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 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
	Colouring	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
	Color Palette	Choice	`COL_PALETTE`	-	Available Choices: [0] DEFAULT [1] DEFAULT_BRIGHT [2] BLACK_WHITE [3] BLACK_RED [4] BLACK_GREEN [5] BLACK_BLUE [6] WHITE_RED [7] WHITE_GREEN [8] WHITE_BLUE [9] YELLOW_RED [10] YELLOW_GREEN [11] YELLOW_BLUE [12] RED_GREEN [13] RED_BLUE [14] GREEN_BLUE [15] RED_GREY_BLUE [16] RED_GREY_GREEN [17] GREEN_GREY_BLUE [18] RED_GREEN_BLUE [19] RED_BLUE_GREEN [20] GREEN_RED_BLUE [21] RAINBOW [22] NEON [23] TOPOGRAPHY [24] ASPECT_1 [25] ASPECT_2 [26] ASPECT_3 Default: 0
	Number of Colors	Integer	`COL_COUNT`	-	Default: 100
	Revert Palette	Boolean	`COL_REVERT`	-	Default: 0
	Graduated Colors	Boolean	`GRADUATED`	-	Default: 1
	Standard Deviation	Floating point	`STDDEV`	-	Minimum: 0.000000 Default: 2.000000
	Percentage Range	Value range	`LINEAR`	-	-
	Value Range	Value range	`STRETCH`	-	-
	Scaling	Choice	`SCALE_MODE`	Scaling applied to colouring 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	`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	`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	`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_KML <str>] [-NO_DATA <str>] [-COLOURING <str>] [-COL_PALETTE <str>] [-COL_COUNT <num>] [-COL_REVERT <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_KML:<str>           	Create KML File
	Boolean
	Default: 0
  -NO_DATA:<str>            	Set Transparency for No-Data
	Boolean
	Default: 1
  -COLOURING:<str>          	Colouring
	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_PALETTE:<str>        	Color Palette
	Choice
	Available Choices:
	[0] DEFAULT
	[1] DEFAULT_BRIGHT
	[2] BLACK_WHITE
	[3] BLACK_RED
	[4] BLACK_GREEN
	[5] BLACK_BLUE
	[6] WHITE_RED
	[7] WHITE_GREEN
	[8] WHITE_BLUE
	[9] YELLOW_RED
	[10] YELLOW_GREEN
	[11] YELLOW_BLUE
	[12] RED_GREEN
	[13] RED_BLUE
	[14] GREEN_BLUE
	[15] RED_GREY_BLUE
	[16] RED_GREY_GREEN
	[17] GREEN_GREY_BLUE
	[18] RED_GREEN_BLUE
	[19] RED_BLUE_GREEN
	[20] GREEN_RED_BLUE
	[21] RAINBOW
	[22] NEON
	[23] TOPOGRAPHY
	[24] ASPECT_1
	[25] ASPECT_2
	[26] ASPECT_3
	Default: 0
  -COL_COUNT:<num>          	Number of Colors
	Integer
	Default: 100
  -COL_REVERT:<str>         	Revert Palette
	Boolean
	Default: 0
  -GRADUATED:<str>          	Graduated Colors
	Boolean
	Default: 1
  -STDDEV:<double>          	Standard Deviation
	Floating point
	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
	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
	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
	Minimum: 0.000000
	Default: 2.000000