Tool Export Image (bmp, jpg, pcx, png, tif)

With this tool you can save a grid to an image file. Optionally, a shade grid can be overlayed using the specified transparency and brightness adjustment.

Author: O.Conrad (c) 2005
Menu: File|Grid|Export

Parameters

	Name	Type	Identifier	Description	Constraints
Input	Grid	grid, input	`GRID`	-	-
Input	Shade (*)	grid, input, optional	`SHADE`	-	-
Options	Grid System	grid system	`PARAMETERS_GRID_SYSTEM`	-	-
	Image File	file path	`FILE`	-	-
	Create World File	boolean	`FILE_WORLD`	Store georeference along image to an additional file.	Default: 1
	Create KML File	boolean	`FILE_KML`	Expects that the input grid uses geographic coordinates.	Default: 0
	Set Transparency for No-Data	boolean	`NO_DATA`	-	Default: 1
	Coloring	choice	`COLOURING`	-	Available Choices: [0] histogram stretch to standard deviation [1] histogram stretch to percentage range [2] histogram stretch to value range [3] lookup table [4] rgb coded values Default: 0
	Number of Colors	integer number	`COL_COUNT`	-	Default: 100
	Revert Palette	boolean	`COL_REVERT`	-	Default: 0
	Colors Palette	colors	`COL_PALETTE`	-	-
	Graduated Colors	boolean	`GRADUATED`	-	Default: 1
	Standard Deviation	floating point number	`STDDEV`	-	Minimum: 0.000000 Default: 2.000000
	Percentage Range	value range	`LINEAR`	-	-
	Value Range	value range	`STRETCH`	-	-
	Scaling	choice	`SCALE_MODE`	Scaling applied to coloring choices (i) grid's standard deviation, (ii) grid's value range, (iii) specified value range	Available Choices: [0] linear intervals [1] increasing geometrical intervals [2] decreasing geometrical intervals Default: 0
	Geometrical Interval Factor	floating point number	`SCALE_LOG`	-	Minimum: 0.001000 Default: 10.000000
	Lookup Table	static table	`LUT`	-	5 Fields: - 1. [color] Color - 2. [string] Name - 3. [string] Description - 4. [8 byte floating point number] Minimum - 5. [8 byte floating point number] Maximum
	Transparency	floating point number	`SHADE_TRANS`	The transparency of the shade [%]	Minimum: 0.000000 Maximum: 100.000000 Default: 75.000000
	Histogram Stretch	choice	`SHADE_COLOURING`	-	Available Choices: [0] Linear [1] Standard Deviation Default: 0
	Linear	value range	`SHADE_BRIGHT`	Minimum and maximum [%], the range for histogram stretch.	-
	Standard Deviation	floating point number	`SHADE_STDDEV`	-	Minimum: 0.000000 Default: 2.000000
(*) optional

Command-line

Usage: saga_cmd io_grid_image 0 [-GRID <str>] [-SHADE <str>] [-FILE <str>] [-FILE_WORLD <str>] [-FILE_KML <str>] [-NO_DATA <str>] [-COLOURING <str>] [-COL_COUNT <num>] [-COL_REVERT <str>] [-COL_PALETTE <str>] [-GRADUATED <str>] [-STDDEV <double>] [-LINEAR_MIN <double>] [-LINEAR_MAX <double>] [-STRETCH_MIN <double>] [-STRETCH_MAX <double>] [-SCALE_MODE <str>] [-SCALE_LOG <double>] [-LUT <str>] [-SHADE_TRANS <double>] [-SHADE_COLOURING <str>] [-SHADE_BRIGHT_MIN <double>] [-SHADE_BRIGHT_MAX <double>] [-SHADE_STDDEV <double>]
  -GRID:<str>               	Grid
	grid, input
  -SHADE:<str>              	Shade
	grid, input, optional
  -FILE:<str>               	Image File
	file path
  -FILE_WORLD:<str>         	Create World File
	boolean
	Default: 1
  -FILE_KML:<str>           	Create KML File
	boolean
	Default: 0
  -NO_DATA:<str>            	Set Transparency for No-Data
	boolean
	Default: 1
  -COLOURING:<str>          	Coloring
	choice
	Available Choices:
	[0] histogram stretch to standard deviation
	[1] histogram stretch to percentage range
	[2] histogram stretch to value range
	[3] lookup table
	[4] rgb coded values
	Default: 0
  -COL_COUNT:<num>          	Number of Colors
	integer number
	Default: 100
  -COL_REVERT:<str>         	Revert Palette
	boolean
	Default: 0
  -COL_PALETTE:<str>        	Colors Palette
	colors
  -GRADUATED:<str>          	Graduated Colors
	boolean
	Default: 1
  -STDDEV:<double>          	Standard Deviation
	floating point number
	Minimum: 0.000000
	Default: 2.000000
  -LINEAR_MIN:<double>      	Percentage Range
	value range
  -LINEAR_MAX:<double>      	Percentage Range
	value range
  -STRETCH_MIN:<double>     	Value Range
	value range
  -STRETCH_MAX:<double>     	Value Range
	value range
  -SCALE_MODE:<str>         	Scaling
	choice
	Available Choices:
	[0] linear intervals
	[1] increasing geometrical intervals
	[2] decreasing geometrical intervals
	Default: 0
  -SCALE_LOG:<double>       	Geometrical Interval Factor
	floating point number
	Minimum: 0.001000
	Default: 10.000000
  -LUT:<str>                	Lookup Table
	static table
	5 Fields:
	- 1. [color] Color
	- 2. [string] Name
	- 3. [string] Description
	- 4. [8 byte floating point number] Minimum
	- 5. [8 byte floating point number] Maximum
	
  -SHADE_TRANS:<double>     	Transparency
	floating point number
	Minimum: 0.000000
	Maximum: 100.000000
	Default: 75.000000
  -SHADE_COLOURING:<str>    	Histogram Stretch
	choice
	Available Choices:
	[0] Linear
	[1] Standard Deviation
	Default: 0
  -SHADE_BRIGHT_MIN:<double>	Linear
	value range
  -SHADE_BRIGHT_MAX:<double>	Linear
	value range
  -SHADE_STDDEV:<double>    	Standard Deviation
	floating point number
	Minimum: 0.000000
	Default: 2.000000