#include <c4d_baseobject.h>

Inheritance diagram for PolygonObject:

[legend]

Detailed Description

Represents a Polygon object.

Note: Has to be created with Alloc() and destroyed with Free(). Use AutoAlloc to automate the allocation and destruction based on scope.

Private Member Functions
	PolygonObject ()

	~PolygonObject ()

Alloc/Free
static PolygonObject *	Alloc (Int32 pcnt, Int32 vcnt)

static void	Free (PolygonObject *&bl)

Selected/Hidden Polygon/Edge
BaseSelect *	GetPolygonS ()

const BaseSelect *	GetPolygonS () const

BaseSelect *	GetPolygonH ()

const BaseSelect *	GetPolygonH () const

EdgeBaseSelect *	GetEdgeS ()

const EdgeBaseSelect *	GetEdgeS () const

EdgeBaseSelect *	GetEdgeH ()

const EdgeBaseSelect *	GetEdgeH () const

EdgeBaseSelect *	GetPhongBreak ()

const EdgeBaseSelect *	GetPhongBreak () const

BaseSelect *	GetShadingBreak (Bool includeBorderEdges, Bool includeUserBreak, Bool includeUserNormals, Float userNormalsAngle=DegToRad(5.0), Float autoNormalsAngle=DegToRad(180.0))

Polygon
const CPolygon *	GetPolygonR () const

CPolygon *	GetPolygonW ()

Int32	GetPolygonCount () const

Resize Object
Bool	ResizeObject (Int32 pcnt, Int32 vcnt)

Bool	ResizeObject (Int32 pcnt, Int32 vcnt, Int32 ncnt)

Bool	ResizeObject (Int32 pcnt, Int32 vcnt, Int32 ncnt, Int32 vc_flags)

Get/Set Edge Selection
BaseSelect *	GetSelectedEdges (Neighbor *e, EDGESELECTIONTYPE ltype)

BaseSelect *	GetSelectedEdges (Neighbor e, BaseSelect sel)

Bool	SetSelectedEdges (Neighbor e, BaseSelect pSel, EDGESELECTIONTYPE ltype)

Phong Normals
Vector32 *	CreatePhongNormals ()

N-gon
Bool	GetPolygonTranslationMap (Int32 &ngoncnt, Int32 *&polymap)

Bool	GetNGonTranslationMap (Int32 ngoncnt, Int32 polymap, Int32 *&ngons)

Pgon *	GetAndBuildNgon ()

Int32	GetNgonCount ()

void	GetSelectedNgons (BaseSelect *sel)

void	GetHiddenNgons (BaseSelect *sel)

NgonBase *	GetNgonBase ()

Bool	ValidateEdgeSelection (BaseSelect *sel)

Bool	ValidateEdgeSelection ()

Bool	GetEdgeSelection (BaseSelect *sel, EDGESELECTIONTYPE type)

void	GetNgonEdgesCompact (UChar *&edges)

Additional Inherited Members
Public Member Functions inherited from PointObject
BaseSelect *	GetPointS ()

const BaseSelect *	GetPointS () const

BaseSelect *	GetPointH ()

const BaseSelect *	GetPointH () const

const Vector *	GetPointR () const

Vector *	GetPointW ()

Int32	GetPointCount () const

Float32 *	CalcVertexMap (BaseObject *modifier)

Bool	ResizeObject (Int32 pcnt)

void	IncreaseBoundingBox (Int32 cnt, Vector *v)

Public Member Functions inherited from BaseObject
BaseObject *	GetNext ()

BaseObject *	GetPred ()

BaseObject *	GetUp ()

BaseObject *	GetDown ()

BaseObject *	GetDownLast ()

Vector	GetAbsPos () const

void	SetAbsPos (const Vector &v)

Vector	GetAbsScale () const

void	SetAbsScale (const Vector &v)

Vector	GetAbsRot () const

void	SetAbsRot (const Vector &v)

Vector	GetFrozenPos () const

void	SetFrozenPos (const Vector &v)

Vector	GetFrozenScale () const

void	SetFrozenScale (const Vector &v)

Vector	GetFrozenRot () const

void	SetFrozenRot (const Vector &v)

Vector	GetRelPos () const

void	SetRelPos (const Vector &v)

Vector	GetRelScale () const

void	SetRelScale (const Vector &v)

Vector	GetRelRot () const

