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 DOS 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] [-imagedpi value] [-imageformat value]

where:

  • project_file - project file name or mask for multiple files (*.3pj, for example);
  • -r - recursive folder scanning - when used with project or image file mask;
  • -result image_file - output image file name;
  • -front[_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 - set color (hex format);
  • -zoom value - set zoom value;
  • -shadow on|off - enable/disable shadow;
  • -reflection on|off - enable/disable reflection;
  • -background value - set background color (hex format);
  • -image... 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_NAME} - 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_NAME} - image file base name (without extension);
  • {IMAGE_PATH} - path to image file.

Examples:

  • Sample of the path to 3DTextCommander.exe:

    "C:\Program Files\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