Running 3D Text Commander from command prompt
To run 3D Text Commander in the command-line mode:
- Click on the Start button on your Desktop and then select Run... on the menu that appears.
- In the Run Application window that appears, click on the Browse... button,
navigate to the 3D Text Commander home folder and select the application executable.
- Type necessary keys and options and then click OK.
Batch mode
Parsing large amounts of data - multiple projects with multiple images - is
much more productive with command line options. Simply run the application
with necessary keys in the Command Prompt window, then sit back and relax -
the job will be completed automatically.
Command-line options and commands
3DTextCommander.exe -b project_file [-r]
[-result image_file]
[-front[_N] image_file]
[-text[_N] text_to_render]
[-find[_N] text_to_replace]
[-color[_N] value]
[-zoom value]
[-shadow on|off]
[-reflection on|off]
[-background value]
[-imagewidth value]
[-imageheight value]
[-imagemarginx1 value]
[-imagemarginx2 value]
[-imagemarginy1 value]
[-imagemarginy2 value]
[-imagemarginx value]
[-imagemarginy value]
[-imagemargin value]
[-imagesizeincludemargin]
[-imagedpi value]
[-imageformat value]
where:
You can use mask only in one place; i.e., you cannot use it in both project name and image name.
The following substitution can be used in text:
The following substitutions can be used in file names:
If you use mask in an image file name, the following substitutions can be used in other image file names:
Examples:
where:
| Parameter | Alt. name | Description |
|---|---|---|
| project_file | project file name or mask for multiple files (*.cpj, for example); | |
| -r | recursive folder scanning - when used with project or image file mask; | |
| -result image_file | -res image_file | output image file name; |
| -front[_N] image_file | -s0[_N] image_file | front-side image file name (for Nth object, if it is required) or mask for multiple files (*.png, for example); |
| -text[_N] text_to_render | text to render; | |
| -find[_N] text_to_replace | text to be found and replaced by -text value (if it is required). For multiple replacements, use the || delimiter (see examples); | |
| -color[_N] value | -c[_N] value | set object color, value - hex format RRGGBB or auto; |
| -zoom value | -z value | set zoom value; |
| -shadow on|off | -sh on|off | enable/disable shadow; |
| -reflection on|off | -rf on|off | enable/disable reflection; |
| -background value | -bg value | set background color, value - hex format RRGGBB; |
|
-imagesizeincludemargin -imagewidth value -imageheight value -imagemarginx1 value -imagemarginx2 value -imagemarginy1 value -imagemarginy2 value -imagemarginx value -imagemarginy value -imagemargin value -imagedpi value -imageformat value |
-is -iw value -ih value -imx1 value -imx2 value -imy1 value -imy2 value -imx value -imy value -im value -id value -if value | set properties for output image. |
You can use mask only in one place; i.e., you cannot use it in both project name and image name.
The following substitution can be used in text:
- {_3DTEXT_BR_} - new line.
The following substitutions can be used in file names:
- {PROJECT_FILE} - project file base name (without extension);
- {PROJECT_PATH} - path to project file.
If you use mask in an image file name, the following substitutions can be used in other image file names:
- {IMAGE_FILE} - image file base name (without extension);
- {IMAGE_PATH} - path to image file.
Examples:
- Sample of the path to 3DTextCommander.exe:
"C:\Program Files (x86)\Insofta 3D Text Commander\3DTextCommander.exe"
- "_Path_\3DTextCommander.exe" -b c:\work\menu.3pj
- "_Path_\3DTextCommander.exe" -b c:\work\menu.3pj -front c:\work\*.png -result {IMAGE_FILE}_res.png
- "_Path_\3DTextCommander.exe" -b c:\work\*.3pj
- "_Path_\3DTextCommander.exe" -b c:\work\menu.3pj -text Support{_3DTEXT_BR_}Form
- In this example, the strings "Year" for "New Year" and "2017" for "2018" will be replaced:
"_Path_\3DTextCommander.exe" -b c:\work\menu.3pj -find "Year||2017" -text "New year||2018"
-
In the last example, image file "{PROJECT_PATH}{PROJECT_FILE}_res.png" will be substituted by "c:\work\site\menu1_res.png" for project "c:\work\site\menu1.3pj":
"_Path_\3DTextCommander.exe" -b c:\work\*.3pj -r -result {PROJECT_PATH}{PROJECT_FILE}_res.png
Related topics
3D Text Commander