contents.txt

File, Folder or Disk Folder                     Description                             
-------------------- -------------------------- --------------------------------------- 
Doc                  \                          Soft-copy versions of                   
                                                programming references                  
                                                and guides.                             
Lib                  \                          Libraries: drivers and driver           
                                                installation documents,                 
                                                C header files, and C linkable          
                                                library files.                          
Utl                  \                          Utilities: 2-D and 3-D                  
                                                art conversion and                      
                                                processing.                             
Contents.txt         \                          Information about all                   
                                                the key files in this                   
                                                release and where they                  
                                                reside.                                 
Install.txt          \                          Instructions for installing the         
                                                development hardware and                
                                                software.  Follow these                 
                                                instructions after reading              
                                                readme.txt.                             
Legal.txt            \                          Legal copyright and                     
                                                disclaimer information.                 
Readme.txt           \                          Readme: read this document              
                                                before using this system!               
rs32e301.exe         \Doc                       Adobe Acrobat with Search,              
                                                version 3.01.  Allows you               
                                                to search across the                    
                                                contents of multiple                    
                                                documents.                              
Drv                  \Lib                       Windows drivers for the Set2.1          
                                                development hardware.                   
                                                It's necessary to install these         
                                                video drivers on the target             
                                                development machine                     
                                                in order to see the output.             
Kamui                \Lib                       Includes, libraries and sample          
                                                programs for Kamui, a low-              
                                                level graphics API.                     
Ninja                \Lib                       Includes, libraries, demos,             
                                                and sample programs for                 
                                                Ninja, a medium- to high-               
                                                level graphics API.                     
arc1akamui.inf       \Lib\Drv                   Installation file for ARC1.  Use        
                                                the Add New Hardware...                 
                                                wizard in conjunction with              
                                                this file to install this driver.       
Arc1dev.dll          \Lib\Drv                   ARC1 virtual device driver for          
                                                Windows 95.                             
Arc1dev.vxd          \Lib\Drv                   Windows 95 virtual device               
                                                driver (VxD) for ARC1                   
Install.txt          \Lib\Drv                   Instructions for installing the         
                                                development hardware and                
                                                software.  Follow these                 
                                                instructions after reading              
                                                readme.txt.                             
Kamui.dll            \Lib\Drv                   Kamui hardware-control library          
                                                run-time DLL.                           
Kamui.ini            \Lib\Drv                   The Kamui driver configuration          
                                                file.  This file is copied to           
                                                C:\WINDOWS upon installation.           
                                                The file has a few user-selectable      
                                                parameters; see install.txt.            
Kmimem.dll           \Lib\Drv                   Memory configuration dynamic            
                                                link library.                           
Kmimem.ini           \Lib\Drv                   Memory configuration information.       
                                                Not user modifiable.                    
Msvcrt.dll           \Lib\Drv                   Microsoft Visual C++ run-time           
                                                module.  This module may                
                                                already be installed on your            
                                                system; if so, updating this            
                                                component is not                        
                                                necessary.                              
Kmsrv.exe            \Lib\Drv                   The driver access control               
                                                program for Kamui.  Grants              
                                                access to the PowerVR                   
                                                card to one application at              
                                                a time.                                 
Pcutil.dll           \Lib\Drv                   Handles Kamui auxiliary                 
                                                BMP format parsing                      
                                                and saving functions.                   
                                                Loaded at run-time by                   
                                                kmsrv.exe.                              
Previous             \Lib\Drv                   The Kamui drivers that shipped
                                                with the previous development
                                                system release.  Use these
                                                drivers only if you experience
                                                problems with the demos for
                                                the more recent drivers.
Include              \Lib\Kamui                 C include files for Kamui               
                                                applications.                           
Lib                  \Lib\Kamui                 Linkable library files for Kamui.       
Samples              \Lib\Kamui                 Sample Kamui applications.              
                                                Source code and original                
                                                art is provided for these               
                                                samples.                                
Cubes                \Lib\Kamui\Samples         Sample application which                
                                                shows one way to create                 
                                                and maintain a simple                   
                                                hierarchy of objects in                 
                                                Kamui.                                  
Modtest01            \Lib\Kamui\Samples         Sample application demonstrating        
                                                moving two textures across two          
                                                modifier surfaces.                      
QTDirect             \Lib\Kamui\Samples         Sample application that                 
                                                demonstrates the use                    
                                                of kmRenderDirect().                    
QuikTest             \Lib\Kamui\Samples         Sample application that                 
                                                demonstrates some                       
                                                useful Kamui optimizations.             