void	SetRelRot (const Vector &v)

const Matrix &	GetMl () const

void	SetMl (const Matrix &m)

Matrix	GetFrozenMln () const

Matrix	GetRelMln () const

Matrix	GetRelMl () const

void	SetRelMl (const Matrix &m)

Matrix	GetMg () const

void	SetMg (const Matrix &m)

Matrix	GetMln () const

Matrix	GetMgn () const

Matrix	GetUpMg () const

void	CopyMatrixTo (BaseObject *dst)

Vector	GetMp ()

Vector	GetRad ()

void	GetDimension (Vector &mp, Vector &rad)

Int32	GetEditorMode () const

Int32	GetEditorModeH () const

void	SetEditorMode (Int32 mode)

Int32	GetRenderMode () const

Int32	GetRenderModeH () const

void	SetRenderMode (Int32 mode)

Bool	GetDeformMode () const

void	SetDeformMode (Bool mode)

Int32	GetRealDeformMode () const

void	SetRealDeformMode (Int32 mode)

Int32	GetUniqueIP ()

void	SetUniqueIP (Int32 ip)

BaseTag *	GetFirstTag ()

BaseTag *	GetLastTag ()

BaseTag *	GetTag (Int32 type, Int32 nr=0)

const maxon::BaseArray< BaseTag * > *	GetTagsOfType (Int32 type) const

const maxon::BaseArray< BaseTag * > *	GetTagsWithFlags (Int32 flags) const

const void *	GetTagDataR (Int32 type, Int32 nr=0) const

void *	GetTagDataW (Int32 type, Int32 nr=0)

Int32	GetTagDataCount (Int32 type) const

BaseTag *	MakeTag (Int32 type, BaseTag *pred=nullptr)

VariableTag *	MakeVariableTag (Int32 type, Int32 count, BaseTag *pred=nullptr)

void	InsertTag (BaseTag tp, BaseTag pred=nullptr)

void	KillTag (Int32 type, Int32 nr=0)

Bool	CopyTagsTo (BaseObject dest, Int32 visible, Int32 variable, Int32 hierarchical, AliasTrans trans)

BaseObject *	GetCache (HierarchyHelp *hh=nullptr)

BaseObject *	GetDeformCache ()

LineObject *	GetIsoparm ()

void	SetIsoparm (LineObject *l)

BaseObject *	GetCacheParent () const

BaseObject *	GetCacheTopParent () const

Bool	SetPhong (Bool on, Bool anglelimit, Float angle)

Bool	IsDirty (DIRTYFLAGS flags)

void	SetDirty (DIRTYFLAGS flags)

Bool	CheckCache (HierarchyHelp *hh)

void	Touch ()

void	GetColorProperties (ObjectColorProperties *prop)

void	SetColorProperties (ObjectColorProperties *prop)

const Matrix &	GetModelingAxis (BaseDocument *doc)

void	SetModelingAxis (const Matrix &m)

BaseObject *	GetAndCheckHierarchyClone (HierarchyHelp hh, BaseObject op, HIERARCHYCLONEFLAGS flags, Bool dirty, AliasTrans trans, Int childCount, maxon::BaseArray< BaseObject * > *children, Bool addChildOrClone=false)

BaseObject *	GetAndCheckHierarchyClone (HierarchyHelp hh, BaseObject op, HIERARCHYCLONEFLAGS flags, Bool dirty, AliasTrans trans, Bool allchildren)

BaseObject *	GetHierarchyClone (HierarchyHelp hh, BaseObject op, HIERARCHYCLONEFLAGS flags, Bool dirty, AliasTrans trans)

BaseObject *	GetHierarchyClone (HierarchyHelp hh, BaseObject op, HIERARCHYCLONEFLAGS flags, Bool dirty, AliasTrans trans, DIRTYFLAGS dirtyflags)

void	NewDependenceList ()

Bool	CompareDependenceList ()

void	AddDependence (HierarchyHelp hh, BaseObject op)

void	AddDependence (HierarchyHelp hh, BaseObject op, DIRTYFLAGS dirtyflags)

void	TouchDependenceList ()

void	SetRotationOrder (ROTATIONORDER order)

ROTATIONORDER	GetRotationOrder () const

void	SetQuaternionRotationMode (Bool active, Bool bUndo)

Bool	IsQuaternionRotationMode ()

