Fast Tracker 2 Extended Module - Revision history

Nickysn: /* File Format */ - sample header data is ignored by FT2 and is broken in many modules in the wild

2024-02-21T02:37:18Z

File Format: - sample header data is ignored by FT2 and is broken in many modules in the wild

← Older revision		Revision as of 19:37, 20 February 2024
Line 72:		Line 72:
	*** if Number_of_samples_in_instrument > 0 then		*** if Number_of_samples_in_instrument > 0 then
	**** Extended header:		**** Extended header:
	***** 32-bit LongWord: sample header size. Usually 40.		***** 32-bit LongWord: sample header size. Usually 40. '''This field appears to be completely ignored by Fast Tracker 2 and there are modules in the wild that have completely broken values in this field (e.g. I've seen this in modules, that claim to be created by Sk@le Tracker). It's better to ignore it and assume the sample header size is always 40.'''
	***** 96 bytes: Sample number for each note.		***** 96 bytes: Sample number for each note.
	***** 1222 bytes: Volume envelope.		***** 1222 bytes: Volume envelope.
Line 114:		Line 114:
	***** Byte: Reserved.		***** Byte: Reserved.
	***** 22 bytes: Sample name.		***** 22 bytes: Sample name.
	***** Sample header size minus 40 bytes: Optional extra data.		***** Sample header size minus 40 bytes: Optional extra data. '''The sample header size field is completely ignored by Fast Tracker 2. Therefore, it's best to assume the sample header size is always 40 bytes and to not skip this data!'''
	**** Sample data for each sample of the instrument. Each sample data is written as delta values. Even though, there's no sample compression, the use of delta values makes the file more compressable, e.g. if you compress the file into a .zip or another similar format, it achieves a better compression ratio, compared to raw PCM. Stereo is written left channel first (the entire sample), followed by the right channel.		**** Sample data for each sample of the instrument. Each sample data is written as delta values. Even though, there's no sample compression, the use of delta values makes the file more compressable, e.g. if you compress the file into a .zip or another similar format, it achieves a better compression ratio, compared to raw PCM. Stereo is written left channel first (the entire sample), followed by the right channel.

Nickysn: /* File Format */ - sample data format

2022-10-09T01:41:56Z

File Format: - sample data format

← Older revision		Revision as of 18:41, 8 October 2022
Line 115:		Line 115:
	***** 22 bytes: Sample name.		***** 22 bytes: Sample name.
	***** Sample header size minus 40 bytes: Optional extra data.		***** Sample header size minus 40 bytes: Optional extra data.
	**** ~~TODO:~~ instrument sample data		**** Sample data for each sample of the instrument. Each sample data is written as delta values. Even though, there's no sample compression, the use of delta values makes the file more compressable, e.g. if you compress the file into a .zip or another similar format, it achieves a better compression ratio, compared to raw PCM. Stereo is written left channel first (the entire sample), followed by the right channel.

	==Playback notes==		==Playback notes==

Nickysn: Dxy - the value is in decimal!

2022-10-09T00:35:47Z

Dxy - the value is in decimal!

← Older revision		Revision as of 17:35, 8 October 2022
Line 163:		Line 163:

	====Dxy====		====Dxy====
	Pattern break to row.		Pattern break to row. Jump to row x*10 + y. '''THE VALUE PROVIDED IS IN DECIMAL!''' This had to be yelled out as it's a common mistake when making a XM player.

	====Exy - Miscellaneous effects====		====Exy - Miscellaneous effects====

Nickysn: /* File Format */ - Volume type, panning type bits explained

2022-10-08T19:59:11Z

File Format: - Volume type, panning type bits explained

← Older revision		Revision as of 12:59, 8 October 2022
Line 84:		Line 84:
	***** Byte: Panning envelope loop start.		***** Byte: Panning envelope loop start.
	***** Byte: Panning envelope loop end.		***** Byte: Panning envelope loop end.
	***** Byte: Volume type.		***** Byte: Volume type:
	***** Byte: Panning type.		****** bit 0: 1 = Volume envelope enabled; 0 = Volume envelope disabled
			****** bit 1: 1 = Sustain point enabled; 0 = Sustain point disabled
			****** bit 2: 1 = Envelope loop enabled; 0 = Envelope loop disabled
			***** Byte: Panning type:
			****** bit 0: 1 = Panning envelope enabled; 0 = Panning envelope disabled
			****** bit 1: 1 = Sustain point enabled; 0 = Sustain point disabled
			****** bit 2: 1 = Envelope loop enabled; 0 = Envelope loop disabled
	***** Byte: Vibrato type.		***** Byte: Vibrato type.
	***** Byte: Vibrato sweep.		***** Byte: Vibrato sweep.

Nickysn: /* File Format */