Reload01             \Lib\Kamui\Samples         Sample application that                 
                                                loads and displays one                  
                                                texture applied to nine                 
                                                different mipmap sizes.                 
Rendtx02             \Lib\Kamui\Samples         Sample application that                 
                                                shows how to render flat                
                                                textures into a display                 
                                                buffer, and then use                    
                                                the rendered buffer as                  
                                                a texture in a multipass                
                                                rendering.                              
Rendtx03             \Lib\Kamui\Samples         Sample application demonstrating        
                                                use of back planes for generating       
                                                motion blur effects.  This sample       
                                                also demonstrates using the frame       
                                                buffer as a texture.                    
Txtest01             \Lib\Kamui\Samples         Sample application that renders         
                                                textures from twiddled ARGB4444,        
                                                ARGB1555, and RGB565 formats.           
                                                The textures are resized with and       
                                                without clamping of u and v             
                                                coordinates.                            
Txtest02             \Lib\Kamui\Samples         Sample application that renders         
                                                textures from twiddled ARGB4444,        
                                                ARGB1555, and RGB565 formats.           
                                                These textures are mipmapped.           
                                                The textures are resized with and       
                                                without clamping of u and v             
                                                coordinates.                            
Txtest03             \Lib\Kamui\Samples         Sample application that renders         
                                                textures from vector-quantization       
                                                (VQ) compressed textures.  A            
                                                texture is rendered in ARGB1555         
                                                mode against a filled background.       
Txtest05             \Lib\Kamui\Samples         Sample application that shows           
                                                how to render a rectangular             
                                                texture.  This texture is in            
                                                ARGB4444 format and has                 
                                                texel size 128x32; however, it          
                                                is displayed as a scaling square.       
katana.inc           \Lib\Kamui\Samples         The default set of make rules           
                                                for making all Ninja projects           
                                                under Microsoft Visual C++.             
                                                This make occurs via the                
                                                command line.                           
Make.bat             \Lib\Kamui\Samples         Run this batch file to build            
                                                all examples in subdirectories          
                                                of this directory.  Visual C++          
                                                5.0 must be installed.                  
makefile             \Lib\Kamui\Samples         nmake-format makefile that              
                                                makes all the Kamui examples            
                                                in these subdirectories.                
MakePath.exe         \Lib\Kamui\Samples         If you've not run the VCVARS32.BAT      
                                                batch file, this short utility rewrites 
                                                the MAKE.BAT make file to               
                                                refer to your local INCLUDE and         
                                                LIB directories.                        
Demo                 \Lib\Ninja                 Demonstrations of some of               
                                                the rendering capabilities              
                                                of the system.  No source code          
                                                is currently provided for these         
                                                demonstrations.                         
Include              \Lib\Ninja                 C include files that                    
                                                should be included to                   
                                                build Ninja programs                    
                                                and sample applications.                
Lib                  \Lib\Ninja                 Ninja C libraries.  Link                
                                                directly with all these                 
                                                libraries when building                 
                                                a Ninja application.                    
Samples              \Lib\Ninja                 Ninja sample applications.              
                                                Source code is provided                 
                                                for these sample                        
                                                applications.                           
Cache                \Lib\Ninja\Samples         Sample application showing how          
                                                ninety textures can be loaded           
                                                with njLoadTexture() and played         
                                                back in a very short movie.             
Draw2D               \Lib\Ninja\Samples         Sample application which shows          
                                                drawing 2-D objects with Ninja.         
                                                Allows the user to draw points,         
                                                lines, polygon, and circles.            
Draw3D               \Lib\Ninja\Samples         Sample application that shows           
                                                several Ninja 3-D primitives            
                                                and models rendered in                  
                                                several modes.  Models are              
                                                rendered with and without               
                                                textures, in wireframe,                 
                                                and with and without depth              
                                                fogging.  A quick motion                
                                                blur demo is also included.             
Light                \Lib\Ninja\Samples         Sample application that                 
                                                demonstrates how to manage              
                                                multiple (in this case, six) light      
                                                sources in a scene.  Each light         
                                                source can be turned on or off          
                                                and the color of each light             
                                                source can be changed in                
                                                real-time.                              
Logo                 \Lib\Ninja\Samples         Sample application that shows           
                                                how to use Ninja for                    
                                                environmental mapping.                  
Map                  \Lib\Ninja\Samples         Sample application demonstrates         
                                                use of a modifier volume, which         
                                                is a unique bit of PowerVR              
                                                technology.  To operate this            
                                                demonstration, hold down                
                                                any of the A, C, D, X, or               
                                                Z keys and press arrow                  
                                                keys simultaneously.                    
                                                Return or Enter enables                 
                                                or disables the light                   
                                                volume.                                 
