Triangular mesh. More...

#include <ccMesh.h>

Inheritance diagram for ccMesh:

[legend]

Collaboration diagram for ccMesh:

[legend]

Public Types
enum	MESH_SCALAR_FIELD_PROCESS { SMOOTH_MESH_SF , ENHANCE_MESH_SF }
	Mesh scalar field processes. More...

using	triangleMaterialIndexesSet = ccArray< int, 1, int >
	Container of per-triangle material descriptors.

Public Types inherited from ccHObject
enum	DEPENDENCY_FLAGS { DP_NONE = 0 , DP_NOTIFY_OTHER_ON_DELETE = 1 , DP_NOTIFY_OTHER_ON_UPDATE = 2 , DP_DELETE_OTHER = 8 , DP_PARENT_OF_OTHER = 24 }
	Dependency flags. More...

enum	SelectionBehavior { SELECTION_AA_BBOX , SELECTION_FIT_BBOX , SELECTION_IGNORED }
	Behavior when selected.

using	Container = std::vector< ccHObject * >
	Standard instances container (for children, etc.)

using	Shared = QSharedPointer< ccHObject >
	Shared pointer.

using	SharedContainer = std::vector< Shared >
	Shared instances container (for children, etc.)

using	GlobalBoundingBox = CCCoreLib::BoundingBoxTpl< double >
	Global (non-shifted) bounding-box.

Public Types inherited from ccSerializableObject
enum	DeserializationFlags { DF_POINT_COORDS_64_BITS = 1 , DF_SCALAR_VAL_32_BITS = 2 }
	Deserialization flags (bit-field) More...

typedef QMultiMap< unsigned, unsigned >	LoadedIDMap
	Map of loaded unique IDs (old ID --> new ID)

Public Member Functions
	ccMesh (ccGenericPointCloud *vertices, unsigned uniqueID=ccUniqueIDGenerator::InvalidUniqueID)
	Default ccMesh constructor. More...

	ccMesh (CCCoreLib::GenericIndexedMesh giMesh, ccGenericPointCloud giVertices)
	ccMesh constructor (from a CCCoreLib::GenericIndexedMesh) More...

	~ccMesh () override
	Default destructor.

CC_CLASS_ENUM	getClassID () const override
	Returns class ID. More...

void	setAssociatedCloud (ccGenericPointCloud *cloud)
	Sets the associated vertices cloud (warning)

ccMesh *	cloneMesh (ccGenericPointCloud vertices=nullptr, ccMaterialSet clonedMaterials=nullptr, NormsIndexesTableType clonedNormsTable=nullptr, TextureCoordsContainer cloneTexCoords=nullptr)
	Clones this entity. More...

bool	merge (const ccMesh *mesh, bool createSubMesh)
	Merges another mesh into this one. More...

unsigned	getUniqueIDForDisplay () const override
	Returns object unique ID used for display. More...

ccBBox	getOwnBB (bool withGLFeatures=false) override
	Returns the entity's own bounding-box (with local/shifted coordinates) More...

bool	isSerializable () const override
	Returns whether object is serializable of not. More...

const ccGLMatrix &	getGLTransformationHistory () const override
	Returns the transformation 'history' matrix. More...

ccGenericPointCloud *	getAssociatedCloud () const override
	Returns the vertices cloud. More...

void	refreshBB () override
	Forces bounding-box update. More...

bool	interpolateNormalsBC (unsigned triIndex, const CCVector3d &w, CCVector3 &N) override
	Interpolates normal(s) inside a given triangle. More...

bool	interpolateColors (unsigned triIndex, const CCVector3 &P, ccColor::Rgb &C) override
	Interpolates RGB colors inside a given triangle. More...

bool	interpolateColorsBC (unsigned triIndex, const CCVector3d &w, ccColor::Rgb &C) override
	Interpolates RGB colors inside a given triangle. More...

bool	interpolateColors (unsigned triIndex, const CCVector3 &P, ccColor::Rgba &C) override
	Interpolates RGBA colors inside a given triangle. More...

bool	interpolateColorsBC (unsigned triIndex, const CCVector3d &w, ccColor::Rgba &C) override
	Interpolates RGBA colors inside a given triangle. More...

void	computeInterpolationWeights (unsigned triIndex, const CCVector3 &P, CCVector3d &weights) const override
	Returns the (barycentric) interpolation weights for a given triangle. More...

bool	getColorFromMaterial (unsigned triIndex, const CCVector3 &P, ccColor::Rgba &C, bool interpolateColorIfNoTexture) override
	Returns RGB color fom a given triangle material/texture. More...

bool	getVertexColorFromMaterial (unsigned triIndex, unsigned char vertIndex, ccColor::Rgba &color, bool returnColorIfNoTexture) override
	Returns RGB color of a vertex fom a given triangle material/texture. More...

unsigned	capacity () const override
	Returns max capacity. More...

void	forEach (genericTriangleAction action) override

void	placeIteratorAtBeginning () override

CCCoreLib::GenericTriangle *	_getNextTriangle () override

CCCoreLib::GenericTriangle *	_getTriangle (unsigned triangleIndex) override

CCCoreLib::VerticesIndexes *	getNextTriangleVertIndexes () override

CCCoreLib::VerticesIndexes *	getTriangleVertIndexes (unsigned triangleIndex) override

void	getTriangleVertices (unsigned triangleIndex, CCVector3 &A, CCVector3 &B, CCVector3 &C) const override

unsigned	size () const override

void	getBoundingBox (CCVector3 &bbMin, CCVector3 &bbMax) override

bool	normalsAvailable () const override

bool	interpolateNormals (unsigned triIndex, const CCVector3 &P, CCVector3 &N) override

virtual const CCCoreLib::VerticesIndexes *	getTriangleVertIndexes (unsigned triangleIndex) const

bool	hasColors () const override
	Returns whether colors are enabled or not. More...

bool	hasNormals () const override
	Returns whether normals are enabled or not. More...

bool	hasScalarFields () const override
	Returns whether one or more scalar fields are instantiated. More...

bool	hasDisplayedScalarField () const override
	Returns whether an active scalar field is available or not. More...

bool	normalsShown () const override
	Returns whether normals are shown or not. More...

void	toggleMaterials () override
	Toggles material display state. More...

void	invertNormals ()
	Inverts normals (if any) More...

void	shiftTriangleIndexes (unsigned shift)
	Shifts all triangles indexes. More...

void	flipTriangles ()
	Flips the triangle. More...

void	addTriangle (unsigned i1, unsigned i2, unsigned i3)
	Adds a triangle to the mesh. More...

bool	reserve (size_t n)
	Reserves the memory to store the vertex indexes (3 per triangle) More...

bool	resize (size_t n)
	Resizes the array of vertex indexes (3 per triangle) More...

void	shrinkToFit ()
	Removes unused capacity.

bool	hasTriNormals () const override
	Returns whether the mesh has per-triangle normals. More...

void	getTriangleNormalIndexes (unsigned triangleIndex, int &i1, int &i2, int &i3) const override
	Returns a triplet of normal indexes for a given triangle (if any) More...

bool	getTriangleNormals (unsigned triangleIndex, CCVector3 &Na, CCVector3 &Nb, CCVector3 &Nc) const override
	Returns a given triangle normal. More...

NormsIndexesTableType *	getTriNormsTable () const override
	Returns per-triangle normals shared array. More...

void	setTriNormsTable (NormsIndexesTableType *triNormsTable, bool autoReleaseOldTable=true)
	Sets per-triangle normals array (may be shared)

void	clearTriNormals ()
	Removes per-triangle normals.

bool	arePerTriangleNormalsEnabled () const
	Returns whether per triangle normals are enabled. More...

bool	reservePerTriangleNormalIndexes ()
	Reserves memory to store per-triangle triplets of normal indexes. More...

void	addTriangleNormalIndexes (int i1, int i2, int i3)
	Adds a triplet of normal indexes for next triangle. More...

void	setTriangleNormalIndexes (unsigned triangleIndex, int i1, int i2, int i3)
	Sets a triplet of normal indexes for a given triangle. More...

void	removePerTriangleNormalIndexes ()
	Removes any per-triangle triplets of normal indexes.

void	invertPerTriangleNormals ()
	Invert per-triangle normals.

bool	hasMaterials () const override
	Returns whether the mesh has materials/textures. More...

const ccMaterialSet *	getMaterialSet () const override
	Returns associated material set. More...

int	getTriangleMtlIndex (unsigned triangleIndex) const override
	Returns a given triangle material indexes. More...

bool	convertMaterialsToVertexColors ()
	Converts materials to vertex colors. More...

bool	hasPerTriangleMtlIndexes () const
	Returns whether this mesh as per-triangle material index.

bool	reservePerTriangleMtlIndexes ()
	Reserves memory to store per-triangle material index. More...

void	removePerTriangleMtlIndexes ()
	Removes any per-triangle material indexes.

