Last modified 18 August 2003 by jdavis@math.wisc.edu

The SMea Kit

The SMea Kit is an open-source, high-level 3D graphics library, written in Objective-C atop OpenGL and Mac OS X's Cocoa framework.

Reference

Methods and functions that issue OpenGL commands are noted; you must ensure that the intended OpenGL context is current when invoking them. All methods return the receiver, except where otherwise noted. Screen coordinates are relative to the view, with the origin in the lower left corner. (This is standard in Cocoa, unless your view's coordinates are flipped.) All angles are measured in radians.

SMKBinaryTree implements a simple binary tree.
- SMKSplayTree is a splay tree datastructure.
- SMKTree implements an arbitrary tree.
  - SMKSceneTree is what scene trees are made of.
SMKBubbleDrawer lets you put a "speech bubble" into an SMKSceneTree.
SMKCamera provides camera control and scene antialiasing.
SMKDrawingManager handles translucency and the drawing of text.
SMKInterpolator lets you control real time in your program.
SMKMatrix packages some basic matrix functionality.
SMKModelDrawer lets you put a customized SMKModel into an SMKSceneTree.
SMKResource is a shared resource that can be managed by SMKResourceManager.
- SMKShape stores a basic 3D shape consisting of triangles and vertices.
  - SMKModel adds normals and texture coordinates to facilitate lighting and texture mapping.
- SMKTexture encapsulates an OpenGL texture object.
SMKResourceManager is a database for shared resources descended from SMKResource.
SMKTester provides picking and collision testing services.
SMKTransformation abstractly describes a rigid-body transformation.
- SMKAxisTransformation is a transformation involving rotation about a single arbitrary axis.

SMKDrawing is the protocol that describes drawers in SMKSceneTrees.
SMKManagedDrawing is a protocol used by SMKDrawingManager.
SMKUtilities is a tiny library of C functions used elsewhere in the SMea Kit.

License and (Lack of) Warranty

This manual is part of the SMea Kit. The SMea Kit is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

The SMea Kit is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this software; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.