r.out.png.1grass - Man Page

Export a GRASS raster map as a non-georeferenced PNG image.


raster, export, output, PNG


r.out.png --help
r.out.png [-tw] input=name output=name  [compression=integer]   [--overwrite]  [--help]  [--verbose]  [--quiet]  [--ui]



Make NULL cells transparent


Output world file


Allow output files to overwrite existing files


Print usage summary


Verbose module output


Quiet module output


Force launching GUI dialog


input=name [required]

Name of input raster map

output=name [required]

Name for new PNG file (use ’-’ for stdout)


Compression level of PNG file
(0 = none, 1 = fastest, 9 = best)
Options: 0-9
Default: 6


r.out.png exports a GRASS GIS raster map in non-georeferenced Portable Network Graphics (PNG) image format, respecting the current region resolution and bounds.

Optionally the user can choose to export a World File (.wld) to provide basic georeferencing support. When used with the transparency flag this can create images useful for KML, TMS, or WMS overlays. (e.g. for use in Google Earth or as OpenLayers tiles) If output is redirected to stdout, the world file will be called png_map.wld.


The example is based on the North Carolina sample data location.

Export of the soil map to PNG format with world file:

g.region raster=soils_Kfactor -p
# export PNG file with additional world file
r.out.png input=soils_Kfactor output=soils_Kfactor -w
# verify
gdalinfo soils_Kfactor.png

See Also

r.out.gdal, r.out.ppm, r.out.ascii, r.import


Alex Shevlakov
Hamish Bowman

Source Code

Available at: r.out.png source code (history)

Accessed: Tuesday Mar 19 11:01:58 2024

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

© 2003-2024 GRASS Development Team, GRASS GIS 8.3.2 Reference Manual


GRASS 8.3.2 GRASS GIS User's Manual