Initialization file directives

Introduction

This chapter describes the directives which may appear in the initialization file. The directives are listed in alphabetical order. You can also include most of these directives in the run string, with the suitable names (see Summary table) and the form described in Directives and options. The keys which can be used in the run string only are described in Run options.




AVA ——— Controls paper feed at end of drawing 

SYNTAX


AVA feed_flag

ARGUMENTS


feed_flag  sets the paper feed mode on the plotter or printer after printing the drawing. 
The following values are allowed: 

0 inhibits paper feed at the end of the drawing; alternatively, you can enter the OFF string; 

1 half page paper feed, or in devices which have this function (HP-GL and HP-GL/2 plotters), paper feed up to the end of the drawing; alternatively, you can enter the HALF string; 

2 full page paper feed; alternatively, you can enter the FULL or the ON string. 

Default 
2 (FULL or ON): full page paper feed.


DESCRIPTION


Allows you to control the paper feed at the end of printing. Option 2 not only transmits a special paper feed command to the device, preparing a subsequent drawing on a new intentionally blank page, but also, in some devices which normally use raster technology, provokes printing of the last drawing transmitted and its deletion from the device's memory.

In devices which use raster technology, you should use the code only in the last drawing if you want to merge (GRA MERGE) two or more drawings.

The code without arguments is equivalent to GRA ADVANCE 2
See also:  FRA 
GRA MERGE 
GRA NCOP 
GRA ODVT 


BRE ——— Allows you to stop printing for pen change 

SYNTAX


BRE pen1 [pen2 [ ... ]]

ARGUMENTS


pen1 ... numbers identifying the pens at which the plotter must stop to allow a change 

DESCRIPTION


Allows you to temporarily interrupt printing of the drawing, when GBPLO detects an entity whose pen attribute is equal to one of the values specified with pen1 pen2 ... You can, therefore, change the pen on the device, fitting that required. To continue printing the drawing, press Carriage Return (Enter, ...).


DEF ——— Defines symbolic names 

SYNTAX


DEF symbolic_name actual_name

ARGUMENTS


symbolic_name  string with which the actual name specified is symbolically identified
actual_name  actual name or pathname for which a symbolic name is defined

DESCRIPTION


This directive, which can be used only in the initialization file, allows you to define a symbolic_name which will be used in the directives which follow the DEF in the initialization file in place of the specified actual_name: each occurrence of the symbolic_name will be substituted with the actual_name.

The directive is case sensitive: aBc ¹ AbC.

A maximum of 10 different DEF directives can appear in the same initialization file.

Recursiveness is not allowed: you cannot use symbolic names defined with a DEF directive as actual names in another DEF directive. For example, if you enter the directive:

DEF DIRMASTER /mainhost/root1/cad,

a symbolic name for /mainhost/root1/cad/drawings cannot be given using a directive of the following type:

DEF DIRDIS DIRMASTER/drawings

and you must, therefore, use:

DEF DIRDIS /mainhost/root1/cad/drawings

Obviously, the DEF directive proves very useful when you have to use long pathnames more than once.


DIM ——— Defines sheet size 

SYNTAX


DIM  size  | xmax ymax

or:

GRA FORMDsize | xmax ymax [un_measure ]

ARGUMENTS


size  defines sheet dimensions by specifying the standard size; the following values are allowed: 

A0 1189 x 841 mm; 

A0R (A0 horizontal); 

A1 841 x 594 mm; 

A1R (A1 horizontal); 

A2 594 x 420 mm; 

A2R (A2 horizontal); 

A3 420 x 297 mm; 

A3R (A3 horizontal); 

A4 297 x 210 mm; 

A4R (A4 horizontal); 

A5 210 x 149 mm; 

A5R (A5 horizontal). 

xmax real number, defines maximum dimension in cm along the x-axis. 

ymax real number, defines maximum dimension in cm along the y-axis. 

un_measure unit of measure for the values xmax ymax; values allowed: 

MM millimeters (default); 

