Export C3DFile

The Export_C3DFile command is available in the Visual3D as a way to export a C3D file.

• The manual option is through the Export Menu commands that can be found in the File Menu. A dialog will open and allow you to make selections for how you wish to have the data exported.
• The additional feature of the pipeline command that is not available in the menu command is the ability to use wildcards to export multiple C3D files.

The command below is as seen on the Visual3D application, it has many parameters as there are many options to manipulate this command.

Export_C3DFile
! /OLD_FILE_NAME=
! /NEW_FILE_NAME=
! /DESTINATION_FOLDER=
! /SUFFIX=_
! /CREATE_FOLDER_PATH=FALSE
! /PROMPT_FOR_NEW_FILE=TRUE
! /IF_NEWFILE_EXISTS_REPLACE=FALSE
! /EXPORT_ENDIAN=
! /TRUNCATE_POINT_LABELS=FALSE
! /USE_ORIGINAL_START_FRAME=FALSE
! /EXPORT_START_FRAME=1
! /EXPORT_END_FRAME=EOF
! /EXPORT_PROCESSED_TARGET_DATA=FALSE
! /EXPORT_PROCESSED_ANALOG_DATA=FALSE
! /TRUNCATE_PARAMETER_SECTION=FALSE
/EXPORT_ALL_LANDMARKS=FALSE
! /EXPORT_DIGITIZING_LANDMARKS=FALSE
! /EXPORT_FUNCTIONAL_LANDMARKS=FALSE
! /EXPORT_EMPTY_TARGETS=FALSE
! /EVENT_LABELS=
! /EXPORT_OLD_EVENT_LABELS=FALSE
;

The Export_C3DFile command parameter definitions are found below:

The command can be edited in a text editor or in dialog form. To edit in the dialog, either click on the Edit button in the pipeline workshop, or double-click on the pipeline command. The dialog is shown below:

• File to Export: Dropdown to select the currently loaded motion file (C3D) from the workspace.
• New File Name: Field to define the new exported C3D file name.
• Export Folder: Directory where the exported file will be saved. You can browse to select a location.
• File Suffix: Text suffix added to the original filename.
• Replace File if it Exists: If checked, allows overwriting existing C3D files with the same name.
• Prompt for new file if folder and filename are blank: Ensures a prompt appears if no filename or folder is specified.
• Select Old 4/18 Character Event Labels in Header to Export: Text field or listbox to manually enter or select legacy event labels.
• Export Original First Frame: Maintains the original file's start frame (otherwise export starts at frame 1 or a specified value.
• Export All Landmarks as Targets: Includes digitized anatomical landmarks in the export as regular target points.
• Export Functional Joint Landmarks as Targets: Exports joint center landmarks as target markers.
• Export Unnamed and Empty Targets: Includes targets that do not have reliable tracking or are unnamed.
• Export Processed Target Data: Exports the filtered or otherwise processed marker data instead of raw target signals.
• Export Processed Analog Data: Exports processed analog signals (e.g., filtered EMG) instead of raw analog data.
• 4 Character Labels: If checked, trims target names to four characters for older software compatibility.
• Truncate Parameters Section: Reduces the parameter section to the minimum required set (useful for older systems or simpler exports).
• Export Old 4/18 Character Event Labels in Header: Uses older event label format in the C3D header for compatibility with legacy systems.
• Endian: Dropdown to select the endian format (PC, VAX, SGI) for the binary C3D output.
• Export Start Frame: Specifies which frame of the motion file to begin exporting.
• Export End Frame: Specifies the final frame to export. Default is EOF (End of File).

The following examples will go through the use of the Export_C3DFile command in the Visual3D application.

Only a START_FRAME and an END_FRAME are available as parameters for the export command. To export between EVENT_LABELS:

Set_Pipeline_Parameter_From_Expression
/PARAMETER_NAME=START_FRAME
/EXPRESSION=1+EVENT_LABEL::ORIGINAL::START*PARAMETERS::POINT::RATE
/AS_INTEGER=TRUE
;
Set_Pipeline_Parameter_From_Expression
/PARAMETER_NAME=ENDFRAME
/EXPRESSION=1+EVENT_LABEL::ORIGINAL::END*PARAMETERS::POINT::RATE
/AS_INTEGER=TRUE
;

