mruvorbis.dll — README

概要

mruvorbis.dll は、Ogg Vorbis 形式の音声ファイルを再生・エンコードするための Windows 用ダイナミックリンクライブラリ (DLL) です。 C++ アプリケーションや DirectX / SDL ゲームへの組み込みを想定して設計されており、 LoadLibrary による動的ロード方式に対応しています。

主な機能

BGM 再生	Ogg Vorbis ファイルのループ再生・フェードイン／アウト・ミュート・パン制御
SE プール再生	複数 SE を同時再生できる VorbisSePool API（優先度付きボイス管理）
クロスフェード	2 プレイヤーを交互に使用するシームレスなクロスフェード切り替え
エンコード	float PCM → Ogg Vorbis へのリアルタイムエンコード (quality ベース)
デバッグ支援	DumpState / SIMD レベル診断 API
SIMD 最適化	MMX / SSE2 / AVX2 / AVX512 を自動検出して最適なパスを選択
出力デバイス	WASAPI / WaveOut 対応・デバイス切り替え自動復旧

動作環境

OS	Windows 10 / 11 (x86・x64)
ランタイム	Visual C++ 再頒布可能パッケージ 2022 (vcredist)
配置場所	呼び出し元 EXE と同じフォルダ（または検索パス上）
ビット数	EXE と DLL のビット数 (x86 / x64) を一致させること

同梱ファイル

mruvorbis_v1.0.0.0/

│

├── README.html / .txt← このファイル（スタート地点）

│

│ ── ドキュメント ────────────────────────────────────────────────

├── html/

│ ├── USAGE.html / .txt← 使い方ガイド（API 早見表・サンプル実行方法）

│ └── LICENSE.html / .txt← ライセンス・サードパーティ表記

│

│ ── 実行用環境 ──────────────────────────────────────────────────

├── bin/

│ ├── mruvorbis.dll← 本体 DLL（必須）

│ ├── mruvorbis_sample.exe← ビルド済みサンプル実行ファイル

│ ├── run_sample.bat← 起動バッチ（D&D 対応）

│ ├── bgm.ogg← サンプル BGM（Pixel Adventure）

│ └── se.ogg← サンプル SE（Hit）

│

│ ── サンプルプロジェクト ────────────────────────────────────────

└── sample/

├── include/

│ └── VorbisDllExports.h← 公開 C API ヘッダ

├── src/

│ └── mruvorbis_sample.cpp← サンプルソース

└── project/

├── VC2022/← Visual Studio 2022 用

│ ├── mruvorbis_sample.sln

│ ├── mruvorbis_sample.vcxproj

│ └── ...

└── VC2026/← Visual Studio 2026 用

├── mruvorbis_sample.slnx

├── mruvorbis_sample.vcxproj

└── ...

注意事項

⚠️

mruvorbis.dll は呼び出し元 EXE と同じフォルダに配置してください。
EXE と DLL のビット数（x86 / x64）は必ず一致させてください。
終了時は必ず Vorbis_FinalizeAll() を呼んでから FreeLibrary() してください。