# Dreamcast Sound Library

Copyright 1997,1998 SEGA Enterprises Ltd,
Document Version 1.00.03
1998.10. 8更新

## 注意

また，表示の確認はInternet Explorer 4.01sp1でのみ行っております．Netscape Navigatorでは若干スタイルが変わってしまいます．

## 更新情報

前回リリースのドキュメント（ドキュメントバージョン1.00.02）からの更新個所にはほとんど色がついています．色は変更又は修正・追加・削除になっております．色がついていないものはHTMLの記述ミスなどです．

### 1998.10. 8

- "使用する"がまだ"仕様する"になっていたので今度こそ修正．

### 1998.10. 1

- 概要にサウンドモジュールの操作を追加．
- サウンドメモリにメモリブロックを転送するAPIである`sdMemBlkTransfer`を新たに一般公開．

### 1998. 9.30

- サンプルのsample00で関数`SoundInit`に移動できなかった（アンカーミス）のを修正．
- ステレオ・モノラルの設定をするAPIである`sdSndSetSpace`の参照に`SDE_SPACE`を追加．
- メモリブロックハンドルのパラメータ設定をするAPIである`sdMemBlkSetPrm`の参照に`SD_MEMBLK_CALLBACK_FUNC`を追加．
- マルチユニットファイルのダウンロードを行うAPIである`sdMultiUnitDownload`とバンクファイルのダウンロードを行うAPIである`sdBankDownload`の参照に`SDMEMBLK`を追加．
- バンクファイルのダウンロードを行うAPIである`sdBankDownload`の参照に`SDE_DATA_TYPE`を追加．
- サウンドメモリのメモリアロケート情報の取得をするAPIである`sdSndMemGetBankStat`の参照に`SDE_DATA_TYPE`を追加．
- MIDIメッセージを送信するAPIである`sdMidiSendMes`のプライオリティの範囲が10進数表記と16進数表記がまざっていたので16進数表記に統一．

### 1998. 9.29

1.00.00リリース後の修正について．

- 推奨環境をInternet Explorer 4.01sp1に変更．
- 表題のドキュメントバージョンを1.00.00にし忘れていた．次と言うことでとりあえず1.00.01ということにしておく．
- API索引でメモリブロックAPIにリンクが貼られていなかったので修正．
- `sdPstmPlay`で"使用する"が"仕様する"になっていたところを修正．
- スタイルシートの若干の見なおし．それにともないヘアライン等若干見なおし．

### 1998. 9.28

- テクニカルノートに何も書かれていないのでとりあえず削除．今書いているところ（苦笑）

### 1998. 9.18

- 一覧から`sdSndSetFxOutPrm`が抜けていたので追加．
- `sdSndSetFxOutPrm`で全角数字を使っていたのを半角数字に修正．
- `sdSndStopAll`の引数が`void`になっていたので`Void`に修正．
- `sdSndClearFxPrg`の引数が`void`になっていたので`Void`に修正．
- `sdSndSetFxOut`で"番号"が抜けていたので追加．
- `sdSndSetFxOutPrm`の引数の範囲記述を追加．
- `sdSndStopAll`の備考でAPI名がフォントが等幅になっていなかったので修正．．
- 改行コードがまだ一部`LF`のファイルがあったので全て`CR`+`LF`に統一．
- 最新の用語集を収録．

### 1998. 9.14

- マクロ定数の`SDD_PORT_FLG_TROUBLE`の説明の文章が中と半端に途切れていたので途切れた分を削除．
- PCMストリームの再生開始APIである`sdPstmPlay`の引数の説明でサンプリング周波数マクロ定数が記述されていたがマクロ定数を参照してもらうことにして削除．
- PCMストリームの再生開始APIである`sdPstmPlay`のサンプリング周波数設定の引数名を`smp_frequendy`に変更．
- PCMストリームの再生開始APIである`sdPstmPlay`のサンプリング周波数設定の説明をもう少し追記．
- PCMストリームの再生開始APIである`sdPstmPlay`のサンプリング周波数設定の参照を追加．
- 音源コントロールAPIのほとんどに少し参照を追加．
- PCMストリームのチャンネルステータスを取得するAPIである`sdPstmGetStat`の引数`ch_num`の説明がおかしかったのを修正．
- PCMストリームの波形転送をするAPIである`sdPstmTransferWaveData`の引数`ch_num`が`ch`になっていたのと，引数`memblk_handle`のデータタイプがおかしかったのを修正．
- PCMストリームの波形転送が可能か検査するAPIである`sdPstmIsTransferWaveData`の引数`ch_num`が`ch`になっていたのを修正．
- FAQの項目をひとつ追加．サウンドデータの扱い方について簡単に説明．