Export_C3DFile
/OLD_FILE_NAME=C:\Demo Files\CaseAMD\amd001.c3d
/NEW_FILE_NAME=test.c3d
/DESTINATION_FOLDER=Z:\scottselbie 1\Desktop\test\
/SUFFIX=
/EXPORT_ENDIAN=1
! /TRUNCATE_POINT_LABELS=FALSE
! /USE_ORIGINAL_START_FRAME=FALSE
/EXPORT_START_FRAME=::START_FRAME
/EXPORT_END_FRAME=::END_FRAME
! /EXPORT_PROCESSED_TARGET_DATA=FALSE
! /EXPORT_PROCESSED_ANALOG_DATA=FALSE
! /TRUNCATE_PARAMETER_SECTION=FALSE
/EXPORT_ALL_LANDMARKS=FALSE
! /EXPORT_DIGITIZING_LANDMARKS=FALSE
! /EXPORT_FUNCTIONAL_LANDMARKS=FALSE
! /EXPORT_EMPTY_TARGETS=FALSE
! /EVENT_LABELS=
! /EXPORT_OLD_EVENT_LABELS=FALSE
;

This example will export all C3D files in the Workspace

Export_C3DFile
/Old_File_Name= *.c3d
!/New_File_Name=
/Destination_Folder=
/Suffix=
!/Export_Endian=
!/Truncate_Point_Labels=
!/USE_ORIGINAL_START_FRAME=FALSE
!/EXPORT_START_FRAME=1
!/EXPORT_END_FRAME=EOF
!/Export_Processed_Data= false
!/Truncate_Parameter_Section=false
!/Export_Junk_Targets=false
!/Export_Old_Event_Labels=false
!/Event_Labels=
;

Note that the /Destination_Folder= is not specified in the command above. To have control over the destination folder for the exported C3D file, the entire path to the exported file should be specified. Often this is done by adding a pipeline command to prompt the user for the Folder Path.

! This will allow the user to set the folder path for the destination files
Set_Pipeline_Parameter_To_Folder_Path
/PARAMETER_NAME= FOLDER
/PARAMETER_VALUE=
;

! Export all C3D files in the Workspace to the Folder path specified by the user
Export_C3DFile
/Old_File_Name= *.c3d
!/New_File_Name=
/Destination_Folder=::FOLDER
/Suffix=
!/Export_Endian=
!/Truncate_Point_Labels=
!/USE_ORIGINAL_START_FRAME=FALSE
!/EXPORT_START_FRAME=1
!/EXPORT_END_FRAME=EOF
!/Export_Processed_Data= false
!/Truncate_Parameter_Section=false
!/Export_Junk_Targets=false
!/Export_Old_Event_Labels=false
!/Event_Labels=
;

If /Export_Processed_Data= TRUE, Visual3D exports only data from the TARGET PROCESSED folder.

If there are no signals in the PROCESSED folder, the exported C3D file will contain no POINT data.

! This will allow the user to set the folder path for the destination files
Set_Pipeline_Parameter_To_Folder_Path
/PARAMETER_NAME= FOLDER
/PARAMETER_VALUE=
;

! Export all C3D files in the Workspace to the Folder path specified by the user
! Visual3D exports only data from the TARGET PROCESSED folder
Export_C3DFile
/Old_File_Name= *.c3d
!/New_File_Name=
/Destination_Folder=::FOLDER
/Suffix=
!/Export_Endian=
!/Truncate_Point_Labels=
!/USE_ORIGINAL_START_FRAME=FALSE
!/EXPORT_START_FRAME=1
!/EXPORT_END_FRAME=EOF
/Export_Processed_Data= TRUE
!/Truncate_Parameter_Section=false
!/Export_Junk_Targets=false
!/Export_Old_Event_Labels=false
!/Event_Labels=
!/Number_Of_Frames_To_Export=ALL
;

Back to Pipeline Commands Reference