════════════════════════════════════════════════════════════════
  mrutheora.dll  — 使い方ガイド
  ALC Software Laboratory
════════════════════════════════════════════════════════════════

【クイックスタート】
  1. mrutheora.dll を EXE と同じフォルダに配置
  2. LoadLibraryW(L"mrutheora.dll") でロード
  3. Win32 ウィンドウ (HWND) を作成
  4. Theora_Create() → LoadFile() → Start(h, hwnd, ...) で再生
  5. 終了: Theora_Stop() → Theora_Destroy() → FreeLibrary()

【API 早見表】

  ── 基本操作 ────────────────────────────────────────────────
  Theora_Create()                      ハンドル作成
  Theora_Destroy(h)                    ハンドル破棄
  Theora_LoadFile(h, path)             OGVファイルロード
  Theora_Start(h,hwnd,x,y,w,h,sc,lp)  再生開始・描画先指定
  Theora_Stop(h)                       再生停止
  Theora_Pause(h, BOOL)                一時停止 / 再開
  Theora_SeekMs(h, ms)                 ミリ秒シーク
  Theora_StepFrame(h)                  1フレーム進める
  Theora_IsPlaying(h) / IsPaused(h)   状態取得

  ── ループ / 速度 / 情報 ───────────────────────────────────
  Theora_SetLoop(h, BOOL)              ループ設定
  Theora_SetLoopRange(h, start, end)   区間ループ設定 (ms)
  Theora_SetSpeed(h, speed)            再生速度 (0.25〜4.0)
  Theora_GetPositionMs(h)              現在位置 (ms)
  Theora_GetDurationMs(h)              総時間 (ms)
  Theora_GetWidth/Height(h)            映像サイズ
  Theora_GetFps(h)                     FPS取得
  Theora_GetTotalFrames(h)             総フレーム数
  Theora_HasAudio(h)                   音声トラック有無
  Theora_IsSynced(h)                   映像音声同期状態
  Theora_GetDriftMs(h)                 ドリフト量 (ms)

  ── 描画 / スケーリング ─────────────────────────────────────
  Theora_SetTarget(h,hwnd,x,y,w,h,sc) 描画先変更
  Theora_SetScaleMode(h, mode)         スケールモード
    TH_SCALE_NEAREST=0 / TH_SCALE_LINEAR=1
  Theora_OnResize(h, w, h)            ウィンドウリサイズ通知

  ── 音量 ────────────────────────────────────────────────────
  Theora_SetVolume(h, vol)   音量設定 (0.0〜1.0)
  Theora_GetVolume(h)        音量取得
  Theora_SetMute(h, BOOL)    ミュート設定
  Theora_IsMuted(h)          ミュート状態

  ── フレーム取得 ─────────────────────────────────────────────
  Theora_GetCurrentFrameBitmap(h, hWnd)    HBITMAP取得
  Theora_CopyCurrentFrameBgra32(h, ...)    BGRA32コピー
  Theora_CopyCurrentFrameYuv420(h, ...)    YUV420コピー

  ── マスク ───────────────────────────────────────────────────
  Theora_SetMaskRect / SetMaskRects        矩形マスク
  Theora_AnimateMaskRect                   アニメーションマスク
  Theora_SetMaskBitmap / UpdateMaskBitmap  ビットマップマスク
  Theora_SetMaskBlendMode / CombineMode    マスクモード設定

  ── テキスト / キューポイント / コールバック ─────────────────
  Theora_DrawTextOverlay(h, text, ...)     テキスト重ね表示
  Theora_DrawTextOverlayEx(h, text, ...)   テキスト（拡張版）
  Theora_AddCuePoint(h, ms, id)            キューポイント追加
  Theora_ClearCuePoints(h)                 全削除
  Theora_SetCallbacks(h, ...)              コールバック設定

  ── エンコード / バージョン ─────────────────────────────────
  TheoraEncoder_Create(w, h, ...)          エンコーダ作成
  TheoraEncoder_EncodeFrame(enc, ...)      YUV420エンコード
  TheoraEncoder_Finish / Destroy           終了・破棄
  Theora_GetVersionString()                DLLバージョン
  Theora_GetBuildInfo()                    ビルド情報
  Theora_DumpState(h)                      デバッグ状態

【実行方法】
      mrutheora_sample.exe sample.ogv
      ※ run_sample.bat に OGV をドラッグ&ドロップでも可

【操作キー一覧】
      Space       一時停止 / 再開
      Left        5 秒 巻き戻し
      Right       5 秒 早送り
      Up          音量 +10%
      Down        音量 -10%
      M           ミュート切り替え
      L           ループ切り替え
      ESC         終了

════════════════════════════════════════════════════════════════
