====== Export 3D Animation To Image ======

Export a snapshot of the 3D viewer and save the file to disk.

  * multiple files in the workspace can be selected
  * multiple frames of data can be exported to individual files

**Note: if there are multiple output files (either because of multiple files or multiple frames), the name of the file is used as a prefix on the output file and the frame number is appended.**
==== Contents ====



  * [[#Pipeline_Command|1 Pipeline Command]]
    * [[#Exporting_one_image|1.1 Exporting one image]]
    * [[#Exporting_multiple_images|1.2 Exporting multiple images]]
  * [[#Version_4_Implementation|2 Version 4 Implementation]]


==== Pipeline Command ====

**Export_3D_Animation_To_Image**
/FILE_NAME=
/IMAGE_FILE_NAME=
/APPEND_FRAME_TO_FILENAME=
/START_FRAME=1
/END_FRAME=
/EVENT_SEQUENCE=
/EXCLUDE_EVENTS=
/OUTPUT_WIDTH=640
/OUTPUT_HEIGHT=480
**;**
=== Exporting one image ===

In the following example:

  * One Image is exported from the first file that matches the wildcard specificat
  * Frame 10 is exported
  * The output file is specified using the IMAGE_FILE_NAME parameter

\\


**Export_3D_Animation_To_Image**
/FILE_NAME=*2.c3d
/IMAGE_FILE_NAME=Z:\temp\outImage.png
/APPEND_FRAME_TO_FILENAME=FALSE
! /IMAGE_FORMAT=png
/START_FRAME=10
/END_FRAME=
/EVENT_SEQUENCE=
/EXCLUDE_EVENTS=
! /OUTPUT_WIDTH=640
! /OUTPUT_HEIGHT=480
**;**
{{:ExportImageDlg2.jpg}}
{{:mvc002_61.png}}
=== Exporting multiple images ===

In the following example:

  * Images are exported from all files in the workspace.
  * Frames 1 and 2 are exported
  * All frames within the Event_Sequence (LHS-LTO) are exported
  * The target folder for the files is specified using the IMAGE_FILE_NAME parameter
  * The exported file contains the name of the original file appended with the frame number

\\


**Export_3D_Animation_To_Image**
/FILE_NAME=*.c3d
/IMAGE_FILE_NAME=Z:\temp\
/APPEND_FRAME_TO_FILENAME=TRUE
/START_FRAME=1
/END_FRAME=2
/EVENT_SEQUENCE=LHS+LTO
/EXCLUDE_EVENTS=
/OUTPUT_WIDTH=640
/OUTPUT_HEIGHT=480
**;**
{{:ExportImageDlg.jpg}}
==== Version 4 Implementation ====

Export a snapshot of the 3D viewer and save the file to disk.

in Version 4:

  * only one file in the workspace can be selected
  * only one frame of data can be exported
  * only one exported filename can be specified.

**Export_3D_Animation_To_Image**
! /FILE_NAME=
! /IMAGE_FILE_NAME=
! /FRAME=1
! /OUTPUT_WIDTH=640
! /OUTPUT_HEIGHT=480
**;**
This is consistent with the export option under the [[[https://www.c-motion.com/v3dwiki/index.php?title=Menus#File_Menu|File Menu Item]]]

\\
[[Visual3D:Documentation:Pipeline:General_Information:Pipeline_Commands_Reference|Back to Pipeline Commands Reference]]