Software Companions - PDF, DWF, PLT and TIFF Viewing and Conversion Software

ViewCompanion
Conversion Configuration File Description

A conversion configuration file can be used to override most of the settings used by ViewCompanion during conversion.
A configuration file can be used in combination with the /ci and /cmi command line options.


The file format is very simple and uses a set of recognized keywords, as described below.
The file must start with the following header:


[ViewCompanion Convert Configuration]


Then one or more statements, using the following keywords, can be included:


ADDMARGINS=ON/OFF
If set to ON, margins will be added to the converted file.
Use the MARGINLEFT, MARGINTOP, MARGINLEFT and MARGINBOTTOM to define the size of these margins.


ADJUSTCOLORS=ON/OFF
If set to ON, colors close to active background color will be inverted.
If this option is enabled and you're converting a drawing with white color on white background, the color will be set to black instead.


ARCRES=60
Sets the number of line segments used for drawing a full circle. The higher the number, the smoother a circle will appear.
This option is used for raster file output, or if the destination format doesn't support circles or arcs.


CREATEMULTIFILE=ON/OFF
If set to ON, multiple files with one page each will be created if the source file is a multipage file.


CREATEMULTIPAGE=ON/OFF
If set to ON, a multipage destination file will be created if the source file is a multipage file.


CUSTOMBACKCOLOR=0
Change the custom background color.
Select the background color to use for conversion with the SETBACKCOLORINDEX keyword.


DWFCOMPRESSION=ON/OFF
If set to ON, DWF compression will be enabled. Set to OFF to create uncompressed DWF files.


DXFMM=ON/OFF
If set to ON, DXF files will be written using metric coordinates even if the current measurements are set to Imperial (inch).


DXFR12=ON/OFF
If set to ON, DXF files compatible with AutoCAD R12, this can be useful if your CAD application cannot read the newer DXF variants.
Set this setting to OFF to create AutoCAD 2000 and newer compatible DXF files.


JPEGPROGRESSIVE=1
Enable or disable creation of progressive JPEG files. Set to 1 to enable progressive JPEG files or set to 0 to disable this feature.
The default value is 0.


JPEGQUALITY=75
Set compression level for exported JPEG files. The value must be between 0 (no compression) and 100 (highest compression). A higher value will make smaller files, but the quality will be lower due to data loss.
The default value is 75.


KEEPPAPERANDCENTER=ON/OFF
If enabled the exported file will use the actual selected paper size and center the image.


LANDSCAPE=ON/OFF
If set to ON, the selected paper size will be rotated to landscape mode. Paper sizes are by default in portrait mode.


LOGFILE=ON/OFF
If set to ON, a log file will be created.


LOGFILEFOLDER="C:\folder"
If this option is used all log files will be placed in the given folder.


LOGFILEUNIT=0
Can be 0 (mm) or 1 (inches).


MARGINBOTTOM=0.2
Set the bottom margin in inch. This setting is only used if ADDMARGINS is enabled.


MARGINLEFT=0.2
Set the left margin in inch. This setting is only used if ADDMARGINS is enabled.


MARGINRGHT=0.2
Set the right margin in inch. This setting is only used if ADDMARGINS is enabled.


MARGINTOP=0.2
Set the top margin in inch. This setting is only used if ADDMARGINS is enabled.


MONOCHROME=ON/OFF
If set to ON, the converted file will use only black and white colors.


PAPERSIZE=A3
Select the paper size to use for conversion.
Below is a table that lists the available paper formats:

A0(841 x 1189 mm)
A1(594 x 841 mm)
A2(420 x 594 mm)
A3-Extra(322 x 445 mm)
A3(297 x 420 mm)
A4-Extra(236 x 322 mm)
A4-Plus(210 x 330 mm)
A4(210 x 297 mm)
A5-Extra(174 x 235 mm)
A5(148 x 210 mm)
A6(105 x 148 mm)
B0(1000 x 1414 mm)
B1(707 x 1000 mm)
B2(500 x 707 mm)
B3(353 x 500 mm)
B4(250 x 353 mm)
B5-Extra(201 x 276 mm)
B5(176 x 250 mm)
B6(125 x 176 mm)
C6(162 x 229 mm)
Engineering-A(8.5 x 11 inch)
Engineering-B(11 x 17 inch)
Engineering-C(17 x 22 inch)
Engineering-D(22 x 34 inch)
Engineering-E(34 x 44 inch)
Architectural-A(9 x 12 inch)
Architectural-B(12 x 18 inch)
Architectural-C(18 x 24 inch)
Architectural-D(24 x 36 inch)
Architectural-E(36 x 48 inch)
Architectural-E2(30 x 42 inch)
Letter(8.5 x 11 inch)
Legal(8.5 x 14 inch)
Tabloid(11 x 17 inch)
Slide(11 x 7.33 inch)
Ledger(17 x 11 inch)
Executive(7.25 x 10.5 inch)
Statement(5.5 x 8,5 inch)
A1F(594 x 1189 mm)
A3F(297 x 594 mm)

