API tools faq
paste
Advertisement
GenesisFan64

ImpulseTracker format

GenesisFan64
Oct 25th, 2021 (edited)
228
0
Never
Add comment
Not a member of Pastebin yet? Sign Up, it unlocks many cool features!
text 54.00 KB | None | 0 0
raw download clone embed print report
  1.  
  2.  
  3. Impulse Header Layout
  4.  
  5. 0 1 2 3 4 5 6 7 8 9 A B C D E F
  6. ╔═══╦═══╦═══╦═══╦═══════════════════════════════════════════════╗
  7. 0000: ║'I'║'M'║'P'║'M'║ Song Name, max 26 characters, includes NULL ║
  8. ╠═══╩═══╩═══╩═══╩═══════════════════════════════════════╦═══════╣
  9. 0010: ║.......................................................║PHiligt║
  10. ╠═══════╦═══════╦═══════╦═══════╦═══════╦═══════╦═══════╬═══════╣
  11. 0020: ║OrdNum ║InsNum ║SmpNum ║PatNum ║ Cwt/v ║ Cmwt ║ Flags ║Special║
  12. ╠═══╦═══╬═══╦═══╬═══╦═══╬═══════╬═══════╩═══════╬═══════╩═══════╣
  13. 0030: ║GV ║MV ║IS ║IT ║Sep║PWD║MsgLgth║Message Offset ║ Reserved ║
  14. ╠═══╩═══╩═══╩═══╩═══╩═══╩═══════╩═══════════════╩═══════════════╣
  15. 0040: ║ Chnl Pan (64 bytes)...........................................║
  16. ╠═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╣
  17.  
  18. ╠═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╣
  19. 0080: ║ Chnl Vol (64 bytes)...........................................║
  20. ╠═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╣
  21.  
  22. ╠═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╣
  23. 00C0: ║ Orders, Length = OrdNum ║
  24. ╠═══════════════════════════════════════════════════════════════╣
  25. xxxx: ║ 'Long' Offset of instruments, Length = InsNum*4 (1) ║
  26. ╠═══════════════════════════════════════════════════════════════╣
  27. xxxx: ║ 'Long' Offset of samples headers, Length = SmpNum*4 (2) ║
  28. ╠═══════════════════════════════════════════════════════════════╣
  29. xxxx: ║ 'Long' Offset of patterns, Length = PatNum*4 (3) ║
  30. ╚═══════════════════════════════════════════════════════════════╝
  31.  
  32. (1) Offset = 00C0h+OrdNum
  33. (2) Offset = 00C0h+OrdNum+InsNum*4
  34. (3) Offset = 00C0h+OrdNum+InsNum*4+SmpNum*4
  35.  
  36. Note that if the (long) offset to a pattern = 0, then the
  37. pattern is assumed to be a 64 row empty pattern.
  38.  
  39. PHiligt = Pattern row hilight information. Only relevant for pattern
  40. editing situations.
  41.  
  42. Cwt: Created with tracker.
  43. Impulse Tracker y.xx = 0yxxh
  44. Cmwt: Compatible with tracker with version greater than value.
  45. (ie. format version)
  46. OrdNum: Number of orders in song.
  47. InsNum: Number of instruments in song
  48. SmpNum: Number of samples in song
  49. PatNum: Number of patterns in song
  50. Flags: Bit 0: On = Stereo, Off = Mono
  51. Bit 1: Vol0MixOptimizations - If on, no mixing occurs if
  52. the volume at mixing time is 0 (redundant v1.04+)
  53. Bit 2: On = Use instruments, Off = Use samples.
  54. Bit 3: On = Linear slides, Off = Amiga slides.
  55. Bit 4: On = Old Effects, Off = IT Effects
  56. Differences:
  57. - Vibrato is updated EVERY frame in IT mode, whereas
  58. it is updated every non-row frame in other formats.
  59. Also, it is two times deeper with Old Effects ON
  60. - Command Oxx will set the sample offset to the END
  61. of a sample instead of ignoring the command under
  62. old effects mode.
  63. - (More to come, probably)
  64. Bit 5: On = Link Effect G's memory with Effect E/F. Also
  65. Gxx with an instrument present will cause the
  66. envelopes to be retriggered. If you change a
  67. sample on a row with Gxx, it'll adjust the
  68. frequency of the current note according to:
  69.  
  70. NewFrequency = OldFrequency * NewC5 / OldC5;
  71. Bit 6: Use MIDI pitch controller, Pitch depth given by PWD
  72. Bit 7: Request embedded MIDI configuration
  73. (Coded this way to permit cross-version saving)
  74.  
  75. Special: Bit 0: On = song message attached.
  76. Song message:
  77. Stored at offset given by "Message Offset" field.
  78. Length = MsgLgth.
  79. NewLine = 0Dh (13 dec)
  80. EndOfMsg = 0
  81.  
  82. Note: v1.04+ of IT may have song messages of up to
  83. 8000 bytes included.
  84. Bit 1: Reserved
  85. Bit 2: Reserved
  86. Bit 3: MIDI configuration embedded
  87. Bit 4-15: Reserved
  88.  
  89. GV: Global volume. (0->128) All volumes are adjusted by this
  90. MV: Mix volume (0->128) During mixing, this value controls
  91. the magnitude of the wave being mixed.
  92. IS: Initial Speed of song.
  93. IT: Initial Tempo of song
  94. Sep: Panning separation between channels (0->128, 128 is max sep.)
  95. PWD: Pitch wheel depth for MIDI controllers
  96. Chnl Vol: Volume for each channel. Ranges from 0->64
  97. Chnl Pan: Each byte contains a panning value for a channel. Ranges from
  98. 0 (absolute left) to 64 (absolute right). 32 = central pan,
  99. 100 = Surround sound.
  100. +128 = disabled channel (notes will not be played, but note
  101. that effects in muted channels are
  102. still processed)
  103. Orders: This is the order in which the patterns are played.
  104. Valid values are from 0->199.
  105. 255 = "---", End of song marker
  106. 254 = "+++", Skip to next order
  108.  
  109. Old Impulse Instrument Format (cmwt < 200h)
  110.  
  111. 0 1 2 3 4 5 6 7 8 9 A B C D E F
  112. ╔═══╦═══╦═══╦═══╦═══════════════════════════════════════════════╗
  113. 0000: ║'I'║'M'║'P'║'I'║ DOS FileName (12345678.123) ║
  114. ╠═══╬═══╬═══╬═══╬═══╦═══╦═══╦═══╦═══════╦═══╦═══╦═══════╦═══╦═══╣
  115. 0010: ║00h║Flg║VLS║VLE║SLS║SLE║ x ║ x ║FadeOut║NNA║DNC║TrkVers║NoS║ x ║
  116. ╠═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══════╩═══╩═══╩═══════╩═══╩═══╣
  117. 0020: ║ Instrument Name, max 26 bytes, includes NUL...................║
  118. ╠═══════════════════════════════════════╦═══╦═══╦═══╦═══╦═══╦═══╣
  119. 0030: ║.......................................║ x ║ x ║ x ║ x ║ x ║ x ║
  120. ╠═══════════════════════════════════════╩═══╩═══╩═══╩═══╩═══╩═══╣
  121. 0040: ║ Note-Sample/Keyboard Table, Length = 240 bytes................║
  122. ╠═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╣
  123.  
  124. ╠═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╣
  125. 0130: ║ Volume envelope (200 bytes)...................................║
  126. ╠═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╣
  127.  
  128. ╠═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╣
  129. 01F8: ║ Node points (25x2 bytes)......║
  130. ╚═══════════════════════════════╝
  131.  
  132. Total length of old instrument header is 554 bytes.
  133.  
  134. Flg: Bit 0. On = Use volume envelope
  135. Bit 1. On = Use volume loop
  136. Bit 2. On = Use sustain volume loop
  137. VLS: Volume loop start (node number)
  138. VLE: Volume loop end (node number)
  139. SLS: Sustain loop start (node number)
  140. SLE: Sustain loop end (node number)
  141. FadeOut: Ranges between 0 and 64, but the fadeout "Count" is 512.
  142. Fade applied when:
  143. 1) Note fade NNA is selected and triggered (by another note)
  144. 2) Note off NNA is selected with no volume envelope
  145. or volume envelope loop
  146. 3) Volume envelope end is reached
  147.  
  148. DNC: Duplicate note check (0 = Off, 1 = On)
  149. NNA: New note action:
  150. 0 = Note cut
  151. 1 = Note continue
  152. 2 = Note off
  153. 3 = Note fade
  154.  
  155. TrkVers: Tracker version used to save the instrument. This is only
  156. used in the instrument files.
  157. NoS: Number of samples associated with instrument. This is only
  158. used in the instrument files.
  159.  
  160. Note-Sample/Keyboard Table.
  161. Each note of the instrument is first converted to a sample number
  162. and a note (C-0 -> B-9). These are stored as note/sample pairs
  163. (note first, range 0->119 for C-0 to B-9, sample ranges from
  164. 1-99, 0=no sample)
  165.  
  166. Volume envelope: Values from 0->64, 0FFh indicating end of envelope.
  167. (after which note fade applies)
  168.  
  169. Node data: Tick THEN magnitude
  170.  
  172.  
  173. Impulse Instrument Format
  174.  
  175. 0 1 2 3 4 5 6 7 8 9 A B C D E F
  176. ╔═══╦═══╦═══╦═══╦═══════════════════════════════════════════════╗
  177. 0000: ║'I'║'M'║'P'║'I'║ DOS FileName (12345678.123) ║
  178. ╠═══╬═══╬═══╬═══╬═══════╦═══╦═══╦═══╦═══╦═══╦═══╦═══════╦═══╦═══╣
  179. 0010: ║00h║NNA║DCT║DCA║FadeOut║PPS║PPC║GbV║DfP║RV ║RP ║TrkVers║NoS║ x ║
  180. ╠═══╩═══╩═══╩═══╩═══════╩═══╩═══╩═══╩═══╩═══╩═══╩═══════╩═══╩═══╣
  181. 0020: ║ Instrument Name, max 26 bytes, includes NUL...................║
  182. ╠═══════════════════════════════════════╦═══╦═══╦═══╦═══╦═══════╣
  183. 0030: ║.......................................║IFC║IFR║MCh║MPr║MIDIBnk║
  184. ╠═══════════════════════════════════════╩═══╩═══╩═══╩═══╩═══════╣
  185. 0040: ║ Note-Sample/Keyboard Table, Length = 240 bytes................║
  186. ╠═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╣
  187.  
  188. ╠═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╣
  189. 0130: ║ Envelopes.....................................................║
  190. ╠═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╣
  191.  
  192. NNA = New Note Action
  193. 0 = Cut 1 = Continue
  194. 2 = Note off 3 = Note fade
  195.  
  196. DCT = Duplicate Check Type
  197. 0 = Off 1 = Note
  198. 2 = Sample 3 = Instrument
  199.  
  200. DCA: Duplicate Check Action
  201. 0 = Cut
  202. 1 = Note Off
  203. 2 = Note fade
  204.  
  205. FadeOut: Ranges between 0 and 128, but the fadeout "Count" is 1024
  206. See the Last section on how this works.
  207. Fade applied when:
  208. 1) Note fade NNA is selected and triggered (by another note)
  209. 2) Note off NNA is selected with no volume envelope
  210. or volume envelope loop
  211. 3) Volume envelope end is reached
  212.  
  213. PPS: Pitch-Pan separation, range -32 -> +32
  214. PPC: Pitch-Pan center: C-0 to B-9 represented as 0->119 inclusive
  215.  
  216. GbV: Global Volume, 0->128
  217. DfP: Default Pan, 0->64, &128 => Don't use
  218. RV: Random volume variation (percentage)
  219. RP: Random panning variation (panning change - not implemented yet)
  220.  
  221. MCh = MIDI Channel
  222. MPr = MIDI Program (Instrument)
  223.  
  224. TrkVers: Tracker version used to save the instrument. This is only
  225. used in the instrument files.
  226. NoS: Number of samples associated with instrument. This is only
  227. used in the instrument files.
  228.  
  229. Note-Sample/Keyboard Table.
  230. Each note of the instrument is first converted to a sample number
  231. and a note (C-0 -> B-9). These are stored as note/sample byte pairs
  232. (note first, range 0->119 for C-0 to B-9, sample ranges from
  233. 1-99, 0=no sample)
  235. Envelope layout
  236.  
  237. Envelopes: 3 structures, first for volume (130h), second for
  238. panning (182h), third for pitch (1D4h).
  239.  
  240. Each is structured as such:
  241.  
  242. 0 1 2 3 4 5 6.......
  243. ╔═══╦═══╦═══╦═══╦═══╦═══╦═══════════════════════════════════╦═══╗
  244. xxxx: ║Flg║Num║LpB║LpE║SLB║SLE║ Node points, 25 sets, 75 bytes....║ x ║
  245. ╠═══╬═══╬═══╬═══╬═══╬═══╬═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╬═══╣
  246.  
  247. Flg: Bit 0: Envelope on/off, 1 = on, 0 = off
  248. Bit 1: Loop on/off, 1 = on, 0 = off
  249. Bit 2: SusLoop on/off, 1 = on, 0 = off
  250.  
  251. Num = Number of node points
  252.  
  253. LpB = Loop beginning SLB = Sustain loop beginning
  254. LpE = Loop end SLE = Sustain loop end
  255.  
  256. Node point = 1 byte for y-value
  257. (0->64 for vol, -32->+32 for panning or pitch)
  258. 1 word (2 bytes) for tick number (0->9999)
  259.  
  260. Total length of an instrument is 547 bytes, but 554 bytes are
  261. written, just to simplify the loading of the old format. (Hence
  262. there are 7 'wasted' bytes per instrument)
  263.  
  265.  
  266. Impulse Sample Format
  267.  
  268. 0 1 2 3 4 5 6 7 8 9 A B C D E F
  269. ╔═══╦═══╦═══╦═══╦═══════════════════════════════════════════════╗
  270. 0000: ║'I'║'M'║'P'║'S'║ DOS Filename (12345678.123) ║
  271. ╠═══╬═══╬═══╬═══╬═══════════════════════════════════════════════╣
  272. 0010: ║00h║GvL║Flg║Vol║ Sample Name, max 26 bytes, includes NUL.......║
  273. ╠═══╩═══╩═══╩═══╩═══════════════════════════════════════╦═══╦═══╣
  274. 0020: ║.......................................................║Cvt║DfP║
  275. ╠═══════════════╦═══════════════╦═══════════════╦═══════╩═══╩═══╣
  276. 0030: ║ Length ║ Loop Begin ║ Loop End ║ C5Speed ║
  277. ╠═══════════════╬═══════════════╬═══════════════╬═══╦═══╦═══╦═══╣
  278. 0040: ║ SusLoop Begin ║ SusLoop End ║ SamplePointer ║ViS║ViD║ViR║ViT║
  279. ╚═══════════════╩═══════════════╩═══════════════╩═══╩═══╩═══╩═══╝
  280.  
  281. The cache file has the following pieces of information added on:
  282.  
  283. 0 1 2 3 4 5 6 7 8 9 A B C D E F
  284. ╔═══════════════╦═══════╦═══════╦═══╦═══════════════════════════╗
  285. 0050: ║ File Size ║ Date ║ Time ║Fmt║...........................║
  286. ╚═══════════════╩═══════╩═══════╩═══╩═══════════════════════════╝
  287.  
  288. Fmt. 0 = unchecked. 1 = directory, 2 = it sample, 3 = st sample
  289.  
  290.  
  291. GvL: Global volume for instrument, ranges from 0->64
  292. Flg: Bit 0. On = sample associated with header.
  293. Bit 1. On = 16 bit, Off = 8 bit.
  294. Bit 2. On = stereo, Off = mono. Stereo samples not supported yet
  295. Bit 3. On = compressed samples.
  296. Bit 4. On = Use loop
  297. Bit 5. On = Use sustain loop
  298. Bit 6. On = Ping Pong loop, Off = Forwards loop
  299. Bit 7. On = Ping Pong Sustain loop, Off = Forwards Sustain loop
  300. Vol: Default volume for instrument
  301.  
  302. Length: Length of sample in no. of samples NOT no. of bytes
  303. LoopBeg: Start of loop (no of samples in, not bytes)
  304. Loop End: Sample no. AFTER end of loop
  305. C5Speed: Number of bytes a second for C-5 (ranges from 0->9999999)
  306. SusLBeg: Start of sustain loop
  307. SusLEnd: Sample no. AFTER end of sustain loop
  308.  
  309. SmpPoint: 'Long' Offset of sample in file.
  310.  
  311. ViS: Vibrato Speed, ranges from 0->64
  312. ViD: Vibrato Depth, ranges from 0->64
  313. ViT: Vibrato waveform type.
  314. 0=Sine wave
  315. 1=Ramp down
  316. 2=Square wave
  317. 3=Random (speed is irrelevant)
  318. ViR: Vibrato Rate, rate at which vibrato is applied (0->64)
  319.  
  320. The depth of the vibrato at any point is worked out in the following
  321. way:
  322. Every processing cycle, the following occurs:
  323. 1) Mov AX, [SomeVariableNameRelatingToVibrato]
  324. 2) Add AL, Rate
  325. 3) AdC AH, 0
  326. 4) AH contains the depth of the vibrato as a fine-linear slide.
  327. 5) Mov [SomeVariableNameRelatingToVibrato], AX ; For the next
  328. ; cycle.
  329.  
  330. For those that don't understand assembly, then the depth is
  331. basically the running-sum of the rate divided by 256.
  332.  
  333. Sample vibrato uses a table 256-bytes long
  334.  
  335. Convert - bits other than bit 0 are used internally for the loading
  336. of alternative formats.
  337. Bit 0:
  338. Off: Samples are unsigned } IT 2.01 and below use unsigned samples
  339. On: Samples are signed } IT 2.02 and above use signed samples
  340. Bit 1:
  341. Off: Intel lo-hi byte order for 16-bit samples } Safe to ignore
  342. On: Motorola hi-lo byte order for 16-bit samples } these values...
  343. Bit 2: }
  344. Off: Samples are stored as PCM values }
  345. On: Samples are stored as Delta values }
  346. Bit 3: }
  347. On: Samples are stored as byte delta values }
  348. (for PTM loader) }
  349. Bit 4: }
  350. On: Samples are stored as TX-Wave 12-bit values }
  351. Bit 5: }
  352. On: Left/Right/All Stereo prompt }
  353. Bit 6: Reserved
  354. Bit 7: Reserved
  355.  
  356. DfP - Default Pan. Bits 0->6 = Pan value, Bit 7 ON to USE (opposite of inst)
  357.  
  359.  
  360. Impulse Pattern Format
  361.  
  362. 0 1 2 3 4 5 6 7 8 9 A B C D E F
  363. ╔═══════╦═══════╦═══╦═══╦═══╦═══╦═══════════════════════════════╗
  364. 0000: ║Length ║ Rows ║ x ║ x ║ x ║ x ║ Packed data................ ║
  365. ╠═══╦═══╬═══╦═══╬═══╬═══╬═══╬═══╬═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╣
  366.  
  367. Length: Length of packed pattern, not including the 8 byte header
  368. Note that the pattern + the 8 byte header will ALWAYS
  369. be less than 64k
  370. Rows: Number of rows in this pattern (Ranges from 32->200)
  371.  
  372. Patterns are unpacked by the following pseudocode... (this may look
  373. horrible, but in practise, it's just as convenient as the S3M
  374. pattern format for playback (but not for display))
  375.  
  376. GetNextChannelMarker:
  377. Read byte into channelvariable.
  378. if(channelvariable = 0) then end of row
  379. Channel = (channelvariable-1) & 63 ; Channel is 0 based.
  380. if(channelvariable & 128) then read byte into maskvariable
  381. else maskvariable = previousmaskvariable for current channel
  382.  
  383. if(maskvariable & 1), then read note. (byte value)
  384. // Note ranges from 0->119 (C-0 -> B-9)
  385. // 255 = note off, 254 = notecut
  386. // Others = note fade (already programmed into IT's player
  387. // but not available in the editor)
  388.  
  389. if(maskvariable & 2), then read instrument (byte value)
  390. // Instrument ranges from 1->99
  391.  
  392. if(maskvariable & 4), then read volume/panning (byte value)
  393. // Volume ranges from 0->64
  394. // Panning ranges from 0->64, mapped onto 128->192
  395. // Prepare for the following also:
  396. // 65->74 = Fine volume up
  397. // 75->84 = Fine volume down
  398. // 85->94 = Volume slide up
  399. // 95->104 = Volume slide down
  400. // 105->114 = Pitch Slide down
  401. // 115->124 = Pitch Slide up
  402. // 193->202 = Portamento to
  403. // 203->212 = Vibrato
  404.  
  405. Effects 65 is equivalent to D0F, 66 is equivalent to D1F -> 74 = D9F
  406. Similarly for 75-84 (DFx), 85-94 (Dx0), 95->104 (D0x).
  407.  
  408. (Fine) Volume up/down all share the same memory (NOT shared with Dxx
  409. in the effect column tho).
  410.  
  411. Pitch slide up/down affect E/F/(G)'s memory - a Pitch slide
  412. up/down of x is equivalent to a normal slide by x*4
  413.  
  414. Portamento to (Gx) affects the memory for Gxx and has the equivalent
  415. slide given by this table:
  416.  
  417. SlideTable DB 1, 4, 8, 16, 32, 64, 96, 128, 255
  418.  
  419. Vibrato uses the same 'memory' as Hxx/Uxx.
  420.  
  421. if(maskvariable & 8), then read command (byte value) and commandvalue
  422. // Valid ranges from 0->31 (0=no effect, 1=A, 2=B, 3=C, etc.)
  423.  
  424. if(maskvariable & 16), then note = lastnote for channel
  425. if(maskvariable & 32), then instrument = lastinstrument for channel
  426. if(maskvariable & 64), then volume/pan = lastvolume/pan for channel
  427. if(maskvariable & 128), then {
  428. command = lastcommand for channel and
  429. commandvalue = lastcommandvalue for channel
  430. }
  431. Goto GetNextChannelMarker
  432.  
  434.  
  435. Mathematics
  436.  
  437. Abbreviations:
  438. FV = Final Volume (Ranges from 0 to 128). In versions 1.04+, mixed output
  439. devices are reduced further to a range from 0 to 64 due to lack of
  440. memory.
  441. Vol = Volume at which note is to be played. (Ranges from 0 to 64)
  442. SV = Sample Volume (Ranges from 0 to 64)
  443. IV = Instrument Volume (Ranges from 0 to 128)
  444. CV = Channel Volume (Ranges from 0 to 64)
  445. GV = Global Volume (Ranges from 0 to 128)
  446. VEV = Volume Envelope Value (Ranges from 0 to 64)
  447.  
  448. In Sample mode, the following calculation is done:
  449. FV = Vol * SV * CV * GV / 262144 ; Note that 262144 = 2^18
  450. ; So bit shifting can be done.
  451.  
  452. In Instrument mode the following procedure is used:
  453.  
  454. 1) Update volume envelope value. Check for loops / end of envelope.
  455. 2) If end of volume envelope (ie. position >= 200 or VEV = 0FFh), then turn
  456. on note fade.
  457. 3) If notefade is on, then NoteFadeComponent (NFC) = NFC - FadeOut
  458. ; NFC should be initialised to 1024 when a note is played.
  459. 4) FV = Vol * SV * IV * CV * GV * VEV * NFC / 2^41
  460.  
  461. Linear slides work like this:
  462. Final frequency = Original frequency * 2^(SlideValue/768)
  463.  
  464. (I used a lookup table for the multipliers here)
  465.  
  466. For command Exx, SlideValue = -4*EffectValue
  467. For command EEx, SlideValue = -EffectValue
  468. For command Fxx, SlideValue = 4*EffectValue
  469. For command FEx, SlideValue = EffectValue
  470.  
  471. Note that sample vibrato always uses Linear slides.
  472.  
  473. Notes about effects (as compared to other module formats)
  474.  
  475. C This is now in *HEX*. (Used to be in decimal in ST3)
  476. E/F/G/H/U You need to check whether the song uses Amiga/Linear slides.
  477. H/U Vibrato in Impulse Tracker is two times finer than in
  478. any other tracker and is updated EVERY tick.
  479. If "Old Effects" is *ON*, then the vibrato is played in the
  480. normal manner (every non-row tick and normal depth)
  481. E/F/G These commands ALL share the same memory.
  482. Oxx Offsets to samples are to the 'xx00th' SAMPLE. (ie. for
  483. 16 bit samples, the offset is xx00h*2)
  484. Oxx past the sample end will be ignored, unless "Old Effects"
  485. is ON, in which case the Oxx will play from the end of the
  486. sample.
  487. Yxy This uses a table 4 times larger (hence 4 times slower) than
  488. vibrato or tremelo. If the waveform is set to random, then
  489. the 'speed' part of the command is interpreted as a delay.
  490.  
  491. If you read through this document and there are ANY points which you have
  492. troubles with (and have to try out), then let me know - because someone
  493. else will have the same questions - and I'd like to make this DOC as easy
  494. to understand as possible.
  495.  
  496. For Panning....
  497. Here's the rough procedure used:
  498.  
  499. NotePan = ChannelPan
  500. if InstrumentPan=On then NotePan = InstrumentPan
  501. NotePan = NotePan+(InstrumentNote-PPCenter)*PPSeparation/8
  502.  
  503. Pitch Envelopes
  504. Each value on the envelope equates to half a semitone. This is interpolated
  505. 64 times for smooth pitch sliding. Positive values indicate a pitch variation
  506. UP of x semitones, negative values indicate a pitch variation down.
  507.  
  508. General Info
  509.  
  510. The player in Impulse Tracker 'allocates' channels to notes whenever they
  511. are *PLAYED*. In sample mode, the allocation is simple:
  512. Virtual Channel (number) = 'Host' channel (number)
  513.  
  514. In instrument mode, the following procedure is used:
  515.  
  516. Check if channel is already playing ---Yes--> set 'background' flag on.
  517. | 'Trigger' NNA. If NNA=cut,
  518. No then use this virtual
  519. | channel.
  520. | |
  521. |<------------------ else -----------------/
  522. |
  523. v
  524. Search and find the first non-active virtual channel.
  525. |
  526. Non-active channel found? ----Yes----> Use this for playback.
  527. |
  528. No
  529. |
  530. v
  531. Search through and find the channel of lowest volume that is in the #
  532. 'background' (ie. no longer controlled directly) #
  533. | #
  534. Background channel found? ----Yes----> Use this for playback. #
  535. | #
  536. No #
  537. | #
  538. v #
  539. Return error - the note is *NOT* allocated a channel, and hence is not #
  540. played. #
  541.  
  542. This is actually quite a simple process... just that it's another of
  543. those 'hassles' to have to write...
  544.  
  545. ### Note: This is by far the simplest implementation of congestion
  546. resolution. IT 2.03 and above have a greatly enhanced
  547. method which more selectively removes the most insignificant
  548. channel. Obviously, there is no best way to do this - I
  549. encourage you to experiment and find new algorithms for
  550. yourself.
  551.  
  553.  
  554. Internal Tables
  555.  
  556. FineSineData Label Byte
  557. DB 0, 2, 3, 5, 6, 8, 9, 11, 12, 14, 16, 17, 19, 20, 22, 23
  558. DB 24, 26, 27, 29, 30, 32, 33, 34, 36, 37, 38, 39, 41, 42, 43, 44
  559. DB 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 56, 57, 58, 59
  560. DB 59, 60, 60, 61, 61, 62, 62, 62, 63, 63, 63, 64, 64, 64, 64, 64
  561. DB 64, 64, 64, 64, 64, 64, 63, 63, 63, 62, 62, 62, 61, 61, 60, 60
  562. DB 59, 59, 58, 57, 56, 56, 55, 54, 53, 52, 51, 50, 49, 48, 47, 46
  563. DB 45, 44, 43, 42, 41, 39, 38, 37, 36, 34, 33, 32, 30, 29, 27, 26
  564. DB 24, 23, 22, 20, 19, 17, 16, 14, 12, 11, 9, 8, 6, 5, 3, 2
  565. DB 0, -2, -3, -5, -6, -8, -9,-11,-12,-14,-16,-17,-19,-20,-22,-23
  566. DB -24,-26,-27,-29,-30,-32,-33,-34,-36,-37,-38,-39,-41,-42,-43,-44
  567. DB -45,-46,-47,-48,-49,-50,-51,-52,-53,-54,-55,-56,-56,-57,-58,-59
  568. DB -59,-60,-60,-61,-61,-62,-62,-62,-63,-63,-63,-64,-64,-64,-64,-64
  569. DB -64,-64,-64,-64,-64,-64,-63,-63,-63,-62,-62,-62,-61,-61,-60,-60
  570. DB -59,-59,-58,-57,-56,-56,-55,-54,-53,-52,-51,-50,-49,-48,-47,-46
  571. DB -45,-44,-43,-42,-41,-39,-38,-37,-36,-34,-33,-32,-30,-29,-27,-26
  572. DB -24,-23,-22,-20,-19,-17,-16,-14,-12,-11, -9, -8, -6, -5, -3, -2
  573.  
  574. FineRampDownData Label Byte
  575. DB 64, 63, 63, 62, 62, 61, 61, 60, 60, 59, 59, 58, 58, 57, 57, 56
  576. DB 56, 55, 55, 54, 54, 53, 53, 52, 52, 51, 51, 50, 50, 49, 49, 48
  577. DB 48, 47, 47, 46, 46, 45, 45, 44, 44, 43, 43, 42, 42, 41, 41, 40
  578. DB 40, 39, 39, 38, 38, 37, 37, 36, 36, 35, 35, 34, 34, 33, 33, 32
  579. DB 32, 31, 31, 30, 30, 29, 29, 28, 28, 27, 27, 26, 26, 25, 25, 24
  580. DB 24, 23, 23, 22, 22, 21, 21, 20, 20, 19, 19, 18, 18, 17, 17, 16
  581. DB 16, 15, 15, 14, 14, 13, 13, 12, 12, 11, 11, 10, 10, 9, 9, 8
  582. DB 8, 7, 7, 6, 6, 5, 5, 4, 4, 3, 3, 2, 2, 1, 1, 0
  583. DB 0, -1, -1, -2, -2, -3, -3, -4, -4, -5, -5, -6, -6, -7, -7, -8
  584. DB -8, -9, -9,-10,-10,-11,-11,-12,-12,-13,-13,-14,-14,-15,-15,-16
  585. DB -16,-17,-17,-18,-18,-19,-19,-20,-20,-21,-21,-22,-22,-23,-23,-24
  586. DB -24,-25,-25,-26,-26,-27,-27,-28,-28,-29,-29,-30,-30,-31,-31,-32
  587. DB -32,-33,-33,-34,-34,-35,-35,-36,-36,-37,-37,-38,-38,-39,-39,-40
  588. DB -40,-41,-41,-42,-42,-43,-43,-44,-44,-45,-45,-46,-46,-47,-47,-48
  589. DB -48,-49,-49,-50,-50,-51,-51,-52,-52,-53,-53,-54,-54,-55,-55,-56
  590. DB -56,-57,-57,-58,-58,-59,-59,-60,-60,-61,-61,-62,-62,-63,-63,-64
  591.  
  592. FineSquareWave Label Byte
  593. DB 128 Dup (64), 128 Dup (0)
  594.  
  595. EmptyPattern Label
  596. DW 64, 64, 0, 0
  597. DB 64 Dup (0)
  598.  
  599. ;═══════════════════════════════════════════════════════════════════════════════
  600.  
  601. PitchTable Label DWord ; Values are 16.16 bit
  602. DW 2048, 0, 2170, 0, 2299, 0, 2435, 0, 2580, 0, 2734, 0 ; C-0
  603. DW 2896, 0, 3069, 0, 3251, 0, 3444, 0, 3649, 0, 3866, 0 ;>B-0
  604.  
  605. DW 4096, 0, 4340, 0, 4598, 0, 4871, 0, 5161, 0, 5468, 0 ; C-1
  606. DW 5793, 0, 6137, 0, 6502, 0, 6889, 0, 7298, 0, 7732, 0 ;>B-1
  607.  
  608. DW 8192, 0, 8679, 0, 9195, 0, 9742, 0, 10321, 0, 10935, 0
  609. DW 11585, 0, 12274, 0, 13004, 0, 13777, 0, 14596, 0, 15464, 0
  610.  
  611. DW 16384, 0, 17358, 0, 18390, 0, 19484, 0, 20643, 0, 21870, 0
  612. DW 23170, 0, 24548, 0, 26008, 0, 27554, 0, 29193, 0, 30929, 0
  613.  
  614. DW 32768, 0, 34716, 0, 36781, 0, 38968, 0, 41285, 0, 43740, 0
  615. DW 46341, 0, 49097, 0, 52016, 0, 55109, 0, 58386, 0, 61858, 0
  616.  
  617. DW 0, 1, 3897, 1, 8026, 1, 12400, 1, 17034, 1, 21944, 1
  618. DW 27146, 1, 32657, 1, 38496, 1, 44682, 1, 51236, 1, 58179, 1
  619.  
  620. DW 0, 2, 7794, 2, 16051, 2, 24800, 2, 34068, 2, 43888, 2
  621. DW 54292, 2, 65314, 2, 11456, 3, 23828, 3, 36936, 3, 50823, 3
  622.  
  623. DW 0, 4, 15588, 4, 32103, 4, 49600, 4, 2601, 5, 22240, 5
  624. DW 43048, 5, 65092, 5, 22912, 6, 47656, 6, 8336, 7, 36110, 7
  625.  
  626. DW 0, 8, 31176, 8, 64205, 8, 33663, 9, 5201, 10, 44481, 10
  627. DW 20559, 11, 64648, 11, 45823, 12, 29776, 13, 16671, 14, 6684, 15
  628.  
  629. DW 0, 16, 62352, 16, 62875, 17, 1790, 19, 10403, 20, 23425, 21
  630. DW 41118, 22, 63761, 23, 26111, 25, 59552, 26, 33342, 28, 13368, 30
  631.  
  632. FineLinearSlideUpTable Label ; Values are 16.16 bit
  633. DW 0, 1, 59, 1, 118, 1, 178, 1, 237, 1 ; 0->4
  634. DW 296, 1, 356, 1, 415, 1, 475, 1, 535, 1 ; 5->9
  635. DW 594, 1, 654, 1, 714, 1, 773, 1, 833, 1 ; 10->14
  636. DW 893, 1 ; 15
  637.  
  638. LinearSlideUpTable Label ; Value = 2^(Val/192), Values are 16.16 bit
  639. DW 0, 1, 237, 1, 475, 1, 714, 1, 953, 1 ; 0->4
  640. DW 1194, 1, 1435, 1, 1677, 1, 1920, 1, 2164, 1 ; 5->9
  641. DW 2409, 1, 2655, 1, 2902, 1, 3149, 1, 3397, 1 ; 10->14
  642. DW 3647, 1, 3897, 1, 4148, 1, 4400, 1, 4653, 1 ; 15->19
  643. DW 4907, 1, 5157, 1, 5417, 1, 5674, 1, 5932, 1 ; 20->24
  644. DW 6190, 1, 6449, 1, 6710, 1, 6971, 1, 7233, 1 ; 25->29
  645. DW 7496, 1, 7761, 1, 8026, 1, 8292, 1, 8559, 1 ; 30->34
  646. DW 8027, 1, 9096, 1, 9366, 1, 9636, 1, 9908, 1 ; 35->39
  647. DW 10181, 1, 10455, 1, 10730, 1, 11006, 1, 11283,1 ; 40->44
  648. DW 11560, 1, 11839, 1, 12119, 1, 12400, 1, 12682,1 ; 45->49
  649. DW 12965, 1, 13249, 1, 13533, 1, 13819, 1, 14106,1 ; 50->54
  650. DW 14394, 1, 14684, 1, 14974, 1, 15265, 1, 15557,1 ; 55->59
  651. DW 15850, 1, 16145, 1, 16440, 1, 16737, 1, 17034,1 ; 60->64
  652. DW 17333, 1, 17633, 1, 17933, 1, 18235, 1, 18538,1 ; 65->69
  653. DW 18842, 1, 19147, 1, 19454, 1, 19761, 1, 20070,1 ; 70->74
  654. DW 20379, 1, 20690, 1, 21002, 1, 21315, 1, 21629,1 ; 75->79
  655. DW 21944, 1, 22260, 1, 22578, 1, 22897, 1, 23216,1 ; 80->84
  656. DW 23537, 1, 23860, 1, 24183, 1, 24507, 1, 24833,1 ; 85->89
  657. DW 25160, 1, 25488, 1, 25817, 1, 26148, 1, 26479,1 ; 90->94
  658. DW 26812, 1, 27146, 1, 27481, 1, 27818, 1, 28155,1 ; 95->99
  659. DW 28494, 1, 28834, 1, 29175, 1, 29518, 1, 29862,1 ; 100->104
  660. DW 30207, 1, 30553, 1, 30900, 1, 31248, 1, 31599,1 ; 105->109
  661. DW 31951, 1, 32303, 1, 32657, 1, 33012, 1, 33369,1 ; 110->114
  662. DW 33726, 1, 34085, 1, 34446, 1, 34807, 1, 35170,1 ; 115->119
  663. DW 35534, 1, 35900, 1, 36267, 1, 36635, 1, 37004,1 ; 120->124
  664. DW 37375, 1, 37747, 1, 38121, 1, 38496, 1, 38872,1 ; 125->129
  665. DW 39250, 1, 39629, 1, 40009, 1, 40391, 1, 40774,1 ; 130->134
  666. DW 41158, 1, 41544, 1, 41932, 1, 42320, 1, 42710,1 ; 135->139
  667. DW 43102, 1, 43495, 1, 43889, 1, 44285, 1, 44682,1 ; 140->144
  668. DW 45081, 1, 45481, 1, 45882, 1, 46285, 1, 46690,1 ; 145->149
  669. DW 47095, 1, 47503, 1, 47917, 1, 48322, 1, 48734,1 ; 150->154
  670. DW 49147, 1, 49562, 1, 49978, 1, 50396, 1, 50815,1 ; 155->159
  671. DW 51236, 1, 51658, 1, 52082, 1, 52507, 1, 52934,1 ; 160->164
  672. DW 53363, 1, 53793, 1, 54224, 1, 54658, 1, 55092,1 ; 165->169
  673. DW 55529, 1, 55966, 1, 56406, 1, 56847, 1, 57289,1 ; 170->174
  674. DW 57734, 1, 58179, 1, 58627, 1, 59076, 1, 59527,1 ; 175->179
  675. DW 59979, 1, 60433, 1, 60889, 1, 61346, 1, 61805,1 ; 180->184
  676. DW 62265, 1, 62727, 1, 63191, 1, 63657, 1, 64124,1 ; 185->189
  677. DW 64593, 1, 65064, 1, 0, 2, 474, 2, 950, 2 ; 190->194
  678. DW 1427, 2, 1906, 2, 2387, 2, 2870, 2, 3355, 2 ; 195->199
  679. DW 3841, 2, 4327, 2, 4818, 2, 5310, 2, 5803, 2 ; 200->204
  680. DW 6298, 2, 6795, 2, 7294, 2, 7794, 2, 8296, 2 ; 205->209
  681. DW 8800, 2, 9306, 2, 9814, 2, 10323, 2, 10835,2 ; 210->214
  682. DW 11348, 2, 11863, 2, 12380, 2, 12899, 2, 13419,2 ; 215->219
  683. DW 13942, 2, 14467, 2, 14993, 2, 15521, 2, 16051,2 ; 220->224
  684. DW 16583, 2, 17117, 2, 17653, 2, 18191, 2, 18731,2 ; 225->229
  685. DW 19273, 2, 19817, 2, 20362, 2, 20910, 2, 21460,2 ; 230->234
  686. DW 22011, 2, 22565, 2, 23121, 2, 23678, 2, 24238,2 ; 235->239
  687. DW 24800, 2, 25363, 2, 25929, 2, 25497, 2, 27067,2 ; 240->244
  688. DW 27639, 2, 28213, 2, 28789, 2, 29367, 2, 29947,2 ; 245->249
  689. DW 30530, 2, 31114, 2, 31701, 2, 32289, 2, 32880, 2 ; 250->254
  690. DW 33473, 2, 34068, 2 ; 255->256
  691.  
  692. FineLinearSlideDownTable Label ; Values are 0.16 bit
  693. DW 65535, 65477, 65418, 65359, 65300, 65241, 65182, 65359 ; 0->7
  694. DW 65065, 65006, 64947, 64888, 64830, 64772, 64713, 64645 ; 8->15
  695.  
  696. LinearSlideDownTable Label ; Values are 0.16 bit
  697. DW 65535, 65300, 65065, 64830, 64596, 64364, 64132, 63901 ; 0->7
  698. DW 63670, 63441, 63212, 62984, 62757, 62531, 62306, 62081 ; 8->15
  699. DW 61858, 61635, 61413, 61191, 60971, 60751, 60532, 60314 ; 16->23
  700. DW 60097, 59880, 59664, 59449, 59235, 59022, 58809, 58597 ; 24->31
  701. DW 58386, 58176, 57966, 57757, 57549, 57341, 57135, 56929 ; 32->39
  702. DW 56724, 56519, 56316, 56113, 55911, 55709, 55508, 55308 ; 40->47
  703. DW 55109, 54910, 54713, 54515, 54319, 54123, 53928, 53734 ; 48->55
  704. DW 53540, 53347, 53155, 52963, 52773, 52582, 52393, 52204 ; 56->63
  705. DW 52016, 51829, 51642, 51456, 51270, 51085, 50901, 50718 ; 64->71
  706. DW 50535, 50353, 50172, 49991, 49811, 49631, 49452, 49274 ; 72->79
  707. DW 49097, 48920, 48743, 48568, 48393, 48128, 48044, 47871 ; 80->87
  708. DW 47699, 47527, 47356, 47185, 47015, 46846, 46677, 46509 ; 88->95
  709. DW 46341, 46174, 46008, 45842, 45677, 45512, 45348, 45185 ; 96->103
  710. DW 45022, 44859, 44698, 44537, 44376, 44216, 44057, 43898 ;104->111
  711. DW 43740, 43582, 43425, 43269, 43113, 42958, 42803, 42649 ;112->119
  712. DW 42495, 42342, 42189, 42037, 41886, 41735, 41584, 41434 ;120->127
  713. DW 41285, 41136, 40988, 40840, 40639, 40566, 40400, 40253 ;128->135
  714. DW 40110, 39965, 39821, 39678, 39535, 39392, 39250, 39109 ;136->143
  715. DW 38968, 38828, 38688, 38548, 38409, 38271, 38133, 37996 ;144->151
  716. DW 37859, 37722, 37586, 37451, 37316, 37181, 37047, 36914 ;152->159
  717. DW 36781, 36648, 36516, 36385, 36254, 36123, 35993, 35863 ;160->167
  718. DW 35734, 35605, 35477, 35349, 35221, 35095, 34968, 34842 ;168->175
  719. DW 34716, 34591, 34467, 34343, 34219, 34095, 33973, 33850 ;176->183
  720. DW 33728, 33607, 33486, 33365, 33245, 33125, 33005, 32887 ;184->191
  721. DW 32768, 32650, 32532, 32415, 32298, 32182, 32066, 31950 ;192->199
  722. DW 31835, 31720, 31606, 31492, 31379, 31266, 31153, 31041 ;200->207
  723. DW 30929, 30817, 30706, 30596, 30485, 30376, 30226, 30157 ;208->215
  724. DW 30048, 29940, 29832, 29725, 29618, 29511, 29405, 29299 ;216->223
  725. DW 29193, 29088, 28983, 28879, 28774, 28671, 28567, 28464 ;224->231
  726. DW 28362, 28260, 28158, 28056, 27955, 27855, 27754, 27654 ;232->239
  727. DW 27554, 27455, 27356, 27258, 27159, 27062, 26964, 26867 ;240->247
  728. DW 26770, 26674, 26577, 26482, 26386, 26291, 26196, 26102 ;248->255
  729. DW 26008 ; 256
  730.  
  731. ;═══════════════════════════════════════════════════════════════════════════════
  732.  
  733. Effect Info
  734.  
  735. Here's about all the info I can think of for effects. "Process" variables are
  736. variables used internally by effects to control the direction of playback..
  737. This section has not been completed yet.
  738.  
  739. First, here is the rough flow chart for processing information, it's not fully
  740. detailed, but all of the important steps are outlined.
  741.  
  742. ╔═════════════════════════════════════════════════════════╗
  743. ║ Set note volume to volume set for each channel ║
  744. ║ Set note frequency to frequency set for each channel ║
  745. ╚════════════╦════════════════════════════════════════════╝
  746. ║
  747. ╔════════════╩════════════╗
  748. ║ Decrease tick counter ║ Yes
  749. ║ Is tick counter 0 ? ╠═════════════════════════╗
  750. ╚════════════╦════════════╝ ║
  751. ║ ║
  752. No ║ ╔═════════════════════╩══════════════════╗
  753. ╔════════════╩════════════╗ ║ Tick counter = Tick counter set ║
  754. ║ Update effects for each ║ ║ (the current 'speed') ║
  755. ║ channel as required. ║ ║ Decrease Row counter. ║
  756. ║ ║ ║ Is row counter 0? ║
  757. ╚═══╦═════════════════════╝ ╚════════════╦══════════╦════════════════╝
  758. ║ No ║ ║
  759. ║ ╔═════════════════════╝ ║ Yes
  760. ║ ║ ║
  761. ║ ╔═════════════╩══════════════╗ ╔═══════════════╩════════════════╗
  762. ║ ║ Call update-effects for ║ ║ Row counter = 1 ║
  763. ║ ║ each channel. ║ ║ ║
  764. ║ ╚══════════════╦═════════════╝ ║ Increase ProcessRow ║
  765. ║ ║ ║ Is ProcessRow > NumberOfRows? ║
  766. ╠═════════════════╝ ╚════════╦══════════════════╦════╝
  767. ║ Yes ║ ║ No
  768. ║ ╔════════════════════════════════╩══════════════╗ ║
  769. ║ ║ ProcessRow = BreakRow ║ ║
  770. ║ ║ BreakRow = 0 ║ ║
  771. ║ ║ Increase ProcessOrder ║ ║
  772. ║ ║ while Order[ProcessOrder] = 0xFEh, ║ ║
  773. ║ ║ increase ProcessOrder ║ ║
  774. ║ ║ if Order[ProcessOrder] = 0xFFh, ║ ║
  775. ║ ║ ProcessOrder = 0 ║ ║
  776. ║ ║ CurrentPattern = Order[ProcessOrder] ║ ║
  777. ║ ╚═════════════════════╦═════════════════════════╝ ║
  778. ║ ║ ║
  779. ║ ╠═════════════════════════════╝
  780. ║ ║
  781. ║ ╔═════════════════════╩══════════════════════════╗
  782. ║ ║ CurrentRow = ProcessRow ║
  783. ║ ║ Update Pattern Variables (includes jumping to ║
  784. ║ ║ the appropriate row if requried and getting ║
  785. ║ ║ the NumberOfRows for the pattern) ║
  786. ║ ╚═════════════════════╦══════════════════════════╝
  787. ║ ║
  788. ╠═══════════════════════════════╝
  789. ║
  790. ╔═══╩═══════════════╗ Yes ╔═══════════════════════════════╗
  791. ║ Instrument mode? ╠══════════════════╣ Update Envelopes as required ║
  792. ╚═══╦═══════════════╝ ║ Update fadeout as required ║
  793. ║ ║ Calculate final volume if req ║
  794. ║ No (Sample mode) ║ Calculate final pan if req ║
  795. ║ ║ Process sample vibrato if req ║
  796. ╔═══╩═════════════════════════════════╗╚═══════════════╦═══════════════╝
  797. ║ Calculate final volume if required ║ ║
  798. ║ Calculate final pan if requried ║ ║
  799. ║ Process sample vibrato if required ║ ║
  800. ╚═══╦═════════════════════════════════╝ ║
  801. ║ ║
  802. ║ ║
  803. ╚═════════════════════════╦════════════════════════╝
  804. ║
  805. ╔════════════════╩══════════════════╗
  806. ║ Output sound!!! ║
  807. ╚═══════════════════════════════════╝
  808.  
  809. Axx Set Tempo
  810.  
  811. if (xx != 0) {
  812. Maxtick = xx;
  813. Currenttick = xx;
  814. }
  815.  
  816. Bxx Jump to Order
  817.  
  818. ProcessOrder = xx - 1;
  819. ProcessRow = 0xFFFE; // indicates new pattern internally for IT...
  820.  
  821. Cxx Break to Row
  822.  
  823. BreakRow = xx;
  824. ProcessRow = 0xFFFE;
  825.  
  826. Dxx Volume slide down
  827.  
  828. if (xx == 0) then xx = last xx for (Dxx/Kxx/Lxx) for this channel.
  829.  
  830. Order of testing: Dx0, D0x, DxF, DFx
  831.  
  832. Dx0 Set effect update for channel enabled if channel is ON.
  833. If x = F, then slide up volume by 15 straight away also (for S3M compat)
  834. Every update, add x to the volume, check and clip values > 64 to 64
  835. D0x Set effect update for channel enabled if channel is ON.
  836. If x = F, then slide down volume by 15 straight away also (for S3M)
  837. Every update, subtract x from the volume, check and clip values < 0 to 0
  838. DxF Add x to volume straight away. Check and clip values > 64 to 64
  839. DFx Subtract x from volume straight away. Check and clip values < 0 to 0
  840.  
  841. Hxy Vibrato
  842.  
  843. if (x != 0) {
  844. speed = 4*x;
  845. }
  846. if (y != 0) {
  847. depth = y * 4;
  848. if(OldEffects) depth <<= 1;
  849. }
  850. Set effect update for channel enabled if channel is ON.
  851. Goto InitVibrato (explained later)
  852.  
  853. Ixy Tremor, ontime x, offtime y
  854.  
  855. if (x != 0) {
  856. ontime = x;
  857. if (oldeffects) ontime++;
  858. }
  859. if (y != 0) {
  860. offtime = y;
  861. if (oldeffects) offtime++;
  862. }
  863.  
  864. Nxx Channel volume slide down
  865.  
  866. if (xx == 0) then xx = last Nxx for this channel.
  867.  
  868. Order of testing: Nx0, N0x, NxF, NFx
  869.  
  870. Nx0 Set effect update for channel enabled.
  871. Every update, add x to the volume, check and clip values > 64 to 64
  872. N0x Set effect update for channel enabled.
  873. Every update, subtract x from the volume, check and clip values < 0 to 0
  874. NxF Add x to volume straight away. Check and clip values > 64 to 64
  875. NFx Subtract x from volume straight away. Check and clip values < 0 to 0
  876.  
  877. Uxy Fine Vibrato
  878.  
  879. if (x != 0) {
  880. speed = 4*x;
  881. }
  882. if (y != 0) {
  883. depth = y;
  884. if(OldEffects) depth <<= 1;
  885. }
  886. Set effect update for channel enabled if channel is ON.
  887. Goto InitVibrato (explained later)
  888.  
  889. Wxx Global volume slide down
  890.  
  891. if (xx == 0) then xx = last Wxx for this channel.
  892.  
  893. Order of testing: Wx0, W0x, WxF, WFx
  894.  
  895. Wx0 Set effect update for channel enabled.
  896. Every update, add x to the volume, check and clip values > 128 to 128
  897. W0x Set effect update for channel enabled.
  898. Every update, subtract x from the volume, check and clip values < 0 to 0
  899. WxF Add x to volume straight away. Check and clip values > 128 to 128
  900. WFx Subtract x from volume straight away. Check and clip values < 0 to 0
  901.  
  902. .. sorry this is incomplete..
  903.  
  904.  
  905.  
  906.  
Advertisement
Add Comment
Please, Sign In to add comment
Advertisement
Public Pastes
Advertisement
We use cookies for various purposes including analytics. By continuing to use Pastebin, you agree to our use of cookies as described in the Cookies Policy.  OK, I Understand
Not a member of Pastebin yet?
Sign Up, it unlocks many cool features!