# `class` ImageData

ImageData holds unpacked image data. The data is stored in an FieldData object as value fields. For simplicity all images are implemented as 3D images, but has an extent of 1 in Z for 2D images, and an extent of 1 in both Y and Z for 1D images. Cube maps are stored as a 3D image with Z-depth of 6 (one for each side)

# Properties

Property	Description
Name	The name of the ImageData object. (Inherited from Object)

# Methods

Method	Description
AddColors	Adds the Colors field.
AddField	Adds a field. The field must have a name that does not conflict with any of the existing field names. The field is referenced by the image after the call to AddField()
AddObserver	Adds a user-defined observer object to the interface, that will receive events from the interface. (Inherited from Object)
DeepCopy	Copies the field setup and data from another object. To only copy the setup, set copy_data to false.
GetClass	Get the name of the ImageData class. (Inherited from Object)
GetColors	The Colors field.
GetColorsFormat	The color field format specification.
GetColorsValueType	The base type used by the colors field.
GetField	Gets a field.
GetFieldValueType	Gets the value type of a field.
GetImageFields	The ImageFields field data object, that holds all fields within the image.
GetType	The type of this image data.
GetXSize	The X dimension size of this image data.
GetYSize	The Y dimension size of this image data.
GetZSize	The Z dimension size of this image data.
HasColors	Checks if the image has a color field.
HasField	Check if a field exists in the IImageData object.
IsA	Returns true if ImageData is a or is a descendant of the class named as the type parameter. (Inherited from Object)
IsNull	Returns true if the ImageData object is invalid. (Inherited from Object)
IsSameObjectAs	Returns true if the ImageData object is valid. (Inherited from Object)
NewCopy	Creates another image data object with the same field setup. To also copy the data to the new object, set copy_data to true.
NonNull	Returns true if the ImageData object is valid. (Inherited from Object)
PrintInfo	Prints the content/info of the ImageData object to the log. (Inherited from Object)
RemoveColors	Removes the Colors field.
RemoveField	Removes a field.
RemoveObserver	Removes a previously added observer object. (Inherited from Object)
Reset	Clears all data from the image, and removes all data fields. The type is reset to 2D.
Set1DSize	The X dimension size of this image data.
Set2DSize	The X and Y dimension size of this image data.
Set3DSize	The X, Y and Z dimension size of this image data.
SetCubeSize	The 6 uniform cube side dimensions of this image data.

# Static methods

Method	Description
IsClassA	Returns true if the class is a or is a descendant of the class named as the type parameter. (Inherited from Object)
SafeCast	SafeCast makes sure the input object is of a class that can be cast into spImageData, and if this is the case, returns the object cast into spImageData. (Inherited from Object)

# Properties details

# Name

The name of the ImageData object. (Inherited from Object)

Type	Name	Min	Max	Description
`const char *`	name			New name of the object.

Type	Name	Min	Max	Description
`string`	name			New name of the object.

Name	Type	Min	Max	Description
name	`str`			New name of the object.

# Methods details

# AddColors

Adds the Colors field.

Type	Name	Min	Max	Description
EBaseTypes	valuetype			The type used to store the tuples. Use TYPES_ID_UCHAR base type for 8-bit per channel data, and TYPES_ID_USHORT base type for 16-bit per channel data.
`const char *`	format			A string that describes the format of the color field. Each character in format represents a color channel in the color tuple. All characters in the format string must be unique and uppercase. Normal values for format are: RGB, RGBA, YUV, HLS, CMYK, L and R. In these examples the tuplesize of the formats will be 3,4,3,3,4,1 and 1, respectively. The format string must be at least one character long. Use the SG_IMAGEDATA_FORMAT_[] defines to define the standard types.

Type	Name	Min	Max	Description
EBaseTypes	valuetype			The type used to store the tuples. Use TYPES_ID_UCHAR base type for 8-bit per channel data, and TYPES_ID_USHORT base type for 16-bit per channel data.
`string`	format			A string that describes the format of the color field. Each character in format represents a color channel in the color tuple. All characters in the format string must be unique and uppercase. Normal values for format are: RGB, RGBA, YUV, HLS, CMYK, L and R. In these examples the tuplesize of the formats will be 3,4,3,3,4,1 and 1, respectively. The format string must be at least one character long. Use the SG_IMAGEDATA_FORMAT_[] defines to define the standard types.

