Utilities Guide > Toon Boom Utilities Guide > Chapter 2: Utilities > utransform Utility

utransform Utility

The utransform program converts vector images to pixmaps, and between different pixmap file formats. For example, you can use utransform to convert a TGA to an SGI file. Or, you can convert a TVG file to a Photoshop PSD file.

Here is the format you must follow when using utransform:

$ utransform -file [file name, including extension] [options]

Here are the available utransform options:

 

COMMAND

ACTION

OPTIONS

 

-outformat <format>

This is the file type you want to output with utransform.

The following are the file formats supported by utransform: TGA, TGA1, TGA3, TGA4, SGI, SGI1, SGI3, SGI4, SGIDP3, SGIDP4, OMFJPEG, OPT, OPT1, OPT3, OPT4, PSD, PSD1, PSD3, PSD4, PSDDP3, PSDDP4, YUV, PAL, and SCAN.

-outfile <name>

This option is for the file name of the output file.

If you are processing multiple files, you will not be able to control their final name. If not specified, the files created by utransform will have the same file name as the original. The only difference will be the file extension.

-debug

This option will display information on the different steps of the process as well as the messages related to errors that might have occurred.

-?|-h|-help|--help

This option will display the help information.

-v|-version|--version

This option will display the version information.

IMAGE OPTIONS

 

-resolution <w> <h>

This option manages vector and pixmap input files. It indicates the height and width of the output file.

-resolution scan

This option will use the.scan info to determine the drawing resolution when unvectorizing from the Control Centre.

-scale <s>

Use this option to scale the height and the width of the output file by the value you enter.

The resolution of the image must be able to accommodate the new image size.

-xscale <s>

Use this option to scale the width of the output file.

The resolution of the image must be able to accommodate the new image size.

-yscale <s>

Use this option to scale the height of the output file.

The resolution of the image must be able to accommodate the new image size.

-turn <degrees>

Use this option to rotate the output file by the amount of degree entered.

-ps <in> <out>

Use this option to convert the shape of the pixel.

This option inputs and outputs pixel shapes for formats other than YUV and PAL.

The possible values are: square, NTSC and PAL.

-bgcolor <r> <g> <b>

This option defines the background colour for TVG images.

The range is either 0-1 (a percentage of 255) or 0 - 255. The default value is white.

-bgalpha <a>

This is the alpha value of the background.

The range is either 0-1 or 0 - 255. The default value is opaque (255).

VECTOR OPTIONS

 

-antialiasing <quality><exponent>

quality = low, medium-low, medium or high exponent = between 0-3

This option is for converting vector images to pixmaps.

You can specify the quality of the anti-aliasing process (low, medium-low, medium or high) or the exponent (between 0-3).

-nolinetexture

This disables the generation of line textures from TVG files.

-nolineart

Use this option to exclude line art from the output file.

-nocolorart

Use this option to exclude colour art from output file.

-move <x> <y>

Use this option to recentre the output file, output pixels or world units for TVG output

Note: Useful values for TVG output might be
714.285000 in x or 535.713750 in y

-flatten

Use this option to flatten the drawing and merge its textures.

By default the output file format is TVG.

-bboxtvgincrease

This option will increase the .tvg bonding box size. The default value is 5 (percent).

-normalize

This option normalizes the TVG. This implies that the outformat is TVG.

If the TVG has a different scaling than 1, it will scale the coordinates and set the scaling to 1.0.

-setfieldsize <f>

Use this option to set the internal scaling of the TVG to an exact field size.

VECTOR TO VECTOR OPTIONS

 

-centreline

Use this option to extract the centreline of the drawing’s line art.

-closegap

Use this option to perform Close gap.

-gaplength

Use this option to define a Close gap length value.

The default value is 10.

-hairpasses

Use this option to set the number of pass to perform for the remove hair option. The default value is 2.

-hairlength

Use this option to define the value for the hair length. The default is 20.

-keepcolorart

Use this option to keep the existing colour art and extract the centreline over it.

-showstrokes

Use this option to show the contour of line art and centrelines in special colours.

-thickness

Use this option to define the thickness in pixels of the strokes to show.

-fieldsize <fs>

Use this option to set the field size for PDF output.

The default field size is 12.

-lineartstrokescolor <r> <g> <b> <a>

Use this option to define the red, green, blue, alpha values for the line art stroke colour.

-colorartstrokescolor <r> <g> <b> <a>

Use this option to define the red, green, blue, alpha values for the colour art stroke colour.

-nofitcolorart

Use this option if you do NOT want to generate Bezier curves for colour art.

-tvgversion <version>

This option will convert to older/supported vector format product version:

v720 = 1005

v710 = 1005

v702 = 1004 (Early version of 7.0.2 were using1003.)

v700 = 1003

ALIGNMENT OPTIONS

 

-align <RULE>

Use this option to generate a bitmap that will fit inside Harmony with a read module aligned with a defined rule.

RULE can be: AS_IS, CENTER_TB, CENTER_LR, CENTER_FIRST_PAGE_HORIZONTAL, CENTER_FIRST_PAGE_VERTICAL, TOP, BOTTOM, LEFT, RIGHT.

-dpi <dpi>

Use this option to define the output resolution for the bitmap image in dots per inch.

The default resolution is 75 dpi.

-sar <scene_aspect_ratio>

This option sets the scene aspect ratio, the default is 1.33333. Use 1.7777777 for 16/9 scenes. The scene aspect ratio can be read from the scene alignment dialog. Beware, that this is not the ratio of the scene resolution.