MKI_MULTI_BITMAPREF (Multi-Entity Editing Classes) Renamed and changed in Version 2025.0

C++ Syntax

class MKI_MULTI_BITMAPREF : public MKI_MULTI_BASE

{

  public:

  MKI_FILEREFERENCE m_szBitmapName;

  MKI_VECTOR m_cScaling;

  double m_dRotation,

         m_dDistortion;

  MKI_POINT m_cPointUnits;

  MKI_BITMAP_EFFECT m_cEffect;

  __int32 m_nFitMode;

          m_nAlignMode;

  MKI_INTVECTOR m_cSize;

  __int32 f_nColorBits;

  MKI_VECTOR m_cResolution;

  bool m_fIsLoaded,

       m_fHasAlpha,

       m_fIsMono,

       m_fBaseCMYK;

  void

  Init( void ); New in Version 2023.1

  void

  Fill(

 MKI_CONST_BITMAPREF_REF f_rData ); New in Version 2023.1

  bool

  Apply(

 MKI_BITMAPREF_REF f_rData,

 bool f_fCopyAll ) const; New in Version 2023.1

  bool

  GetBitmapInfo(

 MKI_DUMMYSTRW& f_rString ) const;

};

This structure contains bitmap reference properties to be edited in a dialog window.

Element Description

m_szBitmapName Changed in Version 2019.1

[MKI_FILEREFERENCE] Bitmap name.

m_dScaling Changed in Version 6.41

[MKI_VECTOR] Horizontal and vertical scaling of the bitmap.

m_dRotation

[double] Rotation of the bitmap in [rad].

m_dDistortion

[double] Distortion of the bitmap in [rad].

m_cPointUnits New in Version 2023.1

[MKI_POINT] X and Y coordinate of the bitmap’s insertion point in current length units (not in internal millimeters).

m_cEffect New in Version 2024.1

[MKI_BITMAP_EFFECT] Options for live image processing.

m_nFitMode New in Version 2025.0

[__int32] Fitting mode for the bitmap. Allowed values are:

MKI_BITMAPFIT_NONE

The bitmap will not be fitted. It will instead be displayed left- and bottom-aligned to the insertion point in a size based on its own resolution (the mode used by bitmap references before Version 2025.0). m_cFitSize will be ignored.

MKI_BITMAPFIT_INSIDE

The bitmap will be scaled proportionally to completely fit into the rectangle given by m_cFitSize, i.e. some parts of the rectangle might be left unfilled.

MKI_BITMAPFIT_OUTSIDE

The bitmap will be scaled proportionally to fill the rectangle given by m_cFitSize completely, i.e. some parts of the bitmap might lie outside the rectangle (and will not be clipped).

MKI_BITMAPFIT_COVER

The bitmap will be scaled non-proportionally to cover the complete rectangle given by m_cFitSize.

m_nAlignMode New in Version 2025.0

[__int32] Bitmap alignment. Allowed values are:

MKI_BITMAPALIGN_BL

The bitmap will be scaled (if fitted) or aligned relative to the bottom left corner of the rectangle.

MKI_BITMAPALIGN_BC

The bitmap will be scaled (if fitted) or aligned relative to the bottom center of the rectangle.

MKI_BITMAPALIGN_BR

The bitmap will be scaled (if fitted) or aligned relative to the bottom right corner of the rectangle.

MKI_BITMAPALIGN_CL

The bitmap will be scaled (if fitted) or aligned relative to the left center of the rectangle.

MKI_BITMAPALIGN_CC

The bitmap will be scaled (if fitted) or aligned relative to the center of the rectangle.

MKI_BITMAPALIGN_CR

The bitmap will be scaled (if fitted) or aligned relative to the right center of the rectangle.

MKI_BITMAPALIGN_TL

The bitmap will be scaled (if fitted) or aligned relative to the top left corner of the rectangle.

MKI_BITMAPALIGN_TC

The bitmap will be scaled (if fitted) or aligned relative to the top center of the rectangle.

MKI_BITMAPALIGN_TR

The bitmap will be scaled (if fitted) or aligned relative to the top right corner of the rectangle.

m_cFitSize New in Version 2025.0

[MKI_VECTOR] Absolute size of a rectangle in millimeters to fit the bitmap into. It starts at origin and extents to the right and upwards. If one or both values are zero or negative, the bitmap will not be fitted. If should be set in any case, even if m_nFitMode is MKI_BITMAPFIT_NONE, although in that case, no scaling will be applied and alignment will be performed relative to the insertion point (ignoring m_cFitSize).

m_cSize Changed in Version 2016.1

[MKI_INTVECTOR] Bitmap width and height in pixels. This value is only valid for single-object property editing and is read-only.

m_nColorBits

[__int32] Color-depths of the bitmap width in bits. This value is only valid for single-object property editing and is read-only.

m_cResolution Changed in Version 6.41

[MKI_VECTOR] Horizontal and vertical resolution of the bitmap in pixels per [mm]. This value is only valid for single-object property editing and is read-only.

m_fIsLoaded New in Version 2022.0

[bool] If true, the original bitmap has already been loaded into memory successfully. This value is only valid for single-object property editing and is read-only.

m_fHasAlpha New in Version 2015.2

[bool] If true, the original bitmap contained an alpha channel. This value is only valid for single-object property editing and is read-only.

m_fIsMono New in Version 2022.0

[bool] If true, the original bitmap was a monochrome bitmap, thus line and fill color shall be applied. This value is only valid for single-object property editing and is read-only.

m_fBaseCMYK New in Version 2015.2

[bool] If true, the original bitmap used CMYK colors. This value is only valid for single-object property editing and is read-only.

Comment

When using functions of the base class MKI_MULTI_BASE, use the following flags defined in this class to identify its elements:

USE_NAME

Apply the bitmap name m_szBitmapName.

USE_XSCALE

Apply the horizontal scaling m_cScaling.vx.

USE_YSCALE

Apply the vertical scaling m_cScaling.vy.

USE_ROTATION

Apply the rotation m_dRotation.

USE_DISTORTION

Apply the distortion m_dDistortion.

USE_XPOS

Apply the insert point’s X-coordinate m_cPosition.x.

USE_YPOS

Apply the insert point’s Y-coordinate m_cPosition.y.

USE_GAMMA

Apply the gamma index in m_cEffect.m_nGamma.

USE_BRIGHTNESS

Apply the relative brightness in m_cEffect.m_nBrightness.

USE_CONTRAST

Apply the relative contrast in m_cEffect.m_nContrast.

USE_INTENSITY

Apply the relative intensity in m_cEffect.m_nIntensity.

USE_MASK

Apply the m_nDisplayMode bit MKI_BITMAPDISPLAY_MASK.

USE_MASKCOLOR

Apply the mask color in m_cEffect.m_cMaskColor.

USE_FITMODE New in Version 2025.0

Apply the fitting mode in m_nFitMode.

USE_ALIGNMODE New in Version 2025.0

Apply the alignment mode in m_nAlignMode.