User Tools

Site Tools


visual3d:documentation:pipeline:file_commands:export_3d_animation_to_image

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

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

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 File Menu Item]


Back to Pipeline Commands Reference

visual3d/documentation/pipeline/file_commands/export_3d_animation_to_image.txt · Last modified: 2024/07/17 11:45 by sgranger