Bool	SynchronizeVectorTrackKeys (Int32 vectorTrackID, Bool bUndo, BaseTime startRange=BaseTime(-108000, 1), BaseTime endRange=BaseTime(108000, 1))

Bool	FindBestEulerAngle (Int32 rotationTrackID, Bool bAdjustTangent, Bool bUndo, BaseTime startRange=BaseTime(-108000, 1), BaseTime endRange=BaseTime(108000, 1))

Bool	EvaluateSynchronizedRotation (const BaseTime &time, ANIMATEFLAGS flags, Vector *resultRotation=nullptr)

Bool	GetVectorTracks (const DescID &id, CTrack &xfound, CTrack &yfound, CTrack *&zfound)

Bool	GetVectorCurves (CCurve curveToSearch, CCurve &xfound, CCurve &yfound, CCurve &zfound)

UInt64	GetGUID ()

Int32	GetHighlightHandle (BaseDraw *bd)

SplineObject *	GetRealSpline ()

Float	GetVisibility (Float parent)

Bool	SearchHierarchy (BaseObject *op)

BaseObject *	GetOrigin (Bool safe)

void	SetOrigin (BaseObject *origin)

BaseObject *	GetTopOrigin (Bool parent, Bool safe)

BaseObject *	GetEditObject (BaseObject **psds, DISPLAYEDITSTATE state, Bool safetey=true)

void	RemoveFromCache ()

DRAWRESULT	ObjDraw (DRAWPASS drawpass, BaseDraw bd, BaseDrawHelp bh)

Public Member Functions inherited from BaseList2D
void	SetBit (Int32 mask)

Bool	GetBit (Int32 mask) const

void	DelBit (Int32 mask)

void	ToggleBit (Int32 mask)

Int32	GetAllBits () const

void	SetAllBits (Int32 bits)

void	SetBitEx (Int32 mask, Int32 flags)

const Char *	GetViewportRenderId (VIEWPORT_RENDER_ID typeId) const

BaseList2D *	GetNext ()

BaseList2D *	GetPred ()

BaseContainer	GetData ()

void	SetData (const BaseContainer &bc, Bool add=true)

const BaseContainer *	GetDataInstance () const

BaseContainer *	GetDataInstance ()

const BaseContainer &	GetDataInstanceRef () const

BaseContainer &	GetDataInstanceRef ()

String	GetName () const

void	SetName (const maxon::String &name)

String	GetBubbleHelp ()

Bool	TransferGoal (BaseList2D *dst, Bool undolink)

Bool	TransferMarker (BaseList2D *dst) const

Bool	Scale (Float scale)

Bool	Edit ()

void	GetIcon (IconData *dat)

GeListHead *	GetNLARoot ()

BaseList2D *	AnimationLayerRemap (BaseObject **layer=nullptr)

String	GetTypeName ()

BaseList2D *	GetMain () const

void	InsertTrackSorted (CTrack *track)

Bool	AddEventNotification (BaseList2D bl, NOTIFY_EVENT eventid, NOTIFY_EVENT_FLAG flags, const BaseContainer data)

Bool	RemoveEventNotification (BaseDocument doc, BaseList2D bl, NOTIFY_EVENT eventid)

Bool	FindEventNotification (BaseDocument doc, BaseList2D bl, NOTIFY_EVENT eventid)

Bool	SetDescIDState (const DescID &id, DESCIDSTATE descidstate)

DESCIDSTATE	GetDescIDState (const DescID &id, Bool tolerant) const

GeListHead *	GetOverrideRoot ()

BaseOverride *	GetFirstOverride ()

GeListHead *	GetShaderRepositoryRoot ()

GeListHead *	GetHiddenShaderRoot ()

maxon::NimbusForwardRef	GetNimbusRef (const maxon::Id &spaceId) const

maxon::Result< maxon::NimbusForwardRef >	PrivateGetOrCreateNimbusRef (const maxon::Id &spaceId)

void	RemoveNimbusRef (const maxon::Id &spaceId)

maxon::Result< maxon::HashMap< maxon::Id, maxon::NimbusForwardRef > >	GetAllNimbusRefs () const

Bool	IsNodeBased () const

void	GetMarkerStampEx (UInt32 l1, UInt32 l2)

const GeMarker &	GetMarker () const

void	SetMarker (const GeMarker &m)

