2.7.10 expImage

1 Menu Information
2 Brief Information
3 Command Line Usage
4 X-Function Execution Options
5 Variables
6 Description
7 Examples
8 Related X-Functions

Menu Information

File: Export: Image
(When Matrix window is active)

Brief Information

Export image to file

Command Line Usage

1. expImage fname:="c:\flower";

2. expImage im:=[Mbook1]1 type:=tif fname:=c:\flower;

3. expimage -t mytheme f:="c:\ExportedUsingTheme";

X-Function Execution Options

Please refer to the page for additional option switches when accessing the x-function from script

Variables

Display Name	Variable Name	I/O and Type	Default Value	Description
Input Matrix	im	Input MatrixObject	<active>	The image to export. The default is the active image.
File Type	type	Input int	bmp	Specify the export type. Option list bmp:BMP Export to BMP file. gif:GIF Export to GIF file. jpg:JPG Export to JPG file. pcx:PCX Export to PCX file. png:PNG Export to PNG file. psd:PSD Export to PSD file. tga:TGA Export to TGA file. tif:TIF Export to TIF file.
File Name	fname	Input string	fname$	Specify the path and filename of the exported image. If file extension is omitted, it will be appended according to the file type.
Image Settings	tr	Input TreeNode	<unassigned>	Specify the image settings. Note that different settings are available for different file types. For all types, you can specify the DPI resolution and color depth. When JPG is selected for File Type, you can further specify the compression ratio. As for TIFF, both the color space and compression method are available. See more details in Description table

Description

The expImage function exports a matrix object as an image file. The matrix object of any data type can be used as input, but it might be converted to another data type according to the settings and output type.

Eight export file types (BMP, GIF, JPEG, TIFF etc) are supported. Users can choose among them according to their needs. In addition, the TIFF file format includes an Export as Grayscale GeoTIFF output option with separate treenode settings.

You can also specify DPI resolution, color depth, etc. using the Image Settings tree in the dialog. Please select a file type before you use this tree, because different settings are available for different file types.

Details on TreeNode Dialog Options

Image Settings (tr)

Please see this page for details by file type.

Please see this page for details of grayscale GeoTIFF export.

Examples

1. The following example exports the active matrix object as a JPEG image file (c:\test.jpg):

a. From the Origin menu, select File: Export: Image. This opens the expASC dialog for you to tweak the export options.

b. Use the File Type drop-down list to select "Joint Photographic Experts Group *.jpg". Enter "c:\test.jpg" for File Name. Click Ok to close the dialog.

2. The following script command exports the active matrix object as a BMP file (c:\test.bmp) without opening the dialog:

expImage fname:="c:\test.bmp" type:=0;