apps/gui/skin_engine/wps_internals.h

   1 /***************************************************************************
   2  *             __________               __   ___.
   3  *   Open      \______   \ ____   ____ |  | _\_ |__   _______  ___
   4  *   Source     |       _//  _ \_/ ___\|  |/ /| __ \ /  _ \  \/  /
   5  *   Jukebox    |    |   (  <_> )  \___|    < | \_\ (  <_> > <  <
   6  *   Firmware   |____|_  /\____/ \___  >__|_ \|___  /\____/__/\_ \
   7  *                     \/            \/     \/    \/            \/
   8  * $Id$
   9  *
  10  * Copyright (C) 2007 Nicolas Pennequin
  11  *
  12  * This program is free software; you can redistribute it and/or
  13  * modify it under the terms of the GNU General Public License
  14  * as published by the Free Software Foundation; either version 2
  15  * of the License, or (at your option) any later version.
  16  *
  17  * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
  18  * KIND, either express or implied.
  19  *
  20  ****************************************************************************/
  21
  22  /* This stuff is for the wps engine only.. anyone caught using this outside
  23   * of apps/gui/wps_engine will be shot on site! */
  24
  25 #ifndef _WPS_ENGINE_INTERNALS_
  26 #define _WPS_ENGINE_INTERNALS_
  27
  28
  29 /* Timeout unit expressed in HZ. In WPS, all timeouts are given in seconds
  30    (possibly with a decimal fraction) but stored as integer values.
  31    E.g. 2.5 is stored as 25. This means 25 tenth of a second, i.e. 25 units.
  32 */
  33 #define TIMEOUT_UNIT (HZ/10) /* I.e. 0.1 sec */
  34 #define DEFAULT_SUBLINE_TIME_MULTIPLIER 20 /* In TIMEOUT_UNIT's */
  35
  36 #include "skin_tokens.h"
  37 #include "tag_table.h"
  38 #include "skin_parser.h"
  39
  40
  41 /* TODO: sort this mess out */
  42
  43 #include "screen_access.h"
  44 #include "statusbar.h"
  45 #include "metadata.h"
  46
  47 /* alignments */
  48 #define WPS_ALIGN_RIGHT 32
  49 #define WPS_ALIGN_CENTER 64
  50 #define WPS_ALIGN_LEFT 128
  51
  52
  53 #define TOKEN_VALUE_ONLY 0x0DEADC0D
  54
  55 #ifdef HAVE_ALBUMART
  56
  57 /* albumart definitions */
  58 #define WPS_ALBUMART_NONE           0      /* WPS does not contain AA tag */
  59 #define WPS_ALBUMART_CHECK          1      /* WPS contains AA conditional tag */
  60 #define WPS_ALBUMART_LOAD           2      /* WPS contains AA tag */
  61
  62 #define WPS_ALBUMART_ALIGN_RIGHT    1    /* x align:   right */
  63 #define WPS_ALBUMART_ALIGN_CENTER   2    /* x/y align: center */
  64 #define WPS_ALBUMART_ALIGN_LEFT     4    /* x align:   left */
  65 #define WPS_ALBUMART_ALIGN_TOP      1    /* y align:   top */
  66 #define WPS_ALBUMART_ALIGN_BOTTOM   4    /* y align:   bottom */
  67
  68 #endif /* HAVE_ALBUMART */
  69
  70 /* wps_data*/
  71
  72 #ifdef HAVE_LCD_BITMAP
  73 struct gui_img {
  74     struct viewport* vp;    /* The viewport to display this image in */
  75     short int x;                  /* x-pos */
  76     short int y;                  /* y-pos */
  77     short int num_subimages;      /* number of sub-images */
  78     short int subimage_height;    /* height of each sub-image */
  79     struct bitmap bm;
  80     const char *label;
  81     bool loaded;            /* load state */
  82     bool always_display;    /* not using the preload/display mechanism */
  83     int display;
  84     bool using_preloaded_icons; /* using the icon system instead of a bmp */
  85 };
  86
  87 struct image_display {
  88     const char *label;
  89     int subimage;
  90     struct wps_token *token; /* the token to get the subimage number from */
  91     int offset; /* offset into the bitmap strip to start */
  92 };
  93
  94 struct progressbar {
  95     enum skin_token_type type;
  96     struct viewport *vp;
  97     /* regular pb */
  98     short x;
  99     /* >=0: explicitly set in the tag -> y-coord within the viewport
 100        <0 : not set in the tag -> negated 1-based line number within
 101             the viewport. y-coord will be computed based on the font height */
 102     short y;
 103     short width;
 104     short height;
 105     bool  follow_lang_direction;
 106
 107     struct gui_img *image;
 108
 109     bool invert_fill_direction;
 110     bool nofill;
 111     bool nobar;
 112     struct gui_img *slider;
 113     bool horizontal;
 114     struct gui_img *backdrop;
 115 };
 116 #endif
 117
 118
 119
 120 struct align_pos {
 121     char* left;
 122     char* center;
 123     char* right;
 124 };
 125
 126 #ifdef HAVE_LCD_BITMAP
 127
 128 #define MAX_IMAGES (26*2) /* a-z and A-Z */
 129 #define MAX_PROGRESSBARS 3
 130
 131 /* The image buffer is big enough to store one full-screen native bitmap,
 132    plus two full-screen mono bitmaps. */
 133
 134 #define WPS_MAX_VIEWPORTS   24
 135 #define WPS_MAX_LINES       ((LCD_HEIGHT/5+1) * 2)
 136 #define WPS_MAX_SUBLINES    (WPS_MAX_LINES*3)
 137 #define WPS_MAX_TOKENS      1024
 138 #define WPS_MAX_STRINGS     128
 139 #define STRING_BUFFER_SIZE  1024
 140 #define WPS_MAX_COND_LEVEL  10
 141
 142 #else
 143
 144 #define WPS_MAX_VIEWPORTS   2
 145 #define WPS_MAX_LINES       2
 146 #define WPS_MAX_SUBLINES    12
 147 #define WPS_MAX_TOKENS      64
 148 #define WPS_MAX_STRINGS     32
 149 #define STRING_BUFFER_SIZE  64
 150 #define WPS_MAX_COND_LEVEL  5
 151
 152 #endif
 153
 154 #define SUBLINE_RESET -1
 155
 156 enum wps_parse_error {
 157     PARSE_OK,
 158     PARSE_FAIL_UNCLOSED_COND,
 159     PARSE_FAIL_INVALID_CHAR,
 160     PARSE_FAIL_COND_SYNTAX_ERROR,
 161     PARSE_FAIL_COND_INVALID_PARAM,
 162     PARSE_FAIL_LIMITS_EXCEEDED,
 163 };
 164
 165 #define VP_DRAW_HIDEABLE    0x1
 166 #define VP_DRAW_HIDDEN      0x2
 167 #define VP_DRAW_WASHIDDEN   0x4
 168 /* these are never drawn, nor cleared, i.e. just ignored */
 169 #define VP_NEVER_VISIBLE    0x8
 170 #define VP_DEFAULT_LABEL    "|"
 171 struct skin_viewport {
 172     struct viewport vp;   /* The LCD viewport struct */
 173     char hidden_flags;
 174     bool is_infovp;
 175     char* label;
 176     unsigned start_fgcolour;
 177     unsigned start_bgcolour;
 178 };
 179 struct viewport_colour {
 180     struct viewport *vp;
 181     unsigned colour;
 182 };
 183 #ifdef HAVE_TOUCHSCREEN
 184 struct touchregion {
 185     struct skin_viewport* wvp;/* The viewport this region is in */
 186     short int x;             /* x-pos */
 187     short int y;             /* y-pos */
 188     short int width;         /* width */
 189     short int height;        /* height */
 190     enum {
 191         WPS_TOUCHREGION_ACTION,
 192         WPS_TOUCHREGION_SCROLLBAR,
 193         WPS_TOUCHREGION_VOLUME
 194     } type;                  /* type of touch region */
 195     bool reverse_bar;        /* if true 0% is the left or top */
 196     bool repeat;             /* requires the area be held for the action */
 197     int action;              /* action this button will return */
 198     bool armed;              /* A region is armed on press. Only armed regions are triggered
 199                                 on repeat or release. */
 200     union {                  /* Extra data, action dependant */
 201         void* data;
 202         int   value;
 203     };
 204 };
 205 #endif
 206
 207 struct playlistviewer {
 208     struct viewport *vp;
 209     bool show_icons;
 210     int start_offset;
 211     struct skin_element *line;
 212 };
 213
 214
 215 #ifdef HAVE_ALBUMART
 216 struct skin_albumart {
 217     /* Album art support */
 218     int x;
 219     int y;
 220     int width;
 221     int height;
 222
 223     unsigned char xalign; /* WPS_ALBUMART_ALIGN_LEFT, _CENTER, _RIGHT */
 224     unsigned char yalign; /* WPS_ALBUMART_ALIGN_TOP, _CENTER, _BOTTOM */
 225     unsigned char state; /* WPS_ALBUMART_NONE, _CHECK, _LOAD */
 226
 227     struct viewport *vp;
 228     int draw_handle;
 229 };
 230 #endif
 231
 232
 233 struct line {
 234     unsigned update_mode;
 235 };
 236
 237 struct line_alternator {
 238     int current_line;
 239     unsigned long next_change_tick;
 240 };
 241
 242 struct conditional {
 243     int last_value;
 244     struct wps_token *token;
 245 };
 246
 247 struct logical_if {
 248     struct wps_token *token;
 249     enum {
 250         IF_EQUALS, /* == */
 251         IF_NOTEQUALS, /* != */
 252         IF_LESSTHAN, /* < */
 253         IF_LESSTHAN_EQ, /* <= */
 254         IF_GREATERTHAN, /* > */
 255         IF_GREATERTHAN_EQ /* >= */
 256     } op;
 257     struct skin_tag_parameter operand;
 258     int num_options;
 259 };
 260
 261 /* wps_data
 262    this struct holds all necessary data which describes the
 263    viewable content of a wps */
 264 struct wps_data
 265 {
 266     struct skin_element *tree;
 267 #ifdef HAVE_LCD_BITMAP
 268     struct skin_token_list *images;
 269 #endif
 270 #if LCD_DEPTH > 1 || defined(HAVE_REMOTE_LCD) && LCD_REMOTE_DEPTH > 1
 271     struct {
 272         char *backdrop;
 273         int backdrop_id;
 274     };
 275 #endif
 276
 277 #ifdef HAVE_TOUCHSCREEN
 278     struct skin_token_list *touchregions;
 279 #endif
 280 #ifdef HAVE_ALBUMART
 281     struct skin_albumart *albumart;
 282     int    playback_aa_slot;
 283 #endif
 284
 285 #ifdef HAVE_LCD_BITMAP
 286     bool peak_meter_enabled;
 287     bool wps_sb_tag;
 288     bool show_sb_on_wps;
 289 #else /*HAVE_LCD_CHARCELLS */
 290     unsigned short wps_progress_pat[8];
 291     bool full_line_progressbar;
 292 #endif
 293     bool wps_loaded;
 294 };
 295
 296 /* wps_data end */
 297
 298 /* wps_state
 299    holds the data which belongs to the current played track,
 300    the track which will be played afterwards, current path to the track
 301    and some status infos */
 302 struct wps_state
 303 {
 304     struct mp3entry* id3;
 305     struct mp3entry* nid3;
 306     int  ff_rewind_count;
 307     bool ff_rewind;
 308     bool paused;
 309     bool is_fading;
 310 };
 311
 312 /* change the ff/rew-status
 313    if ff_rew = true then we are in skipping mode
 314    else we are in normal mode */
 315 /* void wps_state_update_ff_rew(bool ff_rew); Currently unused */
 316
 317 /* change the tag-information of the current played track
 318    and the following track */
 319 /* void wps_state_update_id3_nid3(struct mp3entry *id3, struct mp3entry *nid3); Currently unused */
 320 /* wps_state end*/
 321
 322 /* gui_wps
 323    defines a wps with its data, state,
 324    and the screen on which the wps-content should be drawn */
 325 struct gui_wps
 326 {
 327     struct screen *display;
 328     struct wps_data *data;
 329 };
 330
 331 /* gui_wps end */
 332
 333 char *get_image_filename(const char *start, const char* bmpdir,
 334                                 char *buf, int buf_size);
 335 /***** wps_tokens.c ******/
 336
 337 const char *get_token_value(struct gui_wps *gwps,
 338                            struct wps_token *token, int offset,
 339                            char *buf, int buf_size,
 340                            int *intval);
 341
 342 /* Get the id3 fields from the cuesheet */
 343 const char *get_cuesheetid3_token(struct wps_token *token, struct mp3entry *id3,
 344                                   int offset_tracks, char *buf, int buf_size);
 345 const char *get_id3_token(struct wps_token *token, struct mp3entry *id3,
 346                           char *filename, char *buf, int buf_size, int limit, int *intval);
 347 #if CONFIG_TUNER
 348 const char *get_radio_token(struct wps_token *token, int preset_offset,
 349                             char *buf, int buf_size, int limit, int *intval);
 350 #endif
 351
 352 struct gui_img* find_image(const char *label, struct wps_data *data);
 353 struct skin_viewport* find_viewport(const char *label, bool uivp, struct wps_data *data);
 354
 355
 356 #ifdef SIMULATOR
 357 #define DEBUG_SKIN_ENGINE
 358 extern bool debug_wps;
 359 #endif
 360
 361 #endif