Bool	AddUniqueID (Int32 appid, const Char *const mem, Int bytes)

Bool	FindUniqueID (Int32 appid, const Char *&mem, Int &bytes) const

Int32	GetUniqueIDCount () const

Bool	GetUniqueIDIndex (Int32 idx, Int32 &id, const Char *&mem, Int &bytes) const

Bool	SetAnimatedParameter (CTrack *track, const DescID &id, const GeData &t_data1, const GeData &t_data2, Float mix, DESCFLAGS_SET flags)

Bool	GetAnimatedParameter (const DescID &id, GeData &t_data1, GeData &t_data2, Float &mix, DESCFLAGS_GET flags)

BaseShader *	GetFirstShader () const

void	InsertShader (BaseShader shader, BaseShader pred=nullptr)

void	ClearKeyframeSelection ()

Bool	FindKeyframeSelection (const DescID &id)

Bool	SetKeyframeSelection (const DescID &id, Bool selection)

Bool	KeyframeSelectionContent ()

LayerObject *	GetLayerObject (BaseDocument *doc)

Bool	SetLayerObject (LayerObject *layer)

const LayerData *	GetLayerData (BaseDocument *doc, Bool rawdata=false)

Bool	SetLayerData (BaseDocument *doc, const LayerData &data)

GeListHead *	GetCTrackRoot ()

CTrack *	GetFirstCTrack ()

CTrack *	FindCTrack (const DescID &id)

Public Member Functions inherited from GeListNode
GeListNode *	GetNext ()

GeListNode *	GetPred ()

GeListNode *	GetDown ()

GeListNode *	GetUp ()

GeListNode *	GetDownLast ()

void	InsertBefore (GeListNode *bl)

void	InsertAfter (GeListNode *bl)

void	InsertUnder (GeListNode *bl)

void	InsertUnderLast (GeListNode *bl)

void	Remove ()

GeListHead *	GetListHead ()

Int32	GetNodeID (Int32 index=0) const

template<typename CAST >
const CAST *	GetNodeData (Int32 index=0) const

template<typename CAST >
CAST *	GetNodeData (Int32 index=0)

void	SetCustomData (GeListNode *node)

GeListNode *	GetCustomData ()

BaseDocument *	GetDocument ()

Int32	GetBranchInfo (BranchInfo *info, Int32 max, GETBRANCHINFO flags)

Bool	IsDocumentRelated ()

Int32	GetInfo () const

Bool	GetNBit (NBIT bit) const

UInt32	GetNBitMask (Int32 index) const

Bool	ChangeNBit (NBIT bit, NBITCONTROL bitmode)

Public Member Functions inherited from C4DAtom
Int32	GetType () const

Int32	GetRealType () const

Int32	GetDiskType () const

Bool	IsInstanceOf (Int32 id) const

Int32	GetClassification () const

Bool	Message (Int32 type, void *data=nullptr)

Bool	MultiMessage (MULTIMSG_ROUTE flags, Int32 type, void *data)

C4DAtom *	GetClone (COPYFLAGS flags, AliasTrans *trn)

Bool	CopyTo (C4DAtom dst, COPYFLAGS flags, AliasTrans trn)

Bool	Read (HyperFile *hf, Int32 id, Int32 level)

Bool	Write (HyperFile *hf)

Bool	ReadObject (HyperFile *hf, Bool readheader)

Bool	WriteObject (HyperFile *hf)

Bool	GetDescription (Description *description, DESCFLAGS_DESC flags)

Bool	GetParameter (const DescID &id, GeData &t_data, DESCFLAGS_GET flags)

Bool	SetParameter (const DescID &id, const GeData &t_data, DESCFLAGS_SET flags)

DynamicDescription *	GetDynamicDescription ()

Bool	GetEnabling (const DescID &id, const GeData &t_data, DESCFLAGS_ENABLE flags, const BaseContainer *itemdesc)

Bool	TranslateDescID (const DescID &id, DescID &res_id, C4DAtom *&res_at)

UInt32	GetDirty (DIRTYFLAGS flags) const

void	SetDirty (DIRTYFLAGS flags)

UInt32	GetHDirty (HDIRTYFLAGS mask) const

void	SetHDirty (HDIRTYFLAGS mask)

Static Public Member Functions inherited from BaseObject
static BaseObject *	Alloc (Int32 type)

