summaryrefslogtreecommitdiffstats
path: root/manual/plugins/text_viewer.tex
blob: 1836b45c2ba8728a730907a2f8513e1e53d107ce (plain)
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
\subsection{Text Viewer}
This is a Viewer for text files with word wrap. Just open a .txt file to
display it. The text viewer features controls to handle various styles of text
formatting, has top{}-of{}-file and bottom{}-of{}-file buttons. You can view
files without a \fname{.txt} extension by using \emph{Open with} from the
\emph{Context Menu} (see \reference{ref:Contextmenu}).


\begin{table}
    \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}{\ButtonVolUp}
    \opt{GIGABEAT_S_PAD}{\ButtonPrev}
    \opt{COWON_D2_PAD}{\TouchTopMiddle}
  \opt{HAVEREMOTEKEYMAP}{& }
        & 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}{\ButtonVolDown}
    \opt{GIGABEAT_S_PAD}{\ButtonNext}
    \opt{COWON_D2_PAD}{\TouchBottomMiddle}
  \opt{HAVEREMOTEKEYMAP}{& }
        & 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}{\ButtonLeft}
  \opt{HAVEREMOTEKEYMAP}{& }
        & 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}{\ButtonRight}
  \opt{HAVEREMOTEKEYMAP}{& }
        & 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,GIGABEAT_S_PAD}{%
        \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn+\ButtonUp}
        \opt{SANSA_E200_PAD,SANSA_FUZE_PAD}{\ButtonScrollBack}
        \opt{SANSA_C200_PAD}{\ButtonUp}
        \opt{GIGABEAT_S_PAD}{\ButtonUp}
  \opt{HAVEREMOTEKEYMAP}{& }
        & One line up\\
    }

    \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,SANSA_E200_PAD%
      ,SANSA_FUZE_PAD,SANSA_C200_PAD,GIGABEAT_S_PAD}{%
        \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn+\ButtonDown}
        \opt{SANSA_E200_PAD,SANSA_FUZE_PAD}{\ButtonScrollFwd}
        \opt{SANSA_C200_PAD}{\ButtonDown}
        \opt{GIGABEAT_S_PAD}{\ButtonDown}
  \opt{HAVEREMOTEKEYMAP}{& }
        & One line down\\
    }

    \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,GIGABEAT_S_PAD}{
        \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn+\ButtonLeft}
        \opt{GIGABEAT_S_PAD}{\ButtonLeft}
  \opt{HAVEREMOTEKEYMAP}{& }
        & One column left\\
    }

    \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,GIGABEAT_S_PAD}{
        \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn+\ButtonRight}
        \opt{GIGABEAT_S_PAD}{\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}{\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_FUZE_PAD}{\ButtonSelect+\ButtonDown}
    \opt{MROBE100_PAD}{\ButtonDisplay}
    \opt{COWON_D2_PAD}{\TouchCenter}
  \opt{HAVEREMOTEKEYMAP}{& }
        & Toggle autoscroll\\

    \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,COWOND_D2_PAD}{\ButtonMenu}
    \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonMode}
    \opt{IAUDIO_X5_PAD,SANSA_C200_PAD,SANSA_E200_PAD}{\ButtonSelect}
    \opt{SANSA_FUZE_PAD}{Long \ButtonSelect}
    \opt{IRIVER_H10_PAD}{\ButtonRew}
  \opt{HAVEREMOTEKEYMAP}{& }
        & 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}{\ButtonMenu}
    \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD,SANSA_C200_PAD,GIGABEAT_PAD%
        ,MROBE100_PAD,COWON_D2_PAD}{\ButtonPower}
    \opt{SANSA_FUZE_PAD}{Long \ButtonHome}
    \opt{GIGABEAT_S_PAD}{\ButtonBack}
  \opt{HAVEREMOTEKEYMAP}{&
          \opt{IRIVER_RC_H100_PAD}{\ButtonRCStop}
  }
        & Exit text viewer\\

    \end{btnmap}
\end{table}

\subsubsection{The Viewer's Menu}

\begin{description}
\item[Quit] Exits the plugin.
\item[Viewer Options]
    \begin{description}
    \item[Encoding]
    sets 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{UTF-8} (Unicode),
    \setting{BIG5} (Traditional Chinese),
    \setting{KSX-1001} (Korean),
    \setting{GB-2312} (Simple Chinese),
    \setting{SJIS} (Japanese),
    \setting{CP1250} (Central European),
    \setting{ISO-8859-2} (Latin Extended),
    \setting{ISO-8859-9} (Turkish),
    \setting{ISO-8859-6} (Arabic),
    \setting{ISO-8859-11} (Thai),
    \setting{CP1251} (Cyrillic),
    \setting{ISO-8859-8} (Hebrew),
    \setting{ISO-8859-7} (Greek),
    \setting{ISO-8859-1} (Latin 1).
    This setting only applies to the plugin and is independent from the
    \setting{Default Codepage} setting (see \reference{ref:Defaultcodepage}).
    \item[Word Wrap] toggles between Wrap and Chop.
        \begin{description}
            \item[Off (Chop Words)] breaks lines at white space or hyphen.
            \item[On] breaks lines at the maximum column limit.
        \end{description}
    \item[Line Mode] cycles through Normal, Join and Expand and Reflow Lines.
        \begin{description}
            \opt{lcd_bitmap}{
            \item[Reflow Lines] justifies the text fully.
            }
            \item[Expand] adds a blank line. Useful for making the paragraphs
            clearer in some book style text files.
            \item[Join] joins lines. Useful for adopting the orphans that
            occur with e{}-mail style (i.e. pre{}-wrapped) text files.
            \item[Normal] breaks lines at newline characters.
        \end{description}
    \item[Wide View] toggles between Narrow and Wide.
        \begin{description}
            \item[Yes] sets maximum column to 114. Useful for navigating large files.
            (Currently, Wide and Join cannot be selected together.)
            \item[No (Narrow)] sets maximum column to the screen width.
        \end{description}
    \opt{lcd_bitmap}{
    \item[Show Scrollbar] toggles scrollbar for the current View mode. If the
    file fits on one screen, there is no scrollbar and toggling this setting
    has no effect.
        \begin{description}
            \item[On] has a scrollbar by default, until toggled.
            \item[Off] has no scrollbar by default, until toggled.
        \end{description}
    \item[Overlap Pages] toggles between Normal and Overlap.
        \begin{description}
            \item[Yes] tells page{}-down/page{}-up to retain one line from previous screen.
            \item[No] sets page{}-down/page{}-up to one full screen.
        \end{description}
    }
    \item[Scroll Mode] controls the function of the ``Scroll-up'' and
    ``Scroll-down'' buttons.
        \begin{description}
            \item[Scroll by Line]
            \item[Scroll by Page]
        \end{description}
    \item[Auto-scroll Speed]
    controls the speed of auto-scrolling in number of lines per scroll step,
    available options are \setting{1} to \setting{10} lines. As an example,
    a setting of \setting{4} will scroll up the text four lines per second.
    \end{description}

\item[Show Playback Menu] controls the playback of the currently loaded playlist
and change the volume of your \dap{} without leaving the plugin.
\item[Return] to the text view.
\end{description}

\note{The text viewer automatically saves its settings and also stores the
current position in the viewed text files (up to the last 46 files).}

\subsubsection{Compatibility}

\begin{itemize}
\item Currently messages are in English
\item Does not currently support right{}-to{}-left languages.
\end{itemize}