C++ Syntax

class MKI_BITMAPREF

{

public:

MKI_FILEREFERENCE m_szBitmapName;

MKI_MATRIX m_cDisplayMatrix;

MKI_BITMAP_EFFECT m_cEffect;

__int32 m_nListIndex;

void

Init( void );

bool

IsIdentical( const MKI_BITMAPREF_REF f_rData ) const; New in Version 2022.1

};

This structure contains settings for a bitmap reference.

Element Description

BitmapName Changed in Version 2019.1

[MKI_FILEREFERENCE] Name of the bitmap to be displayed. If this name starts with the prefix character '#' (Ansi 35), this name is a reference to an internal bitmap of this file. Else, it is a file name of a valid Windows-style bitmap file. The maximum size of such a bitmap is 32,000 by 32,000 pixels, using color depths of 1 bit, 4 bit, 8 bit, 8 bit + alpha channel, 24 bit, or 24 bit + alpha channel.

DisplayMatrix

[MKI_MATRIX] Display matrix of the bitmap. The position stored in the matrix places the lower left corner of the bitmap, the scaling and rotation information determines the size and orientation of the display. The size is relative to the default bitmap resolution stored in the bitmap's header. If the bitmap does not contain a valid resolution information, its resolution is assumed to be 300 dpi.

Effect New in Version 2024.1

[MKI_BITMAP_EFFECT] Options for live image processing.

ListIndex New in Version 6.20

[__int32] Zero-based index of the bitmap in the internal caches. This value must not be modified!

MKD Syntax

A data block of type MKI_DB_INFO_BITMAPREF (243) is used to store the parameters for bitmap references, i.e. for objects that are used to display bitmap files in the drawing.

BitmapName,

DisplayMatrix,

Gamma,Brightness,Contrast,Intensity,DisplayMode,MaskColor

Example

|BitmapName|

"C:\\BITMAPS\\MYIMAGE.JPG",

|DisplayMatrix|

2.0,0.0,0.0,2.0,10.0,-7.0,

|Gamma,Brightness,Contrast,Intensity,DisplayMode,MaskColor|

0,0,0,0,1,0/0/0/0

This bitmap reference displays the bitmap C:\BITMAPS\MYIMAGE.JPG. It will be located at (10.0, 7.0) and will be displayed in twice its original size. Any white pixel will be transparent.