static void	Free (BaseObject *&bl)

Static Public Member Functions inherited from BaseList2D
static BaseList2D *	Alloc (Int32 type)

static void	Free (BaseList2D *&bl)

Static Public Attributes inherited from BaseList2D
static const Int32	SETBIT_FLAG_NODIRTY

static const Int32	SETBIT_FLAG_REMOVE

Constructor & Destructor Documentation

◆ PolygonObject()

PolygonObject ( )

private

◆ ~PolygonObject()

~PolygonObject ( )

private

Member Function Documentation

◆ Alloc()

static PolygonObject* Alloc	(	Int32	pcnt,
		Int32	vcnt
	)

static

Allocates a Polygon object. Destroy the allocated Polygon object with Free(). Use AutoAlloc to automate the allocation and destruction based on scope.

Parameters

[in]	pcnt	The point count.
[in]	vcnt	The polygon count.

Returns: The allocated Polygon object, or nullptr if the allocation failed.

◆ Free()

static void Free ( PolygonObject *& bl )

static

Destructs Polygon objects allocated with Alloc(). Use AutoAlloc to automate the allocation and destruction based on scope.

Parameters

[in,out] bl The Polygon object to destruct. If the pointer is nullptr nothing happens. The pointer is assigned nullptr afterwards.

◆ GetPolygonS() [1/2]

BaseSelect* GetPolygonS ( )

Gets the selected polygons (visible ones only).

Returns: The selection of visible polygons. The Polygon object owns the pointed base select.

◆ GetPolygonS() [2/2]

const BaseSelect* GetPolygonS ( ) const

Gets the selected polygons (visible ones only).

Returns: The selection of visible polygons. The Polygon object owns the pointed base select.

◆ GetPolygonH() [1/2]

BaseSelect* GetPolygonH ( )

Gets the hidden polygons (hidden ones within the editor only).

Returns: The hidden polygons. The Polygon object owns the pointed base select.

◆ GetPolygonH() [2/2]

const BaseSelect* GetPolygonH ( ) const

Gets the hidden polygons (hidden ones within the editor only).

Returns: The hidden polygons. The Polygon object owns the pointed base select.

◆ GetEdgeS() [1/2]

EdgeBaseSelect* GetEdgeS ( )

Gets the selected edges (visible ones only).
The edges are indexed by 4 * polygon + edge where polygon is the polygon index and edge is the edge index between 0 and 3.

Note: If the selection is changed make sure it is still valid, so that shared edges have a well-defined selection status.
It is safer to use SetSelectedEdges().

Returns: The selection of visible edges. The Polygon object owns the pointed base select.

See also: GetSelectedEdges()
SetSelectedEdges()

◆ GetEdgeS() [2/2]

const EdgeBaseSelect* GetEdgeS ( ) const

Gets the selected edges (visible ones only).
The edges are indexed by 4 * polygon + edge where polygon is the polygon index and edge is the edge index between 0 and 3.

Note: If the selection is changed make sure it is still valid, so that shared edges have a well-defined selection status.
It is safer to use SetSelectedEdges().

Returns: The selection of visible edges. The Polygon object owns the pointed base select.

See also: GetSelectedEdges()
SetSelectedEdges()

◆ GetEdgeH() [1/2]

EdgeBaseSelect* GetEdgeH ( )

Gets the hidden edges (hidden ones within the editor only).
The edges are indexed by 4 * polygon + edge where polygon is the polygon index and edge is the edge index between 0 and 3.

Note: If this selection is changed make sure it is still valid, so that shared edges have a well-defined selection status.
It is safer to use SetSelectedEdges().

Returns: The hidden edges. The Polygon object owns the pointed base select.

◆ GetEdgeH() [2/2]

const EdgeBaseSelect* GetEdgeH ( ) const

Gets the hidden edges (hidden ones within the editor only).
The edges are indexed by 4 * polygon + edge where polygon is the polygon index and edge is the edge index between 0 and 3.

Note: If this selection is changed make sure it is still valid, so that shared edges have a well-defined selection status.
It is safer to use SetSelectedEdges().

Returns: The hidden edges. The Polygon object owns the pointed base select.

◆ GetPhongBreak() [1/2]

EdgeBaseSelect* GetPhongBreak ( )

Gets the Phong break edges.
The edges are indexed by 4 * polygon + edge where polygon is the polygon index and edge is the edge index between 0 and 3.

