Another wps rework:

*rename gui_wps_refresh() to gui_wps_redraw() and update() to gui_wps_update() to better describe what they do
*Clear things up and differentiate better between gui_wps_redraw()/gui_wps_display()/gui_wps_update() (it wasn't so what they're supposed to do before)
*cleanup gui_wps_display() and gui_wps_update() quite a bit
*Remove unused/unneeded code, do some pointer copying to save binsize, and code cleanup at several places

Visible changes should be small

git-svn-id: svn://svn.rockbox.org/rockbox/trunk@20483 a1c6a512-1295-4272-9138-f99709370657

4 files changed, 133 insertions, 160 deletions

diff --git a/apps/gui/gwps-common.c b/apps/gui/gwps-common.c
index 005fefd0fb..198d62d891 100644
--- a/apps/gui/gwps-common.c
+++ b/apps/gui/gwps-common.c
@@ -74,8 +74,6 @@
 #define TIMEOUT_UNIT (HZ/10) /* I.e. 0.1 sec */
 #define DEFAULT_SUBLINE_TIME_MULTIPLIER 20 /* In TIMEOUT_UNIT's */
 
-
-/* fades the volume */
 bool wps_fading_out = false;
 void fade(bool fade_in, bool updatewps)
 {
@@ -100,7 +98,7 @@ void fade(bool fade_in, bool updatewps)
             if (updatewps)
             {
                 FOR_NB_SCREENS(i)
-                    gui_wps_refresh(&gui_wps[i], 0, WPS_REFRESH_NON_STATIC);
+                    gui_wps_redraw(&gui_wps[i], 0, WPS_REFRESH_NON_STATIC);
             }
             sleep(1);
         }
@@ -116,7 +114,7 @@ void fade(bool fade_in, bool updatewps)
             if (updatewps)
             {
                 FOR_NB_SCREENS(i)
-                    gui_wps_refresh(&gui_wps[i], 0, WPS_REFRESH_NON_STATIC);
+                    gui_wps_redraw(&gui_wps[i], 0, WPS_REFRESH_NON_STATIC);
             }
             sleep(1);
         }
@@ -135,12 +133,9 @@ void fade(bool fade_in, bool updatewps)
     }
 }
 
