devs/foxbox
1
0
Fork 0
forked from len0rd/rockbox
Code Pull requests Activity

Minor corrections to the .colours file editing; added .colours to the list of supported files.

Browse source 
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@20407 a1c6a512-1295-4272-9138-f99709370657
This commit is contained in:
Alexander Levin 2009-03-20 19:33:20 +00:00
parent 2d77fde363
commit 71812ca1fd
2 changed files with 74 additions and 69 deletions
Download patch file Download diff file Expand all files Collapse all files

137
manual/advanced_topics/main.tex
View file

@ -39,82 +39,83 @@ file find the instructions on the Rockbox website:
\wikilink{LangFiles} \wikilink{LangFiles}
\opt{lcd_color}{ \opt{lcd_color}{
\subsection{Changing Filetype Colours} \subsection{\label{ref:ChangingFiletypeColours}Changing Filetype Colours}
Rockbox has the capability to modify the \setting{File Browser} to show Rockbox has the capability to modify the \setting{File Browser} to show
different filetypes in different colours, depending on the file extension. files of different types in different colours, depending on the file extension.
\subsubsection{Set-up}
There are two steps to changing the filetype colours - creating
a file with the extension \fname{.colours} and then activating it using
a config file. The \fname{.colours} files \emph{must} be stored in
the \fname{/.rockbox/themes/} directory.
The \fname{.colours} file is just a text file, and can be edited with
your text editor of choice.
\subsubsection{Creating the .colours file} \subsubsection{Set-up}
The \fname{.colours} file consits of the file extension There are two steps to changing the filetype colours: creating
(or \fname{folder}) followed by a colon and then the colour desired a file with the extension \fname{.colours} and then activating it using
as an RGB value in hexadecimal, as in the following example:\\* a config file. The \fname{.colours} files \emph{must} be stored in
\\ the \fname{/.rockbox/themes/} directory.
\config{folder:808080}\\ The \fname{.colours} file is just a text file, and can be edited with
\config{mp3:00FF00}\\ your text editor of choice.
\config{ogg:00FF00}\\
\config{txt:FF0000}\\
\config{???:FFFFFF}\\*
The permissible extensions are as follows:\\* \subsubsection{Creating the .colours file}
\\ The \fname{.colours} file consists of the file extension
\config{folder, m3u, m3u8, cfg, wps, lng, rock, bmark, cue, colours, mpa, (or \fname{folder}) followed by a colon and then the colour desired
\firmwareextension{}, % as an RGB value in hexadecimal, as in the following example:\\*
\opt{swcodec}{mp1, }mp2, mp3% \\
\opt{swcodec}{, ogg, oga, wma, wmv, asf, wav, flac, ac3, a52, mpc, \config{folder:808080}\\
wv, m4a, m4b, mp4, mod, shn, aif, aiff, spx, sid, adx, nsf, nsfe, \config{mp3:00FF00}\\
spc, ape, mac, sap}% \config{ogg:00FF00}\\
\opt{lcd_bitmap}{\opt{swcodec}{, mpg, mpeg}}% \config{txt:FF0000}\\
\opt{HAVE_REMOTE_LCD}{, rwps}% \config{???:FFFFFF}\\*
\opt{lcd_non-mono}{, bmp}%
\opt{radio}{, fmr}%
\opt{lcd_bitmap}{, fnt, kbd}}\\*
%It'd be ideal to get these from filetypes.c
All file extensions that are not either specifically listed in the The permissible extensions are as follows:\\*
\fname{.colours} files or are not in the list above will be \\
set to the colour given by \config{???}. Extensions that \config{folder, m3u, m3u8, cfg, wps, lng, rock, bmark, cue, colours, mpa,
are in the above list but not in the \fname{.colours} \firmwareextension{}, %
file will be set to the foreground colour as normal. \opt{swcodec}{mp1, }mp2, mp3%
\opt{swcodec}{, ogg, oga, wma, wmv, asf, wav, flac, ac3, a52, mpc,
wv, m4a, m4b, mp4, mod, shn, aif, aiff, spx, sid, adx, nsf, nsfe,
spc, ape, mac, sap}%
\opt{lcd_bitmap}{\opt{swcodec}{, mpg, mpeg}}%
\opt{HAVE_REMOTE_LCD}{, rwps}%
\opt{lcd_non-mono}{, bmp}%
\opt{radio}{, fmr}%
\opt{lcd_bitmap}{, fnt, kbd}}\\*
%It'd be ideal to get these from filetypes.c
\subsubsection{Activating} All file extensions that are not either specifically listed in the
To activate the filetype colours, the \fname{.colours} file needs to be \fname{.colours} files or are not in the list above will be
invoked from a \fname{.cfg} configuration file. The easiest way to do set to the colour given by \config{???}. Extensions that
this is to create a new text file containing the following single are in the above list but not in the \fname{.colours}
line:\\* file will be set to the foreground colour as normal.
\\
\config{filetype colours: /.rockbox/themes/filename.colours}\\*
where filename is replaced by the filename you used when creating the \subsubsection{Activating}
\fname{.colours} file. Save this file as e.g. \fname{colours.cfg} in the To activate the filetype colours, the \fname{.colours} file needs to be
\fname{/.rockbox/themes} directory and then activate the config file invoked from a \fname{.cfg} configuration file. The easiest way to do
from the menu as normal this is to create a new text file containing the following single
(\setting{Settings} $\rightarrow$ \setting{Theme Settings}% line:\\*
$\rightarrow$ \setting{Browse Themes}). \\
\config{filetype colours: /.rockbox/themes/filename.colours}\\*
\subsubsection{Editing} where filename is replaced by the filename you used when creating the
The built-in \setting{Text Editor} (see \reference{sec:text_editor}) \fname{.colours} file. Save this file as e.g. \fname{colours.cfg} in the
automatically understands the \fname{/.rockbox/themes} directory and then activate the config file
\fname{.colours} file format, but an external text editor can from the menu as normal
also be used. To edit the \fname{.colours} file using Rockbox, (\setting{Settings} $\rightarrow$ \setting{Theme Settings}%
select it in the \setting{File Browser}. The file will open in $\rightarrow$ \setting{Browse Themes}).
the \setting{Text Editor}. Upon selecting a line, the following choices
will appear:\\*
\\
\config{Extension}\\
\config{Colour}\\*
If \config{Extension} is selected, the \setting{virtual keyboard} \subsubsection{Editing}
(see \reference{sec:virtual_keyboard}) appears, The built-in \setting{Text Editor} (see \reference{sec:text_editor})
allowing the file extension to be modified. If \config{Colour} automatically understands the
is selected, the colour selector screen appears. Choose the desired \fname{.colours} file format, but an external text editor can
colour, then save the \fname{.colours} file using the standard also be used. To edit the \fname{.colours} file using Rockbox,
\setting{Text Editor} controls. ``play'' it in the \setting{File Browser}. The file will open in
the \setting{Text Editor}. Upon selecting a line, the following choices
will appear:\\*
\\
\config{Extension}\\
\config{Colour}\\*
If \config{Extension} is selected, the \setting{virtual keyboard}
(see \reference{sec:virtual_keyboard}) appears,
allowing the file extension to be modified. If \config{Colour}
is selected, the colour selector screen appears. Choose the desired
colour, then save the \fname{.colours} file using the standard
\setting{Text Editor} controls.
} }
\opt{lcd_non-mono}{% \opt{lcd_non-mono}{%

6
manual/appendix/file_formats.tex
View file

@ -53,7 +53,11 @@
& Rockbox Video & \fname{.rvf} & View a movie (Rockbox format)\\} & Rockbox Video & \fname{.rvf} & View a movie (Rockbox format)\\}
} }
& Link & \fname{.link} & Display list of target files and directories; & Link & \fname{.link} & Display list of target files and directories;
selecting one jumps to the target. \emph{see \reference{ref:Shortcutsplugin}}\\ selecting one jumps to the target. See \reference{ref:Shortcutsplugin}.\\
\opt{lcd_color}{
& Colours & \fname{.colours} & Open the colours file for editing.
See \reference{ref:ChangingFiletypeColours}.\\
}
\bottomrule \bottomrule
\end{tabularx} \end{tabularx}
\end{center} \end{center}