English
★PROGRAMMER'S GUIDE ★サウンドI/Fライブラリ
▲ 戻る| 進む▼
サウンドI/Fライブラリ/2.リファレンス

2.2 データ仕様

[共通]


一
覧
表
Title

データ仕様

Data

システム起動データ型

Data name

SndIniDt

No

1

 サウンドシステムに必要なデータの転送元を示すデータ型です。転送先はサウンドメモリ(固定)です。それぞれ以下の内容を設定してください。

アクセスマクロ
SndIniDt sys_ini
アクセスマクロ
型
説明
SND_INI_PRG_ADR(sys_ini)
Uint16*
68Kプログラム格納先頭アドレス
SND_INI_PRG_SZ(sys_ini)
Uint16
68Kプログラム格納先頭サイズ
SND_INI_ARA_ADR(sys_ini)
Uint16*
サウンドエリアマップ格納先頭アドレス
SND_INI_ARA_SZ(sys_ini)
Uint16
サウンドエリアマップサイズ(ワード指定)


一
覧
表
Title

データ仕様

Data

サウンドエリアマップデータ型

Data name

SndAreaMap

No

2

 サウンドエリアマップを示すデータ型です。

値の意味
値
意味
0〜255
任意


一
覧
表
Title

データ仕様

Data

全体音量データ型

Data name

SndTlVl

No

3

 全体の音量を示すデータ型です。

値の意味
値
意味
0〜15
0がOFF、15が最大


一
覧
表
Title

データ仕様

Data

Effect bank numberデータ型

Data name

SndEfctBnkNum

No

4

 Effect bank numberを示すデータ型です。

値の意味
値
意味
0〜15
任意


一
覧
表
Title

データ仕様

Data

音色 bank numberデータ型

Data name

SndToneBnkNum

No

5

 音色 bank numberを示すデータ型です。

値の意味
値
意味
0〜15
任意


一
覧
表
Title

データ仕様

Data

Mixer numberデータ型

Data name

SndMixBnkNum

No

6

 Mixer numberを示すデータ型です。

値の意味
値
意味
0〜127
任意


一
覧
表
Title

データ仕様

Data

Effect out selectデータ型

Data name

SndEfctOut

No

7

 Effect out selectを示すデータ型です。

値の意味
値
意味
0〜15
任意


一
覧
表
Title

データ仕様

Data

Levelデータ型

Data name

SndLev

No

8

 Levelを示すデータ型です。

値の意味
値
意味
0〜7
任意


一
覧
表
Title

データ仕様

Data

PANデータ型

Data name

SndPan

No

9

 PANを示すデータ型です。左から右へ流れるように音を移動するには、-15からカウントアップしてください。

値の意味
↑、↓:矢印の向きに音量増加
値
意味
左
右
-15
最大
OFF
-14〜-1
最大
↓
0
最大
最大
0〜14
↑
最大
15
OFF
最大


一
覧
表
Title

データ仕様

Data

コマンド実行状態データ型

Data name

SndRet

No

10

コマンド実行状態を示すデータ型です。

値
意味
SND_RET_SET
コマンド正常終了(コマンドがセットできました)
SND_RET_NSET
コマンド異常終了(コマンドがセットできませんでした)


一
覧
表
Title

データ仕様

Data

ハードウェアチェックパラメータデータ型

Data name

SndHardPrm

No

11

 ハードウェアチェックパラメータを示すデータ型です。

値
説明
SND_DRAM4
DRAM 4Mbit read/write
SND_DRAM8
DRAM 8Mbit read/write
SND_SCSP_MIDI
SCSP MIDI
SND_SOUND_SRC_LR
音源出力(L/R)
SND_SOUND_SRC_L
音源出力(L)
SND_SOUND_SRC_R
音源出力(R)


一
覧
表
Title

データ仕様

Data

ハードウェアチェックステータスデータ型

Data name

SndHardStat

No

12

 ハードウェアチェックステータスを示すデータ型です。

