1 \subsection{Text Viewer
}
2 \screenshot{plugins/images/ss-text_viewer-main
}{Text Viewer
}{img:text_viewer-main
}
3 This is a Viewer for text files with word wrap. Just open a
\fname{.txt
} or
4 \fname{.nfo
} file to display it. The text viewer features controls to handle
5 various styles of text formatting and has top
{}-of
{}-file and bottom
{}-of
{}-file
6 buttons. You can view files without a
\fname{.txt
} or
\fname{.nfo
} extension
7 by using
\emph{Open with
} from the
\emph{Context Menu
}
8 (see
\reference{ref:Contextmenu
}). You can also bookmark pages.
10 \subsubsection{Default keys
}
12 \opt{PLAYER_PAD
}{\ButtonLeft}
13 \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD
%
14 ,SANSA_E200_PAD,SANSA_FUZE_PAD,GIGABEAT_PAD,MROBE100_PAD,SANSA_FUZEPLUS_PAD
}{\ButtonUp}
15 \opt{IPOD_4G_PAD,IPOD_3G_PAD
}{\ButtonScrollBack}
16 \opt{IRIVER_H10_PAD,MPIO_HD300_PAD
}{\ButtonScrollUp}
17 \opt{SANSA_C200_PAD,SANSA_CLIP_PAD
}{\ButtonVolUp}
18 \opt{GIGABEAT_S_PAD
}{\ButtonPrev}
19 \opt{COWON_D2_PAD
}{\ButtonMinus{} /
}%
20 \opt{touchscreen
}{\TouchTopMiddle}
21 \opt{PBELL_VIBE500_PAD
}{\ButtonOK}
22 \opt{MPIO_HD200_PAD
}{\ButtonRew}
23 \opt{HAVEREMOTEKEYMAP
}{&
24 \opt{IAUDIO_M3_PAD
}{\ButtonRCUp}
28 \opt{PLAYER_PAD
}{\ButtonRight}
29 \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD
%
30 ,SANSA_E200_PAD,SANSA_FUZE_PAD,GIGABEAT_PAD,MROBE100_PAD,SANSA_FUZEPLUS_PAD
}{\ButtonDown}
31 \opt{IPOD_4G_PAD,IPOD_3G_PAD
}{\ButtonScrollFwd}
32 \opt{IRIVER_H10_PAD,MPIO_HD300_PAD
}{\ButtonScrollDown}
33 \opt{SANSA_C200_PAD,SANSA_CLIP_PAD
}{\ButtonVolDown}
34 \opt{GIGABEAT_S_PAD
}{\ButtonNext}
35 \opt{COWON_D2_PAD
}{\ButtonPlus{} /
}%
36 \opt{touchscreen
}{\TouchBottomMiddle}
37 \opt{PBELL_VIBE500_PAD
}{\ButtonCancel}
38 \opt{MPIO_HD200_PAD
}{\ButtonFF}
39 \opt{HAVEREMOTEKEYMAP
}{&
40 \opt{IAUDIO_M3_PAD
}{\ButtonRCDown}
44 \opt{PLAYER_PAD
}{\ButtonMenu+
\ButtonLeft}
45 \opt{GIGABEAT_S_PAD
}{\ButtonPlay+
\ButtonLeft}
46 \opt{MPIO_HD200_PAD
}{\ButtonVolDown}
47 \opt{MPIO_HD300_PAD
}{\ButtonRew}
48 \opt{touchscreen
}{\TouchMidLeft}
49 \nopt{PLAYER_PAD,GIGABEAT_S_PAD,touchscreen,IAUDIO_M3_PAD,MPIO_HD200_PAD
%
50 ,MPIO_HD300_PAD
}{\ButtonLeft}
51 \opt{HAVEREMOTEKEYMAP
}{&
52 \opt{IAUDIO_M3_PAD
}{\ButtonRCLeft}
54 & Top of file (Narrow mode) /
55 One screen left (Wide mode)\\
57 \opt{PLAYER_PAD
}{\ButtonMenu+
\ButtonRight}
58 \opt{GIGABEAT_S_PAD
}{\ButtonPlay+
\ButtonRight}
59 \opt{MPIO_HD200_PAD
}{\ButtonVolUp}
60 \opt{MPIO_HD300_PAD
}{\ButtonFF}
61 \opt{touchscreen
}{\TouchMidRight}
62 \nopt{PLAYER_PAD,GIGABEAT_S_PAD,touchscreen,IAUDIO_M3_PAD,MPIO_HD200_PAD
%
63 ,MPIO_HD300_PAD
}{\ButtonRight}
64 \opt{HAVEREMOTEKEYMAP
}{&
65 \opt{IAUDIO_M3_PAD
}{\ButtonRCRight}
67 & Bottom of file (Narrow mode) /
68 One screen right (Wide mode)\\
70 \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,SANSA_E200_PAD
%
71 ,SANSA_FUZE_PAD,SANSA_C200_PAD,SANSA_CLIP_PAD,GIGABEAT_S_PAD
%
72 ,GIGABEAT_PAD,PBELL_VIBE500_PAD,SANSA_FUZEPLUS_PAD
}{%
73 \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD
}{\ButtonOn+
\ButtonUp}
74 \opt{SANSA_E200_PAD,SANSA_FUZE_PAD
}{\ButtonScrollBack}
75 \opt{SANSA_C200_PAD,SANSA_CLIP_PAD,GIGABEAT_S_PAD,PBELL_VIBE500_PAD
}{\ButtonUp}
76 \opt{GIGABEAT_PAD
}{\ButtonA+
\ButtonUp}
77 \opt{SANSA_FUZEPLUS_PAD
}{\ButtonVolUp}
78 \opt{HAVEREMOTEKEYMAP
}{&
}
82 \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,SANSA_E200_PAD
%
83 ,SANSA_FUZE_PAD,SANSA_C200_PAD,SANSA_CLIP_PAD,GIGABEAT_S_PAD
%
84 ,GIGABEAT_PAD,PBELL_VIBE500_PAD,SANSA_FUZEPLUS_PAD
}{%
85 \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD
}{\ButtonOn+
\ButtonDown}
86 \opt{SANSA_E200_PAD,SANSA_FUZE_PAD
}{\ButtonScrollFwd}
87 \opt{SANSA_C200_PAD,SANSA_CLIP_PAD,GIGABEAT_S_PAD,PBELL_VIBE500_PAD
}{\ButtonDown}
88 \opt{GIGABEAT_PAD
}{\ButtonA+
\ButtonDown}
89 \opt{SANSA_FUZEPLUS_PAD
}{\ButtonVolDown}
90 \opt{HAVEREMOTEKEYMAP
}{&
}
94 \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,GIGABEAT_PAD,
%
95 GIGABEAT_S_PAD,SANSA_FUZEPLUS_PAD
}{
96 \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD
}{\ButtonOn+
\ButtonLeft}
97 \opt{GIGABEAT_S_PAD
}{\ButtonLeft}
98 \opt{GIGABEAT_PAD
}{\ButtonA+
\ButtonLeft}
99 \opt{SANSA_FUZEPLUS_PAD
}{\ButtonBottomLeft}
100 \opt{HAVEREMOTEKEYMAP
}{&
}
104 \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,GIGABEAT_PAD,
%
105 GIGABEAT_S_PAD,SANSA_FUZEPLUS_PAD
}{
106 \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD
}{\ButtonOn+
\ButtonRight}
107 \opt{GIGABEAT_S_PAD
}{\ButtonRight}
108 \opt{GIGABEAT_PAD
}{\ButtonA+
\ButtonRight}
109 \opt{SANSA_FUZEPLUS_PAD
}{\ButtonBottomRight}
110 \opt{HAVEREMOTEKEYMAP
}{&
}
114 \opt{RECORDER_PAD,PLAYER_PAD,IPOD_4G_PAD,IPOD_3G_PAD,IAUDIO_X5_PAD
%
115 ,IRIVER_H10_PAD,GIGABEAT_S_PAD,PBELL_VIBE500_PAD
%
116 ,MPIO_HD200_PAD,MPIO_HD300_PAD,SANSA_FUZEPLUS_PAD
}{\ButtonPlay}
117 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD
}{\ButtonSelect}
118 \opt{ONDIO_PAD
}{\ButtonMenu}
119 \opt{GIGABEAT_PAD
}{\ButtonA}
120 \opt{SANSA_C200_PAD,SANSA_E200_PAD
}{\ButtonRec}
121 \opt{SANSA_CLIP_PAD
}{\ButtonHome}
122 \opt{SANSA_FUZE_PAD
}{\ButtonDown+
\ButtonSelect}
123 \opt{MROBE100_PAD
}{\ButtonDisplay}
124 \opt{MPIO_HD200_PAD
}{FIXME
}
125 \opt{touchscreen
}{\TouchCenter}
126 \opt{HAVEREMOTEKEYMAP
}{&
127 \opt{IAUDIO_M3_PAD
}{\ButtonRCMode}
129 & Toggle autoscroll\\
131 \opt{PLAYER_PAD
}{\ButtonOn}
132 \opt{RECORDER_PAD
}{\ButtonFTwo}
133 \opt{ONDIO_PAD
}{\ButtonMenu+
\ButtonOff}
134 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD
}{\ButtonOn+
\ButtonSelect}
135 \opt{IPOD_4G_PAD,IPOD_3G_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD
}{\ButtonSelect}
136 \opt{IRIVER_H10_PAD
}{\ButtonFF}
137 \opt{IAUDIO_X5_PAD
}{\ButtonRec}
138 \opt{SANSA_FUZEPLUS_PAD
}{Long
\ButtonSelect}
139 \opt{SANSA_E200_PAD,SANSA_C200_PAD,SANSA_CLIP_PAD
}{\ButtonDown+
\ButtonSelect}
140 \opt{COWON_D2_PAD
}{\ButtonMenu+
\ButtonPlus}
141 \opt{SANSA_FUZE_PAD
}{\ButtonUp+
\ButtonSelect}
142 \opt{PBELL_VIBE500_PAD
}{\ButtonPower}
143 \opt{MPIO_HD200_PAD
}{\ButtonRec}
144 \opt{MPIO_HD300_PAD
}{\ButtonEnter}
145 \opt{HAVEREMOTEKEYMAP
}{&
146 \opt{IAUDIO_M3_PAD
}{\ButtonRCPlay+
\ButtonRCMode}
148 & Set/Reset bookmarks\\
150 \opt{RECORDER_PAD
}{\ButtonFOne}
151 \opt{ONDIO_PAD
}{Long
\ButtonMenu}
152 \opt{PLAYER_PAD,IPOD_4G_PAD,IPOD_3G_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD
%
153 ,MROBE100_PAD,PBELL_VIBE500_PAD,MPIO_HD300_PAD
}{\ButtonMenu}
154 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD
}{\ButtonMode}
155 \opt{IAUDIO_X5_PAD,SANSA_C200_PAD,SANSA_CLIP_PAD,SANSA_E200_PAD
}{\ButtonSelect}
156 \opt{SANSA_FUZE_PAD
}{Long
\ButtonSelect}
157 \opt{SANSA_FUZEPLUS_PAD
}{\ButtonBack}
158 \opt{IRIVER_H10_PAD
}{\ButtonRew}
159 \opt{COWON_D2_PAD
}{\ButtonMenu{} /
}%
160 \opt{MPIO_HD200_PAD
}{\ButtonFunc}
161 \opt{touchscreen
}{\TouchTopRight}
162 \opt{HAVEREMOTEKEYMAP
}{&
163 \opt{IAUDIO_M3_PAD
}{\ButtonRCPlay}
167 \opt{PLAYER_PAD
}{\ButtonStop}
168 \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD
}{\ButtonOff}
169 \opt{IPOD_4G_PAD,IPOD_3G_PAD
}{\ButtonSelect+
\ButtonMenu}
170 \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD,SANSA_C200_PAD,SANSA_CLIP_PAD
%
171 ,GIGABEAT_PAD,MROBE100_PAD,SANSA_FUZEPLUS_PAD
}{\ButtonPower}
172 \opt{SANSA_FUZE_PAD
}{Long
\ButtonHome}
173 \opt{GIGABEAT_S_PAD
}{\ButtonBack}
174 \opt{COWON_D2_PAD
}{\ButtonPower{} /
}%
175 \opt{touchscreen
}{\TouchTopLeft}
176 \opt{IAUDIO_M3_PAD,PBELL_VIBE500_PAD
}{\ButtonRec}
177 \opt{MPIO_HD200_PAD
}{\ButtonRec +
\ButtonPlay}
178 \opt{MPIO_HD300_PAD
}{Long
\ButtonMenu}
179 \opt{HAVEREMOTEKEYMAP
}{&
180 \opt{IAUDIO_M3_PAD
}{\ButtonRCRec}
181 \opt{IRIVER_RC_H100_PAD
}{\ButtonRCStop}
190 \item[Return
] Return to the file being viewed.
191 \item[Viewer Options
] Change settings for the current file.
193 \item[Encoding
] Set the codepage in the text viewer.
194 % ToDo: wrap some of the following settings into a \opt{lcd_bitmap} to exlude
195 % ones that don't work on charcell - as soon as the plugin itself does
197 \setting{ISO-
8859-
1} (Latin
1).
198 \setting{ISO-
8859-
7} (Greek),
200 \setting{ISO-
8859-
8} (Hebrew),
202 \setting{CP1251
} (Cyrillic),
204 \setting{ISO-
8859-
11} (Thai),
205 \setting{CP1256
} (Arabic),
207 \setting{ISO-
8859-
9} (Turkish),
208 \setting{ISO-
8859-
2} (Latin Extended),
209 \setting{CP1250
} (Central European),
211 \setting{SJIS
} (Japanese),
212 \setting{GB-
2312} (Simple Chinese),
213 \setting{KSX-
1001} (Korean),
214 \setting{BIG5
} (Traditional Chinese),
216 \setting{UTF-
8} (Unicode),
217 This setting only applies to the plugin and is independent from the
218 \setting{Default Codepage
} setting (see
\reference{ref:Defaultcodepage
}).
219 \item[Word Wrap
] Toggle word wrap mode.
221 \item[On
] Break lines at the maximum column limit.
222 \item[Off (Chop Words)
] Break lines at white space or hyphen.
224 \item[Line Mode
] Change how lines are displayed.
226 \item[Normal
] Break lines at newline characters.
227 \item[Join
] Join lines together.
228 \item[Expand
] Add a blank line at newlines. Useful for making paragraphs
229 clearer in some book style text files.
231 \item[Reflow Lines
] Justify the text.
234 \item[Screens Per Page
] Set the number of screens per page. Available
235 options are
\setting{1} to
\setting{5} screens per page.
236 \item[Alignment
] Set the text alignment.
238 \item[Right
] Set the text alignment to the right.
239 (Useful for displaying right-to-left languages, such as Arabic or Hebrew)
240 \item[Left
] Set the text alignment to the left.
243 \item[Show Header
] Select whether to show the header. The header displays the file path.
245 \item[No
] Do not display the header.
246 \item[Yes
] Display the header.
248 \item[Show Footer
] Select whether to show the footer. The footer dispays the page number.
250 \item[No
] Do not display the footer.
251 \item[Yes
] Display the footer.
254 \item[Font
] Select the font to be used by the Text Viewer.
255 \item[Show Statusbar
] Select whether to show the status bar. If you select
256 a theme settings that the status bar does not display (see
257 \reference{ref:configure_rockbox_themes
}), the status bar is not
258 displayed even if you select
\setting{Yes
}.
260 \item[No
] Do not display the status bar.
261 \item[Yes
] Display the status bar.
264 \item[Scroll Settings
] The scrolling settings submenu.
266 \item[Horizontal
] Submenu for horizontal scrolling settings.
268 \item[Scrollbar
] Toggle the horizontal scrollbar for the
269 current mode. If the file fits on one screen, there is no
270 scrollbar and this setting has no effect.
272 \item[No
] Do not display the horizontal scroll bar.
273 \item[Yes
] Display the horizontal scroll bar.
275 \item[Scroll Mode
] Change the function of the ``Left'' and
278 \item[Scroll by Screen
] Move to the previous/next
280 \item[Scroll by Column
] Move to the previous/next
284 \item[Vertical
] Submenu for vertical scrolling settings.
286 \item[Scrollbar
] Toggle the vertical scrollbar for the
287 current mode. If the file fits on one screen, there is no
288 scrollbar and this setting has no effect.
290 \item[No
] Do not display the vertical scroll bar.
291 \item[Yes
] Display the vertical scroll bar.
293 \item[Scroll Mode
] Change the function of the ``Scroll-up''
294 and ``Scroll-down'' buttons.
296 \item[Scroll by Page
] Scroll up or down one full screen.
297 \item[Scroll by Line
] Scroll up or down one line.
300 \item[Overlap Pages
] Set whether the last line from the
301 previous screen is retained when scrolling pages.
303 \item[No
] Do not retain previous line.
304 \item[Yes
] Retain previous line.
307 \item[Auto-scroll Speed
] Control the speed of auto-scrolling
308 in number of lines per second. Available options are
309 \setting{1} to
\setting{10} lines per second. As an example,
310 \setting{4} will scroll the text at four lines per second.
311 \item[Left/Right Key (Narrow mode)
] Change the function of
312 the ``Left'' and ``Right'' buttons when the screen is in
313 narrow mode (i.e. one screen per page).
315 \item[Previous/Next Page
] Scroll up or down one full screen.
316 \item[Top/Bottom Page
] Move to the top or bottom page.
320 \item[Indent Spaces
] Set the number of spaces to indent the text when line
321 mode is set to
\setting{Reflow Lines
}. Available options are
\setting{0}
322 to
\setting{5} spaces. If you select
\setting{0}, a blank line is
323 displayed as an indent.
326 \item[Show Playback Menu
] Display the playback menu to allow control of the
327 currently playing music without leaving the plugin.
329 \item[Select Bookmark
] Select a saved bookmark. In the screenshot below, the
330 ``*'' denotes the current page.
332 \screenshot{plugins/images/ss-text_viewer-sel_bk_menu
}{The select bookmark menu
}{img:text_viewer-sel_bk
}
334 \item[Global Settings
] Set the default settings for the text viewer.
335 The setting items are the same as
\setting{Viewer Options
}. The global
336 settings are stored in
337 \fname{.rockbox/rocks/viewers/viewer.dat
}.
339 \item[Quit
] Exits the plugin. The text viewer automatically
340 stores its settings, the current position and bookmarks in
341 \fname{.rockbox/rocks/viewers/viewer
\_file.dat
}.
344 \subsubsection{Bookmarks
}
345 To add a bookmark, press
346 \opt{PLAYER_PAD
}{\ButtonOn}\opt{RECORDER_PAD
}{\ButtonFTwo}%
347 \opt{ONDIO_PAD
}{\ButtonMenu+
\ButtonOff}%
348 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD
}{\ButtonOn+
\ButtonSelect}%
349 \opt{IPOD_4G_PAD,IPOD_3G_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD
}{\ButtonSelect}%
350 \opt{IRIVER_H10_PAD
}{\ButtonFF}\opt{IAUDIO_X5_PAD
}{\ButtonRec}%
351 \opt{SANSA_E200_PAD,SANSA_C200_PAD,SANSA_CLIP_PAD
}{\ButtonDown+
\ButtonSelect}%
352 \opt{COWON_D2_PAD
}{\ButtonMenu+
\ButtonPlus}%
353 \opt{SANSA_FUZE_PAD
}{\ButtonUp+
\ButtonSelect}%
354 \opt{IAUDIO_M3_PAD
}{\ButtonRCPlay+
\ButtonRCMode}.
355 \opt{MPIO_HD200_PAD
}{FIXME
}
356 The bookmark will be displayed as shown below. To delete the bookmark
357 press the same button again.
359 \screenshot{plugins/images/ss-text_viewer-bookmark
}{A bookmark
}{img:text_viewer-bookmark
}