summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorChristian Soffke <christian.soffke@gmail.com>2021-12-08 14:01:39 +0100
committerSolomon Peachy <pizza@shaftnet.org>2021-12-09 21:02:10 -0500
commitf78a0e52306951f8e4031bf6db9fbfba83982fcf (patch)
tree8b2c996fc5316d6a182de1cab0ff1d35362b17cf
parent694f929a99ae4b2b58cd6b322a7d63d74ad717ec (diff)
downloadrockbox-f78a0e52306951f8e4031bf6db9fbfba83982fcf.tar.gz
rockbox-f78a0e52306951f8e4031bf6db9fbfba83982fcf.zip
Manual (HTML): fix image aspect ratio and size
Change-Id: If7c680badcb1a493e2a2059d84ea5b154382bad2
-rw-r--r--manual/appendix/file_formats.tex39
-rw-r--r--manual/configure_rockbox/playback_options.tex3
-rw-r--r--manual/configure_rockbox/sound_settings.tex3
-rw-r--r--manual/preamble.tex10
-rw-r--r--manual/rockbox_interface/main.tex8
5 files changed, 35 insertions, 28 deletions
diff --git a/manual/appendix/file_formats.tex b/manual/appendix/file_formats.tex
index 0e77676305..f7335e20d4 100644
--- a/manual/appendix/file_formats.tex
+++ b/manual/appendix/file_formats.tex
@@ -1,12 +1,13 @@
1% $Id$ % 1% $Id$ %
2\newcommand{\includeicon}{\Ifpdfoutput{\includegraphics[width=0.37cm]}{\includegraphics}}
2\chapter{File formats} 3\chapter{File formats}
3\section{\label{ref:Supportedfileformats}Supported file formats} 4\section{\label{ref:Supportedfileformats}Supported file formats}
4\begin{rbtabular}{\textwidth}{cl>{\raggedright}p{7em}X}% 5\begin{rbtabular}{\textwidth}{cl>{\raggedright}p{7em}X}%
5{\textbf{Icon} & \textbf{File Type} & \textbf{Extension} 6{\textbf{Icon} & \textbf{File Type} & \textbf{Extension}
6 & \textbf{Action when selected}}{}{} 7 & \textbf{Action when selected}}{}{}
7\includegraphics[width=0.37cm]{appendix/images/icon-directory.png} 8\includeicon{appendix/images/icon-directory.png}
8 & Directory & \emph{none} & Enter the directory \tabularnewline 9 & Directory & \emph{none} & Enter the directory \tabularnewline
9 \includegraphics[width=0.37cm]{appendix/images/icon-audio-file.png} 10 \includeicon{appendix/images/icon-audio-file.png}
10 & Audio file & \emph{various}\newline% 11 & Audio file & \emph{various}\newline%
11 (see \ref{ref:Supportedaudioformats})% 12 (see \ref{ref:Supportedaudioformats})%
12 % do NOT use \reference{} here as that will break the table. 13 % do NOT use \reference{} here as that will break the table.
@@ -14,62 +15,62 @@
14 & Bookmark & \fname{.bmark} & Display all bookmarks for an audio file\tabularnewline 15 & Bookmark & \fname{.bmark} & Display all bookmarks for an audio file\tabularnewline
15 & Game of Life & \fname{.cells} & Show the configuration with the 16 & Game of Life & \fname{.cells} & Show the configuration with the
16 ``Rocklife'' plugin\tabularnewline 17 ``Rocklife'' plugin\tabularnewline
17\includegraphics[width=0.37cm]{appendix/images/icon-config.png} 18\includeicon{appendix/images/icon-config.png}
18 & Configuration File & \fname{.cfg} & Load the settings file\tabularnewline 19 & Configuration File & \fname{.cfg} & Load the settings file\tabularnewline
19\includegraphics[width=0.37cm]{appendix/images/icon-chip8.png} 20\includeicon{appendix/images/icon-chip8.png}
20 & Chip8 game & \fname{.ch8} & Play the Chip8 game \tabularnewline 21 & Chip8 game & \fname{.ch8} & Play the Chip8 game \tabularnewline
21\opt{lcd_color}{ 22\opt{lcd_color}{
22 & Colours & \fname{.colours} & Open the colours file for editing. 23 & Colours & \fname{.colours} & Open the colours file for editing.
23 See \reference{ref:ChangingFiletypeColours}.\tabularnewline 24 See \reference{ref:ChangingFiletypeColours}.\tabularnewline
24} 25}
25\includegraphics[width=0.37cm]{appendix/images/icon-cuesheet.png} 26\includeicon{appendix/images/icon-cuesheet.png}
26 & Cuesheet & \fname{.cue} & View the cuesheet file \tabularnewline 27 & Cuesheet & \fname{.cue} & View the cuesheet file \tabularnewline
27\opt{radio}{ 28\opt{radio}{
28 & FM Presets & \fname{.fmr} & Load the FM Presets (previous are discarded)\tabularnewline 29 & FM Presets & \fname{.fmr} & Load the FM Presets (previous are discarded)\tabularnewline
29} 30}
30\includegraphics[width=0.37cm]{appendix/images/icon-font.png} 31\includeicon{appendix/images/icon-font.png}
31 & Font & \fname{.fnt} & Change the user interface font to this one\tabularnewline 32 & Font & \fname{.fnt} & Change the user interface font to this one\tabularnewline
32\opt{gigabeat}{ 33\opt{gigabeat}{
33 \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png} 34 \includeicon{appendix/images/icon-rolo.png}
34 & Rockbox firmware & \fname{.gigabeat} & Load the new firmware with ROLO \tabularnewline 35 & Rockbox firmware & \fname{.gigabeat} & Load the new firmware with ROLO \tabularnewline
35} 36}
36\opt{iaudio}{ 37\opt{iaudio}{
37 \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png} 38 \includeicon{appendix/images/icon-rolo.png}
38 & Rockbox firmware & \fname{.iaudio} & Load the new firmware with ROLO \tabularnewline 39 & Rockbox firmware & \fname{.iaudio} & Load the new firmware with ROLO \tabularnewline
39} 40}
40\opt{ipod}{ 41\opt{ipod}{
41 \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png} 42 \includeicon{appendix/images/icon-rolo.png}
42 & Rockbox firmware & \fname{.ipod} & Load the new firmware with ROLO \tabularnewline 43 & Rockbox firmware & \fname{.ipod} & Load the new firmware with ROLO \tabularnewline
43} 44}
44\opt{iriverh100,iriverh300}{ 45\opt{iriverh100,iriverh300}{
45 \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png} 46 \includeicon{appendix/images/icon-rolo.png}
46 & Rockbox firmware & \fname{.iriver} & Load the new firmware with ROLO \tabularnewline 47 & Rockbox firmware & \fname{.iriver} & Load the new firmware with ROLO \tabularnewline
47} 48}
48\includegraphics[width=0.37cm]{appendix/images/icon-image-file.png} 49\includeicon{appendix/images/icon-image-file.png}
49 & Image & \fname{.jpg} & View the JPEG image \tabularnewline 50 & Image & \fname{.jpg} & View the JPEG image \tabularnewline
50 & Link & \fname{.link} & Display list of target files and directories; 51 & Link & \fname{.link} & Display list of target files and directories;
51 selecting one jumps to the target. See \reference{ref:Shortcutsplugin}.\tabularnewline 52 selecting one jumps to the target. See \reference{ref:Shortcutsplugin}.\tabularnewline
52\includegraphics[width=0.37cm]{appendix/images/icon-lang.png} 53\includeicon{appendix/images/icon-lang.png}
53 & Language File & \fname{.lng} & Load the language file \tabularnewline 54 & Language File & \fname{.lng} & Load the language file \tabularnewline
54\includegraphics[width=0.37cm]{appendix/images/icon-playlist.png} 55\includeicon{appendix/images/icon-playlist.png}
55 & Playlist & \fname{.m3u}, \fname{.m3u8} & Load the playlist and start playing 56 & Playlist & \fname{.m3u}, \fname{.m3u8} & Load the playlist and start playing
56 the first file \tabularnewline 57 the first file \tabularnewline
57\opt{iriverh10,iriverh10_5gb,sansa,mrobe100,vibe500,samsungyh}{ 58\opt{iriverh10,iriverh10_5gb,sansa,mrobe100,vibe500,samsungyh}{
58 \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png} 59 \includeicon{appendix/images/icon-rolo.png}
59 & Rockbox firmware & \fname{.mi4} & Load the new firmware with ROLO \tabularnewline 60 & Rockbox firmware & \fname{.mi4} & Load the new firmware with ROLO \tabularnewline
60} 61}
61 \includegraphics[width=0.37cm]{appendix/images/icon-movie-file.png} 62 \includeicon{appendix/images/icon-movie-file.png}
62 & Video & \fname{.mpg}, \fname{.mpeg}, \fname{.mpv}, \fname{.m2v} & Play the MPEG1/2 video \tabularnewline 63 & Video & \fname{.mpg}, \fname{.mpeg}, \fname{.mpv}, \fname{.m2v} & Play the MPEG1/2 video \tabularnewline
63\includegraphics[width=0.37cm]{appendix/images/icon-rock.png} 64\includeicon{appendix/images/icon-rock.png}
64 & Plugin & \fname{.rock} & Start the plugin\tabularnewline 65 & Plugin & \fname{.rock} & Start the plugin\tabularnewline
65\opt{sansaAMS}{ 66\opt{sansaAMS}{
66 \includegraphics[width=0.37cm]{appendix/images/icon-rolo.png} 67 \includeicon{appendix/images/icon-rolo.png}
67 & Rockbox firmware & \fname{.sansa} & Load the new firmware with ROLO \tabularnewline 68 & Rockbox firmware & \fname{.sansa} & Load the new firmware with ROLO \tabularnewline
68} 69}
69\includegraphics[width=0.37cm]{appendix/images/icon-text.png} 70\includeicon{appendix/images/icon-text.png}
70 & Text File & \fname{.txt} & Display the text file using the text viewer plugin\tabularnewline 71 & Text File & \fname{.txt} & Display the text file using the text viewer plugin\tabularnewline
71 & Voice file & \fname{.voice} & Allow Rockbox to speak menus\tabularnewline 72 & Voice file & \fname{.voice} & Allow Rockbox to speak menus\tabularnewline
72\includegraphics[width=0.37cm]{appendix/images/icon-wps.png} 73\includeicon{appendix/images/icon-wps.png}
73 & While Playing Screen & \fname{.wps} & Load the new WPS display configuration\tabularnewline 74 & While Playing Screen & \fname{.wps} & Load the new WPS display configuration\tabularnewline
74\end{rbtabular} 75\end{rbtabular}
75 76
diff --git a/manual/configure_rockbox/playback_options.tex b/manual/configure_rockbox/playback_options.tex
index aa2cfff1d5..f9f50593e6 100644
--- a/manual/configure_rockbox/playback_options.tex
+++ b/manual/configure_rockbox/playback_options.tex
@@ -146,7 +146,8 @@ you to configure settings related to audio playback.
146 146
147 The graphic below illustrates how the different settings work in practice. 147 The graphic below illustrates how the different settings work in practice.
148 148
149 \includegraphics[width=14cm]{configure_rockbox/images/crossfade_graphic.png} 149 \Ifpdfoutput{\includegraphics[width=14cm]{configure_rockbox/images/crossfade_graphic.png}}
150 {\includegraphics{configure_rockbox/images/crossfade_graphic.png}}
150 }%\opt{crossfade} 151 }%\opt{crossfade}
151 152
152\section{\label{ref:ReplayGain}Replaygain} 153\section{\label{ref:ReplayGain}Replaygain}
diff --git a/manual/configure_rockbox/sound_settings.tex b/manual/configure_rockbox/sound_settings.tex
index 73885c27aa..d91ffec989 100644
--- a/manual/configure_rockbox/sound_settings.tex
+++ b/manual/configure_rockbox/sound_settings.tex
@@ -263,7 +263,8 @@ change to customise your listening experience.
263 The graphic below illustrates how the width of 10kHz band can be adjusted to 263 The graphic below illustrates how the width of 10kHz band can be adjusted to
264 cover a wider (lower Q) or narrower (higher Q) range of frequencies. 264 cover a wider (lower Q) or narrower (higher Q) range of frequencies.
265 265
266 \includegraphics[width=14cm]{configure_rockbox/images/Q_factor.png} 266 \Ifpdfoutput{\includegraphics[width=14cm]{configure_rockbox/images/Q_factor.png}}
267 {\includegraphics{configure_rockbox/images/Q_factor.png}}
267 268
268 \nopt{gigabeats}{In some ways the EQ is similar to the 269 \nopt{gigabeats}{In some ways the EQ is similar to the
269 \setting{Bass} and \setting{Treble} settings described earlier, but the EQ 270 \setting{Bass} and \setting{Treble} settings described earlier, but the EQ
diff --git a/manual/preamble.tex b/manual/preamble.tex
index 2d49623a57..187f7c1f3a 100644
--- a/manual/preamble.tex
+++ b/manual/preamble.tex
@@ -178,19 +178,21 @@
178 \newcommand{\seriesimg}{\specimg} 178 \newcommand{\seriesimg}{\specimg}
179\fi 179\fi
180 180
181\newcommand{\includescreenshot}{\Ifpdfoutput{\includegraphics[width=\screenshotsize]}{\includegraphics}}
182
181\newcommand{\screenshot}[3]{ 183\newcommand{\screenshot}[3]{
182 \begin{figure}[H] 184 \begin{figure}[H]
183 \begin{center} 185 \begin{center}
184 \IfFileExists{#1-\genericimg-\specimg.png} 186 \IfFileExists{#1-\genericimg-\specimg.png}
185 {\includegraphics[width=\screenshotsize]{#1-\genericimg-\specimg.png} 187 {\includescreenshot{#1-\genericimg-\specimg.png}
186 \typeout{Note: device specific image used}} 188 \typeout{Note: device specific image used}}
187 {\IfFileExists{#1-\genericimg-\seriesimg.png} 189 {\IfFileExists{#1-\genericimg-\seriesimg.png}
188 {\includegraphics[width=\screenshotsize]{#1-\genericimg-\seriesimg.png} 190 {\includescreenshot{#1-\genericimg-\seriesimg.png}
189 \typeout{Note: series specific image used}} 191 \typeout{Note: series specific image used}}
190 {\IfFileExists{#1-\genericimg.png} 192 {\IfFileExists{#1-\genericimg.png}
191 {\includegraphics[width=\screenshotsize]{#1-\genericimg.png}} 193 {\includescreenshot{#1-\genericimg.png}}
192 {\IfFileExists{#1} 194 {\IfFileExists{#1}
193 {\includegraphics[width=\screenshotsize]{#1} 195 {\includescreenshot{#1}
194 \typeout{Warning: deprecated plain image name used}}% 196 \typeout{Warning: deprecated plain image name used}}%
195 {\typeout{Missing image: #1 (\genericimg) (\specimg)}% 197 {\typeout{Missing image: #1 (\genericimg) (\specimg)}%
196 \color{red}{\textbf{WARNING!} Image not found}% 198 \color{red}{\textbf{WARNING!} Image not found}%
diff --git a/manual/rockbox_interface/main.tex b/manual/rockbox_interface/main.tex
index 45da828143..ccc6e25ae6 100644
--- a/manual/rockbox_interface/main.tex
+++ b/manual/rockbox_interface/main.tex
@@ -15,8 +15,9 @@
15% specify the extension. 15% specify the extension.
16\begin{center} 16\begin{center}
17\IfFileExists{rockbox_interface/images/\specimg-front.png} 17\IfFileExists{rockbox_interface/images/\specimg-front.png}
18 {\includegraphics[height=8cm,width=10cm,keepaspectratio=true]% 18 {\Ifpdfoutput{\includegraphics[height=8cm,width=10cm,keepaspectratio=true]%
19 {rockbox_interface/images/\specimg-front} 19 {rockbox_interface/images/\specimg-front}}
20 {\includegraphics{rockbox_interface/images/\specimg-front}}
20 } 21 }
21 {\color{red}{\textbf{WARNING!} Image not found}% 22 {\color{red}{\textbf{WARNING!} Image not found}%
22 \typeout{Warning: missing front image} 23 \typeout{Warning: missing front image}
@@ -26,7 +27,8 @@
26 % spacing between the two pictures, could possibly be improved 27 % spacing between the two pictures, could possibly be improved
27 \begin{center} 28 \begin{center}
28 \IfFileExists{rockbox_interface/images/\specimg-remote.png} 29 \IfFileExists{rockbox_interface/images/\specimg-remote.png}
29 {\includegraphics[height=5.6cm,width=10cm,keepaspectratio=true]{rockbox_interface/images/\specimg-remote} 30 {\Ifpdfoutput{\includegraphics[height=5.6cm,width=10cm,keepaspectratio=true]{rockbox_interface/images/\specimg-remote}}
31 {\includegraphics{rockbox_interface/images/\specimg-remote}}
30 } 32 }
31 {\color{red}{\textbf{WARNING!} Image not found}% 33 {\color{red}{\textbf{WARNING!} Image not found}%
32 \typeout{Warning: missing remote image} 34 \typeout{Warning: missing remote image}