定数
説明
SND_HARD_OK 
正常
SND_HARD_ERR
異常


[シーケンス]


一
覧
表
Title

データ仕様

Data

発音管理番号データ型

Data name

SndSeqNum

No

13

 発音管理番号を示すデータ型です。

値の意味
値
意味
0〜7
任意


一
覧
表
Title

データ仕様

Data

Sequence bank numberデータ型

Data name

SndSeqBnkNum

No

14

 Sequence bank numberを示すデータ型です。

値の意味
値
意味
0〜15
任意


一
覧
表
Title

データ仕様

Data

Sequence song numberデータ型

Data name

SndSeqSongNum

No

15

 Sequence song numberを示すデータ型です。

値の意味
値
意味
0〜255
任意


一
覧
表
Title

データ仕様

Data

Priorty levelデータ型

Data name

SndSeqPri

No

16

 Priorty levelを示すデータ型です。

値の意味
値
意味
0〜7
0が最高優先順位、7が最低優先順位


一
覧
表
Title

データ仕様

Data

Sequence Volumeデータ型

Data name

SndSeqVl

No

17

 Sequence Volumeを示すデータ型です。

値の意味
値
意味
0〜127
0がOFF、127が最大(原音)


一
覧
表
Title

データ仕様

Data

fade Rateデータ型

Data name

SndFadeRate

No

18

 fade Rateを示すデータ型です。

値の意味
値
意味
0
fade Rateは無効
1〜255
1で最長、255で最短


一
覧
表
Title

データ仕様

Data

Tempoデータ型

Data name

SndTempo

No

19

 Tempoを示すデータ型です。

値の意味
値
意味
+32767〜32768
現在の値に対する相対値
+がUP、−がDOWN
+4096で2倍UP、−4096で2倍DOWN


一
覧
表
Title

データ仕様

Data

シーケンスステータスデータ型

Data name

SndSeqStat

No

20

 シーケンスステータスを示すデータ型です。

SndSeqStat status
アクセスマクロ
型
説明
SND_SEQ_STAT_MODE(status)
Uint16
song mode  
SND_SEQ_STAT_STAT(status)
Uint16
song status

SND_SEQ_STAT_MODE(status)
定数名
説明
SND_MD_STOP   
stop      
SND_MD_PLAY   
play      
SND_MD_FADE   
fade      
SND_MD_PLAY_PS
play pause
SND_MD_FADE_PS
fade pause

SND_SEQ_STAT_STAT(status)
値(16進数)
意味
00
nomal      
01〜7F
error code 
80〜FF
Timing flag


一
覧
表
Title

データ仕様

Data

発音管理番号再生位置データ型

Data name

SndSeqPlayPos

No

21

 発音管理番号再生位置を示すデータ型です。

値の意味
値(16進数)
意味
0〜FFFF
0〜FFFF


[PCM]


一
覧
表
Title

データ仕様

Data

PCM開始パラメータデータ型

Data name

SndPcmStartPrm

No

22

 PCM開始パラメータを示すデータ型です。

SndPcmStPrm prm
アクセスマクロ
型
説明
SND_PRM_MODE(prm)
Uint8 
ステレオ・モノラル+サンプリングレート
SND_PRM_SADR(prm)
Uint16
PCMストリームバッファスタートアドレス
SND_PRM_SIZE(prm)
Uint16
PCMストリームバッファサイズ
SND_PRM_OFSET(prm)
Uint8 
PCMストリーム再生開始オフセット

SND_PRM_MODE(prm) : 以下の定数は論理和で指定してください。
ビット位置
定数
意味
モノラル・ステレオ選択ビット
SND_MD_MONO
モノラル
SND_MD_STEREO
ステレオ
サンプリングレート選択ビット
SND_MD_16
16ビットPCM
SND_MD_8
8ビットPCM

SND_PRM_SADR(prm)
値(16進数)
意味
0000〜FFFF
PCMストリームバッファスタートアドレス
(20bitデータの上位16bit)