Name	Type	Min	Max	Description
valuetype	EBaseTypes			The type used to store the tuples. Use TYPES_ID_UCHAR base type for 8-bit per channel data, and TYPES_ID_USHORT base type for 16-bit per channel data.
format	`str`			A string that describes the format of the color field. Each character in format represents a color channel in the color tuple. All characters in the format string must be unique and uppercase. Normal values for format are: RGB, RGBA, YUV, HLS, CMYK, L and R. In these examples the tuplesize of the formats will be 3,4,3,3,4,1 and 1, respectively. The format string must be at least one character long. Use the SG_IMAGEDATA_FORMAT_[] defines to define the standard types.

# AddField

Adds a field. The field must have a name that does not conflict with any of the existing field names. The field is referenced by the image after the call to AddField()

Type	Name	Description
`const char *`	name	The name of the field to add.
EBaseTypes	valuetype	The type of the field, types listed in BaseTypes.
`unsigned int`	tuplesize	The size of tuples in the new field.

Type	Name	Description
`string`	name	The name of the field to add.
EBaseTypes	valuetype	The type of the field, types listed in BaseTypes.
`uint`	tuplesize	The size of tuples in the new field.

Name	Type	Description
name	`str`	The name of the field to add.
valuetype	EBaseTypes	The type of the field, types listed in BaseTypes.
tuplesize	`int`	The size of tuples in the new field.

# AddObserver

Adds a user-defined observer object to the interface, that will receive events from the interface. (Inherited from Object)

Type	Name	Min	Max	Description
`Observer`	observer			Observer is the object that will receive events.

Type	Name	Min	Max	Description
`Observer`	observer			Observer is the object that will receive events.

Name	Type	Min	Max	Description
observer	`Observer`			Observer is the object that will receive events.

# DeepCopy

Copies the field setup and data from another object. To only copy the setup, set copy_data to false.

Type	Name	Min	Max	Description
ImageData	source			The IImageData object to copy from.
`bool`	copy_data			True if the data should be copied along with the image data properties.

Type	Name	Min	Max	Description
ImageData	source			The IImageData object to copy from.
`bool`	copy_data			True if the data should be copied along with the image data properties.

Name	Type	Min	Max	Description
source	ImageData			The IImageData object to copy from.
copy_data	`bool`			True if the data should be copied along with the image data properties.

# GetClass

Get the name of the ImageData class. (Inherited from Object)

# GetColors

The Colors field.

# GetColorsFormat

The color field format specification.

# GetColorsValueType

The base type used by the colors field.

Key	Value	Comment
TYPES_ID_VOID	0
TYPES_ID_BOOL	1
TYPES_ID_CHAR	2
TYPES_ID_UCHAR	3
TYPES_ID_SHORT	4
TYPES_ID_USHORT	5
TYPES_ID_INT	6
TYPES_ID_UINT	7
TYPES_ID_LONG	8
TYPES_ID_ULONG	9
TYPES_ID_FLOAT	10
TYPES_ID_DOUBLE	11
TYPES_ID_REAL	12
TYPES_ID_RID	13
TYPES_ID_RCHAR	14
TYPES_ID_RHANDLE	15
TYPES_ID_STRING	16
TYPES_ID_OBJECT	17

Key	Value	Comment
TYPES_ID_VOID	0
TYPES_ID_BOOL	1
TYPES_ID_CHAR	2
TYPES_ID_UCHAR	3
TYPES_ID_SHORT	4
TYPES_ID_USHORT	5
TYPES_ID_INT	6
TYPES_ID_UINT	7
TYPES_ID_LONG	8
TYPES_ID_ULONG	9
TYPES_ID_FLOAT	10
TYPES_ID_DOUBLE	11
TYPES_ID_REAL	12
TYPES_ID_RID	13
TYPES_ID_RCHAR	14
TYPES_ID_RHANDLE	15
TYPES_ID_STRING	16
TYPES_ID_OBJECT	17

