HP zx2000 Supplementary Manual
HP zx2000 Supplementary Manual

HP zx2000 Supplementary Manual

Hp zx2000: supplementary guide
Table of Contents

Advertisement

Quick Links

graphics administration guide
for HP-UX 11.X (IPF version)
Document Part Number: 5969-3151
June 2003

Advertisement

Table of Contents
loading

Summary of Contents for HP zx2000

  • Page 1 HP-UX 11.X (IPF version) Document Part Number: 5969-3151 June 2003...
  • Page 2 The warranties for HP products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty.
  • Page 3: Table Of Contents

    DLKM on HP-UX 11.23 and later ....... .
  • Page 4 ..............4–24 mapping options from the previous hp X Server to the current XFree86 X Server ..4–35 defaultVisual option .
  • Page 5: Document Conventions

    Documentation for each graphical application is provided by two manuals: one specific to the application and this manual which provides information common to all of the applications. For example, the primary user interface of the workstation is X Windows which is required whether or not you use any 3D APIs.
  • Page 6 preface 1–2 Graphics Administration Guide...
  • Page 7: Path Names

    This chapter contains information on locating files that reside in the file system. finding files with “whence” and “whereis” There are two main methods of finding commands if you know the name of the command you’re looking for. The first method is to use the Korn shell command whence, which tells you where a command resides.
  • Page 8: Path Names

    path names path names contrib/libglut contrib/libwidget contrib/xglinfo demos include/GL lbin lib/hpux32 lib/hpux64 hpux32/X11/Xserver/modules/ xf86/extensions hpux64/X11/Xserver/modules/ xf86/extensions hpux32 hpux64 2–2 /opt/graphics/OpenGL files Utilities found in the OpenGL Utility Toolkit as mentioned in the OpenGL Programming for the X Window System manual Motif widget library and source code Utility to print display and visual information for OpenGL with the X Window system...
  • Page 9: Compiling Your Application

    This chapter provides information for compiling your application using the OpenGL application programming interface (API). Compiling examples are given for C. compiling OpenGL applications To compile a program that does not use the OpenGL utilities, use a makefile that looks like this: INCDIR=-I/opt/graphics/OpenGL/include LIBDIR32=-L/opt/graphics/OpenGL/lib/hpux32 LIBDIR64=-L/opt/graphics/OpenGL/lib/hpux64...
  • Page 10: Kernel Graphics Drivers

    GVID is not a DLKM, but it is statically built into the kernel. GVID is device-independent. The usage of DLKMs is very different for the 11.22 version of HP-UX and subsequent versions of HP-UX. Both versions of DLKMs are discussed in this section.
  • Page 11: Correctly Configured 11.23 And Later System

    11.23 and later system To determine if the DLKMs are loaded correctly on HP-UX 11.23 and later systems, run the command /usr/sbin/kcmodule -v -q <DLKM Name> (as root). This displays the status of the specified DLKM. The DLKMs that you should look for in a correctly configured graphics system included: gvid_info, the DRM, and the HRM.
  • Page 12: Loading A Graphics Dlkm On Hp-Ux 11.23 And Later

    DRM or the hw_init module. If used, the command will fail. Xf86 loads these modules when it first starts. loading a graphics DLKM on HP-UX 11.23 and later All graphics DLKM s are loaded using the same commands. First change into the directory where the DLKM resides.
  • Page 13: Configuring An X Server On Hp-Ux

    X Server on HP-UX This chapter documents information specific to the HP Xf86 X Server. The X Server is based on the XFree86 version 4.1.0 or later X Server. This section describes features unique to HP's implementation of the X Server, provides information on how to configure the X Server and includes a list of supported X configurations.
  • Page 14: Screen Actions

    X Server on HP-UX screen actions These actions are activated depending on which screens have been chosen. ■ Describe Screen provides information about the device. ■ Identify Screen flashes the monitor that is connected to the graphics device.
  • Page 15: Xf86Config File Format

    It is recommended that the units always be specified when using frequency option values to avoid any errors in determining the value. Graphics Administration Guide configuring an X Server on HP-UX www.xfree86.org ). The manual pages are available...
  • Page 16: Serverlayout Section

    X Server on HP-UX ServerLayout section The ServerLayout section identifies which Screen sections are to be used in a multiheaded configuration, the relative layout of those screens, and which InputDevice sections are to be used. Each ServerLayout section has an Identifier, a list of Screen section identifiers, and a list of InputDevice section identifiers.
  • Page 17 (which is rare). Note: when this value is set to 24. Integer logging and verbosity logging and verbosity configuring an X Server on HP-UX Ctrl+Shift+Break sequences. some clients don't behave well on page 4-19. on page 4-19. 4–5...
  • Page 18: Files Section

    X Server on HP-UX Xserver Options for ServerLayout Section (Continued) Option LogVerbose CursorScaleFactor MaxCursorSize AccelerateIndirectRendering Boolean True Files section The Files section specifies paths to where fonts and modules are located and the location of the rgb database and the user specified logfile. The Files section format is: “Files”...
  • Page 19 /var/X11/Xserver/logs/Xf86.n.log, where n is the display number. All names must be enclosed within double quotes. There may be only one Files section in the configuration file. This section does not recognize Option as a keyword. Graphics Administration Guide configuring an X Server on HP-UX 4–7...
  • Page 20: Module Section

    Modules are searched for in each directory specified in the ModulePath search path and in the drivers, input, extensions, fonts, and HP-UX subdirectories of each directory in the ModulePath. If ModulePath is not specified in the Files section, the default ModulePath is searched.
  • Page 21: Inputdevice Section

    (such as moving the cursor, etc). Source: XF86Config manual page. integer Sets the motion history size. Default: 0. Source: XF86Config manual page. configuring an X Server on HP-UX section, or from the -pointer section, then the first 4–9...
  • Page 22: Screen Section

    X Server on HP-UX The following two examples show an InputDevice section for a keyboard and mouse: Section “InputDevice” Identifier Driver EndSection Section “InputDevice” Identifier Driver Option Option EndSection The above InputDevice section can be modified to run the X Server without a mouse. To do this, simply change the “Device”...
  • Page 23 Disables accelerated dashed lines drawn between two arbitrary points. Disables accelerated transfers of full-color rectangular patterns from system memory to video memory (using a memory-mapped aperture). Disables accelerated fills of a rectangular region with a monochrome pattern. configuring an X Server on HP-UX 4–11...
  • Page 24 X Server on HP-UX Entry XaaNoMono8x8PatternFillTrap XaaNoOffscreenPixmaps XaaNoPixmapCache XaaNoScanlineCPUToScreen ColorExpandFill XaaNoScanlineImageWriteRect XaaNoScreenToScreen ColorExpandFill XaaNoScreenToScreenCopy XaaNoSolidBresenhamLine XaaNoSolidFillRect XaaNoSolidFillTrap XaaNoSolidHorVertLine XaaNoSolidTwoPointLine SuppressVisuals SuppressGlxVisuals Each Screen section must contain one or more Display subsections. Those subsections provide depth configuration information, and the one chosen depends on the depth that is being used for the screen.
  • Page 25: Display Subsection

    Some of the latter are described above in the Screen section, and they may also be included here. However, options set in the Display subsection may be “overridden” in the Screen section. Graphics Administration Guide depth visual “ModeName” configuring an X Server on HP-UX 4–13...
  • Page 26: Monitor Section

    X Server on HP-UX Monitor section The configuration file may have multiple Monitor sections. The Monitor section provides information about the specifications of the monitor, monitor-specific Options, and information about the video modes to use with the monitor. There must be at least one Monitor section, for the monitor being used.
  • Page 27: Device Section

    The device should be a /dev/gvid device (for example, /dev/gvid0, /dev/gvid1) Options are device dependant and should be searched for in device specific sections of this document. Graphics Administration Guide “DeviceID” “driver” “Vname” “busid”] configuring an X Server on HP-UX 4–15...
  • Page 28: Extensions

    X Server on HP-UX extensions double buffer extension (DBE) DBE is an extension to the X Server that provides a double-buffering API. For more information about DBE and the API, consult the DBE manual pages: ■ ■ XdbeQueryExtension ■...
  • Page 29 States defined by VESA DPMS Compliance Power Requirements Savings Not Applicable None Optional Minimal Mandatory Substantial Mandatory Maximum “BlankTime” “StandbyTime” “SuspendTime” “OffTime” configuring an X Server on HP-UX Recovery Time Very Short (<1 sec) Short Longer System Dependent “10” “20” “30” “60” 4–17...
  • Page 30: Dynamic Library Loading

    X Server on HP-UX Option Value BlankTime time StandbyTime time SuspendTime time OffTime time dynamic library loading The path for each dynamically loaded module must be specified in the ModulePath in order for them to load. See the...
  • Page 31: Features

    LogFile closes the built-in default log file and opens the file specified by this option as the default log file, unless the NoLogging option is selected. The NoLogging option overrides this option. Graphics Administration Guide “CursorScaleFactor” “MaxCursorSize” configuring an X Server on HP-UX “n” “Size” 4–19...
  • Page 32: Glx Visual Suppression

    X Server on HP-UX The following is an example of setting the various logging options. The Verbose and LogVerbose options are set so that only error and fatal error messages are sent to stderr and the log file.
  • Page 33: Technical Print Service (Tps)

    It may also be referenced as the X Print Service. Please refer to the tps(5) manual page for details on configuring and using TPS. Graphics Administration Guide configuring an X Server on HP-UX 4–21...
  • Page 34: Virtual Frame Buffer (Xvfb)

    X Server on HP-UX virtual frame buffer (Xvfb) Xvfb(1) is an X Server that does not require display hardware or input devices. It emulates a video frame buffer by using the system’s virtual memory. Xvfb may be used for: rendering with non-standard depths and screen configurations, software rendering, providing a way to run applications that don't need an X Server but for some reason insist on having one, etc.
  • Page 35 /var/tmp for the frame buffer. Xvfb :100 -pixdepths 3 27 -fbdir /var/tmp Graphics Administration Guide Command Line Switches (Continued) Description Specifies the black value the server should use. Specifies the white value the server should use. configuring an X Server on HP-UX 4–23...
  • Page 36: Security

    X Server on HP-UX security This entire section was copied from the XFree86 Xserver(1) manual page. A security file must be placed somewhere on the system and loaded from the command line using the –sp option. The remainder of this section details the format and use of the security file.
  • Page 37 Specify operations that untrusted clients may attempt, and the actions that the server should take in response to those operations. Graphics Administration Guide Security Section Syntax (Continued) is <required property>, the following apply. If <required > configuring an X Server on HP-UX 4–25...
  • Page 38 X Server on HP-UX Syntax Description <operation> Can be r (read), w (write), or d (delete). The following table shows how X Protocol property requests map to these operations in The Open Group server implementation. ListProperties none, untrusted clients can always list all properties <action>...
  • Page 39 # To let untrusted clients use the standard colormaps created # by xstdcmap, include these lines. property RGB_DEFAULT_MAP property RGB_BEST_MAP property RGB_RED_MAP property RGB_GREEN_MAP Graphics Administration Guide configuring an X Server on HP-UX root ar iw root ar iw root root...
  • Page 40: Connecting To The Network

    X Server on HP-UX property RGB_BLUE_MAP property RGB_GRAY_MAP # To let untrusted clients use the color management database # created by xcmsdb, include these lines. property XDCCC_LINEAR_RGB_CORRECTION property XDCCC_LINEAR_RGB_MATRICES property XDCCC_GRAY_SCREENWHITEPOINT property XDCCC_GRAY_CORRECTION # To let untrusted clients use the overlay visuals that many # vendors support, include this line.
  • Page 41: Signal Description

    X Server from the command line Starting X from the command line is not the preferred method of starting X on HP-UX. This documentation outlines the necessary steps to start X from the command line and the command line options for those users who may need to do so.
  • Page 42 X Server on HP-UX /usr/bin/X11/Xf86 [options …] The command line options are specified in the following table. Switch –a –ac –allowMouseOpenFail NA allowNonLocalXvidtune NA –ar1 –ar2 –audit –auth –bestRefresh –broadcast –bs –c 4–30 X Server Command Line Options...
  • Page 43 Set bpp for the frame buffer. Default: 8. Font Sets default cursor font. FontName Default font name. Swaps the default values for the black and white pixels. LocalAddress Specifies the local address to connect from. configuring an X Server on HP-UX (all 4–31...
  • Page 44 X Server on HP-UX X Server Command Line Options (Continued) Switch –fp –gamma –bgmma –ggamma –rgamma –help –l –ignoreABI –indirect –kb –keyboard –ld –lf –ls –nolock –logo nologo –layout –logfile 4–32 Value Description FontPath Sets the search path for fonts. This path is a comma separated list of directories which the X Server searches for font databases.
  • Page 45 Probes for devices, then exit. HostName Enables XDMCP and send Query packets to the specified host. Suppresses most informational messages at startup. The verbosity level is set to zero. configuring an X Server on HP-UX –nolisten tcp –terminate 4–33...
  • Page 46 X Server on HP-UX X Server Command Line Options (Continued) Switch –r –s –scanpci –screen –su –sp –t –terminate –to –tst ttyxx –v –verbose –version –weight 4–34 Value Description Turns off auto-repeat. Turns on auto-repeat. Minutes Sets screen-saver timeout time in minutes.
  • Page 47: Mapping Options From The Previous Hp X Server To The Current Xfree86 X Server

    The purpose of this section is to provide the user, who is familiar with the X* screens files for the HP X Server, a method of setting the equivalent options in the XF86Config file, in the current release of the XFree86 X Server. Only those options that are currently implemented in the release are documented here.
  • Page 48: Defaultvisual Option

    X Server on HP-UX defaultVisual option Class The default class visual can be set in a Display subsection of the Screen section of the XF86Config file using the Visual option. The following example demonstrates how this would be done in the X*screens file and how it would be done in the XF86Config file.
  • Page 49: Minimum Monitor Power Save Level Option

    Graphics Administration Guide on page 4-16 for more details on this option. on page 4-19 for more details. “glx” on page 4-16 for more details on this configuring an X Server on HP-UX on page 4-16 for more details 4–37...
  • Page 50: Input Devices

    X Server on HP-UX input devices keyboards supported keyboard drivers The supported keyboard driver is: keyboard supported keyboard options The following is a list of keyboard options supported by HP. Options Value AutoRepeat Integer Xleds Integer … pointers...
  • Page 51: Output Devices

    False Boolean False Boolean True Boolean False True configuring an X Server on HP-UX supported device Description Enable DVI connector. Enable quad-buffered stereo mode. Synchronizes frame buffer refresh between multiple raster engines. Setting this option causes the device to become a slave to an external timing generator (another device).
  • Page 52: Supported Monitor Configurations

    X Server on HP-UX Options Overlay FSAA These options are enabled by adding a line to the /etc/X11/XF86Config file in the Device section. For example: Option "Overlay" "True" Note that both the option name and option value must be enclosed in quotation marks.
  • Page 53: Overlay Visuals And Overlay Transparency

    *pOverlayVisuals, *pOVis; getVis; *pVisuals; overlayVisualsAtom, actualType; = screen; = XGetVisualInfo(display, VisualScreenMask, &getVis, &nVisuals); malloc ( (size_t)nVisuals * sizeof(OverlayVisualPropertyRec) True); overlayVisualsAtom, 0, numLongs, False, AnyPropertyType, &actualType, &actualFormat, &numLongs, &bytesAfter, &pOverlayVisuals); configuring an X Server on HP-UX Obtain / 4; 4–41...
  • Page 54 X Server on HP-UX pOVis = pOverlayVisuals; while (--nOVisuals >= 0) {if ( pOVis->transparentType == TransparentPixel ) pOVis++; XFree(pOverlayVisuals); **There might be some additional checking of the found **transparent overlay visuals wanted; e.g., for depth. XFree(pVisuals); This program segment is not complete; however, its main purpose is to give an idea of how to find an overlay visual having transparency.
  • Page 55: Ati Firegl X1And Z1 Device-Dependent Information

    Description Boolean False Enable quad-buffered stereo mode. Boolean False Use TrueColor as the default visual instead of PseudoColor. Boolean True Enable the Overlay visuals. Boolean False Enable the Opaque Overlay visual. configuring an X Server on HP-UX supported device 4–43...
  • Page 56 X Server on HP-UX supported monitor configurations The following table documents supported display resolution and refresh rate for the ATI FireGL X1 and ATI FireGL Z1. Check your monitor specification to determine if the monitor supports any or all of these resolutions.
  • Page 57: Ati Radeon™ 7000, Manager Processor And Rx5670 Graphics Solution Device-Dependent Information

    The X server can be either in depth 8 or depth 24 frame buffer mode. In depth 24 mode the available visual is TrueColor. This is the recommended visual. In depth 8 mode the available visual is PseudoColor. The frame buffer depth is configurable through HP’s System Administration Manager (SAM).
  • Page 58: System Requirements

    X Server on HP-UX Resolution (HxV) 1600x1024 1600x1024 1600x1200 1600x1200 1920x1080 1920x1080 1920x1200 ATI Radeon7000 configuration hints Depth 24 is the recommended depth. The benefit is that with the TrueColor visual applications have a large 16M color palette available. Because the TrueColor colormap is read only, it can be shared among multiple applications without any color flashing problems.
  • Page 59 Hz. or 1024x768@75 Hz. resolutions. ■ If the selected monitor resolution and frequency worked with any HP Visualize graphics card (fxe, fx5 or fx10), then the graphics cards documented here also work with a monitor of the same resolution and frequency.
  • Page 60 X Server on HP-UX Visualize Feature 1280x1024 @ 85 Hz Yes 1024x768 @ 85 Hz Yes Hardware multi display miscellaneous fonts The X Server can obtain fonts from directories or font servers. Setting up a font server or making a directory a font directory is beyond the scope of this document.
  • Page 61 File /etc/X11/XF86Config /etc/X11/rgb /etc/Xn.hosts /var/X11/XServer/logs/Xf86.n.log Graphics Administration Guide configuring an X Server on HP-UX Description The configuration file. The X Server uses this file to configure itself during initialization. The color database. Initial access control list for display n. The log file, where n is the display number.
  • Page 62 X Server on HP-UX 4–50 Graphics Administration Guide...
  • Page 63: Server Configuration Details

    This chapter discusses several details concerning the configuration of X hosts, colormaps, mouse and keyboard. making an x*.hosts file The /etc/X0.hosts file is an ASCII text file containing the host names of each remote host permitted to access your local server. ■...
  • Page 64: Initializing The Colormap With Xintcolormap

    X Server configuration details initializing the colormap with xintcolormap The xinitcolormap client initializes the X colormap. Specific X colormap entries (pixel values) are made to correspond to specified colors. An initialized colormap is required by applications that assume a predefined colormap. xinitcolormap has the following syntax: xinitcolormap [<options>] where the <...
  • Page 65: Miscellaneous Topics

    One of the restrictions in using these APIs in multi-threaded programs is that The 3D graphics libraries support kernel threads only (libpthread); they do not support the DCE user threads package (libcma). reference documentation You may find the following documentation helpful when using HP graphics products: For installing products: ■ HP-UX Reference ■...
  • Page 66 miscellaneous topics 6–2 Graphics Administration Guide...

This manual is also suitable for:

Zx6000

Table of Contents