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 -outformat [options] [file name, including extension]
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. |
-crop | Outputs part of a tvg where the lines are. A bitmap of the bounding box around those lines is output as well as an XML file with the position of that bitmap in relation to the Camera view. |
-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 |
-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 node 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. |