OdDbMPolygon Class

Class Hierarchy

Syntax

C++

class OdDbMPolygon : public OdDbEntity;

File

DbMPolygon.h

Description

This class processes one or more closed polygons as a single polygon. Corresponding C++ library: AcMPolygonObj15

Group

OdDb Classes

Public Methods

	Name	Description
	~OdDbMPolygon	Destroys the multi polygon object.
	OdDbMPolygon	Creates a new instance of a multi polygon object with default parameters.

OdDbMPolygon Enumerations

	Name	Description
	loopDir	Declares the loop directions.

OdDbMPolygon Methods

	Name	Description
	appendLoopFromBoundary	This is the overview for the appendLoopFromBoundary method overload.
	appendMPolygonLoop	Appends a polygon loop.
	balanceDisplay	Checks loops for intersection and direction. If the cycle is placed at an even level of the tree, and the direction is clockwise, it will be marked as invalid (it will not be displayed). To change direction to the correct one, use balanceTree(). If a cycle intersects with another cycle, the cycle with a higher index will be marked as invalid (not drawn). Loops that have been marked as invalid but have the correct direction and no intersections will be marked as valid and will be drawn again.
	balanceTree	Checks the direction of the loops and changes it to the correct one. The directivity check is based on the resulting tree from getMPolygonTree. Where the depth of the tree indicates the direction of the loop (even values are counterclockwise, odd are clockwise). If in MPolygon there are loops that are not displayed (invalid), they will be marked again as valid (and will be drawn) if they do not intersect with others. Also the check is done for intersections of the displayed (valid) loops. Intersected loops are marked as invalid, and they will not be drawn.
	createLoops	Creates loops from vertices and bulges for empty OdDbMPolygon.
	createLoopsFromBoundaries	Creates loops from entities for an empty OdDbMPolygon. Every ObjectId must be one closed loop.
	deleteMPolygonTree	Recursively deletes the tree created by OdDbMPolygon::getMPolygonTree(OdDbMPolygonNode*& loopNode).
	dwgInFields	Reads the .dwg file data of this object.
	dwgOutFields	Writes the .dwg file data of this object.
	dxfInFields	Reads the DXF data of this object.
	dxfOutFields	Writes the DXF data of this object.
	elevation	Returns the elevation of this entity in the OCS.
	evaluateHatch	Evaluates the hatch for this MPolygon entity.
	getArea	Returns the area of this entity.
	getChildLoops	Returns an array of indices of the loops that are children of the specified loop.
	getClosestLoopTo	Finds the closest loop from the OdDbMPolygon within the pick box around the specified 3D point.
	getLoopDirection	Gets the direction of the specified loop in the closed polygon.
	getMPolygonLoopAt	Gets the specified loop.
	getMPolygonTree	Creates a nesting tree of nodes, where the nodes represent the nesting of the loops.
	getOffsetVector	Returns the offset vector.
	getParentLoop	Returns the index of the parent loop, related to the specified loop.
	getPatternDefinitionAt	Returns the specified pattern definition line.
	getPerimeter	Calculates the OdDbMPolygon perimeter by adding the lengths of all borders.
	hatch	This is the overview for the hatch method overload.
	insertMPolygonLoopAt	Inserts a polygon loop to the specified position.
	isBalanced	Checks if there are loops that are not drawn (invalid). Does not check loops that are drawn (valid) for intersection or direction.
	isPointInsideMPolygon	The function projects worldPt to the polygon plane, then if the point is on some boundary, indices of these boundaries are added to the loopsArray and the function returns, otherwise it finds the innermost loop containing the point and adds its index to the loopsArray before returning.
	isPointOnLoopBoundary	Determines whether the specified point in WCS is on the specified loop of the polygon.
	normal	Returns the WCS normal to the plane of this entity.
	numMPolygonLoops	Returns the number of loops in the closed polygon.
	numPatternDefinitions	Returns the number of pattern definition lines.
	patternAngle	Returns the pattern angle.
	patternColor	Returns the color information as an OdCmColor instance.
	patternDouble	Returns the pattern double flag.
	patternName	Returns the name of the pattern.
	patternScale	Returns the pattern scale.
	patternSpace	Returns the pattern spacing.
	patternType	Returns the hatch pattern type for this MPolygon entity.
	removeMPolygonLoopAt	Removes a polygon loop from the specified position.
	replaceMPolygonLoopAt	This is the overview for the replaceMPolygonLoopAt method overload.
	saveAs	Creates a geometric representation of the entity for saving proxy graphics or converting to previous formats.
	setElevation	Sets the elevation of this entity in the OCS.
	setGradient	Sets the gradient type and name.
	setGradientAngle	Sets the angle of the gradient.
	setGradientColors	Sets the colors and interpolation values describing the gradient fill.
	setGradientOneColorMode	Controls the oneColorMode.
	setGradientShift	Sets the interpolation value between the default and shifted values of the gradient's definition.
	setLoopDirection	Sets the direction for the specified loop in the closed polygon.
	setNormal	Sets the WCS normal to the plane of this entity.
	setPattern	Sets the pattern data.
	setPatternAngle	Sets the pattern angle.
	setPatternColor	Sets the color information an OdCmColor instance.
	setPatternDouble	Sets the pattern double flag.
	setPatternScale	Sets the pattern scale.
	setPatternSpace	Sets the pattern spacing.
	subExplode	Breaks the polygon into a set of polylines.
	subSetDatabaseDefaults	Applies the default properties of the specified database to this entity.
	subSubentPtr	Create an object by OdDbFullSubentPath to the subentity.
	subTransformBy	Transforms the polygon by a specified matrix.
	subWorldDraw	Indicates whether the entity has no view-dependent graphics.

Send feedback about this topic