Browse Source

Trade: doc++

pull/537/head
Vladimír Vondruš 5 years ago
parent
commit
145d41dcff
  1. 18
      src/Magnum/Trade/MaterialData.h
  2. 2
      src/Magnum/Trade/MaterialLayerData.h
  3. 2
      src/Magnum/Trade/MeshData.h

18
src/Magnum/Trade/MaterialData.h

@ -1227,8 +1227,8 @@ class MAGNUM_TRADE_EXPORT MaterialAttributeData {
* In case of a @ref MaterialAttributeType::String, returns a * In case of a @ref MaterialAttributeType::String, returns a
* null-terminated @cpp const char* @ce (not a pointer to * null-terminated @cpp const char* @ce (not a pointer to
* @ref Containers::StringView). This doesn't preserve the actual * @ref Containers::StringView). This doesn't preserve the actual
* string size in case the string data contain zero bytes, thus prefer * string size in case the string data contain @cpp '\0' @ce bytes,
* to use typed access in that case. * thus prefer to use typed access in that case.
*/ */
const void* value() const; const void* value() const;
@ -2214,8 +2214,8 @@ class MAGNUM_TRADE_EXPORT MaterialData {
* - In case of a @ref MaterialAttributeType::String returns a * - In case of a @ref MaterialAttributeType::String returns a
* null-terminated @cpp const char* @ce (not a pointer to * null-terminated @cpp const char* @ce (not a pointer to
* @ref Containers::StringView). This doesn't preserve the actual * @ref Containers::StringView). This doesn't preserve the actual
* string size in case the string data contain zero bytes, thus prefer * string size in case the string data contain zero bytes, thus
* to use typed access in that case. * prefer to use typed access in that case.
* *
* @see @ref hasAttribute(), @ref tryAttribute(), @ref attributeOr() * @see @ref hasAttribute(), @ref tryAttribute(), @ref attributeOr()
*/ */
@ -2235,8 +2235,8 @@ class MAGNUM_TRADE_EXPORT MaterialData {
* - In case of a @ref MaterialAttributeType::String returns a * - In case of a @ref MaterialAttributeType::String returns a
* null-terminated @cpp const char* @ce (not a pointer to * null-terminated @cpp const char* @ce (not a pointer to
* @ref Containers::StringView). This doesn't preserve the actual * @ref Containers::StringView). This doesn't preserve the actual
* string size in case the string data contain zero bytes, thus prefer * string size in case the string data contain zero bytes, thus
* to use typed access in that case. * prefer to use typed access in that case.
* *
* @see @ref hasLayer() * @see @ref hasLayer()
*/ */
@ -2538,7 +2538,7 @@ class MAGNUM_TRADE_EXPORT MaterialData {
* Releases the ownership of the layer offset array and resets internal * Releases the ownership of the layer offset array and resets internal
* layer-related state to default. The material then behaves like if it * layer-related state to default. The material then behaves like if it
* has no layers. Note that the returned array has a custom no-op * has no layers. Note that the returned array has a custom no-op
* deleter when the data are not owned by the mesh, and while the * deleter when the data are not owned by the material, and while the
* returned array type is mutable, the actual memory might be not. * returned array type is mutable, the actual memory might be not.
* *
* @attention Querying attributes after calling @ref releaseLayerData() * @attention Querying attributes after calling @ref releaseLayerData()
@ -2555,8 +2555,8 @@ class MAGNUM_TRADE_EXPORT MaterialData {
* Releases the ownership of the attribute array and resets internal * Releases the ownership of the attribute array and resets internal
* attribute-related state to default. The material then behaves like * attribute-related state to default. The material then behaves like
* if it has no attributes. Note that the returned array has a custom * if it has no attributes. Note that the returned array has a custom
* no-op deleter when the data are not owned by the mesh, and while the * no-op deleter when the data are not owned by the material, and while
* returned array type is mutable, the actual memory might be not. * the returned array type is mutable, the actual memory might be not.
* *
* @attention Querying layers after calling @ref releaseAttributeData() * @attention Querying layers after calling @ref releaseAttributeData()
* has undefined behavior and might lead to crashes. This is done * has undefined behavior and might lead to crashes. This is done

2
src/Magnum/Trade/MaterialLayerData.h

@ -40,7 +40,7 @@ namespace Magnum { namespace Trade {
@m_since_latest @m_since_latest
Convenience wrapper that re-routes all @ref MaterialData base material layer Convenience wrapper that re-routes all @ref MaterialData base material layer
and attribute accessors APIS from to a layer specified in the @p layer template and attribute accessors APIs from to a layer specified in the @p layer template
parameter. All APIs expect that given layer exists. See parameter. All APIs expect that given layer exists. See
@ref Trade-MaterialData-usage-layers for more information. @ref Trade-MaterialData-usage-layers for more information.
*/ */

2
src/Magnum/Trade/MeshData.h

@ -764,7 +764,7 @@ class MAGNUM_TRADE_EXPORT MeshData {
* creates an instance that doesn't own the passed vertex and index * creates an instance that doesn't own the passed vertex and index
* data. The @p indexDataFlags / @p vertexDataFlags parameters can * data. The @p indexDataFlags / @p vertexDataFlags parameters can
* contain @ref DataFlag::Mutable to indicate the external data can be * contain @ref DataFlag::Mutable to indicate the external data can be
* modified, and is expected to *not* have @ref DataFlag::Owned set. * modified, and are expected to *not* have @ref DataFlag::Owned set.
*/ */
explicit MeshData(MeshPrimitive primitive, DataFlags indexDataFlags, Containers::ArrayView<const void> indexData, const MeshIndexData& indices, DataFlags vertexDataFlags, Containers::ArrayView<const void> vertexData, Containers::Array<MeshAttributeData>&& attributes, UnsignedInt vertexCount = ImplicitVertexCount, const void* importerState = nullptr) noexcept; explicit MeshData(MeshPrimitive primitive, DataFlags indexDataFlags, Containers::ArrayView<const void> indexData, const MeshIndexData& indices, DataFlags vertexDataFlags, Containers::ArrayView<const void> vertexData, Containers::Array<MeshAttributeData>&& attributes, UnsignedInt vertexCount = ImplicitVertexCount, const void* importerState = nullptr) noexcept;

Loading…
Cancel
Save