ic
/
magnum
mirror of https://github.com/mosra/magnum.git
6
0
Fork 0
Code Issues Projects Releases Wiki Activity
Browse Source

Trade: doc++, minor.

pull/570/head
Vladimír Vondruš 4 years ago
parent
492b4272e3
commit
cb7dd224db
7 changed files with 62 additions and 45 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Unified View
Diff Options
Show Stats Download Patch File Download Diff File
  1. 9
      src/Magnum/Trade/FlatMaterialData.h
  2. 2
      src/Magnum/Trade/MaterialData.h
  3. 21
      src/Magnum/Trade/PbrClearCoatMaterialData.h
  4. 2
      src/Magnum/Trade/PbrMetallicRoughnessMaterialData.cpp
  5. 20
      src/Magnum/Trade/PbrMetallicRoughnessMaterialData.h
  6. 37
      src/Magnum/Trade/PbrSpecularGlossinessMaterialData.h
  7. 16
      src/Magnum/Trade/PhongMaterialData.h

9
src/Magnum/Trade/FlatMaterialData.h
Unescape View File

@ -63,6 +63,7 @@ class MAGNUM_TRADE_EXPORT FlatMaterialData: public MaterialData {
* @ref MaterialAttribute::BaseColorTexture or * @ref MaterialAttribute::BaseColorTexture or
* @ref MaterialAttribute::DiffuseTexture attributes is present, * @ref MaterialAttribute::DiffuseTexture attributes is present,
* @cpp false @ce otherwise. * @cpp false @ce otherwise.
* @see @ref texture()
*/ */
bool hasTexture() const; bool hasTexture() const;
@ -77,6 +78,7 @@ class MAGNUM_TRADE_EXPORT FlatMaterialData: public MaterialData {
* example a @ref MaterialAttribute::BaseColorTexture but only a * example a @ref MaterialAttribute::BaseColorTexture but only a
* @ref MaterialAttribute::DiffuseTextureMatrix, * @ref MaterialAttribute::DiffuseTextureMatrix,
* returns @cpp false @ce. * returns @cpp false @ce.
* @see @ref textureMatrix()
*/ */
bool hasTextureTransformation() const; bool hasTextureTransformation() const;
@ -87,15 +89,16 @@ class MAGNUM_TRADE_EXPORT FlatMaterialData: public MaterialData {
/** /**
* @brief Whether the material uses extra texture coordinate sets * @brief Whether the material uses extra texture coordinate sets
* *
* Returns @cpp true @ce if the material is textured an a * Returns @cpp true @ce if the material is textured and a
* @ref MaterialAttribute::BaseColorTextureCoordinates, * @ref MaterialAttribute::BaseColorTextureCoordinates,
* @ref MaterialAttribute::DiffuseTextureCoordinates or * @ref MaterialAttribute::DiffuseTextureCoordinates or
* @ref MaterialAttribute::TextureCoordinates attribute matching the * @ref MaterialAttribute::TextureCoordinates attribute matching the
* texture is present and has a non-zero value, @cpp false @ce * texture is present and has a non-zero value, @cpp false @ce
* otherwise. In particular, if there's for example a * otherwise. In particular, if there's for example a
* @ref MaterialAttribute::BaseColorTexture but * @ref MaterialAttribute::BaseColorTexture but only a
* only a @ref MaterialAttribute::DiffuseTextureCoordinates, returns * @ref MaterialAttribute::DiffuseTextureCoordinates, returns
* @cpp false @ce. * @cpp false @ce.
* @see @ref textureCoordinates()
*/ */
bool hasTextureCoordinates() const; bool hasTextureCoordinates() const;

2
src/Magnum/Trade/MaterialData.h
Unescape View File

@ -2044,7 +2044,7 @@ class MAGNUM_TRADE_EXPORT MaterialData {
* Convenience access to the @ref MaterialAttribute::LayerFactorTextureCoordinates * Convenience access to the @ref MaterialAttribute::LayerFactorTextureCoordinates
* / @ref MaterialAttribute::TextureCoordinates attributes in given * / @ref MaterialAttribute::TextureCoordinates attributes in given
* layer or a @ref MaterialAttribute::TextureCoordinates attribute in * layer or a @ref MaterialAttribute::TextureCoordinates attribute in
* the base material. If not present, the default is @cpp 0 @ce. * the base material. If neither is present, the default is @cpp 0 @ce.
* Available only if the @ref MaterialAttribute::LayerFactorTexture * Available only if the @ref MaterialAttribute::LayerFactorTexture
* attribute is present. The @p layer is expected to exist. * attribute is present. The @p layer is expected to exist.
* @see @ref hasLayer(), @ref hasAttribute() * @see @ref hasLayer(), @ref hasAttribute()

21
src/Magnum/Trade/PbrClearCoatMaterialData.h
Unescape View File

@ -95,7 +95,8 @@ class MAGNUM_TRADE_EXPORT PbrClearCoatMaterialData: public MaterialLayerData<Mat
* @ref MaterialAttribute::NormalTextureMatrix or * @ref MaterialAttribute::NormalTextureMatrix or
* @ref MaterialAttribute::TextureMatrix attributes are present in this * @ref MaterialAttribute::TextureMatrix attributes are present in this
* layer or if @ref MaterialAttribute::TextureMatrix is present in the * layer or if @ref MaterialAttribute::TextureMatrix is present in the
* base material, @cpp false @ce otherwise * base material, @cpp false @ce otherwise.
* @see @ref hasCommonTextureTransformation()
*/ */
bool hasTextureTransformation() const; bool hasTextureTransformation() const;
@ -108,6 +109,7 @@ class MAGNUM_TRADE_EXPORT PbrClearCoatMaterialData: public MaterialLayerData<Mat
* otherwise. In particular, returns @cpp true @ce also if there's no * otherwise. In particular, returns @cpp true @ce also if there's no
* texture transformation at all. Use @ref hasTextureTransformation() * texture transformation at all. Use @ref hasTextureTransformation()
* to distinguish that case. * to distinguish that case.
* @see @ref commonTextureMatrix()
*/ */
bool hasCommonTextureTransformation() const; bool hasCommonTextureTransformation() const;
@ -122,6 +124,7 @@ class MAGNUM_TRADE_EXPORT PbrClearCoatMaterialData: public MaterialLayerData<Mat
* this material and have a non-zero value or if * this material and have a non-zero value or if
* @ref MaterialAttribute::TextureCoordinates is present in the base * @ref MaterialAttribute::TextureCoordinates is present in the base
* material and has a non-zero value, @cpp false @ce otherwise. * material and has a non-zero value, @cpp false @ce otherwise.
* @see @ref hasCommonTextureCoordinates()
*/ */
bool hasTextureCoordinates() const; bool hasTextureCoordinates() const;
@ -135,6 +138,7 @@ class MAGNUM_TRADE_EXPORT PbrClearCoatMaterialData: public MaterialLayerData<Mat
* otherwise. In particular, returns @cpp true @ce also if there's no * otherwise. In particular, returns @cpp true @ce also if there's no
* extra texture coordinate set used at all. Use * extra texture coordinate set used at all. Use
* @ref hasTextureCoordinates() to distinguish that case. * @ref hasTextureCoordinates() to distinguish that case.
* @see @ref commonTextureCoordinates()
*/ */
bool hasCommonTextureCoordinates() const; bool hasCommonTextureCoordinates() const;
@ -154,7 +158,7 @@ class MAGNUM_TRADE_EXPORT PbrClearCoatMaterialData: public MaterialLayerData<Mat
* *
* Available only if @ref MaterialAttribute::RoughnessTexture is * Available only if @ref MaterialAttribute::RoughnessTexture is
* present in this layer. Meant to be multiplied with @ref roughness(). * present in this layer. Meant to be multiplied with @ref roughness().
* @see @ref AbstractImporter::texture() * @see @ref hasAttribute(), @ref AbstractImporter::texture()
*/ */
UnsignedInt roughnessTexture() const; UnsignedInt roughnessTexture() const;
@ -260,7 +264,7 @@ class MAGNUM_TRADE_EXPORT PbrClearCoatMaterialData: public MaterialLayerData<Mat
* @brief Common texture coordinate transformation matrix for all textures * @brief Common texture coordinate transformation matrix for all textures
* *
* Expects that @ref hasCommonTextureTransformation() is @cpp true @ce; * Expects that @ref hasCommonTextureTransformation() is @cpp true @ce;
* returns a coordinate set index that's the same for all of * returns a matrix that's the same for all of
* @ref layerFactorTextureMatrix(), @ref roughnessTextureMatrix() and * @ref layerFactorTextureMatrix(), @ref roughnessTextureMatrix() and
* @ref normalTextureMatrix() where a texture is present. If no texture * @ref normalTextureMatrix() where a texture is present. If no texture
* is present, returns an identity matrix. * is present, returns an identity matrix.
@ -268,13 +272,14 @@ class MAGNUM_TRADE_EXPORT PbrClearCoatMaterialData: public MaterialLayerData<Mat
Matrix3 commonTextureMatrix() const; Matrix3 commonTextureMatrix() const;
/** /**
* @brief Common texture coordinate set index for all textures * @brief Common texture coordinate set for all textures
* *
* Expects that @ref hasCommonTextureCoordinates() is @cpp true @ce; * Expects that @ref hasCommonTextureCoordinates() is @cpp true @ce;
* returns a coordinate set index that's the same for all of * returns a coordinate set that's the same for all of
* @ref layerFactorTextureCoordinates(), @ref roughnessTextureCoordinates() * @ref layerFactorTextureCoordinates(),
* and @ref normalTextureCoordinates() where a texture is present. If * @ref roughnessTextureCoordinates() and
* no texture is present, returns @cpp 0 @ce. * @ref normalTextureCoordinates() where a texture is present. If no
* texture is present, returns @cpp 0 @ce.
*/ */
UnsignedInt commonTextureCoordinates() const; UnsignedInt commonTextureCoordinates() const;
}; };

2
src/Magnum/Trade/PbrMetallicRoughnessMaterialData.cpp
Unescape View File

@ -126,7 +126,7 @@ bool PbrMetallicRoughnessMaterialData::hasTextureTransformation() const {
hasAttribute(MaterialAttribute::RoughnessTextureMatrix) || hasAttribute(MaterialAttribute::RoughnessTextureMatrix) ||
hasAttribute(MaterialAttribute::NormalTextureMatrix) || hasAttribute(MaterialAttribute::NormalTextureMatrix) ||
hasAttribute(MaterialAttribute::OcclusionTextureMatrix) || hasAttribute(MaterialAttribute::OcclusionTextureMatrix) ||
hasAttribute(MaterialAttribute::EmissiveTextureMatrix);; hasAttribute(MaterialAttribute::EmissiveTextureMatrix);
} }
bool PbrMetallicRoughnessMaterialData::hasCommonTextureTransformation() const { bool PbrMetallicRoughnessMaterialData::hasCommonTextureTransformation() const {

20
src/Magnum/Trade/PbrMetallicRoughnessMaterialData.h
Unescape View File

@ -62,7 +62,8 @@ class MAGNUM_TRADE_EXPORT PbrMetallicRoughnessMaterialData: public MaterialData
* @ref MaterialAttribute::MetalnessTexture or * @ref MaterialAttribute::MetalnessTexture or
* @ref MaterialAttribute::NoneRoughnessMetallicTexture attributes is * @ref MaterialAttribute::NoneRoughnessMetallicTexture attributes is
* present, @cpp false @ce otherwise. * present, @cpp false @ce otherwise.
* @see @ref hasRoughnessTexture(), @ref hasNoneRoughnessMetallicTexture() * @see @ref metalnessTexture(), @ref hasRoughnessTexture(),
* @ref hasNoneRoughnessMetallicTexture()
*/ */
bool hasMetalnessTexture() const; bool hasMetalnessTexture() const;
@ -73,7 +74,8 @@ class MAGNUM_TRADE_EXPORT PbrMetallicRoughnessMaterialData: public MaterialData
* @ref MaterialAttribute::RoughnessTexture or * @ref MaterialAttribute::RoughnessTexture or
* @ref MaterialAttribute::NoneRoughnessMetallicTexture attributes is * @ref MaterialAttribute::NoneRoughnessMetallicTexture attributes is
* present, @cpp false @ce otherwise. * present, @cpp false @ce otherwise.
* @see @ref hasMetalnessTexture(), @ref hasNoneRoughnessMetallicTexture() * @see @ref roughnessTexture(), @ref hasMetalnessTexture(),
* @ref hasNoneRoughnessMetallicTexture()
*/ */
bool hasRoughnessTexture() const; bool hasRoughnessTexture() const;
@ -260,6 +262,7 @@ class MAGNUM_TRADE_EXPORT PbrMetallicRoughnessMaterialData: public MaterialData
* the same value, @cpp false @ce otherwise. In particular, returns * the same value, @cpp false @ce otherwise. In particular, returns
* @cpp true @ce also if there's no texture transformation at all. Use * @cpp true @ce also if there's no texture transformation at all. Use
* @ref hasTextureTransformation() to distinguish that case. * @ref hasTextureTransformation() to distinguish that case.
* @see @ref commonTextureMatrix()
*/ */
bool hasCommonTextureTransformation() const; bool hasCommonTextureTransformation() const;
@ -290,6 +293,7 @@ class MAGNUM_TRADE_EXPORT PbrMetallicRoughnessMaterialData: public MaterialData
* returns @cpp true @ce also if there's no extra texture coordinate * returns @cpp true @ce also if there's no extra texture coordinate
* set used at all. Use @ref hasTextureCoordinates() to distinguish * set used at all. Use @ref hasTextureCoordinates() to distinguish
* that case. * that case.
* @see @ref commonTextureCoordinates()
*/ */
bool hasCommonTextureCoordinates() const; bool hasCommonTextureCoordinates() const;
@ -492,10 +496,10 @@ class MAGNUM_TRADE_EXPORT PbrMetallicRoughnessMaterialData: public MaterialData
* @brief Normal texture coordinate set * @brief Normal texture coordinate set
* *
* Convenience access to the @ref MaterialAttribute::NormalTextureCoordinates * Convenience access to the @ref MaterialAttribute::NormalTextureCoordinates
* / @ref MaterialAttribute::TextureCoordinates attributes. If neither is * / @ref MaterialAttribute::TextureCoordinates attributes. If neither
* present, the default is @cpp 0 @ce. Available only if the material * is present, the default is @cpp 0 @ce. Available only if the
* has @ref MaterialAttribute::NormalTexture. * material has @ref MaterialAttribute::NormalTexture.
* @see @ref hasAttribute(), @ref AbstractImporter::texture() * @see @ref hasAttribute()
*/ */
UnsignedInt normalTextureCoordinates() const; UnsignedInt normalTextureCoordinates() const;
@ -600,7 +604,7 @@ class MAGNUM_TRADE_EXPORT PbrMetallicRoughnessMaterialData: public MaterialData
* @brief Common texture coordinate transformation matrix for all textures * @brief Common texture coordinate transformation matrix for all textures
* *
* Expects that @ref hasCommonTextureTransformation() is @cpp true @ce; * Expects that @ref hasCommonTextureTransformation() is @cpp true @ce;
* returns a coordinate set index that's the same for all of * returns a matrix that's the same for all of
* @ref baseColorTextureMatrix(), @ref metalnessTextureMatrix(), * @ref baseColorTextureMatrix(), @ref metalnessTextureMatrix(),
* @ref roughnessTextureMatrix(), @ref normalTextureMatrix(), * @ref roughnessTextureMatrix(), @ref normalTextureMatrix(),
* @ref occlusionTextureMatrix() and @ref emissiveTextureMatrix() where * @ref occlusionTextureMatrix() and @ref emissiveTextureMatrix() where
@ -610,7 +614,7 @@ class MAGNUM_TRADE_EXPORT PbrMetallicRoughnessMaterialData: public MaterialData
Matrix3 commonTextureMatrix() const; Matrix3 commonTextureMatrix() const;
/** /**
* @brief Common texture coordinate set index for all textures * @brief Common texture coordinate set for all textures
* *
* Expects that @ref hasCommonTextureCoordinates() is @cpp true @ce; * Expects that @ref hasCommonTextureCoordinates() is @cpp true @ce;
* returns a coordinate set index that's the same for all of * returns a coordinate set index that's the same for all of

37
src/Magnum/Trade/PbrSpecularGlossinessMaterialData.h
Unescape View File

@ -62,7 +62,7 @@ class MAGNUM_TRADE_EXPORT PbrSpecularGlossinessMaterialData: public MaterialData
* @ref MaterialAttribute::SpecularTexture or * @ref MaterialAttribute::SpecularTexture or
* @ref MaterialAttribute::SpecularGlossinessTexture attributes is * @ref MaterialAttribute::SpecularGlossinessTexture attributes is
* present, @cpp false @ce otherwise. * present, @cpp false @ce otherwise.
* @see @ref hasGlossinessTexture(), * @see @ref specularTexture(), @ref hasGlossinessTexture(),
* @ref hasSpecularGlossinessTexture() * @ref hasSpecularGlossinessTexture()
*/ */
bool hasSpecularTexture() const; bool hasSpecularTexture() const;
@ -74,7 +74,7 @@ class MAGNUM_TRADE_EXPORT PbrSpecularGlossinessMaterialData: public MaterialData
* @ref MaterialAttribute::GlossinessTexture or * @ref MaterialAttribute::GlossinessTexture or
* @ref MaterialAttribute::SpecularGlossinessTexture attributes is * @ref MaterialAttribute::SpecularGlossinessTexture attributes is
* present, @cpp false @ce otherwise. * present, @cpp false @ce otherwise.
* @see @ref hasSpecularTexture(), * @see @ref glossinessTexture(), @ref hasSpecularTexture(),
* @ref hasSpecularGlossinessTexture() * @ref hasSpecularGlossinessTexture()
*/ */
bool hasGlossinessTexture() const; bool hasGlossinessTexture() const;
@ -130,6 +130,7 @@ class MAGNUM_TRADE_EXPORT PbrSpecularGlossinessMaterialData: public MaterialData
* the same value, @cpp false @ce otherwise. In particular, returns * the same value, @cpp false @ce otherwise. In particular, returns
* @cpp true @ce also if there's no texture transformation at all. Use * @cpp true @ce also if there's no texture transformation at all. Use
* @ref hasTextureTransformation() to distinguish that case. * @ref hasTextureTransformation() to distinguish that case.
* @see @ref commonTextureMatrix()
*/ */
bool hasCommonTextureTransformation() const; bool hasCommonTextureTransformation() const;
@ -145,6 +146,7 @@ class MAGNUM_TRADE_EXPORT PbrSpecularGlossinessMaterialData: public MaterialData
* @ref MaterialAttribute::EmissiveTextureCoordinates or * @ref MaterialAttribute::EmissiveTextureCoordinates or
* @ref MaterialAttribute::TextureCoordinates attributes is present and * @ref MaterialAttribute::TextureCoordinates attributes is present and
* has a non-zero value, @cpp false @ce otherwise. * has a non-zero value, @cpp false @ce otherwise.
* @see @ref hasCommonTextureCoordinates()
*/ */
bool hasTextureCoordinates() const; bool hasTextureCoordinates() const;
@ -159,11 +161,12 @@ class MAGNUM_TRADE_EXPORT PbrSpecularGlossinessMaterialData: public MaterialData
* returns @cpp true @ce also if there's no extra texture coordinate * returns @cpp true @ce also if there's no extra texture coordinate
* set used at all. Use @ref hasTextureCoordinates() to distinguish * set used at all. Use @ref hasTextureCoordinates() to distinguish
* that case. * that case.
* @see @ref commonTextureCoordinates()
*/ */
bool hasCommonTextureCoordinates() const; bool hasCommonTextureCoordinates() const;
/** /**
* @brief Base color * @brief Diffuse color
* *
* Convenience access to the @ref MaterialAttribute::DiffuseColor * Convenience access to the @ref MaterialAttribute::DiffuseColor
* attribute. If not present, the default is @cpp 0xffffffff_srgbaf @ce. * attribute. If not present, the default is @cpp 0xffffffff_srgbaf @ce.
@ -174,7 +177,7 @@ class MAGNUM_TRADE_EXPORT PbrSpecularGlossinessMaterialData: public MaterialData
Color4 diffuseColor() const; Color4 diffuseColor() const;
/** /**
* @brief Base color texture ID * @brief Diffuse texture ID
* *
* Available only if @ref MaterialAttribute::DiffuseTexture is * Available only if @ref MaterialAttribute::DiffuseTexture is
* present. Meant to be multiplied with @ref diffuseColor(). * present. Meant to be multiplied with @ref diffuseColor().
@ -183,7 +186,7 @@ class MAGNUM_TRADE_EXPORT PbrSpecularGlossinessMaterialData: public MaterialData
UnsignedInt diffuseTexture() const; UnsignedInt diffuseTexture() const;
/** /**
* @brief Base color texture coordinate transformation matrix * @brief Diffuse texture coordinate transformation matrix
* *
* Convenience access to the @ref MaterialAttribute::DiffuseTextureMatrix * Convenience access to the @ref MaterialAttribute::DiffuseTextureMatrix
* / @ref MaterialAttribute::TextureMatrix attributes. If neither is * / @ref MaterialAttribute::TextureMatrix attributes. If neither is
@ -194,7 +197,7 @@ class MAGNUM_TRADE_EXPORT PbrSpecularGlossinessMaterialData: public MaterialData
Matrix3 diffuseTextureMatrix() const; Matrix3 diffuseTextureMatrix() const;
/** /**
* @brief Base color texture coordinate set * @brief Diffuse texture coordinate set
* *
* Convenience access to the @ref MaterialAttribute::DiffuseTextureCoordinates * Convenience access to the @ref MaterialAttribute::DiffuseTextureCoordinates
* / @ref MaterialAttribute::TextureCoordinates attributes. If neither is * / @ref MaterialAttribute::TextureCoordinates attributes. If neither is
@ -404,7 +407,7 @@ class MAGNUM_TRADE_EXPORT PbrSpecularGlossinessMaterialData: public MaterialData
* / @ref MaterialAttribute::TextureMatrix attributes. If neither is * / @ref MaterialAttribute::TextureMatrix attributes. If neither is
* present, the default is an identity matrix. Available only if the * present, the default is an identity matrix. Available only if the
* material has @ref MaterialAttribute::OcclusionTexture. * material has @ref MaterialAttribute::OcclusionTexture.
* @see @ref hasAttribute(), @ref AbstractImporter::texture() * @see @ref hasAttribute()
*/ */
Matrix3 occlusionTextureMatrix() const; Matrix3 occlusionTextureMatrix() const;
@ -415,7 +418,7 @@ class MAGNUM_TRADE_EXPORT PbrSpecularGlossinessMaterialData: public MaterialData
* / @ref MaterialAttribute::TextureCoordinates attributes. If neither is * / @ref MaterialAttribute::TextureCoordinates attributes. If neither is
* present, the default is @cpp 0 @ce. Available only if the material * present, the default is @cpp 0 @ce. Available only if the material
* has @ref MaterialAttribute::OcclusionTexture. * has @ref MaterialAttribute::OcclusionTexture.
* @see @ref hasAttribute(), @ref AbstractImporter::texture() * @see @ref hasAttribute()
*/ */
UnsignedInt occlusionTextureCoordinates() const; UnsignedInt occlusionTextureCoordinates() const;
@ -449,7 +452,7 @@ class MAGNUM_TRADE_EXPORT PbrSpecularGlossinessMaterialData: public MaterialData
* / @ref MaterialAttribute::TextureMatrix attributes. If neither is * / @ref MaterialAttribute::TextureMatrix attributes. If neither is
* present, the default is an identity matrix. Available only if the * present, the default is an identity matrix. Available only if the
* material has @ref MaterialAttribute::EmissiveTexture. * material has @ref MaterialAttribute::EmissiveTexture.
* @see @ref hasAttribute(), @ref AbstractImporter::texture() * @see @ref hasAttribute()
*/ */
Matrix3 emissiveTextureMatrix() const; Matrix3 emissiveTextureMatrix() const;
@ -460,7 +463,7 @@ class MAGNUM_TRADE_EXPORT PbrSpecularGlossinessMaterialData: public MaterialData
* / @ref MaterialAttribute::TextureCoordinates attributes. If neither * / @ref MaterialAttribute::TextureCoordinates attributes. If neither
* is present, the default is @cpp 0 @ce. Available only if the * is present, the default is @cpp 0 @ce. Available only if the
* material has @ref MaterialAttribute::EmissiveTexture. * material has @ref MaterialAttribute::EmissiveTexture.
* @see @ref hasAttribute(), @ref AbstractImporter::texture() * @see @ref hasAttribute()
*/ */
UnsignedInt emissiveTextureCoordinates() const; UnsignedInt emissiveTextureCoordinates() const;
@ -468,7 +471,7 @@ class MAGNUM_TRADE_EXPORT PbrSpecularGlossinessMaterialData: public MaterialData
* @brief Common texture coordinate transformation matrix for all textures * @brief Common texture coordinate transformation matrix for all textures
* *
* Expects that @ref hasCommonTextureTransformation() is @cpp true @ce; * Expects that @ref hasCommonTextureTransformation() is @cpp true @ce;
* returns a coordinate set index that's the same for all of * returns a matrix that's the same for all of
* @ref diffuseTextureMatrix(), @ref specularTextureMatrix(), * @ref diffuseTextureMatrix(), @ref specularTextureMatrix(),
* @ref glossinessTextureMatrix(), @ref normalTextureMatrix(), * @ref glossinessTextureMatrix(), @ref normalTextureMatrix(),
* @ref occlusionTextureMatrix() and @ref emissiveTextureMatrix() where * @ref occlusionTextureMatrix() and @ref emissiveTextureMatrix() where
@ -478,15 +481,15 @@ class MAGNUM_TRADE_EXPORT PbrSpecularGlossinessMaterialData: public MaterialData
Matrix3 commonTextureMatrix() const; Matrix3 commonTextureMatrix() const;
/** /**
* @brief Common texture coordinate set index for all textures * @brief Common texture coordinate set for all textures
* *
* Expects that @ref hasCommonTextureCoordinates() is @cpp true @ce; * Expects that @ref hasCommonTextureCoordinates() is @cpp true @ce;
* returns a coordinate set index that's the same for all of * returns a coordinate set that's the same for all of
* @ref diffuseTextureCoordinates(), @ref specularTextureCoordinates(), * @ref diffuseTextureCoordinates(), @ref specularTextureCoordinates(),
* @ref glossinessTextureCoordinates(), @ref normalTextureCoordinates(), * @ref glossinessTextureCoordinates(),
* @ref occlusionTextureCoordinates() and @ref emissiveTextureCoordinates() * @ref normalTextureCoordinates(), @ref occlusionTextureCoordinates()
* where a texture is present. If no texture is present, returns * and @ref emissiveTextureCoordinates() where a texture is present. If
* @cpp 0 @ce. * no texture is present, returns @cpp 0 @ce.
*/ */
UnsignedInt commonTextureCoordinates() const; UnsignedInt commonTextureCoordinates() const;
}; };

16
src/Magnum/Trade/PhongMaterialData.h
Unescape View File

@ -267,6 +267,7 @@ class MAGNUM_TRADE_EXPORT PhongMaterialData: public MaterialData {
* same value, @cpp false @ce otherwise. In particular, returns * same value, @cpp false @ce otherwise. In particular, returns
* @cpp true @ce also if there's no texture transformation at all. Use * @cpp true @ce also if there's no texture transformation at all. Use
* @ref hasTextureTransformation() to distinguish that case. * @ref hasTextureTransformation() to distinguish that case.
* @see @ref commonTextureMatrix()
*/ */
bool hasCommonTextureTransformation() const; bool hasCommonTextureTransformation() const;
@ -296,6 +297,7 @@ class MAGNUM_TRADE_EXPORT PhongMaterialData: public MaterialData {
* returns @cpp true @ce also if there's no extra texture coordinate * returns @cpp true @ce also if there's no extra texture coordinate
* set used at all. Use @ref hasTextureCoordinates() to distinguish * set used at all. Use @ref hasTextureCoordinates() to distinguish
* that case. * that case.
* @see @ref commonTextureCoordinates()
*/ */
bool hasCommonTextureCoordinates() const; bool hasCommonTextureCoordinates() const;
@ -335,7 +337,7 @@ class MAGNUM_TRADE_EXPORT PhongMaterialData: public MaterialData {
* *
* Available only if @ref MaterialAttribute::AmbientTexture is * Available only if @ref MaterialAttribute::AmbientTexture is
* present. Meant to be multiplied with @ref ambientColor(). * present. Meant to be multiplied with @ref ambientColor().
* @see @ref hasAttribute() * @see @ref hasAttribute(), @ref AbstractImporter::texture()
*/ */
UnsignedInt ambientTexture() const; UnsignedInt ambientTexture() const;
@ -572,7 +574,7 @@ class MAGNUM_TRADE_EXPORT PhongMaterialData: public MaterialData {
* @m_since_latest * @m_since_latest
* *
* Expects that @ref hasCommonTextureTransformation() is @cpp true @ce; * Expects that @ref hasCommonTextureTransformation() is @cpp true @ce;
* returns a coordinate set index that's the same for all of * returns a matrix that's the same for all of
* @ref ambientTextureMatrix(), @ref diffuseTextureMatrix(), * @ref ambientTextureMatrix(), @ref diffuseTextureMatrix(),
* @ref specularTextureMatrix() and @ref normalTextureMatrix() where a * @ref specularTextureMatrix() and @ref normalTextureMatrix() where a
* texture is present. If no texture is present, returns an identity * texture is present. If no texture is present, returns an identity
@ -595,15 +597,15 @@ class MAGNUM_TRADE_EXPORT PhongMaterialData: public MaterialData {
#endif #endif
/** /**
* @brief Common texture coordinate set index for all textures * @brief Common texture coordinate set for all textures
* @m_since_latest * @m_since_latest
* *
* Expects that @ref hasCommonTextureCoordinates() is @cpp true @ce; * Expects that @ref hasCommonTextureCoordinates() is @cpp true @ce;
* returns a coordinate set index that's the same for all of * returns a coordinate set that's the same for all of
* @ref ambientTextureCoordinates(), @ref diffuseTextureCoordinates(), * @ref ambientTextureCoordinates(), @ref diffuseTextureCoordinates(),
* @ref specularTextureCoordinates() and @ref normalTextureCoordinates() * @ref specularTextureCoordinates() and
* where a texture is present. If no texture is present, returns * @ref normalTextureCoordinates() where a texture is present. If no
* @cpp 0 @ce. * texture is present, returns @cpp 0 @ce.
*/ */
UnsignedInt commonTextureCoordinates() const; UnsignedInt commonTextureCoordinates() const;

Write Preview
Loading…
Cancel
Save