Return to README.rtf CVS log

Up to [NeXTSTEP 3.3 examples] / Examples / 3Dkit / Simple

Annotation of Examples/3Dkit/Simple/README.rtf, revision 1.1.1.1

1.1       root        1: {\rtf0\ansi{\fonttbl\f0\fswiss Helvetica;\f1\fmodern Ohlfs;}
                      2: \paperw8240
                      3: \paperh12580
                      4: \margl120
                      5: \margr120
                      6: {\colortbl;\red0\green0\blue0;}
                      7: \pard\tx960\tx1920\tx2880\tx3840\tx4800\tx5760\tx6720\tx7680\tx8640\tx9600\f0\b\i0\ulnone\fs36\fc0\cf0 Simple
                      8: \b0\fs24 \
                      9: by Bill Bumgarner\
                     10: \
                     11: 
                     12: \b Overview
                     13: \b0 \
                     14: \
                     15: This example demonstrates how to take advantage of many of the features provided by the 3Dkit.  It does this through a subclass of N3DCamera called SimpleCamera. This class controls a very simple 3D environment featuring:\
                     16: 
                     17: \pard\tx200\tx540\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\fi-920\li920\fc1\cf1       - Light Sources\
                     18:                - ambient light\
                     19:                - point light  (close to the surface being lit with an intensity less than or equal to 1.0-- though light sources do accept intensities over 1.0, Pixar strongly recommends against intensity values over 1.0)\
                     20:        - Surface Shader\
                     21:                - simple matte surface, color turned off by default so that it  tracks quickly on a B&W machine (the code to turn on color is included, but commented out)\
                     22:        - Shaded surface rendering.  Drops to wireframe when being manipulated by the mouse. \
                     23:        - A simple scene w/a Torus (though the code to draw a teapot are included and commented out).\
                     24:  - Use of the N3DRotator class to intuitively control 3D rotations via the mouse.\
                     25:  - Saving of RIB code to a file (along with a custom "Display..." command)
                     26: \fi0\li0 \
                     27: 
                     28: \pard\tx960\tx1920\tx2880\tx3840\tx4800\tx5760\tx6720\tx7680\tx8640\tx9600\fc0\cf0 \
                     29: 
                     30: \b Classes defined within Simple
                     31: \b0 \
                     32: 
                     33: \b \
                     34: SimpleCamera\
                     35: 
                     36: \b0 The SimpleCamera is a subclass of N3DCamera (which is a subclass of the View class).  SimpleCamera creates the scene, including the shader, the light sources, and the N3DRotator instance within its initFrame: method.  It also specifies what surface type should be used.  SimpleCamera also supports saving of RIB code to a file via that dumpRib: method that is the target of a menu item in InterfaceBuilder.  SimpleCamera implements a custom mouseDown: method that tracks the mouse in a modal loop and rotates the scene via a modal loop.  When tracking the mouse, SimpleCamera specifies that surfaces should be rendered as wireframe to make the mouse tracking more responsive.\
                     37: \
                     38: 
                     39: \b SimpleShape\
                     40: 
                     41: \b0 SimpleShape is a subclass of N3DShape that implements a single method;  renderSelf:, that calls RiTorus.  The code needed to generate the classic teapot is also included. 
                     42: }

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.