This is an old revision of the document!
Table of Contents
the command file_open command will add a file to the visual3d workspace. the command is as follows:
file_open /file_name= file_name is the file name or file mask including the path. /file_path= the path string that will be pre-pended to the file_name /search_subfolder= search all subfolders for files matching the filename or file mask !/suffix= text here will be added to the end of the c3d file which is loaded. !/set_prompt= this parameters sets the text in the upper left hand corner of the browse window !/on_file_not_found=prompt !/file_types_on_prompt= this parameter sets the type of files the dialog will show (cmo, c3d, ascii, etc) ; note: if /file_name= is blank, a dialog pops up to allow the user to browse to the file. wildcards (*) can be used in place of the file name.
file_types
the following file types are supported and can be added within visual3d:
- .c3d - c3d file or www.c3d.org]
- .cmo - visual3d workspace file
- .txt - visual3d tab delimited text file
- .gcd - vicon gcd file
- .ndi - ndi aurora file
- .p2d - p2d file
filter
you can filter using the following filter types:
- c3d
- cmo
- vnd
- p2d
- ascii
- xml
- ndi
- gcd
- mvnx
multiple file types can be specified by using a plus sign (ex. c3d+cmo+p2d)
examples
this page lists several examples for this command.
prompt the user for the filename
this example will prompt the user for the files by opening a dialog box for selection.
file_open /file_name= ;
specify the filename
this example specifies the filename explicitly. note that the filename should contain the complete path to the file.
file_open= /file_name= c:\demo_files\walking.c3d ;
specify the filename using wildcards
this example specifies the filename by using a wildcard. all c3d files in the c:\demo_files folder will be opened.
file_open= /file_name= c:\demo_files\*.c3d ;
specify the filename using a pipeline parameter and wildcards
this example uses pipeline parameters to specify the folder containing the data files and uses a wildcard in the filename
set_pipeline_parameter_to_folder_path /parameter_name= data_folder /parameter_value=c:\demo_files ; ! now open the file. file_open= /file_name= ::data_folder&*.c3d ;
specify the filename using the default data folder and wildcards
this example uses pipeline parameters to specify the default data folder containing the data files and uses a wildcard in the filename.
set_pipeline_parameter_to_folder_path /parameter_name= data_folder /parameter_value=visual3d_default_data_folder ; ! now open the file. file_open= /file_name= ::data_folder&*.c3d ;