SND_PRM_SIZE(prm)
値(16進数)
意味
0000〜FFFF
PCMストリームバッファサイズ
(1チャネル分のサンプル数)

SND_PRM_OFSET(prm)
値(16進数)
意味
0〜F
1000単位(4Kサンプル)
PCMストリーム再生開始オフセット
(0000〜F000)


一
覧
表
Title

データ仕様

Data

PCM変更パラメータデータ型

Data name

SndPcmChgPrm

No

23

 PCM変更パラメータを示すデータ型です。

SndPcmChgPrm prm
アクセスマクロ
型
説明
SND_PRM_NUM(prm)   
SndPcmNum
PCMストリーム再生番号
SND_PRM_LEV(prm)   
SndLev   
ダイレクト音Level
SND_PRM_PAN(prm)   
SndPan   
ダイレクト音Pan
SND_PRM_PICH(prm)  
Uint8    
PICHワード      
 
SND_R_EFCT_IN(prm) 
SndEfctIn
Efect in select 
右出力
(モノラル)
SND_R_EFCT_LEV(prm)
SndLev   
Efect send Level
SND_L_EFCT_IN(prm) 
SndEfctIn
Efect in select 
左出力
(モノラル時無効)
SND_L_EFCT_LEV(prm)
SndLev   
Efect send Level

 以下に各アクセスマクロで使用できる定数、値を示します。

SND_PRM_NUM(prm)
値
意味
0〜7
PCMストリーム再生番号

SND_PRM_PICH(prm)
 SCSPマニュアルのPICHレジスタをご覧ください。


一
覧
表
Title

データ仕様

Data

PCM再生アドレスデータ型

Data name

SndPcmPlayAdr

No

24

 PCM再生アドレスを示すデータ型です。

SndPcmPlayAdr(prm)
アクセスマクロ
型
説明
SND_PCM_RADR(prm)
Uint8
右出力(モノラル)
SND_PCM_LADR(prm)
Uint8
左出力


一
覧
表
Title

データ仕様

Data

PCMアドレス更新割り込みステータス
データ型

Data name

SndPcmIntStat

No

25

 PCMアドレス更新割り込みステータスを示すデータ型です。以下のビット位置定数は論理和で指定できます。

ビット位置定数
説明
SND_PCM_PLAY0
PCM再生番号0
SND_PCM_PLAY1
PCM再生番号1
SND_PCM_PLAY2
PCM再生番号2
SND_PCM_PLAY3
PCM再生番号3
SND_PCM_PLAY4
PCM再生番号4
SND_PCM_PLAY5
PCM再生番号5
SND_PCM_PLAY6
PCM再生番号6
SND_PCM_PLAY7
PCM再生番号7


[CD]


一
覧
表
Title

データ仕様

Data

解析音量データ型

Data name

SndCdVlAnl

No

26

 解析音量を示すデータ型です。

値の意味
値
意味
0〜32767
0がOFF、32767が最大


一
覧
表
Title

データ仕様

Data

周波数帯域別ステレオ解析音量データ型

Data name

SndCdHzSrVl

No

27

 周波数帯域別ステレオ解析音量を示すデータ型です。モノラルの場合は左右出力に同じ値が入ります。

SndCdHzSrVl hz_vl
アクセスマクロ
型
説明
SND_CD_LHIGH(hz_vl)
SndCdVlAnl
高音域解析音量
左出力
SND_CD_LMID(hz_vl)
SndCdVlAnl
中音域解析音量
SND_CD_LLOW(hz_vl)
SndCdVlAnl
低音域解析音量
SND_CD_RHIGH(hz_vl)
SndCdVlAnl
高音域解析音量
右出力
SND_CD_RMID(hz_vl)
SndCdVlAnl
中音域解析音量
SND_CD_RLOW(hz_vl)
SndCdVlAnl
低音域解析音量


▲ 戻る| 進む▼
★PROGRAMMER'S GUIDE ★サウンドI/Fライブラリ
Copyright SEGA ENTERPRISES, LTD., 1997