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

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;

  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_nEffect New in Version 2024.1

[MKI_BITMAP_EFFECT] Options for live image processing.

m_cMaskColor New in Version 6.60

[MKI_COLORVALUE] Transparent color of the bitmap in RGB notation.

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_nGamma.

USE_BRIGHTNESS

Apply the relative brightness in m_nBrightness.

USE_CONTRAST

Apply the relative contrast in m_nContrast.

USE_INTENSITY

Apply the relative intensity in m_nIntensity.

USE_MASK

Apply the m_nDisplayMode bit MKI_BITMAPDISPLAY_MASK.

USE_MASKCOLOR

Apply the mask color in m_cMaskColor.