OrxCamera

Defines
#define	orxCAMERA_KU32_FLAG_2D   0x00000001
#define	orxCAMERA_KU32_FLAG_NONE   0x00000000
#define	orxCAMERA_KU32_MASK_USER_ALL   0x000000FF
Typedefs
typedef struct __orxCAMERA_t	orxCAMERA
Functions
orxDLLAPI orxCAMERA *orxFASTCALL	orxCamera_Create (orxU32 _u32Flags)
orxDLLAPI orxCAMERA *orxFASTCALL	orxCamera_CreateFromConfig (const orxSTRING _zConfigID)
orxDLLAPI orxSTATUS orxFASTCALL	orxCamera_Delete (orxCAMERA *_pstCamera)
orxDLLAPI void orxFASTCALL	orxCamera_Exit ()
orxDLLAPI orxCAMERA *orxFASTCALL	orxCamera_Get (const orxSTRING _zName)
orxDLLAPI orxFRAME *orxFASTCALL	orxCamera_GetFrame (const orxCAMERA *_pstCamera)
orxDLLAPI orxAABOX *orxFASTCALL	orxCamera_GetFrustum (const orxCAMERA *_pstCamera, orxAABOX *_pstFrustum)
orxDLLAPI const orxSTRING orxFASTCALL	orxCamera_GetName (const orxCAMERA *_pstCamera)
orxDLLAPI orxVECTOR *orxFASTCALL	orxCamera_GetPosition (const orxCAMERA *_pstCamera, orxVECTOR *_pvPosition)
orxDLLAPI orxFLOAT orxFASTCALL	orxCamera_GetRotation (const orxCAMERA *_pstCamera)
orxDLLAPI orxFLOAT orxFASTCALL	orxCamera_GetZoom (const orxCAMERA *_pstCamera)
orxDLLAPI orxSTATUS orxFASTCALL	orxCamera_Init ()
orxDLLAPI orxSTATUS orxFASTCALL	orxCamera_SetFrustum (orxCAMERA *_pstCamera, orxFLOAT _fWidth, orxFLOAT _fHeight, orxFLOAT _fNear, orxFLOAT _fFar)
orxDLLAPI orxSTATUS orxFASTCALL	orxCamera_SetParent (orxCAMERA *_pstCamera, void *_pParent)
orxDLLAPI orxSTATUS orxFASTCALL	orxCamera_SetPosition (orxCAMERA *_pstCamera, const orxVECTOR *_pvPosition)
orxDLLAPI orxSTATUS orxFASTCALL	orxCamera_SetRotation (orxCAMERA *_pstCamera, orxFLOAT _fRotation)
orxDLLAPI void orxFASTCALL	orxCamera_Setup ()
orxDLLAPI orxSTATUS orxFASTCALL	orxCamera_SetZoom (orxCAMERA *_pstCamera, orxFLOAT _fZoom)

---

Detailed Description

Camera Module Allows to creates and handle cameras Camera are structures used to render graphic (2D/3D) objects They thus can be referenced by other structures

---

Define Documentation

#define orxCAMERA_KU32_FLAG_2D   0x00000001

2D flag

Definition at line 59 of file orxCamera.h.

#define orxCAMERA_KU32_FLAG_NONE   0x00000000

Anim flags No flags

Definition at line 57 of file orxCamera.h.

#define orxCAMERA_KU32_MASK_USER_ALL   0x000000FF

User all mask

Definition at line 61 of file orxCamera.h.

---

Typedef Documentation

typedef struct __orxCAMERA_t orxCAMERA

Internal camera structure

Definition at line 66 of file orxCamera.h.

---

Function Documentation

orxDLLAPI orxCAMERA* orxFASTCALL orxCamera_Create

(

orxU32

_u32Flags )

Creates a camera

Parameters:

[in]

_u32Flags

Camera flags (2D / ...)

Returns:

Created orxCAMERA / orxNULL

orxDLLAPI orxCAMERA* orxFASTCALL orxCamera_CreateFromConfig

(

const orxSTRING

_zConfigID )

Creates a camera from config

Parameters:

[in]

_zConfigID

Config ID @ return orxCAMERA / orxNULL

orxDLLAPI orxSTATUS orxFASTCALL orxCamera_Delete

(

orxCAMERA *

_pstCamera )

Deletes a camera

Parameters:

[in]

_pstCamera

Camera to delete

Returns:

orxSTATUS_SUCCESS / orxSTATUS_FAILURE

orxDLLAPI void orxFASTCALL orxCamera_Exit

