3.3.5.4 Bitstream Speedo Scalable Fonts

• DECW$SYSCOMMON:[SYSFONT.DECW.SPEEDO]

Table 3-7 Bitstream Speedo Scalable Fonts (.SPD File Extension)

File Name	Font Name
Charter
FONT0648	-Bitstream-Charter-Medium-R-Normal- -0-0-0-0-P-0-ISO8859-1
FONT0649	-Bitstream-Charter-Medium-I-Normal- -0-0-0-0-P-0-ISO8859-1
FONT0709	-Bitstream-Charter-Bold-R-Normal- -0-0-0-0-P-0-ISO8859-1
FONT0710	-Bitstream-Charter-Bold-I-Normal- -0-0-0-0-P-0-ISO8859-1
Courier
FONT0419	-Bitstream-Courier-Medium-R-Normal- -0-0-0-0-m-0-ISO8859-1
FONT0582	-Bitstream-Courier-Medium-I-Normal- -0-0-0-0-m-0-ISO8859-1
FONT0583	-Bitstream-Courier-Bold-R-Normal- -0-0-0-0-m-0-ISO8859-1
FONT0611	-Bitstream-Courier-Bold-I-Normal- -0-0-0-0-m-0-ISO8859-1

3.3.5.5 Agfa Monotype TrueType Scalable Fonts

Table 3-8 lists the new Agfa Monotype TrueType scalable fonts and their file names. The files for these fonts are located in the following directory:

• DECW$SYSCOMMON:[SYSFONT.DECW.TRUETYPE]

Table 3-8 Agfa Monotype TrueType Scalable Fonts (.TTF File Extension)

File Name	Font Name
Albany (Similar to Arial)
ALBANYBD	-Agfa Monotype-Albany-Bold-R-Normal- -0-0-0-0-P-0-ISO8859-1
ALBANYBI	-Agfa Monotype-Albany-Bold-I-Normal- -0-0-0-0-P-0-ISO8859-1
ALBANYIT	-Agfa Monotype-Albany-Medium-I-Normal- -0-0-0-0-P-0-ISO8859-1
ALBANY_ _	-Agfa Monotype-Albany-Medium-R-Normal- -0-0-0-0-P-0-ISO8859-1
Cumberland (Similar to Courier)
CUMBB	-Agfa Monotype-Cumberland-Bold-R-Normal- -0-0-0-0-M-0-ISO8859-1
CUMBBI	-Agfa Monotype-Cumberland-Bold-I-Normal- -0-0-0-0-M-0-ISO8859-1
CUMBI	-Agfa Monotype-Cumberland-Medium-I-Normal- -0-0-0-0-M-0-ISO8859-1
CUMBR	-Agfa Monotype-Cumberland-Medium-R-Normal- -0-0-0-0-M-0-ISO8859-1
Screen
SAN_M_21	-Agfa Monotype-Screen Sans-Medium-R-Normal- -0-0-0-0-M-0-ISO8859-1
SAN_P_21	-Agfa Monotype-Screen Sans-Medium-R-Normal- -0-0-0-0-P-0-ISO8859-1
SRF_M_21	-Agfa Monotype-Screen Serif-Medium-R-Normal- -0-0-0-0-M-0-ISO8859-1
SRF_P_21	-Agfa Monotype-Screen Serif-Medium-R-Normal- -0-0-0-0-P-0-ISO8859-1
Thorndale (Similar to Times New Roman)
THOBI_ _ _	-Agfa Monotype-Thorndale-Bold-I-Normal- -0-0-0-0-P-0-ISO8859-1
THOB_ _ _ _	-Agfa Monotype-Thorndale-Bold-R-Normal- -0-0-0-0-P-0-ISO8859-1
THOI_ _ _ _	-Agfa Monotype-Thorndale-Medium-I-Normal- -0-0-0-0-P-0-ISO8859-1
THOR_ _ _ _	-Agfa Monotype-Thorndale-Medium-R-Normal- -0-0-0-0-P-0-ISO8859-1

