Developer's Toolkit Release Notes for HP-UX 10.30 ABCDE HP Part No.
Legal Notices The information contained in this document is subject to change without notice. Hewlett-Packard makes no warranty of any kind with regard to this manual, including, but not limited to, the implied warranties of merchantability and tness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or direct, indirect, special, incidental or consequential damages in connection with the furnishing, performance, or use of this material.
Printing History July 1997 . . .. . Edition 1 The printing date will change when a new edition is printed. Minor changes may be made at reprint without changing the printing date. The manual part number will change when extensive changes are made.
Contents 1. 2. Announcements Product . . . . . . . . . . . . xterm Superseded by dtterm . . . VueHelp Libraries Removed . . . Obsolete Functions . . . . . . . Changes in Keyboard Functionality Rendering International Characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 1-1 1-1 1-2 1-2 1-3 Features . . . . . . . . . . . . . . . . . . . . . . . . Libraries for Motif and the X Window System Development New Features and Updates . . . . . .
3. Known Problems and Bugs 4. Compatibility Information and Installation Requirements 5. What's Fixed in this Version 6. Questions and Answers 7. What Manuals are Available for This Version 8. Software Availability in Native Languages CDE Threads and Signal Handling . . . . . . . . . . . . . . . . . . . Help System XPM Graphics . . . . . . . . . . . . . . . . . . . . . . Application Con icts With DtHelp Searches . . . . . . . . . . . . . . . Installation . . . . . . . . . . . . . . . .
1 Announcements Product This is a revision of the Developer's Toolkit for HP-UX 10.30. xterm Superseded by dtterm This release of HP-UX includes both the X11 Release 5 and Release 6 versions of xterm, delivered in the following directories as unsupported software: R5: /usr/bin/X11/xterm R6: /usr/contrib/bin/X11/xterm The functionality of xterm is superceded by the industry-standard dtterm terminal emulator, making xterm redundant.
Obsolete Functions XHP functions for internationalized keyboard input have been removed. These HP proprietary functions are no longer needed since X11R5 and R6 provide public, standard APIs that provide equivalent functionality.
Rendering International Characters In X11R3 and X11R4, support for rendering Asian characters was done through a proprietary mechanism called the associate font mechanism. In HP-UX 9.*, rendering of Asian character data requires that two fonts be opened to correctly render all Asian characters. When an Asian font was opened with XLoadFont() or XLoadQueryFont(), the font was checked for the existence of an associate font property.
2 What's In This Version Features The HP-UX Developer's Kit provides information needed to develop applications using the following technologies on HP-UX 10.30 systems. OSF/Motif 1.2 X11 R6 Xlib X11 R6 Xt Intrinsics X11 R6 Athena Widget Set X11 R5 Xlib* X11 R5 Xt Intrinsics* Imake Common Desktop Environment 1.0 Audio Imaging Digital Video (Video Out, MPEG, and Camera) Technical Print Service HP PEX 5.1 Version 4 Starbase The X11 R5 development libraries have been replaced with the R6 libraries.
New Features and Updates The Developer's Toolkit includes these new components: X11 R6.1 Extensions Thread Restricted Libraries Technical Print Service X11 R6.1 Extensions New extensions include: DOUBLE-BUFFER (DBE) ICE X Rendezvous RECORD XKEYBOARD (XKB) The Double Bu er Extension (DBE) provides a standard way to utilize double-bu ering which allows icker-free animation. The Inter-Client Exchange protocol (ICE) speci es a generic communication framework for data exchange between arbitrary clients.
The X Print Service is a collection of components derived from the X 11 Window System, Motif, and Common Desktop Environment (CDE) technologies. For application developers, the main components include: X Print Extension Library The X Print Extension library provides protocol extensions to allow an application to generate print \jobs", \documents", and \pages", and to manage a Print Context.
Documentation The Technical Print Service Developer't Kit does not include a programmer's manual.
Help Widget Library - libDtHelp Help Utility API (DtHelp) HelpDialog Widget API (DtHelpDialog) HelpQuickDialog Widget API (DtHelpQuickD) Terminal Widget Library - libDtTerm Terminal Widget API (DtTerm) Desktop Widget Library - libDtWidget Editor Widget API (DtEditor) ComboBox Widget API (DtComboBox) MenuButton Widget API (DtMenuButton) SpinBox Widget API (DtSpinBox) Calendar Library - libcsa Calendar API (csa) ToolTalk Messaging Library - libtt ToolTalk Toolkit API (ttdt, tttk) ToolTalk Messaging API (
PEX 5.1 Version 4 The Version 4 release of HP PEX 5.1 brings high-performance 3D graphics through the X server to the HP9000 3D Color Workstations. The HP PEX server and HP PEXlib client software extend the capabilities of the X Window System and provide integrated 3D distributed graphics in an open system environment. The Hewlett-Packard implementation is equipped with a number of features for enhanced performance and interoperability.
To determine whether or not the PEX 3D run-time libraries are installed, run /opt/graphics/PEX5/demos/verify_install. If HP PEX resides on your system, verify_install will create a window and draw a rotating \PEX cube" in it|a cube with three letter-shaped holes drilled in it, one per face, one in each dimension. Depending upon your hardware and color map settings, you may experience \technicolor"|the distracting e ect of displayed objects changing colors as color maps with di erent contents are installed.
Example programs developed by Hewlett-Packard are installed in the /opt/graphics/PEX5/examples/hp/ directory. README les under this directory explain how to use the example programs. Example programs that demonstrate portability and functionality of the CGE extensions are in /opt/graphics/PEX5/examples/cge. Programming utilities for visual selection and color map creation provided by the CGE PEX vendors are in /opt/graphics/PEX5/utilities/cge.
Imake The HP-UX 10.30 development environment provides the Imake con guration management tool. This version is based on the X11 R6 implementation released by the X Consortium.
Note Some systems may not have the symbolic links in /opt/video/lib that point libyuv2.sl to libyuv2.1 and libvlVideo.sl to libvlVideo.1 . If this is the case on your system, you will need to use the following commands (one time only) as user root: cd /opt/video/lib ln -s libyuv2.2 libyuv2.sl ln -s libvlVideo.2 libvlVideo.sl Supported Systems The shared libraries included in this kit are designed for use on HP PA-RISC platforms running HP-UX version 10.
Filesets The Digital Video Developer's Kit consists of several lesets.
MpMpegRewind MpMpegScaledFrameSize MpMpegSeek MpMpegSetScale MpMpegStop MpMpegSync MpMpegVideoPtr MpYuv MpYuvInitialSize MpYuvNewSize MpYuvResetSomeVars MpYuvSetScale vlCloseDisplay vlCloseVideoConnection vlDisplayFrame vlEnableColor vlFreeFrame vlGetAudioCapabilities vlGetAudioVolume vlGetColorAdjust vlGetDisplayOffset vlLoadVFile vlMirrorVideo vlOpenDisplay vlOpenVideoConnection vlPauseVideo vlPreBufferVideo vlRefreshVideo vlResumeVideo vlSetAudioQuality vlSetAudioVolume vlSetColorAdjust vlSetDisplayOffs
3 Known Problems and Bugs CDE Threads and Signal Handling All of the CDE public libraries are thread-restricted. This means that the libraries can be called by only a single thread within a multi-threaded application. Two CDE libraries, libtDtTerm and libtt, handle signals in a manner that can a ect a threaded application's behavior. Both libraries register a signal handler to catch certain signals.
Help System XPM Graphics When using an xpm graphic with the Help System, it is strongly recommended that you ll out the xpm speci cation completely|that is, specify a color value, a gray value, and a monochrome value for each pixel. This allows the Help System to degrade the xpm image to your speci cations if it cannot allocate all of the colors for a particular graphic. This may occur, for example, when Help is viewed on a display that does not have full color support.
4 Compatibility Information and Installation Requirements Read this entire document and any other Release Notes or READMEs you may have before you begin an installation or update. If you install all the components included in the HP-UX Developer's Toolkit, you will need approximately 100 megabytes of disk space. The HP-UX Developer's Toolkit consists of these products: X11MotifDevKit This product contains the libraries and functions which allow you to use X1 R6 Xlib and Xt Intrinsics, OSF/Motif and Imake.
Installation To install your software, run the SD-UX swinstall command. It will invoke a user interface that will lead you through the installation. Perform any necessary tasks to get the system running. The manuals Managing HP-UX Software with SD-UX (B2355-90089) and Installing HP-UX 10.0 (B2355-90086) have this information. You may also need to use user documentation for other parts of the system, such as networking, system security, and windowing.
Shared Libraries Stacked libB.sl libA.sl on Archived Library libc.a libB.sl Shared Library Stacked libA.a on Archived Library libc.sl Dynamic Loading of Versioned Libraries When developing an application that dynamically loads versioned libraries, the name used for loading a library requires special attention. Applications should not dynamically load versioned libraries with names of the form library name .sl. Names ending in the .
5 What's Fixed in this Version Patch Releases A description of HP-UX patch releases is available on the World Wide Web. The URL is http://us.external.hp.com. You should check this site for patches that apply to HP-UX 10.30. This information can also be obtained from an ftp server. Use anonymous ftp to access the server hpatlse.atl.hp.com. Change directories to hp-ux_patches/s700_800/10.* to browse patch information.
6 Questions and Answers Writing An Internationalized Motif Application This section describes how to \internationalize" the graphical user interface of a Motif application. Internationalization (I18N) is a design methodology that allows you to develop a single version of your software that works correctly for your user in their chosen language. I18N is a shorthand convention for \internationalization" (\I" followed by 18 letters followed by \N").
HP-UX delivers input methods for all supported non-Asian locales. Input methods for Asian locales are supplied with the language-speci c version of the operating system. For many Asian input methods, the input method must be started before the client starts. In some instances, Xlib can launch the input method on behalf of the client. For additional information, refer to the documentation provided with the input method.
example, to obtain keyboard input in a DrawingArea widget. You can nd the syntax of the XmIm routines in the header le /usr/include/Motif1.2/Xm/Xm.h . The public XmIm APIs are documented in Motif 2.0. The book, X Windows on the World , also includes documentation and examples of using the XmIm APIs. 6.
7 What Manuals are Available for This Version Developer's Toolkit Documentation The following manuals support the HP-UX Developer's Toolkit. These manuals can be ordered in sets, or most can be ordered individually. Series 700 Documentation Product Numbers User Environment manuals (B2355EA #OBL) Motif 1.2 Programmer's Guide, Vol 6A, O'Reilly & Associates (B1171-90074) Motif 1.2 Reference, Vol 6B , O'Reilly & Associates (B1171-90075) Motif 1.
Fast Alpha/Font Manager Programmer's Guide (B2355-90097) Graphics Administration Guide (B2355-90122) PEX Programming manuals (B2355EA #AVE) HP PEX Implementation and Programming Supplement (B3176-90118) PEXlib Programming Manual O'Reilly & Associates (B3176-90003) PEXlib Programming Reference O'Reilly & Associates (B3176-90004) Portable Programming with CGE PEX 5.
PEX Programming manuals (B6205AA #AVE) HP PEX Implementation and Programming Supplement (B3176-90118) PEXlib Programming Manual O'Reilly & Associates (B3176-90003) PEXlib Programming Reference O'Reilly & Associates (B3176-90004) Portable Programming with CGE PEX 5.1 (B3176-90042) PEXlib Developer's README FIRST (B2355-90630) Graphics Administration Guide (B2355-90122) You can order these manuals by contacting your local sales o ce, Parts Direct Ordering (800) 227-8164, or HP DIRECT at (800) 637-7740.
8 Software Availability in Native Languages The HP-UX Developer's Toolkit can be ordered either as an English or Japanese product.
