EXPORT_IMAGE array

MATRIX Array Level: 1

The EXPORT_IMAGE array exports an image file. Only one image file is exported per EXPORT_IMAGE array.

Note

If you wish to export multiple images at once use FOLDER (instead of FILE).

When exporting image files, RELATIVE paths are always preferred and much safer.

Fields in the EXPORT_IMAGE array

	Description
JOB=NAME	Assign Job to export. Required. Dynamic Job References are also supported.
FILE=LOCATION	File location for the exported image. The single image file will contain all included_layers. The path may be either Absolute or Relative. (IMPORTANT: When exporting, RELATIVE paths are always preferred and much safer).
FOLDER=LOCATION	Path for the exported image file(s). Each layer (from included_layers) will be output as a separate file. This is an excellent way to generate a separate image for each layer. The folder path may be either Absolute or Relative. (IMPORTANT: When exporting, RELATIVE paths are always preferred and much safer).
WIDTH=NUM	Export Image Width in Pixels. (default: 800)
UNITS=MM|INCH	Optional. Defines Units for the Zoomed-in area to use. This can be helpful to magnify specific areas or 'realtime zoom diplay' for online viewers. Left, Bottom, Right, Top must be comma separated. (default: 0,0,0,0 is used then entire extents). This is OPTIONAL and only used when someone wishes to create a magnified image using ZOOMBOX. (default units: MM)
ZOOMBOX=L,B,R,T	Optional. Creates a magnified area to use for the Image. This can be helpful to magnify specific areas of a design or for 'realtime zoom diplay' with online viewers. Left, Bottom, Right, Top must be comma separated. (default: 0,0,0,0 is used then entire extents). This is OPTIONAL and only used when someone wishes to create a zoomed-in/out image. UNITS must be defined before ZOOMBOX or else millimeter will be used.
OMIT_LAYERS=NAME	Optional. Layers to ignore. Must be comma separated. (Default is All layers are included).
INCLUDE_LAYERS=NAME	Optional. Layers to include. Must be comma separated. (Default is All layers are included).
EXTENSION=NAME	Determine image type to export. Choose from: GIF, BMP, PNG, JPG, TIF. (Default is PNG). Only useful when exporting images to a folder.
BACKGROUND=BLACK|WHITE	Assign the background color for the generated images. (Default is BLACK).

Example EXPORT_IMAGE Array:

# Export image of All Layers using the design extents
EXPORT_IMAGE {
   JOB=PowerPointDino
   FILE=PowerPointDino/Image/ImageExtents.png
   WIDTH=800
   BACKGROUND=white
}
 
 
# Export image of All Layers with a Zoomed-in view of design using extents: 0.5,0.5(mm) by 82,57(mm)
EXPORT_IMAGE {
   JOB=PowerPointDino
   FILE=PowerPointDino/Image/ImageZoomNoPreview.png
   WIDTH=800
   UNITS=MM
   ZOOMBOX=0.5,0.5,82,57.0
   BACKGROUND=black
}
 
 
# Export all images to a relative folder MyImages.
EXPORT_IMAGE {
   JOB=@active
   FOLDER=MyImages
   WIDTH=1200
   EXTENSION=jpg
   BACKGROUND=white
}