Motlink              \Lib\Ninja\Samples         Sample application that                 
                                                shows how to create                     
                                                an object hierarchy                     
                                                and animate that                        
                                                hierarchy using either                  
                                                linear or spline based                  
                                                animation.                              
Scroll               \Lib\Ninja\Samples         Sample application shows two            
                                                independently scrolling playfields.     
                                                One field has an alpha channel.         
Shape                \Lib\Ninja\Samples         Sample application that                 
                                                demonstrates the use of                 
                                                njDrawShapeMotion()                     
                                                to animate a model.                     
Sprite               \Lib\Ninja\Samples         Sample application shows what           
                                                looks to be a matrix of spheres         
                                                spinning in space.  In fact each        
                                                sphere is actually a Ninja 3-D          
                                                sprite object.                          
Teapot               \Lib\Ninja\Samples         Sample application shows the            
                                                classic Utah teapot, this time          
                                                with an environmental map               
                                                and specular highlights.                
Temjin               \Lib\Ninja\Samples         Sample application showing              
                                                hierarchical animation technique        
                                                using Ninja.  This application          
                                                also reuses the frame buffer            
                                                for a hall-of-mirrors effect.           
Texture              \Lib\Ninja\Samples         Sample application demonstrating        
                                                how to draw flat textures under         
                                                Ninja using njDrawTexture().            
Torus                \Lib\Ninja\Samples         Sample application that draws           
                                                eight torii with different              
                                                material values.  This demo             
                                                runs faster on machines with            
                                                faster CPUs -- the polygon              
                                                counts you see may be a                 
                                                limited by the speed of your            
                                                target machine's CPU.                   
katana.inc           \Lib\Ninja\Samples         The default set of make rules           
                                                for making all Ninja projects           
                                                under Microsoft Visual C++.             
                                                This make occurs via the                
                                                command line.                           
Make.bat             \Lib\Ninja\Samples         Run this batch file to set              
                                                paths correctly before                  
                                                executing the recursive                 
                                                make.                                   
makefile             \Lib\Ninja\Samples         This is a Visual C++ nmake-             
                                                style makefile that knows               
                                                how to make all examples                
                                                residing in these                       
                                                subdirectories.                         
MakePath.exe         \Lib\Ninja\Samples         If you've not run the VCVARS32.BAT      
                                                batch file, this short utility rewrites 
                                                the MAKE.BAT make file to               
                                                refer to your local INCLUDE and         
                                                LIB directories.                        
Gfx                  \Utl                       2-D and 3-D graphics                    
                                                conversion and processing               
                                                utilities.                              
Conv                 \Utl\Gfx                   Graphics conversion and                 
                                                processing utilities.                   
NjViewer             \Utl\Gfx                   Utility for viewing Ninja objects       
                                                and changing material values            
                                                associated with objects.                
Pc                   \Utl\Gfx\Conv              PC-based art processing tools.          
Sgi                  \Utl\Gfx\Conv              Silicon Graphics-based art              
                                                processing tools.                       
3DSMaxR2             \Utl\Gfx\Conv\Pc           Plug-in for 3D Studio Max               
                                                R2.  Converts models from               
                                                R2 format to Ninja format.              
Gigen                \Utl\Gfx\Conv\Pc           Ninja global index generator.           
                                                Ninja textures are uniquely             
                                                identified by an integer.               
                                                This utility renumbers all              
                                                the textures in a directory.            
Lightwav             \Utl\Gfx\Conv\Pc           Plug-in for Lightwave.                  
                                                This plug-in exports                    
                                                Lightwave format to                     
                                                Ninja format.                           
Softimag             \Utl\Gfx\Conv\Pc           Plug-in for Softimage for               
                                                Windows NT.  Converts                   
                                                Softimage objects to                    
                                                Ninja format.                           
Texture              \Utl\Gfx\Conv\Pc           Texture conversion and                  
                                                compression utilities                   
                                                that run on the command                 
                                                line.                                   
ninjasgi.tar         \Utl\Gfx\Conv\Sgi          Alias to Ninja file converter for       
                                                Silicon Graphics workstations.          
                                                This file is a Un*x tar archive.        
siexpm2.tar          \Utl\Gfx\Conv\Sgi          Softimage for SGI to                    
                                                Ninja exporter.  Optimized              
                                                for the mips2000 series                 
                                                of processors.                          
siexpm4.tar          \Utl\Gfx\Conv\Sgi          Softimage for SGI to Ninja              
                                                format converter.  Optimized            
                                                for the mips4000 series of              
                                                processors.                             
