ref: f2c806cb2ade67461ccb8d05c604ff2ad715e75a
dir: /release/win32/protracker.ini/
; ProTracker 2 clone config file ; ; [] is a category, doesn't affect parsing ; ; is a comment, and also doesn't affect parsing ; ; If a duplicate setting is found, the one closest to the end of the ; file will be used. ; If a setting is invalid or not entered, it will use the default value. ; ; Syntax: ; ENTRY=VALUE (only strings can have spaces!) ; [VIDEO SETTINGS] ; Video scaling factor ; Syntax: 1X, 2X, 3X ... 9X ; Default value: 2X ; Comment: Sets the video scaling factor (window rendering size). ; 1X = 320x255 (no scaling) ; 2X = 640x510 (default) ; 3x = 960x765 ; 4x = 1280x1020 ; 5x = 1600x1275 ; 6x = 1920x1530 ; 7x = 2240x1785 ; 8x = 2560x2040 ; 9x = 2880x2295 ; VIDEOSCALE=2X ; Start in fullscreen mode ; Syntax: TRUE or FALSE ; Default value: FALSE ; FULLSCREEN=FALSE ; Filtering of upscaled pixels ; Syntax: NEAREST, LINEAR, BEST ; Default value: NEAREST ; Comment: Setting it to LINEAR or BEST will smooth out the pixels ; and make them less grainy. ; PIXELFILTER=NEAREST ; Integer scaling of pixels ; Syntax: TRUE or FALSE ; Default value: TRUE ; Comment: If the image is not completely stretched out vertically ; in fullscreen mode, disabling this option will make it do so. ; The aspect ratio will be maintained. However, the pixels might not ; look perfect. This is best used together with PIXELFILTER=LINEAR ; (or BEST). The image will look blurry though... ; INTEGERSCALING=TRUE ; Make fullscreen mode completely stretch out the image to fit the whole screen ; Syntax: TRUE or FALSE ; Default value: FALSE ; Comment: Setting this to TRUE will in most cases ruin the aspect ; ratio of the image. Please look at the INTEGERSCALING option as well. ; FULLSCREENSTRETCH=FALSE ; Turn off vsync ; Syntax: TRUE or FALSE ; Default value: FALSE ; Comment: Turns off vsync for less input delay (mouse/keyboard). ; However, it will introduce more video stuttering at random times. ; VSYNCOFF=FALSE ; Use hardware mouse ; Syntax: TRUE or FALSE ; Default value: TRUE ; Comment: Disables software mouse and uses the mouse in your OS. ; This can feel more comfortable for some users because of less latency. ; Some systems might need it to be set FALSE for the mouse to function ; at all. ; HWMOUSE=TRUE [GENERAL SETTINGS] ; Hide last modification dates in Disk Op. to get longer dir/file names ; Syntax: TRUE or FALSE ; Default value: FALSE ; HIDEDISKOPDATES=FALSE ; Compo mode: Stop song after reaching song end ; Syntax: TRUE or FALSE ; Default value: FALSE ; Comment: For music competitions. Stops the song after reaching ; song end so that you don't have to sit there and press STOP at ; the right moment. ; COMPOMODE=FALSE ; Close Disk Op. after loading a module ; Syntax: TRUE or FALSE ; Default value: TRUE ; AUTOCLOSEDISKOP=TRUE ; Remember play mode after loading a module in Disk Op. ; Syntax: TRUE or FALSE ; Default value: FALSE ; Comment: If set to TRUE and you were playing while loading a mod, ; it will not stop playback on load. ; Works best with AUTOCLOSEDISKOP set to FALSE. (like FT2) ; REMEMBERPLAYMODE=FALSE ; Blank sample number (first digit) aka. "BLANKZERO" setting in PT ; Syntax: TRUE or FALSE ; Default value: FALSE ; Comment: Setting it to TRUE removes the first sample number ; digit in the pattern viewer, if it's zero. E.g. "0F" -> " F". ; This mode is always enabled if PATTDOTS is set to true. BLANKZERO=FALSE ; Real VU-meters ; Syntax: TRUE or FALSE ; Default value: FALSE ; Comment: Setting it to TRUE will render real VU-meters which ; are updated from the audio mixer. Works best with lower ; audio latencies. ; REALVUMETERS=FALSE ; Show dots instead of zeroes ; Syntax: TRUE or FALSE ; Default value: FALSE ; Comment: Setting it to TRUE will display dots for empty slots ; in the pattern viewer. Slightly easier on the eye, but ruins the ; authentic ProTracker look. ; PATTDOTS=FALSE ; The way of displaying notes ; Syntax: SHARP or FLAT ; Default value: SHARP ; Comment: Setting it to FLAT will display notes differently. ; E.g. C#2 will be Db2. ; ACCIDENTAL=SHARP ; Quantize value for notes in record mode ; Syntax: 0 to 63 ; Default value: 1 ; Comment: Will move the notes you record to every n'th row. ; Entering 0 will turn off the quantizing, and the notes you play ; will always be inserted at the row you are at. ; Entering 1 will quantize the notes the the nearest row according ; to the speed. i.e. if you play a note after the first half has been ; played, it will be quantized to the row below. ; Entering a value like 8 will quantize to every 8th row, and so on. ; QUANTIZE=1 ; Delete out of range notes on transpose ; Syntax: TRUE or FALSE ; Default value: FALSE ; Comment: If enabled, all the notes transposed out of range ; (C-1 to B-3) will be deleted. If not, they will not be transposed. ; TRANSDEL=FALSE ; Set default modules directory for Disk Op. read/load/save ; Stynax: Text string ; Default value: ; Max length: Varies... 260 characters on Windows, more on other OSes. ; Comment: If it is blank, then it will use the current dir. ; Don't use quotes! Path can be relative if wanted, but keep in mind ; that on macOS/Linux the initial path on run will be $HOME. ; GNU/Linux note: Path is case-sensitive and must not end with / ; DEFAULTDIR= ; Set default samples directory for Disk Op. read/load/save ; Stynax: Text string ; Default value: ; Max length: Varies... 260 characters on Windows, more on other OSes. ; Comment: If it is blank, then it will use the current dir. ; Don't use quotes! Path can be relative if wanted, but keep in mind ; that on macOS/Linux the initial path on run will be $HOME. ; GNU/Linux note: Path is case-sensitive and must not end with / ; DEFAULTSMPDIR= ; "mod.filename" saving ; Syntax: TRUE or FALSE ; Default value: FALSE ; Comment: Setting it to TRUE changes MOD saving to ext.filename. ; This is handy for editing songs made on the Amiga. ; Setting it to FALSE changes it to filename.ext (f.ex. mysong.mod) ; MODDOT=FALSE ; Draw a center line in the SAMPLER screen's waveform ; Syntax: TRUE or FALSE ; Default value: TRUE ; Comment: This used to draw a dotted line, but now draws a line instead ; DOTTEDCENTER=TRUE [AUDIO SETTINGS] ; Audio output frequency ; Syntax: Number, in hertz ; Default value: 48000 ; Comment: Ranges from 44100 to 192000. 96000 is recommended if your ; OS is set to mix shared audio at 96kHz or higher. ; FREQUENCY=48000 ; Audio input frequency ; Syntax: Number, in hertz ; Default value: 44100 ; Comment: Ranges from 44100 to 192000. This should be set to match ; the frequency used for your audio input device (for sampling). ; SAMPLINGFREQ=44100 ; Normalize sampled audio before converting to 8-bit ; Syntax: TRUE or FALSE ; Default value: TRUE ; Comment: This one is for the audio sampling feature in the SAMPLER ; screen. If it's set to TRUE, it will normalize the gain before it ; converts the sample to 8-bit in the end. This will preserve as much ; amplitude information as possible to lower quantization noise. ; NORMALIZESAMPLING=TRUE ; Audio buffer size ; Syntax: Number, in samples ; Default value: 1024 ; Comment: Ranges from 128 to 8192. Should be a number that is 2^n ; (128, 256, 512, 1024, 2048, 4096, 8192, ...). The number you input ; isn't necessarily the actual value the audio API decides to use. ; Lower means less audio latency but possible audio issues, higher ; means more audio latency but less chance for issues. ; BUFFERSIZE=1024 ; Amiga 500 low-pass filter (not the "LED" filter) ; Syntax: TRUE or FALSE ; Default value: FALSE ; Comment: Enabling this will simulate the ~4421Hz 6dB/oct RC low-pass ; filter present in almost all Amigas. This will make the sound a bit ; muddier. On Amiga 1200, the cut-off is ~34kHz (sharper sound). This ; can also be toggled in the tracker by pressing F12. This must not be ; confused with the "LED" filter which can be toggled with the pattern ; command E0x. ; A500LOWPASSFILTER=FALSE ; Stereo separation ; Syntax: 0 to 100 (percent) ; Default value: 20 (good value for headphones) ; Comment: Set to 100 for the hard panning Amiga uses. ; Set to 0 for mono, which might be preferred in some cases. ; STEREOSEPARATION=20 ; Low-pass samples before getting 2x downsampled during loading (if requested) ; Syntax: TRUE or FALSE ; Default value: TRUE ; Comment: Set to false if you want slightly sharper sound when loading ; samples that are 2x downsampled (if requested). ; Keep in mind that you might get more aliasing in the sound if you ; disable this, and certain sounds with a lot of treble might sound ; weird (f.ex. hi-hats and cymbals). If the sample you load have a ; frequency below 22kHz, it will never be downsampled (and thus this ; setting changes nothing). I recommend keeping this set to TRUE. ; SAMPLELOWPASS=TRUE ; End of config file