Error return codes in Callisto

Macros
#define	CAL_ALREADY_INIT   -2
#define	CAL_CANNOT_MANIPULATE_ROOT_GROUP   -5
#define	CAL_CANNOT_SET_VISIBILITY   -22
#define	CAL_CLONE_IN_SUBGROUP   -13
#define	CAL_FILE_ERROR   -11
#define	CAL_GROUP_NOT_COL_CAPABLE   -17
#define	CAL_GROUPS_DO_NOT_OVERLAP   -16
#define	CAL_GROUPS_IN_SAME_SUBTREE   -8
#define	CAL_ILLEGAL_KEY_STATE   -19
#define	CAL_ILLEGAL_VALUE   -7
#define	CAL_INVALID_EXTENSION   -21
#define	CAL_IS_DYNAMIC   -20
#define	CAL_NAME_ALREADY_EXISTS   -10
#define	CAL_NAME_NOT_FOUND   -9
#define	CAL_NO_SUCH_GROUP   -3
#define	CAL_NO_SUCH_OBJECT   -6
#define	CAL_NO_SUCH_PARENT_GROUP   -4
#define	CAL_NOT_INIT   -1
#define	CAL_OBJ_HAS_NO_TEXTURE_COORDINATES   - 24
#define	CAL_STATISTICSNOTENABLED   -23
#define	CAL_SUCCESS   0
#define	CAL_TEXTURE_ERROR   -18
#define	CAL_VIEW_ALREADY_VISIBLE   -14
#define	CAL_VIEW_NOT_VISIBLE   -15
#define	CAL_VIS_NOT_RUNNING   -12

Detailed Description

Macro Definition Documentation

#define CAL_ALREADY_INIT   -2

Callisto is already initialized.

#define CAL_CANNOT_MANIPULATE_ROOT_GROUP   -5

The root group is a system group and cannot be manipulated.

#define CAL_CANNOT_SET_VISIBILITY   -22

Either provide visibility for all keystates of a group, or none.

#define CAL_CLONE_IN_SUBGROUP   -13

The clone you are trying to make cannot be put in the source's subtree.

#define CAL_FILE_ERROR   -11

The file you try to read/write is not valid or could not be found.

#define CAL_GROUP_NOT_COL_CAPABLE   -17

Group not capable of collision checks.

#define CAL_GROUPS_DO_NOT_OVERLAP   -16

Cannot calculate penetration depth, because objects do not overlap.

#define CAL_GROUPS_IN_SAME_SUBTREE   -8

Cannot collision check because both groups are part of the same tree-branch.

#define CAL_ILLEGAL_KEY_STATE   -19

Key state already defined.

#define CAL_ILLEGAL_VALUE   -7

One of the parameters has an illegal value.

#define CAL_INVALID_EXTENSION   -21

You try to use a file with the incorrect extension.

#define CAL_IS_DYNAMIC   -20

You try to set properties of a group/object that has a motion defined.

#define CAL_NAME_ALREADY_EXISTS   -10

This name already exists.

#define CAL_NAME_NOT_FOUND   -9

This name does not exist.

#define CAL_NO_SUCH_GROUP   -3

The group does not exist.

#define CAL_NO_SUCH_OBJECT   -6

The object does not exist.

#define CAL_NO_SUCH_PARENT_GROUP   -4

The parent group does not exist.

#define CAL_NOT_INIT   -1

Callisto is not yet initialized, use CAL_Initialisation.

#define CAL_OBJ_HAS_NO_TEXTURE_COORDINATES   - 24

Cannot set texture to object without texture coordinates (applies to triangles).

#define CAL_STATISTICSNOTENABLED   -23

Statistical information is not enabled.

#define CAL_SUCCESS   0

The function was succesful.

#define CAL_TEXTURE_ERROR   -18

Cannot load texture, check filename/path and fileformat, did you add a texture resource first by using CAL_AddTextureResource?.

#define CAL_VIEW_ALREADY_VISIBLE   -14

The view you try to show is a already visible (use another viewID.

#define CAL_VIEW_NOT_VISIBLE   -15

You try to do something with a view, while it is not visible.

#define CAL_VIS_NOT_RUNNING   -12

You try to do something with the visualiser while it is not running or it is suspended.