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