数値表現

整数

当サイトでは、特に断りがない限り数値は以下のように表記しています。

桁数をそろえるため 0 を付加することがあります。

用語一覧

トラック

サウンドドライバが管理しています。音楽・効果音 などの種類があり、複数のトラックを使用します。種類、総トラック数 及び コマンド はサウンドドライバにより異なります。

当サイトではトラックの番号は 1 以上の値を使用しています。

アドレス

"カートリッジのアドレス" です。通常は $4020–$FFF9 の範囲で指定します。一部のアドレスはレジスタなどで使用しています。

仮引数

8 ビットの値である 場合は、$\mathrm{xxx}$ 、$\mathrm{yy}$ など 2 文字で定義しています。

16 ビットの値である 場合は、$\mathrm{xxxx}$ 、$\mathrm{yyyy}$ など 4 文字で定義しています。

当サイトでは、値の範囲は "最小値–最大値" と表しています。符号の有無は、最小値の絶対値が最大値の絶対値よりも大きいかどうかで確認できます。

既定値

サウンドドライバファンクションで演奏開始時に設定される値です。

固定小数点数

小数点が置かれる桁を固定して表された数です。サウンドドライバでは一回当たりの変化量を求める場合などに使用します。処理速度などの制限があるため、整数部と小数部はそれぞれ 8 の倍数のビット数で処理します。負数は 2 の補数で表現します。

チャネルの音量などの計算には小数部を 0 とした整数部分のみを使用します。固定小数点数の音量が $V$ である場合は $\lfloor V\rfloor$ を計算に使用します。

関数一覧

$\lfloor x\rfloor$床関数 (floor)

$x$ 以下の最大の整数を返します。

$\lceil x\rceil$天井関数 (ceiling)

$x$ 以上の最小の整数を返します。

$\mathrm{MIN}\left(x_1,x_2,\dots \right)$最小値

() 内の最小の値を返します。

$\mathrm{MAX}\left(x_1,x_2,\dots \right)$最大値

() 内の最大の値を返します。

$\mathrm{CLAMP}\left(x,N,X\right)$クランプ

$x$ が最小値 $N$・最大値 $X$ の範囲内である場合は $x$ 、範囲外である場合は $N$ 又は $X$ を返します。

最小値は $N$ 、最大値は $X$ です。

$\mathrm{CLAMP}\left(x,N,X\right)=\mathrm{MIN}\left(\mathrm{MAX}\left(x,N\right),X\right)$

$\mathrm{U2}\left(x\right)$符号なし 2 ビット整数

$\lfloor x\rfloor$ と $2^2-1$ のビット論理積を返します。

最小値は 0 、最大値は 3 です。

テーブル番号の選択などに使用しています。

$\mathrm{U3}\left(x\right)$符号なし 3 ビット整数

$\lfloor x\rfloor$ と $2^3-1$ のビット論理積を返します。

最小値は 0 、最大値は 7 です。

Decay Rate の計算などに使用しています。

$\mathrm{U4}\left(x\right)$符号なし 4 ビット整数

$\lfloor x\rfloor$ と $2^4-1$ のビット論理積を返します。

最小値は 0 、最大値は 15 です。

Attack Rate の計算などに使用しています。

$\mathrm{U5}\left(x\right)$符号なし 5 ビット整数

$\lfloor x\rfloor$ と $2^5-1$ のビット論理積を返します。

最小値は 0 、最大値は 31 です。

ノイズクロックの計算などに使用しています。

$\mathrm{U6}\left(x\right)$符号なし 6 ビット整数

$\lfloor x\rfloor$ と $2^6-1$ のビット論理積を返します。

最小値は 0 、最大値は 63 です。

揺れの大きさの計算などに使用しています。

$\mathrm{U7}\left(x\right)$符号なし 7 ビット整数

$\lfloor x\rfloor$ と $2^7-1$ のビット論理積を返します。

最小値は 0 、最大値は 127 です。

音量やパンの計算などに使用しています。

$\mathrm{U8}\left(x\right)$符号なし 8 ビット整数

$\lfloor x\rfloor$ と $2^8-1$ のビット論理積を返します。

最小値は 0 、最大値は 255 です。

$\mathrm{U16}\left(x\right)$符号なし 16 ビット整数

$\lfloor x\rfloor$ と $2^{16}-1$ のビット論理積を返します。

最小値は 0 、最大値は 65535 です。

$\mathrm{S8}\left(x\right)$符号あり 8 ビット整数

$\lfloor x\rfloor$ と $2^8-1$ のビット論理積を返します。最上位ビットが 1 である場合は負数を表します。

