GTX logo
Welcome to GTX
YouTube Logo
GTX Customer Support

GTXImage CAD Series and GTXRaster CAD Series, All Versions:

GTXRAST.CFG - Editable Configuration File

A user editable configuration file exists within the main program folder for each installation of every version of GTXImage CAD and GTXRaster CAD. This text file, named gtxrast.cfg, may be edited in Notepad, Wordpad, Microsoft Word, or other text file editor. It consists of 61 program variables which control such program aspects as display color, default image file types, program license version, and much more. Many of the variable values which are written into this file will set GTX program command option choices which are changeable within the running GTX program. Some of the values in the configuration file may not be altered except by exiting the running GTX program and text editing the configuration file.

Configuration Entry Descriptions - The configuration file entries are explained below and valid entries are given. Any items not included in the file or not given a value will use the default values.

Basic Configuration Parameters

DrawingUnits This entry has two functions. It defines whether configuration values should be inches or millimeters and also how the World Coordinate Units should be applied to the raster image. The raster image can be either “1inch” or “1mm”; the other linear measurements in the configuration file will be in the same unit (i.e., if you specify “mm” the RasterWidth parameter will express millimeters and the value should be adjusted accordingly). The DrawingUnits value defines what inch or 1 mm on the raster image maps to in AutoCAD units. The value entered must be a real number. This defaults to AutoCAD’s initial units value.

RasterPath Defines the default path for saving raster files. You can override the directory entered here by entering the full path when prompted for a file name. The default is to save the file in the current directory.

RasterFormat Defines the default storage format of new raster files.  This is used by gCREATE and when using gACTIVE on color images.

RasterLoadExt Defines the available raster formats that will be loaded with AutoCAD open when a raster file with the same name is in the same directory.

RefRotate Defines the angle to rotate images with accompanying .REF files when attached with gATTACH (whether explitly invoked or incidentally invoked using AutoCAD OPEN command). Valid entries are Rotate, Turn or Off.

Rotate Performs an AutoCAD ROTATE on the image entity, then moves the image so the new lower left corner is located where the old one was. Use this option if you want to migrate hybrid raster data back to older versions of GTX software. The disadvantage is that raster files with .REF files are attached at an angle. No raster data is changed - the image is rotated and moved!

Turn Performs a gTURN on the image entity, which actually rotates the raster data and swaps the X and Y raster limits, resizing the image. Use this option if backward migration to earlier GTX software is not important. The advantage of this option is that images are attached at a 0° orientation.

RefAngle Defines the angle used by RefRotate parameter. Valid entries are 0, 90, 180, 270 degrees. The default is 90.

MaxNumPixels Sets the maximum number of pixels allowed in a new raster image. Default setting is 973440000, which at 400 dpi is equivalent to 78.38 x 78.38 inches or 1990 x 1990 millimeters.

HighlightColor Defines the default color used to highlight selected raster data. Choose a color that can be seen against the raster image and against the background color. The default is GREEN.

RasterWidth Sets the default raster line width to be used when vector entities are converted to raster. The entry should be an appropriate real number, or T if you want to specify the Line Width Table values. The default is .01. This value will be in inches or mm according to the DrawingUnits entry. All the values can be reset when you use the gRASTER command.

BackupRas YES causes raster save to create a backup raster file. NO deactivates the backup option.

BackupRasExt Sets the file extension for backup raster files.

Resolution Defines the default resolution for new raster images. 

MaxUndo Sets the number of raster undos that are stored.

Tiffformat Sets the subformat to be used when saving TIFF files:

Format Value

Disable Disables a specified command. Enter a single command name (i.e., gMOVE) after the word “Disable”. The software will not allow the user to invoke the specified command. To disable multiple commands, add more Disable [Command Name] lines to the configuration file.

Text Configuration Parameters

CharFile Sets a recognition file for GTX PLUS versions to automatically load when it is run. If you want the program to load multiple recognition files, add more CharFile [Recognition File] lines to the configuration file.
AmbigChar Sets a character to be listed in the ambiguous characters list box in the gTCONFIG dialog upon starting GTX PLUS versions.
CharOrient Sets the initial values for the Orientation list in the gTCONFIG dialog, determining the allowed orientations for building AutoCAD text entities. The default setting is 0. Valid entries are any angle between -360 and 360 degrees.
CharThreshold Sets the initial value of the AutoConvert Threshold setting in the gTCONFIG dialog. This is the character confidence level above which the character verification dialog appears. The default value is 100, which makes the character verification dialog appear every time. Valid entries are integers from 0 to 100.
CharMinSize Sets the initial value for the Min Char Size setting in the gTCONFIG dialog, determining the minimum value for raster text characters when using Text IOP or gTCONVRT. The default value is .04.
CharMaxSize Sets the initial value for the Max Char Size setting in the gTCONFIG dialog, determining the maximum value for the raster characters when using Text IOP or gTCONVRT. The default value is .4.
CharSpaceSize Sets the initial value for the Space Size setting in the gTCONFIG dialog, defining the distance between raster characters in terms of a typical character’s width necessary for gTCONVRT to insert a space character. The default value is 1.0. Valid entries are any positive real number.
CharAlign Sets the initial value for the Alignment Offset setting in the gTCONFIG dialog, determining the minimum vertical distance, relative to the text strings’ orientations, between separate lines of text in terms of a percentage of a typical character’s height. The default setting is 0. Valid entries are any real number.
TextHeight Sets the initial value for the TextHeight value in the text configuration dialog.
MaxSpaceSize Sets the initial value for the Max # Spaces setting in the gTCONFIG dialog, determining the maximum number of spaces that can be inserted into a text string by gTCONVRT before it breaks the text string into two separate AutoCAD text entities. The default setting is 1. Valid entries are integers 1 through 100.
MaxSpaceSize Sets the initial value for the Max Space Size dialog.
WordVerifyLevel Sets the initial value for the word-mode verification level.
WordForceLevel Sets the initial value for the word-mode force-fit level.
TouchingCR Controls whether ICR splits touching characters.  0 means OFF, 1 means ON
CRMode Controls whether ICR is performing Character recognition or Word recognition.  0 means word mode CR, 1 means character mode CR
SimFile Establishes the character similarity file to use for word recognition.  Gtxtext.sim is hardcoded into GTX, but if another file is loaded it will override the default similarity settings.
WordFile Establishes the dictionary file(s) to load on startup.

