bitmap.image

BITMAP_GetClass

imageclass

None.

This image class can create an image given the name of a source file. It uses the datatypes system to create a bitmap used for rendering the image. Bitmap supports drawing itself in a selected state, and supports transparent images provided that the datatype supports transparency.

Instead of a source file name, a ready-to-use bitmap can be passed with OM_NEW.

OM_NEW

Create the bitmap image. Passed to superclass, then OM_SET.

OM_DISPOSE

Destroy the bitmap image.

OM_GET

Get object attributes. Passed to superclass first.

OM_SET

Set object attributes. Passed to superclass first.

OM_UPDATE

Set object notification attributes. Passed to superclass first.

IM_DRAW

Render the image. Overrides the superclass.

All other methods are passed to the superclass, including OM_DISPOSE.

IA_TopEdge (WORD) -

IA_LeftEdge (WORD) -

IA_Width (WORD) -

IA_Height (WORD)

Set position and size of the image. If given, these must be greater than or equal to the maximum dimensions of the bitmaps used, unless IA_Scalable is TRUE (see below).

If IA_Scalable is FALSE and the image size is larger than one of the bitmap sizes, the bitmap will be drawn centered within the image. The area surrounding the bitmap is left untouched.

If IA_Scalable is TRUE, the bitmap will be drawn stretched according to the image size, rather than centered. In this case, it is possible for the image size to be smaller than the bitmap size.

As long as the image sizes have not been specified, the image will automatically size itself to be as large as the largest of its bitmaps. You can get back to this behavior at any time by setting the image sizes to -1 (via OM_SET).

Defaults to the maximum of the dimensions of the normal and selected bitmaps.

Applicability is (OM_NEW, OM_SET, OM_GET)

IA_Scalable (BOOL)

If TRUE, the image will scale its bitmap, stretching it as needed to cover the whole image size. If FALSE, the bitmap will be centered within the image area. (V45)

Defaults to FALSE.

Applicability is (OM_NEW, OM_SET, OM_GET)

BITMAP_SourceFile (STRPTR)

Source file name of the image file to create the bitmap from, using the datatypes system.

Applicability is (OM_NEW, OM_GET)

BITMAP_Screen (struct Screen *)

Pointer to the screen to use the image on. This attribute MUST be provided when creating an object of this class using the datatypes system.

Applicability is (OM_NEW, OM_GET)

BITMAP_Precision (ULONG)

Precision to use when obtaining colors. See the PRECISION_ defines in <graphics/view.h>

Defaults to PRECISION_ICON.

Applicability is (OM_NEW, OM_GET)

BITMAP_Masking (BOOL)

If set to TRUE, the image will be drawn using a transparent mask if the image source contains a transparent color.

Defaults to FALSE.

Applicability is (OM_NEW, OM_GET)

BITMAP_BitMap (struct BitMap *)

Instead of letting the class create the bitmap using datatypes, you can create your own bitmap and pass it to the class. If you supply your own bitmap, you MUST set BITMAP_Width and BITMAP_Height too. Either BITMAP_SourceFile or BITMAP_BitMap must be given.

Applicability is (OM_NEW, OM_GET)

BITMAP_Width (LONG) - BITMAP_Height (LONG) - Set the dimensions of your own bitmap passed with

BITMAP_MaskPlane (APTR)

A mask plane. Only set this if you supply your own bitmap with BITMAP_BitMap. The mask plane will only be used if BITMAP_Masking is TRUE.

Defaults to NULL.

Applicability is (OM_NEW, OM_GET)

BITMAP_SelectSourceFile (STRPTR)

Source file name of the selected state image to create the bitmap from, using the datatypes system.

Applicability is (OM_NEW, OM_GET)

BITMAP_SelectBitMap (struct BitMap *)

Your own bitmap to use for the selected state. If you supply your own bitmap, you MUST set BITMAP_SelectWidth and BITMAP_SelectHeight too.

Applicability is (OM_NEW, OM_GET)

BITMAP_SelectWidth (LONG) - BITMAP_SelectHeight (LONG) - Set the dimensions of your own selected

BITMAP_SelectMaskPlane (APTR)

A mask plane for the selected state bitmap. Only set this if you supply your own bitmap with BITMAP_SelectBitMap. The mask plane will only be used if BITMAP_Masking is TRUE.

Defaults to NULL.

Applicability is (OM_NEW, OM_GET)

BITMAP_OffsetX (LONG) - BITMAP_OffsetY (LONG) - Together with BITMAP_BitMap, BITMAP_Width

BITMAP_SelectOffsetX (LONG) - BITMAP_SelectOffsetY (LONG) - Together with BITMAP_SelectBitMap,