3.3.5.6 Adobe Type1 Fonts

Table 3-9 lists previously undocumented Adobe Type1 fonts and their file names. The files for these fonts are located in the following directory:

• DECW$SYSCOMMON:[SYSFONT.DECW.TYPE1]

Table 3-9 Adobe Type1 Scalable Fonts (.PCA File Extension)

File Name	Font Name
Courier
COUR	-Adobe-Courier-Medium-R-Normal- -0-0-0-0-P-0-ISO8859-1
COURI	-Adobe-Courier-Medium-I-Normal- -0-0-0-0-P-0-ISO8859-1
COURB	-Adobe-Courier-Bold-R-Normal- -0-0-0-0-P-0-ISO8859-1
COURBI	-Adobe-Courier-Bold-I-Normal- -0-0-0-0-P-0-ISO8859-1
Utopia
UTRG_ _ _ _	-Adobe-Utopia-Medium-R-Normal- -0-0-0-0-P-0-ISO8859-1
UTI_ _ _ _ _	-Adobe-Utopia-Medium-I-Normal- -0-0-0-0-P-0-ISO8859-1
UTB_ _ _ _ _	-Adobe-Utopia-Bold-R-Normal- -0-0-0-0-P-0-ISO8859-1
UTBI_ _ _ _	-Adobe-Utopia-Bold-I-Normal- -0-0-0-0-P-0-ISO8859-1

3.4 X Window System Toolkit (Xt) Enhancements

Table 3-10 New Xt Functions Supported for X11R6.6

Function Name	Description
XtAppAddBlockHook	Registers a block hook procedure.
XtAppAddSignal	Registers a signal callback.
XtAppGetExitFlag	Supports controlled exit from main loop in a multithreaded application by returning the flag set by XtAppSetExitFlag.
XtAppLock	Locks the application context in a multithreaded application.
XtAppSetExitFlag	Supports controlled exit from main loop in a multithreaded application by setting a flag in the application context.
XtAppUnlock	Releases an application context lock.
XtCancelSelectionRequest	Cancels a multiple selection request.
XtChangeManagedSet	Simultaneously removes from and adds to the geometry managed set of a composite widget.
XtCreateSelectionRequest	Adds to a multiple selection request.
XtDispatchEventToWidget	Dispatches an event to a specified widget.
XtGetClassExtension	Locates a class extension record of an object class.
XtGetDisplays	Lists the open displays associated with an application context.
XtGetKeyboardFocusWidget	Determines which widget would be the end result of keyboard event forwarding for a keyboard event on a specified widget.
XtGetSelectionParameters	Gets target parameters needed to perform a selection conversion.
XtHooksOfDisplay	Retrieves the hook registration object for the specified display.
XtInsertEventTypeHandler	Registers an event handler procedure by event type.
XtIsSessionShell	Widget subclass verification function for the session shell widget.
XtLastEventProcessed	Retrieves the last event processed by XtDispatchEvent.
XtNoticeSignal	Notifies the X Toolkit that a signal has occurred.
XtOpenApplication	Convenience function to initialize intrinsics, create an application context, open a display connection, and create an application shell.
XtProcessLock	Locks the X Toolkit process lock.
XtProcessUnlock	Releases the X Toolkit process lock.
XtRegisterDrawable	Associates a drawable with a widget so that the drawable receives events as if part of the widget.
XtRegisterExtensionSelector	Registers a procedure to receive extension events for a widget.
XtRemoveBlockHook	Discontinues use of a block hook procedure.
XtRemoveEventTypeHandler	Removes a registration created by XtInsertEventTypeHandler.
XtRemoveSignal	Removes a registered signal callback.
XtReleasePropertyAtom	Releases a reservation made by XtReservePropertyAtom.
XtReservePropertyAtom	Reserves a unique atom for selection requests on a widget.
XtSendSelectionRequest	Sends a multiple selection request.
XtSessionGetToken	With the new session shell widget, gets an additional token for a save callback response with a deferred outcome.
XtSessionReturnToken	Returns a token obtained using XtSessionGetToken when checkpoint processing is complete.
XtSetEventDispatcher	Registers the event dispatcher procedure for events of the specified type.
XtSetSelectionParameters	Associates target parameters with a selection.
XtToolkitThreadInitialize	Initializes multithreaded support.
XtUnregisterDrawable	Removes an association set by XtRegisterDrawable.
XtVaOpenApplication	Convenience function to initialize intrinsics, create an application context, open a display connection, and create an application shell.

