Pixyco-XYZ/openmesh
5
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge branch 'doc_update' into 'master'

Browse Source 
Updated documentation of BaseKernel's property functions to hint at PropertyManager.



See merge request !90
This commit is contained in:
Jan Möbius
2016-09-23 09:36:28 +02:00
parent 17b91da501 dafbcf1480
commit 03c35391ed
1 changed files with 51 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

62
src/OpenMesh/Core/Mesh/BaseKernel.hh
View File

@@ -79,8 +79,11 @@ namespace OpenMesh {
//== CLASS DEFINITION =========================================================
/// This class provides the basic property management like adding/removing
/// properties and access to properties.
/// This class provides low-level property management like adding/removing
/// properties and access to properties. Under most circumstances, it is
/// advisable to use the high-level property management provided by
/// PropertyManager, instead.
///
/// All operations provided by %BaseKernel need at least a property handle
/// (VPropHandleT, EPropHandleT, HPropHandleT, FPropHandleT, MPropHandleT).
/// which keeps the data type of the property, too.
@@ -115,7 +118,12 @@ public: //-------------------------------------------------- add new properties
//@{
/** Adds a property
/** You should not use this function directly. Instead, use the convenient
* PropertyManager wrapper and/or one of its helper functions such as
* makePropertyManagerFromNew, makePropertyManagerFromExisting, or
* makePropertyManagerFromExistingOrNew.
*
* Adds a property
*
* Depending on the property handle type a vertex, (half-)edge, face or
* mesh property is added to the mesh. If the action fails the handle
@@ -177,7 +185,10 @@ public: //--------------------------------------------------- remove properties
/// \name Removing a property from a mesh tiem
//@{
/** Remove a property.
/** You should not use this function directly. Instead, use the convenient
* PropertyManager wrapper to manage (and remove) properties.
*
* Remove a property.
*
* Removes the property represented by the handle from the apropriate
* mesh item.
@@ -231,7 +242,12 @@ public: //------------------------------------------------ get handle from name
/// \name Get property handle by name
//@{
/** Retrieves the handle to a named property by it's name.
/** You should not use this function directly. Instead, use the convenient
* PropertyManager wrapper (e.g. PropertyManager::propertyExists) or one of
* its higher level helper functions such as
* makePropertyManagerFromExisting, or makePropertyManagerFromExistingOrNew.
*
* Retrieves the handle to a named property by it's name.
*
* \param _ph A property handle. On success the handle is valid else
* invalid.
@@ -281,7 +297,12 @@ public: //--------------------------------------------------- access properties
/// \name Access a property
//@{
/** Access a property
/** In most cases you should use the convenient PropertyManager wrapper
* and use of this function should not be necessary. Under some
* circumstances, however (i.e. making a property persistent), it might be
* necessary to use this function.
*
* Access a property
*
* This method returns a reference to property. The property handle
* must be valid! The result is unpredictable if the handle is invalid!
@@ -342,7 +363,10 @@ public: //-------------------------------------------- access property elements
/// \name Access a property element using a handle to a mesh item
//@{
/** Return value of property for an item
/** You should not use this function directly. Instead, use the convenient
* PropertyManager wrapper.
*
* Return value of property for an item
*/
template <class T>
@@ -414,7 +438,11 @@ public: //-------------------------------------------- access property elements
public: //------------------------------------------------ copy property
/** Copies a single property from one mesh element to another (of the same type)
/** You should not use this function directly. Instead, use the convenient
* PropertyManager wrapper (e.g. PropertyManager::copy_to or
* PropertyManager::copy).
*
* Copies a single property from one mesh element to another (of the same type)
*
* @param _ph A vertex property handle
* @param _vh_from From vertex handle
@@ -426,7 +454,11 @@ public: //------------------------------------------------ copy property
vprops_.property(_ph)[_vh_to.idx()] = vprops_.property(_ph)[_vh_from.idx()];
}
/** Copies a single property from one mesh element to another (of the same type)
/** You should not use this function directly. Instead, use the convenient
* PropertyManager wrapper (e.g. PropertyManager::copy_to or
* PropertyManager::copy).
*
* Copies a single property from one mesh element to another (of the same type)
*
* @param _ph A halfedge property handle
* @param _hh_from From halfedge handle
@@ -438,7 +470,11 @@ public: //------------------------------------------------ copy property
hprops_.property(_ph)[_hh_to.idx()] = hprops_.property(_ph)[_hh_from.idx()];
}
/** Copies a single property from one mesh element to another (of the same type)
/** You should not use this function directly. Instead, use the convenient
* PropertyManager wrapper (e.g. PropertyManager::copy_to or
* PropertyManager::copy).
*
* Copies a single property from one mesh element to another (of the same type)
*
* @param _ph An edge property handle
* @param _eh_from From edge handle
@@ -450,7 +486,11 @@ public: //------------------------------------------------ copy property
eprops_.property(_ph)[_eh_to.idx()] = eprops_.property(_ph)[_eh_from.idx()];
}
/** Copies a single property from one mesh element to another (of the same type)
/** You should not use this function directly. Instead, use the convenient
* PropertyManager wrapper (e.g. PropertyManager::copy_to or
* PropertyManager::copy).
*
* Copies a single property from one mesh element to another (of the same type)
*
* @param _ph A face property handle
* @param _fh_from From face handle