CM centimeters.


DESCRIPTION


Allows you to define the size of the drawing either through the standard sizes or by specifying the dimensions and the relative unit of measure.

The size is considered the same as the size of the sheet loaded on the plotter, even if the actual dimensions of the sheet are different.

See also:  GRA ODVL 


DRC ——— Defines the drawing directory 

SYNTAX


DRC drawing_dir Default:

ARGUMENTS


drawing_dir  pathname of the directory to be searched for drawings entered 

DESCRIPTION


Allows you to define the directory to be searched for the drawings entered with the option -F and the symbol library defined with LSI, if you do not specify the complete pathname.

See also:  LSI 


DRE ——— Specifies the think3 application installation root directory 

SYNTAX


DRE pathname

Default: GBPLO installation root directory.

ARGUMENTS


pathname  pathname of the think3 application installation root directory

DESCRIPTION


Allows you to specify the think3 application installation root directory, used by GBPLO to determine the fonts to be used in drawings generated in the think3 environment. These fonts reside in the "fonts" subdirectory of the said root directory.

If you do not specify the root directory, GBPLO assumes the GBPLO (DRO) installation root directory.
 
 
See also:  DRO 


DRF ——— Defines font directory 

SYNTAX


DRF font_directory

or

GRA DIRF font_directory

ARGUMENTS


font_directory  pathname for font search (node, directory and subdirectory)

DESCRIPTION


Defines the directory containing the font archives (which can be used by the application with text quality 4 or after the GRA FLOAD command for text quality 3) by specifying the pathname, or node, directory and subdirectory, depending on the operating system used

If you do not specify the pathname or if font_directory is blank, the program searches for the fonts in the run directory of the application program.
 
 
See also:  GRA FLOAD 


DRO ——— Defines installation root directory 

SYNTAX


DRO root_dir

ARGUMENTS


root_dir  pathname of the installation root directory. 

DESCRIPTION


Allows you to specify the installation root directory, used by GBPLO to construct the name of several files specified in the relative mode (MSG).

Has no effect on files and directories specified with GRA keys.
 
 
See also:  MSG 


FER ——— Defines error file 

SYNTAX


FER pathname

ARGUMENTS


pathname  pathname of the error file

DESCRIPTION


Allows you to specify the pathname of a file which will be used to record any error indications otherwise displayed on-screen.


FQU ——— Defines angle dimension unit of measure 

SYNTAX


FQU ang_unit

ARGUMENTS


ang_unit  code identifying the unit of measure to be used for the representation of angle dimensions. Values allowed: 

SDEC sexadecimal degrees 

SGEN sexagesimal degrees 

CEN centesimal degrees 

RAD radian degrees 

Default: SGEN (sexagesimal degrees). 
 
 


DESCRIPTION


Allow you to define the unit of measure to be used for the representation of angle dimension in the drawing.


FRA ——— Framing On/Off 

SYNTAX


FRA framing_flag

ARGUMENTS


framing_flag  flag which can assume the following values: 

ON activates framing mode; 

OFF inhibits framing mode (default).


DESCRIPTION


Allows you to switch the frame drawing mode On/Off on those plotters which have the function (BGL, HP-GL, HP-GL/2).

Framing is a mode in which plotting occurs on pages obtained by suitably splitting the drawing along the x-axis.

The splitting of the pages along the x-axis (frame step) depends on the plotter specification and must be known to the program if it is to split the drawing correctly. In the case of plotting off line (output to file) you must tell the program the size of the frame step using the code GRA P1P2.

If framing is On, you cannot merge two or more drawings on the same sheet (GRA MERGE), nor can you make multiple copies (NCO).

In HP-GL/2 use framing only if the drawing is particularly complicated and the data transmitted exceeds the plotter memory capacity.

The code without arguments is equivalent to FRA ON.

If the -COM option is present, framing is always Off.
 
See also:  GRA MERGE 
GRA P1P2 
GRA SHP1P2 
NCO


GRA ARCD ——— Controls discretization when drawing arcs 

