progress_image: Display a custom 80 by 80 pixel image as a progress bar.
In switchboard: An Agile Widget Engine for Real-Time, Dynamic Visualizations

Description Arguments Value Usage See Also Examples

The progress_image widget displays an image as a progressBar.

`eavesdrop`	The variable to track with a progress bar.
`maximum`	The maximum value of `eavesdrop` that marks the end of what to progress track.
`size`	A number used to designate the size (magnification) of the widget. The default is set to `1` which is 80 by 80 pixels. For example, setting to `3` will results in a widget 3-times the default size (240 by 240 pixels) and will occupy a grid area of 3 by 3.
`placeOnGrid`	A row by column coordinate (e.g., `c(row-number, column-number)`) of a grid that designates the position to draw the widget on the `switchboard`. Use `showGrid()` to help organize widget placement on dashboard. The default places the first widget in pipe chain to the `c(1, 1)` position, and all following on the same row stacked to the right.
`updates`	The number of times the widget is to be updated (e.g., when it be modified/changed). The default updates the widget 100 times. Increase number for smoother progress bar animation.
`delay`	Pause each update of the switchboard. Default has no delay, values are in seconds (e.g., `delay = 0.01` results in 0.01 second delay with each iteration).
`honest`	When `TRUE`, it updates the widget by the true progression value. The default (`FALSE`) has a cosmetic modification to the progression value that helps update it in a prettier way.
`closeAtMaximum`	Functions like `switchboard_close()` by closing the switchboard window when the eavesdropped value equals maximum. NOTE: if a widget has `closeAtMaximum = TRUE`, then this widget MUST be placed at the end (i.e., last widget) of the pipe chain.
`fill`	The direction of how things are animated when displaying progression. The default is `horizontal`, which tracks progression from left to right (maximum), but `vertical` can also be used for progress to occur in a bottom to up (maximum) animation.
`file`	A *.png filename with a transparent background that designates an image to be used as a progress-bar. The total image size should be 80 by 80 pixels, but for best integration into switchboard layout, the actual image must be 75 by 75 pixels placed at the bottom left of the 80 by 80 image. This will leave a 5 pixel whitespace at both the top and right side of the image.

Nothing.

1
2
3

progress_image(eavesdrop, maximum = 100, size = 1,
   placeOnGrid = c(1, 1), updates = 100, delay = 0, honest = FALSE,
   closeAtMaximum = FALSE, fill = "horizontal", file = "")

Other progress bars: progress_benchmark(), progress_ibis(), progress_oyster(), progress_percent(), progress_phyllotaxis(), progress_pikachu(), progress_ring_percent(), progress_ring()

## Not run: 
     
     for (i in 1:250) {
       switchboard(delay = 0.01) %>%
         progress_image(i, maximum = 250, 
                        file = system.file("images", "topography.png", package = "switchboard"))
     }
     switchboard_close()


## End(Not run)