manual/plugins/clock.tex

   1 \subsection{Clock}
   2 \screenshot{plugins/images/ss-clock}{Clock}{img:clock}
   3
   4 This is a fully featured analogue and digital clock plugin.
   5
   6 \subsubsection{Key configuration}
   7
   8 \begin{table}
   9 \begin{btnmap}{}{}
  10     \opt{RECORDER_PAD,IAUDIO_X5_PAD,IRIVER_H300_PAD,IPOD_4G_PAD,IPOD_3G_PAD%
  11         ,GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD,SANSA_C200_PAD%
  12         ,SANSA_E200_PAD,IRIVER_H10_PAD,SANSA_FUZE_PAD,PBELL_VIBE500_PAD}
  13         {\ButtonLeft{} / \ButtonRight}
  14     \opt{COWON_D2_PAD}{\TouchMidRight{} / \TouchMidLeft}
  15        \opt{HAVEREMOTEKEYMAP}{& }
  16     & Cycle through modes \\
  17     \opt{RECORDER_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD%
  18         ,MROBE100_PAD,PBELL_VIBE500_PAD}{\ButtonUp{} / \ButtonDown}
  19     \opt{IPOD_3G_PAD,IPOD_4G_PAD,SANSA_E200_PAD,SANSA_FUZE_PAD}
  20       {\ButtonScrollFwd{} / \ButtonScrollBack}
  21     \opt{SANSA_C200_PAD}{\ButtonVolUp{} / \ButtonVolDown}
  22     \opt{IRIVER_H10_PAD}{\ButtonScrollUp{} / \ButtonScrollDown}
  23     \opt{COWON_D2_PAD}{\ButtonMinus{} / \ButtonPlus}
  24        \opt{HAVEREMOTEKEYMAP}{& }
  25     & Cycle through skins \\
  26     \opt{RECORDER_PAD}{\ButtonFOne}
  27     \opt{IAUDIO_X5_PAD}{\ButtonRec}
  28     \opt{IRIVER_H300_PAD}{\ButtonMode}
  29     \opt{IPOD_4G_PAD,IPOD_3G_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD,PBELL_VIBE500_PAD}
  30       {\ButtonMenu}
  31     \opt{SANSA_C200_PAD,SANSA_E200_PAD,SANSA_FUZE_PAD}{\ButtonDown}
  32     \opt{IRIVER_H10_PAD}{\ButtonFF}
  33     \opt{COWON_D2_PAD}{\ButtonMenu{} or \TouchTopLeft}
  34        \opt{HAVEREMOTEKEYMAP}{& }
  35     & Main Menu \\
  36     \opt{RECORDER_PAD}{\ButtonPlay}
  37     \opt{IRIVER_H10_PAD}{\ButtonRew}
  38     \opt{IRIVER_H300_PAD,IAUDIO_X5_PAD,IPOD_4G_PAD,IPOD_3G_PAD,SANSA_C200_PAD%
  39       ,SANSA_E200_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD%
  40       ,SANSA_FUZE_PAD}
  41       {\ButtonSelect}
  42     \opt{COWON_D2_PAD}{\ButtonPlus{} or \TouchBottomMiddle}
  43     \opt{PBELL_VIBE500_PAD}{\ButtonOK}
  44        \opt{HAVEREMOTEKEYMAP}{& }
  45     & Start / Stop Counter \\
  46     \opt{RECORDER_PAD_PAD}{Long \ButtonPlay}%
  47     \opt{IRIVER_H10_PAD}{Long \ButtonRew}%
  48     \opt{IRIVER_H300_PAD,IAUDIO_X5_PAD,IPOD_4G_PAD,IPOD_3G_PAD,SANSA_C200_PAD%
  49       ,SANSA_E200_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD,SANSA_FUZE_PAD}
  50       {Long \ButtonSelect}
  51     \opt{COWON_D2_PAD}{\ButtonPlus{} or long \TouchBottomMiddle}
  52     \opt{PBELL_VIBE500_PAD}{Long \ButtonOK}
  53        \opt{HAVEREMOTEKEYMAP}{& }
  54     & Reset Counter \\
  55     \opt{RECORDER_PAD,IRIVER_H300_PAD}{\ButtonOff}
  56     \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonMenu + \ButtonSelect}
  57     \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD,SANSA_C200_PAD,GIGABEAT_PAD%
  58         ,MROBE100_PAD}{\ButtonPower}
  59     \opt{SANSA_FUZE_PAD}{Long \ButtonHome}
  60     \opt{GIGABEAT_S_PAD}{\ButtonBack}
  61     \opt{COWON_D2_PAD}{\ButtonPower{} or \TouchBottomRight}
  62     \opt{PBELL_VIBE500_PAD}{\ButtonRec}
  63        \opt{HAVEREMOTEKEYMAP}{& }
  64     & Save Settings (if enabled) and Exit \\
  65 \end{btnmap}
  66 \end{table}
  67
  68 \textbf{Clock Menu}
  69 \begin{description}
  70 \item[View Clock] Exits the menu and returns to the current clock mode display.
  71 \item[Mode Selector] Opens a menu from which you can select a clock mode to view.
  72 \item[Counter Settings] Opens a menu from which you can adjust settings
  73     pertaining to the counter.
  74 \item[Mode Settings] Opens a menu from which you can adjust settings pertaining to
  75     the current clock mode (analog, digital, binary).
  76 \item[General Settings]
  77     \begin{description}
  78     \item[Reset Settings]
  79     Reset all settings to their default values.
  80     \item[Save Settings]
  81     Save all settings to disk.
  82     \item[Show Counter]
  83     Toggle Counter display.
  84     \item[Save]
  85     Choose whether to disable automatic saving, saving to disk on exit, or
  86     saving to disk every settings change.
  87     \item[Backlight]
  88     Choose whether to disable the backlight, use the user's timeout setting,
  89     or keep the backlight on.
  90     \item[Idle Poweroff]
  91     Toggle Idle Poweroff.
  92     \note{This setting is not saved to disk.}
  93     \end{description}
  94 \item[Help] Opens a brief help screen with key mappings and functionality.
  95 \item[Credits] Displays a credits roll.
  96 \end{description}
  97
  98 \subsubsection{Analog mode}
  99 Small, round, analog clock is displayed in the middle of the LCD.
 100 Time readout, if enabled, is displayed at the upper left.
 101 If Time readout is in 12-hour (``12h'') mode, AM or PM will be displayed at the
 102 upper right.  The Date readout, if enabled, is displayed at the lower left.
 103 The Counter, if enabled, is displayed at the lower right.
 104 The second hand, if enabled, is displayed along with the hour and minute hands.
 105 Digit display, if enabled, places ``12'', ``3'', ``6'', and ``9'' around the
 106 face of the clock in their respective positions.
 107
 108 \subsubsection{Digital mode}
 109 An imitation of an LCD, this mode shows a Clock comprised of digital ``segments''.
 110 The Date readout, if enabled, is displayed at the bottom, center.
 111 The Second readout, if in ``Text'' mode, is displayed at the top, center; if in
 112 ``Bar'' mode, is displayed as a progress bar at the top of the LCD; if in
 113 ``Invert'' mode, will invert the LCD left-to-right as the seconds pass (a
 114 fully-inverted LCD means the entire minute has passed).
 115 The Counter, if displayed, is shown at the upper left.
 116 The Blinking Colon, if enabled, blinks the colon once every second.
 117 12-hour mode, if enabled, will display the time in a 12-hour format.
 118
 119 \subsubsection{LCD mode}
 120 Based on the Digital Mode, the LCD mode is another imitation of an LCD.
 121 The settings available in this mode are exactly the same as Digital Mode, but
 122 they are independent of Digital Mode. For example, you can have the Date
 123 Readout enabled in Digital Mode and disabled in LCD Mode.
 124
 125 \subsubsection{Fullscreen}
 126 A Fullscreen clock is displayed. Show Border, if enabled, will draw a small
 127 box at every hour position (1 to 12 inclusive).
 128 Invert Seconds, if enabled, will invert the LCD as the seconds pass.
 129 Second Hand, if enabled, will draw a second hand among the hour and minute hands.
 130
 131 \subsubsection{Binary mode}
 132 This mode shows a Binary clock.
 133 The hour is displayed on the top line, the minute is displayed on the middle
 134 line, and the seconds are on the last line.
 135 Circle mode, if enabled, draws empty and full circles, instead of zeros and ones.
 136 For help on reading binary, please visit:
 137 \url{http://en.wikipedia.org/wiki/Binary_numeral_system}
 138
 139 \subsubsection{Plain mode}
 140 This mode shows a ``plain'' clock in large text that takes up nearly the whole LCD.