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, see MKI_FITMODE_*.

m_nAlignMode New in Version 2025.0

[__int32] Alignment mode for the bitmap, see MKI_ALIGNMODE_*.

m_cFitSize New in Version 2025.0

[MKI_VECTOR] Absolute size of a rectangle in internal [mm] 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. It should be set in any case, even if m_nFitMode is MKI_FITMODE_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.