Note: If the selection is changed make sure it is still valid, so that shared edges have a well-defined selection status.
It is safer to use SetSelectedEdges().

Returns: The Phong break edges. The Polygon object owns the pointed base select.

◆ GetPhongBreak() [2/2]

const EdgeBaseSelect* GetPhongBreak ( ) const

Gets the Phong break edges.
The edges are indexed by 4 * polygon + edge where polygon is the polygon index and edge is the edge index between 0 and 3.

Note: If the selection is changed make sure it is still valid, so that shared edges have a well-defined selection status.
It is safer to use SetSelectedEdges().

Returns: The Phong break edges. The Polygon object owns the pointed base select.

◆ GetShadingBreak()

BaseSelect* GetShadingBreak	(	Bool	includeBorderEdges,
		Bool	includeUserBreak,
		Bool	includeUserNormals,
		Float	userNormalsAngle = `DegToRad(5.0)`,
		Float	autoNormalsAngle = `DegToRad(180.0)`
	)

Gets the shading break edges based on neighbor polygons shading edges and a specified

Since: R19

Border edges can optionally be marked as break edges. Current break edges can optionally be included (merged) in the resulting break edges.

Finally, user normal vectors can optionally be considered using a separate angle limit for this purpose.

Note: The edges are indexed by 4 * polygon + edge where polygon is the polygon index and edge is the edge index between 0 and 3.

Since: R19

Parameters

[in]	includeBorderEdges	true to mark border edges as break edges, otherwise false.
[in]	includeUserBreak	true to include the user break edges (same as obtained with GetPhongBreak), otherwise false.
[in]	includeUserNormals	true to consider user normals using the userNormalAngle parameter, otherwise false.
[in]	userNormalsAngle	The angle limit in radians beyond which polygon vertex normals sharing edge vertices create a break edge.
[in]	autoNormalsAngle	The angle limit in radians beyond which polygon normals sharing an edge create a break edge.

Returns: The shading break edges. The PolygonObject owns the pointed BaseSelect.

◆ GetPolygonR()

const CPolygon* GetPolygonR ( ) const

Gets the start of the read-only array of polygons.

Note: While this function may sound trivial and cheap, internally it is not. For performance reasons, it is not recommended to use this function inside a loop or inside a loop condition.

Returns: The first element in the read-only polygon array. The Polygon object owns the pointed array.

◆ GetPolygonW()

CPolygon* GetPolygonW ( )

Gets the start of the writable array of polygons.

Note: While this function may sound trivial and cheap, internally it is not. For performance reasons, it is not recommended to use this function inside a loop or inside a loop condition.

Returns: The first element in the writable polygon array. The Polygon object owns the pointed array.

◆ GetPolygonCount()

Int32 GetPolygonCount ( ) const

Gets the number of polygons in the object.

Note: While this function may sound trivial and cheap, internally it is not. For performance reasons, it is not recommended to use this function inside a loop or inside a loop condition.

Returns: The polygon count.

◆ ResizeObject() [1/3]

Bool ResizeObject	(	Int32	pcnt,
		Int32	vcnt
	)

Changes the number of points and polygons in the object.

Parameters

[in]	pcnt	The new number of points.
[in]	vcnt	The new number of polygons.

Returns: true if the number of points and polygons was changed successfully, otherwise false.

◆ ResizeObject() [2/3]

Bool ResizeObject	(	Int32	pcnt,
		Int32	vcnt,
		Int32	ncnt
	)

Changes the number of points, polygons and N-gons in the object.

Parameters

[in]	pcnt	The new number of points.
[in]	vcnt	The new number of polygons.
[in]	ncnt	The new number of N-gons.

Returns: true if the number of points, polygons and N-gons was changed successfully, otherwise false.

◆ ResizeObject() [3/3]

Bool ResizeObject	(	Int32	pcnt,
		Int32	vcnt,
		Int32	ncnt,
		Int32	vc_flags
	)

Changes the number of points, polygons and N-gons in the object with variable changed flags.

Parameters

[in]	pcnt	The new number of points.
[in]	vcnt	The new number of polygons.
[in]	ncnt	The new number of N-gons.
[in]	vc_flags	The variable changed flags: VC_FLAGS

Returns: true if the number of points, polygons and N-gons was changed successfully, otherwise false.

