apps/plugins/starfield.c

   1 /***************************************************************************
   2 *             __________               __   ___.
   3 *   Open      \______   \ ____   ____ |  | _\_ |__   _______  ___
   4 *   Source     |       _//  _ \_/ ___\|  |/ /| __ \ /  _ \  \/  /
   5 *   Jukebox    |    |   (  <_> )  \___|    < | \_\ (  <_> > <  <
   6 *   Firmware   |____|_  /\____/ \___  >__|_ \|___  /\____/__/\_ \
   7 *                     \/            \/     \/    \/            \/
   8 * Copyright (C) 2005 Kevin Ferrare
   9 *
  10 * This program is free software; you can redistribute it and/or
  11 * modify it under the terms of the GNU General Public License
  12 * as published by the Free Software Foundation; either version 2
  13 * of the License, or (at your option) any later version.
  14 *
  15 * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
  16 * KIND, either express or implied.
  17 *
  18 ****************************************************************************/
  19
  20 #include "plugin.h"
  21 #include "lib/helper.h"
  22
  23 #ifdef HAVE_LCD_BITMAP /* and also not for the Player */
  24
  25 PLUGIN_HEADER
  26
  27 /******************************* Globals ***********************************/
  28
  29 /* Key assignement */
  30 #if (CONFIG_KEYPAD == IPOD_4G_PAD) || \
  31     (CONFIG_KEYPAD == IPOD_3G_PAD) || \
  32     (CONFIG_KEYPAD == IPOD_1G2G_PAD)
  33 #define STARFIELD_QUIT BUTTON_MENU
  34 #define STARFIELD_INCREASE_ZMOVE BUTTON_SCROLL_FWD
  35 #define STARFIELD_DECREASE_ZMOVE BUTTON_SCROLL_BACK
  36 #define STARFIELD_INCREASE_NB_STARS BUTTON_RIGHT
  37 #define STARFIELD_DECREASE_NB_STARS BUTTON_LEFT
  38 #define STARFIELD_TOGGLE_COLOR BUTTON_PLAY
  39
  40 #elif (CONFIG_KEYPAD == IAUDIO_X5M5_PAD)
  41 #define STARFIELD_QUIT BUTTON_POWER
  42 #define STARFIELD_INCREASE_ZMOVE BUTTON_UP
  43 #define STARFIELD_DECREASE_ZMOVE BUTTON_DOWN
  44 #define STARFIELD_INCREASE_NB_STARS BUTTON_RIGHT
  45 #define STARFIELD_DECREASE_NB_STARS BUTTON_LEFT
  46 #define STARFIELD_TOGGLE_COLOR BUTTON_PLAY
  47
  48 #elif (CONFIG_KEYPAD == IRIVER_H10_PAD)
  49 #define STARFIELD_QUIT BUTTON_POWER
  50 #define STARFIELD_INCREASE_ZMOVE BUTTON_SCROLL_UP
  51 #define STARFIELD_DECREASE_ZMOVE BUTTON_SCROLL_DOWN
  52 #define STARFIELD_INCREASE_NB_STARS BUTTON_RIGHT
  53 #define STARFIELD_DECREASE_NB_STARS BUTTON_LEFT
  54 #define STARFIELD_TOGGLE_COLOR BUTTON_PLAY
  55
  56 #elif (CONFIG_KEYPAD == GIGABEAT_PAD)
  57 #define STARFIELD_QUIT BUTTON_POWER
  58 #define STARFIELD_INCREASE_ZMOVE BUTTON_UP
  59 #define STARFIELD_DECREASE_ZMOVE BUTTON_DOWN
  60 #define STARFIELD_INCREASE_NB_STARS BUTTON_RIGHT
  61 #define STARFIELD_DECREASE_NB_STARS BUTTON_LEFT
  62 #define STARFIELD_TOGGLE_COLOR BUTTON_SELECT
  63
  64 #elif (CONFIG_KEYPAD == SANSA_E200_PAD) || \
  65       (CONFIG_KEYPAD == SANSA_C200_PAD) || \
  66       (CONFIG_KEYPAD == SANSA_CLIP_PAD) || \
  67       (CONFIG_KEYPAD == SANSA_M200_PAD)
  68 #define STARFIELD_QUIT BUTTON_POWER
  69 #define STARFIELD_INCREASE_ZMOVE BUTTON_UP
  70 #define STARFIELD_DECREASE_ZMOVE BUTTON_DOWN
  71 #define STARFIELD_INCREASE_NB_STARS BUTTON_RIGHT
  72 #define STARFIELD_DECREASE_NB_STARS BUTTON_LEFT
  73 #define STARFIELD_TOGGLE_COLOR BUTTON_SELECT
  74
  75 #elif (CONFIG_KEYPAD == SANSA_FUZE_PAD)
  76 #define STARFIELD_QUIT (BUTTON_HOME|BUTTON_REPEAT)
  77 #define STARFIELD_INCREASE_ZMOVE BUTTON_UP
  78 #define STARFIELD_DECREASE_ZMOVE BUTTON_DOWN
  79 #define STARFIELD_INCREASE_NB_STARS BUTTON_RIGHT
  80 #define STARFIELD_DECREASE_NB_STARS BUTTON_LEFT
  81 #define STARFIELD_TOGGLE_COLOR BUTTON_SELECT
  82
  83 #elif (CONFIG_KEYPAD == GIGABEAT_S_PAD)
  84 #define STARFIELD_QUIT BUTTON_BACK
  85 #define STARFIELD_INCREASE_ZMOVE BUTTON_UP
  86 #define STARFIELD_DECREASE_ZMOVE BUTTON_DOWN
  87 #define STARFIELD_INCREASE_NB_STARS BUTTON_RIGHT
  88 #define STARFIELD_DECREASE_NB_STARS BUTTON_LEFT
  89 #define STARFIELD_TOGGLE_COLOR BUTTON_SELECT
  90
  91 #elif (CONFIG_KEYPAD == MROBE100_PAD)
  92 #define STARFIELD_QUIT BUTTON_POWER
  93 #define STARFIELD_INCREASE_ZMOVE BUTTON_UP
  94 #define STARFIELD_DECREASE_ZMOVE BUTTON_DOWN
  95 #define STARFIELD_INCREASE_NB_STARS BUTTON_RIGHT
  96 #define STARFIELD_DECREASE_NB_STARS BUTTON_LEFT
  97 #define STARFIELD_TOGGLE_COLOR BUTTON_SELECT
  98
  99 #elif CONFIG_KEYPAD == IAUDIO_M3_PAD
 100 #define STARFIELD_QUIT BUTTON_RC_REC
 101 #define STARFIELD_INCREASE_ZMOVE BUTTON_RC_VOL_UP
 102 #define STARFIELD_DECREASE_ZMOVE BUTTON_RC_VOL_DOWN
 103 #define STARFIELD_INCREASE_NB_STARS BUTTON_RC_FF
 104 #define STARFIELD_DECREASE_NB_STARS BUTTON_RC_REW
 105 #define STARFIELD_TOGGLE_COLOR BUTTON_RC_MODE
 106
 107 #elif CONFIG_KEYPAD == IAUDIO67_PAD
 108 #define STARFIELD_QUIT BUTTON_POWER
 109 #define STARFIELD_INCREASE_ZMOVE BUTTON_STOP
 110 #define STARFIELD_DECREASE_ZMOVE BUTTON_PLAY
 111 #define STARFIELD_INCREASE_NB_STARS BUTTON_LEFT
 112 #define STARFIELD_DECREASE_NB_STARS BUTTON_RIGHT
 113 #define STARFIELD_TOGGLE_COLOR BUTTON_MENU
 114
 115 #elif (CONFIG_KEYPAD == COWON_D2_PAD)
 116 #define STARFIELD_QUIT BUTTON_POWER
 117
 118 #elif CONFIG_KEYPAD == CREATIVEZVM_PAD
 119 #define STARFIELD_QUIT BUTTON_BACK
 120 #define STARFIELD_INCREASE_ZMOVE BUTTON_UP
 121 #define STARFIELD_DECREASE_ZMOVE BUTTON_DOWN
 122 #define STARFIELD_INCREASE_NB_STARS BUTTON_RIGHT
 123 #define STARFIELD_DECREASE_NB_STARS BUTTON_LEFT
 124 #define STARFIELD_TOGGLE_COLOR BUTTON_SELECT
 125
 126 #elif CONFIG_KEYPAD == PHILIPS_HDD1630_PAD
 127 #define STARFIELD_QUIT BUTTON_POWER
 128 #define STARFIELD_INCREASE_ZMOVE BUTTON_UP
 129 #define STARFIELD_DECREASE_ZMOVE BUTTON_DOWN
 130 #define STARFIELD_INCREASE_NB_STARS BUTTON_RIGHT
 131 #define STARFIELD_DECREASE_NB_STARS BUTTON_LEFT
 132 #define STARFIELD_TOGGLE_COLOR BUTTON_SELECT
 133
 134 #elif CONFIG_KEYPAD == PHILIPS_SA9200_PAD
 135 #define STARFIELD_QUIT BUTTON_POWER
 136 #define STARFIELD_INCREASE_ZMOVE BUTTON_UP
 137 #define STARFIELD_DECREASE_ZMOVE BUTTON_DOWN
 138 #define STARFIELD_INCREASE_NB_STARS BUTTON_NEXT
 139 #define STARFIELD_DECREASE_NB_STARS BUTTON_PREV
 140 #define STARFIELD_TOGGLE_COLOR BUTTON_PLAY
 141
 142 #elif (CONFIG_KEYPAD == ONDAVX747_PAD) || (CONFIG_KEYPAD == ONDAVX777_PAD) || (CONFIG_KEYPAD == MROBE500_PAD)
 143 #define STARFIELD_QUIT BUTTON_POWER
 144
 145 #elif CONFIG_KEYPAD == SAMSUNG_YH_PAD
 146 #define STARFIELD_QUIT               BUTTON_FFWD
 147 #define STARFIELD_INCREASE_ZMOVE     BUTTON_UP
 148 #define STARFIELD_DECREASE_ZMOVE     BUTTON_DOWN
 149 #define STARFIELD_INCREASE_NB_STARS  BUTTON_RIGHT
 150 #define STARFIELD_DECREASE_NB_STARS  BUTTON_LEFT
 151 #define STARFIELD_TOGGLE_COLOR       BUTTON_PLAY
 152
 153 #elif CONFIG_KEYPAD == PBELL_VIBE500_PAD
 154 #define STARFIELD_QUIT               BUTTON_REC
 155 #define STARFIELD_INCREASE_ZMOVE     BUTTON_UP
 156 #define STARFIELD_DECREASE_ZMOVE     BUTTON_DOWN
 157 #define STARFIELD_INCREASE_NB_STARS  BUTTON_NEXT
 158 #define STARFIELD_DECREASE_NB_STARS  BUTTON_PREV
 159 #define STARFIELD_TOGGLE_COLOR       BUTTON_PLAY
 160
 161 #endif
 162
 163 #ifdef HAVE_TOUCHSCREEN
 164 #ifndef STARFIELD_QUIT
 165 #define STARFIELD_QUIT              BUTTON_TOPLEFT
 166 #endif
 167 #ifndef STARFIELD_INCREASE_ZMOVE
 168 #define STARFIELD_INCREASE_ZMOVE    BUTTON_TOPMIDDLE
 169 #endif
 170 #ifndef STARFIELD_DECREASE_ZMOVE
 171 #define STARFIELD_DECREASE_ZMOVE    BUTTON_BOTTOMMIDDLE
 172 #endif
 173 #ifndef STARFIELD_INCREASE_NB_STARS
 174 #define STARFIELD_INCREASE_NB_STARS BUTTON_MIDRIGHT
 175 #endif
 176 #ifndef STARFIELD_DECREASE_NB_STARS
 177 #define STARFIELD_DECREASE_NB_STARS BUTTON_MIDLEFT
 178 #endif
 179 #ifndef STARFIELD_TOGGLE_COLOR
 180 #define STARFIELD_TOGGLE_COLOR      BUTTON_CENTER
 181 #endif
 182 #endif
 183
 184 #ifndef STARFIELD_QUIT
 185 #define STARFIELD_QUIT BUTTON_OFF
 186 #endif
 187 #ifndef STARFIELD_INCREASE_ZMOVE
 188 #define STARFIELD_INCREASE_ZMOVE BUTTON_UP
 189 #endif
 190 #ifndef STARFIELD_DECREASE_ZMOVE
 191 #define STARFIELD_DECREASE_ZMOVE BUTTON_DOWN
 192 #endif
 193 #ifndef STARFIELD_INCREASE_NB_STARS
 194 #define STARFIELD_INCREASE_NB_STARS BUTTON_RIGHT
 195 #endif
 196 #ifndef STARFIELD_DECREASE_NB_STARS
 197 #define STARFIELD_DECREASE_NB_STARS BUTTON_LEFT
 198 #endif
 199
 200 #ifndef STARFIELD_TOGGLE_COLOR
 201 #ifdef BUTTON_SELECT
 202 #define STARFIELD_TOGGLE_COLOR BUTTON_SELECT
 203 #else
 204 #define STARFIELD_TOGGLE_COLOR BUTTON_PLAY
 205 #endif
 206 #endif
 207 #if (CONFIG_KEYPAD == IRIVER_H100_PAD) || (CONFIG_KEYPAD == IRIVER_H300_PAD)
 208 #define STARFIELD_RC_QUIT BUTTON_RC_STOP
 209 #endif
 210
 211
 212 #define LCD_CENTER_X (LCD_WIDTH/2)
 213 #define LCD_CENTER_Y (LCD_HEIGHT/2)
 214 #define Z_MAX_DIST 100
 215
 216
 217 #define MAX_STARS (LCD_WIDTH*LCD_HEIGHT*20)/100
 218 #define INIT_STARS 200
 219 #define STARFIELD_INCREASE_STEP 50
 220 #define INIT_SPACE_SPEED 1
 221 #define STAR_MAX_VELOCITY 2
 222 /*
 223  * max 3d coord in the 2d screen :
 224  * example with x
 225  *  x2d=x3d/z+LCD_CENTER_X (+LCD_CENTER_X to center ...)
 226  * so
 227  *  max_x2d=max_x3d/max_z+LCD_CENTER_X
 228  *  max_x3d=(max_x2d-LCD_CENTER_X)*max_z
 229  * with
 230  *  max_x2d = LCD_WIDTH
 231  *  max_z = Z_MAX_DIST
 232  * we have now
 233  * max_x3d=(LCD_WIDTH-LCD_CENTER_X)*Z_MAX_DIST
 234  * max_x3d=LCD_CENTER_X*Z_MAX_DIST
 235  */
 236
 237 #define MAX_INIT_STAR_X LCD_CENTER_X*Z_MAX_DIST
 238 #define MAX_INIT_STAR_Y LCD_CENTER_Y*Z_MAX_DIST
 239
 240 #define MSG_DISP_TIME 30
 241
 242 /*
 243  * Each star's stuffs
 244  */
 245 struct star
 246 {
 247     int x,y,z;
 248     int velocity;
 249 #ifdef HAVE_LCD_COLOR
 250     int color;
 251 #endif
 252 };
 253
 254 static inline void star_init(struct star * star, int z_move, bool color)
 255 {
 256     star->velocity=rb->rand() % STAR_MAX_VELOCITY+1;
 257     /* choose x between -MAX_INIT_STAR_X and MAX_INIT_STAR_X */
 258     star->x=rb->rand() % (2*MAX_INIT_STAR_X)-MAX_INIT_STAR_X;
 259     star->y=rb->rand() % (2*MAX_INIT_STAR_Y)-MAX_INIT_STAR_Y;
 260 #ifdef HAVE_LCD_COLOR
 261     if(color)
 262         star->color=LCD_RGBPACK(rb->rand()%128+128,rb->rand()%128+128,
 263                                 rb->rand()%128+128);
 264     else
 265         star->color=LCD_WHITE;
 266 #else
 267     (void)color;
 268 #endif
 269     if(z_move>=0)
 270         star->z=Z_MAX_DIST;
 271     else
 272         star->z=rb->rand() %Z_MAX_DIST/2+1;
 273 }
 274
 275 static inline void star_move(struct star * star, int z_move, bool color)
 276 {
 277     star->z -= z_move*star->velocity;
 278     if (star->z <= 0 || star->z > Z_MAX_DIST)
 279         star_init(star, z_move, color);
 280 }
 281
 282 static inline void star_draw(struct star * star, int z_move, bool color)
 283 {
 284     int x_draw, y_draw;
 285     /*
 286      * 3d -> 2d : projection on the screen : x2d=x3d/z (thales theorem)
 287      * we put the star in the center of the screen
 288      */
 289     x_draw = star->x / star->z + LCD_CENTER_X;
 290     if (x_draw < 1 || x_draw >= LCD_WIDTH)
 291     {
 292         star_init(star, z_move, color);
 293         return;
 294     }
 295     y_draw  = star->y / star->z + LCD_CENTER_Y;
 296     if (y_draw < 1 || y_draw >= LCD_HEIGHT)
 297     {
 298         star_init(star, z_move, color);
 299         return;
 300     }
 301
 302 #ifdef HAVE_LCD_COLOR
 303     rb->lcd_set_foreground(star->color);
 304 #endif
 305
 306     rb->lcd_drawpixel(x_draw, y_draw);
 307     if(star->z<5*Z_MAX_DIST/6)
 308     {
 309         rb->lcd_drawpixel(x_draw, y_draw - 1);
 310         rb->lcd_drawpixel(x_draw - 1, y_draw);
 311         if(star->z<Z_MAX_DIST/2)
 312         {
 313             rb->lcd_drawpixel(x_draw + 1, y_draw);
 314             rb->lcd_drawpixel(x_draw, y_draw + 1);
 315         }
 316     }
 317 }
 318
 319 /*
 320  * Whole starfield operations
 321  */
 322 struct starfield
 323 {
 324     struct star tab[MAX_STARS];
 325     int nb_stars;
 326     int z_move;
 327     bool color;
 328 };
 329
 330 static inline void starfield_init(struct starfield * starfield)
 331 {
 332     starfield->nb_stars=0;
 333     starfield->z_move=INIT_SPACE_SPEED;
 334     starfield->color=false;
 335 }
 336
 337 static inline void starfield_add_stars(struct starfield * starfield,
 338                                        int nb_to_add)
 339 {
 340     int i, old_nb_stars;
 341     old_nb_stars=starfield->nb_stars;
 342     starfield->nb_stars+=nb_to_add;
 343
 344     if(starfield->nb_stars > MAX_STARS)
 345         starfield->nb_stars=MAX_STARS;
 346
 347     for( i=old_nb_stars ; i < starfield->nb_stars ; ++i )
 348     {
 349         star_init( &(starfield->tab[i]), starfield->z_move, starfield->color );
 350     }
 351 }
 352
 353 static inline void starfield_del_stars(struct starfield * starfield,
 354                                        int nb_to_add)
 355 {
 356     starfield->nb_stars-=nb_to_add;
 357     if(starfield->nb_stars<0)
 358         starfield->nb_stars=0;
 359 }
 360
 361 static inline void starfield_move_and_draw(struct starfield * starfield)
 362 {
 363     int i;
 364     for(i=0;i<starfield->nb_stars;++i)
 365     {
 366         star_move(&(starfield->tab[i]), starfield->z_move, starfield->color);
 367         star_draw(&(starfield->tab[i]), starfield->z_move, starfield->color);
 368     }
 369 }
 370
 371 static struct starfield starfield;
 372
 373 int plugin_main(void)
 374 {
 375     char str_buffer[40];
 376     int button, avg_peak, t_disp=0;
 377     int font_h, font_w;
 378     bool pulse=true;
 379     rb->lcd_getstringsize("A", &font_w, &font_h);
 380     starfield_init(&starfield);
 381     starfield_add_stars(&starfield, INIT_STARS);
 382
 383 #if LCD_DEPTH > 1
 384      rb->lcd_set_backdrop(NULL);
 385 #endif
 386 #ifdef HAVE_LCD_COLOR
 387     rb->lcd_set_background(LCD_BLACK);
 388     rb->lcd_set_foreground(LCD_WHITE);
 389 #endif
 390
 391     while (true)
 392     {
 393         rb->sleep(1);
 394         rb->lcd_clear_display();
 395
 396 #if ((CONFIG_CODEC == SWCODEC)  || !defined(SIMULATOR) && \
 397     ((CONFIG_CODEC == MAS3587F) || (CONFIG_CODEC == MAS3539F)))
 398
 399         /* This will make the stars pulse to the music */
 400         if(pulse){
 401
 402             /* Get the peaks. ( Borrowed from vu_meter ) */
 403 #if (CONFIG_CODEC == SWCODEC)
 404             int left_peak, right_peak;
 405             rb->pcm_calculate_peaks(&left_peak, &right_peak);
 406 #else
 407             int left_peak = rb->mas_codec_readreg(0xC);
 408             int right_peak = rb->mas_codec_readreg(0xD);
 409 #endif
 410             /* Devide peak data by 4098 to bring the max
 411                value down from ~32k to 8 */
 412             left_peak  =    left_peak/0x1000;
 413             right_peak =    right_peak/0x1000;
 414
 415             /* Make sure they dont stop */
 416             if(left_peak<0x1)
 417                 left_peak     = 0x1;
 418             if(right_peak<0x1)
 419                 right_peak    = 0x1;
 420
 421             /* And make sure they dont go over 8 */
 422             if(left_peak>0x8)
 423                 left_peak     = 0x8;
 424             if(right_peak>0x8)
 425                 right_peak    = 0x8;
 426
 427             /* We need the average of both chanels */
 428             avg_peak     = ( left_peak + right_peak )/2;
 429
 430             /* Set the speed to the peak meter */
 431             starfield.z_move = avg_peak;
 432
 433         } /* if pulse */
 434 #else
 435         (void) avg_peak;
 436 #endif
 437         starfield_move_and_draw(&starfield);
 438
 439 #ifdef HAVE_LCD_COLOR
 440         rb->lcd_set_foreground(LCD_WHITE);
 441 #endif
 442
 443         /* if a parameter is updated (by the user), we must print it */
 444         if (t_disp > 0)
 445         {
 446             --t_disp;
 447             rb->snprintf(str_buffer, sizeof(str_buffer),
 448                          "star:%d speed:%d",
 449                          starfield.nb_stars,
 450                          starfield.z_move);
 451 #ifdef HAVE_LCD_COLOR
 452             rb->lcd_set_foreground(LCD_WHITE);
 453 #endif
 454             rb->lcd_putsxy(0, LCD_HEIGHT-font_h, str_buffer);
 455         }
 456         rb->lcd_update();
 457
 458         button = rb->button_get(false);
 459         switch(button)
 460         {
 461             case (STARFIELD_INCREASE_ZMOVE):
 462             case (STARFIELD_INCREASE_ZMOVE | BUTTON_REPEAT):
 463                 ++(starfield.z_move);
 464                 pulse=false;
 465                 t_disp=MSG_DISP_TIME;
 466                 break;
 467             case (STARFIELD_DECREASE_ZMOVE):
 468             case (STARFIELD_DECREASE_ZMOVE | BUTTON_REPEAT):
 469                 --(starfield.z_move);
 470                 pulse=false;
 471                 t_disp=MSG_DISP_TIME;
 472                 break;
 473             case(STARFIELD_INCREASE_NB_STARS):
 474             case(STARFIELD_INCREASE_NB_STARS | BUTTON_REPEAT):
 475                 starfield_add_stars(&starfield, STARFIELD_INCREASE_STEP);
 476                 t_disp=MSG_DISP_TIME;
 477                 break;
 478             case(STARFIELD_DECREASE_NB_STARS):
 479             case(STARFIELD_DECREASE_NB_STARS | BUTTON_REPEAT):
 480                 starfield_del_stars(&starfield, STARFIELD_INCREASE_STEP);
 481                 t_disp=MSG_DISP_TIME;
 482                 break;
 483 #ifdef HAVE_LCD_COLOR
 484             case(STARFIELD_TOGGLE_COLOR):
 485                 starfield.color=!starfield.color;
 486                 break;
 487 #endif
 488 #ifdef STARFIELD_RC_QUIT
 489             case STARFIELD_RC_QUIT:
 490 #endif
 491             case(STARFIELD_QUIT):
 492             case(SYS_USB_CONNECTED):
 493                 return PLUGIN_OK;
 494                 break;
 495         }
 496     }
 497 }
 498
 499 /*************************** Plugin entry point ****************************/
 500
 501 enum plugin_status plugin_start(const void* parameter)
 502 {
 503     int ret;
 504
 505     (void)parameter;
 506     /* Turn off backlight timeout */
 507     backlight_force_on(); /* backlight control in lib/helper.c */
 508
 509     ret = plugin_main();
 510
 511     /* Turn on backlight timeout (revert to settings) */
 512     backlight_use_settings(); /* backlight control in lib/helper.c*/
 513
 514     return ret;
 515 }
 516
 517 #endif /* #ifdef HAVE_LCD_BITMAP */