Table of contents

General

• VDSlib Reference Manual
  • Budget Based Simplification Given a triangle budget render the best simplification.
  • Building the vertex tree Routines for constructing the VDSlib vertex tree.
  • Dynamic vertex tree maintenance Routines for controlling simplification at run-time.
  • General-purpose utility routines Debugging and utility routines used throughout VDSlib.
  • Manipulating vdsNodePath structures. Macros for examining and changing the path to a vdsNode.
  • Rendering the current simplification Routines for rendering the vertex tree.
  • Standard callbacks: common routines and variables Common routines and globals used by the standard callbacks.
  • Standard callbacks: folding/unfolding nodes Simple example criteria for simplifying the vertex tree.
  • Standard callbacks: rendering nodes Simple example routines for rendering the vertex tree.
  • Standard callbacks: testing node visibility Simple example criteria for vertex tree visibility culling.
  • Standard library: a simple octree-based clustering algorithm Routines for building a VDS vertex tree using a VERY simple octree-based clustering scheme.
  • VDSlib macros Some important macros used to configure VDSlib.
  • VDSlib: The Basics An introduction to the View-Dependent Simplification library.
  • Vertex tree file I/O Routines for reading and writing vertex trees.

Functions, Macros

• budgetSimplifyTree Simplify the vertex tree based on a triangle budget
• vdsAddNode Add a vertex of the original model as a leaf node of the VDS vertex tree
• vdsAddTri Add a triangle of the original model
• vdsAdjustTreeBoundary Adjust the active boundary of the vertex tree
• vdsAdjustTreeTopDown Traverse given vertex tree top-down, adjusting the boundary
• vdsBeginGeometry Initialize the geometry structures
• vdsBeginVertexTree Initializes the builder
• vdsCalcTriNormal Calculate a triangle's current normal
• vdsClusterNodes Cluster a set of nodes under a single new node
• vdsClusterOctree Build an octree over the given leaf nodes using vdsClusterNodes()
• vdsCountTrisDrawn Returns the number of triangles rendered since last call
• vdsEndGeometry When all geometry has been added, prepares VDSlib for node clustering
• vdsEndVertexTree Finalize the VDS vertex tree
• vdsErrorTest A simple vdsErrorMetric callback based on screen-space node extent
• vdsFindCommonAncestor Find the common ancestor of two nodes Given two nodes A and B, returns the ID of the first common ancestor of A & B
• vdsFindNode Find a node from its vdsNodeId
• vdsFoldNode Fold the given node
• vdsFoldSubtree Fold the entire subtree rooted at the given node
• vdsFreeTree Free all memory used by a vertex tree
• vdsNewObject Start a new object, with separate vertex and triangle lists
• vdsPrintNodePath Print the path to a given node to stdout
• vdsReadTree Read a vertex tree from a VDS binary file
• vdsRenderLit Draw a node's triangles lit but not shaded
• vdsRenderShaded Draw a node's triangles shaded but not lit
• vdsRenderShadedLit Draw a node's triangles shaded and lit
• vdsRenderTree Traverses the vertex tree, culling and rendering nodes according to user-specified callbacks
• vdsRenderWireframe Draw a node's triangles in wireframe
• vdsSetFOV Tell VDSlib the current field of view, in radians
• vdsSetLookVec Tell VDSlib the current "look vector"
• vdsSetThreshold Set the simplification threshold for the standard simplification callback
• vdsSetViewpoint Tell VDSlib the current viewpoint
• vdsSimpleVisibility Test a node against the view frustum
• vdsSprintNodePath Print a vdsNodeID to a string
• vdsStatTree Gather statistics for a vertex tree
• vdsThresholdTest A simple vdsFoldCriterion callback based on screen-space node extent
• vdsUnfoldAncestors Unfold the given node, recursively unfolding the node's ancestors first if necessary
• vdsUnfoldNode Unfold the given node
• vdsUpdateTriProxies Update tri->proxies (must be called by rendering callbacks)
• vdsWriteTree Writes a vertex tree to a VDS binary file

Variables

• vdsFOV Field of view, in radians
• vdsInvTanFOV We precompute 1/tan(FOV) for speed
• vdsLookVec Direction of the viewer's gaze
• vdsThreshold Fraction of FOV which a node must cover to avoid being folded
• vdsViewPt Position of the viewer

Macros

• PATH_BRANCH Look up a particular branch within a vdsNodePath
• PATH_COPY Copy one vdsNodePath structure into another
• PATH_SET_BRANCH Set a particular branch within a vdsNodePath
• VDS_CULLDEPTH VDS_CULLDEPTH defines the depth to which the vertex tree is culled
• VDS_DOUBLE_PRECISION Define VDS_DOUBLE_PRECISION to make everything double precision
• VDS_MAXDEGREE VDS_MAXDEGREE defines the maximum degree of vertex tree nodes