./README_sgi

* 
* README for IBM Visualization Data Explorer for SGI.  
* 
* (C) COPYRIGHT International Business Machines Corp. 1991-1997 
* All Rights Reserved. 
* Licensed Materials - Property of IBM 
* 
* US Government Users Restricted Rights - Use, duplication or 
* disclosure restricted by GSA ADP Schedule Contract with IBM Corp. 
* 
* 
  
  
The information contained in this file consists of 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. Hardware Rendering on SGI Platforms 
       A. Exceeding System/Process Memory  
       B. Overriding the default library 
    2. Adding a Module 
       A. Using the Module Builder  
       B. Bad File Magic Number error 
       C. Runtime-loadable modules  
    3. Gamma Correction 
    4. Changes for version 3.1.4  
       A. Using Shared Memory is now the default  
       B. Change in behavior of DXSHMEM 
       C. Fonts have changed  
    5. Using Large Amounts of Memory 
  
======================================================================== 
  
1. Hardware Rendering on SGI Platforms 
  
A. Exceeding System/Process Memory  
The most recent object displayed is stored in system memory. If this object 
is very large it is possible to exceed the system/process memory limits. 
If this occurs you will receive many errors of the following form: 
 ERR#2_gl_makeroom 
  
The only known workaround is to reduce the size of the object(s). 
  
B. Overriding the default library 
If both gl and opengl are supported you can override the default 
library (opengl) by specifying the -hwrender command line option as 
gl, rather than opengl. Alternatively, you can use the DXHWMOD  
environment variable, which should be set to either DXhwdd.o or 
DXhwddOGL.o. 
  
2. Adding a Module 
  
A. Using the Module Builder  
When using the module builder to build a full dxexec, at link time the 
following warning message may appear: 
   /usr/bin/ld: 
   Warning: sscanf: multiply defined 
            previous (used) definition from '/usr/lib/libmpc.a': 
            new (ignored) definition from '/usr/lib/libmpc.a' 
  
This message should be ignored. 
  
B. Bad File Magic Number error 
If IRIX 5 is not installed on the system, the linker will give 
the error message "Object file format error, bad file magic number". 
  
C. Runtime-loadable modules  
You need to use -mdf flag on dx to load runtime modules from the 
command line if you are using more than 1 processor. That is, 
you cannot use the "Load Module Description" option of the File menu 
to load them after Data Explorer has started. 
You may notice warnings when you compile runtime-loadable modules. 
These are simply warnings about subroutines which are referenced 
by the runtime-loadable module. They will be found in the running 
dxexec. These warnings do *not* mean that your subroutine will not 
work. 
  
  
3. Gamma Correction 
When the Data Explorer executive is running on the sgi archecture,  
8-bit windows are assumed to already be gamma-corrected, so 
DXGAMMA is by default set to 1. Otherwise, DXGAMMA is by default 
set to 2. You can override the default gamma correction by  
setting DXGAMMA, DXGAMMA_8BIT, DXGAMMA_12BIT, or DXGAMMA_24BIT. 
If set, DXGAMMA_NBIT overrides the value set by DXGAMMA. 
  
4. Changes for version 3.1.4  
  
A. Using Shared Memory is now the default  
Data Explorer now uses shared memory by default on sgi machines. 
  
B. Change in behavior of DXSHMEM 
In versions of Data Explorer prior to 3.1.4, DXSHMEM, if set to 
anything, would force shared memory to be used. In version 3.1.4, 
DXSHMEM must be set to anything other than -1 for shared memory to be  
used; if set to -1, then the data segment will be extended, for  
architectures for which this is permissible. 
  
C. Fonts have changed  
Data Explorer 3.1.2 and all previous versions used different fonts  
when displaying on sgi machines than when displaying on any other machine.    
In 3.1.4, the fonts are uniform across platforms.  The correct fonts are  
a little bit larger than the old sgi fonts.  This is a potential  
problem for control panels since the some text strings may not fit the  
space allotted.  (This actually fixes a problem where your panels  
looked fine when displaying on an sgi but looked bad when displaying  
on any other machine.) Users can revert to the pre-3.1.4 fonts by  
adding the following to the file DX in $HOME or in a directory in  
the XAPPLRESDIR environment variable: 
DX*fontList:-adobe-helvetica*bold-r*14*=bold,\ 
-adobe-helvetica*bold-r*12*=small_bold,\ 
-adobe-helvetica*bold-r*18*=big_bold,\ 
-adobe-helvetica*bold-r*24*=huge_bold,\ 
-adobe-helvetica*medium-r*14*=normal,\ 
-adobe-helvetica*medium-r*12*=small_normal,\ 
-adobe-helvetica*medium-r*18*=big_normal,\ 
-adobe-helvetica*medium-r*24*=huge_normal,\ 
-adobe-helvetica*medium-o*12*=small_oblique,\ 
-adobe-helvetica*medium-o*18*=big_oblique,\ 
-adobe-helvetica*medium-o*24*=huge_oblique,\ 
-adobe-helvetica*medium-o*14*=oblique 
  
NOTE: line breaks and line continuation characters are here just for  
readability.   The user must enter this as 1 continuous line with no  
line continuation characters, carriage returns, or spaces.   
Only those users who would be satisfied with the restriction of never  
running a net on some machine other than an sgi should consider doing this. 
  
  
5. Using Large Amounts of Memory 
  
If you have problems starting up DX with more than 512 Mbytes of 
memory, use the "systune" command to check and set kernel tuneable 
parameters to allow a user process to allocate more space.  You may 
also have to adjust the "limits" or "ulimits" settings to allow large 
amounts of memory to be used. 
  
  
---------------------------------------------------------------------- 
  
The following trademarks apply to this information: 
  
IBM is a registered trademark of International Business Machines Corporation. 
IBM Visualization Data Explorer is a trademark of International 
    Business Machines Corporation. 
IRIX and Silicon Graphics are registered trademarks of Silicon Graphics, Inc.