Modulef
Next: 6.3 Entering a position in the Up: 6 Input management Prev: 6.1 Definition of the terminal and Contents

6.2 Interaction subroutines

```
      SUBROUTINE GETXY(X, Y)
      REAL X, Y
```
returns the coordinates of the graphics cursor (visible on the visualization surface in the form of a cross or a small rectangle), expressed in the user space and defined by MASQUI and FENTRI, in (X, Y). The unit system, in which these coordinates are expressed, is defined by MASQUI.
If we decide to take the same dimensions for MASQUI and MASQU2 and is the visualized object is a two-dimensional object, then the coordinates returned in X and Y correspond exactly to the object's real coordinates.
If, for the same masks, the visualization object is three-dimensional, then the coordinates obtained are those obtained by MASQU2 defined by PRSPCT, and it is placed on the plane, Z = -1. In other words, the true coordinates obtained are (X, Y, -1.), expressed in the object's unit system, where:
```
      SUBROUTINE GETXYC(X, Y, IC)
      REAL X, Y
      CHARACTER*1 IC
```
This subroutine is identical to the preceding one, except for IC which contains the character corresponding to the key used for input. If the terminal is implemented well, we will have the following relationship:
```
      SUBROUTINE STROKE(NMAX, NB, X, Y)
      INTEGER NMAX, NB
      REAL X(NMAX), Y(NMAX)
```
returns in arrays X and Y a maximum of NMAX coordinates pairs defined in the user space. The actual number of points input is indicated in NB.
This function corresponds to the input of a curve, point by point (map recording or scheme recording).
```
      SUBROUTINE CSTROK(NMAX, NB, X, Y, DELMIN, DELMAX)
      INTEGER NMAX, NB
      REAL X(NMAX), Y(NMAX), DELMIN, DELMAX
```
returns in arrays X and Y a maximum of NMAX coordinate pairs defined in the user space. The actual number of points input is indicated in NB.
DELMIN and DELMAX indicate the minimum (elimination of noise) and maximum (elimination of coding errors) distances, respectively, between two consecutive points.
This function corresponds to the input of a curve by hand.
```
      SUBROUTINE GETEXT(OUTEXT, X, Y, NBCMAX, INTEXT, NBCIN)
      CHARACTER*(*) OUTEXT, INTEXT
      INTEGER NBCMAX, NBCIN
      REAL X, Y
```
returns a string of NBCMAX characters maximum in array INTEXT. The actual number of characters input is indicated in NBCIN. An initial text contained in array OUTEXT is first displayed at position (X, Y) defined on the visualization surface. The initial text is cannot be edited. If, when called, NBCIN is non-zero, the NBCIN characters of INTEXT are displayed and those which can be edited.
On exit, (X, Y) is the position of the character which follows the last printed character.
```
      SUBROUTINE GETNUM(OUTEXT,X,Y,R,I,B,ITYP,ICONT,MINI,MAXI,MINR,MAXR)
      CHARACTER*(*)OUTEXT
      INTEGER I, ITYP, ICONT, MINI, MAXI
      REAL X, Y, R, MINR, MAXR
      LOGICAL B
```
returns on of the following values in ITYP: either an integer number in I (ITYP = 0), or a real value in R (ITYP = 1), or a logical entity in B (ITYP = 2).
Eventually, the text contained in the character string, OUTEXT, is displayed first at position (X, Y) on the visualization surface (variable name, comment,...) as well as the current value of the number.
Finally, is ICONT is non-zero, the number entered can be restrained to lie between two limits indicated by MINI and MAXI for an integer, and between MINR and MAXR for a real.
```
      SUBROUTINE GETHIT(HITSEG, HITNAM)
      INTEGER HITSEG, HITNAM
```
returns the name of a segment, using the designation device, in HITSEG. The name of the designated element is stored in HITNAM (see BGNA and ENDAS).

Next: 6.3 Entering a position in the Up: 6 Input management Prev: 6.1 Definition of the terminal and Contents