Graphics-related properties of the HostOptions object
Related Topics

image\validfor_v.gif

Applies To Objects

HostOptions

Description

The properties in this group control the appearance of ReGIS and Tektronix graphic images. They are available only in KEA! with Graphics, when running a DEC VT340 session. They are equivalent to the options in a VT340 session: page Settings, Display, Graphics.

 

Syntax

Unless noted, all graphics-related properties have the following syntax:

object.Property

Element

Description

Object

The HostOptions object.

Property

A graphics-related property.

 

Names and Descriptions of individual properties

GraphicsBitMap Property

This read-write property affects how graphic images are stored for redrawing on the screen, and for printing. If this property is TRUE, a copy of the image is saved in memory. Compare this property with the GraphicsDisplayList property.

The BitMap technique works with all printers. This generally means that the screen be redrawn faster than with the DisplayList technique. However, if you change the font size, the image cannot be redisplayed. You must use the BitMap technique if you want to copy and paste graphics. If the GraphicsBitMap and GraphicsDisplayList properties are both TRUE, the BitMap technique is used when possible, otherwise DisplayList.

 

GraphicsCursor Property

Set this read-write property TRUE to display a graphics output cursor at the writing point. This does not affect the Graphics Input Mode cursor.

 

GraphicsDisplayList Property

This read-write property affects how graphic images are stored for redrawing on the screen, and for printing. If this property is TRUE, all graphics commands are stored in a list. Compare this property with the GraphicsBitMap property.

Although the display list method can provide better results, many printers do not support this technique. This technique offers you the most flexibility when you want to change the font size (zoom).

 

GraphicsMacroReport Property

Set this read-write property TRUE to send the contents of a macrograph in response to a ReGIS Report Macrograph command from the host.

 

SixelBackgroundPrinting Property

Set this read-write property TRUE to send background colors when responding to a ReGIS hardcopy command S(H) from the host.

 

SixelColorPrinting Property

Set this read-write property TRUE to send color sixels when responding to a ReGIS hardcopy command S(H) from the host. Set this property FALSE to send monochrome sixels.

 

SixelColorSpecification Property

Returns or sets the color encoding method used when responding to a ReGIS hardcopy command S(H) from the host. Use the following values to select a color encoding method.

Constant

Value

Description

xCOLORHLS

0

Use Hue, Lightness, Saturation encoding.

xCOLORRGB

1

Use Red, Green, Blue encoding.

 

SixelGraphicsLevel Property

Returns or sets the aspect ratio used when responding to a ReGIS hardcopy command S(H) from the host. Use a constant or value to select the aspect ratio that best matches the VAX printer on which you will print the image. Contact your VAX system administrator for assistance in selecting one of these values.

Constant

Value

xSIXELLA210

0

xSIXELLEVEL1

1

xSIXELLEVEL2

2

 

SixelIgnorePrintRequests Property

Returns or sets whether to ignore host request to print graphics. Set this property TRUE to ignore ReGIS hardcopy commands S(H) from the host.

 

SixelPrintOption Property

Returns or sets the size of the image printed in response to a ReGIS hardcopy command S(H) from the host. Use a constant or value to select the image size.

Constant

Value

Size of image

xSIXELPRINTCOMPRESSED

0

Aproximately 6 inches wide by 3 inches high. Default.

xSIXELPRINTROTATED

1

Approximately 12 inches wide by 8 inches high, rotated to print in landscape orientation on letter size paper.

xSIXELPRINTEXPANDED

2

Approximately 12 inches wide by 8 inches high.

 

SixelScrolling Property

Returns or sets whether to allow sixel scrolling. If TRUE (VT340 compatibility), sixel drawing begins at the current text cursor position and can scroll the screen. If FALSE (VT240 compatibility), sixel drawing begins at the home position and cannot scroll the screen. This does not affect the text active position.

 

StyledLines Property

Returns or sets whether to use solid background to ensure proper display of styled lines. If your image is missing some lines, set this property TRUE to use a solid background, rather than a transparent background. Although this differs slightly from the VT340, styled lines are displayed properly. The state of this property is stored in the Windows Registry database, not in your session file. If you set this value, all display sessions use it.

 

TektronixAutoPrint Property