3DSMax               \Utl\Gfx\NjViewer          Sample models created                   
                                                using 3D Studio Max                     
                                                version R2.                             
Alias                \Utl\Gfx\NjViewer          Sample models created                   
                                                using Alias.                            
Lightwav             \Utl\Gfx\NjViewer          Sample models created                   
                                                using Lightwave.                        
Softimag             \Utl\Gfx\NjViewer          Sample models created                   
                                                using Softimage for                     
                                                Windows NT.                             
Njviewer.exe         \Utl\Gfx\NjViewer          Ninja Viewer utility.  This             
                                                utility loads and views Ninja           
                                                object files (.NJA) and                 
                                                applies Ninja animations                
                                                to them (.NAS).                         
Arm                  \Utl\Gfx\NjViewer\3DSMax   A scooping and lifting                  
                                                mechanical arm.                         
                                                Animation included.                     
Ball                 \Utl\Gfx\NjViewer\3DSMax   Texture-mapping logo                    
                                                onto a lit sphere.                      
Bkanga               \Utl\Gfx\NjViewer\3DSMax   Dinosaur constructed                    
                                                from abstract geometric                 
                                                primitives.  A simple                   
                                                animation is included.                  
Bowl                 \Utl\Gfx\NjViewer\3DSMax   Ten pins and a bowling                  
                                                ball on a wooden lane.                  
                                                The animation shows                     
                                                knocking over nine                      
                                                pins.                                   
Face                 \Utl\Gfx\NjViewer\3DSMax   3D Studio Max standard                  
                                                face animation.                         
Heli                 \Utl\Gfx\NjViewer\3DSMax   Model and animation                     
                                                of a helicopter in                      
                                                a sky sphere.  Rotors                   
                                                rotate.                                 
Ikb                  \Utl\Gfx\NjViewer\3DSMax   The classic 3D Studio Max               
                                                bird, modelled with inverse             
                                                kinematic animation to                  
                                                make its nose follow a                  
                                                rubber duck.                            
Mirrorbx             \Utl\Gfx\NjViewer\3DSMax   A cube with a tiled                     
                                                texture map.                            
Teapot               \Utl\Gfx\NjViewer\3DSMax   Everyone's favorite Utah                
                                                teapots.  The animation                 
                                                stretches and scales                    
                                                three independent                       
                                                teapots.                                
Texbox               \Utl\Gfx\NjViewer\3DSMax   Another cube, this time                 
                                                with five independent                   
                                                textures, one for each                  
                                                face.                                   
Torus                \Utl\Gfx\NjViewer\3DSMax   Torus with an environmental             
                                                building map.                           
Loop                 \Utl\Gfx\NjViewer\Alias    A strip with two twists.                
                                                Animation shows a ball                  
                                                travelling around the                   
                                                strip.                                  
Sysmark              \Utl\Gfx\NjViewer\Alias    The Sega of Japan                       
                                                System R&D logo,                        
                                                modelled in Alias.                      
Ufoman               \Utl\Gfx\NjViewer\Alias    The Alias UFO guy,                      
                                                bouncing up and down                    
                                                in his UFO.                             
Woman                \Utl\Gfx\NjViewer\Alias    An animation and model                  
                                                of a walking woman.                     
Fish                 \Utl\Gfx\NjViewer\Lightwav A three-segmented fish                  
                                                with swimming animation.                
Jump                 \Utl\Gfx\NjViewer\Lightwav Model and animation                     
                                                of a jumping robot.                     
Koke                 \Utl\Gfx\NjViewer\Lightwav Model and running                       
                                                animation of koke.                      
                                                See also the Ninja                      
                                                koke sample program.                    
Okori                \Utl\Gfx\NjViewer\Lightwav A stylized animation                    
                                                scene, mirrored across                  
                                                a plane.                                
F40Strip             \Utl\Gfx\NjViewer\Softimag A race car model,                       
                                                generated with Ninja's                  
                                                strip optimizer.                        
Fishman              \Utl\Gfx\NjViewer\Softimag The model from the                      
                                                fishman Ninja demo.                     
                                                The animation from                      
                                                the demo is included.                   
FshStrip             \Utl\Gfx\NjViewer\Softimag The same model as                       
                                                fishman, but generated                  
                                                with the Ninja strip                    
                                                optimizer.                              
Nasumap              \Utl\Gfx\NjViewer\Softimag A sample track model.                   
Por                  \Utl\Gfx\NjViewer\Softimag Another race car model.                 
Rocktman             \Utl\Gfx\NjViewer\Softimag Our hero Rocketman                      
                                                pushing a bicycle as                    
                                                fast as it will go.                     
