ref: cc40820c1883d2ef3a4f7cde62f5818f4204f7c7
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!) ; [SAMPLE LENGTH LIMIT] ; Limit samples to 64kB (65534/$FFFE), like intended in ProTracker ; Syntax: TRUE or FALSE ; Default value: TRUE ; Comment: Setting it to FALSE will remove the 64kB (65534/$FFFE) sample ; length limit and support 128kB samples (131070/$1FFFE). ; Keep in mind that >64kB samples are not officially supported in most ; ProTracker trackers and replayers, and will often result in bugs. ; ; CAUTION: The 9xx command (Set Sample Offset) doesn't work at all if ; the sample length is above 65534/$FFFE. This is a known bug ; in all ProTracker versions. I am not fixing this bug as I ; want to keep the ProTracker 2.3D replayer quirks. ; ; Please do not change this setting unless you're aware of the problems ; you might face when creating >64k-sample PT MODs! Also do remember ; that since this feature is off by default, most people will not be ; able to listen to 128kB modules in the PT2 clone out of the box. ; 64K_LIMIT=TRUE [VIDEO SETTINGS] ; Video upscaling factor ; Syntax: AUTO, 1X, 2X, 3X, 4X ... 16X ; Default value: AUTO ; Comment: Sets the video upscaling factor (window size). ; AUTO = Auto-fit (tries to find the optimal value for the screen) ; 1X = 320x255 (no scaling) ; 2X = 640x510 ; 3X = 960x765 ; 4x = 1280x1020 ; ...and so on up to 16X ; (width = 320*x, height = 255*x) ; VIDEOSCALE=AUTO ; 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] ; "Edit mode" + step-play (return/backspace) behavior ; Syntax: TRUE or FALSE ; Default value: FALSE ; Comment: If set to true and you use step-play in edit mode, then ; edit mode will be kept when the step-play is done. ; STEPPLAY_KEEP_EDITMODE=FALSE ; Don't show downsample dialog after loading a sample whose frequency is >22kHz. ; Syntax: TRUE or FALSE ; Default value: FALSE ; NO_DWNSMP_ON_SMP_LOAD=FALSE ; 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 ; Disable the Karplus-Strong (E8x) ProTracker replayer effect ; Syntax: TRUE or FALSE ; Default value: FALSE ; Comment: This ProTracker command low-pass filters the current sample. ; It's a little used effect despite being present in original PT, ; and it was often replaced for syncing visuals with the music in ; demos. You can turn it off if you need to. ; DISABLE_E8X=FALSE [AUDIO SETTINGS] ; Audio output frequency ; Syntax: Number, in hertz ; Default value: 48000 ; Comment: Ranges from 44100 to 192000. Does not apply to MOD2WAV. ; 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 ; MOD2WAV output frequency ; Syntax: Number, in hertz ; Default value: 44100 ; Comment: Ranges from 44100 to 192000. ; MOD2WAVFREQUENCY=44100 ; Filter model (Amiga model) ; Syntax: A500 or A1200 ; Default value: A1200 ; Comment: Selects what kind of Amiga to simulate (lp/hp filters). ; A1200 has sharper sound but more aliasing, while A500 has more ; filtered (muddy) sound but less aliasing. The filter model can ; also be toggled by pressing F12 in the program. ; FILTERMODEL=A1200 ; 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 ; Audio buffer size ; Syntax: Number, in unit of samples (not bytes) ; 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 ; End of config file