|
|
|
|
#ifndef Magnum_SceneGraph_SceneGraph_h
|
|
|
|
|
#define Magnum_SceneGraph_SceneGraph_h
|
|
|
|
|
/*
|
|
|
|
|
This file is part of Magnum.
|
|
|
|
|
|
|
|
|
|
Copyright © 2010, 2011, 2012, 2013, 2014, 2015
|
|
|
|
|
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 Forward declarations for @ref Magnum::SceneGraph namespace
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
#include "Magnum/Types.h"
|
|
|
|
|
|
SceneGraph: generalized camera implementation.
The camera now accepts generic projection matrix instead of providing
functions for setting orthographic/perspective projection. This allowed
to completely get rid of the AbstractCamera->Camera*D inheritance
hierarchy and everything is now done through one templated Camera class.
The Camera2D::setProjection(), Camera3D::setOrthographic() and
Camera3D::setPerspective() are deprecated, use
Camera*D::setProjectionMatrix() in combination with
Matrix3::projection(), Matrix4::orthographicProjection() and
Matrix4::perspectiveProjection() instead.
The Camera3D::near() and Camera3D::far() getters are removed. The user
is advised to cache the values on application side if they are really
needed. More general queries for all six clipping planes (*not*
distance) might be implemented later.
The AbstractCamera, AbstractBasicCamera2D, AbstractBaseicCamera3D,
AbstractCamera2D and AbstractCamera3D types are deprecated as there is
no such type anymore, use Camera, BasicCamera2D, BasicCamera3D, Camera2D
and Camera3D instead.
The AbstractCamera.h, AbstractCamera.hpp, Camera2D.h, Camera2D.hpp,
Camera3D.h and Camera3D.hpp headers are deprecated, use Camera.h and
Camera.hpp instead.
As always, all deprecated features will be removed in some future
release.
11 years ago
|
|
|
#ifdef MAGNUM_BUILD_DEPRECATED
|
|
|
|
|
#include <Corrade/Utility/Macros.h>
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
namespace Magnum { namespace SceneGraph {
|
|
|
|
|
|
|
|
|
|
#ifndef DOXYGEN_GENERATING_OUTPUT
|
|
|
|
|
enum class AspectRatioPolicy: UnsignedByte;
|
|
|
|
|
|
|
|
|
|
/* Enum CachedTransformation and CachedTransformations used only directly */
|
|
|
|
|
|
|
|
|
|
template<UnsignedInt, class> class AbstractFeature;
|
|
|
|
|
template<class T> using AbstractBasicFeature2D = AbstractFeature<2, T>;
|
|
|
|
|
template<class T> using AbstractBasicFeature3D = AbstractFeature<3, T>;
|
|
|
|
|
typedef AbstractBasicFeature2D<Float> AbstractFeature2D;
|
|
|
|
|
typedef AbstractBasicFeature3D<Float> AbstractFeature3D;
|
|
|
|
|
|
|
|
|
|
/* AbstractFeatureGroup shouldn't be used directly */
|
|
|
|
|
|
|
|
|
|
template<UnsignedInt, class, class> class AbstractGroupedFeature;
|
|
|
|
|
template<class Derived, class T> using AbstractBasicGroupedFeature2D = AbstractGroupedFeature<2, Derived, T>;
|
|
|
|
|
template<class Derived, class T> using AbstractBasicGroupedFeature3D = AbstractGroupedFeature<3, Derived, T>;
|
|
|
|
|
template<class Derived> using AbstractGroupedFeature2D = AbstractBasicGroupedFeature2D<Derived, Float>;
|
|
|
|
|
template<class Derived> using AbstractGroupedFeature3D = AbstractBasicGroupedFeature3D<Derived, Float>;
|
|
|
|
|
|
|
|
|
|
template<UnsignedInt, class> class AbstractObject;
|
|
|
|
|
template<class T> using AbstractBasicObject2D = AbstractObject<2, T>;
|
|
|
|
|
template<class T> using AbstractBasicObject3D = AbstractObject<3, T>;
|
|
|
|
|
typedef AbstractBasicObject2D<Float> AbstractObject2D;
|
|
|
|
|
typedef AbstractBasicObject3D<Float> AbstractObject3D;
|
|
|
|
|
|
|
|
|
|
template<UnsignedInt, class> class AbstractTransformation;
|
|
|
|
|
template<class T> using AbstractBasicTransformation2D = AbstractTransformation<2, T>;
|
|
|
|
|
template<class T> using AbstractBasicTransformation3D = AbstractTransformation<3, T>;
|
|
|
|
|
typedef AbstractBasicTransformation2D<Float> AbstractTransformation2D;
|
|
|
|
|
typedef AbstractBasicTransformation3D<Float> AbstractTransformation3D;
|
|
|
|
|
|
|
|
|
|
template<UnsignedInt, class T, class = T> class AbstractTranslation;
|
|
|
|
|
template<class T, class TranslationType = T> using AbstractBasicTranslation2D = AbstractTranslation<2, T, TranslationType>;
|
|
|
|
|
template<class T, class TranslationType = T> using AbstractBasicTranslation3D = AbstractTranslation<3, T, TranslationType>;
|
|
|
|
|
typedef AbstractBasicTranslation2D<Float> AbstractTranslation2D;
|
|
|
|
|
typedef AbstractBasicTranslation3D<Float> AbstractTranslation3D;
|
|
|
|
|
|
|
|
|
|
template<class> class AbstractBasicTranslationRotation2D;
|
|
|
|
|
template<class> class AbstractBasicTranslationRotation3D;
|
|
|
|
|
typedef AbstractBasicTranslationRotation2D<Float> AbstractTranslationRotation2D;
|
|
|
|
|
typedef AbstractBasicTranslationRotation3D<Float> AbstractTranslationRotation3D;
|
|
|
|
|
|
|
|
|
|
template<class> class AbstractBasicTranslationRotationScaling2D;
|
|
|
|
|
template<class> class AbstractBasicTranslationRotationScaling3D;
|
|
|
|
|
typedef AbstractBasicTranslationRotationScaling2D<Float> AbstractTranslationRotationScaling2D;
|
|
|
|
|
typedef AbstractBasicTranslationRotationScaling3D<Float> AbstractTranslationRotationScaling3D;
|
|
|
|
|
|
|
|
|
|
template<UnsignedInt, class> class Animable;
|
|
|
|
|
template<class T> using BasicAnimable2D = Animable<2, T>;
|
|
|
|
|
template<class T> using BasicAnimable3D = Animable<3, T>;
|
|
|
|
|
typedef BasicAnimable2D<Float> Animable2D;
|
|
|
|
|
typedef BasicAnimable3D<Float> Animable3D;
|
|
|
|
|
|
|
|
|
|
enum class AnimationState: UnsignedByte;
|
|
|
|
|
|
|
|
|
|
template<UnsignedInt, class> class AnimableGroup;
|
|
|
|
|
template<class T> using BasicAnimableGroup2D = AnimableGroup<2, T>;
|
|
|
|
|
template<class T> using BasicAnimableGroup3D = AnimableGroup<3, T>;
|
|
|
|
|
typedef BasicAnimableGroup2D<Float> AnimableGroup2D;
|
|
|
|
|
typedef BasicAnimableGroup3D<Float> AnimableGroup3D;
|
|
|
|
|
|
SceneGraph: generalized camera implementation.
The camera now accepts generic projection matrix instead of providing
functions for setting orthographic/perspective projection. This allowed
to completely get rid of the AbstractCamera->Camera*D inheritance
hierarchy and everything is now done through one templated Camera class.
The Camera2D::setProjection(), Camera3D::setOrthographic() and
Camera3D::setPerspective() are deprecated, use
Camera*D::setProjectionMatrix() in combination with
Matrix3::projection(), Matrix4::orthographicProjection() and
Matrix4::perspectiveProjection() instead.
The Camera3D::near() and Camera3D::far() getters are removed. The user
is advised to cache the values on application side if they are really
needed. More general queries for all six clipping planes (*not*
distance) might be implemented later.
The AbstractCamera, AbstractBasicCamera2D, AbstractBaseicCamera3D,
AbstractCamera2D and AbstractCamera3D types are deprecated as there is
no such type anymore, use Camera, BasicCamera2D, BasicCamera3D, Camera2D
and Camera3D instead.
The AbstractCamera.h, AbstractCamera.hpp, Camera2D.h, Camera2D.hpp,
Camera3D.h and Camera3D.hpp headers are deprecated, use Camera.h and
Camera.hpp instead.
As always, all deprecated features will be removed in some future
release.
11 years ago
|
|
|
template<UnsignedInt, class> class Camera;
|
|
|
|
|
template<class T> using BasicCamera2D = Camera<2, T>;
|
|
|
|
|
template<class T> using BasicCamera3D = Camera<3, T>;
|
|
|
|
|
typedef BasicCamera2D<Float> Camera2D;
|
|
|
|
|
typedef BasicCamera3D<Float> Camera3D;
|
|
|
|
|
|
SceneGraph: generalized camera implementation.
The camera now accepts generic projection matrix instead of providing
functions for setting orthographic/perspective projection. This allowed
to completely get rid of the AbstractCamera->Camera*D inheritance
hierarchy and everything is now done through one templated Camera class.
The Camera2D::setProjection(), Camera3D::setOrthographic() and
Camera3D::setPerspective() are deprecated, use
Camera*D::setProjectionMatrix() in combination with
Matrix3::projection(), Matrix4::orthographicProjection() and
Matrix4::perspectiveProjection() instead.
The Camera3D::near() and Camera3D::far() getters are removed. The user
is advised to cache the values on application side if they are really
needed. More general queries for all six clipping planes (*not*
distance) might be implemented later.
The AbstractCamera, AbstractBasicCamera2D, AbstractBaseicCamera3D,
AbstractCamera2D and AbstractCamera3D types are deprecated as there is
no such type anymore, use Camera, BasicCamera2D, BasicCamera3D, Camera2D
and Camera3D instead.
The AbstractCamera.h, AbstractCamera.hpp, Camera2D.h, Camera2D.hpp,
Camera3D.h and Camera3D.hpp headers are deprecated, use Camera.h and
Camera.hpp instead.
As always, all deprecated features will be removed in some future
release.
11 years ago
|
|
|
#ifdef MAGNUM_BUILD_DEPRECATED
|
|
|
|
|
template<UnsignedInt dimensions, class T> using AbstractCamera CORRADE_DEPRECATED_ALIAS("use BasicCamera2D instead") = Camera<dimensions, T>;
|
|
|
|
|
template<class T> using AbstractBasicCamera2D CORRADE_DEPRECATED_ALIAS("use BasicCamera2D instead") = BasicCamera2D<T>;
|
SceneGraph: generalized camera implementation.
The camera now accepts generic projection matrix instead of providing
functions for setting orthographic/perspective projection. This allowed
to completely get rid of the AbstractCamera->Camera*D inheritance
hierarchy and everything is now done through one templated Camera class.
The Camera2D::setProjection(), Camera3D::setOrthographic() and
Camera3D::setPerspective() are deprecated, use
Camera*D::setProjectionMatrix() in combination with
Matrix3::projection(), Matrix4::orthographicProjection() and
Matrix4::perspectiveProjection() instead.
The Camera3D::near() and Camera3D::far() getters are removed. The user
is advised to cache the values on application side if they are really
needed. More general queries for all six clipping planes (*not*
distance) might be implemented later.
The AbstractCamera, AbstractBasicCamera2D, AbstractBaseicCamera3D,
AbstractCamera2D and AbstractCamera3D types are deprecated as there is
no such type anymore, use Camera, BasicCamera2D, BasicCamera3D, Camera2D
and Camera3D instead.
The AbstractCamera.h, AbstractCamera.hpp, Camera2D.h, Camera2D.hpp,
Camera3D.h and Camera3D.hpp headers are deprecated, use Camera.h and
Camera.hpp instead.
As always, all deprecated features will be removed in some future
release.
11 years ago
|
|
|
CORRADE_DEPRECATED("use Camera2D instead") typedef Camera2D AbstractCamera2D;
|
|
|
|
|
template<class T> using AbstractBasicCamera3D CORRADE_DEPRECATED_ALIAS("use BasicCamera3D instead") = BasicCamera3D<T>;
|
SceneGraph: generalized camera implementation.
The camera now accepts generic projection matrix instead of providing
functions for setting orthographic/perspective projection. This allowed
to completely get rid of the AbstractCamera->Camera*D inheritance
hierarchy and everything is now done through one templated Camera class.
The Camera2D::setProjection(), Camera3D::setOrthographic() and
Camera3D::setPerspective() are deprecated, use
Camera*D::setProjectionMatrix() in combination with
Matrix3::projection(), Matrix4::orthographicProjection() and
Matrix4::perspectiveProjection() instead.
The Camera3D::near() and Camera3D::far() getters are removed. The user
is advised to cache the values on application side if they are really
needed. More general queries for all six clipping planes (*not*
distance) might be implemented later.
The AbstractCamera, AbstractBasicCamera2D, AbstractBaseicCamera3D,
AbstractCamera2D and AbstractCamera3D types are deprecated as there is
no such type anymore, use Camera, BasicCamera2D, BasicCamera3D, Camera2D
and Camera3D instead.
The AbstractCamera.h, AbstractCamera.hpp, Camera2D.h, Camera2D.hpp,
Camera3D.h and Camera3D.hpp headers are deprecated, use Camera.h and
Camera.hpp instead.
As always, all deprecated features will be removed in some future
release.
11 years ago
|
|
|
CORRADE_DEPRECATED("use Camera3D instead") typedef Camera3D AbstractCamera3D;
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
template<UnsignedInt, class> class Drawable;
|
|
|
|
|
template<class T> using BasicDrawable2D = Drawable<2, T>;
|
|
|
|
|
template<class T> using BasicDrawable3D = Drawable<3, T>;
|
|
|
|
|
typedef BasicDrawable2D<Float> Drawable2D;
|
|
|
|
|
typedef BasicDrawable3D<Float> Drawable3D;
|
|
|
|
|
|
|
|
|
|
template<class> class BasicDualComplexTransformation;
|
|
|
|
|
template<class> class BasicDualQuaternionTransformation;
|
|
|
|
|
typedef BasicDualComplexTransformation<Float> DualComplexTransformation;
|
|
|
|
|
typedef BasicDualQuaternionTransformation<Float> DualQuaternionTransformation;
|
|
|
|
|
|
|
|
|
|
template<UnsignedInt, class, class> class FeatureGroup;
|
|
|
|
|
template<class Feature, class T> using BasicFeatureGroup2D = FeatureGroup<2, Feature, T>;
|
|
|
|
|
template<class Feature, class T> using BasicFeatureGroup3D = FeatureGroup<3, Feature, T>;
|
|
|
|
|
template<class Feature> using FeatureGroup2D = BasicFeatureGroup2D<Feature, Float>;
|
|
|
|
|
template<class Feature> using FeatureGroup3D = BasicFeatureGroup3D<Feature, Float>;
|
|
|
|
|
|
|
|
|
|
template<UnsignedInt dimensions, class T> using DrawableGroup = FeatureGroup<dimensions, Drawable<dimensions, T>, T>;
|
|
|
|
|
template<class T> using BasicDrawableGroup2D = DrawableGroup<2, T>;
|
|
|
|
|
template<class T> using BasicDrawableGroup3D = DrawableGroup<3, T>;
|
|
|
|
|
typedef BasicDrawableGroup2D<Float> DrawableGroup2D;
|
|
|
|
|
typedef BasicDrawableGroup3D<Float> DrawableGroup3D;
|
|
|
|
|
|
|
|
|
|
template<class> class BasicMatrixTransformation2D;
|
|
|
|
|
template<class> class BasicMatrixTransformation3D;
|
|
|
|
|
typedef BasicMatrixTransformation2D<Float> MatrixTransformation2D;
|
|
|
|
|
typedef BasicMatrixTransformation3D<Float> MatrixTransformation3D;
|
|
|
|
|
|
|
|
|
|
template<class Transformation> class Object;
|
|
|
|
|
|
|
|
|
|
template<class> class BasicRigidMatrixTransformation2D;
|
|
|
|
|
template<class> class BasicRigidMatrixTransformation3D;
|
|
|
|
|
typedef BasicRigidMatrixTransformation2D<Float> RigidMatrixTransformation2D;
|
|
|
|
|
typedef BasicRigidMatrixTransformation3D<Float> RigidMatrixTransformation3D;
|
|
|
|
|
|
|
|
|
|
template<class Transformation> class Scene;
|
|
|
|
|
|
|
|
|
|
template<UnsignedInt, class T, class = T> class TranslationTransformation;
|
|
|
|
|
template<class T, class TranslationType = T> using BasicTranslationTransformation2D = TranslationTransformation<2, T, TranslationType>;
|
|
|
|
|
template<class T, class TranslationType = T> using BasicTranslationTransformation3D = TranslationTransformation<3, T, TranslationType>;
|
|
|
|
|
typedef BasicTranslationTransformation2D<Float> TranslationTransformation2D;
|
|
|
|
|
typedef BasicTranslationTransformation3D<Float> TranslationTransformation3D;
|
|
|
|
|
|
|
|
|
|
namespace Implementation {
|
|
|
|
|
template<class> struct Transformation;
|
|
|
|
|
}
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
}}
|
|
|
|
|
|
|
|
|
|
#endif
|