GPHIGS_GUI User Guide - 8.2. RESOURCES

8.2. RESOURCES

XmNwidth

This resource controls widget size (width). The size corresponds to the visible part of the widget on the screen, and may be different from the size of the PHIGS workstation ( display area ).

If the workstation is larger than the widget, the latter may control the scrollbars and the resulting fresh graphic displays.

XmNheight

This resource controls widget size (height). This size corresponds to the visible part of the widget on the screen, and may be different from the size of the PHIGS workstation ( display area ).

If the workstation is larger than the widget, the latter may control the scrollbars and the resulting fresh graphic displays.

XmNwidthWs

This resource controls workstation size (width), (the part of the screen in which the graphics are displayed ), this size corresponds to the width of the graphic window.

XmNheightWs

This resource controls workstation size (height), (the part of the screen in which the graphics are displayed), this size corresponds to the height of the graphic window.

XmNresizeWs

This resource controls the behaviour of the graphic window in relation to the outside window (the widget). The widget may in fact be smaller than the workstation, in this case the widget controls the scrollbars for access at any time to hidden graphics. The XmNresizeWs resource specifies the behaviour of the graphic window when the widget window is resized to make it the same size as the workstation. If the resource is positioned at XmGPHIGS_RESIZE_WS, the workstation will continue to follow the resize requested by the outside window (the graphic window stays "glued" to the widget window). If the resource is positioned at XmGPHIGS_NO_RESIZE_WS, the size of the graphic window will stay the same and cannot be resized.

Figure 8.2a

The various possible configurations are :

CASE 1 :

XmGPHIGS_RESIZE_WS

XmNwidth different from NULL

XmNheight different from NULL

XmNwidthWs not assigned

XmNheightWs not assigned

For this configuration, the widget does not have any scrollbars and the workstation (drawing area) follows the resizing of the window manager. See demonstration program SzWs.c, case 1

CASE 2 :

XmGPHIGS_NOT_RESIZE_WS

XmNwidth different from NULL

XmNheight different from NULL

XmNwidthWs different from NULL

XmNheightWs different from NULL

For this configuration the widget has scrollbars, but the workstation size (drawing area) remains unchanged. See demonstration program SzWs.c, case 2

CASE 3 :

XmGPHIGS_RESIZE_WS

XmNwidth different from NULL

XmNheight different from NULL

XmNwidthWs different from NULL

XmNheightWs different from NULL

For this configuration the widget has scrollbars and the workstation size (drawing area) cannot be less than the initial size. See demonstration program SzWs.c , case 3

XmNwidgetDA

This resource is used to recognize the identifier, as the term is used in Motif, of the widget workstation (the actual graphic window), it particularly enables the user to associate a pop-up-menu with the workstation. It is thus used to add an Event-Handler to the GPHIGS widget. See demonstration program WsPopup.c

Example :

	int n;
	Widget DA, w;

		n = 0;
		XtSetArg(arg[n], XmNwidgetDA, &DA); n++;
		XtGetValues(w,args,n);

		XtAddEventHandler(DA, ...);

XmNwidgetLink

This resource links the different GPHIGS widget scrollbars The link may either be via the horizontal scrollbars, the vertical scrollbars, or both at the same time. It thus enables two workstations to be scrolled with either of the scrollbars. This link is carried out in one direction at a time, so, in order to have symmetry, it must be specified that widget 1 is linked with widget 2, and that widget 2 is linked with widget 1. See demonstration program LinkW.c

XmNarchiveFile

This resource gives a GPHIGS archive file name to the widget, and the latter will display its contents. This display corresponds to PHIGS "retrieve all structures" and does not take the workstation attributes into account, and particularly the viewing (PHIGS standard).

XmNwsid

This resource gives the number of workstations opened by the widget. This number corresponds to the first PHIGS function parameter popen_ws. For GPHIGS this number may vary from 1 to 15. The widget controls the conflicts : if a number is used twice a warning is displayed, and it attempts to open a free workstation.

XmNlocDev

This resource specifies the locator number used. This number corresponds to the second GPHIGS function parameter pinit_loc(). This number is useful when the widget is used with PIM GPHIGS and enables the PIM soft echos to be arranged. It is necessary, however, to initialize the locator

(function pinit_loc())

XmNpickDev

The same characteristics as for XmNlocDev but for picking.

XmNnumButton

This resource specifies the mouse button number(s) which are confirmed to carry out the pick and locator inputs, this resource is valid for the 2 input types. Several buttons may be specified, for example, a value of 123 or 312 for this resource means that mouse buttons 3, 2 and 1 could carry out the inputting, a value of 31 means that only buttons 1 and 3 would be valid. This resource overrides the following 2 resources.