2022-10-08T15:32:13Z

File Format

← Older revision		Revision as of 08:32, 8 October 2022
Line 108:		Line 108:
	***** Byte: Reserved.		***** Byte: Reserved.
	***** 22 bytes: Sample name.		***** 22 bytes: Sample name.
			***** Sample header size minus 40 bytes: Optional extra data.
	**** TODO: instrument sample data		**** TODO: instrument sample data

Nickysn: /* File Format */

2022-10-08T15:31:10Z

File Format

← Older revision		Revision as of 08:31, 8 October 2022
Line 72:		Line 72:
	*** if Number_of_samples_in_instrument > 0 then		*** if Number_of_samples_in_instrument > 0 then
	**** Extended header:		**** Extended header:
	***** 32-bit LongWord: sample header size.		***** 32-bit LongWord: sample header size. Usually 40.
	***** 96 bytes: Sample number for each note.		***** 96 bytes: Sample number for each note.
	***** 1222 bytes: Volume envelope.		***** 1222 bytes: Volume envelope.

Nickysn: /* File Format */ - instrument name is NUL padded

2022-10-08T15:01:56Z

File Format: - instrument name is NUL padded

← Older revision		Revision as of 08:01, 8 October 2022
Line 67:		Line 67:
	*** Instrument header:		*** Instrument header:
	**** 32-bit LongWord: Instrument header size (includes the optional extended header, described below, but doesn't include the sample headers).		**** 32-bit LongWord: Instrument header size (includes the optional extended header, described below, but doesn't include the sample headers).
	**** 22 bytes: Instrument name.		**** 22 bytes: Instrument name, terminated (padded) with NUL characters.
	**** Byte: Instrument type.		**** Byte: Instrument type.
	**** 16-bit Word: Number of samples in instrument.		**** 16-bit Word: Number of samples in instrument.

Nickysn: /* File Format */ - valid range of Initial BPM

2022-10-08T00:38:59Z

File Format: - valid range of Initial BPM

← Older revision		Revision as of 17:38, 7 October 2022
Line 20:		Line 20:
	*** bit 0: 0 - Amiga slides, 1 - Linear slides		*** bit 0: 0 - Amiga slides, 1 - Linear slides
	** 16-bit Word: Initial speed.		** 16-bit Word: Initial speed.
	** 16-bit Word: Initial BPM.		** 16-bit Word: Initial BPM. Valid range: 0..255
	** 256 bytes: Pattern order.		** 256 bytes: Pattern order.
	** Header size minus 276 bytes: Optional extra header data.		** Header size minus 276 bytes: Optional extra header data.

Nickysn: /* File Format */ - sample flags

2022-10-07T23:56:30Z

File Format: - sample flags

← Older revision		Revision as of 16:56, 7 October 2022
Line 98:		Line 98:
	***** Byte: Volume.		***** Byte: Volume.
	***** Byte: Finetune (signed byte -16..+15).		***** Byte: Finetune (signed byte -16..+15).
	***** Byte: Flags.		***** Byte: Flags:
			****** bits 0..1: 0 = No loop, 1 = Forward loop, 2 = Ping-pong loop, 3 = Invalid (undefined) value
			****** bits 2..3: Undefined (unused).
			****** bit 4: 1 = 16-bit sample, 0 = 8-bit sample.
			****** bit 5: 1 = stereo sample, 0 = mono sample. (Stereo samples are a ModPlug Tracker extension, they're not supported by Fast Tracker 2.)
			****** bits 6..7: Undefined (unused).
	***** Byte: Panning.		***** Byte: Panning.
	***** Byte: Relative note number (signed byte).		***** Byte: Relative note number (signed byte).

Nickysn: /* File Format */ - documented the sample header structure

2022-10-07T23:53:21Z

File Format: - documented the sample header structure

← Older revision		Revision as of 16:53, 7 October 2022
Line 92:		Line 92:
	***** 16-bit Word: Volume fadeout.		***** 16-bit Word: Volume fadeout.
	***** 16-bit Word: Reserved.		***** 16-bit Word: Reserved.
	**** ~~TODO:~~ instrument sample ~~headers~~		**** Sample headers for each sample of the instrument. Each sample header:
			***** 32-bit LongWord: Sample length in bytes.
			***** 32-bit LongWord: Loop start (in bytes, not in samples).
			***** 32-bit LongWord: Loop length (in bytes, not in samples).
			***** Byte: Volume.
			***** Byte: Finetune (signed byte -16..+15).
			***** Byte: Flags.
			***** Byte: Panning.
			***** Byte: Relative note number (signed byte).
			***** Byte: Reserved.
			***** 22 bytes: Sample name.
	**** TODO: instrument sample data		**** TODO: instrument sample data