Errors
AI Shipped
From Faotory o
On Power-Up Remembered
If the Parameter is Omitted
o
KA11 (Level 2): Parameter out of range. (Must be 0 or 1. In
SETUP mode, must be YES or NO.) (-References
(CR) character.
<Enable-4010-GIN> command.
<Page> command.
<Renew-View> command.
<Set~line-style> command.
<Set-margins> command.
4-102 REV, DEC 1981 4110 SERIES COMMAND REFERENCE
ALPHABETICAL LISTING
<Enable-GIN> Command SYNTAX
<enable-GIN>
=
(ESC)(I)(E)<int>PARAMETERS
<int: device-function-code>
<int+: number-of-GIN-events> .
Devioe-Funotion Code.
A number of the form 8D + F, where D is a device code and F is a function code.Valid values for Dare 0 (thumbwheels), 1 (tablet), and 3 (RS-232 peripheral ports number 0). Valid values for Fare 0 (locator function), 1 (pick function, and 2 (stroke function - valid only if D
=
1). .Number-of-GIN-Events (0 to 65535). Specifies the num-ber of points whose position will be reported in a
<GIN-report-sequence> before the device-function com-bination is automatically disabled. If this parameter is zero, GIN is enabled for 65535 GIN events.
Description
Enables the GIN (graphic input) function on the specified device. The device and function are specified by the first integer. The second integer specifies how many events of the function are to occur before the function is automatically disabled. A function can be essentially enabled "permanent-ly" by specifying a very large count (for instance, 65535).
Undesired results may occur if the
~
terminal is simultaneously enabIea for graphic input with two different en----abling commands:-Do-n0t use more than one of these commands-8t-rEe same~e:
<enaDIe-GIN>, <enable-401o=GI~<en
able-4953-tablet-GIN>.
-4110 SERIES COMMAND REFERENCE REV, DEC 1981 4-103
ALPHABETICAL LISTING
Ttie device-function combination is disabled when any of the following occurs:
The count specified in the <enable~GIN> command ex-pires.
The terminal receives a <disable-GIN> command for that device-function code.
The terminal receives a <cancel> command.
The operator presses the CANCEL key.
With thumbwheel GIN enabled, pressing a key with a macro defined for it will cause an event for each character in the macro which would normally be sent to the host.
When the terminal sends a report to the host, bypass mode is entered. (See <enter-bypass-mode>.)
Note that there are GIN devices and GIN functions. (See Tables 4-7, 4-8, and~9.)
Table 4-7
GIN DEVICE ID NUMBERS
Devioe ... Code Host
Program SamplesEvent Device
0 Thumbwheels Keyboard
1 Tablet Tablet pen or puck
ALPHABETICAL LISTING
Table 4-8
GIN FUNCTION ID NUMBERS Code
o
1 2
Funotion Locator Pick Stroke
Table 4-9
DEVICE-FUNCTION ID CODE NUMBERS Code Devioe-Funotion Code
(8 times devioe oode plus funotion oode)
0 Thumbwheels-Locator
1 Thumbwheels-Pick
8 Tablet-Locator
9 Tablet-Pick
10 Tablet-Stroke
24 Plotter at Port 0 - Locator 25 Plotter at Port
o -
Pick32 Plotter at Port 1 - Locator 33 Plotter at Port 1 - Pick
40 Plotter at Port 2 - Locator
41 Plotter at Port 2 - Pick
4110 SERIES COMMAND REFERENCE REV, DEC 1981 4-105
ALPHABETICAL LISTING
The GIN devices are:
•
Thumbwheels. The operator uses the thumbwheels to position the graphic cursbr and then signals a GIN characterstyped onrhekeybOard a r e -treatea as if theY-came from the host rather than the-keybOard-.-- ---
----Tablet. (Requires Option 13 or Option 14.) The positions the graphic cursor by movins the joystick"on
"-106
R~V.DEC1981 4110 SERIES COMMAND REFERENCE
(
ALPHABETICAL LISTING
NOTE
In the 4112 and 4113, moving the
thumbWheelS
TOr
other GIN devICe) posi-tions the graphic cursc;r-in 4096-by-1.~096terminar-space. However, tEe cursor which the operator actualry-sees is the image (in 640-by-480 raster memorY- ---space)-oT the true cursor. How the visi-ble image moves-depends on the current WIndow-viewport transfor~ wnIch maps
objects in terminal space to their cor-responding images in raster-memory ----space.
On power-up, severa~ points in terminal space map to each pixel in raster memory
space.-rnu~ when moving-rhe thumbwheels slowly, it is possible to move the true cursor (Whose position
Tn
terminal space is reported to the host~without produc-Ing any visiDIe-m0tion in the image ofthat-CUrsor in 640-by-480 raster memory space.
Likewise, if the window in terminal space is very-sffiall {as When the
opera-tor has"zoomed in" t"()see more-detail) , then-adjacent polnts-rn-rermInal space may have images in the-current viewport WhIch are separated~ some small
dis-tance.-rn that case,-as the operator--moves tEe cursor in termInal space, the image or-that cursor moves in short steps from Elace to place in-raster memory space.
4110 SERIES COMMAND REFERENCE REV, DEC 1981 4-107
ALPHABETICAL LISTING
The GIN functions are:
Looate. Returns x- and y-coordinates for a particular location. (This is the location in terminal space of the graphic cursor. For further information, see the
<gin-locator-report> description,elsewhere in this section.)
Pick. Compares all detectable segments within the pick aperture, returning the segment number and pick-i.d.
of the highest-priority such segment, together with the <xy> coordinate of the graphics cursor. For fur-ther information, see the <GIN-pick-report>
description, elsewhere in this section.
Stroke. Sends a continudus stream of x- and y-coordi-nates to the host. Currently only the graphics tablet can be used with the stroke function. For more infor-mation, see the <gin-stroke-report> command descrip-tion.
Example. To enable the graphics tablet for five events of the locator function :
<enable-GIN: tablet-locator, 5 events>
=
(ESC)(I)(E)<int: 8><int: 5><enable-GIN: tablet-pick, 32767 events
4 ... 108
ALPHABETICAL LISTING
Number
Of GIN Events. The second parameter in the is of parameter type <int+>; that is, it represents an integer in the range from 0 to 65535. (See the description of the <int>and <int+> parameter types for details.) This parameter
specifies the number of GIN events for which the terminal is enabled.
If this parameter is zero, the terminal is enabled for the maximum number of GIN events (65535). Otherwise, the termi-nal is enabled for the number specified by the <int+>
parameter.
Defaults