ximgview - GRASS manual
Author: GRASS Development Team
Description: ximgview: View BMP images from the PNG driver.
Keywords: display, graphics, raster, vector, visualization

## NAME

ximgview - View BMP images from the PNG driver.

## KEYWORDS

display, graphics, raster, vector, visualization

## SYNOPSIS

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

### Flags:

--help
  Print usage summary
--verbose
  Verbose module output
--quiet
  Quiet module output
--ui
  Force launching GUI dialog

### Parameters:

image=name [required]
  Image file
percent=integer
  Percentage of CPU time to use
  Default: 10

## 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: Friday Apr 17 01:04:26 2026 in commit: 32a143358df26b2e518b03c7e0d79541e8d1e5b1

Main index | Topics index | Keywords index | Graphical index | Full index

© 2003-2026 GRASS Development Team, GRASS 8.5.1dev Reference Manual