C++ Syntax

MKI_XPROPERTY_PTR

MKI_EntityBitmap(

const LPCWSTR f_pszFileName,

double f_dX,

double f_dY,

__int32 f_nFitMode,

double f_dFitSizeX,

double f_dFitSizeY,

__int32 f_nAlignMode,

bool f_fEmbed );

A macro-style command that creates a bitmap reference and inserts it to a currently open provisional clipping surface, extended object, group, block, or to the current drawing (in that order).

Parameters

f_pszFileName

[const LPCWSTR] File name of the image file containing the bitmap to be referenced.

f_dX

f_dY

[double] Alignment point in internal [mm] (relative to the internal origin, scale-independent).

f_nFitMode

[__int32] Fitting mode, see MKI_FITMODE_*.

f_dFitSizeX

f_dFitSizeY

[double] Absolute size of a rectangle in internal [mm] to fit into. It starts at f_dX and f_dY and extents to the right and upwards. If one or both values are zero or negative, no fitting will occur. Will be ignored if f_nFitMode is MKI_FITMODE_NONE.

f_nAlignMode

[__int32] Alignment mode, see MKI_ALIGNMODE_*.

f_fEmbed

[bool] If true, the bitmap will be embedded, i.e. the image data will become part of the drawing (increasing the drawing size significantly). Otherwise, the image data will only be referenced by file name (making the drawing dependent from the external bitmap file).

Return Value

Returns the address of the newly created entity's property set is successful, else nullptr.