void	addTriangleMtlIndex (int mtlIndex)
	Adds triangle material index for next triangle. More...

void	setTriangleMtlIndexesTable (triangleMaterialIndexesSet *matIndexesTable, bool autoReleaseOldTable=true)
	Sets per-triangle material indexes array.

const triangleMaterialIndexesSet *	getTriangleMtlIndexesTable () const
	Returns the per-triangle material indexes array.

void	setTriangleMtlIndex (unsigned triangleIndex, int mtlIndex)
	Sets triangle material indexes. More...

void	setMaterialSet (ccMaterialSet *materialSet, bool autoReleaseOldMaterialSet=true)
	Sets associated material set (may be shared)

bool	hasTextures () const override
	Returns whether textures are available for this mesh. More...

TextureCoordsContainer *	getTexCoordinatesTable () const override
	Returns per-triangle texture coordinates array. More...

void	getTriangleTexCoordinates (unsigned triIndex, TexCoords2D &tx1, TexCoords2D &tx2, TexCoords2D *&tx3) const override
	Returns per-triangle texture coordinates (pointer to) More...

bool	hasPerTriangleTexCoordIndexes () const override
	Returns whether this mesh as per-triangle triplets of tex coords indexes. More...

void	getTriangleTexCoordinatesIndexes (unsigned triangleIndex, int &i1, int &i2, int &i3) const override
	Returns the triplet of tex coords indexes for a given triangle. More...

void	setTexCoordinatesTable (TextureCoordsContainer *texCoordsTable, bool autoReleaseOldTable=true)
	Sets per-triangle texture coordinates array (may be shared)

bool	reservePerTriangleTexCoordIndexes ()
	Reserves memory to store per-triangle triplets of tex coords indexes. More...

void	removePerTriangleTexCoordIndexes ()
	Remove per-triangle tex coords indexes.

void	addTriangleTexCoordIndexes (int i1, int i2, int i3)
	Adds a triplet of tex coords indexes for next triangle. More...

void	setTriangleTexCoordIndexes (unsigned triangleIndex, int i1, int i2, int i3)
	Sets a triplet of tex coords indexes for a given triangle. More...

bool	computeNormals (bool perVertex)
	Computes normals. More...

bool	computePerVertexNormals ()
	Computes per-vertex normals. More...

bool	computePerTriangleNormals ()
	Computes per-triangle normals.

bool	laplacianSmooth (unsigned nbIteration=100, PointCoordinateType factor=static_cast< PointCoordinateType >(0.01), ccProgressDialog *progressCb=nullptr)
	Laplacian smoothing. More...

bool	processScalarField (MESH_SCALAR_FIELD_PROCESS process)
	Applies process to the mesh scalar field (the one associated to its vertices in fact) More...

ccMesh *	subdivide (PointCoordinateType maxArea) const
	Subdivides mesh (so as to ensure that all triangles are falls below 'maxArea') More...

ccMesh *	createNewMeshFromSelection (bool removeSelectedFaces)
	Creates a new mesh with the selected vertices only. More...

void	swapTriangles (unsigned index1, unsigned index2)
	Swaps two triangles. More...

void	transformTriNormals (const ccGLMatrix &trans)
	Transforms the mesh per-triangle normals.

bool	mergeDuplicatedVertices (unsigned char octreeLevel=DefaultMergeDuplicateVerticesLevel, QWidget *parentWidget=nullptr)
	Merges duplicated vertices.

Public Member Functions inherited from ccGenericMesh
	ccGenericMesh (QString name=QString(), unsigned uniqueID=ccUniqueIDGenerator::InvalidUniqueID)
	Default constructor. More...

	~ccGenericMesh () override=default
	Destructor.

void	showNormals (bool state) override
	Sets normals visibility. More...

bool	isSerializable () const override
	Returns whether object is serializable of not. More...

virtual ccGenericPointCloud *	getAssociatedCloud () const =0
	Returns the vertices cloud. More...

virtual void	refreshBB ()=0
	Forces bounding-box update. More...

virtual unsigned	capacity () const =0
	Returns max capacity. More...

virtual bool	hasMaterials () const =0
	Returns whether the mesh has materials/textures. More...

virtual const ccMaterialSet *	getMaterialSet () const =0
	Returns associated material set. More...

virtual int	getTriangleMtlIndex (unsigned triangleIndex) const =0
	Returns a given triangle material indexes. More...

virtual bool	hasTextures () const =0
	Returns whether textures are available for this mesh. More...

virtual TextureCoordsContainer *	getTexCoordinatesTable () const =0
	Returns per-triangle texture coordinates array. More...

virtual void	getTriangleTexCoordinates (unsigned triIndex, TexCoords2D &tx1, TexCoords2D &tx2, TexCoords2D *&tx3) const =0
	Returns per-triangle texture coordinates (pointer to) More...

virtual bool	hasPerTriangleTexCoordIndexes () const =0
	Returns whether this mesh as per-triangle triplets of tex coords indexes. More...

virtual void	getTriangleTexCoordinatesIndexes (unsigned triangleIndex, int &i1, int &i2, int &i3) const =0
	Returns the triplet of tex coords indexes for a given triangle. More...

virtual bool	hasTriNormals () const =0
	Returns whether the mesh has per-triangle normals. More...

virtual void	getTriangleNormalIndexes (unsigned triangleIndex, int &i1, int &i2, int &i3) const =0
	Returns a triplet of normal indexes for a given triangle (if any) More...

virtual bool	getTriangleNormals (unsigned triangleIndex, CCVector3 &Na, CCVector3 &Nb, CCVector3 &Nc) const =0
	Returns a given triangle normal. More...

virtual NormsIndexesTableType *	getTriNormsTable () const =0
	Returns per-triangle normals shared array. More...

virtual void	computeInterpolationWeights (unsigned triIndex, const CCVector3 &P, CCVector3d &weights) const
	Returns the (barycentric) interpolation weights for a given triangle. More...

virtual bool	interpolateNormalsBC (unsigned triIndex, const CCVector3d &w, CCVector3 &N)=0
	Interpolates normal(s) inside a given triangle. More...

virtual bool	interpolateColors (unsigned triIndex, const CCVector3 &P, ccColor::Rgb &color)=0
	Interpolates RGB colors inside a given triangle. More...

virtual bool	interpolateColorsBC (unsigned triIndex, const CCVector3d &w, ccColor::Rgb &color)=0
	Interpolates RGB colors inside a given triangle. More...

virtual bool	interpolateColors (unsigned triIndex, const CCVector3 &P, ccColor::Rgba &color)=0
	Interpolates RGBA colors inside a given triangle. More...

virtual bool	interpolateColorsBC (unsigned triIndex, const CCVector3d &w, ccColor::Rgba &color)=0
	Interpolates RGBA colors inside a given triangle. More...

virtual bool	getColorFromMaterial (unsigned triIndex, const CCVector3 &P, ccColor::Rgba &color, bool interpolateColorIfNoTexture)=0
	Returns RGB color fom a given triangle material/texture. More...

virtual bool	getVertexColorFromMaterial (unsigned triIndex, unsigned char vertIndex, ccColor::Rgba &color, bool returnColorIfNoTexture)=0
	Returns RGB color of a vertex fom a given triangle material/texture. More...

virtual bool	isShownAsWire () const
	Returns whether the mesh is displayed as wired or with plain facets.

virtual void	showWired (bool state)
	Sets whether mesh should be displayed as a wire or with plain facets.

virtual bool	triNormsShown () const
	Returns whether per-triangle normals are shown or not.

virtual void	showTriNorms (bool state)
	Sets whether to show or not per-triangle normals.

virtual bool	materialsShown () const
	Sets whether textures/material should be displayed or not.

virtual void	showMaterials (bool state)
	Sets whether textures should be displayed or not.

virtual bool	stipplingEnabled () const
	Returns whether polygon stippling is enabled or not.

void	enableStippling (bool state)
	Enables polygon stippling.

ccPointCloud *	samplePoints (bool densityBased, double samplingParameter, bool withNormals, bool withRGB, bool withTexture, CCCoreLib::GenericProgressCallback *pDlg=nullptr)
	Samples points on a mesh.

void	importParametersFrom (const ccGenericMesh *mesh)
	Imports the parameters from another mesh. More...

virtual bool	trianglePicking (const CCVector2d &clickPos, const ccGLCameraParameters &camera, int &nearestTriIndex, double &nearestSquareDist, CCVector3d &nearestPoint, CCVector3d *barycentricCoords=nullptr) const
	Brute force triangle picking. More...

virtual bool	trianglePicking (unsigned triIndex, const CCVector2d &clickPos, const ccGLCameraParameters &camera, CCVector3d &point, CCVector3d *barycentricCoords=nullptr) const
	Triangle picking (single triangle)

bool	computePointPosition (unsigned triIndex, const CCVector2d &uv, CCVector3 &P, bool warningIfOutside=true) const
	Computes the point that corresponds to the given uv (barycentric) coordinates.

