progdlg_t *
delayed_create_progress_dlg(gpointer top_level_window, const gchar *task_title, const gchar *item_title,
gboolean terminate_is_stop, gboolean *stop_flag,
const GTimeVal *, gfloat progress)
{
progdlg_t *progress_dialog = create_progress_dlg(top_level_window, task_title, item_title, terminate_is_stop, stop_flag);
update_progress_dlg(progress_dialog, progress, item_title);
return progress_dialog;
}
progdlg_t *
delayed_create_progress_dlg(const gchar *task_title, const gchar *item_title,
gboolean terminate_is_stop, gboolean *stop_flag,
const GTimeVal *start_time, gfloat progress)
{
GTimeVal time_now;
gdouble delta_time;
gdouble min_display;
progdlg_t *dlg;
#define INIT_DELAY 0.1 * 1e6 /* .1 second = 0.1e6 microseconds */
#define MIN_DISPLAY_DEFAULT 2.0 * 1e6
/* Create a progress dialog, but only if it's not likely to disappear
* immediately, which can be disconcerting for the user.
*
* Arguments are as for create_progress_dlg(), plus:
*
* (a) A pointer to a GTimeVal structure which holds the time at which
* the caller started to process the data.
* (b) The current progress as a real number between 0 and 1.
*/
g_get_current_time(&time_now);
/* Get the time elapsed since the caller started processing the data */
delta_time = (time_now.tv_sec - start_time->tv_sec) * 1e6 +
time_now.tv_usec - start_time->tv_usec;
/* Do nothing for the first INIT_DELAY microseconds */
if (delta_time < INIT_DELAY)
return NULL;
/* If we create the progress dialog we want it to be displayed for a
* minimum of MIN_DISPLAY_DEFAULT microseconds. However, if we
* previously estimated that the progress dialog didn't need to be
* created and the caller's processing is slowing down (perhaps due
* to the action of the operating system's scheduler on a compute-
* intensive task), we tail off the minimum display time such that
* the progress dialog will always be created after
* 2*MIN_DISPLAY_DEFAULT microseconds.
*/
if (delta_time <= INIT_DELAY + MIN_DISPLAY_DEFAULT)
min_display = MIN_DISPLAY_DEFAULT;
else
min_display = 2 * MIN_DISPLAY_DEFAULT - delta_time;
/* = MIN_DISPLAY_DEFAULT - (delta_time - MIN_DISPLAY_DEFAULT) */
/* Assuming the progress increases linearly, see if the progress
* dialog would be displayed for at least min_display microseconds if
* we created it now.
*/
if (progress >= (delta_time / (delta_time + min_display)))
return NULL;
dlg = create_progress_dlg(task_title, item_title, terminate_is_stop,
stop_flag);
/*
* Flush out the dialog so we don't see an "empty" one until first update.
*/
while (gtk_events_pending())
gtk_main_iteration();
/* set dialog start_time to the start of processing, not box creation */
dlg->start_time = *start_time;
return dlg;
}
struct progdlg *FunnelStatistics::progressDialogNew(const gchar *task_title, const gchar *item_title, gboolean terminate_is_stop, gboolean *stop_flag)
{
return create_progress_dlg(capture_file_.window(), task_title, item_title, terminate_is_stop, stop_flag);
}