### 1998. 9. 8

- ポートエラーステータスのビットアサインを表す`SDD_PORT_ERR_〜`の説明を追加．
- ポートエラーステータスのビットアサインを表す`SDD_PORT_FLG_〜`の説明をもう少し詳細に説明を修正．
- PCMストリームの再生周波数マクロに`SDD_PSTM_FREQ_08820`の追加．
- サウンドライブラリのバージョンを調べるAPIである`sdLibGetVer`の参照に間違えて備考に書くべき文面を記述していた．そもそも記述の必要がなかったので削除．
- サウンドドライバのバージョンを調べるAPIである`sdDrvGetVer`およびサウンドライブラリのバージョンを調べるAPIである`sdLibGetVer`の参照に項目を追加．
- サウンドドライバのカウントしているカウンタ数を取得するAPIである`sdDrvGetExecuteCounter`およびMIDIポートの特殊なメッセージをカウントを取得するAPIである`sdDrvGetMidiTimmingCounter`のエラーコードを追加．
- サウンドドライバのエラーステータスを取得するAPIである`sdDrvGetErr`を追加．
- サウンドドライバへのホストコマンドを送信するAPIである`sdSysFlushHostCmd`のエラーコードの記述を追加．
- サウンドライブラリのサーバAPIである`sdSysServer`の引数が`void`だったのを`Void`に修正．

### 1998. 9. 6

- FXレベル・ダイレクトレベル・チャンネルを設定するAPIである`sd{Midi,Shot,Pstm}Set{Fx,Drct}{Ch,Lev}`で設定するFXレベル・ダイレクトレベルの範囲に間違いがあったので修正．簡単に言うと符号付き5ビットもしくは符号無し4ビットではなく符号付き8ビットもしくは符号無し7ビットが正しい．
- 現在のFXアウトプットのパラメータを設定するAPIである`sdSndSetFxOutPrm`の名称が間違っていたので修正．

### 1998. 9. 1

- FXプログラムをクリアするAPIである`sdSndClearFxPrg`の備考を削除．
- 現在のFXアウトプット番号を取得するAPIである`sdSndGetFxOut`の引数説明でミキサという用語があったのでFXアウトプットに修正．
- 全てのサウンドデータの再生を停止するAPIである`sdSndStopAll`で中止と表現していたのを停止に修正．
- サウンドモジュールコントロールAPIで値の精度はそれほど高くありません．と表現していたものを全て削除．
- PCMストリームの波形転送が可能か検査するAPIである`sdPstmIsTransferWaveData`で`07000H`と記述していたところを`7000H`に修正．
- GD-DAポートのステータスを取得するAPIである`sdGddaGetStat`の引数のうち`SDS_GDDA_STAT`が`SDS_CDDA_STAT`になっていたのを修正．
- ホストコマンドのSH-4側のバッファをフラッシュするAPIである`sdSysFlushHostCmd`の引数が`void`になっていたのを`Void`に修正．また，実際の転送量の表現が正しくなかったので同じく修正．
- サウンドライブラリの初期化を行うAPIである`sdLibInit`の説明が"サウンドドライバの初期化"になっていたのを修正．
- 共用体データタイプ内に全角数字があったのを半角数字に修正．
- メモリブロック転送のモードを表す`SDE_MEMBLK_TRANSFER_MODE`の説明にもう少し文章を追加．
- ポートステータスに`m_CommonStat`が残っていたので削除．

それ以前の更新情報は別途更新記録を参照ください．

## 目次

### 概要

- ブロックチャート
- シグナルチャート
- サウンドモジュールの操作

### サウンドシステム仕様

- 仕様一覧

### サンプル

- 一覧

### FAQ

- 一覧

### リファレンス

#### API

- サウンドシステムAPI
- グローバルサウンドコントロールAPI
- サウンドデータユーティリティAPI
- サウンドメモリコントロールAPI
- メモリブロック転送API
- 音源コントロールAPI
- 全API索引

#### データタイプ・定数マクロ

- ハンドル型データタイプ
- マクロ定数
- 単純なデータタイプ
- 構造体型データタイプ
- 列挙型データタイプ
- 全データタイプ・定数マクロ索引

オーバービューに戻る
TOPに戻る