Returns or sets whether to produce a hardcopy when a Tektronix Page Full condition is reached. Set this property TRUE to produce a hardcopy and clear the screen. This property is equivalent to the AutoPrint switch on a 4014.

 

TektronixBSDoesDEL Property

Returns or sets the action to take when an ASCII BS is received in Tektronix mode. If FALSE, BS merely backspaces the cursor. If TRUE, BS backspaces the cursor and erases the character.

 

TektronixCharacterSet Property

Returns or sets the character set to use in Tektronix mode. Use a constant or value to choose a character set.

Constant

Value

Description

xTEKCHARSETASCII

0

Uses the ASCII character set. Default.

xTEKCHARSETAPL

1

Uses the APL character set.

xTEKCHARSETPROG

2

Uses a character set that the host can change with control codes.

 

TektronixCRAddsLF Property

Returns or sets the action to take when an ASCII CR is received in Tektronix mode. If FALSE, CR moves the cursor to the current margin. If TRUE, CR moves the cursor to the current margin, then down one line.

 

TektronixDELIgnored Property

Returns or sets action to take after an ASCII DEL is received in Tektronix mode. If FALSE, DEL is processed the same as any received character. If TRUE, DEL is ignored, appropriate if your host sends DEL as a pad character.

 

TektronixDisplay Property

Returns or sets the size of the emulation window used to display the Tektronix image. Use a constant or value to choose a size.


Constant


Value

Display the
image using

xTEKDISPLAY80X24

0

The full emulation window. This makes the image larger and easier to read.

xTEKDISPLAY64X24

1

64 of the 80 available columns. This setting gives a true aspect ratio. Default.

xTEKDISPLAY80X30

2

All 80 columns, and extend the image vertically to the equivalent of 30 VT lines. This keeps the aspect ratio correct and also makes the image larger and easier to read.

 

TektronixEnlargedCharacter Property

Returns or sets the size of displayed characters in Tektronix mode. If FALSE, use 4014 character sizes (default). If TRUE, use enlarged, easy-to-read characters although they do not align exactly with graphics.

 

TektronixGINTerminator Property

Returns or sets the Tektronix GIN position report terminator. Use a constant or value to choose a terminator.

Constant

Value

Sends at end of report

xTEKGIN_NONE

0

No terminator code. Default.

xTEKGIN_CR

1

Only CR.

xTEKGIN_CREOT

2

CR and EOT.

 

TektronixLFAddsCR Property

Returns or sets action to take after a LF is received in Tektronix mode. If FALSE, move the cursor down one line. If TRUE, move the cursor down one line, then to the current margin.

 

TektronixLineStyleMap Property

Returns or sets how to map the standard 4014 line styles to Windows colors. Use a constant or value to choose a mapping.

Constant

Value

Mapping

xTEKLINESTYLE

0

Use normal 4014 line styles; do not map to colors. Default.

xTEKLINECOLOR

1

Map line styles to colors; all lines appear as solid lines.

xTEKLINEBOTH

2

Map line styles to colors and maintain original line styles.

 

TektronixMarginControl Property

Returns or sets how the Tektronix Page Full Condition is set. This property is equivalent to the MarginControl switch on a 4014.


Constant


Value

Set Page Full
Condition when

xTEKMARGINNONE

0

Never. After a page fills, writing continues at the top without clearing the screen. Default.

xTEKMARGIN1

1

The cursor reaches the bottom of the first margin.

xTEKMARGIN2

2

The cursor reaches the bottom of the second margin.

 

TektronixOverwrite Property

Returns or sets whether to erase existing characters in the Tektronix writing area. If FALSE, overwrite existing characters without erasing them. If TRUE, erase existing characters (including spaces) before writing new characters.

 

TektronixVectorFont Property

Returns or sets the type of font to use for displayed Tektronix characters. If TRUE, generate characters from a vector definition, similar to the Tektronix 4010/4014. If FALSE (default) use the built-in bitmap fonts. In most cases, bitmap creates better looking characters, although the vector character size is more accurate.

 

 

TektronixVT640Compatible Property

Returns or sets whether to interpret VT640 sequences for entering and exiting Tektronix mode. If TRUE, the VT640 sequences are obeyed.