void	setGlobalShift (const CCVector3d &shift) override
	Sets shift applied to original coordinates (information storage only) More...

void	setGlobalScale (double scale) override
	Sets the scale applied to original coordinates (information storage only) More...

const CCVector3d &	getGlobalShift () const override
	Returns the shift applied to original coordinates. More...

double	getGlobalScale () const override
	Returns the scale applied to original coordinates. More...

bool	normalsAvailable () const override

Public Member Functions inherited from ccShiftedObject
	ccShiftedObject (QString name=QString(), unsigned uniqueID=ccUniqueIDGenerator::InvalidUniqueID)
	Default constructor. More...

	ccShiftedObject (const ccShiftedObject &s)=default
	Copy constructor. More...

void	copyGlobalShiftAndScale (const ccShiftedObject &s)
	Copies the Global Shift and Scale from another entity. More...

virtual void	setGlobalShift (double x, double y, double z)
	Sets shift applied to original coordinates (information storage only) More...

virtual void	setGlobalShift (const CCVector3d &shift)
	Sets shift applied to original coordinates (information storage only) More...

virtual const CCVector3d &	getGlobalShift () const
	Returns the shift applied to original coordinates. More...

virtual void	setGlobalScale (double scale)
	Sets the scale applied to original coordinates (information storage only) More...

virtual double	getGlobalScale () const
	Returns the scale applied to original coordinates. More...

bool	isShifted () const
	Returns whether the cloud is shifted or not.

template<typename T >
CCVector3d	toGlobal3d (const Vector3Tpl< T > &Plocal) const
	Returns the point back-projected into the original coordinates system.

template<typename T >
CCVector3d	toLocal3d (const Vector3Tpl< T > &Pglobal) const
	Returns the point projected into the local (shifted) coordinates system.

template<typename T >
CCVector3	toLocal3pc (const Vector3Tpl< T > &Pglobal) const
	Returns the point projected into the local (shifted) coordinates system.

bool	getOwnGlobalBB (CCVector3d &minCorner, CCVector3d &maxCorner) override
	Returns the entity's own global bounding-box (with global/non-shifted coordinates - if relevant) More...

GlobalBoundingBox	getOwnGlobalBB (bool withGLFeatures=false) override
	Returns the entity's own global bounding-box (with global/non-shifted coordinates - if relevant) More...

Public Member Functions inherited from ccHObject
	ccHObject (const QString &name=QString(), unsigned uniqueID=ccUniqueIDGenerator::InvalidUniqueID)
	Default constructor. More...

	ccHObject (const ccHObject &object)
	Copy constructor.

	~ccHObject () override
	Default destructor.

CC_CLASS_ENUM	getClassID () const override
	Returns class ID. More...

bool	isGroup () const
	Returns whether the instance is a group.

ccHObject *	getParent () const
	Returns parent object. More...

virtual QIcon	getIcon () const
	Returns the icon associated to this entity. More...

void	addDependency (ccHObject *otherObject, int flags, bool additive=true)
	Adds a new dependence (additive or not) More...

int	getDependencyFlagsWith (const ccHObject *otherObject) const
	Returns the dependency flags with a given object. More...

void	removeDependencyWith (ccHObject *otherObject)
	Removes any dependency flags with a given object. More...

void	removeDependencyFlag (ccHObject *otherObject, DEPENDENCY_FLAGS flag)
	Removes a given dependency flag. More...

virtual bool	addChild (ccHObject *child, int dependencyFlags=DP_PARENT_OF_OTHER, int insertIndex=-1)
	Adds a child. More...

unsigned	getChildrenNumber () const
	Returns the number of children. More...

unsigned int	getChildCountRecursive () const
	Returns the total number of children under this object recursively. More...

ccHObject *	getChild (unsigned childPos) const
	Returns the ith child. More...

ccHObject *	find (unsigned uniqueID) const
	Finds an entity in this object hierarchy. More...

unsigned	filterChildren (Container &filteredChildren, bool recursive=false, CC_CLASS_ENUM filter=CC_TYPES::OBJECT, bool strict=false, ccGenericGLDisplay *inDisplay=nullptr) const
	Collects the children corresponding to a certain pattern. More...

void	detachChild (ccHObject *child)
	Detaches a specific child. More...

void	detachAllChildren ()
	Removes a specific child. More...

void	removeChild (ccHObject *child)

void	removeChild (int pos)
	Removes a specific child given its index. More...

void	removeAllChildren ()
	Removes all children.

int	getChildIndex (const ccHObject *aChild) const
	Returns child index.

void	swapChildren (unsigned firstChildIndex, unsigned secondChildIndex)
	Swaps two children.

int	getIndex () const
	Returns index relatively to its parent or -1 if no parent.

void	transferChild (ccHObject *child, ccHObject &newParent)
	Transfer a given child to another parent.

void	transferChildren (ccHObject &newParent, bool forceFatherDependent=false)
	Transfer all children to another parent.

ccHObject *	getFirstChild () const
	Shortcut: returns first child.

ccHObject *	getLastChild () const
	Shortcut: returns last child.

bool	isAncestorOf (const ccHObject *anObject) const
	Returns true if the current object is an ancestor of the specified one.

virtual ccBBox	getOwnBB (bool withGLFeatures=false)
	Returns the entity's own bounding-box (with local/shifted coordinates) More...

virtual ccBBox	getBB_recursive (bool withGLFeatures=false, bool onlyEnabledChildren=true)
	Returns the local bounding-box of this entity and it's children. More...

virtual GlobalBoundingBox	getOwnGlobalBB (bool withGLFeatures=false)
	Returns the entity's own global bounding-box (with global/non-shifted coordinates - if relevant) More...

virtual bool	getOwnGlobalBB (CCVector3d &minCorner, CCVector3d &maxCorner)
	Returns the entity's own global bounding-box (with global/non-shifted coordinates - if relevant) More...

virtual GlobalBoundingBox	getGlobalBB_recursive (bool withGLFeatures=false, bool onlyEnabledChildren=true)
	Returns the global bounding-box of this entity and it's children. More...

virtual ccBBox	getDisplayBB_recursive (bool relative, const ccGenericGLDisplay *display=nullptr)
	Returns the bounding-box of this entity and it's children WHEN DISPLAYED. More...

virtual ccBBox	getOwnFitBB (ccGLMatrix &trans)
	Returns best-fit bounding-box (if available) More...

virtual void	drawBB (CC_DRAW_CONTEXT &context, const ccColor::Rgb &col)
	Draws the entity (and its children) bounding-box. More...

void	draw (CC_DRAW_CONTEXT &context) override
	Draws entity and its children. More...

bool	getAbsoluteGLTransformation (ccGLMatrix &trans) const
	Returns the absolute transformation (i.e. the actual displayed GL transformation) of an entity. More...

virtual bool	isDisplayed () const
	Returns whether the object is actually displayed (visible) or not.

virtual bool	isDisplayedIn (const ccGenericGLDisplay *display) const
	Returns whether the object is actually displayed (visible) in a given display or not.

