rockbox/manual/appendix/config_file_options.tex

268 lines
11 KiB
TeX
Raw Normal View History

% $Id$ %
\chapter{\label{ref:config_file_options}Config file options}
\begin{center}
% define a local version of endhead, as using the output distinction adds
% an unwanted newline. endhead breaks with htlatex so we need to remove it
% for the html output.
\ifpdfoutput{\newcommand{\localendhead}{\endhead}}%
{\newcommand{\localendhead}{}}
\begin{longtable}{@{}>{\raggedright}p{.35\textwidth}@{}>{\raggedright}p{.4\textwidth}@{}p{.25\textwidth}@{}}
\toprule
\textbf{Setting} & \textbf{Allowed Values} & \textbf{Unit}\\
\midrule\localendhead % endhead breaks with htlatex
volume & \opt{player}{-78 to +18}%
\opt{recorder,recorderv2fm,ondiosp,ondiofm}{-100 -to +12}%
\opt{h1xx,h300}{-84 to 0}%
\opt{ipodnano}{-72 to +6}%
\opt{ipodvideo}{-57 to +6}%
\opt{x5}{-73 to +6}
\opt{ipodcolor}{-\fixme{??} to +\fixme{??}}%
& dB\\
\nopt{x5}{%
bass & \opt{MASCODEC}{-15 to +15}%
\opt{h1xx,h300}{0 to +24}%
\opt{ipod}{-6 to +9}%
& dB\\
treble & \opt{MASCODEC}{-15 to +15}%
\opt{h1xx,h300}{0 to +6}%
\opt{ipod}{-6 to +9}%
& dB\\
}%
balance & -100 to +100 & \%\\
channels & stereo, mono, custom, mono left, mono right, karaoke
& N/A\\
shuffle & on, off & N/A\\
repeat & off, all, one, shuffle, ab
& N/A\\
play selected & on, off & N/A\\
resume & on, off & N/A\\
scan min step & 1, 2, 3, 4, 5, 6, 8, 10, 15, 20, 25, 30, 45, 60
& seconds\\
scan accel & 0 to 15 & seconds\\
antiskip & 0 to 7 & seconds\\
volume fade & on, off & N/A\\
id3 tag priority & v2-v1, v1-v2 & N/A\\
sort case & on, off & N/A\\
show files & all, supported, music, playlists
& N/A\\
follow playlist & on, off & N/A\\
playlist viewer icons
& on, off & N/A\\
playlist viewer indices
& on, off & N/A\\
playlist viewer track display
& track name,full path
& N/A\\
recursive directory insert
& on, off & N/A\\
scroll speed & 1 to 25 & Hz\\
scroll delay & 0 to 250 & 1/10s\\
scroll step & 1 to 112 & pixels\\
bidir limit & 0 to 200 & \% screen\\
contrast & 0 to 63 & N/A\\
backlight timeout
& off, on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30,
45, 60, 90 & seconds\\
backlight timeout plugged
& off, on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30,
45, 60, 90 & seconds\\
disk spindown & 3 to 254 & seconds\\
battery capacity
& 1500 - 3200 & mAh\\
idle poweroff & off, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 30, 45, 60
& minutes\\
lang & /path/filename.lng & N/A\\
wps & /path/filename.wps & N/A\\
autocreate bookmarks
& off, on & N/A\\
autoload bookmarks
& off, on & N/A\\
use most-recent-bookmarks
& off, on & N/A\\
talk dir & off, number, spell, enter, hover
& N/A\\
talk file & off, number, spell& N/A\\
talk menu & off, on & N/A\\
tagcache\_autoupdate
& on, off & N/A\\
warn when erasing dynamic playlist
& on, off & N/A\\
cuesheet support
& on, off & N/A\\
%
\opt{swcodec}{
replaygain & on, off & N/A\\
replaygain type
& track, album, track shuffle
& N/A\\
replaygain noclip
& on, off & N/A\\
replaygain preamp
& -120 to 120 & 0.1dB\\
%
crossfade & off, shuffle, track skip, always
& N/A\\
crossfade fade in delay
& 0 to 7 & seconds\\
crossfade fade out delay
& 0 to 7 & seconds\\
crossfade fade in duration
& 0 to 15 & seconds\\
crossfade fade out duration
& 0 to 15 & seconds\\
crossfade fade out mode
& crossfade, mix & N/A\\
%
crossfeed & on, off & N/A\\
crossfeed direct gain
& 0 to 60 & 0.1dB\\
crossfeed cross gain
& 30 to 120 & 0.1dB\\
crossfeed hf attenuation
& 60 to 240 & 0.1dB\\
crossfeed hf cutoff
& 500 to 2000 & Hz\\
%
eq enabled & on, off & N/A\\
eq precut & 0 to 240 & 0.1dB\\
eq band 0 cutoff & 0 to 32768 & Hz\\
eq band 1 cutoff & 0 to 32768 & Hz\\
eq band 2 cutoff & 0 to 32768 & Hz\\
eq band 3 cutoff & 0 to 32768 & Hz\\
eq band 4 cutoff & 0 to 32768 & Hz\\
eq band 0 q & 0 to 64 & N/A\\
eq band 1 q & 0 to 64 & N/A\\
eq band 2 q & 0 to 64 & N/A\\
eq band 3 q & 0 to 64 & N/A\\
eq band 4 q & 0 to 64 & N/A\\
eq band 0 gain & -240 to 240 & 0.1dB\\
eq band 1 gain & -240 to 240 & 0.1dB\\
eq band 2 gain & -240 to 240 & 0.1dB\\
eq band 3 gain & -240 to 240 & 0.1dB\\
eq band 4 gain & -240 to 240 & 0.1dB\\
%
beep & off, weak, moderate, strong
& N/A\\
dircache & on, off & N/A\\
tagcache\_ram & on, off & N/A\\
}%
\opt{recorder,recorderv2fm}{
loudness & 0 to 17 & N/A\\
superbass & on, off & N/A\\
auto volume & off, 20ms, 2s, 4s, 8s
& seconds\\
mdb enable & on,off & N/A\\
mdb strength & 0 to 127 & dB\\
mdb harmonics & 0 to 100 & \%\\
mdb center & 20 to 300 & Hz\\
mdb shape & 50 to 300 & Hz\\
}%
\opt{lcd_bitmap}{
peak meter release
& 1 to 126 & ?\\
peak meter hold
& off, 200ms, 300ms, 500ms, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10,
15, 20, 30, 1min & N/A \\
peak meter clip hold
& on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30, 45,
60, 90, 2min, 3min, 5min, 10min, 20min, 45min, 90min
& N/A \\
peak meter busy & on, off & N/A\\
peak meter dbfs & on, off & on:~dbfs, off:~linear\\
peak meter min & 0 to 89 (dB) or 0 to 100 (\%)
& dB or \%\\
peak meter max & 0 to 89 /(dB) or 0 to 100 (\%)
& dB or \%\\
statusbar & on, off & N/A\\
scrollbar & on, off & N/A\\
volume display
& graphic, numeric & N/A\\
battery display
& graphic, numeric & N/A\\
font & /path/filename.fnt & N/A\\
invert & on, off & N/A\\
}%
\opt{swcodec}{% This doesn't depend on swcodec but using a \nopt here
% causes ondiosp not to build for mysterious reasons.
backdrop & /path/filename.bmp & N/A\\
}%
\opt{lcd_color}{
foreground color & 000000 to FFFFFF & RRGGBB\\
background color & 000000 to FFFFFF & RRGGBB\\
line selector start color & 000000 to FFFFFF & RRGGBB\\
line selector end color & 000000 to FFFFFF & RRGGBB\\
}
\opt{HAVE_REMOTE_LCD}{
rwps & /path/filename.rwps & N/A\\
remote contrast
& 5 to 63 & N/A\\
remote invert
& on, off & N/A\\
remote flip display
& on, off & N/A\\
remote backlight timeout
& off, on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25,
30, 45, 60, 90 & seconds\\
remote backlight timeout plugged
& off, on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25,
30, 45, 60, 90 & seconds\\
remote caption backlight
& on, off & N/A\\
remote scroll speed
& 0 to 15 & N/A\\
remote scroll step
& 1 to 160 & N/A\\
remote scroll delay
& 0 to 250 & N/A\\
remote bidir limit
& 0 to 200 & N/A\\
backlight filters first remote keypress
& on, off & N/A\\
\opt{h1xx,h300}{
remote reduce ticking
& on, off & N/A\\
}%
}
\opt{rtc}{
time format & 12hour, 24hour & N/A\\
}%
\opt{recording}{
rec quality & 0 to 7 & 0: small size, 7: high quality\\
rec frequency
& 48, 44, 32, 24, 22, 16 & kHz\\
rec source & mic, line, spdif & N/A\\
rec channels & mono, stereo & N/A\\
rec mic gain & 0 to 15 & N/A\\
rec left gain & 0 to 15 & N/A\\
rec right gain
& 0 to 15 & N/A\\
editable recordings
& off,on & N/A\\
rec timesplit
& off, 0:05, 0:10, 0:15, 0:30, 1:00, 2:00, 4:00, 6:00,
8:00, 16:00, 24:00 & h:mm\\
pre-recording time
& off, 1 to 30 & seconds\\
rec directory
& /recordings,current & N/A\\
}%
\opt{radio}{
force fm mono
& off, on & N/A\\
}%
\opt{player}{
jump scroll
& 0 to 5 & N/A\\
jump scroll delay
& 0 to 250 & 0.01s\\
}%
\bottomrule
\end{longtable}
\end{center}