---
name: "ximgview"
section: "1grass"
platform: "linux"
package: "grass-doc"
version: "8.4.1-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/ximgview"
---

# ximgview(1grass)

View BMP images from the PNG driver.

## 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)

Accessed: Monday Feb 24 17:52:42 2025

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

© 2003-2025 GRASS Development Team, GRASS GIS 8.4.1 Reference Manual