◆ GetSelectedEdges() [1/2]

BaseSelect* GetSelectedEdges	(	Neighbor *	e,
		EDGESELECTIONTYPE	ltype
	)

Gets the selected, hidden or phong break edges.
The edges are indexed uniquely by a Neighbor object, so each edge has a single index.

Note: Convenience wrapper around GetEdgeS(), GetEdgeH() and GetPhongBreak().

Warning: The returned BaseSelect* must be deleted with BaseSelect::Free() afterwards.

Parameters

[in]	e	The neighbor object with information about the edge topology. Must be initialized with all polygons: Neighbor::Init(poly->GetPointCount(), poly->GetPolygonR(), poly->GetPolygonCount(), nullptr); Neighbor::Init virtual Bool Init(Int32 pcnt, const CPolygon vadr, Int32 vcnt, BaseSelect bs)
[in]	ltype	The type of edge selection to get: EDGESELECTIONTYPE

Returns: The selected edges. The caller owns the pointed base select.

◆ GetSelectedEdges() [2/2]

BaseSelect* GetSelectedEdges	(	Neighbor *	e,
		BaseSelect *	sel
	)

Converts a regular edge selection (4 * polygon + edge) to an edge selection that can be used with the PolyInfo::edge array.

Warning: The returned BaseSelect* must be deleted with BaseSelect::Free() afterwards.

Parameters

[in]	e	The neighbor object with information about the edge topology. Must be initialized with all polygons: Neighbor::Init(poly->GetPointCount(), poly->GetPolygonR(), poly->GetPolygonCount(), nullptr);
[in]	sel	The selection to convert. The caller owns the pointed base select.

Returns: The converted selection. The caller owns the pointed base select.

◆ SetSelectedEdges()

Bool SetSelectedEdges	(	Neighbor *	e,
		BaseSelect *	pSel,
		EDGESELECTIONTYPE	ltype
	)

Sets the selected, hidden or phong break edges.
The edges are indexed uniquely by a Neighbor object, so each edge has a single index.

Note: Convenience wrapper around GetEdgeS(), GetEdgeH() and GetPhongBreak().

Parameters

[in]	e	The neighbor object with information about the edge topology. Must be initialized with all polygons: Neighbor::Init(poly->GetPointCount(), poly->GetPolygonR(), poly->GetPolygonCount(), nullptr);
[in]	pSel	The edge selection. The caller owns the pointed base select.
[in]	ltype	The type of edge selection to set: EDGESELECTIONTYPE

Returns: true if the edge selection succeeded, otherwise false.

◆ CreatePhongNormals()

Vector32* CreatePhongNormals ( )

Gets an array with the stored Phong normals of the object.
The array contains 4* GetPolygonCount() vectors, one for each point of each face (including the unused fourth point for triangles).

Note: Only valid if the object has a Phong tag.

Warning: The returned array has to be freed with DeleteMem() afterwards.

Returns: The Phong normals. The caller owns the pointed array.

◆ GetPolygonTranslationMap()

Bool GetPolygonTranslationMap	(	Int32 &	ngoncnt,
		Int32 *&	polymap
	)

Gets a translation map from polygon indices to N-gon indices.
If polymap[i] = p then polygon i is part of the N-gon p.

Warning: polymap needs to be freed with DeleteMem() afterwards.

Parameters

[in,out]	ngoncnt	Assigned the number of N-gons. This is not the same value as returned by GetNgonCount(). ngoncnt includes all regular polygons as well.
[in,out]	polymap	Assigned a pointer to the N-gon index map. The caller owns the pointed array.

Returns: true if successful, otherwise false.

◆ GetNGonTranslationMap()

Bool GetNGonTranslationMap	(	Int32	ngoncnt,
		Int32 *	polymap,
		Int32 **&	ngons
	)

Gets a translation map from N-gon indices to polygon indices.
The number of polygons in N-gon i is stored in ngons[i][0]. Then the polygon indices are stored in ngons[i][j] where j goes from 1 to ngons[i][0].

Warning: ngons map needs to be freed with DeleteMem() afterwards.

Parameters

[in,out]	ngoncnt	The number of N-gons. Use the value returned by GetPolygonTranslationMap(), not GetNgonCount().
[in,out]	polymap	The polygon map. Use the map returned by GetPolygonTranslationMap(), or a similarly formatted array. The caller owns the pointed array.
[in,out]	ngons	Assigned a pointer to the polygon index map. The caller owns the pointed array.

