C++ Syntax

class MKI_ENTITY_PATCH : public MKI_ENTITY_BASE

{

public:

MKI_PATCHPROPERTY m_cProperty;

__int32 m_nPointCount,

m_nInvisible;

MKI_POINT m_pPoint[];

bool

IsFilled( void ) const; New in Version 2022.2

bool

IsErased( void ) const; New in Version 2022.2

bool

IsOpaque( void ) const; New in Version 2022.2

bool

IsFramed( void ) const; New in Version 2022.2

};

This structure describes an entity of type MKI_ENTITYTYPE_PATCH, i.e. a simple display object for use in display lists only. Header.EntityType must be MKI_ENTITYTYPE_PATCH (5).

Element Description

Property Changed in Version 2022.2

[MKI_PATCHPROPERTY] Properties of the patch.

PointCount

[__int32] Number of points in Point. Valid range is 2 to MKI_POINTS_PER_PATCH.

Invisible

[__int32] Bit-wise OR combination of invisibility and inactivity flags for the edges of the patch (see MKI_PATCH_*).

Point

[MKI_POINT[]] This data section contains a list of points.

MKD Syntax

This entity represents a simple line, a triangle, or a quadrangle in display lists of extended objects. This entity type may NOT exist directly in the object list. An entity of type "Patch" has the following structure:

0,EntityOwner,0,UniqueID,Property,

PointCount,Invisible,Point[0].x,Point[0].y,Point[1].x,...;

Element Description

EntityOwner

[__int16] This value is a unique identification of the plug-in that created the entity. The value MKI_DB_OWNER_MK is reserved for use by Malz++Kassner, especially for objects and data blocks that are created and handled directly by the application. Valid range: 0 <= Value < 10000.

Third-party vendors that plan to implement a plug-in should contact Malz++Kassner to receive their unique identification (see Getting Your Private Owner ID).

Point

[MKI_POINT] This data section contains a list of points with two coordinates each.

Patches are entities without any data blocks. They cannot have attributes. They cannot have linked entities.

Example

|Header,XProperty|

0,0,5,"",0,0,2,.5/.5/.5,0/0/0,0.0,0,0,0,

|PointCount,Invisible|

4,5,

|Point[0]|

0.0,0.0,

|Point[1]|

10.0,0.0,

|Point[2]|

10.0,10.0,

|Point[3]|

0.0,10.0;

This entity is a quadrangular patch, representing a square with the corner points (0.0/0.0), (10.0/0.0), (10.0/10.0), and (0.0/10.0). Its first and third edge are invisible, but active. It will be filled in gray and framed with a thin black line.