We've just updated MediaWiki and its underlying software. If anything doesn't look or work quite right, please mention it to us. --RanAS

N-SPC Engine/Nintendo/Koji Kondo/SFX Sequence Format: Difference between revisions

From SnesLab
Jump to: navigation, search
(Noise Instrument separated and is now more properly defined after accidentally forgetting an extra parameter byte)
(Updating commentary (and updating $DD VCMD to be more accurate description-wise due to the extra parameter))
(2 intermediate revisions by the same user not shown)
Line 27: Line 27:
|<tt>$DB-$DC</tt> || Invalid Note ||
|<tt>$DB-$DC</tt> || Invalid Note ||
|-
|-
|<tt>$DD</tt> || Pitch Slide to Note || <tt>xx yy zz aa</tt>  
|<tt>$DD</tt> || Note + Pitch Slide to Note || <tt>xx yy zz aa</tt>  
|-
|-
|<tt>$DE-$EA</tt> || Invalid Note ||
|<tt>$DE-$EA</tt> || Invalid Note ||
Line 43: Line 43:


==SFX Instrument Format==
==SFX Instrument Format==
The SFX instrument format, shared among all SFX but not consistently stored in terms of memory location, consists of a series of bytes corresponding to direct DSP register writes to the following in order (with the last one not being a DSP register write at all)...
The SFX instrument format, shared among all SFX but not consistently stored in terms of memory location, consists of a series of bytes as following...
* VxVOLL
<pre>xx yy zz aa bb cc dd ee ff</pre>
* VxVOLR
* <tt>xx</tt> is a direct write to the VxVOLL DSP register.
* VxPITCHL
* <tt>yy</tt> is a direct write to the VxVOLR DSP register.
* VxPITCHH
* <tt>zz</tt> is a direct write to the VxPITCHL DSP register.
* VxSRCN
* <tt>aa</tt> is a direct write to the VxPITCHH DSP register.
* VxADSR1
* <tt>bb</tt> is a direct write to the VxSRCN DSP register.
* VxADSR2
* <tt>cc</tt> is a direct write to the VxADSR1 DSP register.
* VxGAIN
* <tt>dd</tt> is a direct write to the VxADSR2 DSP register.
* Pitch Base Multiplier
* <tt>ee</tt> is a direct write to the VxGAIN DSP register.
* <tt>ff</tt> is a pitch base multiplier.


