Module Description: Implement the MHEG5 Bitmap Class. 32 Bitmap Class Defines the behaviour of a two-dimensional array of pixels.$ Base class: Visible Subclasses: None Status: Concrete class. More...

#include "mh5application.h"
#include "mh5bitmap.h"
#include "mh5object.h"
#include "mh5variable.h"
#include "mh5display.h"
#include "mh5memory.h"
#include "mh5debug.h"
#include "mh5misc.h"
#include "mh5profile.h"
#include "mg_api.h"

Functions
void	MHEG5bitmapInit (MHEG5Bitmap *bitmap)
	Initialise a bitmap object with default values. More...

void	MHEG5bitmapFree (MHEG5Bitmap *bitmap)
	Free off all memory associated with the specified object, including any exchanged attributes and internal data. The data holding the object itself is not freed. More...

MHEG5Bitmap *	MHEG5bitmapClone (MHEG5Bitmap *source)
	Copy a bitmap object with original values. More...

void	MHEG5bitmapPrepare (MHEG5Bitmap *bitmap)
	Apply the preparation behaviour of the bitmap class. As this class has no own preparation behaviour this function just invokes the preparation behaviour from the base class. More...

void	MHEG5bitmapActivate (MHEG5Bitmap *bitmap)
	Apply the activation behaviour of the bitmap class. As this class has no own activation behaviour this function just invokes the activation behaviour from the base class. More...

void	MHEG5bitmapDeactivate (MHEG5Bitmap *bitmap)
	Apply the deactivation behaviour of the bitmap class. As this class has no own deactivation behaviour this function just invokes the deactivation behaviour from the base class. More...

void	MHEG5bitmapDestruct (MHEG5Bitmap *bitmap)
	Destruct a bitmap object. More...

MHEG5ErrorCode	MHEG5scaleBitmap (MHEG5Root target, MHEG5GList params)
	The effect of this action is to scale the contents of the Bitmap to the size (XScale, YScale). Implementation of the ScaleBitmap (XScale, YScale) action of the bitmap class. More...

MHEG5ErrorCode	MHEG5setTransparency (MHEG5Root target, MHEG5GList params)
	Change the value of the Transparency attribute. Implementation of the SetTransparency (NewTransparency) action of the bitmap class. More...

MHEG5ErrorCode	MHEG5setBitmapDecodeOffset (MHEG5Root target, MHEG5GList params)
	Implementation of the SetBitmapDecodeOffset (NewXOffset, NewYOffset) action of the bitmap class. SetBitmapDecodeOffset (NewXOffset, NewYOffset) Change the location of the decoded and scaled bitmap with respect to the target Bitmap object. The offset parameters may be negative. Execute the following sequence of actions: More...

MHEG5ErrorCode	MHEG5getBitmapDecodeOffset (MHEG5Root target, MHEG5GList params)
	Implementation of the GetBitmapDecodeOffset (XOffset, YOffset) action of the bitmap class GetBitmapDecodeOffset (XOffsetVar, YOffsetVar) Return the location of the decoded and scaled bitmap with respect to the target Bitmap object. The offset values may be negative. Set the Variables referenced by XPositionVar and YPositionVar to the value of the X and Y decode offset of the target Bitmap object respectively. Provisions of use: The Target object shall be an available Bitmap object. XOffsetVar and YOffsetVar shall refer to active IntegerVariable objects. GetBitmapDecodeOffset –> Target, XOffsetVar, YOffsetVar Target –> GenericObjectReference XOffsetVar, YOffsetVar –> ObjectReference. More...

Detailed Description

Module Description: Implement the MHEG5 Bitmap Class. 32 Bitmap Class Defines the behaviour of a two-dimensional array of pixels.$ Base class: Visible Subclasses: None Status: Concrete class.

Date: 22/04/2002

Author: iwillis

Function Documentation

void MHEG5bitmapActivate ( MHEG5Bitmap * bitmap )

Apply the activation behaviour of the bitmap class. As this class has no own activation behaviour this function just invokes the activation behaviour from the base class.

Parameters

bitmap Pointer to a bitmap.

Returns: None.

MHEG5Bitmap* MHEG5bitmapClone ( MHEG5Bitmap * source )

