# ./README_ibm6000

    *
    * RISC System/6000 specific README for IBM Visualization Data Explorer
    *
    *
    *

    The information contained in this file consists of architecture specific
    hints for using the system, help with functions that may not be apparent,
    and last minute updates to the existing documentation.  It is advisable to
    review this file any time Data Explorer updates are applied.

    ========================================================================

    CONTENTS

        To go directly to an item, search for the item number beginning
        at the left margin.

         1. System configuration
            A. User Limits
            B. Prerequisite Software
            C. "OS page space is low, terminating execution"
         2. Hardware Rendering Considerations
            A. Shared Library Support for Hardware Rendering
            B. Hardware Rendering Not Available Message
            C. The Gto
            D. Gt4x under Sequencer control
            E. 2D Graphics Cards with AIX Option X11_3d.gl.rte
            F. The Gto does not support transparency
            G. OpenGL vs GL hardware renderer
            H. Backing store performance using the OpenGL renderer
            I. The GXT1000
         3. User Interface Notes
            A. Visual Program line connections
            B. Differences for AIX 4.1 desktop

    ========================================================================

    1. System configuration

    A. User Limits
    AIX enforces per process limits on the amount of physical memory used by a
    process.  When you want Data Explorer to use large amounts of physical memory,
    it is advised that you change these per process limits using 'smit' by
    traversing the following menu selections:

            Security & Users
            Users
            Change / Show Characteristics of a User

    You may want to change "Max physical MEMORY" to be some number a few megabytes
    less than the machine size.  This number is specified in 512 byte blocks.
    For example, a machine with 64MB may have this limit set to 114688, 56MB.

    B. Prerequisite Software
    The following are required and must be at or greater than the given release
    level...
                      bos.obj             03.02.0000
                      bosext1.csh.obj     03.02.0000
                      X11rte.obj          01.02.0000
                      X11rte.ext.obj      01.02.0000

    If present, the following are required to be at or greater than the given
    release level...
                      X11_3d.gl.rte.obj   01.02.0000
                      X11_3d.obj          01.02.0000
                      X11dev.obj          01.02.0000

    C. "OS page space is low, terminating execution"
    This message occurs when there is not enough page space allocated.
    See "Paging Space" in the general README file.

    2. Hardware Rendering Considerations
    The behavior of Data Explorer on the RISC System/6000 differs in a few
    ways when using the hardware rendering option.

    A. Shared Library Support for Hardware Rendering
    When hardware rendering is requested for the first time, the executive
    dynamically loads /usr/local/dx/bin_ibm6000/DXhwddOGL.o and the OpenGL shared
    libraries.  If one of these is not present then hardware rendering will
    be disabled. See G "OpenGL vs GL hardware renderer".

    B. Hardware Rendering Not Available Message
    When the message 'Hardware rendering not available: /usr/lib/libgl.a not
    found' appears, then GL shared library or run-time support has
    not been installed.

    C. The Gto
    The Gto drawing processor card should have a Date Code greater than 9052,
    and any EC Level except S24699. To determine the Date Code and EC Level,
    type "lscfg -v -l hispddrp*". If either requirement is not met, contact
    IBM Service to request an upgrade to the Drawing Processor Card (hispddrp*).

    D. Gt4x under Sequencer control
    When users of the Gt4x hardware accelerator cards run visual programs
    which generate simple images, either small or with few objects,
    quickly under Sequencer control, their system may be bogged down with
    graphics work.  To avoid this situation, set the throttle parameter either
    to the Display module or with the Throttle dialog for an Image module
    to some small number (e.g. 0.25 seconds).

    E. 2D Graphics Cards with AIX Option X11_3d.gl.rte
    When users try to use hardware rendering on machines which don't support
    3D rendering but on which the X11_3d.gl.rte option is installed, Data
    Explorer may abnormally exit.

    F. The Gto does not support transparency
    The High Speed 3D Graphics Accelerator (Gto) does not support transparency
    when Hardware Rendering is selected.

    G. OpenGL vs GL hardware renderer
    The default hardware renderer on AIX platforms is OpenGL.  To use
    OpenGL, you must start the X server as follows:
       xinit -- -x mbx -x abx -x GLX
    To use the GL hardware renderer export the environment variable DXHWMOD:
      Korn shell (ksh):  export DXHWMOD=DXhwdd.o
      C shell    (csh):  setenv DXHWMOD DXhwdd.o
    (The alternative is DXHWMOD=DXhwddOGL.o)
    You can also choose between OpenGL and GL on the command line to dx
    by specifying -hwrender [gl|opengl]

    H. Backing store performance using the OpenGL renderer
    When DX is in hardware rendering mode it uses a pixel read function
    to read back the image after each complete display.  The saved image is
    used to refresh the window when an area is later obscured and exposed
    (e.g. pop-up menus) and also for erasing lines drawn during use of the
    direct interactors (e.g. zoom box).  When using the OpenGL renderer on
    adapters where the time to read and write pixels is slow relative to
    drawing geometry, it may be preferable to disable this mechanism by
    exporting the environment variable DXNO_BACKING_STORE:

      Korn shell (ksh):  export DXNO_BACKING_STORE=1
      C shell    (csh):  setenv DXNO_BACKING_STORE 1

    This will cause the image to be redrawn when image areas are exposed
    and will cause the direct interactors to erase lines by using black.
    The black lines will persist until the image is redrawn.

    I. The GXT1000
    In order to use hardware rendering of any type (GL 3.2 or OpenGL) on
    the GXT1000, users must start the X server with the GLX, abx and mbx
    server extensions as described in 2G.

    The GXT1000's X server may sometimes leave black rubberbanding
    lines in place when using the Colormap editor or when
    moving icons around on the canvas. These lines will disappear if the
    window is obscured and then exposed.

    If you resize a window which is using hardware rendering on an
    object with non-opaque objects, it is possible that you will see only
    the opaque object in the original location of the window. This is true
    only for GL 3.2 (not OpenGL).

    You should apply the following ptf's. They will fix many of the above
    problems.
    U433080 GXT1000 Maint Package 1 -- superceded by U437136
    U433283 GXT1000 Maint Package 2
    U434859 GXT1000 Maint Package 3 -- superceded by U437136
    U437136 GXT1000 Enhancement Package 4

    3. User Interface Notes

    A. Visual Program line connections
    Graphical objects in the Visual Program Editor (VPE) may not be shown if the
    workspace is larger than 1280x1024 pixels.

    B. Differences for AIX 4.1 desktop
    Some user interface features may look different than they appear
    on other architectures and in the documentation. You can change
    this behavior by setting the following X resources:
    *enableEtchedInMenu: False
    *enableToggleVisual: False

    ----------------------------------------------------------------------

    The following trademarks apply to this information:

    IBM is a registered trademark of International Business Machines Corporation.
    IBM Visualization Data Explorer AIX, AIXwindows, and RISC System/6000
        are trademarks of International Business Machines Corporation.
    OpenGL is a trademark of Silicon Graphics, Inc.