mirror of https://github.com/mosra/magnum.git
Vladimír Vondruš
6 years ago
11 changed files with 515 additions and 15 deletions
@ -0,0 +1,107 @@
|
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, |
||||
2020 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
#include "FlatMaterialData.h" |
||||
|
||||
#include "Magnum/Math/Color.h" |
||||
#include "Magnum/Math/Matrix3.h" |
||||
|
||||
namespace Magnum { namespace Trade { |
||||
|
||||
using namespace Math::Literals; |
||||
|
||||
bool FlatMaterialData::hasTexture() const { |
||||
return hasAttribute(MaterialAttribute::BaseColorTexture) || |
||||
hasAttribute(MaterialAttribute::DiffuseTexture); |
||||
} |
||||
|
||||
bool FlatMaterialData::hasTextureTransformation() const { |
||||
return (hasAttribute(MaterialAttribute::BaseColorTexture) && hasAttribute(MaterialAttribute::BaseColorTextureMatrix)) || |
||||
(hasAttribute(MaterialAttribute::DiffuseTexture) && hasAttribute(MaterialAttribute::DiffuseTextureMatrix)) || |
||||
hasAttribute(MaterialAttribute::TextureMatrix); |
||||
} |
||||
|
||||
bool FlatMaterialData::hasTextureCoordinates() const { |
||||
return (hasAttribute(MaterialAttribute::BaseColorTexture) && hasAttribute(MaterialAttribute::BaseColorTextureCoordinates)) || |
||||
(hasAttribute(MaterialAttribute::DiffuseTexture) && hasAttribute(MaterialAttribute::DiffuseTextureCoordinates)) || |
||||
hasAttribute(MaterialAttribute::TextureCoordinates); |
||||
} |
||||
|
||||
Color4 FlatMaterialData::color() const { |
||||
/* If the material has a texture, return the color that matches it */ |
||||
if(hasAttribute(MaterialAttribute::BaseColorTexture)) |
||||
return attributeOr(MaterialAttribute::BaseColor, 0xffffffff_srgbaf); |
||||
if(hasAttribute(MaterialAttribute::DiffuseTexture)) |
||||
return attributeOr(MaterialAttribute::DiffuseColor, 0xffffffff_srgbaf); |
||||
|
||||
/* If there's no texture, return whatever is present */ |
||||
if(Containers::Optional<Color4> value = tryAttribute<Color4>(MaterialAttribute::BaseColor)) |
||||
return *value; |
||||
return attributeOr(MaterialAttribute::DiffuseColor, 0xffffffff_srgbaf); |
||||
} |
||||
|
||||
UnsignedInt FlatMaterialData::texture() const { |
||||
/* Explicit assertion because printing that DiffuseTexture isn't found
|
||||
would be misleading as it can be also BaseColorTexture */ |
||||
CORRADE_ASSERT(hasTexture(), |
||||
"Trade::FlatMaterialData::texture(): the material doesn't have a texture", {}); |
||||
if(Containers::Optional<UnsignedInt> value = tryAttribute<UnsignedInt>(MaterialAttribute::BaseColorTexture)) |
||||
return *value; |
||||
return attribute<UnsignedInt>(MaterialAttribute::DiffuseTexture); |
||||
} |
||||
|
||||
Matrix3 FlatMaterialData::textureMatrix() const { |
||||
if(hasAttribute(MaterialAttribute::BaseColorTexture)) { |
||||
if(Containers::Optional<Matrix3> value = tryAttribute<Matrix3>(MaterialAttribute::BaseColorTextureMatrix)) |
||||
return *value; |
||||
return attributeOr(MaterialAttribute::TextureMatrix, Matrix3{}); |
||||
} |
||||
|
||||
if(hasAttribute(MaterialAttribute::DiffuseTexture)) { |
||||
if(Containers::Optional<Matrix3> value = tryAttribute<Matrix3>(MaterialAttribute::DiffuseTextureMatrix)) |
||||
return *value; |
||||
return attributeOr(MaterialAttribute::TextureMatrix, Matrix3{}); |
||||
} |
||||
|
||||
CORRADE_ASSERT_UNREACHABLE("Trade::FlatMaterialData::textureMatrix(): the material doesn't have a texture", {}); |
||||
} |
||||
|
||||
UnsignedInt FlatMaterialData::textureCoordinates() const { |
||||
if(hasAttribute(MaterialAttribute::BaseColorTexture)) { |
||||
if(Containers::Optional<UnsignedInt> value = tryAttribute<UnsignedInt>(MaterialAttribute::BaseColorTextureCoordinates)) |
||||
return *value; |
||||
return attributeOr(MaterialAttribute::TextureCoordinates, 0u); |
||||
} |
||||
|
||||
if(hasAttribute(MaterialAttribute::DiffuseTexture)) { |
||||
if(Containers::Optional<UnsignedInt> value = tryAttribute<UnsignedInt>(MaterialAttribute::DiffuseTextureCoordinates)) |
||||
return *value; |
||||
return attributeOr(MaterialAttribute::TextureCoordinates, 0u); |
||||
} |
||||
|
||||
CORRADE_ASSERT_UNREACHABLE("Trade::FlatMaterialData::textureCoordinates(): the material doesn't have a texture", {}); |
||||
} |
||||
|
||||
}} |
||||
@ -0,0 +1,152 @@
|
||||
#ifndef Magnum_Trade_FlatMaterialData_h |
||||
#define Magnum_Trade_FlatMaterialData_h |
||||
/*
|
||||
This file is part of Magnum. |
||||
|
||||
Copyright © 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, |
||||
2020 Vladimír Vondruš <mosra@centrum.cz> |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a |
||||
copy of this software and associated documentation files (the "Software"), |
||||
to deal in the Software without restriction, including without limitation |
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
||||
and/or sell copies of the Software, and to permit persons to whom the |
||||
Software is furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included |
||||
in all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
||||
DEALINGS IN THE SOFTWARE. |
||||
*/ |
||||
|
||||
/** @file
|
||||
* @brief Class @ref Magnum::Trade::FlatMaterialData |
||||
* @m_since_latest |
||||
*/ |
||||
|
||||
#include "Magnum/Trade/MaterialData.h" |
||||
|
||||
namespace Magnum { namespace Trade { |
||||
|
||||
/**
|
||||
@brief Flat material data |
||||
@m_since_latest |
||||
|
||||
@see @ref AbstractImporter::material(), @ref PbrMetallicRoughnessMaterialData, |
||||
@ref PbrSpecularGlossinessMaterialData, @ref PhongMaterialData |
||||
*/ |
||||
class MAGNUM_TRADE_EXPORT FlatMaterialData: public MaterialData { |
||||
public: |
||||
#ifndef DOXYGEN_GENERATING_OUTPUT |
||||
/* Allow constructing subclasses directly. While not used in the
|
||||
general Importer workflow, it allows users to create instances with |
||||
desired convenience APIs easier (and simplifies testing). It's |
||||
however hidden from the docs as constructing instances this way |
||||
isn't really common and it would add a lot of noise. */ |
||||
using MaterialData::MaterialData; |
||||
#endif |
||||
|
||||
/**
|
||||
* @brief Whether the material has a specular texture |
||||
* |
||||
* Returns @cpp true @ce if any of the |
||||
* @ref MaterialAttribute::BaseColorTexture or |
||||
* @ref MaterialAttribute::DiffuseTexture attributes is present, |
||||
* @cpp false @ce otherwise. |
||||
*/ |
||||
bool hasTexture() const; |
||||
|
||||
/**
|
||||
* @brief Whether the material has texture transformation |
||||
* |
||||
* Returns @cpp true @ce if the material is textured and a |
||||
* @ref MaterialAttribute::BaseColorTextureMatrix, |
||||
* @ref MaterialAttribute::DiffuseTextureMatrix or |
||||
* @ref MaterialAttribute::TextureMatrix attribute matching the texture |
||||
* is present, @cpp false @ce otherwise. In particular, if there's for |
||||
* example a @ref MaterialAttribute::BaseColorTexture but only a |
||||
* @ref MaterialAttribute::DiffuseTextureMatrix, |
||||
* returns @cpp false @ce. |
||||
*/ |
||||
bool hasTextureTransformation() const; |
||||
|
||||
/**
|
||||
* @brief Whether the material uses extra texture coordinate sets |
||||
* |
||||
* Returns @cpp true @ce if the material is textured an a |
||||
* @ref MaterialAttribute::BaseColorTextureCoordinates, |
||||
* @ref MaterialAttribute::DiffuseTextureCoordinates or |
||||
* @ref MaterialAttribute::TextureCoordinates attribute matching the |
||||
* texture is present and has a non-zero value, @cpp false @ce |
||||
* otherwise. In particular, if there's for example a |
||||
* @ref MaterialAttribute::BaseColorTexture but |
||||
* only a @ref MaterialAttribute::DiffuseTextureCoordinates, returns |
||||
* @cpp false @ce. |
||||
*/ |
||||
bool hasTextureCoordinates() const; |
||||
|
||||
/**
|
||||
* @brief Color |
||||
* |
||||
* Convenience access to the @ref MaterialAttribute::BaseColor / |
||||
* @ref MaterialAttribute::DiffuseColor attributes. If neither of them |
||||
* is present, the default is @cpp 0xffffffff_srgbaf @ce. |
||||
* |
||||
* If the material has a texture, the color attribute matching the |
||||
* texture is picked (instead of combining e.g. a |
||||
* @ref MaterialAttribute::BaseColor with @ref MaterialAttribute::DiffuseTexture). The color and texture is meant to |
||||
* be multiplied together. |
||||
* @see @ref hasAttribute(), @ref hasTexture() |
||||
*/ |
||||
Color4 color() const; |
||||
|
||||
/**
|
||||
* @brief Texture ID |
||||
* |
||||
* Available only if either @ref MaterialAttribute::BaseColorTexture or |
||||
* @ref MaterialAttribute::DiffuseTexture is present. Meant to be |
||||
* multiplied with @ref color(). |
||||
* @see @ref hasTexture(), @ref AbstractImporter::texture() |
||||
*/ |
||||
UnsignedInt texture() const; |
||||
|
||||
/**
|
||||
* @brief Texture coordinate transformation matrix |
||||
* |
||||
* Convenience access to the @ref MaterialAttribute::DiffuseTextureMatrix |
||||
* / @ref MaterialAttribute::BaseColorTextureMatrix / |
||||
* @ref MaterialAttribute::TextureMatrix attributes, picking the one |
||||
* matching the texture (instead of combining e.g. a |
||||
* @ref MaterialAttribute::BaseColorTexture with |
||||
* @ref MaterialAttribute::DiffuseTextureMatrix). If no matching |
||||
* attribute is present, the default is an identity matrix. Available |
||||
* only if the material has a texture. |
||||
* @see @ref hasTexture() |
||||
*/ |
||||
Matrix3 textureMatrix() const; |
||||
|
||||
/**
|
||||
* @brief Texture coordinate set |
||||
* |
||||
* Convenience access to the @ref MaterialAttribute::DiffuseTextureCoordinates |
||||
* / @ref MaterialAttribute::BaseColorTextureCoordinates / |
||||
* @ref MaterialAttribute::TextureCoordinates attributes, picking the |
||||
* one matching the texture (instead of combining e.g. a |
||||
* @ref MaterialAttribute::BaseColorTexture with |
||||
* @ref MaterialAttribute::DiffuseTextureCoordinates). If no matching |
||||
* attribute is present, the default is @cpp 0 @ce. Available only if |
||||
* the material has a texture. |
||||
* @see @ref hasTexture() |
||||
*/ |
||||
UnsignedInt textureCoordinates() const; |
||||
}; |
||||
|
||||
}} |
||||
|
||||
#endif |
||||
Loading…
Reference in new issue