Raster-to-Vector Conversion Parameters

GAP_SIZE_TO_JUMP Sets the default GAP JUMP size.
HATCH_LAYER_NAME Sets the layer name to be created during hatch recognition.
LINESTYLE_LAYER_NAME Sets the layer name to be created during linestyle recognition
PColor Establishes a value in the line width configuration table.
Pcolor [Color Value]=0.050 [Line Width]
PClrUnit Determines behavior of linewidth color table when rasterizing or vectorizing with a scaled image. Set PclrUnit=0 if you want to multiply your pcolor setting by the AutoCAD scale of the Image.  Set PclrUnit=1 if you do NOT want to multiply your pcolor setting by the AutoCAD scale of the image.

Other Parameters

ProductLevel sets the product level for the GTX CAD series to run.  Settings include RCAD, RCADPLUS, RTOOLS, R2V, ICAD, ICADPLUS
DemoMode Determines whether GTXRaster CAD operates in demonstration mode.  Although GTXRaster CAD will revert to demo mode if a license is not present, this process can take up to a few minutes.  If you install GTXRaster CAD specifically for demonstration purposes, DemoMode=YES causes it to automatically enter demonstration mode without this delay.  DemoMode=NO (default setting) causes GTXRaster CAD to look for a license when it first runs.
Zero_Pline Determines how polylines of zero width are rasterized.   0 causes zero-width plines to rasterized like other entities.  1 causes them to rasterize at 1 pixel wide.
HaspTimeOut Determines the number of minutes idle time the GTXRaster CAD Series license server will allow before de-activating an active license and making it available again.  Must be at least 120.
Hasp_Type Specifies the type of HASP security key being used. Available settings are: Default, Japan_IBM and Japan_NEC.
RefDelLoad Specifies the behavior of gATTACH as it loads a raster file with an associated .REF file. If set to 1, the .REF is deleted. If set to 0, the .REF file is kept.
DefaultRasterLayer Establishes the name of a layer on which images are placed when attached using gATTACH.
RasterColor Defines the layer color for the layer named in the DefaultRasterLayer config parameter.  Any color from 0-255 can be used.
3P_APP_EDIT Should be set to Yes when another 3rd party application will also be editing raster images.  This will cause more overhead to keep RCAD in sync with the 3rd party application raster edits.  When set to 'YES', RCAD will not perform transparent saving of edited raster images.
3P_APP_SAVING Used when another 3rd party application will also be performing transparent saving.
GACTIVE_ON_GATTACH Controls whether a raster image attached with the gATTACH command should automatically become active (gACTIVE).

Line Width Configuration

The line width configuration table is important to several functions of the GTXRaster CAD Series. Because AutoCAD vector entities have no line width, the GTXRaster CAD Series lets you assign raster line widths to AutoCAD vector colors.

When converting raster to vector, gCONVRT can assign different colors to vectors resulting from different raster line widths. The gRASTER command converts vector data to raster. When rasterizing, AutoCAD vector entities of different colors can be rasterized to different line widths. When smoothing raster the gSMOOTH command can snap raster data to the closest line width listed in this table.

The format for listing a color/linewidth listing is:

Pcolor Color# = LineWidth

in which Color# is the AutoCAD color number to be associated with the raster linewidth. LineWidth is the width of the raster line (this can be measured using the AutoCAD Dist command).

Software License
Activation Help
Support Navigator
Product FAQ
Request Support

Footer bullet1 Footer bullet2 Footer bullet3

© Copyright 2023 GTX. All Rights Reserved.
GTXScanClean is protected by U.S. Patent No. 7,016,536

GTX Europe, Ltd. address and phone number have changed. March 31, 2021

GTX Europe, Ltd. • Cams Hall, • Fareham, Hampshire
United Kingdom PO16 8AB • tel: +44 (0) 1329.227.455 • fax: +44 (0) 1329.227.445 • email:
(UK registration information • Company: GTX Europe Ltd. • Registered Number: 2156326 • Place of registration: England)

r2v raster to vector tiff cals g4 raster to vector paper to cad paper to cad paper to cad tiff view markup redline view markup redline view markup redline vectorization vectorisation vectorization vectorisation vectorization vectorisation R2V GTXRaster CAD GTXRaster Trace GTXRaster CAD Plus GTXRaster R2V GTXImage CAD GTXImage Tools scanclean ScanClean GTXScan Clean Rastercad rastertrace rastercad plus raster r2v v2r rasterization rasterisation rasterization rasterisation rasterization rasterisation Redlining Markup