ic
/
magnum
mirror of https://github.com/mosra/magnum.git
6
0
Fork 0
Code Issues Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
7814 Commits
21 Branches
19 Tags
70 MiB
Tree: 60968779da
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '60968779da'
${ noResults }
magnum/src/Magnum/Shaders/MeshVisualizer.h

771 lines
31 KiB
Raw Normal View History Unescape

Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
#ifndef Magnum_Shaders_MeshVisualizer_h
#define Magnum_Shaders_MeshVisualizer_h
/*
This file is part of Magnum.
Updated copyright year.
7 years ago
Copyright © 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019
Happy new year too.
12 years ago
Vladimír Vondruš <mosra@centrum.cz>
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
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
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
* @brief Class @ref Magnum::Shaders::MeshVisualizer2D, @ref Magnum::Shaders::MeshVisualizer3D
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
*/
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
#include <Corrade/Utility/Utility.h>
#include "Magnum/DimensionTraits.h"
Split the OpenGL layer out, pt 20: adapted Shaders.
8 years ago
#include "Magnum/GL/AbstractShaderProgram.h"
Shaders: huh, why this isn't done here?
7 years ago
#include "Magnum/Shaders/Generic.h"
Making includes absolute, part 6: better filenames for internal files. As we are now using absolute includes, there is no need to prefix everything with "magnum<Namespace>" etc. All generated configuration files are renamed to configure.h and their path is included _before_ everything else to avoid accidental collisions.
12 years ago
#include "Magnum/Shaders/visibility.h"
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
namespace Magnum { namespace Shaders {
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
namespace Implementation {
class MAGNUM_SHADERS_EXPORT MeshVisualizerBase: public GL::AbstractShaderProgram {
protected:
enum class FlagBase: UnsignedByte {
#ifndef MAGNUM_TARGET_GLES2
Wireframe = 1 << 0,
#else
Wireframe = (1 << 0) | (1 << 1),
#endif
NoGeometryShader = 1 << 1
};
typedef Containers::EnumSet<FlagBase> FlagsBase;
CORRADE_ENUMSET_FRIEND_OPERATORS(FlagsBase)
explicit MeshVisualizerBase(FlagsBase flags);
explicit MeshVisualizerBase(NoCreateT) noexcept: GL::AbstractShaderProgram{NoCreate} {}
MAGNUM_SHADERS_LOCAL GL::Version setupShaders(GL::Shader& vert, GL::Shader& frag, const Utility::Resource& rs) const;
MeshVisualizerBase& setColor(const Color4& color);
MeshVisualizerBase& setWireframeColor(const Color4& color);
MeshVisualizerBase& setWireframeWidth(Float width);
/* Prevent accidentally calling irrelevant functions */
#ifndef MAGNUM_TARGET_GLES
using GL::AbstractShaderProgram::drawTransformFeedback;
#endif
#if !defined(MAGNUM_TARGET_GLES2) && !defined(MAGNUM_TARGET_WEBGL)
using GL::AbstractShaderProgram::dispatchCompute;
#endif
FlagsBase _flags;
Int _colorUniform{1},
_wireframeColorUniform{2},
_wireframeWidthUniform{3},
_smoothnessUniform{4},
_viewportSizeUniform{5};
};
}
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
/**
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
@brief 2D mesh visualization shader
@m_since_latest
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
Uses the geometry shader to visualize wireframe of 3D meshes. You need to
Shaders: remove MeshVisualizer default behavior. It was rendering everything with a plain color, which is rather useless. Moreover it wasn't consistent with TBN visualization where you might actually want only the lines rendered and not the triangle.
6 years ago
provide the @ref Position attribute in your triangle mesh. Use
Shaders: define reasonable uniform defaults for all shaders. Plus a bit of cleanup / fixing broken English.
8 years ago
@ref setTransformationProjectionMatrix(), @ref setColor() and others to
configure the shader.
Shaders: there's never enough documentation. Each shader now has sample image, example mesh configuration and example rendering setup. Also properly documented all attribute types and made introductory chapter for whole Shaders namespace.
11 years ago
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
@image html shaders-meshvisualizer2d.png width=256px
Shaders: remove MeshVisualizer default behavior. It was rendering everything with a plain color, which is rather useless. Moreover it wasn't consistent with TBN visualization where you might actually want only the lines rendered and not the triangle.
6 years ago
The shader expects that you enable wireframe visualization by passing an
appropriate @ref Flag to the constructor --- there's no default behavior with
nothing enabled. The shader is a 2D variant of @ref MeshVisualizer3D with
mostly identical workflow. See its documentation for more information.
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
*/
class MAGNUM_SHADERS_EXPORT MeshVisualizer2D: public Implementation::MeshVisualizerBase {
public:
/**
* @brief Vertex position
*
* @ref shaders-generic "Generic attribute",
* @ref Magnum::Vector2 "Vector2".
*/
typedef typename Generic2D::Position Position;
/**
* @brief Vertex index
*
* See @ref MeshVisualizer3D::VertexIndex for more information.
*/
typedef GL::Attribute<4, Float> VertexIndex;
enum: UnsignedInt {
/**
* Color shader output. @ref shaders-generic "Generic output",
* present always. Expects three- or four-component floating-point
* or normalized buffer attachment.
*/
ColorOutput = Generic2D::ColorOutput
};
/**
* @brief Flag
*
* @see @ref Flags, @ref MeshVisualizer2D()
*/
enum class Flag: UnsignedByte {
/**
* Visualize wireframe. On OpenGL ES 2.0 this also enables
* @ref Flag::NoGeometryShader.
*/
#ifndef MAGNUM_TARGET_GLES2
Wireframe = 1 << 0,
#else
Wireframe = (1 << 0) | (1 << 1),
#endif
/**
* Don't use a geometry shader for wireframe visualization. If
* enabled, you might need to provide also the @ref VertexIndex
* attribute in the mesh. In OpenGL ES 2.0 enabled alongside
* @ref Flag::Wireframe.
*/
NoGeometryShader = 1 << 1
};
/** @brief Flags */
typedef Containers::EnumSet<Flag> Flags;
/**
* @brief Constructor
* @param flags Flags
Shaders: remove MeshVisualizer default behavior. It was rendering everything with a plain color, which is rather useless. Moreover it wasn't consistent with TBN visualization where you might actually want only the lines rendered and not the triangle.
6 years ago
*
* At least @ref Flag::Wireframe is expected to be enabled.
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
*/
Shaders: remove MeshVisualizer default behavior. It was rendering everything with a plain color, which is rather useless. Moreover it wasn't consistent with TBN visualization where you might actually want only the lines rendered and not the triangle.
6 years ago
explicit MeshVisualizer2D(Flags flags);
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
/**
* @brief Construct without creating the underlying OpenGL object
*
* The constructed instance is equivalent to a moved-from state. Useful
* in cases where you will overwrite the instance later anyway. Move
* another object over it to make it useful.
*
* This function can be safely used for constructing (and later
* destructing) objects even without any OpenGL context being active.
* However note that this is a low-level and a potentially dangerous
* API, see the documentation of @ref NoCreate for alternatives.
*/
explicit MeshVisualizer2D(NoCreateT) noexcept: Implementation::MeshVisualizerBase{NoCreate} {}
/** @brief Copying is not allowed */
MeshVisualizer2D(const MeshVisualizer2D&) = delete;
/** @brief Move constructor */
MeshVisualizer2D(MeshVisualizer2D&&) noexcept = default;
/** @brief Copying is not allowed */
MeshVisualizer2D& operator=(const MeshVisualizer2D&) = delete;
/** @brief Move assignment */
MeshVisualizer2D& operator=(MeshVisualizer2D&&) noexcept = default;
/** @brief Flags */
Flags flags() const {
return reinterpret_cast<const Flags&>(Implementation::MeshVisualizerBase::_flags);
}
/**
* @brief Set transformation and projection matrix
* @return Reference to self (for method chaining)
*
* Initial value is an identity matrix.
*/
MeshVisualizer2D& setTransformationProjectionMatrix(const Matrix3& matrix);
/**
* @brief Set viewport size
* @return Reference to self (for method chaining)
*
* Has effect only if @ref Flag::Wireframe is enabled and geometry
* shaders are used, otherwise it does nothing. Initial value is a zero
* vector.
*/
Shaders: tangent space visualization in MeshVisualizer3D.
6 years ago
MeshVisualizer2D& setViewportSize(const Vector2& size);
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
/**
* @brief Set base object color
* @return Reference to self (for method chaining)
*
Shaders: remove MeshVisualizer default behavior. It was rendering everything with a plain color, which is rather useless. Moreover it wasn't consistent with TBN visualization where you might actually want only the lines rendered and not the triangle.
6 years ago
* Initial value is @cpp 0xffffffff_rgbaf @ce. Expects that
* @ref Flag::Wireframe is enabled.
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
*/
MeshVisualizer2D& setColor(const Color4& color) {
return static_cast<MeshVisualizer2D&>(Implementation::MeshVisualizerBase::setColor(color));
}
/**
* @brief Set wireframe color
* @return Reference to self (for method chaining)
*
* Initial value is @cpp 0x000000ff_rgbaf @ce. Expects that
* @ref Flag::Wireframe is enabled.
*/
MeshVisualizer2D& setWireframeColor(const Color4& color) {
return static_cast<MeshVisualizer2D&>(Implementation::MeshVisualizerBase::setWireframeColor(color));
}
/**
* @brief Set wireframe width
* @return Reference to self (for method chaining)
*
* Value is in screen space (depending on @ref setViewportSize()),
* initial value is @cpp 1.0f @ce. Expects that @ref Flag::Wireframe is
* enabled.
*/
MeshVisualizer2D& setWireframeWidth(Float width) {
return static_cast<MeshVisualizer2D&>(Implementation::MeshVisualizerBase::setWireframeWidth(width));
}
/**
* @brief Set line smoothness
* @return Reference to self (for method chaining)
*
* Value is in screen space (depending on @ref setViewportSize()),
* initial value is @cpp 2.0f @ce. Expects that @ref Flag::Wireframe is
* enabled.
*/
Shaders: tangent space visualization in MeshVisualizer3D.
6 years ago
MeshVisualizer2D& setSmoothness(Float smoothness);
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
private:
Int _transformationProjectionMatrixUniform{0};
};
/**
@brief 3D mesh visualization shader
Shaders: remove MeshVisualizer default behavior. It was rendering everything with a plain color, which is rather useless. Moreover it wasn't consistent with TBN visualization where you might actually want only the lines rendered and not the triangle.
6 years ago
Uses the geometry shader to visualize wireframe or tangent space of 3D meshes.
You need to provide the @ref Position attribute in your triangle mesh at the
very least. Use @ref setTransformationProjectionMatrix(), @ref setColor() and
others to configure the shader.
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
@image html shaders-meshvisualizer3d.png width=256px
Shaders: ported MeshVisualizer to not require geometry shader. Wireframe width and smoothness isn't ported yet, because I don't fully understand the behavior of standard derivatives in fragment shader.
13 years ago
Shaders: remove MeshVisualizer default behavior. It was rendering everything with a plain color, which is rather useless. Moreover it wasn't consistent with TBN visualization where you might actually want only the lines rendered and not the triangle.
6 years ago
The shader expects that you enable either wireframe visualization or tangent
space visualization by passing an appropriate @ref Flag to the constructor ---
there's no default behavior with nothing enabled.
Shaders: documentation update for the new theme. Also made the shader image background transparent to better fit in the docs and updated the images to match site colors.
8 years ago
@section Shaders-MeshVisualizer-wireframe Wireframe visualization
Shaders: ported MeshVisualizer to not require geometry shader. Wireframe width and smoothness isn't ported yet, because I don't fully understand the behavior of standard derivatives in fragment shader.
13 years ago
Removed enum-referencing Doxygen workarounds. In 1.8.5 it is now possible to reference directly to enum member. Hooray! Also added explicit @ref here and there, fixing some referencing bugs along the way.
13 years ago
Wireframe visualization is done by enabling @ref Flag::Wireframe. It is done
Shaders: improve MeshVisualizer docs a bit.
6 years ago
either using geometry shaders or with help of additional vertex information. If
you have geometry shaders available, you don't need to do anything else.
Shaders: ported MeshVisualizer to not require geometry shader. Wireframe width and smoothness isn't ported yet, because I don't fully understand the behavior of standard derivatives in fragment shader.
13 years ago
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
@requires_gl32 Extension @gl_extension{ARB,geometry_shader4} for wireframe
Shaders: ported MeshVisualizer to not require geometry shader. Wireframe width and smoothness isn't ported yet, because I don't fully understand the behavior of standard derivatives in fragment shader.
13 years ago
rendering using geometry shaders.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
@requires_es_extension Extension @gl_extension{EXT,geometry_shader} for
Shaders: ported MeshVisualizer to use geometry shaders also on ES3+AEP. Please note that in ES3 there is a behavioral change -- geometry shader is no longer explicitly disabled, but it is enabled by default and you have to disable it if you don't have the required extension or don't want to use it.
11 years ago
wireframe rendering using geometry shaders.
Shaders: ported MeshVisualizer to not require geometry shader. Wireframe width and smoothness isn't ported yet, because I don't fully understand the behavior of standard derivatives in fragment shader.
13 years ago
Shaders: improve MeshVisualizer docs a bit.
6 years ago
If you don't have geometry shaders, you need to enable @ref Flag::NoGeometryShader
(done by default in OpenGL ES 2.0) and use only **non-indexed** triangle meshes
(see @ref MeshTools::duplicate() for a possible solution). Additionaly, if you
have OpenGL < 3.1 or OpenGL ES 2.0, you need to provide also the
Shaders: documentation improvements.
12 years ago
@ref VertexIndex attribute.
Shaders: ported MeshVisualizer to not require geometry shader. Wireframe width and smoothness isn't ported yet, because I don't fully understand the behavior of standard derivatives in fragment shader.
13 years ago
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
@requires_gles30 Extension @gl_extension{OES,standard_derivatives} for
Shaders: ported MeshVisualizer to use geometry shaders also on ES3+AEP. Please note that in ES3 there is a behavioral change -- geometry shader is no longer explicitly disabled, but it is enabled by default and you have to disable it if you don't have the required extension or don't want to use it.
11 years ago
wireframe rendering without geometry shaders.
Doxygen: renamed \extension[2] to \gl_extension[2]. So it's clear that this is not a Vulkan extension link.
8 years ago
If using geometry shaders on OpenGL ES, @gl_extension{NV,shader_noperspective_interpolation}
Shaders: tangent space visualization in MeshVisualizer3D.
6 years ago
is optionally used for improving line appearance. On desktop OpenGL this is
done implicitly.
Shaders: reorder MeshVisualizer docs.
6 years ago
@subsection Shaders-MeshVisualizer-wireframe-geom Example setup with a geometry shader (desktop GL, OpenGL ES 3.2)
Common mesh setup:
@snippet MagnumShaders.cpp MeshVisualizer-usage-geom1
Common rendering setup:
@snippet MagnumShaders.cpp MeshVisualizer-usage-geom2
@subsection Shaders-MeshVisualizer-wireframe-no-geom Example setup for indexed meshes without a geometry shader
The vertices have to be converted to a non-indexed array first. Mesh setup:
@snippet MagnumShaders.cpp MeshVisualizer-usage-no-geom1
Rendering setup:
@snippet MagnumShaders.cpp MeshVisualizer-usage-no-geom2
@subsection Shaders-MeshVisualizer-usage-wireframe-no-geom-old Wireframe visualization of non-indexed meshes without a geometry shader on older hardware
You need to provide also the @ref VertexIndex attribute. Mesh setup *in
addition to the above*:
@snippet MagnumShaders.cpp MeshVisualizer-usage-no-geom-old
Rendering setup the same as above.
Shaders: tangent space visualization in MeshVisualizer3D.
6 years ago
@section Shaders-MeshVisualizer-tbn Tangent space visualization
On platforms with geometry shaders (desktop GL, OpenGL ES 3.2), the shader is
able to visualize tangents, bitangent and normal direction via colored lines
coming out of vertices (red, green and blue for tangent, bitangent and normal, respectively). This can be enabled together with wireframe visualization,
however note that when both are enabled, the lines are not antialiased to avoid
depth ordering artifacts.
For tangents and normals, you need to provide the @ref Tangent and @ref Normal
attributes and enable @ref Flag::TangentDirection and
@ref Flag::NormalDirection, respectively. If any of the attributes isn't
present, its data are implicitly zero and thus the direction isn't shown ---
which means you don't need to worry about having two active variants of the
shader and switching between either depending on whether tangents are present
or not.
For bitangents however, there are two possible representations --- the more
efficient one is via a fourth component in the tangent attribute that
indicates tangent space handedness, in which case you'll be using the
@ref Tangent4 attribute instead of @ref Tangent, and enable
@ref Flag::BitangentFromTangentDirection. The other, more obvious but less
efficient representation, is a dedicated @ref Bitangent attribute (in which
case you'll enable @ref Flag::BitangentDirection). Note that these two are
mutually exclusive, so you need to choose either of them based on what given
Shaders: reorder MeshVisualizer docs.
6 years ago
mesh contains. Example for the first case:
Shaders: tangent space visualization in MeshVisualizer3D.
6 years ago
@snippet MagnumShaders.cpp MeshVisualizer-usage-tbn1
Rendering setup:
@snippet MagnumShaders.cpp MeshVisualizer-usage-tbn2
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
@see @ref shaders, @ref MeshVisualizer2D
Shaders: ported MeshVisualizer to not require geometry shader. Wireframe width and smoothness isn't ported yet, because I don't fully understand the behavior of standard derivatives in fragment shader.
13 years ago
@todo Understand and add support wireframe width/smoothness without GS
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
*/
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
class MAGNUM_SHADERS_EXPORT MeshVisualizer3D: public Implementation::MeshVisualizerBase {
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
public:
Shaders: there's never enough documentation. Each shader now has sample image, example mesh configuration and example rendering setup. Also properly documented all attribute types and made introductory chapter for whole Shaders namespace.
11 years ago
/**
* @brief Vertex position
*
Doxygen. Doxygen IS BROKEN BEYOND REPAIR. I introduced *strong* enum with values, in a subnamespace, that have the same name as completely unrelated typedefs. Guess what?! It breaks ALL LINKS TO THOSE TYPEDEFS! **EVERYWHERE!!!**
8 years ago
* @ref shaders-generic "Generic attribute",
* @ref Magnum::Vector3 "Vector3".
Shaders: there's never enough documentation. Each shader now has sample image, example mesh configuration and example rendering setup. Also properly documented all attribute types and made introductory chapter for whole Shaders namespace.
11 years ago
*/
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
typedef typename Generic3D::Position Position;
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
Shaders: tangent space visualization in MeshVisualizer3D.
6 years ago
/**
* @brief Tangent direction
* @m_since_latest
*
* @ref shaders-generic "Generic attribute",
* @ref Magnum::Vector3 "Vector3". Use either this or the @ref Tangent4
* attribute. Used only if @ref Flag::TangentDirection is enabled.
*/
typedef typename Generic3D::Tangent Tangent;
/**
* @brief Tangent direction with a bitangent sign
* @m_since_latest
*
* @ref shaders-generic "Generic attribute",
* @ref Magnum::Vector4 "Vector4". Use either this or the @ref Tangent
* attribute. Used only if @ref Flag::TangentDirection or
* @ref Flag::BitangentFromTangentDirection is enabled.
*/
typedef typename Generic3D::Tangent4 Tangent4;
/**
* @brief Bitangent direction
* @m_since_latest
*
* @ref shaders-generic "Generic attribute",
* @ref Magnum::Vector4 "Vector4". Use either this or the @ref Tangent4
* attribute. Used only if @ref Flag::BitangentDirection is enabled.
*/
typedef typename Generic3D::Bitangent Bitangent;
/**
* @brief Normal direction
* @m_since_latest
*
* @ref shaders-generic "Generic attribute",
* @ref Magnum::Vector3 "Vector3". Used only if
* @ref Flag::NormalDirection is enabled.
*/
typedef typename Generic3D::Normal Normal;
Shaders: ported MeshVisualizer to not require geometry shader. Wireframe width and smoothness isn't ported yet, because I don't fully understand the behavior of standard derivatives in fragment shader.
13 years ago
/**
* @brief Vertex index
*
Shaders: there's never enough documentation. Each shader now has sample image, example mesh configuration and example rendering setup. Also properly documented all attribute types and made introductory chapter for whole Shaders namespace.
11 years ago
* @ref Magnum::Float "Float", used only in OpenGL < 3.1 and OpenGL ES
* 2.0 if @ref Flag::Wireframe is enabled. This attribute (modulo 3)
Shaders: documentation update for the new theme. Also made the shader image background transparent to better fit in the docs and updated the images to match site colors.
8 years ago
* specifies index of given vertex in triangle, i.e. @cpp 0.0f @ce for
* first, @cpp 1.0f @ce for second, @cpp 2.0f @ce for third. In OpenGL
Shaders: improve MeshVisualizer docs.
7 years ago
* 3.1, OpenGL ES 3.0 and newer this value is provided via the
* @cb{.glsl} gl_VertexID @ce shader builtin, so the attribute is not
* needed.
Shaders: rethink generic attribute allocation from scratch. This adds binormals, object IDs and instanced transformation, but has to break existing locations in order to provide new guarantees.
6 years ago
*
* @note This attribute uses the same slot as @ref Generic::ObjectId,
* but since Object ID is available only on ES3+ and vertex index
* is used only on ES2 contexts without @glsl gl_VertexID @ce,
* there should be no conflict between these two.
Shaders: ported MeshVisualizer to not require geometry shader. Wireframe width and smoothness isn't ported yet, because I don't fully understand the behavior of standard derivatives in fragment shader.
13 years ago
*/
Shaders: rethink generic attribute allocation from scratch. This adds binormals, object IDs and instanced transformation, but has to break existing locations in order to provide new guarantees.
6 years ago
typedef GL::Attribute<4, Float> VertexIndex;
Shaders: ported MeshVisualizer to not require geometry shader. Wireframe width and smoothness isn't ported yet, because I don't fully understand the behavior of standard derivatives in fragment shader.
13 years ago
Shaders: add ColorOutput constant to all shaders for consistency.
7 years ago
enum: UnsignedInt {
/**
* Color shader output. @ref shaders-generic "Generic output",
* present always. Expects three- or four-component floating-point
* or normalized buffer attachment.
*/
ColorOutput = Generic3D::ColorOutput
};
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
/**
Shaders: removed autolink-preventing % noise.
12 years ago
* @brief Flag
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
*
Shaders: documentation improvements.
12 years ago
* @see @ref Flags, @ref MeshVisualizer()
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
*/
enum class Flag: UnsignedByte {
Shaders: ported MeshVisualizer to not require geometry shader. Wireframe width and smoothness isn't ported yet, because I don't fully understand the behavior of standard derivatives in fragment shader.
13 years ago
/**
Shaders: ported MeshVisualizer to use geometry shaders also on ES3+AEP. Please note that in ES3 there is a behavioral change -- geometry shader is no longer explicitly disabled, but it is enabled by default and you have to disable it if you don't have the required extension or don't want to use it.
11 years ago
* Visualize wireframe. On OpenGL ES 2.0 this also enables
Removed enum-referencing Doxygen workarounds. In 1.8.5 it is now possible to reference directly to enum member. Hooray! Also added explicit @ref here and there, fixing some referencing bugs along the way.
13 years ago
* @ref Flag::NoGeometryShader.
Shaders: ported MeshVisualizer to not require geometry shader. Wireframe width and smoothness isn't ported yet, because I don't fully understand the behavior of standard derivatives in fragment shader.
13 years ago
*/
Shaders: ported MeshVisualizer to use geometry shaders also on ES3+AEP. Please note that in ES3 there is a behavioral change -- geometry shader is no longer explicitly disabled, but it is enabled by default and you have to disable it if you don't have the required extension or don't want to use it.
11 years ago
#ifndef MAGNUM_TARGET_GLES2
Shaders: ported MeshVisualizer to not require geometry shader. Wireframe width and smoothness isn't ported yet, because I don't fully understand the behavior of standard derivatives in fragment shader.
13 years ago
Wireframe = 1 << 0,
#else
Wireframe = (1 << 0) | (1 << 1),
#endif
/**
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
* Don't use a geometry shader for wireframe visualization. If
* enabled, you might need to provide also the @ref VertexIndex
Shaders: improve MeshVisualizer docs.
7 years ago
* attribute in the mesh. In OpenGL ES 2.0 enabled alongside
Shaders: documentation improvements.
12 years ago
* @ref Flag::Wireframe.
Shaders: tangent space visualization in MeshVisualizer3D.
6 years ago
*
* Mutually exclusive with @ref Flag::TangentDirection,
* @ref Flag::BitangentFromTangentDirection,
* @ref Flag::BitangentDirection and @ref Flag::NormalDirection ---
* those need a geometry shader always.
Shaders: ported MeshVisualizer to not require geometry shader. Wireframe width and smoothness isn't ported yet, because I don't fully understand the behavior of standard derivatives in fragment shader.
13 years ago
*/
Shaders: tangent space visualization in MeshVisualizer3D.
6 years ago
NoGeometryShader = 1 << 1,
#if !defined(MAGNUM_TARGET_GLES2) && !defined(MAGNUM_TARGET_WEBGL)
/**
* Visualize tangent direction with red lines pointing out of
* vertices. You need to provide the @ref Tangent or @ref Tangent4
* attribute in the mesh. Mutually exclusive with
* @ref Flag::NoGeometryShader (as this needs a geometry shader
* always).
* @requires_gl32 Extension @gl_extension{ARB,geometry_shader4}
* @requires_gles30 Not defined in OpenGL ES 2.0.
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{EXT,geometry_shader}
* @requires_gles Geometry shaders are not available in WebGL.
* @m_since_latest
*/
TangentDirection = 1 << 2,
/**
* Visualize bitangent direction with green lines pointing out of
* vertices. You need to provide both @ref Normal and @ref Tangent4
* attributes in the mesh, alternatively you can provide the
* @ref Bitangent attribute and enable
* @ref Flag::BitangentDirection instead. Mutually exclusive with
* @ref Flag::NoGeometryShader (as this needs a geometry shader
* always).
* @requires_gl32 Extension @gl_extension{ARB,geometry_shader4}
* @requires_gles30 Not defined in OpenGL ES 2.0.
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{EXT,geometry_shader}
* @requires_gles Geometry shaders are not available in WebGL.
* @m_since_latest
*/
BitangentFromTangentDirection = 1 << 3,
/**
* Visualize bitangent direction with green lines pointing out of
* vertices. You need to provide the @ref Bitangent attribute in
* the mesh, alternatively you can provide both @ref Normal and
* @ref Tangent4 attributes and enable
* @ref Flag::BitangentFromTangentDirection instead. Mutually
* exclusive with @ref Flag::NoGeometryShader (as this needs a
* geometry shader always).
* @requires_gl32 Extension @gl_extension{ARB,geometry_shader4}
* @requires_gles30 Not defined in OpenGL ES 2.0.
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{EXT,geometry_shader}
* @requires_gles Geometry shaders are not available in WebGL.
* @m_since_latest
*/
BitangentDirection = 1 << 4,
/**
* Visualize normal direction with blue lines pointing out of
* vertices. You need to provide the @ref Normal attribute in the
* mesh. Mutually exclusive with @ref Flag::NoGeometryShader (as
* this needs a geometry shader always).
* @requires_gl32 Extension @gl_extension{ARB,geometry_shader4}
* @requires_gles30 Not defined in OpenGL ES 2.0.
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{EXT,geometry_shader}
* @requires_gles Geometry shaders are not available in WebGL.
* @m_since_latest
*/
NormalDirection = 1 << 5
#endif
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
};
Shaders: removed autolink-preventing % noise.
12 years ago
/** @brief Flags */
Removed superfluous template parameter from EnumSet typedefs. Because with GCC 4.7 we can.
12 years ago
typedef Containers::EnumSet<Flag> Flags;
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
/**
* @brief Constructor
Shaders: removed autolink-preventing % noise.
12 years ago
* @param flags Flags
Shaders: remove MeshVisualizer default behavior. It was rendering everything with a plain color, which is rather useless. Moreover it wasn't consistent with TBN visualization where you might actually want only the lines rendered and not the triangle.
6 years ago
*
* At least @ref Flag::Wireframe or one of @ref Flag::TangentDirection,
* @ref Flag::BitangentFromTangentDirection,
* @ref Flag::BitangentDirection, @ref Flag::NormalDirection is
* expected to be enabled.
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
*/
Shaders: remove MeshVisualizer default behavior. It was rendering everything with a plain color, which is rather useless. Moreover it wasn't consistent with TBN visualization where you might actually want only the lines rendered and not the triangle.
6 years ago
explicit MeshVisualizer3D(Flags flags);
#ifdef MAGNUM_BUILD_DEPRECATED
/**
* @brief Constructor
* @m_deprecated_since_latest Use @ref MeshVisualizer3D(Flags) instead.
*/
explicit CORRADE_DEPRECATED("use MeshVisualizer3D(Flags) instead") MeshVisualizer3D(): MeshVisualizer3D{{}} {}
#endif
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
Shaders: added NoCreate constructors to all classes. Makes it possible to have instance of them even before any context is active.
9 years ago
/**
* @brief Construct without creating the underlying OpenGL object
*
Shaders: doc++
7 years ago
* The constructed instance is equivalent to a moved-from state. Useful
Shaders: added NoCreate constructors to all classes. Makes it possible to have instance of them even before any context is active.
9 years ago
* in cases where you will overwrite the instance later anyway. Move
* another object over it to make it useful.
*
* This function can be safely used for constructing (and later
* destructing) objects even without any OpenGL context being active.
doc: hint that Optional is a safer NoCreate.
7 years ago
* However note that this is a low-level and a potentially dangerous
* API, see the documentation of @ref NoCreate for alternatives.
Shaders: added NoCreate constructors to all classes. Makes it possible to have instance of them even before any context is active.
9 years ago
*/
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
explicit MeshVisualizer3D(NoCreateT) noexcept: Implementation::MeshVisualizerBase{NoCreate} {}
Shaders: added NoCreate constructors to all classes. Makes it possible to have instance of them even before any context is active.
9 years ago
Shaders: explicitly list deleted/defaulted copy/move constructor. Two reasons: * documentation * making it actually work because the rules are so complex and ever changing that a thing I thought "just worked" in fact did not work at all The Vector tests now compile again.
8 years ago
/** @brief Copying is not allowed */
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
MeshVisualizer3D(const MeshVisualizer3D&) = delete;
Shaders: explicitly list deleted/defaulted copy/move constructor. Two reasons: * documentation * making it actually work because the rules are so complex and ever changing that a thing I thought "just worked" in fact did not work at all The Vector tests now compile again.
8 years ago
/** @brief Move constructor */
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
MeshVisualizer3D(MeshVisualizer3D&&) noexcept = default;
Shaders: explicitly list deleted/defaulted copy/move constructor. Two reasons: * documentation * making it actually work because the rules are so complex and ever changing that a thing I thought "just worked" in fact did not work at all The Vector tests now compile again.
8 years ago
/** @brief Copying is not allowed */
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
MeshVisualizer3D& operator=(const MeshVisualizer3D&) = delete;
Shaders: explicitly list deleted/defaulted copy/move constructor. Two reasons: * documentation * making it actually work because the rules are so complex and ever changing that a thing I thought "just worked" in fact did not work at all The Vector tests now compile again.
8 years ago
/** @brief Move assignment */
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
MeshVisualizer3D& operator=(MeshVisualizer3D&&) noexcept = default;
Shaders: explicitly list deleted/defaulted copy/move constructor. Two reasons: * documentation * making it actually work because the rules are so complex and ever changing that a thing I thought "just worked" in fact did not work at all The Vector tests now compile again.
8 years ago
Shaders: debug output for all Flag / Flags enums / enum sets.
8 years ago
/** @brief Flags */
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
Flags flags() const {
return reinterpret_cast<const Flags&>(Implementation::MeshVisualizerBase::_flags);
}
Shaders: debug output for all Flag / Flags enums / enum sets.
8 years ago
Shaders: tangent space visualization in MeshVisualizer3D.
6 years ago
#ifdef MAGNUM_BUILD_DEPRECATED
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
/**
* @brief Set transformation and projection matrix
Shaders: tangent space visualization in MeshVisualizer3D.
6 years ago
* @m_deprecated_since_latest Use @ref setTransformationMatrix() and
* @ref setProjectionMatrix() instead.
*/
CORRADE_DEPRECATED("use setTransformationMatrix() and setProjectionMatrix() instead") MeshVisualizer3D& setTransformationProjectionMatrix(const Matrix4& matrix) {
/* Keep projection at identity, which should still work for
wireframe (but of course not for TBN visualization) */
return setTransformationMatrix(matrix);
}
#endif
/**
* @brief Set transformation matrix
Reducing pointer chasings, part 1: method chaining via references. Makes some cases less consistent (and some convenience shortcuts impossible), but goes well with the attitude "don't use pointer when it can't be null".
13 years ago
* @return Reference to self (for method chaining)
Shaders: define reasonable uniform defaults for all shaders. Plus a bit of cleanup / fixing broken English.
8 years ago
*
* Initial value is an identity matrix.
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
*/
Shaders: tangent space visualization in MeshVisualizer3D.
6 years ago
MeshVisualizer3D& setTransformationMatrix(const Matrix4& matrix);
/**
* @brief Set projection matrix
* @return Reference to self (for method chaining)
*
* Initial value is an identity matrix. (i.e., an orthographic
* projection of the default @f$ [ -\boldsymbol{1} ; \boldsymbol{1} ] @f$
* cube).
*/
MeshVisualizer3D& setProjectionMatrix(const Matrix4& matrix);
#if !defined(MAGNUM_TARGET_GLES2) && !defined(MAGNUM_TARGET_WEBGL)
/**
* @brief Set transformation matrix
* @return Reference to self (for method chaining)
* @m_since_latest
*
* Expects that @ref Flag::TangentDirection,
* @ref Flag::BitangentDirection or @ref Flag::NormalDirection is
* enabled. The matrix doesn't need to be normalized, as
* renormalization is done per-fragment anyway.
* Initial value is an identity matrix.
* @requires_gl32 Extension @gl_extension{ARB,geometry_shader4}
* @requires_gles30 Not defined in OpenGL ES 2.0.
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{EXT,geometry_shader}
* @requires_gles Geometry shaders are not available in WebGL.
*/
MeshVisualizer3D& setNormalMatrix(const Matrix3x3& matrix);
#endif
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
/**
* @brief Set viewport size
Reducing pointer chasings, part 1: method chaining via references. Makes some cases less consistent (and some convenience shortcuts impossible), but goes well with the attitude "don't use pointer when it can't be null".
13 years ago
* @return Reference to self (for method chaining)
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
*
Removed enum-referencing Doxygen workarounds. In 1.8.5 it is now possible to reference directly to enum member. Hooray! Also added explicit @ref here and there, fixing some referencing bugs along the way.
13 years ago
* Has effect only if @ref Flag::Wireframe is enabled and geometry
Shaders: tangent space visualization in MeshVisualizer3D.
6 years ago
* shaders are used; or if @ref Flag::TangentDirection,
* @ref Flag::BitangentDirection or @ref Flag::NormalDirection is
* enabled, otherwise it does nothing. Initial value is a zero vector.
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
*/
Shaders: tangent space visualization in MeshVisualizer3D.
6 years ago
MeshVisualizer3D& setViewportSize(const Vector2& size);
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
/**
* @brief Set base object color
Reducing pointer chasings, part 1: method chaining via references. Makes some cases less consistent (and some convenience shortcuts impossible), but goes well with the attitude "don't use pointer when it can't be null".
13 years ago
* @return Reference to self (for method chaining)
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
*
Shaders: remove MeshVisualizer default behavior. It was rendering everything with a plain color, which is rather useless. Moreover it wasn't consistent with TBN visualization where you might actually want only the lines rendered and not the triangle.
6 years ago
* Initial value is @cpp 0xffffffff_rgbaf @ce. Expects that
* @ref Flag::Wireframe is enabled.
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
*/
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
MeshVisualizer3D& setColor(const Color4& color) {
return static_cast<MeshVisualizer3D&>(Implementation::MeshVisualizerBase::setColor(color));
}
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
/**
* @brief Set wireframe color
Reducing pointer chasings, part 1: method chaining via references. Makes some cases less consistent (and some convenience shortcuts impossible), but goes well with the attitude "don't use pointer when it can't be null".
13 years ago
* @return Reference to self (for method chaining)
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
*
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
* Initial value is @cpp 0x000000ff_rgbaf @ce. Expects that
Removed enum-referencing Doxygen workarounds. In 1.8.5 it is now possible to reference directly to enum member. Hooray! Also added explicit @ref here and there, fixing some referencing bugs along the way.
13 years ago
* @ref Flag::Wireframe is enabled.
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
*/
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
MeshVisualizer3D& setWireframeColor(const Color4& color) {
return static_cast<MeshVisualizer3D&>(Implementation::MeshVisualizerBase::setWireframeColor(color));
}
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
/**
* @brief Set wireframe width
Reducing pointer chasings, part 1: method chaining via references. Makes some cases less consistent (and some convenience shortcuts impossible), but goes well with the attitude "don't use pointer when it can't be null".
13 years ago
* @return Reference to self (for method chaining)
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
*
Shaders: tangent space visualization in MeshVisualizer3D.
6 years ago
* Value is in screen space (depending on @ref setViewportSize()),
* initial value is @cpp 1.0f @ce. Expects that @ref Flag::Wireframe is
* enabled.
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
*/
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
MeshVisualizer3D& setWireframeWidth(Float width) {
return static_cast<MeshVisualizer3D&>(Implementation::MeshVisualizerBase::setWireframeWidth(width));
}
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
Shaders: tangent space visualization in MeshVisualizer3D.
6 years ago
#if !defined(MAGNUM_TARGET_GLES2) && !defined(MAGNUM_TARGET_WEBGL)
/**
* @brief Set line width
* @return Reference to self (for method chaining)
* @m_since_latest
*
* Value is in screen space (depending on @ref setViewportSize()),
* initial value is @cpp 1.0f @ce. Expects that
* @ref Flag::TangentDirection,
* @ref Flag::BitangentFromTangentDirection,
* @ref Flag::BitangentDirection or @ref Flag::NormalDirection is
* enabled.
* @requires_gl32 Extension @gl_extension{ARB,geometry_shader4}
* @requires_gles30 Not defined in OpenGL ES 2.0.
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{EXT,geometry_shader}
* @requires_gles Geometry shaders are not available in WebGL.
*/
MeshVisualizer3D& setLineWidth(Float width);
/**
* @brief Set line length
* @return Reference to self (for method chaining)
* @m_since_latest
*
* Value is in object space, initial value is @cpp 1.0f @ce. Expects
* that @ref Flag::TangentDirection,
* @ref Flag::BitangentFromTangentDirection,
* @ref Flag::BitangentDirection or @ref Flag::NormalDirection is
* enabled.
* @requires_gl32 Extension @gl_extension{ARB,geometry_shader4}
* @requires_gles30 Not defined in OpenGL ES 2.0.
* @requires_gles32 Extension @gl_extension{ANDROID,extension_pack_es31a} /
* @gl_extension{EXT,geometry_shader}
* @requires_gles Geometry shaders are not available in WebGL.
*/
MeshVisualizer3D& setLineLength(Float length);
#endif
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
/**
* @brief Set line smoothness
Reducing pointer chasings, part 1: method chaining via references. Makes some cases less consistent (and some convenience shortcuts impossible), but goes well with the attitude "don't use pointer when it can't be null".
13 years ago
* @return Reference to self (for method chaining)
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
*
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
* Value is in screen space (depending on @ref setViewportSize()),
Shaders: tangent space visualization in MeshVisualizer3D.
6 years ago
* initial value is @cpp 2.0f @ce. Expects that @ref Flag::Wireframe,
* @ref Flag::TangentDirection,
* @ref Flag::BitangentFromTangentDirection,
* @ref Flag::BitangentDirection or @ref Flag::NormalDirection is
* enabled.
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
*/
Shaders: tangent space visualization in MeshVisualizer3D.
6 years ago
MeshVisualizer3D& setSmoothness(Float smoothness);
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
private:
Shaders: tangent space visualization in MeshVisualizer3D.
6 years ago
Int _transformationMatrixUniform{0},
_projectionMatrixUniform{6};
#if !defined(MAGNUM_TARGET_GLES2) && !defined(MAGNUM_TARGET_WEBGL)
Int _normalMatrixUniform{7},
_lineWidthUniform{8},
_lineLengthUniform{9};
#endif
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
};
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
#ifdef MAGNUM_BUILD_DEPRECATED
/**
@brief 3D mesh visualizer shader
@m_deprecated_since_latest Use @ref MeshVisualizer3D instead.
*/
typedef CORRADE_DEPRECATED("use MeshVisualizer3D instead") MeshVisualizer3D MeshVisualizer;
#endif
/** @debugoperatorclassenum{MeshVisualizer2D,MeshVisualizer2D::Flag} */
MAGNUM_SHADERS_EXPORT Debug& operator<<(Debug& debug, MeshVisualizer2D::Flag value);
/** @debugoperatorclassenum{MeshVisualizer3D,MeshVisualizer3D::Flag} */
MAGNUM_SHADERS_EXPORT Debug& operator<<(Debug& debug, MeshVisualizer3D::Flag value);
/** @debugoperatorclassenum{MeshVisualizer2D,MeshVisualizer2D::Flags} */
MAGNUM_SHADERS_EXPORT Debug& operator<<(Debug& debug, MeshVisualizer2D::Flags value);
Shaders: debug output for all Flag / Flags enums / enum sets.
8 years ago
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
/** @debugoperatorclassenum{MeshVisualizer3D,MeshVisualizer3D::Flags} */
MAGNUM_SHADERS_EXPORT Debug& operator<<(Debug& debug, MeshVisualizer3D::Flags value);
Shaders: debug output for all Flag / Flags enums / enum sets.
8 years ago
Shaders: add a 2D variant of MeshVisualizer.
6 years ago
CORRADE_ENUMSET_OPERATORS(MeshVisualizer2D::Flags)
CORRADE_ENUMSET_OPERATORS(MeshVisualizer3D::Flags)
Shaders: added first version of MeshVisualizer shader. Rudely written to work only with fairly recent extensions and nothing less than GLSL 3.30. It requires geometry shaders for wireframe rendering, without it it behaves the same as Shaders::Flat.
13 years ago
}}
#endif