MHEG5  15.3.0
source/classes/inc/mh5bitmap.h File Reference

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 "mh5visible.h"

Go to the source code of this file.

Data Structures

struct  MHEG5Bitmap

Functions

void MHEG5bitmapInit (MHEG5Bitmap *bitmap)
 <Function description>="">
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.
MHEG5BitmapMHEG5bitmapClone (MHEG5Bitmap *source)
 Copy a bitmap object with original values.
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.
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.
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.
void MHEG5bitmapDestruct (MHEG5Bitmap *bitmap)
 Destruct a bitmap object.
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.
MHEG5ErrorCode MHEG5setTransparency (MHEG5Root *target, MHEG5GList *params)
 Change the value of the Transparency attribute. Implementation of the SetTransparency (NewTransparency) action of the bitmap class.
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: 1. Set the BitmapDecodeOffset attribute according to NewXOffset and NewYOffset. 2. 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.
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.

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:
05/02/2002
Author:
R.Freeman

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:
bitmapPointer to a bitmap.
Returns:
None.

Copy a bitmap object with original values.

Parameters:
sourceSource 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:
bitmapPointer to a bitmap.
Returns:
None.
void MHEG5bitmapDestruct ( MHEG5Bitmap bitmap)

Destruct a bitmap object.

Parameters:
bitmapPointer 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:
bitmapPointer to object to free.
Returns:
Void
void MHEG5bitmapInit ( MHEG5Bitmap bitmap)

<Function description>="">

Returns:
<Return value>=""> Initialise a bitmap object with default values.
Parameters:
bitmapPointer to object to initialise.
Returns:
Void

<Function description>="">

Parameters:
bitmapPointer 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:
bitmapPointer 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:
targettarget object for this action
paramsAction 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:
targettarget 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: 1. Set the BitmapDecodeOffset attribute according to NewXOffset and NewYOffset. 2. 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:
targettarget object for this action
paramsAction 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:
targettarget object for this action
params??
Returns:
MHEG5ErrorCode.
 All Data Structures Files Functions Variables Typedefs Defines