Skip to content

ximgview

View BMP images from the PNG driver.

ximgview image=name [percent=integer] [--verbose] [--quiet] [--qq] [--ui]

Example:

ximgview image=name

grass.script.run_command("ximgview", image, percent=10, verbose=False, quiet=False, superquiet=False)

Example:

gs.run_command("ximgview", image="name")

Parameters

image=name [required]
    Image file
percent=integer
    Percentage of CPU time to use
    Default: 10
--help
    Print usage summary
--verbose
    Verbose module output
--quiet
    Quiet module output
--qq
    Very quiet module output
--ui
    Force launching GUI dialog

image : str, required
    Image file
    Used as: file, name
percent : int, optional
    Percentage of CPU time to use
    Default: 10
verbose: bool, optional
    Verbose module output
    Default: False
quiet: bool, optional
    Quiet module output
    Default: False
superquiet: bool, optional
    Very quiet module output
    Default: False

DESCRIPTION

ximgview is a simple X11 image viewer for 32-bpp BMP images, as can be created with the PNG and cairo drivers. The display is continually refreshed.

NOTES

The display driver must be configure to map the file, with GRASS_RENDER_FILE_MAPPED=TRUE. This ensures that the file will remain a constant size, rather than being truncated whenever it is updated.

EXAMPLE

(bash shell syntax)

export GRASS_RENDER_FILE=map.bmp
export GRASS_RENDER_WIDTH=640
export GRASS_RENDER_HEIGHT=480
export GRASS_RENDER_IMMEDIATE=PNG
export GRASS_RENDER_FILE_MAPPED=TRUE
export GRASS_RENDER_FILE_READ=TRUE

d.erase
ximgview $GRASS_RENDER_FILE percent=50 &
d.rast elevation.dem
d.vect roads

SEE ALSO

PNG driver, cairo driver, wxpyimgview
variables

AUTHOR

Glynn Clements

SOURCE CODE

Available at: ximgview source code (history)
Latest change: Wednesday Feb 26 06:42:07 2025 in commit 01f63dc