In addition, two new variables are provided in support of the new session shell widget:

• sessionShellClassRec
• sessionShellWidgetClass

See the X Toolkit Intrinsics - C Language Interface, X Window System, X Version 11 Release 6.4 specification available from X.Org for detailed information about each of these functions and variables.

3.4.1 Support for Easy Resource Configuration

Setting and changing resources in X Window System applications can be difficult for both the application developer and the end user. Resource Configuration Management (RCM) addresses this problem by changing the X Intrinsics to immediately modify a resource for the specified widget and each child widget in the hierarchy. As a result:

• No sourcing of resource files is required.
• The application does not need to be restarted for the new resource values to take effect.
• The change occurs immediately.

RCM was made available as part of the X11R6.4 release and is now available with HP DECwindows Motif for HP OpenVMS Alpha Version 1.3. However, note that RCM is not a standard part of the X Toolkit Intrinsics. It is neither an X Consortium standard nor part of the X Window System specifications. As a result, there are currently no public customization tools that take advantage of this feature.

If you are interested in learning more about RCM, see the X Toolkit Intrinsics - C Language Interface, X Window System, X Version 11 Release 6.4 Release Notes available from X.Org.

3.4.2 New Option for CompositeClassExtensionRec

With X11R6, some modifications were made to the widget internals, as described in the X Window System Toolkit manual.

In particular, a new option in the Composite Class extension record enables you to make bundled changes to the managed set of a Composite widget. Widgets that define a change-managed procedure that performs additions and deletions to the managed set of children in a single invocation should set allows_change_managed_set option to TRUE in the extension record.

For more information about the impact this new option may have on existing applications, see the hp DECwindows Motif for hp OpenVMS Alpha Release Notes.

3.5 X Window System Extension and Protocol Enhancements

The following sections describe the new and updated server extensions and protocols available with HP DECwindows Motif for HP OpenVMS Alpha Version 1.3. With the exception of AccessX, all existing extensions continue to be supported.

3.5.1 New X Display Server Extensions

The following X11R6.6 protocol X Window System extensions have been integrated into the DECwindows X11 Display Server and are now supported by HP DECwindows Motif for HP OpenVMS Alpha Version 1.3:

• Application Group (XC-APPGROUP)
• Big Requests (BIG-REQUESTS)
• Colormap Utilization Policy (TOG-CUP)
• Extended Visual Information (EVI)
• Low-Bandwidth X (LBX)
• Security (SECURITY)
• Synchronization (SYNC)
• XC-MISC
• X Double Buffer (DBE)
• XINERAMA (formerly PanoramiX)
• X Keyboard (XKB)

BIG-REQUESTS, EVI, SYNC, TOG-CUP, and XC-MISC are a permanent part of the DECwindows X11 Display Server and are always enabled. DBE, LBX, SECURITY, XC-APPGROUP, XINERAMA, and XKB are dynamically loadable using the DECW$SERVER_EXTENSIONS parameter defined in the DECW$PRIVATE_SERVER_SETUP.COM file. With this symbol, each extension is converted to a shareable image, which is run at server startup. Note that some combinations of extensions can result in conflict; see Section 2.2 for instructions on enabling these extensions.