PDFALEVEL=1
Select PDF conformance level to use for converted files if PDFSTANDARD is set to 1 (see below).
The following options are available:

  1. PDF/a-1b
  2. PDF/a-2b (default)
  3. PDF/a-3b
  4. PDF/a-2u
  5. PDF/a-3u
  6. PDF/a-4
  7. PDF/a-4e

PDFCOMPRESSION=ON/OFF
If set to ON, PDF compression will be enabled. Set to OFF to create uncompressed PDF files.


PDFSTANDARD=1
Select PDF standard to use for converted files.
The PDF/A conformance level to use can be set by the PDFALEVEL command described above.
The following options are available:

  1. PDF 1.7 (editable)
  2. PDF/A (for archiving)

PDFTRANSPARENCY=ON/OFF
Enable or disable the use of transparency in converted PDF files. Please note that some printer drivers don't support transparency, and will run a time consuming flattening process before the printing can complete.
Disable PDF transparency to avoid this problem.


PENTABLE=pentablefilename
Convert the file using the given pentable.


PNGCOMPRESSION=6
Set compression level for exported PNG files. The value must be between 0 (no compression) and 9 (highest compression). A higher value will make smaller files, but the compression will take longer time. The default value is 6.


RASTERDPI=200
Sets the dots per inch to use when converting to raster formats.


RASTERBPP=1
Sets the number of bits per pixels to use when converting to raster formats.
Allowed values:

  1. Monochrome
  2. 16 Color
  3. 256 Color
  4. True Color
  5. True Color with Alpha (BMP, PNG, WEBP and TIFF)

ROTATION=90
Sets the rotation of the plot. Accepted values are 0, 90,180 and 270.


SCALE=100
Sets the scale to use for conversion Accepted value are an integer (percentage), for example use you can 100 to keep the original drawing size.


SCALEPENTABLE=ON/OFF
If set to ON the pentable will be scaled with the drawing.


SCALINGTYPE=0
Set the scaling type to use. If set to 0 (zero), the SCALE parameter will be used.
If the scaling type is set to 1, the converted file will be scaled to fit the selected PAPERSIZE.
If the scaling type is set to 2, the USERWIDTH and USERHEIGHT parameters decide the size of the converted file.


SETBACKCOLORINDEX=0
Select the background color index to use, following values are valid:

  1. White background color
  2. Black background color
  3. Select custom background color (set the actual color by using CUSTOMBACKCOLOR)

SVGCOMPRESSION=ON/OFF
If set to ON, SVG compression will be enabled. Set to OFF to create uncompressed SVG files (svgz).


TEXTPENTABLE=ON/OFF
If set to ON, pen table will also affect HPGL text entities (LB).


TIFFCOMPRESSION=1
Compression to use for converted TIFF files.
Following values are available:

  1. Uncompressed
  2. CCITT RLE (only valid if RASTERBPP is 1)
  3. CCITT G3 (only valid if RASTERBPP is 1)
  4. CCITT G4 (only valid if RASTERBPP is 1)
  5. LZW

TIFFSINGLESTRIP=ON/OFF
If enabled, the created TIFF files will contain only a single strip of image data.
Single strip files will be smaller in file size, but may be slower to read and access, depending on the application reading the TIFF file.


USEBACKCOLOR=ON/OFF
If set to ON, the selected background color will be used.


USEFILEPAPERSIZE=ON/OFF
If enabled the original paper size, if available, will be used instead of the calculated extents of all drawing entities.


USERHEIGHT=11
Set the user defined height in inches to use for the converted file.


USERWIDTH=8.5
Set the user defined width in inches to use for the converted file.


USEROINSTRUCTION=ON/OFF
Some HPGL-2 files contain a RO (Rotation) instruction that controls the rotation of the drawing.
Enable this option to use the rotate instruction when converting the file.


Sample config file:

[ViewCompanion Convert Configuration]
PENTABLE=c:\vc\default.vpt
SCALE=100
SCALINGTYPE=0
MONOCHROME=ON