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]
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