Copy a bitmap object with original values.

Parameters

source Source bitmap.

Returns: Destination bitmap.

void MHEG5bitmapDeactivate ( MHEG5Bitmap * bitmap )

Apply the deactivation behaviour of the bitmap class. As this class has no own deactivation behaviour this function just invokes the deactivation behaviour from the base class.

Parameters

bitmap Pointer to a bitmap.

Returns: None.

void MHEG5bitmapDestruct ( MHEG5Bitmap * bitmap )

Destruct a bitmap object.

Parameters

bitmap Pointer to a bitmap.

Returns: None.

void MHEG5bitmapFree ( MHEG5Bitmap * bitmap )

Free off all memory associated with the specified object, including any exchanged attributes and internal data. The data holding the object itself is not freed.

Parameters

bitmap Pointer to object to free.

Returns: Void

void MHEG5bitmapInit ( MHEG5Bitmap * bitmap )

Initialise a bitmap object with default values.

Parameters

bitmap Pointer to object to initialise

Returns: Void

void MHEG5bitmapPrepare ( MHEG5Bitmap * bitmap )

Apply the preparation behaviour of the bitmap class. As this class has no own preparation behaviour this function just invokes the preparation behaviour from the base class.

Parameters

bitmap Pointer to a bitmap.

Returns: None.

MHEG5ErrorCode MHEG5getBitmapDecodeOffset	(	MHEG5Root *	target,
		MHEG5GList *	params
	)

Implementation of the GetBitmapDecodeOffset (XOffset, YOffset) action of the bitmap class GetBitmapDecodeOffset (XOffsetVar, YOffsetVar) Return the location of the decoded and scaled bitmap with respect to the target Bitmap object. The offset values may be negative. Set the Variables referenced by XPositionVar and YPositionVar to the value of the X and Y decode offset of the target Bitmap object respectively. Provisions of use: The Target object shall be an available Bitmap object. XOffsetVar and YOffsetVar shall refer to active IntegerVariable objects. GetBitmapDecodeOffset –> Target, XOffsetVar, YOffsetVar Target –> GenericObjectReference XOffsetVar, YOffsetVar –> ObjectReference.

Parameters

target	target object for this action
params	Action parameters

Returns: MHEG5ErrorCode.

MHEG5ErrorCode MHEG5scaleBitmap	(	MHEG5Root *	target,
		MHEG5GList *	params
	)

The effect of this action is to scale the contents of the Bitmap to the size (XScale, YScale). Implementation of the ScaleBitmap (XScale, YScale) action of the bitmap class.

Parameters

target	target object for this action
params	??

Returns: MHEG5ErrorCode.

MHEG5ErrorCode MHEG5setBitmapDecodeOffset	(	MHEG5Root *	target,
		MHEG5GList *	params
	)

Implementation of the SetBitmapDecodeOffset (NewXOffset, NewYOffset) action of the bitmap class. SetBitmapDecodeOffset (NewXOffset, NewYOffset) Change the location of the decoded and scaled bitmap with respect to the target Bitmap object. The offset parameters may be negative. Execute the following sequence of actions:

Set the BitmapDecodeOffset attribute according to NewXOffset and NewYOffset.
If the Bitmap object is active, redraw the graphic widget representing the object on the screen in the bounding box defined by the BoxSize and Position attributes and according to its position in the DisplayStack of the active Application object. Provisions of use: The Target object shall be an available Bitmap object. NewXOffset and NewYOffset shall correspond to an offset interpreted in the Scene coordinate system defined by the SceneCoordinateSystem attribute of the currently active Scene. SetBitmapDecodeOffset –> Target, NewXOffset, NewYOffset Target –> GenericObjectReference NewXOffset, NewYOffset –> GenericInteger
Parameters

target target object for this action

params Action parameters

Returns
MHEG5ErrorCode.

MHEG5ErrorCode MHEG5setTransparency	(	MHEG5Root *	target,
		MHEG5GList *	params
	)

Change the value of the Transparency attribute. Implementation of the SetTransparency (NewTransparency) action of the bitmap class.

Parameters

target	target object for this action
params	??

Returns: MHEG5ErrorCode.

Functions

Detailed Description

Function Documentation