-/* return true if screen restore is needed
-   return false otherwise
-*/
 bool update_onvol_change(struct gui_wps * gwps)
 {
-    gui_wps_refresh(gwps, 0, WPS_REFRESH_NON_STATIC);
+    gui_wps_redraw(gwps, 0, WPS_REFRESH_NON_STATIC);
 
 #ifdef HAVE_LCD_CHARCELLS
     splashf(0, "Vol: %3d dB",
@@ -240,7 +235,7 @@ bool ffwd_rew(int button)
                 }
 
                 FOR_NB_SCREENS(i)
-                    gui_wps_refresh(&gui_wps[i],
+                    gui_wps_redraw(&gui_wps[i],
                                     (wps_state.wps_time_countup == false)?
                                     ff_rewind_count:-ff_rewind_count,
                                     WPS_REFRESH_PLAYER_PROGRESS |
@@ -259,7 +254,8 @@ bool ffwd_rew(int button)
                     audio_resume();
 #endif
 #ifdef HAVE_LCD_CHARCELLS
-                gui_wps_display();
+                FOR_NB_SCREENS(i)
+                    gui_wps_redraw(gwps,0, WPS_REFRESH_ALL);
 #endif
                 exit = true;
                 break;
@@ -278,145 +274,125 @@ bool ffwd_rew(int button)
     return usb;
 }
 
-bool gui_wps_display(void)
+bool gui_wps_display(struct gui_wps *gwps)
 {
-    int i;
-    if (!wps_state.id3 && !(audio_status() & AUDIO_STATUS_PLAY))
+    struct screen *display = gwps->display;
+    struct wps_data *data = gwps->data;
+    int screen = display->screen_type;
+
+    /* Update the values in the first (default) viewport - in case the user
+       has modified the statusbar or colour settings */
+#if LCD_DEPTH > 1
+    if (display->depth > 1)
     {
-        global_status.resume_index = -1;
-        splash(HZ, ID2P(LANG_END_PLAYLIST));
-        return true;
+        data->viewports[0].vp.fg_pattern = display->get_foreground();
+        data->viewports[0].vp.bg_pattern = display->get_background();
     }
-    else
-    {
-        FOR_NB_SCREENS(i)
-        {
-            /* Update the values in the first (default) viewport - in case the user
-               has modified the statusbar or colour settings */
-#ifdef HAVE_LCD_BITMAP
-#if LCD_DEPTH > 1
-            if (gui_wps[i].display->depth > 1)
-            {
-                gui_wps[i].data->viewports[0].vp.fg_pattern = gui_wps[i].display->get_foreground();
-                gui_wps[i].data->viewports[0].vp.bg_pattern = gui_wps[i].display->get_background();
-            }
 #endif
-#endif
-            gui_wps[i].display->clear_display();
-            if (!gui_wps[i].data->wps_loaded) {
-                if ( !gui_wps[i].data->num_tokens ) {
-                    /* set the default wps for the main-screen */
-                    if(i == 0)
-                    {
-#ifdef HAVE_LCD_BITMAP
+    display->clear_display();
+    if (!data->wps_loaded) {
+        if ( !data->num_tokens ) {
+            /* set the default wps for the main-screen */
+            if(screen == SCREEN_MAIN)
+            {
 #if LCD_DEPTH > 1
-                        unload_wps_backdrop();
+                unload_wps_backdrop();
 #endif
-                        wps_data_load(gui_wps[i].data,
-                                      gui_wps[i].display,
-                                      "%s%?it<%?in<%in. |>%it|%fn>\n"
-                                      "%s%?ia<%ia|%?d2<%d2|(root)>>\n"
-                                      "%s%?id<%id|%?d1<%d1|(root)>> %?iy<(%iy)|>\n"
-                                      "\n"
-                                      "%al%pc/%pt%ar[%pp:%pe]\n"
-                                      "%fbkBit %?fv<avg|> %?iv<(id3v%iv)|(no id3)>\n"
-                                      "%pb\n"
-                                      "%pm\n", false);
+                wps_data_load(data,
+                              display,
+#ifdef HAVE_LCD_BITMAP
+                              "%s%?it<%?in<%in. |>%it|%fn>\n"
+                              "%s%?ia<%ia|%?d2<%d2|(root)>>\n"
+                              "%s%?id<%id|%?d1<%d1|(root)>> %?iy<(%iy)|>\n"
+                              "\n"
+                              "%al%pc/%pt%ar[%pp:%pe]\n"
+                              "%fbkBit %?fv<avg|> %?iv<(id3v%iv)|(no id3)>\n"
+                              "%pb\n"
+                              "%pm\n", false);
 #else
-                        wps_data_load(gui_wps[i].data,
-                                      gui_wps[i].display,
-                                      "%s%pp/%pe: %?it<%it|%fn> - %?ia<%ia|%d2> - %?id<%id|%d1>\n"
-                                      "%pc%?ps<*|/>%pt\n", false);
+                              "%s%pp/%pe: %?it<%it|%fn> - %?ia<%ia|%d2> - %?id<%id|%d1>\n"
+                              "%pc%?ps<*|/>%pt\n", false);
 #endif
-                    }
-#if NB_SCREENS == 2
-                     /* set the default wps for the remote-screen */
-                     else if(i == 1)
-                     {
-#if defined(HAVE_REMOTE_LCD) && LCD_REMOTE_DEPTH > 1
-                         unload_remote_wps_backdrop();
+            }
+#ifdef HAVE_REMOTE_LCD
+             /* set the default wps for the remote-screen */
+             else if(screen == SCREEN_REMOTE)
+             {
+#if LCD_REMOTE_DEPTH > 1
+                 unload_remote_wps_backdrop();
 #endif
-                         wps_data_load(gui_wps[i].data,
-                                       gui_wps[i].display,
-                                       "%s%?ia<%ia|%?d2<%d2|(root)>>\n"
-                                       "%s%?it<%?in<%in. |>%it|%fn>\n"
-                                       "%al%pc/%pt%ar[%pp:%pe]\n"
-                                       "%fbkBit %?fv<avg|> %?iv<(id3v%iv)|(no id3)>\n"
-                                       "%pb\n", false);
-                     }
+                 wps_data_load(data,
+                               display,
+                               "%s%?ia<%ia|%?d2<%d2|(root)>>\n"
+                               "%s%?it<%?in<%in. |>%it|%fn>\n"
+                               "%al%pc/%pt%ar[%pp:%pe]\n"
+                               "%fbkBit %?fv<avg|> %?iv<(id3v%iv)|(no id3)>\n"
+                               "%pb\n", false);
+             }
 #endif
-                }
-            }
         }
     }
-    yield();
-    FOR_NB_SCREENS(i)
+    else
     {
-        gui_wps_refresh(&gui_wps[i], 0, WPS_REFRESH_ALL);
+#if defined(HAVE_REMOTE_LCD) && LCD_REMOTE_DEPTH > 1
+        if (screen == SCREEN_REMOTE)
+            show_remote_wps_backdrop();
+        else if (screen == SCREEN_MAIN)
+#endif
+#if LCD_DEPTH > 1
+            show_wps_backdrop();
+#endif
     }
-    return false;
+    return gui_wps_redraw(gwps, 0, WPS_REFRESH_ALL);
 }
 
-bool update(struct gui_wps *gwps)
+bool gui_wps_update(struct gui_wps *gwps)
 {
     bool track_changed = audio_has_changed_track();
-    bool retcode = false;
+    struct mp3entry *id3 = gwps->state->id3;
 
     gwps->state->nid3 = audio_next_track();
     if (track_changed)
     {
-        gwps->display->stop_scroll();
-        gwps->state->id3 = audio_current_track();
+        gwps->state->id3 = id3 = audio_current_track();
 
-        if (cuesheet_is_enabled() && gwps->state->id3->cuesheet_type
-            && strcmp(gwps->state->id3->path, curr_cue->audio_filename))
+        if (cuesheet_is_enabled() && id3->cuesheet_type
+            && strcmp(id3->path, curr_cue->audio_filename))
         {
             /* the current cuesheet isn't the right one any more */
             /* We need to parse the new cuesheet */
 
             char cuepath[MAX_PATH];
 
-            if (look_for_cuesheet_file(gwps->state->id3->path, cuepath) &&
+            if (look_for_cuesheet_file(id3->path, cuepath) &&
                 parse_cuesheet(cuepath, curr_cue))
             {
-                gwps->state->id3->cuesheet_type = 1;
-                strcpy(curr_cue->audio_filename, gwps->state->id3->path);
+                id3->cuesheet_type = 1;
+                strcpy(curr_cue->audio_filename, id3->path);
             }
 
-            cue_spoof_id3(curr_cue, gwps->state->id3);
-        }
-
-        if (gui_wps_display())
-            retcode = true;
-        else{
-            gui_wps_refresh(gwps, 0, WPS_REFRESH_ALL);
+            cue_spoof_id3(curr_cue, id3);
         }
     }
 
-    if (gwps->state->id3)
+    if (cuesheet_is_enabled() && id3->cuesheet_type
+        && (id3->elapsed < curr_cue->curr_track->offset
+            || (curr_cue->curr_track_idx < curr_cue->track_count - 1
+                && id3->elapsed >= (curr_cue->curr_track+1)->offset)))
     {
-        if (cuesheet_is_enabled() && gwps->state->id3->cuesheet_type
-            && (gwps->state->id3->elapsed < curr_cue->curr_track->offset
-                || (curr_cue->curr_track_idx < curr_cue->track_count - 1
-                    && gwps->state->id3->elapsed >= (curr_cue->curr_track+1)->offset)))
-        {
-            /* We've changed tracks within the cuesheet :
-               we need to update the ID3 info and refresh the WPS */
-
-            cue_find_current_track(curr_cue, gwps->state->id3->elapsed);
-            cue_spoof_id3(curr_cue, gwps->state->id3);
+        /* We've changed tracks within the cuesheet :
+           we need to update the ID3 info and refresh the WPS */
 
-            gwps->display->stop_scroll();
-            if (gui_wps_display())
-                retcode = true;
-            else
-                gui_wps_refresh(gwps, 0, WPS_REFRESH_ALL);
-        }
-        else
-            gui_wps_refresh(gwps, 0, WPS_REFRESH_NON_STATIC);
+        track_changed = true;
+        cue_find_current_track(curr_cue, id3->elapsed);
+        cue_spoof_id3(curr_cue, id3);
     }
 
-    return retcode;
+    if (track_changed)
+        gwps->display->stop_scroll();
+
+    return gui_wps_redraw(gwps, 0,
+                track_changed ? WPS_REFRESH_ALL : WPS_REFRESH_NON_STATIC);
 }
 
 
@@ -1745,7 +1721,6 @@ static void write_line(struct screen *display,
                        int line,
                        bool scroll)
 {
-
     int left_width = 0, left_xpos;
     int center_width = 0, center_xpos;
     int right_width = 0,  right_xpos;
@@ -1898,22 +1873,23 @@ static void write_line(struct screen *display,
     }
 }
 
-/* Refresh the WPS according to refresh_mode. */
-bool gui_wps_refresh(struct gui_wps *gwps,
+bool gui_wps_redraw(struct gui_wps *gwps,
                      int ffwd_offset,
-                     unsigned char refresh_mode)
+                     unsigned refresh_mode)
 {
     struct wps_data *data = gwps->data;
     struct screen *display = gwps->display;
     struct wps_state *state = gwps->state;
+    struct mp3entry *id3 = state->id3;
 
-    if(!gwps || !data || !state || !display)
+    if(!data || !state || !display || !id3)
+    {
         return false;
+    }
 
     int v, line, i, subline_idx;
-    unsigned char flags;
+    unsigned flags;
     char linebuf[MAX_PATH];
-    unsigned char vp_refresh_mode;
 
     struct align_pos align;
     align.left = NULL;
@@ -1955,12 +1931,6 @@ bool gui_wps_refresh(struct gui_wps *gwps,
     }
 #endif
 
-    if (!state->id3)
-    {
-        display->stop_scroll();
-        return false;
-    }
-
     state->ff_rewind_count = ffwd_offset;
 
     /* disable any viewports which are conditionally displayed */
@@ -1977,8 +1947,8 @@ bool gui_wps_refresh(struct gui_wps *gwps,
     for (v = 0; v < data->num_viewports; v++)
     {
         struct wps_viewport *wps_vp = &(data->viewports[v]);
+        unsigned vp_refresh_mode = refresh_mode;
         display->set_viewport(&wps_vp->vp);
-        vp_refresh_mode = refresh_mode;
 
 #ifdef HAVE_LCD_BITMAP
         /* Set images to not to be displayed */
@@ -2114,7 +2084,7 @@ bool gui_wps_refresh(struct gui_wps *gwps,
     display->update();
 
 #ifdef HAVE_BACKLIGHT
-    if (global_settings.caption_backlight && state->id3)
+    if (global_settings.caption_backlight)
     {
         /* turn on backlight n seconds before track ends, and turn it off n
            seconds into the new track. n == backlight_timeout, or 5s */
@@ -2123,14 +2093,14 @@ bool gui_wps_refresh(struct gui_wps *gwps,
         if ( n < 1000 )
             n = 5000; /* use 5s if backlight is always on or off */
 
-        if (((state->id3->elapsed < 1000) ||
-             ((state->id3->length - state->id3->elapsed) < (unsigned)n)) &&
+        if (((id3->elapsed < 1000) ||
+             ((id3->length - id3->elapsed) < (unsigned)n)) &&
             (state->paused == false))
             backlight_on();
     }
 #endif
 #ifdef HAVE_REMOTE_LCD
-    if (global_settings.remote_caption_backlight && state->id3)
+    if (global_settings.remote_caption_backlight)
     {
         /* turn on remote backlight n seconds before track ends, and turn it
            off n seconds into the new track. n == remote_backlight_timeout,
@@ -2140,8 +2110,8 @@ bool gui_wps_refresh(struct gui_wps *gwps,
         if ( n < 1000 )
             n = 5000; /* use 5s if backlight is always on or off */
 
-        if (((state->id3->elapsed < 1000) ||
-             ((state->id3->length - state->id3->elapsed) < (unsigned)n)) &&
+        if (((id3->elapsed < 1000) ||
+             ((id3->length - id3->elapsed) < (unsigned)n)) &&
             (state->paused == false))
             remote_backlight_on();
     }
diff --git a/apps/gui/gwps-common.h b/apps/gui/gwps-common.h
index 25ce435592..8752c1d162 100644
--- a/apps/gui/gwps-common.h
+++ b/apps/gui/gwps-common.h
@@ -25,14 +25,25 @@
 
 #include "gwps.h"
 
+/* fades the volume, e.g. on pause or stop */
 void fade(bool fade_in, bool updatewps);
-bool gui_wps_display(void);
+
+/* Initially display the wps, can fall back to the build-in wps
+ * if the chosen wps is invalid */
+bool gui_wps_display(struct gui_wps *gui_wps);
+
+/* return true if screen restore is needed
+   return false otherwise */
 bool update_onvol_change(struct gui_wps * gwps);
-bool update(struct gui_wps *gwps);
+
+/* Update track info related stuff, handles cue sheets as well, and redraw */
+bool gui_wps_update(struct gui_wps *gwps);
+
 bool ffwd_rew(int button);
 void display_keylock_text(bool locked);
 
-bool gui_wps_refresh(struct gui_wps *gwps,
+/* Refresh the WPS according to refresh_mode. */
+bool gui_wps_redraw(struct gui_wps *gwps,
                      int ffwd_offset,
-                     unsigned char refresh_mode);
+                     unsigned refresh_mode);
 #endif
diff --git a/apps/gui/gwps.c b/apps/gui/gwps.c
index cbce0f5973..9057d9ead9 100644
--- a/apps/gui/gwps.c
+++ b/apps/gui/gwps.c
@@ -219,15 +219,8 @@ long gui_wps_show(void)
 #ifdef HAVE_LCD_CHARCELLS
     status_set_audio(true);
     status_set_param(false);
-#else
-#if LCD_DEPTH > 1
-    show_wps_backdrop();
-#endif /* LCD_DEPTH > 1 */
 #endif
 
-#if defined(HAVE_REMOTE_LCD) && LCD_REMOTE_DEPTH > 1
-    show_remote_wps_backdrop();
-#endif
     gwps_fix_statusbars();
 
 #ifdef AB_REPEAT_ENABLE
@@ -239,18 +232,17 @@ long gui_wps_show(void)
         wps_state.id3 = audio_current_track();
         wps_state.nid3 = audio_next_track();
         if (wps_state.id3) {
-            if (gui_wps_display())
+            FOR_NB_SCREENS(i)
             {
-                gwps_leave_wps();
-                return 0;
+                if (!gui_wps_display(&gui_wps[i]))
+                    exit = true;
             }
         }
-
-        restore = true;
     }
     
     while ( 1 )
     {
+        yield();
         bool audio_paused = (audio_status() & AUDIO_STATUS_PAUSE)?true:false;
 
         /* did someone else (i.e power thread) change audio pause mode? */
@@ -295,7 +287,7 @@ long gui_wps_show(void)
                     FOR_NB_SCREENS(i)
                     {
                         if(gui_wps[i].data->peak_meter_enabled)
-                            gui_wps_refresh(&gui_wps[i], 0,
+                            gui_wps_redraw(&gui_wps[i], 0,
                                             WPS_REFRESH_PEAK_METER);
                         next_refresh += HZ / PEAK_METER_FPS;
                     }
@@ -392,7 +384,6 @@ long gui_wps_show(void)
                 }
                 break;
 
-                /* volume up */
             case ACTION_WPS_VOLUP:
             {
                 FOR_NB_SCREENS(i)
@@ -410,9 +401,7 @@ long gui_wps_show(void)
                     restoretimer = RESTORE_WPS_NEXT_SECOND;
                 }
             }
-                break;
-
-                /* volume down */
+            break;
             case ACTION_WPS_VOLDOWN:
             {
                 FOR_NB_SCREENS(i)
@@ -683,7 +672,7 @@ long gui_wps_show(void)
         {
             FOR_NB_SCREENS(i)
             {
-                if(update(&gui_wps[i]))
+                if(!gui_wps_update(&gui_wps[i]))
                     exit = true;
             }
             update_track = false;
@@ -702,8 +691,11 @@ long gui_wps_show(void)
 #endif
             restore = false;
             restoretimer = RESTORE_WPS_INSTANTLY;
-            if (gui_wps_display()) {
-                exit = true;
+            FOR_NB_SCREENS(i)
+            {
+                screens[i].stop_scroll();
+                if (!gui_wps_redraw(&gui_wps[i], 0, WPS_REFRESH_ALL))
+                    exit = true;
             }
         }
 
diff --git a/apps/gui/gwps.h b/apps/gui/gwps.h
index d1239c1b34..7888c3944c 100644
--- a/apps/gui/gwps.h
+++ b/apps/gui/gwps.h
@@ -26,13 +26,13 @@
 #include "metadata.h"
 
 /* constants used in line_type and as refresh_mode for wps_refresh */
-#define WPS_REFRESH_STATIC          (1<<0)  /* line doesn't change over time */
-#define WPS_REFRESH_DYNAMIC         (1<<1)  /* line may change (e.g. time flag) */
-#define WPS_REFRESH_SCROLL          (1<<2)  /* line scrolls */
-#define WPS_REFRESH_PLAYER_PROGRESS (1<<3)  /* line contains a progress bar */
-#define WPS_REFRESH_PEAK_METER      (1<<4) /* line contains a peak meter */
-#define WPS_REFRESH_STATUSBAR       (1<<5) /* refresh statusbar */
-#define WPS_REFRESH_ALL             0xff /* to refresh all line types */
+#define WPS_REFRESH_STATIC          (1u<<0)  /* line doesn't change over time */
+#define WPS_REFRESH_DYNAMIC         (1u<<1)  /* line may change (e.g. time flag) */
+#define WPS_REFRESH_SCROLL          (1u<<2)  /* line scrolls */
+#define WPS_REFRESH_PLAYER_PROGRESS (1u<<3)  /* line contains a progress bar */
+#define WPS_REFRESH_PEAK_METER      (1u<<4)  /* line contains a peak meter */
+#define WPS_REFRESH_STATUSBAR       (1u<<5)  /* refresh statusbar */
+#define WPS_REFRESH_ALL       (0xffffffffu)   /* to refresh all line types */
 
 /* to refresh only those lines that change over time */
 #define WPS_REFRESH_NON_STATIC (WPS_REFRESH_DYNAMIC| \