Layer Functions

Functions:

MTK_Layer_AppendObject

int MTK_Layer_AppendObject(MTK_Layer* layer, MTK_Object* obj);
		

Description

Add an object to a layer.

Parameters

layer

pointer to an MTK_Layer struct

obj

pointer to an MTK_Object struct

Return Value

0

success

other

failure

MTK_Layer_Close

int MTK_Layer_Close(MTK_Layer* layer);
		

Description

Clean up the layer.

Parameters

layer

pointer to an MTK_Layer struct

Return Value

0

success

other

failure

MTK_Layer_DeleteObject

int MTK_Layer_DeleteObject(MTK_Layer* layer, const int& index);
		

Description

Delete an object from a layer.

Parameters

layer

pointer to an MTK_Layer struct

index

index of the object (int)

Return Value

0

success

other

failure

MTK_Layer_GetDescription

int MTK_Layer_GetDescription(MTK_Layer* layer, char* desc);
		

Description

Get the description of a layer.

Parameters

layer

pointer to an MTK_Layer struct

desc

buffer of length MTK_BUFFER_SIZE to receive the layer description (char*)

Return Value

0

success

other

failure

MTK_Layer_GetName

int MTK_Layer_GetName(MTK_Layer* layer, char* name);
		

Description

Get the name of a layer.

Parameters

layer

pointer to an MTK_Layer struct

name

buffer of length MTK_BUFFER_SIZE to receive the layer name (char*)

Return Value

0

success

other

failure

MTK_Layer_GetObject

MTK_Object* MTK_Layer_GetObject(MTK_Layer* layer, const int& index);
		

Description

Get an object from a layer.   Allocates a new object which will needs to be freed with MTK_Object_Close .

Parameters

layer

pointer to an MTK_Layer struct

index

index of the object (int)

Return Value

A pointer to an MTK_Object

success

NULL

failure

MTK_Layer_IsEdited

int MTK_Layer_IsEdited(MTK_Layer* layer);
		

Description

Checks if a layer has been edited.

Parameters

layer

pointer to an MTK_Layer struct

Return Value

1

edited

0

not edited

other

failure

MTK_Layer_New

MTK_Layer* MTK_Layer_New();
		

Description

Start with a blank MTK_Layer that values can be set to.

Parameters

None

Return Value

Pointer to an empty MTK_Layer struct

success

Null pointer

failure

MTK_Layer_NObjects

int MTK_Layer_NObjects(MTK_Layer* layer);
		

Description

Get the number of objects in a layer.

Parameters

layer

pointer to an MTK_Layer struct

Return Value

int

number of objects in the layer

-1

failed

MTK_Layer_SetDescription

int MTK_Layer_SetDescription(MTK_Layer* layer, const char* desc);
		

Description

Set the description of a layer.

Parameters

layer

pointer to an MTK_Layer struct

desc

layer description (const char*)

Return Value

0

success

other

failure

MTK_Layer_SetName

int MTK_Layer_SetName(MTK_Layer* layer, const char* name);
		

Description

Set the name of a layer.

Parameters

layer

pointer to an MTK_Layer struct

name

layer name (const char*)

Return Value

0

success

other

failure

MTK_Layer_SetObject

int MTK_Layer_SetObject(MTK_Layer* layer, MTK_Object* obj, const int& index);
		

Description

Set an object in a layer.

Parameters

layer

pointer to an MTK_Layer struct

obj

pointer to an MTK_Object struct

index

index of the object (int)

Return Value

0

success

other

failure