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:

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	-t[_N] text_to_render	text to render;
-find[_N] text_to_replace	-f[_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