PowerVR Software Development Kit


Main Page | Class Hierarchy | Class List | File List | Class Members | File Members

PVRTTrans.h File Reference

Header file of PVRTTrans.cpp Contains structure definitions and prototypes of all functions in PVRTTrans.cpp. More...

Go to the source code of this file.

Classes

struct  PVRTBOUNDINGBOX_TAG

Typedefs

typedef PVRTBOUNDINGBOX_TAG PVRTBOUNDINGBOX
typedef PVRTBOUNDINGBOX_TAGLPPVRTBOUNDINGBOX

Functions

void PVRTTransComputeBoundingBox (PVRTBOUNDINGBOX *const pBoundingBox, const PVRTVECTOR3 *const pV, const int nNumberOfVertices)
bool PVRTTransIsBoundingBoxVisible (const PVRTBOUNDINGBOX *const pBoundingBox, const PVRTMATRIX *const pMatrix, bool *const pNeedsZClipping)
void PVRTTransVec3TransformArray (PVRTVECTOR4 *const pOut, const int nOutStride, const PVRTVECTOR3 *const pV, const int nInStride, const PVRTMATRIX *const pMatrix, const int nNumberOfVertices)
void PVRTTransTransformArray (PVRTVECTOR3 *const pTransformedVertex, const PVRTVECTOR3 *const pV, const int nNumberOfVertices, const PVRTMATRIX *const pMatrix)
void PVRTTransTransformArrayBack (PVRTVECTOR3 *const pTransformedVertex, const PVRTVECTOR3 *const pVertex, const int nNumberOfVertices, const PVRTMATRIX *const pMatrix)
void PVRTTransTransformBack (PVRTVECTOR4 *const pOut, const PVRTVECTOR4 *const pV, const PVRTMATRIX *const pM)
void PVRTTransTransform (PVRTVECTOR4 *const pOut, const PVRTVECTOR4 *const pV, const PVRTMATRIX *const pM)


Detailed Description

Header file of PVRTTrans.cpp Contains structure definitions and prototypes of all functions in PVRTTrans.cpp.

Author:
PowerVR
Date:
July 1998
Copyright:
Copyright 2003-2004 by Imagination Technologies Limited. All rights reserved. No part of this software, either material or conceptual may be copied or distributed, transmitted, transcribed, stored in a retrieval system or translated into any human or computer language in any form by any means, electronic, mechanical, manual or other-wise, or disclosed to third parties without the express written permission of Imagination Technologies Limited, Unit 8, HomePark Industrial Estate, King's Langley, Hertfordshire, WD4 8LZ, U.K.
Platform:
ANSI compatible
Description:
Header file of PVRTTrans.cpp Contains structure definitions and prototypes of all functions in PVRTTrans.cpp
Revision
1.9

Typedef Documentation



LPPVRTBOUNDINGBOX


typedef struct PVRTBOUNDINGBOX_TAG * LPPVRTBOUNDINGBOX
 



PVRTBOUNDINGBOX


typedef struct PVRTBOUNDINGBOX_TAG PVRTBOUNDINGBOX
 


Function Documentation



PVRTTransComputeBoundingBox


void PVRTTransComputeBoundingBox PVRTBOUNDINGBOX *const  pBoundingBox,
const PVRTVECTOR3 *const  pV,
const int  nNumberOfVertices
 

Outputs:
pBoundingBox 
Inputs:
pV 
nNumberOfVertices 
Description:
Calculate the eight vertices that surround an object. This "bounding box" is used later to determine whether the object is visible or not. This function should only be called once to determine the object's bounding box.



PVRTTransIsBoundingBoxVisible


bool PVRTTransIsBoundingBoxVisible const PVRTBOUNDINGBOX *const  pBoundingBox,
const PVRTMATRIX *const  pMatrix,
bool *const  pNeedsZClipping
 

Outputs:
pNeedsZClipping 
Inputs:
pBoundingBox 
pMatrix 
Returns:
TRUE if the object is visible, FALSE if not.
Description:
Determine if a bounding box is "visible" or not along the Z axis. If the function returns TRUE, the object is visible and should be displayed (check bNeedsZClipping to know if Z Clipping needs to be done). If the function returns FALSE, the object is not visible and thus does not require to be displayed. bNeedsZClipping indicates whether the object needs Z Clipping (i.e. the object is partially visible).
  • *pBoundingBox is a pointer to the bounding box structure.
  • *pMatrix is the World, View & Projection matrices combined.
  • *bNeedsZClipping is TRUE if Z clipping is required.



PVRTTransTransform


void PVRTTransTransform PVRTVECTOR4 *const  pOut,
const PVRTVECTOR4 *const  pV,
const PVRTMATRIX *const  pM
 

Outputs:
pOut 
Inputs:
pV 
pM 
Description:
Transform vertex pV by pMatrix and store in pOut.



PVRTTransTransformArray


void PVRTTransTransformArray PVRTVECTOR3 *const  pTransformedVertex,
const PVRTVECTOR3 *const  pV,
const int  nNumberOfVertices,
const PVRTMATRIX *const  pMatrix
 

Outputs:
pTransformedVertex 
Inputs:
pV 
nNumberOfVertices 
pMatrix 
Description:
Transform all vertices in pVertex by pMatrix and store them in pTransformedVertex
  • pTransformedVertex is the pointer that will receive transformed vertices.
  • pVertex is the pointer to untransformed object vertices.
  • nNumberOfVertices is the number of vertices of the object.
  • pMatrix is the matrix used to transform the object.



PVRTTransTransformArrayBack


void PVRTTransTransformArrayBack PVRTVECTOR3 *const  pTransformedVertex,
const PVRTVECTOR3 *const  pVertex,
const int  nNumberOfVertices,
const PVRTMATRIX *const  pMatrix
 

Outputs:
pTransformedVertex 
Inputs:
pVertex 
nNumberOfVertices 
pMatrix 
Description:
Transform all vertices in pVertex by the inverse of pMatrix and store them in pTransformedVertex.
  • pTransformedVertex is the pointer that will receive transformed vertices.
  • pVertex is the pointer to untransformed object vertices.
  • nNumberOfVertices is the number of vertices of the object.
  • pMatrix is the matrix used to transform the object.



PVRTTransTransformBack


void PVRTTransTransformBack PVRTVECTOR4 *const  pOut,
const PVRTVECTOR4 *const  pV,
const PVRTMATRIX *const  pM
 

Outputs:
pOut 
Inputs:
pV 
pM 
Description:
Transform vertex pV by the inverse of pMatrix and store in pOut.



PVRTTransVec3TransformArray


void PVRTTransVec3TransformArray PVRTVECTOR4 *const  pOut,
const int  nOutStride,
const PVRTVECTOR3 *const  pV,
const int  nInStride,
const PVRTMATRIX *const  pMatrix,
const int  nNumberOfVertices
 

PVRTTransVec3TransformArray

Outputs:
pOut Destination for transformed vectors
Inputs:
nOutStride Stride between vectors in pOut array
pV Input vector array
nInStride Stride between vectors in pV array
pMatrix Matrix to transform the vectors
nNumberOfVertices Number of vectors to transform
Description:
Transform all vertices [X Y Z 1] in pV by pMatrix and store them in pOut.


Copyright © 1999-2006, PowerVR Technologies and partners. PowerVR Technologies is a division of Imagination Technologies Ltd.


Generated by DOXYGEN 1.3.6