ACNews #12 07 октября 2002

Программирование

Guide - Format Module Pro Tracker v3.x

■ ■ ■ ■ ■ ■ ■ ■ ■

  ■ ■ ■ ■ ■ ■ ■ ■ ■ ■


                 Module format Pro Tracker v3.x


   Specified offset to fields in the module and its length in 
bytes (Decimal number).


0 (13) "ProTracker 3." - Identification string.
13 (17) "5" (or "4" or even "3") - the number of subversion.

   It should be noted that for modules PTv3.4x and below we use
another, "asymmetric" table volume, and the modules PTv3.3x
uses an alternative frequency table "Pro Tracker", not
coinciding with the same name today!
14 (16) "compilation of"
+30 (32) module name (ASCII, lat, unused characters
 crammed spaces).
62 (4) "by"
+66 (32) the author's name (ASCII, lat, unused characters are 
crammed  spaces).

98 (1) one space.
 (Ie the first 99 bytes of the module form the appropriate line)

99 (1) the number of frequency table: 0 = Pro Tracker, a = 
Sound Tracker,  2 = ASM or PSC, 3 = RealSound. The plate is 192 
bytes and contains the values ​​of the periods up to 96 notes, 
from C-1 (before the first Octa you). Period - the inverse of 
the frequency of the notes placed in the corresponding 
registers AY. Byte (here and below, with one  exception, which 
will be specified) is stored first. Compiler  PT keeps a table 
corresponding module in the player's body on  relative address 
512. Table volume, he keeps in the  same body player at the 
relative address 256. +100 (1) tempo.

101 (1) song end (1 = module is only one position) - a player 
not  used.

102 (1) song loop (0 = infinite loop at the beginning).
103 (2) Psa_chn = offset from the beginning of the module to a 
table of patterns. 105 (32 * 2) offset from the beginning of 
the module to sample, ranging from the zero sample. Two bytes 
per sample. Zero samples in the current  version of the editor 
is used. For all unused  Sample bias is zero.

169 (16 * 2) offset from the beginning of the module to the 
ornaments, ranging from  zero. Two bytes per ornament.Nulevoy 
ornament - it Otsu tstvie ornament, so the data this decoration 
(see below) soda laugh 0,1,0 (you can use this ornament on your 
discretion Niya, but then the song will not be able to use 
samples without ornamentation ments). For all unused ornaments 
offset is zero. 201 (?) List of positions (order). The numbers 
of patterns  (0 ... 84), multiplied by 3. Table completes code 
# ff. Pro  Tracker v3.3x-v3.5x does not support more than 42 
patterns. + Psa_chn (? * 6) index patterns. Contains for each 
of the patterns of displacement has yuschihsya: 

   + 0 (2) to block the channel data (track) A

   + 2 (2) to block the channel data (track) B

   + 4 (2) to block the channel data (track) C.
 Data from the displacement noise (separate column in the 
editor) components are formulated in the channel B. +? (?*?) 
Blocks of data channels, ie the tracks. 

 Track contains the following data:
================================================== 
============== # 00 - the end of the track.

# 01, delay, Lsl, Hsl - effect Gliss (Slide) up or down. Delay
 - The time in the fifties fractions of seconds after which to
 period of the notes will be added value Lsl +256 * Hsl. Shift
 player accumulates in the corresponding variable, and is 
adding after the formation rate notes t.e.snachala handles Xia 
stitch ornament, and only then ... # 02, delay, Lmax, Hmax, 
Lsl, Hsl - Tone Portamento effect up  or vniz.Delay - the time 
in the fifties of a second, after  which the period of the 
notes will be added value Lsl +256 * Hsl.  Lmax +256 * Hmax - 
maximum offset (unsigned), followed by accumulation of which 
should be stopped Portamento. # 03, offset - sample offset. 
Sample starts to not play again. # 04, offset - ornament 
offset. The ornament is beginning to play not first consider. # 
05, YEStime, NOtime - vibrate. note that sounds, it does not 
sound. # 08, delay, Lsl, Hsl - the effect of slide envelope. By 
the time value  the envelope from time to time be added Lsl 
+256 * Hsl. # 09, tempo - tempo indication (in the interrupt on 
the line). Standard LIMITED player less tempo = 3 is not 
playing. # 1x, Henv, Lenv, smp * 2 - change the number of 
samples and include enve yuschuyu type of x-1 with a period 
Lenv +256 * Henv. When you turn on the envelope  it is 
initialized, ie, begins a new period! # 20 - # 3f - specify the 
offset of noise (only happens in the channel B) # 4x - specify 
the pattern number x. # 50 - # Af - specify pitch and FINISH 
analysis of the current row  channel.

# B0 - disable Envelope.
# B1, lines - not to analyze the channel for lines of strings.
 (Lines = 1 corresponds to one line)
# Bx, Henv, Lenv - same as # 1x, but without a sample. That is 
just  include an envelope-type x-1 with the specified period.

# Cv - specify the volume. (V = 0 - END pause and analysis of 
the line.) # D0 - FINISH analysis of the line.

# D1-# Ef - specify the number of samples.
# Fx, smp * 2 - indicate the number of ornaments (x) and number 
of samples. NB: paramenty effects (# 0x) are not immediately 
after the code number effect, and AFTER THE END OF THE LINE! If 
you have multiple effects on a single note (in fact it does not 
happen), the first lie paramenty latter effect, then the 
penultimate, and so on ... 
================================================== 
============== 

+? (?*(?* 4 +2)) - samples.

   + +0 (1) - loop

   + +1 (1) - end (1 = sample from a single line)

   + +2 (? * 4) - data:

      + + +0 (1) sv + - N4 N3 N2 N1 N0 Em

      + + +1 (1) Nm ts ns Tm V3 V2 V1 V0
 sv = 1 - sign sezzhaniya volume + - = 1 corresponds to an 
increase in her crease; N4-0 - frequency noise or offset of the 
envelope (depending on  mask the presence of noise): the shift 
of the envelope 0-15 - down to 16-31 -  up (N4 interpreted as a 
sign); V3-0 - loudness; Tn, Nm,  Em - mask tones, noise, and 
the envelope resp., And if the mask pa VNA unity, then the 
corresponding element of sound is turned off; ts, ns = 1  - 
Signs that the current offset tone or noise / envelope  will be 
remembered. 

      + + +2 (2) displacement of period tone (positive - up, is 
negative - bottom). 

+? (?*(?+ 2)) - ornaments.

   + +0 (1) - loop

   + +1 (1) - end (1 = pattern of a single line)

   + 2 (?) - Data: the bias in semitones (0 = no bias, positive 
bias - up, negative - down). 

waiting for add-ons!

Add-on 10.xi.02:
1. (Sergey Bulba): Table of ASM or PSC has no relation to the 
respective editors. Modules of these editors to import the 
table Sound Tracker. Table ASM or PSC is designed so that when 
the clock frequency AY 1.7744 MHz notes in the editor coincided 
with the same notes of the piano. (Table Real Sound - 
Similarly, but for 1.75 MHz.) 2. The module can be used and the 
0-th sample, if the track he stored along with the ornament 
(can be null). Total 32 samples. 3. Verified information about 
the Portamento, Loop, and # B1. 4. Corrected information about 
the samples.