GTXRAST.CFG - Editable Configuration File
GTXImage CAD Series and GTXRaster CAD Series, All Versions:
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 67 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 552,960,000, which at 300 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. Valid entries are the same for RasterColor. The color can be changed with the gCOLOR or gLAYER commands. 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:
Text Configuration Parameters
CharFile Sets a recognition file for GTXRaster CAD PLUS 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 GTXRaster CAD PLUS.
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.
Other Parameters
ProductLevel sets the product level for the GTXRaster CAD series to run. Settings include RCAD, RCADPLUS, ICAD, ICADPLUS
DemoMode Determines whether GTXRaster CAD operates in demonstration mode. Although GTXRaster CAD will revert to demo mode if a HASP key 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 the HASP key 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.
RefMkSave Specifies whether a .REF file is created for each attached image when AutoCAD SAVEASR12 and SAVEASR13 commands are invoked.
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.
BkCompMode When set to 1, this overrides AutoCAD’s normal behavior to make it behave more like earlier versions of the GTXRaster CAD Series. When a drawing containing attached images is opened, any image that does not have the same name as the drawing is detatched, deleting its image entities. Any raster file with the same name as the drawing will then be attached using any .REF files to register the raster in the vector drawing.
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).
ENABLE_NOVELL_SAVING allows saving raster files over Novell 4.x allows saving raster files over Novell 3.x
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).