---

RtWorldImportGuideKD
[RtWorldImport]

Functions
RtWorldImportGuideKDTree *	RtWorldImportGuideKDCreate (RwBBox *bbox)
void	RtWorldImportGuideKDDestroy (RtWorldImportGuideKDTree *KD)
RtWorldImportGuideKDTree *	RtWorldImportGuideKDAddPartition (RtWorldImportGuideKDTree *KD, RwInt32 type, RwReal value)
void	RtWorldImportGuideKDDeletePartition (RtWorldImportGuideKDTree *KD)
RtWorldImportGuideKDTree *	RtWorldImportGuideKDWrite (RtWorldImportGuideKDTree *guideKD, const RwChar *filename)
RtWorldImportGuideKDTree *	RtWorldImportGuideKDRead (const RwChar *filename, const RwBBox *bbox)

---

Detailed Description

Tools to manipulate the RtWorldImportGuideKDTree that is used to manually build the sectors of a world.

---

Function Documentation

RtWorldImportGuideKDTree* RtWorldImportGuideKDAddPartition (  RtWorldImportGuideKDTree *    KD, RwInt32    type, RwReal    value )

RtWorldImportGuideKDAddPartition Modifies a given leaf node by partitioning it, turning the given node into a non-leaf node and creating two new leaf-node children. To use this function, you need to setup the global import parameters by using RtWorldImportParametersSet. Parameters: KD  The leaf node of the RtWorldImportGuideKDTree type  The orientation of the partition 0, 4, 8 for normal to the x, y or z-axis value  The signed distance of the plane from the origin Returns: The new node if successful, NULL otherwise. A partition is invalid if it is not inside the half space of its parent See also: RtWorldImportGuideKDRead , RtWorldImportGuideKDWrite , RtWorldImportGuideKDDestroy , RtWorldImportGuideKDDeletePartition , RtWorldImportGuideKDCreate

RtWorldImportGuideKDTree* RtWorldImportGuideKDCreate (  RwBBox *    bbox )

RtWorldImportGuideKDCreate Creates a single node RtWorldImportGuideKDTree Parameters: bbox  The bounding box of the world. Returns: The root of the RtWorldImportGuideKDTree See also: RtWorldImportGuideKDRead , RtWorldImportGuideKDWrite , RtWorldImportGuideKDDestroy , RtWorldImportGuideKDDeletePartition , RtWorldImportGuideKDAddPartition

void RtWorldImportGuideKDDeletePartition (  RtWorldImportGuideKDTree *    KD )

RtWorldImportGuideKDDeletePartition Modifies a given node, by destroying its childern, turning the given node into a leaf node. Parameters: KD  The node of the RtWorldImportGuideKDTree See also: RtWorldImportGuideKDRead , RtWorldImportGuideKDWrite , RtWorldImportGuideKDDestroy , RtWorldImportGuideKDAddPartition , RtWorldImportGuideKDCreate

void RtWorldImportGuideKDDestroy (  RtWorldImportGuideKDTree *    KD )

RtWorldImportGuideKDDestroy Destroys the RtWorldImportGuideKDTree Parameters: KD  The RtWorldImportGuideKDTree See also: RtWorldImportGuideKDRead , RtWorldImportGuideKDWrite , RtWorldImportGuideKDDeletePartition , RtWorldImportGuideKDAddPartition , RtWorldImportGuideKDCreate

RtWorldImportGuideKDTree* RtWorldImportGuideKDRead (  const RwChar *    filename, const RwBBox *    bbox )

RtWorldImportGuideKDRead Reads in a previously saved KD tree and stores it in a RtWorldImportGuideKDTree. This can subsequently be applied to a world using a guided build. Parameters: filename  A pointer to the filename where the KD tree is stored bbox  The bounding box of the world Returns: A pointer to the RtWorldImportGuideKDTree See also: RtWorldImportGuideKDRead , RtWorldImportGuideKDDestroy , RtWorldImportGuideKDDeletePartition , RtWorldImportGuideKDAddPartition , RtWorldImportGuideKDCreate

RtWorldImportGuideKDTree* RtWorldImportGuideKDWrite (  RtWorldImportGuideKDTree *    guideKD, const RwChar *    filename )

RtWorldImportGuideKDWrite Saves the given RtWorldImportGuideKDTree Parameters: guideKD  A pointer to the RtWorldImportGuideKDTree. filename  A pointer to the filename where it is to be stored. Returns: The RtWorldImportGuideKDTree. See also: RtWorldImportGuideKDRead , RtWorldImportGuideKDDestroy , RtWorldImportGuideKDDeletePartition , RtWorldImportGuideKDAddPartition , RtWorldImportGuideKDCreate

---