.\" Automatically generated by Pod::Man 4.11 (Pod::Simple 3.35) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "SIDPLAYFP.INI 5" .TH SIDPLAYFP.INI 5 "2021-09-16" "perl v5.30.0" "File formats" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" sidplayfp.ini \- Configuration file for sidplayfp(1). .SH "DESCRIPTION" .IX Header "DESCRIPTION" This page describes the options available for the configuration file of Sidplayfp. It is composed by a number of sections, each one composed by a section name, enclosed by square brackets, followed by a list of = lines. .PP \&\fBsidplayfp.ini\fR supports the following sections: .PP \&\fB[SIDPlayfp]\fR \- Generic configuration .PP \&\fB[Console]\fR \- Console appearance configuration .PP \&\fB[Audio]\fR \- Audio output configuration .PP \&\fB[Emulation]\fR \- Emulation engine parameters .PP All options and values are described in detail below. .PP For any of the following parameter, if it's specified more than one time the last entry encountered will be used. .PP \&\fB\s-1NOTE\s0\fR: if any of these options is specified outside its section, it will be \fIignored\fR. .SS "SIDPlayfp" .IX Subsection "SIDPlayfp" .IP "\fBVersion\fR=\fI\fR" 4 .IX Item "Version=" Configuration version .IP "\fBSonglength Database\fR=\fI\fR" 4 .IX Item "Songlength Database=" Full path for the Songlength \s-1DB.\s0 By default the program will look for a file named \fIDOCUMENTS/Songlengths.txt\fR under the \s-1HVSC\s0 collection path, if the \s-1HVSC_BASE\s0 environment variable is defined. On *NIX systems, if this value is not set, \fBsidplayfp\fR\|(1) will try \fI\f(CI$PREFIX\fI/share/sidplayfp/Songlengths.txt\fR. .IP "\fBDefault Play Length\fR=\fI\s-1MM:SS\s0.mmm\fR" 4 .IX Item "Default Play Length=MM:SS.mmm" Default play time if Songlength Database is not found. .IP "\fBDefault Record Length\fR=\fI\s-1MM:SS\s0.mmm\fR" 4 .IX Item "Default Record Length=MM:SS.mmm" Default recording time when writing wave files if Songlength Database is not found. .IP "\fBKernal Rom\fR=\fI\fR" 4 .IX Item "Kernal Rom=" Full path for the Kernal Rom file. This is the most important rom and should always be provided, although many tunes will still work without. By default the program will look for a file named \fIkernal\fR under the following locations: .RS 4 .IP "\(bu" 4 \&\f(CW$XDG_DATA_HOME\fR/sidplayfp/ .Sp on *NIX systems where \s-1XDG_DATA_HOME\s0 is defined. .IP "\(bu" 4 \&\f(CW$HOME\fR/.local/share/sidplayfp/ .Sp on *NIX systems where \s-1XDG_DATA_HOME\s0 is not defined. .IP "\(bu" 4 \&\f(CW$PREFIX\fR/share/sidplayfp .Sp on *NIX systems when not found in the above directories. .IP "\(bu" 4 \&\f(CW%CSIDL_APPDATA\fR%\e\esidplayfp\e\e .Sp on Windows systems where \s-1CSIDL_APPDATA\s0 is defined. .IP "\(bu" 4 \&\f(CW%USERPROFILE\fR%\e\eApplication Data\e\esidplayfp\e\e .Sp on Windows systems where \s-1CSIDL_APPDATA\s0 is not defined. .RE .RS 4 .RE .IP "\fBBasic Rom\fR=\fI\fR" 4 .IX Item "Basic Rom=" Full path for the Basic Rom file. This is mostly useful for playing \s-1BASIC\s0 tunes. By default the program will look for a file named \fIbasic\fR under the same locations as above. .IP "\fBChargen Rom\fR=\fI\fR" 4 .IX Item "Chargen Rom=" Full path for the Character generator Rom file. Almost useless for playback of tunes, but included for completeness. By default the program will look for a file named \fIchargen\fR under the same locations as above. .SS "Console" .IX Subsection "Console" .IP "\fBAnsi\fR=\fItrue|false\fR" 4 .IX Item "Ansi=true|false" Use \s-1ANSI\s0 escape sequences to provide colored output. .IP "\fBChar Top Left\fR=\fI\fR" 4 .IX Item "Char Top Left=" Character for the top left corner. .IP "\fBChar Top Right\fR=\fI\fR" 4 .IX Item "Char Top Right=" Character for the top right corner. .IP "\fBChar Bottom Left\fR=\fI\fR" 4 .IX Item "Char Bottom Left=" Character for the bottom left corner. .IP "\fBChar Bottom Right\fR=\fI\fR" 4 .IX Item "Char Bottom Right=" Character for the bottom right corner. .IP "\fBChar Vertical\fR=\fI\fR" 4 .IX Item "Char Vertical=" Character for vertical lines. .IP "\fBChar Horizontal\fR=\fI\fR" 4 .IX Item "Char Horizontal=" Character for horizontal lines. .IP "\fBChar Junction Left\fR=\fI\fR" 4 .IX Item "Char Junction Left=" Character for left junctions. .IP "\fBChar Junction Right\fR=\fI\fR" 4 .IX Item "Char Junction Right=" Character for right junctions. .SS "Audio" .IX Subsection "Audio" .IP "\fBFrequency\fR=\fI\fR" 4 .IX Item "Frequency=" Playback frequency expressed in Hertz. Default is 48000. .IP "\fBChannels\fR=\fI\fR" 4 .IX Item "Channels=" Number of channels, 1 for mono and 2 for stereo playback. Default is 1 for standard tunes and 2 for multi \s-1SID\s0 tunes. .IP "\fBBitsPerSample\fR=\fI<16|32>\fR" 4 .IX Item "BitsPerSample=<16|32>" Number of bits ber sample, used only for wav output. Using values other than the ones specified will produce invalid output. .SS "Emulation" .IX Subsection "Emulation" .IP "\fBEngine\fR=\fI\fR" 4 .IX Item "Engine=" Set the \s-1SID\s0 emulation engine. Default is \s-1RESIDFP.\s0 .IP "\fBC64Model\fR=\fI\fR" 4 .IX Item "C64Model=" Default c64 model to use if not specified by tune, \s-1PAL\s0 for european PAL-B model, \s-1NTSC\s0 for american/japanese NTSC-M models, \&\s-1OLD_NTSC\s0 for NTSC-M models with old video chip and \s-1DREAN\s0 for argentinian PAL-N model. Default is \s-1PAL.\s0 .IP "\fBForceC64Model\fR=\fItrue|false\fR" 4 .IX Item "ForceC64Model=true|false" Force the configured c64 model even if the tune specifies one. .IP "\fBCiaModel\fR=\fI\fR" 4 .IX Item "CiaModel=" Select \s-1CIA\s0 chip model, old \s-1MOS 6526\s0 or newer \s-1MOS 8521.\s0 .IP "\fBSidModel\fR=\fI\fR" 4 .IX Item "SidModel=" Default \s-1SID\s0 chip model, old \s-1MOS 6581\s0 or newer \s-1MOS 8580.\s0 .IP "\fBForceSidModel\fR=\fItrue|false\fR" 4 .IX Item "ForceSidModel=true|false" Force the configured \s-1SID\s0 chip model even if the tune specifies one. .IP "\fBDigiBoost\fR=\fItrue|false\fR" 4 .IX Item "DigiBoost=true|false" Enable digiboost for 8580 model. .IP "\fBUseFilter\fR=\fItrue|false\fR" 4 .IX Item "UseFilter=true|false" Enable/disable the emulation of the \s-1SID\s0 filter. .IP "\fBFilterBias\fR=\fI\fR" 4 .IX Item "FilterBias=" Controls the filter bias in the ReSID emulation. Ranges from 0.0 (dark) to 1.0 (light), the default value is 0.5. .IP "\fBFilterCurve6581\fR=\fI\fR" 4 .IX Item "FilterCurve6581=" Controls the filter curve for the 6581 model in the ReSIDfp emulation. Ranges from 0.0 (light) to 1.0 (dark), the default value is 0.5. .IP "\fBFilterCurve8580\fR=\fI\fR" 4 .IX Item "FilterCurve8580=" Controls the filter curve for the 8580 model in the ReSIDfp emulation. Ranges from 0.0 (light) to 1.0 (dark), the default value is 0.5. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBsidplayfp\fR\|(1) .SH "AUTHORS" .IX Header "AUTHORS" .IP "Leandro Nini" 4 .IX Item "Leandro Nini" Current maintainer. .IP "Simon White" 4 .IX Item "Simon White" Wrote the original Sidplay2. .IP "Dag Lem" 4 .IX Item "Dag Lem" Wrote the reSID emulation engine. .IP "Antti S. Lankila" 4 .IX Item "Antti S. Lankila" Wrote the reSIDfp emulation engine as a fork of reSID 0.16. .IP "The Vice team" 4 .IX Item "The Vice team" Large part of the emulation is based on the \s-1VICE\s0's code. .IP "Andre\*' Fachat" 4 .IX Item "Andre' Fachat" Wrote the original reloc65 utility. .IP "Michael Schwendt" 4 .IX Item "Michael Schwendt" Wrote the original SidTune library and \s-1MD5\s0 class (based on work by L. Peter Deutsch). .IP "Mikko Kilponen" 4 .IX Item "Mikko Kilponen" Wrote the original man page. .SH "RESOURCES" .IX Header "RESOURCES" .IP "Home page: " 4 .IX Item "Home page: " .PD 0 .IP "Sidplay2 homepage: " 4 .IX Item "Sidplay2 homepage: " .IP "High Voltage Sid Collection (\s-1HVSC\s0): " 4 .IX Item "High Voltage Sid Collection (HVSC): " .PD .SH "COPYING" .IX Header "COPYING" .IP "Copyright (C) 2000\-2004 Simon White" 4 .IX Item "Copyright (C) 2000-2004 Simon White" .PD 0 .IP "Copyright (C) 2007\-2010 Antti Lankila" 4 .IX Item "Copyright (C) 2007-2010 Antti Lankila" .IP "Copyright (C) 2009\-2015 \s-1VICE\s0 Project" 4 .IX Item "Copyright (C) 2009-2015 VICE Project" .IP "Copyright (C) 2010\-2021 Leandro Nini" 4 .IX Item "Copyright (C) 2010-2021 Leandro Nini" .PD .PP This program is free software; you can redistribute it and/or modify it under the terms of the \s-1GNU\s0 General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. .PP This program is distributed in the hope that it will be useful, but \s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of \&\s-1MERCHANTABILITY\s0 or \s-1FITNESS FOR A PARTICULAR PURPOSE.\s0 See the \&\s-1GNU\s0 General Public License for more details. .PP You should have received a copy of the \s-1GNU\s0 General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, \s-1MA\s0 02110\-1301, \s-1USA.\s0