Differences

This shows you the differences between two versions of the page.

--- visual3d:documentation:pipeline:file_commands:export_3d_animation_to_image [2024/06/19 13:37] – removed sgranger
+++ visual3d:documentation:pipeline:file_commands:export_3d_animation_to_image [2024/07/17 15:45] (current) – created sgranger
@@ Line 1: / Line 1: @@
+====== 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]]