Running 3D Text Commander from command prompt


To run 3D Text Commander in the command-line mode:

  1. Click on the Start button on your Desktop and then select Run... on the menu that appears.

  2. 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.

  3. 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

Related topics