Key	Value	Comment
EBaseTypes_TYPES_ID_VOID	0
EBaseTypes_TYPES_ID_BOOL	1
EBaseTypes_TYPES_ID_CHAR	2
EBaseTypes_TYPES_ID_UCHAR	3
EBaseTypes_TYPES_ID_SHORT	4
EBaseTypes_TYPES_ID_USHORT	5
EBaseTypes_TYPES_ID_INT	6
EBaseTypes_TYPES_ID_UINT	7
EBaseTypes_TYPES_ID_LONG	8
EBaseTypes_TYPES_ID_ULONG	9
EBaseTypes_TYPES_ID_FLOAT	10
EBaseTypes_TYPES_ID_DOUBLE	11
EBaseTypes_TYPES_ID_REAL	12
EBaseTypes_TYPES_ID_RID	13
EBaseTypes_TYPES_ID_RCHAR	14
EBaseTypes_TYPES_ID_RHANDLE	15
EBaseTypes_TYPES_ID_STRING	16
EBaseTypes_TYPES_ID_OBJECT	17

# GetField

Gets a field.

Type	Name	Min	Max	Description
`const char *`	name			The name of the field to get.

Type	Name	Min	Max	Description
`string`	name			The name of the field to get.

Name	Type	Min	Max	Description
name	`str`			The name of the field to get.

# GetFieldValueType

Gets the value type of a field.

Type	Name	Min	Max	Description
`const char *`	name			The name of the field whose type to get, types listed in BaseTypes.

Key	Value	Comment
TYPES_ID_VOID	0
TYPES_ID_BOOL	1
TYPES_ID_CHAR	2
TYPES_ID_UCHAR	3
TYPES_ID_SHORT	4
TYPES_ID_USHORT	5
TYPES_ID_INT	6
TYPES_ID_UINT	7
TYPES_ID_LONG	8
TYPES_ID_ULONG	9
TYPES_ID_FLOAT	10
TYPES_ID_DOUBLE	11
TYPES_ID_REAL	12
TYPES_ID_RID	13
TYPES_ID_RCHAR	14
TYPES_ID_RHANDLE	15
TYPES_ID_STRING	16
TYPES_ID_OBJECT	17

Type	Name	Min	Max	Description
`string`	name			The name of the field whose type to get, types listed in BaseTypes.

Key	Value	Comment
TYPES_ID_VOID	0
TYPES_ID_BOOL	1
TYPES_ID_CHAR	2
TYPES_ID_UCHAR	3
TYPES_ID_SHORT	4
TYPES_ID_USHORT	5
TYPES_ID_INT	6
TYPES_ID_UINT	7
TYPES_ID_LONG	8
TYPES_ID_ULONG	9
TYPES_ID_FLOAT	10
TYPES_ID_DOUBLE	11
TYPES_ID_REAL	12
TYPES_ID_RID	13
TYPES_ID_RCHAR	14
TYPES_ID_RHANDLE	15
TYPES_ID_STRING	16
TYPES_ID_OBJECT	17

Name	Type	Min	Max	Description
name	`str`			The name of the field whose type to get, types listed in BaseTypes.

Key	Value	Comment
EBaseTypes_TYPES_ID_VOID	0
EBaseTypes_TYPES_ID_BOOL	1
EBaseTypes_TYPES_ID_CHAR	2
EBaseTypes_TYPES_ID_UCHAR	3
EBaseTypes_TYPES_ID_SHORT	4
EBaseTypes_TYPES_ID_USHORT	5
EBaseTypes_TYPES_ID_INT	6
EBaseTypes_TYPES_ID_UINT	7
EBaseTypes_TYPES_ID_LONG	8
EBaseTypes_TYPES_ID_ULONG	9
EBaseTypes_TYPES_ID_FLOAT	10
EBaseTypes_TYPES_ID_DOUBLE	11
EBaseTypes_TYPES_ID_REAL	12
EBaseTypes_TYPES_ID_RID	13
EBaseTypes_TYPES_ID_RCHAR	14
EBaseTypes_TYPES_ID_RHANDLE	15
EBaseTypes_TYPES_ID_STRING	16
EBaseTypes_TYPES_ID_OBJECT	17

