shithub: pt2-clone

ref: 71666cfc9fdb10b223032a30a4c0862af49c1e33
dir: /release/win32/protracker.ini/

View raw version
; 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