165 lines
5.9 KiB
OpenEdge ABL
165 lines
5.9 KiB
OpenEdge ABL
P61mode =2 ;Try other modes ONLY IF there are no Fxx commands >= 20.
|
|
;(f.ex., P61.new_ditty only works with P61mode=1)
|
|
|
|
|
|
;; --- options common to all P61modes ---
|
|
|
|
usecode =-1 ;CHANGE! to the USE hexcode from P61con for a big
|
|
;CPU-time gain! (See module usecodes at end of source)
|
|
;Multiple songs, single playroutine? Just "OR" the
|
|
;usecodes together!
|
|
|
|
;...STOP! Have you changed it yet!? ;)
|
|
;You will LOSE RASTERTIME AND FEATURES if you don't.
|
|
|
|
P61pl=usecode&$400000
|
|
|
|
split4 =0 ;Great time gain, but INCOMPATIBLE with F03, F02, and F01
|
|
;speeds in the song! That's the ONLY reason it's default 0.
|
|
;So ==> PLEASE try split4=1 in ANY mode!
|
|
;Overrides splitchans to decrunch 1 chan/frame.
|
|
;See ;@@ note for P61_SetPosition.
|
|
|
|
|
|
splitchans=1 ;#channels to be split off to be decrunched at "playtime frame"
|
|
;0=use normal "decrunch all channels in the same frame"
|
|
;Experiment to find minimum rastertime, but it should be 1 or 2
|
|
;for 3-4 channels songs and 0 or 1 with less channels.
|
|
|
|
visuctrs=1 ;enables visualizers in this example: P61_visuctr0..3.w
|
|
;containing #frames (#lev6ints if cia=1) elapsed since last
|
|
;instrument triggered. (0=triggered this frame.)
|
|
;Easy alternative to E8x or 1Fx sync commands.
|
|
|
|
asmonereport =0 ;ONLY for printing a settings report on assembly. Use
|
|
;if you get problems (only works in AsmOne/AsmPro, tho)
|
|
|
|
p61system=0 ;1=system-friendly. Use for DOS/Workbench programs.
|
|
|
|
p61exec =0 ;0 if execbase is destroyed, such as in a trackmo.
|
|
|
|
p61fade =0 ;enable channel volume fading from your demo
|
|
|
|
channels=4 ;<4 for game sound effects in the higher channels. Incompatible
|
|
; with splitchans/split4.
|
|
|
|
playflag=0 ;1=enable music on/off capability (at run-time). .If 0, you can
|
|
;still do this by just, you know, not calling P61_Music...
|
|
;It's a convenience function to "pause" music in CIA mode.
|
|
|
|
p61bigjtab=0 ;1 to waste 480b and save max 56 cycles on 68000.
|
|
|
|
opt020 =0 ;1=enable optimizations for 020+. Please be 68000 compatible!
|
|
;splitchans will already give MUCH bigger gains, and you can
|
|
;try the MAXOPTI mode.
|
|
|
|
p61jump =0 ;0 to leave out P61_SetPosition (size gain)
|
|
;1 if you need to force-start at a given position fex in a game
|
|
|
|
C =0 ;If you happen to have some $dffxxx value in a6, you can
|
|
;change this to $xxx to not have to load it before P61_Music.
|
|
|
|
clraudxdat=0 ;enable smoother start of quiet sounds. probably not needed.
|
|
|
|
optjmp =1 ;0=safety check for jump beyond end of song. Clear it if you
|
|
;play unknown P61 songs with erroneous Bxx/Dxx commands in them
|
|
|
|
oscillo =0 ;1 to get a sample window (ptr, size) to read and display for
|
|
;oscilloscope type effects (beta, noshorts=1, pad instruments)
|
|
;IMPORTANT: see ;@@ note about chipmem dc.w buffer.
|
|
|
|
quietstart=0 ;attempt to avoid the very first click in some modules
|
|
;IMPORTANT: see ;@@ note about chipmem dc.w buffer.
|
|
|
|
use1Fx=0 ;Optional extra effect-sync trigger (*). If your module is free
|
|
;from E commands, and you add E8x to sync stuff, this will
|
|
;change the usecode to include a whole code block for all E
|
|
;commands. You can avoid this by only using 1Fx. (You can
|
|
;also use this as an extra sync command if E8x is not enough,
|
|
;of course.)
|
|
|
|
;(*) Slideup values>116 causes bugs in Protracker, and E8 causes extra-code
|
|
;for all E-commands, so I used this. It's only faster if your song contains 0
|
|
;E-commands, so it's only useful to a few, I guess. Bit of cyclemania. :)
|
|
|
|
;Just like E8x, you will get the trigger after the P61_Music call, 1 frame
|
|
;BEFORE it's heard. This is good, because it allows double-buffered graphics
|
|
;or effects running at < 50 fps to show the trigger synced properly.
|
|
|
|
|
|
|
|
;; --- CIA mode options (default) ---
|
|
|
|
ifeq P61mode-1
|
|
|
|
p61cia =1 ;call P61_Music on the CIA interrupt instead of every frame.
|
|
|
|
lev6 =1 ;1=keep the timer B int at least for setting DMA.
|
|
;0="FBI mode" - ie. "Free the B-timer Interrupt".
|
|
|
|
;0 requires noshorts=1, p61system=0, and that YOU make sure DMA
|
|
;is set at 11 scanlines (700 usecs) after P61_Music is called.
|
|
;AsmOne will warn you if requirements are wrong.
|
|
|
|
;DMA bits will be poked in the address you pass in A4 to
|
|
;P61_init. (Update P61_DMApokeAddr during playing if necessary,
|
|
;for example if switching Coppers.)
|
|
|
|
;P61_Init will still save old timer B settings, and initialize
|
|
;it. P61_End will still restore timer B settings from P61_Init.
|
|
;So don't count on it 'across calls' to these routines.
|
|
;Using it after P61_Init and before P61_End is fine.
|
|
|
|
noshorts=0 ;1 saves ~1 scanline, requires Lev6=0. Use if no instrument is
|
|
;shorter than ~300 bytes (or extend them to > 300 bytes).
|
|
;It does this by setting repeatpos/length the next frame
|
|
;instead of after a few scanlines,so incompatible with MAXOPTI
|
|
|
|
dupedec =0 ;0=save 500 bytes and lose 26 cycles - I don't blame you. :)
|
|
;1=splitchans or split4 must be on.
|
|
|
|
suppF01 =1 ;0 is incompatible with CIA mode. It moves ~100 cycles of
|
|
;next-pattern code to the less busy 2nd frame of a notestep.
|
|
;If you really need it, you have to experiment as the support
|
|
;is quite complex. Basically set it to 1 and try the various
|
|
;P61modes, if none work, change some settings.
|
|
|
|
endc
|
|
|
|
;; --- VBLANK mode options ---
|
|
|
|
ifeq P61mode-2
|
|
|
|
p61cia =0
|
|
lev6 =1 ;still set sound DMA with a simple interrupt.
|
|
noshorts=0 ;try 1 (and pad short instruments if nec) for 1 scanline gain
|
|
dupedec =0
|
|
suppF01 =P61pl ;if 1, split4=1 may cause sound errors. but try it anyway. :)
|
|
|
|
endc
|
|
|
|
;; --- COPPER mode options ---
|
|
|
|
ifeq P61mode-3
|
|
|
|
p61cia =0
|
|
lev6 =0 ;don't set sound DMA with an interrupt.
|
|
;(use the copper to set sound DMA 11 scanlines after P61_Music)
|
|
noshorts=1 ;You must pad instruments < 300 bytes for this mode to work.
|
|
dupedec =0
|
|
suppF01 =P61pl ;if 1, split4=1 may cause sound errors. but try it anyway. :)
|
|
|
|
endc
|
|
|
|
;; --- MAXOPTI mode options ---
|
|
|
|
ifeq P61mode-4
|
|
|
|
p61cia =0
|
|
lev6 =0
|
|
noshorts=1 ;You must pad instruments < 300 bytes for this mode to work.
|
|
dupedec =1
|
|
suppF01 =P61pl ;if 1, split4=1 may cause sound errors. but try it anyway. :)
|
|
|
|
endc
|