(

)

Exits from the Camera module

orxDLLAPI orxCAMERA* orxFASTCALL orxCamera_Get

(

const orxSTRING

_zName )

Gets camera given its name

Parameters:

[in]

_zName

Camera name

Returns:

orxCAMERA / orxNULL

orxDLLAPI orxFRAME* orxFASTCALL orxCamera_GetFrame

(

const orxCAMERA *

_pstCamera )

Gets camera frame

Parameters:

[in]

_pstCamera

Concerned camera

Returns:

orxFRAME

orxDLLAPI orxAABOX* orxFASTCALL orxCamera_GetFrustum	(	const orxCAMERA *	_pstCamera,
		orxAABOX *	_pstFrustum
	)

Gets camera frustum (3D box for 2D camera)

Parameters:

[in]	_pstCamera	Concerned camera
[out]	_pstFrustum	Frustum box

Returns:

Frustum orxAABOX

orxDLLAPI const orxSTRING orxFASTCALL orxCamera_GetName

(

const orxCAMERA *

_pstCamera )

Gets camera config name

Parameters:

[in]

_pstCamera

Concerned camera

Returns:

orxSTRING / orxSTRING_EMPTY

orxDLLAPI orxVECTOR* orxFASTCALL orxCamera_GetPosition	(	const orxCAMERA *	_pstCamera,
		orxVECTOR *	_pvPosition
	)

Get camera position

Parameters:

[in]	_pstCamera	Concerned camera
[out]	_pvPosition	Camera position

Returns:

orxVECTOR

orxDLLAPI orxFLOAT orxFASTCALL orxCamera_GetRotation

(

const orxCAMERA *

_pstCamera )

Get camera rotation

Parameters:

[in]

_pstCamera

Concerned camera

Returns:

Rotation value (radians)

orxDLLAPI orxFLOAT orxFASTCALL orxCamera_GetZoom

(

const orxCAMERA *

_pstCamera )

Get camera zoom

Parameters:

[in]

_pstCamera

Concerned camera

Returns:

Zoom value

orxDLLAPI orxSTATUS orxFASTCALL orxCamera_Init

(

)

Inits the Camera module

orxDLLAPI orxSTATUS orxFASTCALL orxCamera_SetFrustum	(	orxCAMERA *	_pstCamera,
		orxFLOAT	_fWidth,
		orxFLOAT	_fHeight,
		orxFLOAT	_fNear,
		orxFLOAT	_fFar
	)

Sets camera frustum

Parameters:

[in]	_pstCamera	Concerned camera
[in]	_fWidth	Width of frustum
[in]	_fHeight	Height of frustum
[in]	_fNear	Near distance of frustum
[in]	_fFar	Far distance of frustum

Returns:

orxSTATUS_SUCCESS / orxSTATUS_FAILURE

orxDLLAPI orxSTATUS orxFASTCALL orxCamera_SetParent	(	orxCAMERA *	_pstCamera,
		void *	_pParent
	)

Sets camera parent

Parameters:

[in]	_pstCamera	Concerned camera
[in]	_pParent	Parent structure to set (object, spawner, camera or frame) / orxNULL

Returns:

orsSTATUS_SUCCESS / orxSTATUS_FAILURE

orxDLLAPI orxSTATUS orxFASTCALL orxCamera_SetPosition	(	orxCAMERA *	_pstCamera,
		const orxVECTOR *	_pvPosition
	)

Sets camera position

Parameters:

[in]	_pstCamera	Concerned camera
[in]	_pvPosition	Camera position

Returns:

orxSTATUS_SUCCESS / orxSTATUS_FAILURE

orxDLLAPI orxSTATUS orxFASTCALL orxCamera_SetRotation	(	orxCAMERA *	_pstCamera,
		orxFLOAT	_fRotation
	)

Sets camera rotation

Parameters:

[in]	_pstCamera	Concerned camera
[in]	_fRotation	Camera rotation (radians)

Returns:

orxSTATUS_SUCCESS / orxSTATUS_FAILURE

orxDLLAPI void orxFASTCALL orxCamera_Setup

(

)

Camera module setup

orxDLLAPI orxSTATUS orxFASTCALL orxCamera_SetZoom	(	orxCAMERA *	_pstCamera,
		orxFLOAT	_fZoom
	)

Sets camera zoom

Parameters:

[in]	_pstCamera	Concerned camera
[in]	_fZoom	Camera zoom

Returns:

orxSTATUS_SUCCESS / orxSTATUS_FAILURE