_________ ____ AVS on UNIX WORKSTATIONS INSTALLATION/ RELEASE NOTES ____________ Release 5.5 Final (50.86 / 50.88) November, 1999 Advanced Visual Systems Inc.________ Part Number: 330-0120-02 Rev L NOTICE This document, and the software and other products described or referenced in it, are con®dential and proprietary products of Advanced Visual Systems Inc. or its licensors. They are provided under, and are subject to, the terms and conditions of a written license agreement between Advanced Visual Systems and its customer, and may not be transferred, disclosed or otherwise provided to third parties, unless oth- erwise permitted by that agreement. NO REPRESENTATION OR OTHER AFFIRMATION OF FACT CONTAINED IN THIS DOCUMENT, INCLUDING WITHOUT LIMITATION STATEMENTS REGARDING CAPACITY, PERFORMANCE, OR SUI- TABILITY FOR USE OF SOFTWARE DESCRIBED HEREIN, SHALL BE DEEMED TO BE A WARRANTY BY ADVANCED VISUAL SYSTEMS FOR ANY PURPOSE OR GIVE RISE TO ANY LIABILITY OF ADVANCED VISUAL SYSTEMS WHATSOEVER. ADVANCED VISUAL SYSTEMS MAKES NO WAR- RANTY OF ANY KIND IN OR WITH REGARD TO THIS DOCUMENT, INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PUR- POSE. ADVANCED VISUAL SYSTEMS SHALL NOT BE RESPONSIBLE FOR ANY ERRORS THAT MAY APPEAR IN THIS DOCUMENT AND SHALL NOT BE LIABLE FOR ANY DAMAGES, INCLUDING WITHOUT LIMI- TATION INCIDENTAL, INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES, ARISING OUT OF OR RELATED TO THIS DOCUMENT OR THE INFORMATION CONTAINED IN IT, EVEN IF ADVANCED VISUAL SYSTEMS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. The speci®cations and other information contained in this document for some purposes may not be com- plete, current or correct, and are subject to change without notice. The reader should consult Advanced Visual Systems Inc. for more detailed and current information. Copyright 1999 Advanced Visual Systems Inc. All Rights Reserved AVS and IVP are trademarks of Advanced Visual Systems Inc. AVS/EXPRESS is a registered trademark of Advanced Visual Systems Inc. All other product names mentioned herein are the trademarks or registered trademarks of their respective owners. RESTRICTED RIGHTS LEGEND (U.S. Department of Defense Users) Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights In Technical Data and Computer Software clause at DFARS 252.227± 7013. RESTRICTED RIGHTS NOTICE (U.S. Government Users excluding DoD) Notwithstanding any other lease or license agreement that may pertain to, or accompany the delivery of this computer software, the rights of the Government regarding its use, reproduction and disclosure are as set forth in the Commercial Computer Software Ð Restricted Rights clause at FAR 52.227± 19(c)(2). Advanced Visual Systems Inc. 300 Fifth Ave. Waltham, MA 02451 Printed in U.S.A. _________ ____ CONTENTS _________ ____ ______________________________________________________1 AVS 5.5 Release Notes Release Highlights 1-1 Organization 1-3 AVS 5.5 Media Kit 1-4 License Requirements 1-4 Implementation Overview 1-5 ______________________________________________________2 AVS 5.5 Installation Introduction 2-1 Quick Start Instructions 2-1 Installation Steps 2-2 Remote Installations 2-3 Step 1: Decide Where to Install AVS 2-4 Step 2: Mount the CD 2-4 Step 3: Install AVS 2-6 Install man page 2-10 Step 4: Install license 2-11 If you are installing a new license: 2-11 If you are upgrading an existing license: 2-12 If you are using a demonstration license: 2-13 Before you begin 2-13 How licensing works 2-13 Selecting your host server 2-15 Obtaining a license 2-15 Installing a new license.dat ®le 2-18 Upgrading an existing license.dat ®le 2-18 Installing a demonstration license 2-19 Running licdiag to verify your licensing installation 2-20 Installing the FLEXlm software daemons 2-21 Step 5: Test Install 2-22 Step 6: Tell Users How to Find AVS 2-23 Distribution Contents 2-24 Source Code 2-26 __________________ ________ Contents AVS 5.5 Release Notes iii ____ _________ ______________________________________________________3 AVS 5.5 on UNIX Platforms Introduction 3-1 New Features in AVS 5.5 3-2 Geometry Camera 3-2 Function Key, Arrow Key, Mouse Event Masking 3-3 New Example modules 3-4 AVS/Animator source code 3-5 Documentation updates 3-6 AVS 5 Documentation set in PDF format 3-6 New Chapter: Debugging in AVS 5 3-7 AVS®eld_points_array_size 3-7 AVSoutput_string 3-8 AVSpath variable 3-8 Choice value output example 3-8 Read Field module accepts short data 3-9 Geometry Viewer object parameter 3-9 Unexposed command line options 3-9 New Arbitrary Slice parameter Slice Size 3-10 X Windows and Graphics 3-11 X Implementation 3-11 Graphics Libraries: OpenGL 3-12 X Server Color 3-16 Window Manager 3-19 X Terminal and Remote Display Support 3-21 Stereo Support 3-23 Japanese, Greek, and Cyrillic Labels in Geometry Viewer 3-25 Programming Considerations 3-26 GEOMint_color 3-26 C++ Support 3-27 FORTRAN Modules on 64-bit systems 3-27 Fixed in AVS 5.5 3-29 User Interface Issues 3-29 AVS Kernel, LibFlow or CLI issues 3-30 Geometry Viewer issues 3-31 Licensing Issues 3-32 Module Issues 3-33 Known Problems 3-35 ______________________________________________________4 AVS 5.5 for Compaq Tru64 UNIX Introduction 4-1 Hardware Prerequisites 4-1 Workstation Models 4-1 Graphics Hardware 4-1 Memory 4-2 Disk Space 4-3 Swap Space 4-3 Software Prerequisites 4-5 Operating System: Compaq Tru64 UNIX 4-5 ________ __________________ iv AVS 5.5 Release Notes Contents _________ ____ Graphics Software 4-5 Stereo 4-7 Shared Memory Usage 4-9 Using AVS on Compaq Tru64 UNIX 4-9 Peripherals 4-9 Colormap Sharing 4-9 Renderers 4-10 Image Viewer 4-10 Network Editor 4-10 Modules 4-10 Remote Module Execution 4-10 Image Output 4-10 Graph Viewer 4-11 Geometry Viewer 4-11 Rendering Features 4-11 Notes 4-13 Programming Considerations 4-14 Compiling and Linking Modules 4-14 FORTRAN Modules 4-14 AVS on Compaq Tru64 UNIX: Known Problems 4-15 AVS on Compaq Tru64 UNIX: Fixed Problems 4-16 ______________________________________________________5 AVS 5.5 for Hewlett Packard Introduction 5-1 Hardware Prerequisites 5-1 Workstation Models 5-1 Graphics Hardware 5-1 Memory 5-3 Disk Space 5-3 Swap Space 5-3 Software Prerequisites 5-5 HPUX 5-5 OpenGL 5-5 PHIGS and PowerShade 5-6 Using AVS on an HP 9000/7xxfP Workstation 5-7 Peripherals 5-7 Colormap Sharing 5-7 Enabling Double Buffering on Builtin Graphics Boards 5-9 Starting AVS 5-9 Renderers 5-10 Visual Type 5-10 Image Viewer 5-10 Network Editor 5-11 Modules 5-11 Remote Module Execution 5-11 Image Output 5-11 Graph Viewer 5-11 Geometry Viewer 5-11 __________________ ________ Contents AVS 5.5 Release Notes v ____ _________ Stereo Support 5-12 Rendering Features 5-12 Notes 5-14 Programming Considerations 5-15 Module Generator 5-15 Compiling and Linking Modules 5-16 Fortran 5-16 AVS on HP Workstations: Known Problems 5-16 ______________________________________________________6 AVS 5.5 for IBM RS/6000 Introduction 6-1 Hardware Prerequisites 6-1 Workstation Models 6-1 Graphics Hardware 6-1 Memory 6-4 Swap Space 6-4 Shared Memory Limitation: shmat: too many open ®les 6-5 Software Prerequisites 6-6 AIX 6-6 Graphics Library: OpenGL 6-7 Graphics Library: GL 6-7 Using AVS on the IBM RS/6000 6-8 General 6-8 Window Manager 6-9 Starting AVS 6-9 Image Viewer 6-12 Color 6-12 Network Editor 6-13 Modules 6-13 Using the Geometry Viewers Image Output Port 6-13 Graph Viewer 6-14 Geometry Viewer 6-14 Color 6-14 Rendering Features 6-15 Notes 6-17 Programming Considerations 6-19 Compiling and Linking Modules 6-19 Compiling with C 6-19 Using FORTRAN in AVS 6-19 AVS on IBM RS/6000 Workstations: Known Problems 6-21 AVS on IBM RS/6000 Workstations: Fixed Problems 6-22 ______________________________________________________7 AVS 5.5 for Silicon Graphics Introduction 7-1 Hardware Prerequisites 7-1 Workstation Models 7-1 ________ __________________ vi AVS 5.5 Release Notes Contents _________ ____ Graphics Hardware 7-2 Memory Requirements 7-2 Disk Space 7-3 Determining Your Con®guration 7-3 Software Prerequisites 7-4 IRIX Operating System 7-4 Swap Space 7-4 Using AVS on an SGI Workstation 7-5 General 7-6 Window Manager 7-6 Starting AVS 7-6 Image Viewer 7-8 Network Editor 7-8 Modules 7-9 Image Output 7-9 Graph Viewer 7-9 Geometry Viewer 7-9 Color 7-9 Stereo Support 7-10 Rendering Features 7-11 Notes 7-13 Programming Considerations 7-14 Compiling and Linking Modules 7-14 Compiling with C 7-14 FORTRAN Modules 7-15 AVS on SGI Workstations: Known Problems 7-15 AVS on SGI Workstations: Fixed Problems 7-18 ______________________________________________________8 AVS 5.5 For Sun SunOS5 Introduction 8-1 Hardware Prerequisites 8-1 Con®gurations 8-1 SPARC Models 8-2 Graphics Hardware 8-2 Memory 8-5 Disk Space 8-5 Software Prerequisites 8-5 Graphics Libraries: OpenGL 8-6 Graphics Libraries: XGL 8-7 Window System 8-7 Swap Space: Increasing Limits 8-8 Shared Memory Segment Size 8-10 Using AVS on Sun SPARCstations 8-12 Peripherals 8-12 Stereo Support 8-12 Window Manager 8-13 Starting AVS 8-13 Display Size: GX, GS, SX, S24 8-13 __________________ ________ Contents AVS 5.5 Release Notes vii ____ _________ Visual Type: Pseudocolor on Truecolor Adapters 8-14 Loader Messages at Startup 8-15 Image Viewer 8-15 Network Editor 8-15 Modules 8-15 Graph Viewer 8-15 Geometry Viewer 8-16 OpenGL differences 8-16 Color and Single/Double Buffering 8-16 Rendering Features 8-17 Notes 8-19 Programming Considerations 8-20 Compiling and Linking Modules 8-21 AVS on SunOS