body.h

3D游戏场景编辑器

/****************************************************************************************/
/*  BODY.H                                                                              */
/*                                                                                      */
/*  Author: Mike Sandige	                                                            */
/*  Description: Actor body interface.		                                            */
/*                                                                                      */
/*  The contents of this file are subject to the Genesis3D Public License               */
/*  Version 1.01 (the "License"); you may not use this file except in                   */
/*  compliance with the License. You may obtain a copy of the License at                */
/*  http://www.genesis3d.com                                                            */
/*                                                                                      */
/*  Software distributed under the License is distributed on an "AS IS"                 */
/*  basis, WITHOUT WARRANTY OF ANY KIND, either express or implied.  See                */
/*  the License for the specific language governing rights and limitations              */
/*  under the License.                                                                  */
/*                                                                                      */
/*  The Original Code is Genesis3D, released March 25, 1999.                            */
/*  Genesis3D Version 1.1 released November 15, 1999                                 */
/*  Copyright (C) 1999 WildTangent, Inc. All Rights Reserved           */
/*                                                                                      */
/****************************************************************************************/
#ifndef GE_BODY_H
#define GE_BODY_H 

/* This object is for managing the data associated with a skeletal-based mesh, 
   a 'body'.
   This object holds the geometry for the body and the list of materials needed.
*/

#include "basetype.h"
#include "xform3d.h"
#include "vfile.h"
#include "bitmap.h"

#ifdef __cplusplus
extern "C" {
#endif

#define GE_BODY_NUMBER_OF_LOD			(4)		// 0 is highest detail
#define GE_BODY_NO_PARENT_BONE         (-1)   
#define GE_BODY_HIGHEST_LOD            (0)

#define GE_BODY_ROOT					(-1)	// for specifying 'root' bounding box.

typedef struct geBody geBody;



geBody *GENESISCC geBody_Create(void);

void GENESISCC geBody_Destroy(geBody **B);

geBoolean GENESISCC geBody_IsValid(const geBody *B);


geBoolean GENESISCC geBody_GetGeometryStats(const geBody *B, int lod, int *Vertices, int *Faces, int *Normals);

geBoolean GENESISCC geBody_AddFace(	geBody *B,
								const geVec3d *Vertex1, const geVec3d *Normal1, 
								geFloat U1, geFloat V1, int BoneIndex1,
								const geVec3d *Vertex2, const geVec3d *Normal2, 
									geFloat U2, geFloat V2, int BoneIndex2,
								const geVec3d *Vertex3, const geVec3d *Normal3, 
									geFloat U3, geFloat V3, int BoneIndex3,
								int MaterialIndex);

			// Bitmap is added to body.  It's reference count is increased.  Caller still owns a pointer
			// to the bitmap, and is responsible for destroying it.
geBoolean GENESISCC geBody_AddMaterial( geBody *B, 
									const char *MaterialName, 
									geBitmap *Bitmap,
									geFloat Red, 
									geFloat Green, 
									geFloat Blue,
									int *MaterialIndex);

			// returned bitmap is a pointer to the bitmap in the body's list.  It may not be destroyed.
			// if caller would like to 'own' a copy of that bitmap pointer, it should call geBitmap_CreateRef()
geBoolean GENESISCC geBody_GetMaterial(const geBody *Body, int MaterialIndex,
										const char **MaterialName,
										geBitmap **Bitmap, geFloat *Red, geFloat *Green, geFloat *Blue);

			// Bitmap is set into the body.  It's reference count is increased.  Caller still owns a pointer
			// to the bitmap, and is responsible for destroying it.
geBoolean GENESISCC geBody_SetMaterial(geBody *Body, int MaterialIndex,
										geBitmap *Bitmap,  geFloat Red,  geFloat Green,  geFloat Blue);

int GENESISCC geBody_GetMaterialCount(const geBody *B);

geBoolean GENESISCC geBody_AddBone( geBody *B, 
							int ParentBoneIndex,
							const char *BoneName, 
							const geXForm3d *AttachmentMatrix,
							int *BoneIndex);

geBoolean GENESISCC geBody_ComputeLevelsOfDetail( geBody *B ,int Levels);

int GENESISCC geBody_GetBoneCount(const geBody *B);

void GENESISCC geBody_GetBone(	const geBody *B, 
						int BoneIndex, 
						const char **BoneName,
						geXForm3d *Attachment, 
						int *ParentBoneIndex);

int32 GENESISCC geBody_GetBoneNameChecksum(const geBody *B);

void GENESISCC geBody_SetBoundingBox( geBody *B,
							int BoneIndex,		// GE_BODY_ROOT for specifing 'root' bounding box.
							const geVec3d *MinimumBoxCorner,
							const geVec3d *MaximumBoxCorner);
 

geBoolean GENESISCC geBody_GetBoundingBox( const geBody *B, 
							int BoneIndex,		// GE_BODY_ROOT for specifing 'root' bounding box.
							geVec3d *MinimumBoxCorner,
							geVec3d *MaximumBoxCorner);

geBoolean GENESISCC geBody_GetBoneByName(const geBody* B,
	const char* BoneName,
	int* pBoneIndex,
	geXForm3d* Attachment,
	int* pParentBoneIndex);

geBoolean GENESISCC geBody_WriteToFile(const geBody *B, geVFile *pFile);
geBody  *GENESISCC  geBody_CreateFromFile(geVFile *pFile);




#ifdef __cplusplus
}
#endif

#endif