SYNTAX


GRA ARCD disc

ARGUMENTS


disc  real number, defines the discretization step for drawing arcs (default -3); 
values allowed and meanings: 

>0 fixed discretization step value (real number in degrees); 

<0 discretization precision (real number). 

Default: -3. In some cases the directive is ignored if the arc drawing mode is hardware: GRA ARCM HW.
 


DESCRIPTION


Allows you to control the discretization to be used when drawing arcs.

A positive discretization value defines a fixed step, i.e.: irrespective of the arc radius; the value indicated is the angle (expressed in degrees) subtended by the step.

If you enter a negative discretization value, the step is calculated so as to maintain the camber relative to each discretization section below a number output device units (pixels on screen or unit on plotter) equal to the absolute value of the value indicated. Note: in the latter case, the discretization depends on the radius.

The said discretization has no effect if the arcs are drawn in HW mode, except in HP-GL and HP-GL/2 output formats (see manual for HP-GL, CT instruction). For hardware texts, you must also specify the QTE directive (run option: -QT) during the initialization phase
 
 
See also:  GRA ARCM 
GRA LTRM


GRA ARCM ——— Defines arc drawing mode 

SYNTAX


GRA ARCM option

ARGUMENTS


option  may assume the following values: 

HW: hardware mode; 

SW: software mode; 

PO: polyline mode. 

Default: HW. 
 


DESCRIPTION


Allows you to set the arc drawing mode, selecting from three possible modes.

Hardware mode: the arcs are drawn depending on the modes of the device used. Not all devices have the hardware mode for drawing arcs and this cannot always be used (e.g.: drawing dashed arcs, center off-screen, etc.). If the HW mode is On, for those in which it cannot be applied, the program automatically switches to SW mode.

Software mode: the arcs are drawn in individual segments using an algorithm prepared by the program.

Polyline mode: the arcs are drawn using a polyline.

The discretization step value defined with GRA ARCD may be ignored on some devices when the HW mode is selected and effectively used.
 
 
See also:  GRA ARCD 
GRA LTRM


GRA CMAP ——— Defines content of color map elements 

SYNTAX


GRA CMAP {numcol red green blue}

ARGUMENTS


numcol (integer)  Identifies the position  of the color in the color map or conventional value;  
values allowed and meanings: 

0:255 assigns the specified position on the logical color map the three color components specified, taking into account any mapping set with the GRA COLCH code. 

1000:1255 assigns the specified position less 1000 (nco -1000) of the actual color map, the three color components specified, without taking into account any remapping. 

red

(integer from 0 to 255) defines the value of the red component. 

green

(integer from 0 to 255) defines the value of the green component. 

blue

(integer from 0 to 255) defines the value of the blue component. 

 
 


DESCRIPTION


Defines the content of a position on the color map in terms of the primary color (red, green, blue) components. In other words, generates a table of the associated pen (number) and color (RGB components).

Can be used in the following formats:

HP-GL/2
PostScript
CALCOMP - CDCL, when you set the "plotter degree of intelligence" to 2 with GRA INTPL.
 
 
See also:  GRA COLCH 
GRA INTPL 
GRA NCOLS 
GRA ODVT


GRA COLCH ——— Manages match between logical pen and physical pen 

SYNTAX


GRA COLCH {logical_pen physical_pen}

ARGUMENTS


logical_pen  integer identifying the logical pen number; values allowed 0:255
physical_pen  integer identifying the physical pen; only positive or null values are allowed, provided that they are amongst the number of colors allowed by the device or limited by GRA NCOLS 

DESCRIPTION


Allows you to redefine the matches between elements of the logical color map (of the program) and those of the physical color map on the output device. That is to say, allows you to define an association between the logical pens and the physical pens on the device.

The GRA COLCH code can modify the functioning of the subsequent GRA CMAP codes with color index > 255.

The default match between the two color maps is organized as follows.

See also:  GRA CMAP 
GRA NCOLS 
GRA ODVT