# GetImageFields

The ImageFields field data object, that holds all fields within the image.

# GetType

The type of this image data.

# GetXSize

The X dimension size of this image data.

# GetYSize

The Y dimension size of this image data.

# GetZSize

The Z dimension size of this image data.

# HasColors

Checks if the image has a color field.

# HasField

Check if a field exists in the IImageData object.

Type	Name	Min	Max	Description
`const char *`	name			The name of the field to check for.

Type	Name	Min	Max	Description
`string`	name			The name of the field to check for.

Name	Type	Min	Max	Description
name	`str`			The name of the field to check for.

# IsA

Returns true if ImageData is a or is a descendant of the class named as the type parameter. (Inherited from Object)

Type	Name	Min	Max	Description
`const char *`	type			Name of the class to check if ImageData is, or is a descendant of.

Type	Name	Min	Max	Description
`string`	type			Name of the class to check if ImageData is, or is a descendant of.

Name	Type	Min	Max	Description
type	`str`			Name of the class to check if ImageData is, or is a descendant of.

# IsNull

Returns true if the ImageData object is invalid. (Inherited from Object)

# IsSameObjectAs

Returns true if the ImageData object is valid. (Inherited from Object)

Type	Name	Min	Max	Description
Object	object			Object to compare with.

Type	Name	Min	Max	Description
Object	object			Object to compare with.

Name	Type	Min	Max	Description
object	Object			Object to compare with.

# NewCopy

Creates another image data object with the same field setup. To also copy the data to the new object, set copy_data to true.

Type	Name	Min	Max	Description
`bool`	copy_data			If true, all data is copied.

Type	Name	Min	Max	Description
`bool`	copy_data			If true, all data is copied.

Name	Type	Min	Max	Description
copy_data	`bool`			If true, all data is copied.

# NonNull

Returns true if the ImageData object is valid. (Inherited from Object)

# PrintInfo

Prints the content/info of the ImageData object to the log. (Inherited from Object)

# RemoveColors

Removes the Colors field.

# RemoveField

Removes a field.

Type	Name	Min	Max	Description
`const char *`	name			The name of the field to remove.

Type	Name	Min	Max	Description
`string`	name			The name of the field to remove.

Name	Type	Min	Max	Description
name	`str`			The name of the field to remove.

# RemoveObserver

Removes a previously added observer object. (Inherited from Object)

Type	Name	Min	Max	Description
`rid`	observerId			ObserverId is the id returned by AddObserver when the observer was added.

Type	Name	Min	Max	Description
`int`	observerId			ObserverId is the id returned by AddObserver when the observer was added.

Name	Type	Min	Max	Description
observerId	`int`			ObserverId is the id returned by AddObserver when the observer was added.

# Reset

Clears all data from the image, and removes all data fields. The type is reset to 2D.

# Set1DSize

The X dimension size of this image data.

Type	Name	Min	Max	Description
`unsigned int`	_xs			The desired X dimension size of this image data.

Type	Name	Min	Max	Description
`uint`	_xs			The desired X dimension size of this image data.

# Set2DSize

The X and Y dimension size of this image data.

# Set3DSize

The X, Y and Z dimension size of this image data.

# SetCubeSize

The 6 uniform cube side dimensions of this image data.

# Static methods details

# IsClassA

Returns true if the class is a or is a descendant of the class named as the type parameter. (Inherited from Object)

# SafeCast

SafeCast makes sure the input object is of a class that can be cast into spImageData, and if this is the case, returns the object cast into spImageData. (Inherited from Object)

← GeometryData Material →

Type	Name	Min	Max	Description
`unsigned int`	_xs			The desired X dimension size of each cube side in this image data.
`unsigned int`	_ys			The desired Y dimension size of each cube side in this image data.

# class ImageData