XmNnumButtonLoc

This resource specifies which button(s) are valid for carrying out a locator operation. The possible values are identical to the previous resource but only concern the locator callback .

XmNnumButtonPick

This resource specifies the button(s) which are valid in carrying out a pick operation, the possible values are identical to the previous resource but only concern the pick callback .

XmNpressButton

This resource specifies whether validation takes place when the mouse button is pressed or released.

XmNdepthPick

This resource initializes the search depth for the picking callback, with a default value of 1. During picking, this resource must be initialized since it will be required for the dynamic assignment of the returned path.

XmNdeviceWs

This resource specifies the driver number which will be used to draw in the graphic window. This number corresponds to the third GPHIGS function parameter popen_ws().

PWS_TYPE_X_WINDOW (8887) driver X-Window ( defaut )

PWS_TYPE_SGI_GL_X (7177) driver gl for silicon or IBM

PWS_TYPE_SUN_XGL (8871) driver Xgl for SUN

PWS_TYPE_HP_STARBASE (8384) driver starbase for HP

PWS_TYPE_PEX_STRUCTURE (8069) driver PEXLib structure

PWS_TYPE_PEX_IMMEDIA (8070) driver PEXLib immediate mode

See GPHIGS USER GUIDE for more detailed information on driver characteristics.

XmNsizeBufString

This resource specifies the length of the character string which will be entered in the graphic winsow when the XmNstringCallback is used.

XmNactiveIcon

This resource specifies the list of icons in the GPHIGS-GUI popup menu (<shift> button3)

XmNfontUser

This resource specifies the font which will be used for the GPHIGS-GUI popup menu

XmNdebugMode

This resource accesses GPHIGS debugger in a MOTIF program. It can only be used if the CSS had been built in the XmNcreateDACallback callback. If this is not the case, the gphigs_gui_debug and gphigs_gui_wait_end_debug functions must be used (see chapter : GPHIGS debugger).

XmGDEBUG_MODE

XmNO_GDEBUG_MODE

XmNcursor

This resource specifies a cursor (predefine X-Window) valid for the graphic window. See demonstration program StdCursorW.c

The following 4 resources are designed to be used together to redefine a personnalised cursor in the widget. See demonstration program OwnCursor.c

Figure 8.2b

XmNcursorShape

This resource specifies the cursor shape

XmNcursorMask

This resource specifies the cursor mask

XmNcursorForeground

This resource specifies the cursor foreground

XmNcursorBackground

This resource specifies the cursor background

(a cursor may be defined using the X utility : bitmap )

The following 5 resources enable the use of overlay planes (multi-plane GPHIGS) in the widget with the driver X11 (8887). See demonstration program Mradar.c

XmNwindowGroup

For X11 driver only. Specify the workstation identifier of the X-Window to be used by the current workstation.

XmNnumSubWs

This resource specifies the total number of workstations to be opened (including the master workstation)

XmNsubWs

This resource specifies all the workstations to be opened (including the master workstation)

XmNplaneMask

This resource specifies, in hexadecimal, the planes list for each workstation.

XmNwindowManagerSharedColor

This resource specifies the position, in the colormap, of the colors used by the window manager.

XmHIGH_HALF

XmLOW_HALF

XmHIGH_FULL

XmLOW_FULL

XmNONE_FULL

It should be noted that when the colors are redefined in the same window, the number of colors corresponds to the number of planes (2ⁿ) allocated for the workstation.

In an 8-plane configuration, if the window is shared between 2 workstations, it is impossible to redefine 16 colors on the 2 stations without having to 'blink' when opening / quitting the graphic window. In order to avoid this phenomenon, 16 colors must be redefined on one of the stations and only 8 for the other to leave one plane for the window-manager. For a more complex configuration, 24 planes per window for example, 2 times 16 colors does not create any problems.

See demonstration program MultiW.c

XmNmouseCtrlMenu

This ressource activate ( value XmMOUSE_CTRL_ON ) or desactivate ( value XmNMOUSE_CTRL_OFF ) popup-menu on mouse button 3. If this resource is not set when workstation is created, popup menu will not avalaible. This option is avalaible in configuration file (GPHIGS.def) with %mc (yes/no) in PHIGS program

Voir section 5.5

XmNmouseCtrlList

This resource specifies, with a character string, the list of icons which will be present in the Mouse control menu. This list is numbered with lower case letter, in alphabetical order a,b,c,...

XtSetArg(args[n],XmNmouseCtrlList,"abced"); n++

For PHIGS program this is avalaible with %ml (abcdef..) in configuration file (GPHIGS.def)