TSIPP Quick Reference

Data Types

• color - {red green blue}, 0.0 <= n <= 1.0
• opacity - {red green blue} or {all}, 0.0 <= n <= 1.0
• vertex - {x y z}
• vertex/texture pair - {{x y z} {u v w}}
• vector - {x y z}
• angle - R1.2, D10.5
• matrix -

      {{1.2  1.4  0.1  0}
       {2.1  2.3  1.6  0}
       {2.4  6.1  2.6  0}
       {2.9  1.1  3.6  1}}
  

Polygons and Surfaces

• SippPolygonPush [-tex|-notex|-clock|-counter] vertexList
• SippPolygonClear
• SippSurfaceCreate shaderhandle
• SippSurfaceUnref surfacelist|ALL
• SippSurfaceSetShader surfacelist shaderhandle

Shaders

• SippShaderBasic ambient specular c3 color [opacity]
• SippShaderPhong ambient diffuse specular spec_exp color [opacity]
• SippShaderStrauss ambient smoothness metalness color [opacity]
• SippShaderWood ambient specular c3 scale basecolor ringcolor [opacity]
• SippShaderMarble ambient specular c3 scale basecolor stripcolor [opacity]
• SippShaderGranite ambient specular c3 scale color1 color2 [opacity]
• SippShaderBozo ambient specular c3 scale colorlist [opacity]
• SippShaderBumpy shaderhandle scale [BUMPS] [HOLES]
• SippShaderPlanet ambient specular c3 [opacity]
• SippShaderUnref shaderlist|ALL

Objects

• SippObjectCreate
• SippObjectUnref objectlist|ALL
• SippObjectInstance [-cleartransf|-keeptransf] objecthandle
• SippObjectDup [-cleartransf|-keeptransf] objecthandle
• SippObjectDeepDup [-cleartransf|-keeptransf] objecthandle
• SippObjectAddSurface objecthandle surfacelist
• SippObjectSurfaceCreate objectHandle shaderhandle
• SippObjectSubSurface objecthandle surfacelist
• SippObjectAddSubobj [-check|-nocheck] objecthandle subobjlist
• SippObjectSubSubobj objecthandle subobjlist|ALL
• SippObjectGetTransf objecthandle
• SippObjectSetTransf object matrix
• SippObjectClearTransf object
• SippObjectTransform object matrix
• SippObjectRotateX object angle
• SippObjectRotateY object angle
• SippObjectRotateZ object angle
• SippObjectRotate objecthandle point vector angle
• SippObjectScale objecthandle factor|{xfactor yfactor zfactor}
• SippObjectMove objecthandle {xdist ydist zdist}
• SippObjectAncestor objecthandle

Primitive Object Creation

• SippTorus bigradius smallradius radialres tuberes shaderhandle [texture]
• SippCone bottomradius topradius length resolution shaderhandle [texture]
• SippCylinder radius length resolution shaderhandle [texture]
• SippEllipsoid {xradius yradius zradius} resolution shaderhandle [texture]
• SippSphere radius resolution shaderhandle [texture]
• SippPrism 2dpointlist length shaderhandle [texture]
• SippBlock {xsize ysize zsize} shaderhandle [texture]
• SippCube size shaderhandle [texture]
• SippTeapot resolution shaderhandle [texture]
• SippTeapotBody resolution shaderhandle [texture]
• SippTeapotLid resolution shaderhandle [texture]
• SippTeapotHandle resolution shaderhandle [texture]
• SippTeapotSpout resolution shaderhandle [texture]
• SippVW shader
• SippVWBackFender LEFT|RIGHT shader
• SippVWBack LEFT|RIGHT shader
• SippVWBack LEFT|RIGHT LEFT|RIGHT shader
• SippVWFrontDoor LEFT|RIGHT shader
• SippVWFrontFender LEFT|RIGHT shader
• SippVWFront LEFT|RIGHT LEFT|RIGHT shader
• SippVWHood LEFT|RIGHT shader
• SippVWFrontPanel LEFT|RIGHT shader
• SippVWRunningBoard LEFT|RIGHT shader
• SippVWRoof LEFT|RIGHT shader
• SippBezierCurve resolution vertexlist curvelist shaderhandle [texture]
• SippBezierPatch resolution vertexlist patchlist shaderhandle [texture]
• SippBezierFile fileid resolution shaderhandle [texture]

Light Sources

• SippLightSourceCreate {x y z} color [type]
• SippSpotLightCreate position point opening color type [shadow]
• SippLightDestruct lightlist|ALL
• SippLightSourcePut light {x y z}
• SippSpotLightPos light {x y z}
• SippSpotLightAt light {x y z}
• SippSpotLightOpening light opening
• SippSpotLightShadows light flag
• SippLightColor light color
• SippLightActive light flag

Cameras

• SippCameraCreate [position] [point] [upvector] [focal]
• SippCameraParams camera [position] [point] [upvector] [focal]
• SippCameraDestruct cameralist|ALL
• SippCameraUse camera

Shadows

• SippShadows flag [size]

      flag: 0 | 1 | true | false
  

• SippShadowMapsCreate size
• SippShadowMapsDestruct

Rendering and Copying Images

• SippRender [-flags] outputlist xsize ysize [mode] [oversample]

      flags: -odd | -even | -both
             -update period
             -clear | -noclear
             -either | -topdown | -bottomup
      mode: PHONG, GOURAUD, FLAT, LINE
  

• SippCopy inputHandle outputHandle

PBM Files

• SippPBMOpen [-plain|-raw] filename access
• SippPBMClose pbmhandle

RLE Files

• SippRLEOpen filename [mode]
• SippRLEClose rlehandle
• SippRLEInfo rlehandle EOF|XSIZE|YSIZE

Pixel Maps

• SippPixMapCreate
• SippPixMapUnref pixmapList
• SippPixMapInfo pixmapHandle XSIZE|YSIZE

Image Comments

• SippCommentPut handle name [value]
• SippCommentGet handle [name] [retvar | {}]
• SippCommentDelete handle [name]

Control and Status Commands

• SippBackground [color]
• SippLineColor [color]
• SippShowBackFaces [flag] flag: 0|1|true|false SippAbortRender
• SippInfo attribute

      attribute: VERSION | SIPPVERSION | TSIPPVERSION | TSIPPPATCHLEVEL |
                 RLE | RENDERING
  

• SippReset

Vector and Matrix Math Commands

• SippMkVector point0 point1
• SippVecNegate vector
• SippVecDot vector0 vector1
• SippVecLen vector
• SippVecAdd vector0 vector1
• SippVecSub vector0 vector1
• SippVecMult number vector
• SippVecCross vector0 vector1
• SippVecNorm vector
• SippMatIdent
• SippMatTranslate matrix vector
• SippMatRotateX matrix angle
• SippMatRotateY matrix angle
• SippMatRotateZ matrix angle
• SippMatRotate matrix point vector angle
• SippMatScale matrix factor|{xfactor yfactor zfactor}
• SippMatMirrorPlane matrix point normal
• SippMatMult matrix0 matrix1
• SippPointTransform point matrix
• SippAngleDegrees angle
• SippAngleRadians angle