To access these these extensions, link applications against one or more of the following libraries:

Extension	Library
DBE EVI LBX SECURITY SYNC TOG-CUP XC-APPGROUP XINERAMA	DECW$XEXTLIBSHR
BIG-REQUESTS XC-MISC XKB	DECW$XLIBSHR

For more information about the updates made to the client-side extension library in support of X11R6.6, see Section 3.3.1.

The following sections briefly describe each extension, its function, and any variances from the standard X11R6.6 implementation provided by X.Org. For a detailed description of each extension protocol and the available server requests, see the X Window System (Scheifler and Gettys) series of manuals published by Butterworth-Heinemann, or visit the X.Org web site (http://www.x.org) for the X Window System protocol and library specifications.

3.5.1.1 Application Group Extension (XC-APPGROUP)

XC-APPGROUP enables multiple programs to manage X Window applications on the desktop. This extension allows X applications to be embedded into the window of another program, such as a web browser.

Sets of one or more applications, known as an Application Group, are managed by a controlling application, known as the Application Group Leader. The group shares the Substructure-Redirect attribute of the window with the Application Manager and one or more Application Group Leaders.

Code that uses XC-APPGROUP must include the following header files:

# include "DECW$INCLUDE:Xlib.h" # include "DECW$INCLUDE:Xag.h"

This extension is dynamically loadable (along with the SECURITY extension) at server startup; see Section 2.2. Call the following routine to check if XC-APPGROUP is available on the server system:

Bool XagQueryVersion ( Display *dpy, int *major_version_return, int *minor_version_return );

The following table lists each argument and its description.

Argument	Description
dpy	An input parameter that contains the current display.
major_version_return	Major version number of the extension implementation. Returned by XagQueryVersion.
minor_version_return	Minor version number of the extension implementation. Returned by XagQueryVersion.

3.5.1.2 Big Requests Extension (BIG-REQUESTS)

BIG-REQUESTS enables a client application to extend the length field of a protocol request from 2 ¹⁸ bytes to a 32-bit value. This is useful for clients and other extensions that frequently transmit complex information to the display server.

The only callable function associated with this extension is XExtendedMaxRequestSize, which has been incorporated into Xlib. As such, it is always available when connected to an X Window system that offers this extension.

3.5.1.3 Colormap Utilization Policy Extension (TOG-CUP)

TOG-CUP provides the following colormap management capabilities to the display server:

• A mechanism for a special application (such as a colormap manager) to recognize special colormap requirements. For example, this extension enables an application to locate and initialize a default colormap.
• A policy that encourages colormap sharing and reduces colormap flashing on low-end 8-bit frame buffers.
• A behavior in the color allocation scheme that reduces colormap flashing when colormaps are not shared.

Specifically, the TOG-CUP protocol provides methods that query the server for a list of reserved colormap entries and initialize shareable colormap entries at specific locations. If the core protocol does not contain information about the returned pixel values, the AllocColor and AllocNamedColor requests look in the default colormap for a matching color. If a match is found and the corresponding cell in the private colormap is empty, the color is allocated to that cell in the private colormap rather than the first available location. This minimizes colormap flashing when the main window's default visual class is using a private colormap and is set to GrayScale, PseudoColor, or DirectColor.

Code that uses the TOG-CUP extension must include the following header files:

# include "DECW$INCLUDE:Xlib.h" # include "DECW$INCLUDE:Xcup.h"

This extension is a fixed part of the display server and is always enabled. Call the following routine to check if the TOG-CUP extension is available on the server system:

Bool XcupQueryVersion (display, &major, &minor) Display *display, int major,minor;

Note that client applications must call XcupQueryVersion before calling any other TOG-CUP function.

The following table lists each argument and its description.

Argument	Description
display	An input parameter that contains the current display.
major	Major version number of the extension implementation. Returned by XcupQueryVersion.
minor	Minor version number of the extension implementation. Returned by XcupQueryVersion.