summaryrefslogtreecommitdiffstats
path: root/manual
diff options
context:
space:
mode:
Diffstat (limited to 'manual')
-rwxr-xr-xmanual/advanced_topics/main.tex8
-rw-r--r--manual/appendix/config_file_options.tex13
-rw-r--r--manual/appendix/file_formats.tex126
-rw-r--r--manual/configure_rockbox/bookmarking.tex9
-rw-r--r--manual/configure_rockbox/playback_options.tex20
-rw-r--r--manual/configure_rockbox/playlist_options.tex6
-rw-r--r--manual/configure_rockbox/sound_settings.tex37
-rw-r--r--manual/configure_rockbox/startup_shutdown_options.tex39
-rwxr-xr-xmanual/configure_rockbox/system_options.tex118
-rw-r--r--manual/configure_rockbox/time_and_date.tex5
-rw-r--r--manual/getting_started/installation.tex21
-rw-r--r--manual/getting_started/jztool_install.tex3
-rw-r--r--manual/main_menu/main.tex16
-rw-r--r--manual/platform/erosqnative.tex28
-rw-r--r--manual/platform/keymap-erosqnative.tex118
-rw-r--r--manual/platform/keymap-fiiom3k.tex34
-rw-r--r--manual/platform/keymap-xduoox3.tex4
-rw-r--r--manual/plugins/pictureflow.tex126
-rw-r--r--manual/plugins/text_viewer.tex5
-rw-r--r--manual/preamble.tex10
-rw-r--r--manual/rockbox_interface/browsing_and_playing.tex14
-rw-r--r--manual/rockbox_interface/main.tex29
-rw-r--r--manual/rockbox_interface/wps.tex32
-rw-r--r--manual/working_with_playlists/main.tex38
24 files changed, 588 insertions, 271 deletions
diff --git a/manual/advanced_topics/main.tex b/manual/advanced_topics/main.tex
index b9beb937d8..a7d3240d84 100755
--- a/manual/advanced_topics/main.tex
+++ b/manual/advanced_topics/main.tex
@@ -107,8 +107,8 @@ file find the instructions on the Rockbox website:
\config{folder, m3u, m3u8, cfg, wps, lng, rock, bmark, cue, colours, mpa,
\firmwareextension{}, %
mp1, mp2, mp3, 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, mpg, mpeg%
+ m4a, m4b, mp4, mp4a, mod, shn, aif, aiff, spx, sid, adx, nsf, nsfe, spc,
+ ape, mac, sap, mpg, mpeg%
\opt{HAVE_REMOTE_LCD}{, rwps}%
\opt{lcd_non-mono}{, bmp}%
\opt{radio}{, fmr}%
@@ -194,6 +194,8 @@ viewport. This is done by adding the following line to the
\config{remote ui viewport: X,Y,[width],[height],[font],[fgcolour],[bgcolour]}}
\\*
+}
+
Only the first two parameters \emph{have} to be specified, the others can
be omitted using `$-$' as a placeholder. The syntax is very similar to WPS
viewports (see \reference{ref:Viewports}). Briefly:
@@ -379,8 +381,6 @@ and the WPS, but you can use multiple fonts in each of the individual screens.\\
An example would be: \config{\%Fl(2,12-Nimbus.fnt,100)}
-}
-
\subsubsection{Conditional Tags}
\begin{description}
diff --git a/manual/appendix/config_file_options.tex b/manual/appendix/config_file_options.tex
index b7e807baf4..9de95c257b 100644
--- a/manual/appendix/config_file_options.tex
+++ b/manual/appendix/config_file_options.tex
@@ -132,6 +132,10 @@
rewind duration on pause & 0 to 15 & s\\
disable autoresume if phones not present & off, on & N/A\\
Last.fm Logging & off, on & N/A\\
+ \opt{albumart}{
+ album art
+ & off, prefer embedded, prefer image file & N/A\\
+ }
talk dir & off, number, spell& N/A\\
talk dir clip & off, on & N/A\\
talk file & off, number, spell& N/A\\
@@ -366,7 +370,14 @@
force fm mono
& off, on & N/A\\
}%
-
+ \opt{rds}{
+ sync RDS time
+ & off, on & N/A\\
+ }%
+ \opt{clear_settings_on_hold}{
+ clear settings on hold
+ & off, on & N/A\\
+ }%
\bottomrule
\end{longtable}
\end{center}
diff --git a/manual/appendix/file_formats.tex b/manual/appendix/file_formats.tex
index f7335e20d4..4c12575b2e 100644
--- a/manual/appendix/file_formats.tex
+++ b/manual/appendix/file_formats.tex
@@ -3,11 +3,11 @@
\chapter{File formats}
\section{\label{ref:Supportedfileformats}Supported file formats}
\begin{rbtabular}{\textwidth}{cl>{\raggedright}p{7em}X}%
-{\textbf{Icon} & \textbf{File Type} & \textbf{Extension}
+{\textbf{Icon} & \textbf{File Type} & \textbf{Extension}
& \textbf{Action when selected}}{}{}
\includeicon{appendix/images/icon-directory.png}
& Directory & \emph{none} & Enter the directory \tabularnewline
- \includeicon{appendix/images/icon-audio-file.png}
+ \includeicon{appendix/images/icon-audio-file.png}
& Audio file & \emph{various}\newline%
(see \ref{ref:Supportedaudioformats})%
% do NOT use \reference{} here as that will break the table.
@@ -17,7 +17,7 @@
``Rocklife'' plugin\tabularnewline
\includeicon{appendix/images/icon-config.png}
& Configuration File & \fname{.cfg} & Load the settings file\tabularnewline
-\includeicon{appendix/images/icon-chip8.png}
+\includeicon{appendix/images/icon-chip8.png}
& Chip8 game & \fname{.ch8} & Play the Chip8 game \tabularnewline
\opt{lcd_color}{
& Colours & \fname{.colours} & Open the colours file for editing.
@@ -46,22 +46,22 @@
\includeicon{appendix/images/icon-rolo.png}
& Rockbox firmware & \fname{.iriver} & Load the new firmware with ROLO \tabularnewline
}
-\includeicon{appendix/images/icon-image-file.png}
+\includeicon{appendix/images/icon-image-file.png}
& Image & \fname{.jpg} & View the JPEG image \tabularnewline
& Link & \fname{.link} & Display list of target files and directories;
selecting one jumps to the target. See \reference{ref:Shortcutsplugin}.\tabularnewline
-\includeicon{appendix/images/icon-lang.png}
+\includeicon{appendix/images/icon-lang.png}
& Language File & \fname{.lng} & Load the language file \tabularnewline
\includeicon{appendix/images/icon-playlist.png}
- & Playlist & \fname{.m3u}, \fname{.m3u8} & Load the playlist and start playing
+ & Playlist & \fname{.m3u}, \fname{.m3u8} & Load the playlist and start playing
the first file \tabularnewline
\opt{iriverh10,iriverh10_5gb,sansa,mrobe100,vibe500,samsungyh}{
- \includeicon{appendix/images/icon-rolo.png}
+ \includeicon{appendix/images/icon-rolo.png}
& Rockbox firmware & \fname{.mi4} & Load the new firmware with ROLO \tabularnewline
}
\includeicon{appendix/images/icon-movie-file.png}
& Video & \fname{.mpg}, \fname{.mpeg}, \fname{.mpv}, \fname{.m2v} & Play the MPEG1/2 video \tabularnewline
-\includeicon{appendix/images/icon-rock.png}
+\includeicon{appendix/images/icon-rock.png}
& Plugin & \fname{.rock} & Start the plugin\tabularnewline
\opt{sansaAMS}{
\includeicon{appendix/images/icon-rolo.png}
@@ -83,7 +83,7 @@
& \fname{.a52}, \fname{.ac3}, \fname{.rm}, \fname{.ra}, \fname{.rmvb}
& Supports downmixing for playback of 5.1 streams in stereo\\
ADX
- & \fname{.adx}
+ & \fname{.adx}
& Encrypted ADX is not supported.\\
Advanced Audio Coding
& \fname{.m4a}, \fname{.m4b}, \fname{.mp4}, \fname{.rm}, \fname{.ra}, \fname{.rmvb}
@@ -92,15 +92,15 @@
\opt{clipv1,c200v2}{ % low memory targets (CODEC_SIZE <= 512 KB)
& Supports AAC-LC profile\\}
MPEG audio
- & \fname{.mpa}, \fname{.mp1}, \fname{.mp2}, \fname{.mp3}
+ & \fname{.mpa}, \fname{.mpga}, \fname{.mp1}, \fname{.mp2}, \fname{.mp3}
& MPEG 1/2/2.5 Layer 1/2/3\\
Musepack
- & \fname{.mpc}
+ & \fname{.mpc}
& Supports SV7 and SV8 in mono/stereo \\
OGG/Vorbis
- & \fname{.ogg}, \fname{.oga}
+ & \fname{.ogg}, \fname{.oga}
& Playback of some old ``floor 0'' files may fail on low memory targets.
- Files with album art larger than available RAM will be skipped.
+ Files with album art larger than available RAM will be skipped.
Chained Ogg files are not supported.\\
Sony Audio
& \fname{.oma}, \fname{.aa3}, \fname{.rm}, \fname{.ra}, \fname{.rmvb}
@@ -109,32 +109,32 @@
& \fname{.rm}, \fname{.ra}, \fname{.rmvb}
& Supports RealAudio G2 (Cook)\\
Speex
- & \fname{.spx}
+ & \fname{.spx}
& \\
Dialogic telephony type
- & \fname{.vox}
+ & \fname{.vox}
& \\
Windows Media Audio Standard
- & \fname{.wma}, \fname{.wmv}, \fname{.asf}
+ & \fname{.wma}, \fname{.wmv}, \fname{.asf}
& \\
Windows Media Audio Professional
- & \fname{.wma}, \fname{.wmv}, \fname{.asf}
+ & \fname{.wma}, \fname{.wmv}, \fname{.asf}
& \\
\end{rbtabular}
-
- \note{AAC-HE profiles might not play in realtime on all devices due to CPU
+
+ \note{AAC-HE profiles might not play in realtime on all devices due to CPU
performance requirements.}
\subsection{Lossless Codecs}
\begin{rbtabular}{\textwidth}{lp{6em}X}%
{\textbf{Format} & \textbf{Extension} & \textbf{Notes}}{}{}
Audio Interchange File Format
- & \fname{.aif}, \fname{.aiff}
+ & \fname{.aif}, \fname{.aiff}
& Linear PCM 8/16/24/32 bit, IEEE float 32/64 bit, ITU-T G.711 a-law/$\mu$-law,
QuickTime IMA ADPCM\\
Monkey's Audio
- & \fname{.ape}, \fname{.mac}
- &
+ & \fname{.ape}, \fname{.mac}
+ &
\opt{gigabeatf,iriverh100,iriverh300,iaudiox5,iaudiom5,iaudiom3,ipodnano2g,clipv1}{
-c1000 to -c3000 files decode fast enough to be useful.}
\opt{gigabeats}{}
@@ -142,45 +142,45 @@
\nopt{ipodnano2g}{Only -c1000 files decode fast enough to be useful.}}
\\
Sun Audio
- & \fname{.au}, \fname{.snd}
+ & \fname{.au}, \fname{.snd}
& Linear PCM 8/16/24/32 bit, IEEE float 32/64 bit, ITU-T G.711 a-law/$\mu$-law\\
Free Lossless Audio
- & \fname{.flac}
+ & \fname{.flac}
& Supports multichannel playback including downmixing to stereo.\\
Apple Lossless
- & \fname{.m4a}, \fname{.mp4}
+ & \fname{.m4a}, \fname{.mp4}
& \\
Shorten
- & \fname{.shn}
+ & \fname{.shn}
& Seeking not supported.\\
True Audio
- & \fname{.tta}
+ & \fname{.tta}
& \\
Wave64
- & \fname{.w64}
+ & \fname{.w64}
& Supports same formats as Waveform audio format.\\
Waveform audio format
- & \fname{.wav}
+ & \fname{.wav}
& Linear PCM 8/16/24/32 bit, IEEE float 32/64 bit, ITU-T G.711 a-law/$\mu$-law,
Microsoft ADPCM, Intel DVI ADPCM (IMA ADPCM) 2/3/4/5 bit, Dialogic OKI ADPCM,
YAMAHA ADPCM, Adobe SWF ADPCM\\
Wavpack
- & \fname{.wv}
+ & \fname{.wv}
& \\
\end{rbtabular}
-
- \note{Free Lossless Audio multichannel tracks may not play in realtime on all devices due to CPU
+
+ \note{Free Lossless Audio multichannel tracks may not play in realtime on all devices due to CPU
performance requirements.}
\subsection{Other Codecs}
\begin{rbtabular}{\textwidth}{l>{\raggedright}p{6em}X}%
{\textbf{Format} & \textbf{Extension} & \textbf{Notes}}{}{}
Atari Sound Format
- & \fname{.cmc}, \fname{.cm3}, \fname{.cmr}, \fname{.cms}, \fname{.dmc},
- \fname{.dlt}, \fname{.mpt}, \fname{.mpd}
+ & \fname{.cmc}, \fname{.cm3}, \fname{.cmr}, \fname{.cms}, \fname{.dmc},
+ \fname{.dlt}, \fname{.mpt}, \fname{.mpd}
& \\
Synthetic music Mobile Application Format
- & \fname{.mmf}
+ & \fname{.mmf}
& PCM/ADPCM only \\
Game Boy Sound Format
& \fname{.gbs}
@@ -198,7 +198,7 @@
& Progress bar and seek use subtracks instead of seconds.\\}
SMS/GG/CV Sound Format
& \fname{.sgc}
- & Supports Sega Master System and Game Gear Sound Format.
+ & Supports Sega Master System and Game Gear Sound Format.
Progress bar and seek use subtracks instead of seconds.\\
Video Game Music Format
& \fname{.vgm}
@@ -207,25 +207,25 @@
& \fname{.vgz}
& \\
MOD
- & \fname{.mod}
+ & \fname{.mod}
& \\
NES Sound Format
- & \fname{.nsf}, \fname{.nsfe}
+ & \fname{.nsf}, \fname{.nsfe}
& Progress bar and seek use subtracks instead of seconds.\\
Atari SAP
- & \fname{.sap}
+ & \fname{.sap}
& \\
Sound Interface Device
- & \fname{.sid}
+ & \fname{.sid}
& Progress bar and seek use subtracks instead of seconds.\\
SPC700
- & \fname{.spc}
+ & \fname{.spc}
& \\
\end{rbtabular}
-
- \note{NSF and VGM might not play in realtime on all devices due to CPU
+
+ \note{NSF and VGM might not play in realtime on all devices due to CPU
performance requirements.}
-
+
\subsection{Codec featureset}
\begin{rbtabular}{.95\textwidth}{lXXX}%
{\textbf{Format} & \textbf{Seek} & \textbf{Resume} & \textbf{Gapless}}{}{}
@@ -265,22 +265,22 @@
Sound Interface Device & x & & \\
SPC700 & x & & \\
\end{rbtabular}
-
+
\note{The seek implementations of NES Sound Format, Sound Interface Device,
Game Boy Sound Format, AY Sound Chip Music, Hudson Entertainment System Sound,
Format, MSX Konami Sound System and SMS/GG/CV Sound Format use subtracks
instead of seconds, whereas each subtrack equals a second.}
-
+
\section{\label{ref:SupportedMetadata}Supported metadata tags}
Rockbox supports different metadata formats. In general those tag formats
- are ID3 (v1.0, v1.1, v2.2, v2.3 and v2.4), APE (v1 and v2), Vorbis, MP4 and
- ASF. Few codecs use codec specific tags, several codecs do not use any tags
- yet. The following table gives an overview about what tag types rockbox
+ are ID3 (v1.0, v1.1, v2.2, v2.3 and v2.4), APE (v1 and v2), Vorbis, MP4 and
+ ASF. Few codecs use codec specific tags, several codecs do not use any tags
+ yet. The following table gives an overview about what tag types rockbox
supports for which audio file extension.
-
+
\note{There is always only \emph{one} tag type supported for each file
extension.}
-
+
\begin{rbtabular}{\textwidth}{lX}%
{\textbf{Tag type} & \textbf{File extension}}{}{}
ID3 & \fname{.mp1}, \fname{.mpa}, \fname{.mp2}, \fname{.mp3},
@@ -299,11 +299,11 @@
\fname{.cms}, \fname{.dmc}, \fname{.dlt}, \fname{.mpt},
\fname{.mpd}, \fname{.hes}, \fname{.vgz} \\
\end{rbtabular}
-
+
\subsection{Featureset for generic metadata tags}
\label{ref:featureset_for_generic_metadata_tags}
\begin{rbtabular}{0.90\textwidth}{lXXXXX}%
- {\textbf{Feature} & \textbf{ID3} & \textbf{APE} & \textbf{Vorbis} &
+ {\textbf{Feature} & \textbf{ID3} & \textbf{APE} & \textbf{Vorbis} &
\textbf{MP4} & \textbf{ASF}}{}{}
Embedded albumart \fname{.bmp} & & x & & & \\
Embedded albumart \fname{.jpg} & x & x & & x & x \\
@@ -322,9 +322,9 @@
Albumartist (string) & x & x & x & x & x \\
Grouping (string) & & x & x & x & \\
\end{rbtabular}
-
+
\note{Embedded album art for ASF is limited to pictures of maximum 64 KB size.}
-
+
\subsection{Featureset for codec specific metadata}
\begin{rbtabular}{\textwidth}{lX}%
{\textbf{Feature} & \textbf{Codec specific metadata (file extension)}}{}{}
@@ -332,12 +332,12 @@
Embedded \fname{.jpg} & None \\
Embedded \fname{.png} & None \\
Replaygain & \fname{.mpc}\\
- Title & \fname{.tta}, \fname{.spc}, \fname{.mmf}, \fname{.sid},
- \fname{.rm}, \fname{.ra}, \fname{.rmvb}, \fname{.nsf},
+ Title & \fname{.tta}, \fname{.spc}, \fname{.mmf}, \fname{.sid},
+ \fname{.rm}, \fname{.ra}, \fname{.rmvb}, \fname{.nsf},
\fname{.nsfe}, \fname{.mod}, \fname{.sap}, \fname{.gbs},
\fname{.ay}, \fname{.sgc}, \fname{.vgm} \\
- Artist & \fname{.tta}, \fname{.spc}, \fname{.mmf}, \fname{.sid},
- \fname{.rm}, \fname{.ra}, \fname{.rmvb}, \fname{.nsf},
+ Artist & \fname{.tta}, \fname{.spc}, \fname{.mmf}, \fname{.sid},
+ \fname{.rm}, \fname{.ra}, \fname{.rmvb}, \fname{.nsf},
\fname{.nsfe}, \fname{.sap}, \fname{.gbs}, \fname{.ay},
\fname{.sgc}, \fname{.vgm} \\
Album & \fname{.spc}, \fname{.sid}, \fname{.nsf}, \fname{.nsfe},
@@ -352,15 +352,15 @@
Albumartist & None \\
Grouping & None \\
\end{rbtabular}
-
+
\subsection{Limitations of metadata handling}
\begin{enumerate}
- \item Multiple tags (e.g. for Genre) are not supported. The first tag
+ \item Multiple tags (e.g. for Genre) are not supported. The first tag
item of a set of multiple tags is used.
\item Only one tag type is supported for each audio format.
\nopt{lowmem,himem}{
\item Overall there are 900 bytes available to load metadata strings.
- \item The maximum size of each metadata item (e.g. Artists) is limited
+ \item The maximum size of each metadata item (e.g. Artists) is limited
to 240 bytes.
}
\opt{himem}{
@@ -370,7 +370,7 @@
}
\opt{lowmem}{
\item Overall there are 300 bytes available to load metadata strings.
- \item The maximum size of each metadata item (e.g. Artists) is limited
+ \item The maximum size of each metadata item (e.g. Artists) is limited
to 90 bytes.
}
\end{enumerate}
diff --git a/manual/configure_rockbox/bookmarking.tex b/manual/configure_rockbox/bookmarking.tex
index a429b63d21..c1d0f3b8bf 100644
--- a/manual/configure_rockbox/bookmarking.tex
+++ b/manual/configure_rockbox/bookmarking.tex
@@ -13,18 +13,19 @@
extension. To load a bookmark, select the bookmark file and then select
the bookmark to load. There are other ways to load a bookmarks mentioned
below.
-
+
\note{Bookmarking only works when tracks are launched from the file browser,
and does not work for tracks launched via the
- database. In addition, they do not work with dynamic
- playlists.}
+ database. In addition, they do not work with dynamic (i.e. modified but not saved)
+ playlists. If making a bookmark is not available, saving the playlist
+ is sufficient to allow a bookmark to be made.}
\begin{description}
\item [Bookmark on Stop.]
This option controls whether Rockbox creates a bookmark when playback is
stopped manually.
- \begin{description}
+ \begin{description}
\item[No.]
Do not create bookmarks.
\item[Yes.]
diff --git a/manual/configure_rockbox/playback_options.tex b/manual/configure_rockbox/playback_options.tex
index 6c8f5de316..a2337439db 100644
--- a/manual/configure_rockbox/playback_options.tex
+++ b/manual/configure_rockbox/playback_options.tex
@@ -255,18 +255,6 @@ you to configure settings related to audio playback.
}%
-\section{Last.fm Log}\index{Last.fm Log}\index{Audioscrobbler|see{Last.fm Log}}
- Enables logging of your played tracks for submission to
- \url{http://www.last.fm}. This service was formerly known as
- \emph{Audioscrobbler}. When you enable this option, you'll have to reboot to
- start the logging. The log-file is called
- \opt{rtc}{\fname{.scrobbler.log},}%
- \nopt{rtc}{\fname{.scrobbler-timeless.log},}%
- and is to be found in the root directory of your \dap{}.\\
-
- \note{See \wikilink{LastFMLog} for a further description, and for tools you
- can use to submit your Last.fm log.}
-
\section{Cuesheet Support}\index{Cuesheet Support}
Enables reading of cuesheet files for played tracks. If a cuesheet is found
for a track, track markers are displayed on the progressbar and it is
@@ -324,3 +312,11 @@ you to configure settings related to audio playback.
your audio. This is typically 44.1kHz.}
\note{Opus files are always 48kHz.}
}
+
+\opt{albumart}{
+ \section{Album Art}
+ Album art will not be loaded or displayed when set to \setting{Off}.
+ To prefer loading album art that is stored in a separate image file, set to
+ \setting{Prefer Image File}. The default behavior is to
+ \setting{Prefer Embedded} album art.
+} \ No newline at end of file
diff --git a/manual/configure_rockbox/playlist_options.tex b/manual/configure_rockbox/playlist_options.tex
index 4f6024127e..b29842ceed 100644
--- a/manual/configure_rockbox/playlist_options.tex
+++ b/manual/configure_rockbox/playlist_options.tex
@@ -31,6 +31,12 @@ related to playlists.
If set to \setting{Yes}, Rockbox will provide a warning if the user attempts to
take an action that will cause Rockbox to erase the current dynamic playlist.
+ \item[Keep Current Track When Replacing Playlist.]
+ If set to \setting{Yes}, then \setting{Play} and \setting{Play Shuffled} in
+ the \setting{Current Playlist submenu} will allow the current track to finish
+ playing before the new tracks play. If set to \setting{No}, the current
+ track will be interrupted and new tracks will start playing immediately.
+
\item[Show Shuffled Adding Options.]
If set to \setting{No}, Rockbox will not offer to add shuffled tracks
in the \setting{Current Playlist submenu}.
diff --git a/manual/configure_rockbox/sound_settings.tex b/manual/configure_rockbox/sound_settings.tex
index c618f33603..951eded31c 100644
--- a/manual/configure_rockbox/sound_settings.tex
+++ b/manual/configure_rockbox/sound_settings.tex
@@ -10,7 +10,7 @@ change to customise your listening experience.
where 0~dB is a reference that indicates the maximum volume that the \dap{}
can produce without possible distortion (clipping). All values lower than
this reference will be negative and yield a progressively softer volume.
- \nopt{iriverh100,iriverh300,ondavx777}{%
+ \nopt{iriverh100,iriverh300,ondavx777,erosqnative}{%
Values higher than 0~dB are available and can be used to raise the
volume more than would otherwise be possible. These volume levels will
ordinarily lead to distorted sound, but might work nicely for music that has
@@ -28,11 +28,27 @@ change to customise your listening experience.
\opt{gigabeatf,vibe500}{minimum of -74~dB to a maximum of +6~dB.}%
\opt{fuzeplus}{minimum of -100~dB to a maximum of +6~dB.}
\opt{samsungyh}{minimum of -128~dB to a maximum of 0~dB.}
+ \opt{erosqnative}{minimum of -74~dB (mute) to a maximum of -2~dB.}
\opt{ipodvideo}{\\Remark: Lowering the volume below -57~dB will also affect the line-out
and the recording gain.}
\opt{cowond2}{\\Remark: Lowering the volume below -57~dB will also affect the line-out.}
+ \opt{erosqnative}{\note{When the Line Out is used without anything connected to the
+ Headphone port, the volume is fixed. The value is user-configurable; see \setting{Volume Limit}, \reference{ref:volume_limit}.
+ If the Headphone port is connected, the volume once again uses the normal \setting{Volume} setting,
+ regardless of whether the Line Out is in use.}}
\nopt{gigabeats}{
+\section{\label{ref:volume_limit}Volume Limit}
+ This setting adjusts the maximum volume of your music. The setting is by
+ default set to the maximum volume the \dap{} supports. To set a volume
+ limit, select a volume from the list and the maximum volume will be limited to
+ the selected value all over the system.
+ \opt{xduoox3}{This setting also applies to the Line Out of the \dap{}, as at full scale the \dap{} overdrives the signal.}
+ \opt{erosqnative}{On the \playertype{}, when using the Line Out without anything connected to the Headphone port,
+ the volume is fixed to the \setting{Volume Limit} value.
+ \note{On the \playertype{}, the Line Out level at -2~dB is approximately +7~dBV, -4~dB is approximately +4~dBu,
+ and -18~dB is approximately -10~dBV.}}
+
\section{Bass}
This setting emphasises
\nopt{iriverh100,iriverh300}{or suppresses}
@@ -45,13 +61,6 @@ change to customise your listening experience.
\opt{iaudiom3,iaudiom5,iaudiox5,sansa,sansaAMS,iriverh10,iriverh10_5gb,vibe500,fuzeplus%
,samsungyh}{The minimum setting is -24~dB and the maximum is 24~dB.}
-\section{\label{ref:volume_limit}Volume Limit}
- This setting adjusts the maximum volume of your music. The setting is by
- default set to the maximum volume which equals to no limit. To set a volume
- limit, select a volume from the list and the maximum volume will be limited to
- the selected value all over the system.
- \opt{xduoox3}{This setting also applies to the Line Out of the \dap{}, as at full scale the \dap{} overdrives the signal.}
-
\opt{ipodvideo}{
\section{Bass Cutoff}
This setting controls the frequency below which the bass adjustment applies.
@@ -353,7 +362,7 @@ change to customise your listening experience.
,GIGABEAT_S_PAD,SANSA_C200_PAD,IAUDIO_M3_PAD,MROBE100_PAD%
,SANSA_CLIP_PAD,SANSA_FUZEPLUS_PAD,SAMSUNG_YH92X_PAD%
,SAMSUNG_YH820_PAD}{\ButtonRight}
- \opt{SANSA_E200_PAD,SANSA_FUZE_PAD,IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonScrollFwd}
+ \opt{SANSA_E200_PAD,SANSA_FUZE_PAD,IPOD_4G_PAD,IPOD_3G_PAD,AIGO_EROSQ_PAD}{\ButtonScrollFwd}
\opt{IRIVER_H10_PAD}{\ButtonScrollUp}
\opt{PBELL_VIBE500_PAD}{\ButtonUp}
\opt{MPIO_HD200_PAD,XDUOO_X3_PAD}{\ButtonVolUp}
@@ -371,7 +380,7 @@ change to customise your listening experience.
,GIGABEAT_S_PAD,SANSA_C200_PAD,IAUDIO_M3_PAD,MROBE100_PAD%
,SANSA_CLIP_PAD,SANSA_FUZEPLUS_PAD,SAMSUNG_YH92X_PAD%
,SAMSUNG_YH820_PAD}{\ButtonLeft}
- \opt{SANSA_E200_PAD,SANSA_FUZE_PAD,IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonScrollBack}
+ \opt{SANSA_E200_PAD,SANSA_FUZE_PAD,IPOD_4G_PAD,IPOD_3G_PAD,AIGO_EROSQ_PAD}{\ButtonScrollBack}
\opt{IRIVER_H10_PAD}{\ButtonScrollDown}
\opt{PBELL_VIBE500_PAD}{\ButtonDown}
\opt{MPIO_HD200_PAD,XDUOO_X3_PAD}{\ButtonVolDown}
@@ -388,7 +397,7 @@ change to customise your listening experience.
\opt{IPOD_4G_PAD,IPOD_3G_PAD,PBELL_VIBE500_PAD}{\ButtonLeft}
\opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,SANSA_E200_PAD,SANSA_C200_PAD%
,SANSA_FUZE_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,IAUDIO_M3_PAD,MROBE100_PAD%
- ,SANSA_CLIP_PAD,SANSA_FUZEPLUS_PAD,SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ButtonUp}
+ ,SANSA_CLIP_PAD,SANSA_FUZEPLUS_PAD,SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD,AIGO_EROSQ_PAD}{\ButtonUp}
\opt{IRIVER_H10_PAD,MPIO_HD200_PAD,MPIO_HD300_PAD}{\ButtonRew}
\opt{touchscreen}{\ActionStdPrev}
&
@@ -404,7 +413,7 @@ change to customise your listening experience.
\opt{IPOD_4G_PAD,IPOD_3G_PAD,PBELL_VIBE500_PAD}{\ButtonRight}
\opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,SANSA_E200_PAD,SANSA_C200_PAD%
,SANSA_FUZE_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,IAUDIO_M3_PAD,MROBE100_PAD%
- ,SANSA_CLIP_PAD,SANSA_FUZEPLUS_PAD,SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ButtonDown}
+ ,SANSA_CLIP_PAD,SANSA_FUZEPLUS_PAD,SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD,AIGO_EROSQ_PAD}{\ButtonDown}
\opt{IRIVER_H10_PAD,MPIO_HD200_PAD,MPIO_HD300_PAD}{\ButtonFF}
\opt{touchscreen}{\ActionStdNext}
&
@@ -419,7 +428,7 @@ change to customise your listening experience.
%
\opt{IRIVER_H100_PAD,IRIVER_H300_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,IAUDIO_X5_PAD%
,SANSA_C200_PAD,IPOD_4G_PAD,IPOD_3G_PAD,IPOD_VIDEO_PAD,SANSA_E200_PAD%
- ,SANSA_FUZE_PAD,MROBE100_PAD,SANSA_CLIP_PAD,SANSA_FUZEPLUS_PAD}{\ButtonSelect}
+ ,SANSA_FUZE_PAD,MROBE100_PAD,SANSA_CLIP_PAD,SANSA_FUZEPLUS_PAD,AIGO_EROSQ_PAD}{\ButtonSelect}
\opt{MPIO_HD200_PAD}{\ButtonFunc}
\opt{MPIO_HD300_PAD}{\ButtonEnter}
\opt{PBELL_VIBE500_PAD}{\ButtonOK}
@@ -444,7 +453,7 @@ change to customise your listening experience.
\opt{SANSA_E200_PAD,SANSA_FUZE_PAD,IRIVER_H10_PAD}{\ButtonLeft}
\opt{GIGABEAT_PAD,GIGABEAT_S_PAD,SANSA_C200_PAD,MROBE100_PAD,SANSA_CLIP_PAD}{\ButtonPower}
\opt{PBELL_VIBE500_PAD}{\ButtonCancel}
- \opt{SANSA_FUZEPLUS_PAD}{\ButtonBack}
+ \opt{SANSA_FUZEPLUS_PAD,AIGO_EROSQ_PAD}{\ButtonBack}
\opt{SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ButtonPlay}
\opt{touchscreen}{\TouchTopLeft
\opt{COWON_D2_PAD}{/ \ButtonPower}}
diff --git a/manual/configure_rockbox/startup_shutdown_options.tex b/manual/configure_rockbox/startup_shutdown_options.tex
index 7952985ece..e4639079b5 100644
--- a/manual/configure_rockbox/startup_shutdown_options.tex
+++ b/manual/configure_rockbox/startup_shutdown_options.tex
@@ -36,6 +36,45 @@ are run at startup, or initiate a shutdown when conditions are met.
to be enabled.
\end{description}
+\opt{clear_settings_on_hold}{
+ \opt{ipod}{
+ \subsection{\label{ref:ClearOnHold}Hold switch clears settings on startup }
+ This option controls whether Rockbox clears its configuration if the hold
+ switch is enabled during startup.
+
+ \begin{description}
+ \item[Yes.]
+ Clear the settings if the hold switch is enabled during startup.
+ \item[No.]
+ Do not clear the settings, regardless of the hold switch's position.
+ \end{description}
+ }
+ \nopt{ipod}{
+ \opt{GIGABEAT_S_PAD}{
+ \subsection{\label{ref:ClearOnHold}BUTTON A clears settings on startup }
+ This option controls whether Rockbox clears its configuration if BUTTON_A
+ is held during startup.
+ \begin{description}
+ \item[Yes.]
+ Clear the settings if the BUTTON A is held.
+ \item[No.]
+ Do not clear the settings, regardless of BUTTON A.
+ \end{description}
+ }
+ \nopt{GIGABEAT_S_PAD}{
+ \subsection{\label{ref:ClearOnHold}BUTTON REC clears settings on startup }
+ This option controls whether Rockbox clears its configuration if BUTTON REC
+ is held during startup.
+ \begin{description}
+ \item[Yes.]
+ Clear the settings if the BUTTON REC is held.
+ \item[No.]
+ Do not clear the settings, regardless of BUTTON REC.
+ \end{description}
+ }
+ }
+}
+
\subsection{\label{ref:IdlePoweroffSetting}Idle Poweroff}
Rockbox can be configured to turn off power after the unit has been idle for
a defined number of minutes. The \dap{} is idle when playback is stopped or
diff --git a/manual/configure_rockbox/system_options.tex b/manual/configure_rockbox/system_options.tex
index 32c389e593..85e6a6b7d6 100755
--- a/manual/configure_rockbox/system_options.tex
+++ b/manual/configure_rockbox/system_options.tex
@@ -7,48 +7,51 @@
Options relating to the battery
in the \dap.
\begin{description}
- \item [Battery Capacity.] This setting can be used to tell Rockbox what
- capacity (in mAh) the battery being used has. The default is
- \opt{vibe500}{1000~mAh}%
- \opt{iriverh100,iriverh300}{1300~mAh}%
- \opt{mpiohd200}{850~mAh}%
- \opt{ipodmini}{400~mAh (1G) or 630~mAh (2G)}%
- \opt{ipodcolor}{700~mAh}%
- \opt{ipodnano}{300~mAh}%
- \opt{ipodvideo}{400~mAh (30~GB) or 600~mAh (60~GB and 80~GB)}%
- \opt{ipod4g}{630~mAh}%
- \opt{ipod3g}{630~mAh}%
- \opt{ipod1g2g}{1200~mAh}%
- \opt{iaudiom3,iaudiom5,iaudiox5}{950~mAh}%
- \opt{gigabeatf}{2000~mAh}%
- \opt{gigabeats}{700~mAh}%
- \opt{cowond2}{1600~mAh}%
- \opt{mrobe100}{720~mAh}%
- \opt{samsungyh920,samsungyh925}{900~mAh}%
- \opt{samsungyh820}{650~mAh}%
- \opt{xduoox3}{2000~mAh}%
- , which is the capacity value for the standard battery shipped with the \dap.
- Rockbox uses this value for runtime estimation, not battery percentage
- calculation. Changing this setting has no effect whatsoever on
- actual battery life. This setting only affects the accuracy of the
- runtime estimation as shown on screen.
- \opt{iaudiom3,iaudiom5,iaudiox5}{Rockbox does not automatically distinguish
- between the ``L'' models and the ``simple'' models which determine the
- default value. If your \dap{} is an
- \opt{iaudiom3}{M3L}%
- \opt{iaudiom5}{M5L}%
- \opt{iaudiox5}{X5L}
- set the value to 2250~mAh for more accuracy in the runtime estimation.}
- \opt{ipod,sansa}{This value is fairly meaningless in the \playerman{}
- family at present, and work is on-going into finding a better way to
- determine battery life.}
-
- \opt{battery_types}{
- \item [Battery Type.] This setting tells Rockbox which type of battery
- is currently used in the \dap{}.
- \nopt{xduoox3}{The two supported battery types are ``Alkaline'' or ``NiMH''.}
- \opt{xduoox3}{Older \playerman{} \playertype{} units shipped with a 1500mAh battery, while newer units ships with a 2000mAh battery. If you are not sure which type you have, older units have a button marked ``ESC''.}
- }
+ \nopt{erosqnative}
+ {
+ \item [Battery Capacity.] This setting can be used to tell Rockbox what
+ capacity (in mAh) the battery being used has. The default is
+ \opt{vibe500}{1000~mAh}%
+ \opt{iriverh100,iriverh300}{1300~mAh}%
+ \opt{mpiohd200}{850~mAh}%
+ \opt{ipodmini}{400~mAh (1G) or 630~mAh (2G)}%
+ \opt{ipodcolor}{700~mAh}%
+ \opt{ipodnano}{300~mAh}%
+ \opt{ipodvideo}{400~mAh (30~GB) or 600~mAh (60~GB and 80~GB)}%
+ \opt{ipod4g}{630~mAh}%
+ \opt{ipod3g}{630~mAh}%
+ \opt{ipod1g2g}{1200~mAh}%
+ \opt{iaudiom3,iaudiom5,iaudiox5}{950~mAh}%
+ \opt{gigabeatf}{2000~mAh}%
+ \opt{gigabeats}{700~mAh}%
+ \opt{cowond2}{1600~mAh}%
+ \opt{mrobe100}{720~mAh}%
+ \opt{samsungyh920,samsungyh925}{900~mAh}%
+ \opt{samsungyh820}{650~mAh}%
+ \opt{xduoox3}{2000~mAh}%
+ , which is the capacity value for the standard battery shipped with the \dap.
+ Rockbox uses this value for runtime estimation, not battery percentage
+ calculation. Changing this setting has no effect whatsoever on
+ actual battery life. This setting only affects the accuracy of the
+ runtime estimation as shown on screen.
+ \opt{iaudiom3,iaudiom5,iaudiox5}{Rockbox does not automatically distinguish
+ between the ``L'' models and the ``simple'' models which determine the
+ default value. If your \dap{} is an
+ \opt{iaudiom3}{M3L}%
+ \opt{iaudiom5}{M5L}%
+ \opt{iaudiox5}{X5L}
+ set the value to 2250~mAh for more accuracy in the runtime estimation.}
+ \opt{ipod,sansa}{This value is fairly meaningless in the \playerman{}
+ family at present, and work is on-going into finding a better way to
+ determine battery life.}
+
+ \opt{battery_types}{
+ \item [Battery Type.] This setting tells Rockbox which type of battery
+ is currently used in the \dap{}.
+ \nopt{xduoox3}{The two supported battery types are ``Alkaline'' or ``NiMH''.}
+ \opt{xduoox3}{Older \playerman{} \playertype{} units shipped with a 1500mAh battery, while newer units ships with a 2000mAh battery. If you are not sure which type you have, older units have a button marked ``ESC''.}
+ }
+ }
\opt{usb_charging_enable}{
\item [Charge During USB Connection.] This option lets you control whether
@@ -77,6 +80,7 @@
}
\opt{dircache}{
+ \label{ref:dircache}
\item [Directory Cache.] Rockbox has the ability to cache the contents of
your drive in RAM. The \setting{Directory Cache} takes a small amount of
memory away from Rockbox that would otherwise be used to buffer music,
@@ -118,13 +122,16 @@ This sub menu relates to limits in the Rockbox operating system.
Entries in File Browser} or \setting{Max Playlist Size} to take effect
while \setting{Glyphs To Cache} will affect the next font load.}
% TODO: this needs to be rewritten in another style, it lets you mix sound from another source into the music
- \subsection{Line In} This option activates the line-in port on \dap, which is
- off by default. This is useful for such applications as:
- \begin{itemize}
- \item Game boy $\rightarrow$ \dap $\rightarrow$ human
- \item laptop $\rightarrow$ \dap $\rightarrow$ human
- \item LAN party computer $\rightarrow$ \dap $\rightarrow$ human
- \end{itemize}
+ \nopt{erosqnative}
+ {
+ \subsection{Line In} This option activates the line-in port on \dap, which is
+ off by default. This is useful for such applications as:
+ \begin{itemize}
+ \item Game boy $\rightarrow$ \dap $\rightarrow$ human
+ \item laptop $\rightarrow$ \dap $\rightarrow$ human
+ \item LAN party computer $\rightarrow$ \dap $\rightarrow$ human
+ \end{itemize}
+ }
\opt{quickscreen}{
\subsection{Use Shortcuts Menu Instead of Quick Screen} This option
activates the shortcuts menu instead of opening the quick screen when enabled.
@@ -302,7 +309,7 @@ therefore result in better runtime.
\item[Disable All Lock Notifications]
Disable all softlock notifications, including when power button
is pressed.
- \note{When this is enabled, Disable Locked Reminders is still required to
+ \note{When this is enabled, Disable Locked Reminders is still required to
be enabled for \setting{selectivebacklight} \reference{ref:selectivebacklight}
to work during key lock.}
@@ -863,8 +870,15 @@ therefore result in better runtime.
\opt{usb_power}{
\subsection{USB Mode}
This controls what happens with the \dap{}'s USB port is connected.
- \setting{Charge Only} and \setting{Mass Storage} will automatically enter
- that mode, and \setting{Ask} will prompt the user each time.
+ \setting{Mass Storage} allows you to transfer files, while
+ \setting{Charge Only} will only charge the battery (and allow you to keep
+ using the player). You can choose the opposite behavior by holding down any
+ button while plugging in the USB cable.
+ \nopt{fuzeplus}{
+ \note{Be aware that holding a button may still perform its normal function,
+ so it is recommended to use a button without harmful side effects, such as
+ \ActionStdUsbCharge{}.}
+ }
}
\opt{multidrive_usb}{
\subsection{USB Hide Internal Drive}
diff --git a/manual/configure_rockbox/time_and_date.tex b/manual/configure_rockbox/time_and_date.tex
index aa3f563eed..36da0e6204 100644
--- a/manual/configure_rockbox/time_and_date.tex
+++ b/manual/configure_rockbox/time_and_date.tex
@@ -21,4 +21,9 @@ if voice support is enabled.
}%\opt{recording,radio}
}%\opt{alarm}
\item[Time Format:] Choose 12 or 24 hour clock.
+ \opt{rds}{
+ \item[Sync RDS time:]
+ If this option is enabled, your clock will be kept in sync with the time provided
+ by Radio Data System (RDS) if the currently selected station provides it.
+ }%\opt{rds}
\end{description}
diff --git a/manual/getting_started/installation.tex b/manual/getting_started/installation.tex
index 3903e37e1f..661964dd8a 100644
--- a/manual/getting_started/installation.tex
+++ b/manual/getting_started/installation.tex
@@ -111,7 +111,7 @@ follow the instructions at
\end{description}
}
-\opt{fiiom3k,shanlingq1,agptekrocker,xduoox3ii,xduoox20,aigoerosq}{
+\opt{fiiom3k,shanlingq1,agptekrocker,xduoox3ii,xduoox20,aigoerosq,erosqnative}{
Although Rockbox is considered fully functional on the \playername{}, there are
a few limitations compared to the original firmware which you should be aware
of before installing.
@@ -120,7 +120,7 @@ of before installing.
filesystems such as exFAT or NTFS are not supported.
\item[USB DAC.] This feature is not supported by Rockbox, but you can
dual-boot the original firmware if you want to use it.
- \opt{shanlingq1,agptekrocker,xduoox3ii,xduoox20,aigoerosq}{\item[Wireless.] There is no support for Bluetooth\opt{shanlingq1}{ or WiFi}.
+ \opt{shanlingq1,agptekrocker,xduoox3ii,xduoox20,aigoerosq,erosqnative}{\item[Wireless.] There is no support for Bluetooth\opt{shanlingq1}{ or WiFi}.
You can dual-boot the original firmware to use wireless functionality.}
\item[Hotswapping SD cards.] Rockbox runs from the SD card, not the internal
flash memory. Hotswapping is technically possible, but you need to install
@@ -266,7 +266,7 @@ people. Rockbox Utility is a graphical application that does almost everything
for you. However, should you encounter a problem, then the manual way is
still available to you.\\
-\opt{gigabeats,fiiom3k,shanlingq1}{
+\opt{gigabeats,fiiom3k,shanlingq1,erosqnative}{
\note{The automated install is not yet available for the
\playerlongtype{}. For now you can use the manual method to install Rockbox.
Please still read the section on the automatic install as it explains
@@ -342,7 +342,7 @@ housekeeping tool \caps{Rockbox Utility}. It allows you to:
Prebuilt binaries for Windows, Linux and Mac OS X are
available at the \wikilink{RockboxUtility} wiki page.\\
-\opt{gigabeats,ondavx777,fiiom3k,shanlingq1}{
+\opt{gigabeats,ondavx777,fiiom3k,shanlingq1,erosqnative}{
\note{Rockbox Utility does not currently support the \playertype{} and you will
therefore need to follow the manual install instructions below.\\}}
@@ -545,7 +545,7 @@ by Rockbox, in the main directory of your \daps{} drive.
\opt{samsungyh}{\input{getting_started/samsungyh_install.tex}}
\opt{xduoox3}{\input{getting_started/xduoox3_install.tex}}
\opt{xduoox3ii,xduoox20,agptekrocker,aigoerosq}{\input{getting_started/hibyos_install.tex}}
- \opt{fiiom3k,shanlingq1}{\input{getting_started/jztool_install.tex}}
+ \opt{fiiom3k,shanlingq1,erosqnative}{\input{getting_started/jztool_install.tex}}
}
}
@@ -641,7 +641,7 @@ by Rockbox, in the main directory of your \daps{} drive.
}
\opt{e200}{Your e200 will automatically reboot and Rockbox should load.}
-\opt{fiiom3k,shanlingq1}{
+\opt{fiiom3k,shanlingq1,erosqnative}{
Safely eject / unmount your \dap{}.
}
@@ -807,16 +807,17 @@ completely follow the manual uninstallation instructions below.}}
\playerman{} firmware.
}
-\opt{fiiom3k,shanlingq1}{
+\opt{fiiom3k,shanlingq1,erosqnative}{
If you want to remove the Rockbox bootloader, copy an original firmware
- update to your microSD card and run the \playerman{} update by holding
- \ActionBootOFRecovery{} while powering on the \dap{}.
+ update to your microSD card and run the \playerman{} update by
+ \opt{erosqnative}{running it from the Original Firmware's System Settings menu.}
+ \nopt{erosqnative}{holding \ActionBootOFRecovery{} while powering on the \dap{}.}
Alternatively, if you took a backup of the original \playerman{} bootloader
you can copy the backup file, \bootbackupfilename{}, to your SD card and
select \emph{Restore bootloader} from the recovery menu. The recovery menu
can be accessed by holding \ActionBootRecoveryMenu{} when powering on. If
- your \dap won't boot, use \fname{jztool} to load the bootloader over USB
+ your \dap{} won't boot, use \fname{jztool} to load the bootloader over USB
and enter the recovery menu -- see \reference{ref:jztool_load_bootloader}.
}
diff --git a/manual/getting_started/jztool_install.tex b/manual/getting_started/jztool_install.tex
index c492b6987e..f350f6990b 100644
--- a/manual/getting_started/jztool_install.tex
+++ b/manual/getting_started/jztool_install.tex
@@ -14,6 +14,7 @@ install it again if you want to keep using Rockbox.
\item Download the Rockbox bootloader, \bootfilename{}, from
\opt{fiiom3k}{\download{bootloader/fiio/m3k/}.}
\opt{shanlingq1}{\download{bootloader/shanling/q1/}.}
+ \opt{erosqnative}{\download{bootloader/aigo/native/}.}
\item Download \fname{jztool} from \download{bootloader/fiio/m3k/}.
\item Connect your player in USB boot mode:
\begin{enumerate}
@@ -27,6 +28,8 @@ install it again if you want to keep using Rockbox.
black. The \playerman{} splash screen will not be displayed.}
\opt{shanlingq1}{the LCD will remain black and the \playerman{} splash
screen will not be displayed.}
+ \opt{erosqnative}{the blue LED will light up, the LCD will remain black,
+ and the \playerman{} splash screen will not be displayed.}
\end{enumerate}
\item Windows users need to follow \reference{ref:install_usb_driver} now
to make the \playertype{} accessible to \fname{jztool} before continuing.
diff --git a/manual/main_menu/main.tex b/manual/main_menu/main.tex
index bdb422e10a..f6f70b1084 100644
--- a/manual/main_menu/main.tex
+++ b/manual/main_menu/main.tex
@@ -238,9 +238,15 @@ utilities. A detailed description of the different plugins is to be found in
\opt{quickscreen}
{
\section{\label{ref:QuickScreen}Quick Screen}
- Although the \setting{Quick Screen} is accessible from nearly everywhere,
- not just the \setting{Main Menu}, it is worth mentioning here. It allows
- rapid access to your four favourite settings. The default settings are
+ \nopt{erosqnative}{
+ Although the \setting{Quick Screen} is accessible from nearly everywhere,
+ not just the \setting{Main Menu}, it is worth mentioning here.
+ }
+ \opt{erosqnative}{
+ On the \playertype{}, The \setting{Quick Screen} is only
+ available from the \setting{While Playing Screen} by default.
+ }
+ It allows rapid access to your four favourite settings. The default settings are
\setting{Shuffle} (\reference{ref:PlaybackSettings}),
\setting{Repeat} (\reference{ref:PlaybackSettings}) and the
\setting{Show Files} (\reference{ref:ShowFiles}) options, but almost all
@@ -249,7 +255,9 @@ utilities. A detailed description of the different plugins is to be found in
\ActionStdContext. In the menu which appears you will be given options
to place the setting on the \setting{Quick Screen}.
- Press \ActionStdQuickScreen{} to access it and \ActionQuickScreenExit{} to exit.
+ Press
+ \nopt{erosqnative}{\ActionStdQuickScreen{}}
+ \opt{erosqnative}{\ActionWpsQuickScreen{}} to access it and \ActionQuickScreenExit{} to exit.
The direction buttons will modify the individual setting values as indicated
by the arrow icons. Please note that the settings at opposite sides of the
screen cycle through the available options in opposite directions.
diff --git a/manual/platform/erosqnative.tex b/manual/platform/erosqnative.tex
new file mode 100644
index 0000000000..c7ce0f3c8b
--- /dev/null
+++ b/manual/platform/erosqnative.tex
@@ -0,0 +1,28 @@
+% $Id$ %
+\def\UseOption{erosqnative}
+\edef\UseOption{\UseOption,AIGO_EROSQ_PAD}
+\edef\UseOption{\UseOption,HAVE_BACKLIGHT}
+\edef\UseOption{\UseOption,HAVE_RB_BL_IN_FLASH}
+\edef\UseOption{\UseOption,erosqnative}
+
+\newcommand{\playerman}{Aigo}
+\newcommand{\playertype}{Eros Q}
+\newcommand{\playerlongtype}{\playertype}
+\newcommand{\dapdisplaywidth}{320}
+\newcommand{\dapdisplayheight}{240}
+\newcommand{\dapdisplaydepth}{16}
+\newcommand{\specimg}{aigoerosq}
+%Used to name the player, e.g. ...to the \dap
+\newcommand{\dap}{player}
+%For use when referring to the player. E.g. the \daps\ capacity ...
+\newcommand{\daps}{player's}
+\newcommand{\firmwarefilename}{\fname{rockbox.erosq}}
+\newcommand{\bootfilename}{\fname{bootloader.erosq}}
+\newcommand{\firmwareextension}{\fname{erosq}}
+\newcommand{\bootbackupfilename}{\fname{erosqnative-boot.bin}}
+\newcommand{\jztoolsubcommand}{erosq}
+\newcommand{\screenshotsize}{8cm}
+\newcommand{\disk}{SD card}
+
+% link external keymap file
+\input{platform/keymap-erosqnative.tex}
diff --git a/manual/platform/keymap-erosqnative.tex b/manual/platform/keymap-erosqnative.tex
new file mode 100644
index 0000000000..a05f654769
--- /dev/null
+++ b/manual/platform/keymap-erosqnative.tex
@@ -0,0 +1,118 @@
+% $Id$
+
+\newcommand{\ButtonPower}{\btnfnt{Power}}
+\newcommand{\ButtonPlay}{\btnfnt{Play}}
+\newcommand{\ButtonVolUp}{\btnfnt{Volume Up}}
+\newcommand{\ButtonVolDown}{\btnfnt{Volume Down}}
+\newcommand{\ButtonUp}{\btnfnt{Prev}}
+\newcommand{\ButtonDown}{\btnfnt{Next}}
+\newcommand{\ButtonPrev}{\btnfnt{Prev}}
+\newcommand{\ButtonNext}{\btnfnt{Next}}
+\newcommand{\ButtonSelect}{\btnfnt{Play}}
+\newcommand{\ButtonBack}{\btnfnt{Back}}
+\newcommand{\ButtonMenu}{\btnfnt{Menu}}
+\newcommand{\ButtonScrollFwd}{\btnfnt{Scroll Forward}}
+\newcommand{\ButtonScrollBack}{\btnfnt{Scroll Backward}}
+\newcommand{\ButtonLeft}{\btnfnt{Scroll Backward}}
+\newcommand{\ButtonRight}{\btnfnt{Scroll Forward}}
+
+%Button actions, standard context
+\newcommand{\ActionStdPrev}{\ButtonUp{} or \ButtonScrollBack}
+\newcommand{\ActionStdPrevRepeat}{Long \ButtonUp}
+\newcommand{\ActionStdNext}{\ButtonDown{} or \ButtonScrollFwd}
+\newcommand{\ActionStdNextRepeat}{Long \ButtonDown}
+\newcommand{\ActionStdHotkey}{Long \ButtonPlay}
+\newcommand{\ActionStdOk}{\ButtonPlay}
+\newcommand{\ActionStdCancel}{\ButtonBack}
+\newcommand{\ActionStdContext}{Long \ButtonMenu}
+\newcommand{\ActionStdMenu}{\ButtonMenu}
+\newcommand{\ActionStdKeylock}{\ButtonPower}
+
+%Button actions, wps context
+\newcommand{\ActionWpsBrowse}{\ButtonBack}
+\newcommand{\ActionWpsPlay}{\ButtonPlay}
+\newcommand{\ActionWpsSeekBack}{Long \ButtonPrev}
+\newcommand{\ActionWpsSeekFwd}{Long \ButtonNext}
+\newcommand{\ActionWpsSkipNext}{\ButtonNext}
+\newcommand{\ActionWpsSkipPrev}{\ButtonPrev}
+\newcommand{\ActionWpsQuickScreen}{Long \ButtonPlay}
+\newcommand{\ActionWpsHotkey}{\ButtonScrollBack{} or \ButtonScrollFwd}
+\newcommand{\ActionWpsVolDown}{\ButtonVolDown}
+\newcommand{\ActionWpsVolUp}{\ButtonVolUp}
+\newcommand{\ActionWpsContext}{Long \ButtonMenu}
+\newcommand{\ActionWpsMenu}{\ButtonMenu}
+\newcommand{\ActionWpsStop}{Long \ButtonPower}
+
+%Button actions, settings context
+\newcommand{\ActionSettingsInc}{\ButtonScrollFwd}
+\newcommand{\ActionSettingsIncBigStep}{\ButtonVolUp}
+\newcommand{\ActionSettingsDec}{\ButtonScrollBack}
+\newcommand{\ActionSettingsDecBigStep}{\ButtonVolDown}
+
+%Button actions, list context
+\newcommand{\ActionTreeWps}{Long \ButtonBack}
+\newcommand{\ActionListVolUp}{\ButtonVolUp}
+\newcommand{\ActionListVolDown}{\ButtonVolDown}
+
+%Button actions, tree context
+\newcommand{\ActionTreeHotkey}{Long \ButtonPlay}
+\newcommand{\ActionTreeMenu}{\ButtonMenu}
+\newcommand{\ActionTreeParentDirectory}{\ButtonBack}
+\newcommand{\ActionTreeEnter}{\ButtonSelect}
+
+%Button actions, yesno context
+\newcommand{\ActionYesNoAccept}{\ButtonPlay}
+
+%Button actions, quickscreen context
+\newcommand{\ActionQuickScreenTop}{\ButtonUp}
+\newcommand{\ActionQuickScreenRight}{\ButtonScrollFwd}
+\newcommand{\ActionQuickScreenLeft}{\ButtonScrollBack}
+\newcommand{\ActionQuickScreenDown}{\ButtonDown}
+\newcommand{\ActionQuickScreenExit}{\ButtonBack}
+
+%Button actions, Pitchscreen context
+\newcommand{\ActionPsIncSmall}{\ButtonScrollFwd}
+\newcommand{\ActionPsIncBig}{\ButtonVolUp}
+\newcommand{\ActionPsDecSmall}{\ButtonScrollBack}
+\newcommand{\ActionPsDecBig}{\ButtonVolDown}
+\newcommand{\ActionPsNudgeLeft}{\ButtonPrev}
+\newcommand{\ActionPsNudgeRight}{\ButtonNext}
+\newcommand{\ActionPsToggleMode}{\ButtonPlay}
+\newcommand{\ActionPsReset}{Long \ButtonPlay}
+\newcommand{\ActionPsExit}{\ButtonBack}
+\newcommand{\ActionPsSlower}{Long \ButtonPrev}
+\newcommand{\ActionPsFaster}{Long \ButtonNext}
+
+%Button Actions, keyboard context
+\newcommand{\ActionKbdLeft}{\ButtonScrollBack}
+\newcommand{\ActionKbdRight}{\ButtonScrollFwd}
+\newcommand{\ActionKbdCursorLeft}{\ButtonVolUp}
+\newcommand{\ActionKbdCursorRight}{\ButtonVolDown}
+\newcommand{\ActionKbdUp}{\ButtonUp}
+\newcommand{\ActionKbdDown}{\ButtonDown}
+\newcommand{\ActionKbdPageFlip}{\ButtonMenu}
+\newcommand{\ActionKbdBackspace}{\ButtonBack}
+\newcommand{\ActionKbdSelect}{\ButtonPlay}
+\newcommand{\ActionKbdDone}{Long \ButtonPlay}
+\newcommand{\ActionKbdAbort}{\ButtonPower}
+
+%Button Actions, bookmark context
+\newcommand{\ActionBmDelete}{Long \ButtonPlay}
+
+%Plugin lib actions
+\newcommand{\PluginUp}{\ButtonUp}
+\newcommand{\PluginDown}{\ButtonDown}
+\newcommand{\PluginLeft}{\ButtonLeft}
+\newcommand{\PluginRight}{\ButtonRight}
+\newcommand{\PluginSelect}{\ButtonSelect}
+\newcommand{\PluginSelectRepeat}{Long \ButtonSelect}
+\newcommand{\PluginCancel}{\ButtonBack}
+\newcommand{\PluginExit}{\ButtonPower}
+\newcommand{\PluginScrollFwd}{\ButtonScrollFwd}
+\newcommand{\PluginScrollBack}{\ButtonScrollBack}
+
+\newcommand{\ActionStdUsbCharge}{\ButtonBack}
+
+\newcommand{\ActionIngenicUSBBoot}{\ButtonMenu}
+\newcommand{\ActionBootRecoveryMenu}{\ButtonVolUp}
+\newcommand{\ActionBootOFPlayer}{\ButtonPlay}
diff --git a/manual/platform/keymap-fiiom3k.tex b/manual/platform/keymap-fiiom3k.tex
index ecf07bebd4..5ab89177ec 100644
--- a/manual/platform/keymap-fiiom3k.tex
+++ b/manual/platform/keymap-fiiom3k.tex
@@ -21,15 +21,15 @@
\newcommand{\ActionStdNextRepeat}{\ButtonDown{} or \ButtonScrollFwd}
\newcommand{\ActionStdOk}{\ButtonSelect}
\newcommand{\ActionStdCancel}{\ButtonBack}
-\newcommand{\ActionStdContext}{\ButtonMenu{} or Long \ButtonSelect}
-\newcommand{\ActionStdMenu}{Long \ButtonBack}
-\newcommand{\ActionStdQuickScreen}{Long \ButtonMenu}
+\newcommand{\ActionStdContext}{Long \ButtonSelect}
+\newcommand{\ActionStdMenu}{Long \ButtonMenu}
+\newcommand{\ActionStdQuickScreen}{\ButtonMenu}
\newcommand{\ActionQuickScreenExit}{\ButtonBack{}, \ButtonPower{}, or \ButtonSelect}
\newcommand{\ActionStdUsbCharge}{\ButtonPlay}
%Button actions, wps context
\newcommand{\ActionWpsStop}{Long \ButtonPower}
-\newcommand{\ActionWpsBrowse}{Long \ButtonBack}
+\newcommand{\ActionWpsBrowse}{\ButtonBack}
\newcommand{\ActionWpsVolUp}{\ButtonVolUp}
\newcommand{\ActionWpsVolDown}{\ButtonVolDown}
\newcommand{\ActionWpsSkipPrev}{\ButtonLeft}
@@ -37,20 +37,32 @@
\newcommand{\ActionWpsSeekBack}{Long \ButtonLeft}
\newcommand{\ActionWpsSeekFwd}{Long \ButtonRight}
\newcommand{\ActionWpsPlay}{\ButtonPlay{} or \ButtonSelect}
-\newcommand{\ActionWpsContext}{\ButtonMenu}
-\newcommand{\ActionWpsMenu}{\ButtonBack}
-\newcommand{\ActionWpsQuickScreen}{Long \ButtonMenu}
+\newcommand{\ActionWpsContext}{Long \ButtonSelect}
+\newcommand{\ActionWpsMenu}{Long \ButtonMenu}
+\newcommand{\ActionWpsQuickScreen}{\ButtonMenu}
\newcommand{\ActionWpsHotkey}{Long \ButtonPlay}
\newcommand{\ActionWpsAbSetAPrevDir}{Long \ButtonUp}
\newcommand{\ActionWpsAbSetBNextDir}{Long \ButtonDown}
-\newcommand{\ActionWpsAbReset}{Long \ButtonSelect}
+\newcommand{\ActionWpsAbReset}{Long \ButtonBack}
+
+%Button actions, recording context
+\newcommand{\ActionRecPause}{\ButtonSelect{} or \ButtonPlay}
+\newcommand{\ActionRecExit}{\ButtonBack{} or \ButtonPower}
+\newcommand{\ActionRecNewfile}{Long \ButtonSelect{} or Long \ButtonPlay}
+\newcommand{\ActionRecMenu}{\ButtonMenu}
+\newcommand{\ActionRecPrev}{\ActionStdPrev}
+\newcommand{\ActionRecPrevRepeat}{\ActionStdPrevRepeat}
+\newcommand{\ActionRecNext}{\ActionStdNext}
+\newcommand{\ActionRecNextRepeat}{\ActionStdNextRepeat}
+\newcommand{\ActionRecSettingsInc}{\ButtonVolUp{} or \ButtonRight}
+\newcommand{\ActionRecSettingsDec}{\ButtonVolDown{} or \ButtonLeft}
%Button actions, tree context
-\newcommand{\ActionTreeWps}{Long \ButtonBack}
-\newcommand{\ActionTreeStop}{Long \ButtonPlay}
+\newcommand{\ActionTreeWps}{\ButtonPlay}
+\newcommand{\ActionTreeStop}{Long \ButtonPower}
\newcommand{\ActionTreeParentDirectory}{\ButtonBack}
\newcommand{\ActionTreeEnter}{\ButtonSelect}
-\newcommand{\ActionTreeHotkey}{\ButtonPlay}
+\newcommand{\ActionTreeHotkey}{Long \ButtonPlay}
%Button actions, YesNo context
\newcommand{\ActionYesNoAccept}{\ButtonPlay{} or \ButtonSelect}
diff --git a/manual/platform/keymap-xduoox3.tex b/manual/platform/keymap-xduoox3.tex
index d99a605c12..da35abf9b7 100644
--- a/manual/platform/keymap-xduoox3.tex
+++ b/manual/platform/keymap-xduoox3.tex
@@ -11,6 +11,10 @@
\newcommand{\ButtonLock}{\btnfnt{Lock}}
\newcommand{\ButtonHold}{\btnfnt{Hold Switch}}
+% To make some things happier
+\newcommand{\ButtonLeft}{\btnfnt{Prev}}
+\newcommand{\ButtonRight}{\btnfnt{Next}}
+
%Button actions, standard context
\newcommand{\ActionStdPrev}{\ButtonPrev}
\newcommand{\ActionStdPrevRepeat}{Long \ButtonPrev}
diff --git a/manual/plugins/pictureflow.tex b/manual/plugins/pictureflow.tex
index afab86ef18..2c83a3941f 100644
--- a/manual/plugins/pictureflow.tex
+++ b/manual/plugins/pictureflow.tex
@@ -1,23 +1,44 @@
\subsection{PictureFlow}
\screenshot{plugins/images/ss-pictureflow}{PictureFlow}{img:pictureflow}
-PictureFlow provides a visualisation of your albums with their associated cover
-art. It is possible to start playback of the selected album from PictureFlow.
-Playback will start from the selected track. The PictureFlow plugin will
-continue to run while your tracks are played.
+PictureFlow is a visual browser for your albums. After you've selected something to play,
+PictureFlow will continue running by default, or can show the WPS. The optional WPS
+integration enables access to a context menu for adding albums or songs
+to the dynamic playlist directly from PictureFlow (see \reference{ref:currentplaylist_submenu}).
+
+\subsubsection{Sort Options}
+Albums can be sorted by:
+
+\begin{itemize}
+ \item Name
+ \item Year
+ \item Album Artist + Name
+ \item Album Artist + Year
+\end{itemize}
\subsubsection{Requirements}
-PictureFlow uses both the album art (see \reference{ref:album_art}) and
+PictureFlow uses both the album art (see \reference{ref:album_art}) and
database (see \reference{ref:database}) features of Rockbox.
-It is therefore important that these are working correctly before attempting
-to use PictureFlow. In addition, there are some other points of which to be
-aware:
+These need to be working correctly before PictureFlow can be used.
+\textbf{PictureFlow does not support embedded album art.}
+
+\opt{tc_ramcache}{\note{It is strongly recommended you enable the database's "Load to RAM" feature
+(and restart your player afterwards)! See \reference{ref:databasemenu}. This will \textbf{vastly} speed up
+building the album index as well as loading of track titles when browsing albums.}}
+
+\opt{dircache}{\note{Enabling the disk's directory cache – see \reference{ref:dircache} – noticeably
+reduces the time it takes for cover art to be displayed.}}
+
\begin{itemize}
- \item First an album index must be built, If you have a lot of albums/artists
- this could take a while, any button cancels the process and quits pictureflow.
- \item You don't have to wait for the albumart search to finish, you can press
- any button and the albumart will be searched in the background.
- \item Pictureflow checks for updated albumart (in background) on every restart
+ \item PictureFlow needs to build an album index the first time it's launched
+ (Cancel/Quit by pressing any button) and then writes an album art cache to disk.
+ During the latter, press any button to skip past the progress bar screen and
+ to start browsing immediately. Processing of album art will continue in the
+ background. An indicator in the screen corner shows you the completed percentage.
+ When the cache is being built, the UI may be slow to react to your input.
+ For optimal performance, wait for processing to complete.
+ \item Each time you update your player's database, you should manually rebuild or
+ update the cache in PictureFlow.
\item PictureFlow will accept album art larger than the dimensions of the
screen, but the larger the dimensions, the longer they will take to scale.
\end{itemize}
@@ -32,11 +53,11 @@ aware:
Scroll through albums / track list
\\
}
-
+
% only scroll wheel and `strip' targets use the same action in album and track list
\nopt{scrollwheel,IRIVER_H10_PAD,PBELL_VIBE500_PAD,MPIO_HD300_PAD}{%
% currently the M3 does not use buttons of the main unit which has no display
- \nopt{IAUDIO_M3_PAD,MPIO_HD200_PAD,touchscreen}{\ButtonLeft{} / \ButtonRight}
+ \nopt{IAUDIO_M3_PAD,MPIO_HD200_PAD,touchscreen}{\ButtonLeft{} / \ButtonRight{}}
\opt{MPIO_HD200_PAD}{FIXME}
\opt{touchscreen}{\TouchMidLeft{} / \TouchMidRight}
&
@@ -57,10 +78,33 @@ aware:
\\
}
+ \opt{FIIO_M3K_PAD}{
+ \ButtonLeft{} / \ButtonRight{}
+ &
+ \opt{HAVEREMOTEKEYMAP}{&}
+ Quickly jump to another album (alphabetically or by year) /
+ browse through albums from track list
+ \\
+ }
+ \opt{IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD}{
+ \ButtonLeft{} / \ButtonRight{}
+ &
+ \opt{HAVEREMOTEKEYMAP}{&}
+ Quickly jump to another album (alphabetically or by year)
+ \\
+ }
+ \opt{FIIO_M3K_PAD}{
+ \ButtonVolUp{} / \ButtonVolDown
+ &
+ \opt{HAVEREMOTEKEYMAP}{&}
+ Adjust current album sorting
+ \\
+ }
+
\nopt{IAUDIO_M3_PAD}{%
\nopt{IRIVER_H10_PAD,touchscreen,PBELL_VIBE500_PAD%
,SANSA_FUZE_PAD,MPIO_HD200_PAD,MPIO_HD300_PAD,SAMSUNG_YH92X_PAD%
- ,SAMSUNG_YH820_PAD}
+ ,SAMSUNG_YH820_PAD,XDUOO_X3_PAD}
{\ButtonSelect}
\opt{IRIVER_H10_PAD,PBELL_VIBE500_PAD}{\ButtonRight}
\opt{SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ButtonFF}
@@ -68,6 +112,7 @@ aware:
\opt{SANSA_FUZE_PAD}{\ButtonRight}
\opt{MPIO_HD200_PAD}{\ButtonFunc}
\opt{MPIO_HD300_PAD}{\ButtonEnter}
+ \opt{XDUOO_X3_PAD}{\ButtonPlay}
}
&
\opt{HAVEREMOTEKEYMAP}{
@@ -85,11 +130,13 @@ aware:
Play album from selected track in track list
\\
}
-
- \nopt{IAUDIO_M3_PAD,MPIO_HD200_PAD,MPIO_HD300_PAD,touchscreen,SANSA_FUZEPLUS_PAD}{\ButtonLeft}
+
+ \nopt{IAUDIO_M3_PAD,MPIO_HD200_PAD,MPIO_HD300_PAD,touchscreen,SANSA_FUZEPLUS_PAD,%
+ FIIO_M3K_PAD}{\ButtonLeft}
\opt{MPIO_HD200_PAD}{\ButtonRec}
\opt{MPIO_HD300_PAD}{\ButtonMenu}
\opt{SANSA_FUZEPLUS_PAD}{\ButtonLeft{} or \ButtonBack}
+ \opt{FIIO_M3K_PAD}{\ButtonBack}
\opt{touchscreen}{
\opt{COWON_D2_PAD}{\ButtonPower{} or}
\TouchBottomRight}
@@ -100,10 +147,16 @@ aware:
Exit track list
\\
- \nopt{IAUDIO_M3_PAD,SANSA_FUZEPLUS_PAD}{\ActionStdMenu}
- \nopt{IAUDIO_M3_PAD,SANSA_FUZEPLUS_PAD,SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{\ActionStdMenu}
- \opt{SANSA_FUZEPLUS_PAD}{long \ButtonSelect}
- \opt{SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{or \ButtonRew}
+ \ActionStdContext
+ &
+ \opt{HAVEREMOTEKEYMAP}{&}
+ Enter context menu (if WPS integration is enabled)
+ \\
+
+ \nopt{IAUDIO_M3_PAD,SANSA_FUZEPLUS_PAD,FIIO_M3K_PAD}{\ActionStdMenu}
+ \opt{SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{or \ButtonRew}
+ \opt{SANSA_FUZEPLUS_PAD}{Long \ButtonSelect}
+ \opt{FIIO_M3K_PAD}{\ButtonPower}
&
\opt{HAVEREMOTEKEYMAP}{
\opt{IAUDIO_M3_PAD,GIGABEAT_RC_PAD}{\ActionRCStdMenu}
@@ -117,11 +170,12 @@ aware:
,MROBE100_PAD,SANSA_FUZEPLUS_PAD}{\ButtonPower}
\opt{SANSA_C200_PAD,IRIVER_H10_PAD}{Long \ButtonPower}
\opt{IPOD_4G_PAD,IPOD_3G_PAD}{Long \ButtonMenu}
- \opt{SANSA_FUZE_PAD}{Long \ButtonHome}
+ \opt{SANSA_FUZE_PAD}{Long \ButtonHome}
\opt{PBELL_VIBE500_PAD}{\ButtonRec}
\opt{SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD}{long \ButtonRew}
\opt{MPIO_HD200_PAD}{FIXME}
\opt{MPIO_HD300_PAD}{Long \ButtonMenu}
+ \opt{FIIO_M3K_PAD}{\ButtonBack}
\opt{touchscreen}{
\opt{COWON_D2_PAD}{Long \ButtonPower{} or}
\TouchBottomRight{} (in album view)}
@@ -133,12 +187,13 @@ aware:
&}
Exit PictureFlow
\\
-
+
\end{btnmap}
\subsubsection{Main Menu}
\begin{description}
- \item[Go to WPS.] Leave PictureFlow and enter the while playing screen.
+ \item[Go to WPS.] Leave PictureFlow and enter the While Playing Screen.
+ \item[Clear playlist] Removes all entries from the current playlist.
\item[Playback Control.] Control music playback from within the plugin.
\item[Settings.] Enter the settings menu.
\item[Return.] Exit menu.
@@ -148,7 +203,14 @@ aware:
\subsubsection{Settings Menu}
\begin{description}
- \item[Show FPS.] Displays frames per second on screen.
+ \item[Show album title.] Allows setting the album title / artist to be
+ shown above or below the cover art, or not at all.
+ \item[Show year in album title.] Set whether a year will be displayed next to each album
+ title (determined by the release year of the latest track on an album).
+ \item[Sort albums by.] Change the sorting of albums in PictureFlow.
+ \item[Year sort order.] Determines whether albums are sorted in ascending or descending
+ order, when sorting by year.
+ \item[Display FPS.] Displays frames per second on screen.
\item[Spacing.] The distance between the front edges of the side slides, i.e. changes
the degree of overlap of the side slides. A larger number means less overlap. Scales with zoom.
\item[Centre margin.] The distance, in screen pixels, with zoom at 100, between
@@ -157,14 +219,12 @@ aware:
centre slide. Therefore if set to 4, there will be 3 slides on the left,
the centre slide, and then 3 slides on the right.
\item[Zoom.] Changes the distance at which slides are rendered from the ``camera''.
- \item[Show album title.] Allows setting the album title / artist to be
- shown above or below the cover art, or not at all.
\item[Resize Covers.] Set whether to automatically resize the covers or to leave
them at their original size.
- \item[Rebuild cache.] Rebuild the PictureFlow cache. This is needed in order
- for PictureFlow to pick up new albums, and may occasionally be needed if albums
- are removed.
- \item[Update cache.] Update the PictureFlow cache. New albumart will be added.
- \item[WPS integration.] Integrate pictureflow with the While Playing Screen.
+ \item[Rebuild cache.] Creates a fresh album index and builds the artwork cache from scratch.
+ \item[Update cache.] Creates a fresh album index and updates the existing artwork cache to
+ include newly added albums.
+ \item[WPS integration.] Integrate PictureFlow with the While Playing Screen and enable
+ the Current Playlist context menu.
\item[Backlight.] Force backlight on while running pictureflow.
\end{description}
diff --git a/manual/plugins/text_viewer.tex b/manual/plugins/text_viewer.tex
index 2e215cca38..307ee3edc5 100644
--- a/manual/plugins/text_viewer.tex
+++ b/manual/plugins/text_viewer.tex
@@ -234,7 +234,7 @@ by using \emph{Open with} from the \emph{Context Menu}
(Useful for displaying right-to-left languages, such as Arabic or Hebrew)
\item[Left] Set the text alignment to the left.
\end{description}
- \item[Show Header] Select whether to show the header. The header displays the file path.
+ \item[Show Header] Select whether to show the header. The header displays the file path.
\begin{description}
\item[No] Do not display the header.
\item[Yes] Display the header.
@@ -333,7 +333,7 @@ stores its settings, the current position and bookmarks in
\end{description}
\subsubsection{Bookmarks}
- To add a bookmark, press
+ To add a bookmark, press
\opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn+\ButtonSelect}%
\opt{IPOD_4G_PAD,IPOD_3G_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD}{\ButtonSelect}%
\opt{IRIVER_H10_PAD}{\ButtonFF}\opt{IAUDIO_X5_PAD}{\ButtonRec}%
@@ -346,4 +346,3 @@ stores its settings, the current position and bookmarks in
press the same button again.
\screenshot{plugins/images/ss-text_viewer-bookmark}{A bookmark}{img:text_viewer-bookmark}
-
diff --git a/manual/preamble.tex b/manual/preamble.tex
index 187f7c1f3a..379d00173b 100644
--- a/manual/preamble.tex
+++ b/manual/preamble.tex
@@ -20,7 +20,7 @@
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\documentclass[a4paper,11pt,hyphens]{scrreprt}
-\usepackage[utf8]{inputenx}
+\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
% load ix-utf8enc.dfu to get additional characters from the inputenx package.
\makeatletter\input{ix-utf8enc.dfu}\makeatother
@@ -126,7 +126,7 @@
%% \newenvironment{example}
%% {\stepcounter{example}\paragraph{Example \theexample:}}
%% {\hfill$\Box$
-
+
%% \bigskip
%% \noindent}
@@ -146,7 +146,7 @@
\long\gdef\nil#1{\IfN@Ught#1* {#1}!}% if null
\long\gdef\IfN@Ught#1 #2!{\blank{#2}}
\long\gdef\Ifbl@nk#1#2Q#3!{\ifx#3}% same as above
-}
+}
% environment for setting the changelog.
\newenvironment{changelog}%
@@ -262,7 +262,7 @@
% B1 & B2\\
% C1 & C2\\
% \end{rbtabular}
-%
+%
\newenvironment{rbtabular}[5]{%
\rowcolors{2}{tbloddrowbgcolor}{tblevenrowbgcolor}
\expandafter\let\expandafter\SavedEndTab\csname endtabular*\endcsname
@@ -317,7 +317,7 @@
% set link to download server
% Usage: \download{bootloader/bootloader-ipodnano.ipod}
-% gets expanded to
+% gets expanded to
% "https://download.rockbox.org/bootloader/bootloader-ipodnano.ipod"
\newcommand{\download}[1]{\url{https://download.rockbox.org/#1}}
diff --git a/manual/rockbox_interface/browsing_and_playing.tex b/manual/rockbox_interface/browsing_and_playing.tex
index 1c8e6ed5d2..1a97aaab31 100644
--- a/manual/rockbox_interface/browsing_and_playing.tex
+++ b/manual/rockbox_interface/browsing_and_playing.tex
@@ -66,7 +66,7 @@ the \setting{Show Files} setting to all.
& If there is an audio file playing, return to the
\setting{While Playing Screen} (WPS) without stopping playback.\\
%
- \nopt{player,SANSA_C200_PAD}%
+ \nopt{player,SANSA_C200_PAD,erosqnative}%
{%
\ActionTreeStop
\opt{HAVEREMOTEKEYMAP}{& \ActionRCTreeStop}
@@ -81,11 +81,13 @@ the \setting{Show Files} setting to all.
\opt{HAVEREMOTEKEYMAP}{& \ActionRCStdMenu}
& Enter the \setting{Main Menu}.\\
%
- \opt{quickscreen}{
- \ActionStdQuickScreen
- \opt{HAVEREMOTEKEYMAP}{& \ActionRCStdQuickScreen}
- & Switch to the \setting{Quick Screen}
- (see \reference{ref:QuickScreen}). \\
+ \nopt{erosqnative}{
+ \opt{quickscreen}{
+ \ActionStdQuickScreen
+ \opt{HAVEREMOTEKEYMAP}{& \ActionRCStdQuickScreen}
+ & Switch to the \setting{Quick Screen}
+ (see \reference{ref:QuickScreen}). \\
+ }
}
%
\opt{SANSA_E200_PAD}{
diff --git a/manual/rockbox_interface/main.tex b/manual/rockbox_interface/main.tex
index ccc6e25ae6..82192829fd 100644
--- a/manual/rockbox_interface/main.tex
+++ b/manual/rockbox_interface/main.tex
@@ -518,7 +518,7 @@ To turn on and off your Rockbox enabled \dap{} use the following keys:
\opt{IPOD_3G_PAD}{\ButtonMenu{} / \ButtonPlay}%
\opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD,SANSA_C200_PAD,ONDA_VX777_PAD%
,GIGABEAT_PAD,MROBE100_PAD,GIGABEAT_S_PAD,sansaAMS,PBELL_VIBE500_PAD%
- ,SANSA_FUZEPLUS_PAD,XDUOO_X3_PAD%
+ ,SANSA_FUZEPLUS_PAD,XDUOO_X3_PAD,AIGO_EROSQ_PAD%
}{\ButtonPower}%
\opt{COWON_D2_PAD} {\ButtonPower{}, then \ButtonHold}%
\opt{ONDA_VX777_PAD} {\ButtonPower{}}%
@@ -538,7 +538,7 @@ To turn on and off your Rockbox enabled \dap{} use the following keys:
\opt{IPOD_4G_PAD,IPOD_3G_PAD}{Long \ButtonPlay}%
\opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD,SANSA_C200_PAD%
,GIGABEAT_PAD,MROBE100_PAD,GIGABEAT_S_PAD,sansaAMS,COWON_D2_PAD%
- ,PBELL_VIBE500_PAD,ONDA_VX777_PAD,SANSA_FUZEPLUS_PAD,XDUOO_X3_PAD%
+ ,PBELL_VIBE500_PAD,ONDA_VX777_PAD,SANSA_FUZEPLUS_PAD,XDUOO_X3_PAD,AIGO_EROSQ_PAD%
}{Long \ButtonPower}%
\opt{AGPTEK_ROCKER_PAD}{Long \ButtonPower{}}%
&
@@ -721,15 +721,17 @@ To turn on and off your Rockbox enabled \dap{} use the following keys:
and then press the \ButtonPower{} button.
}
- \opt{fiiom3k,shanlingq1}
+ \opt{fiiom3k,shanlingq1,erosqnative}
{
Rockbox has a dual-boot feature. To boot into the original firmware,
hold \ActionBootOFPlayer{} when powering on the \dap{}.
- You can trigger a normal \playerman{} firmware update by holding
- \ActionBootOFRecovery{} when powering on the \dap{}.
- \warn{Updating the original firmware will \textbf{erase} the Rockbox
+ \nopt{erosqnative}{
+ You can trigger a normal \playerman{} firmware update by holding
+ \ActionBootOFRecovery{} when powering on the \dap{}.
+ \warn{Updating the original firmware will \textbf{erase} the Rockbox
bootloader.}
+ }
\subsection{Entering the recovery menu}
You can access the Rockbox bootloader's ``recovery menu'' by holding
@@ -846,16 +848,13 @@ properly.}
\opt{usb_power}{
\section{USB Charging}
- Whenever your \dap{} is connected to USB, it will automatically charge.
- However, depending on the \config{usb\_mode} setting, the \dap{} may also
- enter mass storage mode or prompt the user for what action to take.
- When the \dap{} is configured to enter mass storage mode or automatically
- charge, you may trigger the opposite behavior by holding down any button
- while plugging it in. Your \dap{} must already be in Rockbox for this to
- function.
+ Your \dap{} will automatically charge when connected to USB. By default
+ Rockbox will connect in mass storage mode to transfer files, but you can
+ prevent this by holding down any button while plugging in the USB cable,
+ or by changing the \setting{USB Mode} setting to \setting{Charge Only}.
\nopt{fuzeplus}{
- \note{Be aware that this button may still perform its normal function, so
- it is recommended to use a button without harmful side effects, such as
+ \note{Be aware that holding a button may still perform its normal function,
+ so it is recommended to use a button without harmful side effects, such as
\ActionStdUsbCharge{}.}
}
}
diff --git a/manual/rockbox_interface/wps.tex b/manual/rockbox_interface/wps.tex
index d52893f55b..7623f89146 100644
--- a/manual/rockbox_interface/wps.tex
+++ b/manual/rockbox_interface/wps.tex
@@ -81,7 +81,7 @@ your WPS (While Playing Screen).
% software hold targets
\nopt{hold_button}{%
\opt{SANSA_CLIP_PAD}{\ButtonHome+\ButtonSelect}
- \opt{SANSA_FUZEPLUS_PAD}{\ButtonPower}
+ \opt{SANSA_FUZEPLUS_PAD,AIGO_EROSQ_PAD}{\ButtonPower}
& Key lock (software hold switch) on/off.\\
}%
% We explicitly list all the appropriate targets here and do no condition
@@ -112,21 +112,23 @@ your WPS (While Playing Screen).
\opt{ab_repeat_buttons}{%
\ActionWpsAbSetBNextDir{} or }%
% not all targets have the above action defined but the one below works on all
- Short \ActionWpsSkipNext{} + Long \ActionWpsSkipNext
- \opt{HAVEREMOTEKEYMAP}{
- &
+ \nopt{erosqnative}{
+ Short \ActionWpsSkipNext{} + Long \ActionWpsSkipNext
+ \opt{HAVEREMOTEKEYMAP}{
+ &
\opt{IRIVER_RC_H100_PAD}{\ActionRCWpsAbSetBNextDir{} or}
- Short \ActionRCWpsSkipNext{} + Long \ActionRCWpsSkipNext}
- & Skip to the next directory.\\
- %
- \opt{ab_repeat_buttons}{%
- \ActionWpsAbSetAPrevDir{} or }%
- Short \ActionWpsSkipPrev{} + Long \ActionWpsSkipPrev
- \opt{HAVEREMOTEKEYMAP}{
- &
+ Short \ActionRCWpsSkipNext{} + Long \ActionRCWpsSkipNext}
+ & Skip to the next directory.\\
+ %
+ \opt{ab_repeat_buttons}{%
+ \ActionWpsAbSetAPrevDir{} or }%
+ Short \ActionWpsSkipPrev{} + Long \ActionWpsSkipPrev
+ \opt{HAVEREMOTEKEYMAP}{
+ &
\opt{IRIVER_RC_H100_PAD}{\ActionRCWpsAbSetAPrevDir{} or}
- Short \ActionRCWpsSkipPrev{} + Long \ActionRCWpsSkipPrev}
- & Skip to the previous directory.\\
+ Short \ActionRCWpsSkipPrev{} + Long \ActionRCWpsSkipPrev}
+ & Skip to the previous directory.\\
+ }
%
\opt{SANSA_E200_PAD,SANSA_C200_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{
\ActionStdRec
@@ -233,7 +235,7 @@ album etc. To access this screen, %
\opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IRIVER_H10_PAD,%
SANSA_C200_PAD,SANSA_E200_PAD,SANSA_FUZE_PAD,SANSA_FUZEPLUS_PAD}{
press \ActionWpsIdThreeScreen. }%
-\opt{IPOD_4G_PAD,IPOD_3G_PAD,IAUDIO_X5_PAD,IAUDIO_M3_PAD,%
+\opt{IPOD_4G_PAD,IPOD_3G_PAD,IAUDIO_X5_PAD,IAUDIO_M3_PAD,FIIO_M3K_PAD,%
GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD,SANSA_CLIP_PAD,PBELL_VIBE500_PAD,%
MPIO_HD200_PAD,MPIO_HD300_PAD,SAMSUNG_YH92X_PAD,SAMSUNG_YH820_PAD,XDUOO_X3_PAD}%
{press \ActionWpsContext{} to access the
diff --git a/manual/working_with_playlists/main.tex b/manual/working_with_playlists/main.tex
index d478dcd283..8571aac61c 100644
--- a/manual/working_with_playlists/main.tex
+++ b/manual/working_with_playlists/main.tex
@@ -48,11 +48,11 @@ song.
rather than erasing the current
playlist, see the section below on how to add music to a playlist.}
-\subsubsection{By using the Clear List \& Play Next function}
-The \setting{Clear List \& Play Next} function as described in
-\ref{ref:currentplaylist_submenu} will replace the dynamic playlist with the selected
-tracks. If a track is currently playing, it is only removed once it’s finished
-playing.
+\subsubsection{By using the Play or Play Shuffled functions}
+The \setting{Play} function as described in \ref{ref:currentplaylist_submenu}
+will replace the dynamic playlist with the selected tracks. The \setting{Play
+Shuffled} function is similar, except the selected tracks will be added to the
+playlist in a random order.
\subsubsection{\label{ref:playlist_catalogue}By using the Playlist catalogue}
The \setting{Playlist catalogue} makes it possible to modify and create
@@ -96,20 +96,6 @@ have not been added yet, immediately after the currently playing track.
\item [Insert Last Shuffled.] Add tracks in a random order to the end of the playlist.
\end{description}
-If you want the existing playlist entries to first be removed before
-selected tracks are inserted, the following two options will achieve that effect.
-They are also available when playback is stopped, whereas the rest of the options
-require music to be playing or paused.
-
-\begin{description}
-\item [Clear List \& Play Next.] Replace all entries in the dynamic playlist with
-selected tracks. If a track is currently playing, it will be removed once it’s
-finished playing.
-
-\item [Clear List \& Play Shuffled.] Similar, except tracks are added in random order.
-Only available when playback is stopped.
-\end{description}
-
Another possibility is to add tracks \emph{temporarily} to the dynamic playlist.
In Rockbox’s parlance, this is called queuing. Queued tracks are automatically
removed from the playlist after they have been played. They are also not saved
@@ -127,6 +113,20 @@ to the playlist file (see \reference{ref:playlistoptions}).
\item [Queue Last Shuffled.] Corresponds to \setting{Insert Last Shuffled}.
\end{description}
+If you'd like to replace the current playlist with the new selection, the
+following two options will achieve that effect.
+
+\begin{description}
+\item [Play.] Replace all entries in the dynamic playlist with the selected
+ tracks. If \setting{Keep Current Track When Replacing Playlist} is set to
+ \setting{Yes}, the new tracks will play after the current track finishes
+ playing; if no track is playing or the setting is \setting{No}, the new
+ tracks will begin playing immediately.
+
+\item [Play Shuffled.] Similar, except the tracks will be added to the new
+ playlist in random order.
+\end{description}
+
\note{You can hide the options to add shuffled tracks or to queue tracks, if you wish.
The latter can also be put into its own submenu. Simply go to
\setting{Settings} $\rightarrow$ \setting{General Settings} $\rightarrow$ \setting{Playlists}