ximgview(1grass)

📦
version 8.5.0 · 10 versions
, in alpine 3.24, ubuntu stonking

💖 ximgview 💖

okay bestie, welcome to ximgview, straight outta the GRASS User's Manual ✨ it's a little X11 viewer that just... stares at your BMPs. affectionately. 🦋

✨ 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 the usage summary, aka the lil cheat sheet 📝
  • --verbose — verbose module output, chatty mode fr fr 🗣️
  • --quiet — quiet module output, shhh 🤫
  • --ui — force launching the GUI dialog 🖥️✨

Parameters 🌈

  • image=name [required] — the image file. you literally cannot skip this one bestie, it's required 😭
  • percent=integer — percentage of CPU time to use 🧠⚡ Default: 10

💅 DESCRIPTION 💅

so ximgview is a simple X11 image viewer for 32-bpp BMP images — the exact kind that the PNG and cairo drivers can create. and the display? it's continually refreshed. like it never stops looking at you. main character energy honestly 👑

👀 NOTES 👀

the display driver must be configured to map the file, using GRASS_RENDER_FILE_MAPPED=TRUE. why tho? because that's what keeps the file at a constant size instead of getting truncated every single time it's updated 💀 no mapped file, no vibe. periodt.

fr fr, don't skip that env var. it's not a suggestion, it's the whole thing 🫶

🍓 EXAMPLE 🍓

(bash shell syntax, obviously 💅)

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

look at that workflow slay 😌✨

🔥 SEE ALSO 🔥

PNG driver, cairo driver, wxpyimgview, variables

iykyk 🌈

👑 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.0 Reference Manual 🫶

okay that's the whole page bestie!! GRASS 8.5.0 energy all the way through, and yeah this is the ximgview(1grass) manual page — go view some BMPs, you got this 💖✨🎀🦋🌸💅

📦 where this page comes from