Returns: true if successful, otherwise false.

◆ GetAndBuildNgon()

Pgon* GetAndBuildNgon ( )

Gets the start of the array of N-gons.

Returns: The N-gon array. The Polygon object owns the pointed array.

◆ GetNgonCount()

Int32 GetNgonCount ( )

Gets the number of N-gons in the object, i.e. the number of polygons with more points than 4.

Returns: The number of N-gons.

◆ GetSelectedNgons()

void GetSelectedNgons ( BaseSelect * sel )

Gets the current N-gon selection.
It has the same order as the GetNGonTranslationMap().

Parameters

[out] sel Assigned the current N-gon selection.

◆ GetHiddenNgons()

void GetHiddenNgons ( BaseSelect * sel )

Gets the current hidden N-gon selection.
It has the same order as GetNGonTranslationMap().

Parameters

[out] sel Assigned the current hidden N-gon selection.

◆ GetNgonBase()

NgonBase* GetNgonBase ( )

Gets the NgonBase instance for the object.

Returns: The N-gon base. The Polygon object owns the pointed NgonBase.

◆ ValidateEdgeSelection() [1/2]

Bool ValidateEdgeSelection ( BaseSelect * sel )

Deselects all selected edges in sel that are N-gon edges.

Parameters

[in] sel The selection to check for N-gon edges. The caller owns the pointed BaseSelect.

Returns: true if successful, otherwise false.

◆ ValidateEdgeSelection() [2/2]

Bool ValidateEdgeSelection ( )

Deselects all selected edges that are N-gon edges.

Returns: true if successful, otherwise false.

◆ GetEdgeSelection()

Bool GetEdgeSelection	(	BaseSelect *	sel,
		EDGESELECTIONTYPE	type
	)

Deselects all edges in sel that are N-gon edges as specified by type.

Parameters

[in]	sel	The selection to check for N-gon edges. The caller owns the pointed BaseSelect.
[in]	type	The type of selection to check: EDGESELECTIONTYPE

Returns: true if successful, otherwise false.

◆ GetNgonEdgesCompact()

void GetNgonEdgesCompact ( UChar *& edges )

Retrieves an array that contains N-gon information for each polygon.
If edges[poly_index] & (1 << edge_index) != 0 the edge is a hidden N-gon edge, where edge_index is between 0 - 3 for quads and 0, 1 or 3 for triangles.

Warning: edges array needs to be freed with DeleteMem() afterwards.

Parameters

[out] edges Assigned a pointer to the compact N-gon edges array. The caller owns the pointed array.

Detailed Description

Private Member Functions

Alloc/Free

Selected/Hidden Polygon/Edge

Polygon

Resize Object

Get/Set Edge Selection

Phong Normals

N-gon

Additional Inherited Members

Constructor & Destructor Documentation

◆ PolygonObject()

◆ ~PolygonObject()

Member Function Documentation

◆ Alloc()

◆ Free()

◆ GetPolygonS() [1/2]

◆ GetPolygonS() [2/2]

◆ GetPolygonH() [1/2]

◆ GetPolygonH() [2/2]

◆ GetEdgeS() [1/2]

◆ GetEdgeS() [2/2]

◆ GetEdgeH() [1/2]

◆ GetEdgeH() [2/2]

◆ GetPhongBreak() [1/2]

◆ GetPhongBreak() [2/2]

◆ GetShadingBreak()

◆ GetPolygonR()

◆ GetPolygonW()

◆ GetPolygonCount()

◆ ResizeObject() [1/3]

◆ ResizeObject() [2/3]

◆ ResizeObject() [3/3]

◆ GetSelectedEdges() [1/2]

◆ GetSelectedEdges() [2/2]

◆ SetSelectedEdges()

◆ CreatePhongNormals()

◆ GetPolygonTranslationMap()

◆ GetNGonTranslationMap()

◆ GetAndBuildNgon()

◆ GetNgonCount()

◆ GetSelectedNgons()

◆ GetHiddenNgons()

◆ GetNgonBase()

◆ ValidateEdgeSelection() [1/2]

◆ ValidateEdgeSelection() [2/2]

◆ GetEdgeSelection()

◆ GetNgonEdgesCompact()