A3DGraphCameraCreate

A3DStatus A3DGraphCameraCreate(const A3DGraphCameraData *pData, A3DGraphCamera **ppCamera)
A3DStatus A3DGraphCameraCreate(const A3DGraphCameraData* pData, A3DGraphCamera** ppCamera)

Creates a new camera entity, returning its handle.

2.0

Once created, the new camera entity can be referenced to by its handle, given by *ppCamera. In case of failure, *ppCamera is unchanged.

Return Values

A3D_SUCCESS: in case of success.

A3D_INITIALIZE_NOT_CALLED: if the library is not initialized

A3D_INVALID_DATA_STRUCT_NULL: if pData is null.

A3D_INVALID_DATA_STRUCT_SIZE: if pData is incorrectly initialized

A3DGraphCamera handle = 0;
A3DGraphCameraData data = A3D_MAKE_DATA(A3DGraphCameraData);
// Configure data...
A3DStatus result = A3DGraphCameraCreate(&data, &handle);
assert(handle != 0);

Parameters

pData: The data used for camera creation.

ppCamera: An address to the new handle after creation.

Returns

A3D_SUCCESS or an error code in case of failure.