virtual bool	isBranchEnabled () const
	Returns whether the object and all its ancestors are enabled.

	ccHObject_recursive_call1 (setSelected, bool, setSelected_recursive) ccHObject_recursive_call1(setDisplay

ccGenericGLDisplay setDisplay_recursive	ccHObject_recursive_call1 (removeFromDisplay, ccGenericGLDisplay *, removeFromDisplay_recursive) ccHObject_recursive_call0(prepareDisplayForRefresh

ccGenericGLDisplay setDisplay_recursive prepareDisplayForRefresh_recursive	ccHObject_recursive_call1 (refreshDisplay, bool, refreshDisplay_recursive) ccHObject_recursive_call0(resetGLTransformationHistory

ccGenericGLDisplay setDisplay_recursive prepareDisplayForRefresh_recursive resetGLTransformationHistory_recursive	ccHObject_recursive_call0 (toggleActivation, toggleActivation_recursive) ccHObject_recursive_call0(toggleVisibility

ccGenericGLDisplay setDisplay_recursive prepareDisplayForRefresh_recursive resetGLTransformationHistory_recursive toggleVisibility_recursive	ccHObject_recursive_call0 (toggleColors, toggleColors_recursive) ccHObject_recursive_call0(toggleNormals

ccGenericGLDisplay setDisplay_recursive prepareDisplayForRefresh_recursive resetGLTransformationHistory_recursive toggleVisibility_recursive toggleNormals_recursive	ccHObject_recursive_call0 (toggleSF, toggleSF_recursive) ccHObject_recursive_call0(toggleShowName

ccGenericGLDisplay setDisplay_recursive prepareDisplayForRefresh_recursive resetGLTransformationHistory_recursive toggleVisibility_recursive toggleNormals_recursive toggleShowName_recursive	ccHObject_recursive_call0 (toggleMaterials, toggleMaterials_recursive) inline virtual void transferDisplay(ccGenericGLDisplay *oldDisplay
	Transfers the entity from one display to the other.

void	applyGLTransformation_recursive (const ccGLMatrix *trans=nullptr)
	Applies the active OpenGL transformation to the entity (recursive) More...

virtual void	notifyGeometryUpdate ()
	Notifies all dependent entities that the geometry of this entity has changed.

bool	isSerializable () const override
	Returns whether object is serializable of not. More...

bool	toFile (QFile &out) const override
	Saves data to binary stream. More...

bool	fromFile (QFile &in, short dataVersion, int flags, LoadedIDMap &oldToNewIDMap) override
	Loads data from binary stream. More...

bool	fromFileNoChildren (QFile &in, short dataVersion, int flags, LoadedIDMap &oldToNewIDMap)
	Custom version of ccSerializableObject::fromFile. More...

virtual bool	isShareable () const
	Returns whether object is shareable or not. More...

virtual void	setSelectionBehavior (SelectionBehavior mode)
	Sets selection behavior (when displayed) More...

virtual SelectionBehavior	getSelectionBehavior () const
	Returns selection behavior.

virtual unsigned	getUniqueIDForDisplay () const
	Returns object unique ID used for display. More...

virtual const ccGLMatrix &	getGLTransformationHistory () const
	Returns the transformation 'history' matrix. More...

virtual void	setGLTransformationHistory (const ccGLMatrix &mat)
	Sets the transformation 'history' matrix (handle with care!)

virtual void	resetGLTransformationHistory ()
	Resets the transformation 'history' matrix.

bool	pushDisplayState () override
	Pushes the current display state (overridden) More...

void	popDisplayState (bool apply=true) override
	Pops the last pushed display state (overridden) More...

Public Member Functions inherited from ccObject
	ccObject (const QString &name=QString(), unsigned uniqueID=ccUniqueIDGenerator::InvalidUniqueID)
	Default constructor. More...

	ccObject (const ccObject &object)
	Copy constructor.

virtual CC_CLASS_ENUM	getClassID () const =0
	Returns class ID. More...

virtual QString	getName () const
	Returns object name. More...

virtual void	setName (const QString &name)
	Sets object name.

virtual unsigned	getUniqueID () const
	Returns object unique ID.

virtual void	setUniqueID (unsigned ID)
	Changes unique ID. More...

virtual bool	isEnabled () const
	Returns whether the object is enabled or not. More...

virtual void	setEnabled (bool state)
	Sets the "enabled" property. More...

virtual void	toggleActivation ()
	Toggles the "enabled" property.

virtual bool	isLocked () const
	Returns whether the object is locked or not. More...

virtual void	setLocked (bool state)
	Sets the "enabled" property. More...

bool	isLeaf () const

bool	isCustom () const

bool	isHierarchy () const

bool	isKindOf (CC_CLASS_ENUM type) const

bool	isA (CC_CLASS_ENUM type) const

QVariant	getMetaData (const QString &key) const
	Returns a given associated meta data. More...

bool	removeMetaData (const QString &key)
	Removes a given associated meta-data. More...

void	setMetaData (const QString &key, const QVariant &data)
	Sets a meta-data element. More...

void	setMetaData (const QVariantMap &dataset, bool overwrite=false)
	Sets several meta-data elements at a time. More...

bool	hasMetaData (const QString &key) const
	Returns whether a meta-data element with the given key exists or not. More...

const QVariantMap &	metaData () const
	Returns meta-data map (const only)

Public Member Functions inherited from ccSerializableObject
virtual	~ccSerializableObject ()=default
	Destructor.

virtual bool	isSerializable () const
	Returns whether object is serializable of not. More...

virtual bool	toFile (QFile &out) const
	Saves data to binary stream. More...

virtual bool	fromFile (QFile &in, short dataVersion, int flags, LoadedIDMap &oldToNewIDMap)
	Loads data from binary stream. More...

Public Member Functions inherited from ccDrawableObject
	ccDrawableObject ()
	Default constructor.

	ccDrawableObject (const ccDrawableObject &object)
	Copy constructor.

virtual void	draw (CC_DRAW_CONTEXT &context)=0
	Draws entity and its children. More...

virtual bool	isVisible () const
	Returns whether entity is visible or not.

virtual void	setVisible (bool state)
	Sets entity visibility.

virtual void	toggleVisibility ()
	Toggles visibility.

virtual bool	isVisibilityLocked () const
	Returns whether visibility is locked or not.

virtual void	lockVisibility (bool state)
	Locks/unlocks visibility. More...

virtual bool	isSelected () const
	Returns whether entity is selected or not.

virtual void	setSelected (bool state)
	Selects/unselects entity.

virtual void	getDrawingParameters (glDrawParams &params) const
	Returns main OpenGL parameters for this entity. More...

virtual bool	hasColors () const
	Returns whether colors are enabled or not. More...

virtual bool	colorsShown () const
	Returns whether colors are shown or not.

virtual void	showColors (bool state)
	Sets colors visibility.

virtual void	toggleColors ()
	Toggles colors display state.

virtual bool	hasNormals () const
	Returns whether normals are enabled or not. More...

virtual bool	normalsShown () const
	Returns whether normals are shown or not. More...

virtual void	showNormals (bool state)
	Sets normals visibility. More...

virtual void	toggleNormals ()
	Toggles normals display state.

virtual bool	hasDisplayedScalarField () const
	Returns whether an active scalar field is available or not. More...

virtual bool	hasScalarFields () const
	Returns whether one or more scalar fields are instantiated. More...

virtual void	showSF (bool state)
	Sets active scalarfield visibility.

virtual void	toggleSF ()
	Toggles SF display state.

virtual bool	sfShown () const
	Returns whether active scalar field is visible.

virtual void	toggleMaterials ()
	Toggles material display state. More...

virtual void	showNameIn3D (bool state)
	Sets whether name should be displayed in 3D or not.

virtual bool	nameShownIn3D () const
	Returns whether name is displayed in 3D or not.

virtual void	toggleShowName ()
	Toggles name in 3D display state.

virtual bool	isColorOverridden () const
	Returns whether colors are currently overridden by a temporary (unique) color. More...

virtual const ccColor::Rgba &	getTempColor () const
	Returns current temporary (unique) color.

virtual void	setTempColor (const ccColor::Rgba &col, bool autoActivate=true)
	Sets current temporary (unique) More...

virtual void	setTempColor (const ccColor::Rgb &col, bool autoActivate=true)
	Sets current temporary (unique) More...

virtual void	enableTempColor (bool state)
	Set temporary color activation state.

virtual void	removeFromDisplay (const ccGenericGLDisplay *win)
	Unlinks entity from a GL display (only if it belongs to it of course)

virtual void	setDisplay (ccGenericGLDisplay *win)
	Sets associated GL display.

virtual ccGenericGLDisplay *	getDisplay () const
	Returns associated GL display.

virtual void	redrawDisplay ()
	Redraws associated GL display.

virtual void	prepareDisplayForRefresh ()
	Sets associated GL display 'refreshable' before global refresh. More...

virtual void	refreshDisplay (bool only2D=false)
	Refreshes associated GL display. More...

virtual void	setGLTransformation (const ccGLMatrix &trans)
	Associates entity with a GL transformation (rotation + translation) More...

virtual void	enableGLTransformation (bool state)
	Enables/disables associated GL transformation. More...

virtual bool	isGLTransEnabled () const
	Returns whether a GL transformation is enabled or not.

virtual const ccGLMatrix &	getGLTransformation () const
	Returns associated GL transformation. More...

virtual void	resetGLTransformation ()
	Resets associated GL transformation. More...

virtual void	rotateGL (const ccGLMatrix &rotMat)
	Multiplies (left) current GL transformation by a rotation matrix. More...

virtual void	translateGL (const CCVector3 &trans)
	Translates current GL transformation by a rotation matrix. More...

virtual void	removeAllClipPlanes ()
	Removes all clipping planes (if any)

virtual bool	addClipPlanes (const ccClipPlane &plane)
	Registers a new clipping plane. More...

virtual void	toggleClipPlanes (CC_DRAW_CONTEXT &context, bool enable)
	Enables or disables clipping planes (OpenGL) More...

virtual bool	pushDisplayState ()
	Pushes the current display state. More...

virtual void	popDisplayState (bool apply=true)
	Pops the last pushed display state. More...

virtual void	applyDisplayState (const DisplayState &state)
	Applies a display state.

Static Public Member Functions
static ccMesh *	Triangulate (ccGenericPointCloud *cloud, CCCoreLib::TRIANGULATION_TYPES type, bool updateNormals=false, PointCoordinateType maxEdgeLength=0, unsigned char dim=2)
	Creates a Delaunay 2.5D mesh from a point cloud. More...

static ccMesh *	TriangulateTwoPolylines (ccPolyline p1, ccPolyline p2, CCVector3 *projectionDir=nullptr)
	Creates a Delaunay 2.5D mesh from two polylines.

Static Public Member Functions inherited from ccGenericMesh
static bool	IsCloudVerticesOfMesh (ccGenericPointCloud cloud, ccGenericMesh *mesh=nullptr)
	Helper to determine if the input cloud acts as vertices of a mesh.

Static Public Member Functions inherited from ccHObject
static ccHObject *	New (CC_CLASS_ENUM objectType, const char *name=nullptr)
	Static factory. More...

static ccHObject *	New (const QString &pluginId, const QString &classId, const char *name=nullptr)
	Static factory (version to be used by external plugin factories) More...

Static Public Member Functions inherited from ccObject
static unsigned	GetCurrentDBVersion ()
	Returns current database version.

static void	SetUniqueIDGenerator (ccUniqueIDGenerator::Shared generator)
	Sets the unique ID generator.

static ccUniqueIDGenerator::Shared	GetUniqueIDGenerator ()
	Returns the unique ID generator.

static unsigned	GetNextUniqueID ()
	Returns a new unassigned unique ID. More...

static unsigned	GetLastUniqueID ()
	Returns last assigned unique ID. More...

static CC_CLASS_ENUM	ReadClassIDFromFile (QFile &in, short dataVersion)
	Helper: reads out class ID from a binary stream. More...

Static Public Member Functions inherited from ccSerializableObject
static bool	WriteError ()
	Sends a custom error message (write error) and returns 'false'. More...

static bool	ReadError ()
	Sends a custom error message (read error) and returns 'false'. More...

static bool	MemoryError ()
	Sends a custom error message (not enough memory) and returns 'false'. More...

static bool	CorruptError ()
	Sends a custom error message (corrupted file) and returns 'false'. More...

Static Public Attributes
static const unsigned char	DefaultMergeDuplicateVerticesLevel = 10
	Default octree level for the 'mergeDuplicatedVertices' algorithm.

Protected Types
using	triangleIndexesContainer = ccArray< CCCoreLib::VerticesIndexes, 3, unsigned >
	Container of per-triangle vertices indexes (3)

using	triangleTexCoordIndexesSet = ccArray< Tuple3i, 3, int >
	Set of triplets of indexes referring to mesh texture coordinates.

using	triangleNormalsIndexesSet = ccArray< Tuple3i, 3, int >
	Set of triplets of indexes referring to mesh normals.

Protected Member Functions
void	drawMeOnly (CC_DRAW_CONTEXT &context) override
	Draws the entity only (not its children) More...

bool	toFile_MeOnly (QFile &out) const override
	Save own object data. More...

bool	fromFile_MeOnly (QFile &in, short dataVersion, int flags, LoadedIDMap &oldToNewIDMap) override
	Loads own object data. More...

void	applyGLTransformation (const ccGLMatrix &trans) override
	Applies a GL transformation to the entity. More...

void	onUpdateOf (ccHObject *obj) override
	This method is called when another object (geometry) is updated. More...

void	onDeletionOf (const ccHObject *obj) override
	This method is called when another object is deleted. More...

void	computeInterpolationWeights (const CCCoreLib::VerticesIndexes &vertIndexes, const CCVector3 &P, CCVector3d &weights) const
	Same as other 'computeInterpolationWeights' method with a set of 3 vertices indexes.

bool	interpolateNormals (const CCCoreLib::VerticesIndexes &vertIndexes, const CCVector3d &w, CCVector3 &N, const Tuple3i *triNormIndexes=nullptr)
	Same as other 'interpolateNormals' method with a set of 3 vertices indexes.

bool	interpolateColors (const CCCoreLib::VerticesIndexes &vertIndexes, const CCVector3d &w, ccColor::Rgb &C)
	Same as other 'interpolateColors' method with a set of 3 vertices indexes.

bool	interpolateColors (const CCCoreLib::VerticesIndexes &vertIndexes, const CCVector3d &w, ccColor::Rgba &C)
	Same as other 'interpolateColors' method with a set of 3 vertices indexes.

bool	pushSubdivide (unsigned indexA, unsigned indexB, unsigned indexC)
	Used internally by 'subdivide'.

Protected Member Functions inherited from ccGenericMesh
bool	toFile_MeOnly (QFile &out) const override
	Save own object data. More...

bool	fromFile_MeOnly (QFile &in, short dataVersion, int flags, LoadedIDMap &oldToNewIDMap) override
	Loads own object data. More...

virtual bool	trianglePicking (unsigned triIndex, const CCVector2d &clickPos, const ccGLMatrix &trans, bool noGLTrans, const ccGenericPointCloud &vertices, const ccGLCameraParameters &camera, CCVector3d &point, CCVector3d barycentricCoords=nullptr, QPainter painter=nullptr) const
	Triangle picking (single triangle)

void	drawMeOnly (CC_DRAW_CONTEXT &context) override
	Draws the entity only (not its children) More...

void	handleColorRamp (CC_DRAW_CONTEXT &context)
	Handles the color ramp display.

Protected Member Functions inherited from ccShiftedObject
bool	saveShiftInfoToFile (QFile &out) const
	Serialization helper (output)

bool	loadShiftInfoFromFile (QFile &in)
	Serialization helper (input)

Protected Member Functions inherited from ccHObject
virtual void	setParent (ccHObject *anObject)
	Sets parent object.

virtual void	drawMeOnly (CC_DRAW_CONTEXT &context)
	Draws the entity only (not its children) More...

virtual void	applyGLTransformation (const ccGLMatrix &trans)
	Applies a GL transformation to the entity. More...

virtual bool	toFile_MeOnly (QFile &out) const
	Save own object data. More...

virtual bool	fromFile_MeOnly (QFile &in, short dataVersion, int flags, LoadedIDMap &oldToNewIDMap)
	Loads own object data. More...

virtual void	drawNameIn3D (CC_DRAW_CONTEXT &context)
	Draws the entity name in 3D. More...

virtual void	onDeletionOf (const ccHObject *obj)
	This method is called when another object is deleted. More...

virtual void	onUpdateOf (ccHObject *obj)
	This method is called when another object (geometry) is updated. More...

Protected Member Functions inherited from ccObject
virtual bool	getFlagState (CC_OBJECT_FLAG flag) const
	Returns flag state.

virtual void	setFlagState (CC_OBJECT_FLAG flag, bool state)
	Sets flag state. More...

bool	toFile (QFile &out) const override
	Saves data to binary stream. More...

bool	fromFile (QFile &in, short dataVersion, int flags, LoadedIDMap &oldToNewIDMap) override
	Reimplemented from ccSerializableObject::fromFile. More...

Protected Attributes
ccMesh_extended_call1(showNormals, bool, showNormals_extended) protected NormsIndexesTableType *	m_triNormals
	Per-triangle normals.

TextureCoordsContainer *	m_texCoords
	Texture coordinates.

ccMaterialSet *	m_materials
	Materials.

triangleIndexesContainer *	m_triVertIndexes
	Triangles' vertices indexes (3 per triangle)

unsigned	m_globalIterator
	Iterator on the list of triangles.

CCCoreLib::SimpleRefTriangle	m_currentTriangle
	Dump triangle structure to transmit temporary data.

ccBBox	m_bBox
	Bounding-box.

triangleMaterialIndexesSet *	m_triMtlIndexes
	Per-triangle material indexes.

triangleTexCoordIndexesSet *	m_texCoordIndexes
	Mesh tex coords indexes (per-triangle)

triangleNormalsIndexesSet *	m_triNormalIndexes
	Mesh normals indexes (per-triangle)

Protected Attributes inherited from ccGenericMesh
bool	m_triNormsShown
	Per-triangle normals display flag.

bool	m_materialsShown
	Texture/material display flag.

bool	m_showWired
	Wireframe display mode.

bool	m_stippling
	Polygon stippling state.

Protected Attributes inherited from ccShiftedObject
CCVector3d	m_globalShift
	Global shift (typically applied at loading time)

double	m_globalScale
	Global scale (typically applied at loading time)

Protected Attributes inherited from ccHObject
ccHObject *	m_parent
	Parent.

Container	m_children
	Children.

SelectionBehavior	m_selectionBehavior
	Selection behavior.

std::map< ccHObject *, int >	m_dependencies
	Dependencies map. More...

ccGLMatrix	m_glTransHistory
	Cumulative GL transformation. More...

bool	m_isDeleting
	Flag to safely handle dependencies when the object is being deleted.

Protected Attributes inherited from ccObject
QString	m_name
	Object name.

unsigned	m_flags
	Object flags.

QVariantMap	m_metaData
	Associated meta-data.

Protected Attributes inherited from ccDrawableObject
bool	m_visible
	Specifies whether the object is visible or not. More...

bool	m_selected
	Specifies whether the object is selected or not.

bool	m_lockedVisibility
	Specifies whether the visibility can be changed by user or not.

bool	m_colorsDisplayed
	Specifies whether colors should be displayed.

bool	m_normalsDisplayed
	Specifies whether normals should be displayed.

bool	m_sfDisplayed
	Specifies whether scalar field should be displayed.

ccColor::Rgba	m_tempColor
	Temporary (unique) color.

bool	m_colorIsOverridden
	Temporary (unique) color activation state.

ccGLMatrix	m_glTrans
	Current GL transformation. More...

bool	m_glTransEnabled
	Current GL transformation activation state. More...

bool	m_showNameIn3D
	Whether name is displayed in 3D or not.

CCVector3d	m_nameIn3DPos
	Last 2D position of the '3D' name.

bool	m_nameIn3DPosIsValid
	Whether the last 2D position of the '3D' name is valid or not.

ccGenericGLDisplay *	m_currentDisplay
	Currently associated GL display.

ccClipPlaneSet	m_clipPlanes
	Active clipping planes (used for display only)

std::vector< DisplayState::Shared >	m_displayStateStack
	The stack of pushed display states.

Additional Inherited Members
Public Attributes inherited from ccHObject
ccGenericGLDisplay setDisplay_recursive prepareDisplayForRefresh_recursive resetGLTransformationHistory_recursive toggleVisibility_recursive toggleNormals_recursive toggleShowName_recursive ccGenericGLDisplay *	newDisplay

Static Protected Member Functions inherited from ccGenericMesh
static CCVector3 *	GetVertexBuffer ()

static CCVector3 *	GetNormalsBuffer ()

static ColorCompType *	GetColorsBuffer ()

static unsigned *	GetWireVertexIndexes ()
	Returns a pre-initialized array of vertex indexes for wired display. More...

static void	EnableGLStippleMask (const QOpenGLContext *context, bool state)
	Enables (OpenGL) stipple mask.

Detailed Description

Triangular mesh.

Member Enumeration Documentation

◆ MESH_SCALAR_FIELD_PROCESS

enum ccMesh::MESH_SCALAR_FIELD_PROCESS

Mesh scalar field processes.

Enumerator
SMOOTH_MESH_SF	Smooth
ENHANCE_MESH_SF	Enhance

Constructor & Destructor Documentation

◆ ccMesh() [1/2]

ccMesh::ccMesh	(	ccGenericPointCloud *	vertices,
		unsigned	uniqueID = `ccUniqueIDGenerator::InvalidUniqueID`
	)

explicit

Default ccMesh constructor.

Parameters

vertices	the vertices cloud
uniqueID	unique ID (handle with care)

◆ ccMesh() [2/2]

ccMesh::ccMesh	(	CCCoreLib::GenericIndexedMesh *	giMesh,
		ccGenericPointCloud *	giVertices
	)

explicit

ccMesh constructor (from a CCCoreLib::GenericIndexedMesh)

The GenericIndexedMesh should refer to a known ccGenericPointCloud.

Parameters

giMesh	the GenericIndexedMesh
giVertices	giMesh vertices

Member Function Documentation

◆ addTriangle()

void ccMesh::addTriangle	(	unsigned	i1,
		unsigned	i2,
		unsigned	i3
	)

Adds a triangle to the mesh.

Warning: Bounding-box validity is broken after a call to this method. However, for the sake of performance, no call to notifyGeometryUpdate is made automatically. Make sure to do so when all modifications are done!

Parameters

i1	first vertex index (relatively to the vertex cloud)
i2	second vertex index (relatively to the vertex cloud)
i3	third vertex index (relatively to the vertex cloud)

◆ addTriangleMtlIndex()

void ccMesh::addTriangleMtlIndex ( int mtlIndex )

Adds triangle material index for next triangle.

Cf. ccMesh::reservePerTriangleMtlIndexes.

Parameters

mtlIndex triangle material index

◆ addTriangleNormalIndexes()

void ccMesh::addTriangleNormalIndexes	(	int	i1,
		int	i2,
		int	i3
	)

Adds a triplet of normal indexes for next triangle.

Make sure per-triangle normal indexes array is allocated (see reservePerTriangleNormalIndexes)

Parameters

i1	first vertex normal index
i2	second vertex normal index
i3	third vertex normal index

◆ addTriangleTexCoordIndexes()

void ccMesh::addTriangleTexCoordIndexes	(	int	i1,
		int	i2,
		int	i3
	)

Adds a triplet of tex coords indexes for next triangle.

Make sure per-triangle tex coords indexes array is allocated (see reservePerTriangleTexCoordIndexes)

Parameters

i1	first vertex tex coords index
i2	second vertex tex coords index
i3	third vertex tex coords index

◆ applyGLTransformation()

void ccMesh::applyGLTransformation ( const ccGLMatrix & trans )

overrideprotectedvirtual

Applies a GL transformation to the entity.

this = rotMat*(this-rotCenter)+(rotCenter+trans)

Parameters

trans a ccGLMatrix structure

Reimplemented from ccHObject.

◆ arePerTriangleNormalsEnabled()

bool ccMesh::arePerTriangleNormalsEnabled ( ) const

Returns whether per triangle normals are enabled.

To enable per triangle normals, you should:

first, reserve memory for triangles (this is always the first thing to do)
associate this mesh to a triangle normals array (see ccMesh::setTriNormsTable)
reserve memory to store per-triangle normal indexes with ccMesh::reservePerTriangleNormalIndexes
add for each triangle a triplet of indexes (referring to stored normals)

◆ capacity()

unsigned ccMesh::capacity ( ) const

overridevirtual

Returns max capacity.

Implements ccGenericMesh.

◆ cloneMesh()

ccMesh * ccMesh::cloneMesh	(	ccGenericPointCloud *	vertices = `nullptr`,
		ccMaterialSet *	clonedMaterials = `nullptr`,
		NormsIndexesTableType *	clonedNormsTable = `nullptr`,
		TextureCoordsContainer *	cloneTexCoords = `nullptr`
	)

Clones this entity.

All the main features of the entity are cloned, except from the octree

Parameters

vertices	vertices set to use (will be automatically - AND OPTIMALLY - cloned if nullptr)
clonedMaterials	for internal use
clonedNormsTable	for internal use
cloneTexCoords	for internal use

Returns: a copy of this entity

◆ computeInterpolationWeights()

void ccMesh::computeInterpolationWeights	(	unsigned	triIndex,
		const CCVector3 &	P,
		CCVector3d &	weights
	)		const

overridevirtual

Returns the (barycentric) interpolation weights for a given triangle.

Reimplemented from ccGenericMesh.

◆ computeNormals()

bool ccMesh::computeNormals ( bool perVertex )

Computes normals.

Parameters

perVertex whether normals should be computed per-vertex or per-triangle

Returns: success

◆ computePerVertexNormals()

bool ccMesh::computePerVertexNormals ( )

Computes per-vertex normals.

normalsWereAllocated &&

◆ convertMaterialsToVertexColors()

bool ccMesh::convertMaterialsToVertexColors ( )

Converts materials to vertex colors.

Warning: this method will overwrite colors (if any)

◆ createNewMeshFromSelection()

ccMesh * ccMesh::createNewMeshFromSelection ( bool removeSelectedFaces )

Creates a new mesh with the selected vertices only.

This method is called after a graphical segmentation. It creates a new mesh structure with the vertices that are tagged as "visible" (see ccGenericPointCloud::visibilityArray). This method will also update this mesh if removeSelectedFaces is true. In this case, all "selected" triangles will be removed from this mesh's instance.

Parameters

removeSelectedFaces specifies if the faces composed only of 'selected' vertices should be removed or not

◆ drawMeOnly()

void ccMesh::drawMeOnly ( CC_DRAW_CONTEXT & context )

overrideprotectedvirtual

Draws the entity only (not its children)

Reimplemented from ccGenericMesh.

Reimplemented in ccPlane.

◆ flipTriangles()

void ccMesh::flipTriangles ( )

Flips the triangle.

Swaps the second and third vertices indexes

◆ fromFile_MeOnly()

bool ccMesh::fromFile_MeOnly	(	QFile &	in,
		short	dataVersion,
		int	flags,
		LoadedIDMap &	oldToNewIDMap
	)

overrideprotectedvirtual

Loads own object data.

Called by 'fromFile' (recursive scheme) To be overloaded (but still called;) by subclass.

Parameters

in	input file
dataVersion	file version
flags	deserialization flags (see ccSerializableObject::DeserializationFlags)
oldToNewIDMap	map to link old IDs with new IDs

Reimplemented from ccGenericMesh.

Reimplemented in ccPlane, ccQuadric, ccSphere, and ccTorus.

◆ getAssociatedCloud()

ccGenericPointCloud * ccMesh::getAssociatedCloud ( ) const

inlineoverridevirtual

Returns the vertices cloud.

Implements ccGenericMesh.

◆ getClassID()

CC_CLASS_ENUM ccMesh::getClassID ( ) const

inlineoverridevirtual

Returns class ID.

Reimplemented from ccHObject.

Reimplemented in ccPlane, ccQuadric, ccSphere, and ccTorus.

◆ getColorFromMaterial()

bool ccMesh::getColorFromMaterial	(	unsigned	triIndex,
		const CCVector3 &	P,
		ccColor::Rgba &	color,
		bool	interpolateColorIfNoTexture
	)

overridevirtual

Returns RGB color fom a given triangle material/texture.

Parameters

	triIndex	triangle index
	P	point where to grab color (should be inside the triangle!)
[out]	color	texel color
	interpolateColorIfNoTexture	whether to return the color interpolated from the RGB field if no texture/material is associated to the given triangles

Returns: success

Implements ccGenericMesh.

◆ getGLTransformationHistory()

const ccGLMatrix & ccMesh::getGLTransformationHistory ( ) const

overridevirtual

Returns the transformation 'history' matrix.

Reimplemented from ccHObject.

◆ getMaterialSet()

const ccMaterialSet * ccMesh::getMaterialSet ( ) const

inlineoverridevirtual

Returns associated material set.

Implements ccGenericMesh.

◆ getOwnBB()

ccBBox ccMesh::getOwnBB ( bool withGLFeatures = false )

overridevirtual

Returns the entity's own bounding-box (with local/shifted coordinates)

Children bounding-boxes are ignored.

Parameters

withGLFeatures whether to take into account display-only elements (if any)

Returns: bounding-box

Reimplemented from ccHObject.

◆ getTexCoordinatesTable()

TextureCoordsContainer * ccMesh::getTexCoordinatesTable ( ) const

inlineoverridevirtual

Returns per-triangle texture coordinates array.

Implements ccGenericMesh.

◆ getTriangleMtlIndex()

int ccMesh::getTriangleMtlIndex ( unsigned triangleIndex ) const

overridevirtual

Returns a given triangle material indexes.

Implements ccGenericMesh.

◆ getTriangleNormalIndexes()

void ccMesh::getTriangleNormalIndexes	(	unsigned	triangleIndex,
		int &	i1,
		int &	i2,
		int &	i3
	)		const

overridevirtual

Returns a triplet of normal indexes for a given triangle (if any)

Parameters

[in]	triangleIndex	triangle index
[out]	i1	first vertex normal index (or -1 if none)
[out]	i2	second vertex normal index (or -1 if none)
[out]	i3	third vertex normal index (or -1 if none)

Implements ccGenericMesh.

◆ getTriangleNormals()

bool ccMesh::getTriangleNormals	(	unsigned	triangleIndex,
		CCVector3 &	Na,
		CCVector3 &	Nb,
		CCVector3 &	Nc
	)		const

overridevirtual

Returns a given triangle normal.

Mesh must have triangle normals associated (see hasTriNormals)

Implements ccGenericMesh.

◆ getTriangleTexCoordinates()

void ccMesh::getTriangleTexCoordinates	(	unsigned	triIndex,
		TexCoords2D *&	tx1,
		TexCoords2D *&	tx2,
		TexCoords2D *&	tx3
	)		const

overridevirtual

Returns per-triangle texture coordinates (pointer to)

Implements ccGenericMesh.

◆ getTriangleTexCoordinatesIndexes()

void ccMesh::getTriangleTexCoordinatesIndexes	(	unsigned	triangleIndex,
		int &	i1,
		int &	i2,
		int &	i3
	)		const

overridevirtual

Returns the triplet of tex coords indexes for a given triangle.

Parameters

triangleIndex	triangle index
i1	first vertex tex coords index
i2	second vertex tex coords index
i3	third vertex tex coords index

Implements ccGenericMesh.

◆ getTriNormsTable()

NormsIndexesTableType * ccMesh::getTriNormsTable ( ) const

inlineoverridevirtual

Returns per-triangle normals shared array.

Implements ccGenericMesh.

◆ getUniqueIDForDisplay()

unsigned ccMesh::getUniqueIDForDisplay ( ) const

overridevirtual

Returns object unique ID used for display.

Reimplemented from ccHObject.

◆ getVertexColorFromMaterial()

bool ccMesh::getVertexColorFromMaterial	(	unsigned	triIndex,
		unsigned char	vertIndex,
		ccColor::Rgba &	color,
		bool	returnColorIfNoTexture
	)

overridevirtual

Returns RGB color of a vertex fom a given triangle material/texture.

Parameters

	triIndex	triangle index
	vertIndex	vertex index inside triangle (i.e. 0, 1 or 2!)
[out]	color	texel color
	returnColorIfNoTexture	whether to return the color from the vertex RGB field if no texture/material is associated to the given triangle

Returns: success

Implements ccGenericMesh.

◆ hasColors()

bool ccMesh::hasColors ( ) const

overridevirtual

Returns whether colors are enabled or not.

Reimplemented from ccDrawableObject.

◆ hasDisplayedScalarField()

bool ccMesh::hasDisplayedScalarField ( ) const

overridevirtual

Returns whether an active scalar field is available or not.

Reimplemented from ccDrawableObject.

◆ hasMaterials()

bool ccMesh::hasMaterials ( ) const

overridevirtual

Returns whether the mesh has materials/textures.

Implements ccGenericMesh.

◆ hasNormals()

bool ccMesh::hasNormals ( ) const

overridevirtual

Returns whether normals are enabled or not.

Reimplemented from ccDrawableObject.

◆ hasPerTriangleTexCoordIndexes()

bool ccMesh::hasPerTriangleTexCoordIndexes ( ) const

inlineoverridevirtual

Returns whether this mesh as per-triangle triplets of tex coords indexes.

Implements ccGenericMesh.

◆ hasScalarFields()

bool ccMesh::hasScalarFields ( ) const

overridevirtual

Returns whether one or more scalar fields are instantiated.

Warning: doesn't mean a scalar field is currently displayed (see ccDrawableObject::hasDisplayedScalarField).

Reimplemented from ccDrawableObject.

◆ hasTextures()

bool ccMesh::hasTextures ( ) const

overridevirtual

Returns whether textures are available for this mesh.

Implements ccGenericMesh.

◆ hasTriNormals()

bool ccMesh::hasTriNormals ( ) const

overridevirtual

Returns whether the mesh has per-triangle normals.

Implements ccGenericMesh.

◆ interpolateColors() [1/2]

bool ccMesh::interpolateColors	(	unsigned	triIndex,
		const CCVector3 &	P,
		ccColor::Rgb &	color
	)

overridevirtual

Interpolates RGB colors inside a given triangle.

Parameters

	triIndex	triangle index
	P	point where to interpolate (should be inside the triangle!)
[out]	color	interpolated color

Returns: success

Implements ccGenericMesh.

◆ interpolateColors() [2/2]

bool ccMesh::interpolateColors	(	unsigned	triIndex,
		const CCVector3 &	P,
		ccColor::Rgba &	color
	)

overridevirtual

Interpolates RGBA colors inside a given triangle.

Parameters

	triIndex	triangle index
	P	point where to interpolate (should be inside the triangle!)
[out]	color	interpolated color

Returns: success

Implements ccGenericMesh.

◆ interpolateColorsBC() [1/2]

bool ccMesh::interpolateColorsBC	(	unsigned	triIndex,
		const CCVector3d &	w,
		ccColor::Rgb &	color
	)

overridevirtual

Interpolates RGB colors inside a given triangle.

Parameters

	triIndex	triangle index
	w	barycentric coordinates
[out]	color	interpolated color

Returns: success

Implements ccGenericMesh.

◆ interpolateColorsBC() [2/2]

bool ccMesh::interpolateColorsBC	(	unsigned	triIndex,
		const CCVector3d &	w,
		ccColor::Rgba &	color
	)

overridevirtual

Interpolates RGBA colors inside a given triangle.

Parameters

	triIndex	triangle index
	w	barycentric coordinates
[out]	color	interpolated color

Returns: success

Implements ccGenericMesh.

◆ interpolateNormalsBC()

bool ccMesh::interpolateNormalsBC	(	unsigned	triIndex,
		const CCVector3d &	w,
		CCVector3 &	N
	)

overridevirtual

Interpolates normal(s) inside a given triangle.

Parameters

	triIndex	triangle index
	w	barycentric coordinates
[out]	N	interpolated normal

Returns: success

Implements ccGenericMesh.

◆ invertNormals()

void ccMesh::invertNormals ( )

Inverts normals (if any)

Either the per-triangle normals, or the per-vertex ones

◆ isSerializable()

bool ccMesh::isSerializable ( ) const

inlineoverridevirtual

Returns whether object is serializable of not.

Reimplemented from ccGenericMesh.

◆ laplacianSmooth()

bool ccMesh::laplacianSmooth	(	unsigned	nbIteration = `100`,
		PointCoordinateType	factor = `static_cast<PointCoordinateType>(0.01)`,
		ccProgressDialog *	progressCb = `nullptr`
	)

Laplacian smoothing.

Parameters

nbIteration	smoothing iterations
factor	smoothing 'force'
progressCb	progress dialog callback

◆ merge()

bool ccMesh::merge	(	const ccMesh *	mesh,
		bool	createSubMesh
	)

Merges another mesh into this one.

Parameters

mesh	mesh to be merged in this one
createSubMesh	whether to create a submesh entity corresponding to the added mesh

Returns: success

◆ normalsShown()

bool ccMesh::normalsShown ( ) const

overridevirtual

Returns whether normals are shown or not.

Reimplemented from ccDrawableObject.

◆ onDeletionOf()

void ccMesh::onDeletionOf ( const ccHObject * obj )

overrideprotectedvirtual

This method is called when another object is deleted.

For internal use.

Reimplemented from ccHObject.

◆ onUpdateOf()

void ccMesh::onUpdateOf ( ccHObject * obj )

overrideprotectedvirtual

This method is called when another object (geometry) is updated.

For internal use.

Reimplemented from ccHObject.

◆ processScalarField()

bool ccMesh::processScalarField ( MESH_SCALAR_FIELD_PROCESS process )

Applies process to the mesh scalar field (the one associated to its vertices in fact)

A very simple smoothing/enhancement algorithm based on each vertex direct neighbours. Prior to calling this method, one should check first that the vertices are associated to a scalar field. Warning: the processed scalar field must be enabled for both INPUT & OUTPUT! (see ccGenericCloud::setCurrentScalarField)

Parameters

process either 'smooth' or 'enhance'

◆ refreshBB()

void ccMesh::refreshBB ( )

overridevirtual

Forces bounding-box update.

Implements ccGenericMesh.

◆ reserve()

bool ccMesh::reserve ( size_t n )

Reserves the memory to store the vertex indexes (3 per triangle)

Parameters

n	the number of triangles to reserve

Returns: true if the method succeeds, false otherwise

◆ reservePerTriangleMtlIndexes()

bool ccMesh::reservePerTriangleMtlIndexes ( )

Reserves memory to store per-triangle material index.

Before adding per-triangle material index to the mesh (with ccMesh::addTriangleMtlIndex()) be sure to reserve the necessary amount of memory with this method. This method reserves memory for as many material descriptors as the number of triangles in the mesh (effectively stored or reserved - a call to ccMesh::reserve prior to this one is mandatory).

Returns: true if ok, false if there's not enough memory

◆ reservePerTriangleNormalIndexes()

bool ccMesh::reservePerTriangleNormalIndexes ( )

Reserves memory to store per-triangle triplets of normal indexes.

Before adding per-triangle normal indexes triplets to the mesh (with ccMesh::addTriangleNormalsIndexes()) be sure to reserve the necessary amount of memory with this method. This method reserves memory for as many normals indexes triplets as the number of triangles in the mesh (effectively stored or reserved - a call to ccMesh::reserve prior to this one is mandatory).

Returns: true if ok, false if there's not enough memory

◆ reservePerTriangleTexCoordIndexes()

bool ccMesh::reservePerTriangleTexCoordIndexes ( )

Reserves memory to store per-triangle triplets of tex coords indexes.

Before adding per-triangle tex coords indexes triplets to the mesh (with ccMesh::addTriangleTexCoordIndexes()) be sure to reserve the necessary amount of memory with this method. This method reserves memory for as many tex coords indexes triplets as the number of triangles in the mesh (effectively stored or reserved - a call to ccMesh::reserve prior to this one is mandatory).

Returns: true if ok, false if there's not enough memory

◆ resize()

bool ccMesh::resize ( size_t n )

Resizes the array of vertex indexes (3 per triangle)

If the new number of elements is smaller than the actual size, the overflooding elements will be deleted.

Parameters

n	the new number of triangles

Returns: true if the method succeeds, false otherwise

◆ setTriangleMtlIndex()

void ccMesh::setTriangleMtlIndex	(	unsigned	triangleIndex,
		int	mtlIndex
	)

Sets triangle material indexes.

Cf. ccMesh::reservePerTriangleMtlIndexes.

Parameters

triangleIndex	triangle index
mtlIndex	triangle material index

◆ setTriangleNormalIndexes()

void ccMesh::setTriangleNormalIndexes	(	unsigned	triangleIndex,
		int	i1,
		int	i2,
		int	i3
	)

Sets a triplet of normal indexes for a given triangle.

Parameters

triangleIndex	triangle index
i1	first vertex normal index
i2	second vertex normal index
i3	third vertex normal index

◆ setTriangleTexCoordIndexes()

void ccMesh::setTriangleTexCoordIndexes	(	unsigned	triangleIndex,
		int	i1,
		int	i2,
		int	i3
	)

Sets a triplet of tex coords indexes for a given triangle.

Parameters

triangleIndex	triangle index
i1	first vertex tex coords index
i2	second vertex tex coords index
i3	third vertex tex coords index

◆ shiftTriangleIndexes()

void ccMesh::shiftTriangleIndexes ( unsigned shift )

Shifts all triangles indexes.

Parameters

shift index shift (positive)

◆ subdivide()

ccMesh * ccMesh::subdivide ( PointCoordinateType maxArea ) const

Subdivides mesh (so as to ensure that all triangles are falls below 'maxArea')

Returns: subdivided mesh (if successful)

◆ swapTriangles()

void ccMesh::swapTriangles	(	unsigned	index1,
		unsigned	index2
	)

Swaps two triangles.

Automatically updates internal structures (i.e. lookup tables for material, normals, etc.).

◆ toFile_MeOnly()

bool ccMesh::toFile_MeOnly ( QFile & out ) const

overrideprotectedvirtual

Save own object data.

Called by 'toFile' (recursive scheme) To be overloaded (but still called;) by subclass.

Reimplemented from ccGenericMesh.

Reimplemented in ccPlane, ccQuadric, ccSphere, and ccTorus.

◆ toggleMaterials()

void ccMesh::toggleMaterials ( )

inlineoverridevirtual

Toggles material display state.

Reimplemented from ccDrawableObject.

◆ Triangulate()

ccMesh * ccMesh::Triangulate	(	ccGenericPointCloud *	cloud,
		CCCoreLib::TRIANGULATION_TYPES	type,
		bool	updateNormals = `false`,
		PointCoordinateType	maxEdgeLength = `0`,
		unsigned char	dim = `2`
	)

static

Creates a Delaunay 2.5D mesh from a point cloud.

See CCCoreLib::PointProjectionTools::computeTriangulation.

The documentation for this class was generated from the following files:

ccMesh.h
ccMesh.cpp

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Types

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ MESH_SCALAR_FIELD_PROCESS

Constructor & Destructor Documentation

◆ ccMesh() [1/2]

◆ ccMesh() [2/2]

Member Function Documentation

◆ addTriangle()

◆ addTriangleMtlIndex()

◆ addTriangleNormalIndexes()

◆ addTriangleTexCoordIndexes()

◆ applyGLTransformation()

◆ arePerTriangleNormalsEnabled()

◆ capacity()

◆ cloneMesh()

◆ computeInterpolationWeights()

◆ computeNormals()

◆ computePerVertexNormals()

◆ convertMaterialsToVertexColors()

◆ createNewMeshFromSelection()

◆ drawMeOnly()

◆ flipTriangles()

◆ fromFile_MeOnly()

◆ getAssociatedCloud()

◆ getClassID()

◆ getColorFromMaterial()

◆ getGLTransformationHistory()

◆ getMaterialSet()

◆ getOwnBB()

◆ getTexCoordinatesTable()

◆ getTriangleMtlIndex()

◆ getTriangleNormalIndexes()

◆ getTriangleNormals()

◆ getTriangleTexCoordinates()

◆ getTriangleTexCoordinatesIndexes()

◆ getTriNormsTable()

◆ getUniqueIDForDisplay()

◆ getVertexColorFromMaterial()

◆ hasColors()

◆ hasDisplayedScalarField()

◆ hasMaterials()

◆ hasNormals()

◆ hasPerTriangleTexCoordIndexes()

◆ hasScalarFields()

◆ hasTextures()

◆ hasTriNormals()

◆ interpolateColors() [1/2]

◆ interpolateColors() [2/2]

◆ interpolateColorsBC() [1/2]

◆ interpolateColorsBC() [2/2]

◆ interpolateNormalsBC()

◆ invertNormals()

◆ isSerializable()

◆ laplacianSmooth()

◆ merge()

◆ normalsShown()

◆ onDeletionOf()

◆ onUpdateOf()

◆ processScalarField()

◆ refreshBB()

◆ reserve()

◆ reservePerTriangleMtlIndexes()

◆ reservePerTriangleNormalIndexes()

◆ reservePerTriangleTexCoordIndexes()

◆ resize()

◆ setTriangleMtlIndex()

◆ setTriangleNormalIndexes()

◆ setTriangleTexCoordIndexes()

◆ shiftTriangleIndexes()

◆ subdivide()

◆ swapTriangles()

◆ toFile_MeOnly()