This functionality is only available for certain module packages. Info / Copyright

Action: exportToGraphics


Parameter

Description

TYPE

Type of task that the action is to perform:
GRAPHICPROJECT: Export project in graphic format (TIF, GIF, PNG, JPG).
GRAPHICPAGE: Export pages in graphic format (TIF, GIF, PNG, JPG).

PROJECTNAME

Project name with complete file path (optional).
If nothing is entered, the selected project will be used if the action is to be run over the user interface (e.g. via the script or ribbon). When executing from the Windows command line, PROJECTNAME must be specified or ProjectAction has to be used before that. Otherwise a system message will appear.

PAGENAME 

Name of the pages to be exported (optional). This parameter has an effect only if the TYPE parameter has the following value: GRAPHICPAGE.

EXPORTSCHEME 

Scheme for graphical export (optional). Supplies the default values for other optional parameters. If this parameter is not available or empty (""), then the most recently used graphical export scheme is used.

DESTINATIONPATH 

Target directory where the graphic data is saved. If this directory does not exist yet, it will be created. Below this directory a new directory with the name of the project is created when exporting a project. It will store the individual graphic files.

FORMAT 

Output format: Supported export formats:

  • BMP: Available color depth: 1, 4, 8, 16, 24 and 32
  • TIF: Available color depth: 1, 4, 8, 24 and 32
  • GIF: color depth is irrelevant
  • PNG: Available color depth: 1, 4, 8, 16, 24 and 32
  • JPG: Available color depth: 1, 4, 8, 16, 24 and 32

This parameter is optional. If nothing is specified, the default value from the scheme settings is used.

COLORDEPTH 

Color depth of image. Possible values are 1, 8, 16, 24 and 32. This parameter is optional. If nothing is specified, the default value from the scheme settings is used.

IMAGEWIDTH 

Width of image in pixels. The height is automatically calculated from the side dimensions. This parameter is optional. If nothing is specified, the default value from the scheme settings is used.

IMAGECOMPRESSION 

Type of compression when outputting in Tiff format. Possible values are LZW, RLE, CCITT3, CCITT4, NONE. This parameter has no effect on the other output formats. For CCITT3, CCITT4 and RLE compression the color depth is always 1, that is, a binary image is created. This parameter is optional. If nothing is specified, the default value from the scheme settings is used.

BLACKWHITE 

The output is in black and white. Note: The image format or image size is not affected by this. This parameter is optional.
Default value: 1 (black and white).

USEPAGEFILTER

Determines whether only filtered pages or all project pages will be used (optional). Default value: 0.

Notes:

  • If a page is stated explicitly via the PAGENAME parameter, only this page will be exported, and the USEPAGEFILTER parameter will be ignored.
  • If no page is explicitly specified via the PAGENAME parameter and the USEPAGEFILTER parameter is set to 1, only the filtered pages in the page navigator are exported.

ClosedExample:

Export a project:

exportToGraphics 
/TYPE:GRAPHICPROJECT 
/PROJECTNAME:C:\Projects\EPLAN\ESS_Sample_Project.elk 
/DESTINATIONPATH:C:\temp 
/FORMAT:BMP 
/COLORDEPTH:24 
/IMAGEWIDTH:1024 
/BLACKWHITE:1

Export a page:

exportToGraphics 
/TYPE:GRAPHICPAGE 
/PROJECTNAME:C:\Projects\EPLAN\ESS_Sample_Project.elk 
/PAGENAME:=EB3+ET1/2 
/DESTINATIONPATH:C:\temp 
/FORMAT:BMP 
/COLORDEPTH:24 
/IMAGEWIDTH:1024 
/BLACKWHITE:1

Export several pages:

exportToGraphics 
/TYPE:GRAPHICPAGE 
/PROJECTNAME:C:\Projects\EPLAN\ESS_Sample_Project.elk 
/DESTINATIONPATH:C:\temp 
/FORMAT:BMP 
/COLORDEPTH:24 
/IMAGEWIDTH:1024 
/BLACKWHITE:1 
/USEPAGEFILTER:1

Export a page. Several default values are imported from an export scheme:

exportToGraphics 
/TYPE:GRAPHICPAGE 
/PROJECTNAME:C:\Projects\EPLAN\ESS_Sample_Project.elk 
/PAGENAME:=EB3+ET1/2 
/EXPORTSCHEME:Bitmap