==SFX Percussion Format==
==SFX Percussion Format==
This is identical to the music percussion format.
See [[N-SPC Engine/Prototype#Percussion Format|the music percussion format]], as the format is identical.


==SFX Voice Command Format==
==SFX Voice Command Format==
Line 67: Line 68:
<pre>%0xxxxxxx (yy) (zz)</pre>
<pre>%0xxxxxxx (yy) (zz)</pre>


* <tt>xxxxxxx</tt> represents your note length (as seven bits) in tempo ticks.
* <tt>%xxxxxxx</tt> represents your note length (as seven bits) in tempo ticks.
* <tt>yy</tt>, if less than <tt>$80</tt>, represents the volume of the note. If a second byte is defined, this is done for the left channel, otherwise it is for both channels.
* <tt>yy</tt>, if less than <tt>$80</tt>, represents the volume of the note. If a second byte is defined, this is done for the left channel, otherwise it is for both channels.
* <tt>zz</tt>, if less than <tt>$80</tt>, represents the right volume of the note.
* <tt>zz</tt>, if less than <tt>$80</tt>, represents the right volume of the note.
Line 92: Line 93:
<pre>$DA %1??xxxxx yy</pre>
<pre>$DA %1??xxxxx yy</pre>


* <tt>xxxxx</tt> contains the noise clock rate.
* <tt>%xxxxx</tt> contains the noise clock rate.
* <tt>yy</tt> is an instrument ID to an array of instruments. See SFX Instrument Format above for the format. This must be <tt>$7F</tt> or less, otherwise the noise clock rate is overwritten and more bytes will be fetched until a non-noise clock value is given.
* <tt>yy</tt> is an instrument ID to an array of instruments. See SFX Instrument Format above for the format. This must be <tt>$7F</tt> or less, otherwise the noise clock rate is overwritten and more bytes will be fetched until a non-noise clock value is given.


===Pitch Slide To Note (VCMD <tt>$DD</tt>)===
===Note + Pitch Slide To Note (VCMD <tt>$DD</tt>)===
<pre>$DD xx yy zz aa</pre>
<pre>$DD xx yy zz aa</pre>
* <tt>xx</tt> is the starting note.
* <tt>xx</tt> is the starting note.
* <tt>yy</tt> defines the number of tempo ticks to delay the slide for... at least in theory. In reality, this never works, and the pitch slide executes instantly in all cases.
* <tt>yy</tt> defines the number of tempo ticks to delay the slide for... at least in theory. In reality, this never works, and the pitch slide executes instantly in all cases.
* <tt>zz</tt> defines the length of the pitch slide in tempo ticks.
* <tt>zz</tt> defines the length of the pitch slide in tempo ticks. If this is equal or greater than the overall note length, the note won't key off at the end, thus allowing for multiple pitch envelopes to be chained at once.
* <tt>aa</tt> is the target note.
* <tt>aa</tt> is the target note.


===Note Pitch Envelope To (VCMD <tt>$EB</tt>)===
===Note Pitch Envelope To (VCMD <tt>$EB</tt>)===
<pre>$EB xx yy zz</pre>
<pre>$EB xx yy zz</pre>
* <tt>xx</tt> is the number of ticks to delay before applying the pitch envelope.
* <tt>xx</tt> is the number of ticks to delay before applying the pitch envelope... at least in theory. In reality, this never works, and the pitch slide executes instantly in all cases.
* <tt>yy</tt> is the length of the pitch slide in tempo ticks... at least in theory. In reality, this never works, and the pitch slide executes instantly in all cases.
* <tt>yy</tt> is the length of the pitch slide in tempo ticks. If this is equal or greater than the overall note length, the note won't key off at the end, thus allowing for multiple pitch envelopes to be chained at once.
* <tt>zz</tt> is the target note.
* <tt>zz</tt> is the target note.



Revision as of 02:17, 13 April 2021

Go back to N-SPC Engine/Prototype

The SFX sequence data is slightly modified compared to the standard N-SPC's voice command format. These are headerless, unlike a song, and they only support one channel at a time, with the channel used being fixed. Both games have almost the same command set except for VCMD $FF.

All SFX are initially handled at a tempo of $38.

VCMD ID Description Arguments
$00 End of SFX
$01-$7F Note Duration (xx) (yy)
$80-$C5 Note
$C6-$CF Retrigger Note
$D0-$D9 Percussion
$DA Instrument xx
$DA Noise Instrument (Super Mario World CPUIO3) %1??xxxxx yy
$DB-$DC Invalid Note
$DD Note + Pitch Slide to Note xx yy zz aa
$DE-$EA Invalid Note
$EB Note Pitch Envelope To xx yy zz
$EC-$FE Invalid Note
$FF Restart SFX (Super Mario World CPUIO0)
$FF Jump Back One Byte (Super Mario World CPUIO3)
$FF Jump to SFX ID (Pilotwings) xx

SFX Instrument Format

The SFX instrument format, shared among all SFX but not consistently stored in terms of memory location, consists of a series of bytes as following...

xx yy zz aa bb cc dd ee ff
  • xx is a direct write to the VxVOLL DSP register.
  • yy is a direct write to the VxVOLR DSP register.
  • zz is a direct write to the VxPITCHL DSP register.
  • aa is a direct write to the VxPITCHH DSP register.
  • bb is a direct write to the VxSRCN DSP register.
  • cc is a direct write to the VxADSR1 DSP register.
  • dd is a direct write to the VxADSR2 DSP register.
  • ee is a direct write to the VxGAIN DSP register.
  • ff is a pitch base multiplier.

SFX Percussion Format

See the music percussion format, as the format is identical.

SFX Voice Command Format

Invalid Note (VCMD $DB-$DC, $DE-$EA, $EC-$FE)

Doesn't crash the sound driver, but does play an invalid note.

End of SFX (VCMD $00)

Terminates the SFX.

Note Duration (VCMD $01-$7F)

%0xxxxxxx (yy) (zz)
  • %xxxxxxx represents your note length (as seven bits) in tempo ticks.
  • yy, if less than $80, represents the volume of the note. If a second byte is defined, this is done for the left channel, otherwise it is for both channels.
  • zz, if less than $80, represents the right volume of the note.

Note (VCMD $80-$C5)

Plays a note and delays the channel for one note length before reading another VCMD.

Retrigger Note (VCMD $C6-$CF)

Retriggers the previous note and delays the channel for one note length before reading another VCMD.

Note that as a side effect of this, there is no tie or rest command. Rests can be emulated via a zero volume note. Ties... well, officially they're not supported at all, but if the pitch slide length equals or exceeds the note duration, then the note won't be keyed off once the note length has elapsed.

Percussion (VCMD $D0-$D9)

Plays a percussion note. Unlike SFX, percussion uses the same set that the music uses, and thus has the same instrument format as that.

Instrument (VCMD $DA)

$DA xx
  • xx is an instrument ID to an array of instruments. See SFX Instrument Format above for the format.

Noise Instrument (VCMD $DA)

Only compatible with Super Mario World when playing SFX through the CPUIO3 register.

$DA %1??xxxxx yy
  • %xxxxx contains the noise clock rate.
  • yy is an instrument ID to an array of instruments. See SFX Instrument Format above for the format. This must be $7F or less, otherwise the noise clock rate is overwritten and more bytes will be fetched until a non-noise clock value is given.

Note + Pitch Slide To Note (VCMD $DD)

$DD xx yy zz aa
  • xx is the starting note.
  • yy defines the number of tempo ticks to delay the slide for... at least in theory. In reality, this never works, and the pitch slide executes instantly in all cases.
  • zz defines the length of the pitch slide in tempo ticks. If this is equal or greater than the overall note length, the note won't key off at the end, thus allowing for multiple pitch envelopes to be chained at once.
  • aa is the target note.

Note Pitch Envelope To (VCMD $EB)

$EB xx yy zz
  • xx is the number of ticks to delay before applying the pitch envelope... at least in theory. In reality, this never works, and the pitch slide executes instantly in all cases.
  • yy is the length of the pitch slide in tempo ticks. If this is equal or greater than the overall note length, the note won't key off at the end, thus allowing for multiple pitch envelopes to be chained at once.
  • zz is the target note.

Restart SFX (VCMD $FF)

Only compatible with Super Mario World when playing SFX through the CPUIO0 register.

Restarts the SFX from the beginning.

Jump Back One Byte (VCMD $FF)

Only compatible with Super Mario World when playing SFX through the CPUIO3 register.

Normally, the pointer is incremented upon reading the VCMD. This causes the inverse to happen, and sets the pointer to one byte before this VCMD.

Jump to SFX ID (VCMD $FF)

Only compatible with Pilotwings.

$FF xx
  • xx is the SFX ID to jump to. The array used depends on which set of sequences you're using, as the two of them use different sets.