最小値は −128 、最大値は 127 です。

エコーフィードバックの値や音程の計算などに使用しています。

$\mathrm{S16}\left(x\right)$符号あり 16 ビット整数

$\lfloor x\rfloor$ と $2^{16}-1$ のビット論理積を返します。最上位ビットが 1 である場合は負数を表します。

最小値は −32768 、最大値は 32767 です。

$\mathrm{LSL8}\left(x,s\right)$論理左シフト (符号なし 8 ビット整数)

x : シフトされる数値 ($00–$FF)
s : シフトする桁数 (0–7)

$\mathrm{U8}(\mathrm{U8}\left(x\right)\times 2^s)$ を返します。

最小値は 0 、最大値は 255 です。

$\mathrm{LSR8}\left(x,s\right)$論理右シフト (符号なし 8 ビット整数)

x : シフトされる数値 ($0000–$FFFF)
s : シフトする桁数 (0–7)

$\mathrm{U8}(\mathrm{U8}\left(x\right)÷2^s)$ を返します。

最小値は 0 、最大値は 255 です。

$\mathrm{ASR8}\left(x,s\right)$算術右シフト (符号あり 8 ビット整数)

x : シフトされる数値 ($80–$7F)
s : シフトする桁数 (0–7)

$\mathrm{S8}(\mathrm{U8}(256-2^{7-s})\times \mathrm{LSR8}(x,7)+\mathrm{LSR8}\left(x,s\right))$ を返します。

最小値は −128 、最大値は 127 です。

$\mathrm{LSL16}\left(x,s\right)$論理左シフト (符号なし 16 ビット整数)

x : シフトされる数値 ($0000–$FFFF)
s : シフトする桁数 (0–15)

$\mathrm{U16}(\mathrm{U16}\left(x\right)\times 2^s)$ を返します。

最小値は 0 、最大値は 65535 です。

$\mathrm{LSR16}\left(x,s\right)$論理右シフト (符号なし 16 ビット整数)

x : シフトされる数値 ($0000–$FFFF)
s : シフトする桁数 (0–15)

$\mathrm{U16}(\mathrm{U16}\left(x\right)÷2^s)$ を返します。

最小値は 0 、最大値は 65535 です。

$\mathrm{H8}\left(x\right)$符号なし 16 ビット整数 の 上位 8 ビット (符号なし 8 ビット整数)

符号なし 16 ビット整数 $x$ の 上位 8 ビットの値を返します。

最小値は 0 、最大値は 255 です。

$\mathrm{H8}\left(x\right)=\mathrm{LSR16}(x,8)$

$\mathrm{L8}\left(x\right)$符号なし 16 ビット整数 の 下位 8 ビット (符号なし 8 ビット整数)

符号なし 16 ビット整数 $x$ の 下位 8 ビットの値を返します。

最小値は 0 、最大値は 255 です。

$\mathrm{L8}\left(x\right)=\mathrm{U8}\left(x\right)$

$\mathrm{E8}\left(x\right)$符号あり 8 ビット 整数 (エクセス 128)

$\mathrm{S8}(\mathrm{U8}\left(x\right)-\mathrm{128})$ を返します。

最小値は −128 、最大値は 127 です。

$\mathrm{U8Q8}\left(x,d\right)$符号なし 16 ビット固定小数点数 (UQ8.8)

$\mathrm{U16}(x\times 256÷d)÷256$ を返します。

最小値は 0 ($00.00)、最大値は 255.99609375 ($FF.FF) です。

一回当たりの変化量の計算に使用しています。

$\mathrm{S8Q8}\left(x,d\right)$符号あり 16 ビット固定小数点数 (Q8.8)

$\mathrm{S16}(x\times 256÷d)÷256$ を返します。

最小値は -128.0 ($80.00)、最大値は 127.99609375 ($7F.FF) です。

一回当たりの変化量の計算に使用しています。

$\mathrm{R8}\left(A\right)$カートリッジ領域の値 (符号なし 8 ビット整数)

A : カートリッジ領域のアドレス ($4020–$FFF9)

$\mathrm{U8}\left(\mathrm{カートリッジ領域のアドレス\; A\; の値}\right)$ を返します。

$\mathrm{R16}\left(A\right)$カートリッジ領域の値 (符号なし 16 ビット整数)

A : カートリッジ領域のアドレス ($4020–$FFF8)

$\mathrm{LSL16}(\mathrm{R8}\left(A+1\right),8)+\mathrm{U16}(\mathrm{R8}\left(A\right))$ を返します。