#ifndef Magnum_Swizzle_h #define Magnum_Swizzle_h /* Copyright © 2010, 2011, 2012 Vladimír Vondruš This file is part of Magnum. Magnum is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License version 3 only, as published by the Free Software Foundation. Magnum is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License version 3 for more details. */ /** @file * @brief Functions Magnum::swizzle(const T&), Magnum::swizzle(const T&, const char(&)[]) */ #include "Color.h" namespace Magnum { #ifndef DOXYGEN_GENERATING_OUTPUT namespace Implementation { using Math::Implementation::Sequence; using Math::Implementation::GenerateSequence; template struct ComponentAtPosition { static_assert(size > position, "Swizzle parameter out of range of base vector"); template inline constexpr static T value(const Math::Vector& vector) { return vector[position]; } }; template struct Component {}; template struct Component: public ComponentAtPosition {}; template struct Component: public ComponentAtPosition {}; template struct Component: public ComponentAtPosition {}; template struct Component: public ComponentAtPosition {}; template struct Component: public ComponentAtPosition {}; template struct Component: public ComponentAtPosition {}; template struct Component: public ComponentAtPosition {}; template struct Component: public ComponentAtPosition {}; template struct Component { template inline constexpr static T value(const Math::Vector&) { return T(0); } }; template struct Component { template inline constexpr static T value(const Math::Vector&) { return T(1); } }; template struct TypeForSize { typedef Math::Vector Type; }; template struct TypeForSize<2, T> { typedef Math::Vector2 Type; }; template struct TypeForSize<3, T> { typedef Math::Vector3 Type; }; template struct TypeForSize<4, T> { typedef Math::Vector4 Type; }; template struct TypeForSize<3, Color3> { typedef Color3 Type; }; template struct TypeForSize<3, Color4> { typedef Color3 Type; }; template struct TypeForSize<4, Color3> { typedef Color4 Type; }; template struct TypeForSize<4, Color4> { typedef Color4 Type; }; template inline constexpr T componentAtPosition(const Math::Vector& vector, std::size_t position) { return size > position ? vector[position] : throw; } template inline constexpr T component(const Math::Vector& vector, char component) { return component == 'x' ? componentAtPosition(vector, 0) : component == 'y' ? componentAtPosition(vector, 1) : component == 'z' ? componentAtPosition(vector, 2) : component == 'w' ? componentAtPosition(vector, 3) : component == 'r' ? componentAtPosition(vector, 0) : component == 'g' ? componentAtPosition(vector, 1) : component == 'b' ? componentAtPosition(vector, 2) : component == 'a' ? componentAtPosition(vector, 3) : component == '0' ? T(0) : component == '1' ? T(1) : throw; } template inline constexpr Math::Vector swizzleFrom(Sequence, const Math::Vector& vector, const char(&components)[sizeof...(sequence)+1]) { return {component(vector, components[sequence])...}; } } #endif /** @brief Swizzle Vector components Creates new vector from given components. Example: @code Vector4 original(-1, 2, 3, 4); auto vec = swizzle<'a', '1', '0', 'r', 'g', 'b'>(original); // vec == { 4, 1, 0, -1, 2, 3 } @endcode You can use letters `x`, `y`, `z`, `w` and `r`, `g`, `b`, `a` for addressing components or letters `0` and `1` for zero and one. Count of elements is unlimited, but must be at least one. If the resulting vector is two, three or four-component, corresponding Vector2, Vector3, Vector4, Color3 or Color4 specialization is returned. @attention This function is less convenient to write than swizzle(const T&, const char(&)[newSize]), but the evaluation of the swizzling operation is guaranteed to be always done at compile time instead of at runtime. @see @ref matrix-vector-component-access, Vector4::xyz(), Color4::rgb(), Vector4::xy(), Vector3::xy() */ template inline constexpr typename Implementation::TypeForSize::Type swizzle(const T& vector) { return {Implementation::Component::value(vector)...}; } /** @brief Swizzle Vector components Creates new vector from given components. Example: @code Vector4 original(-1, 2, 3, 4); auto vec = swizzle(original, "a10rgb"); // vec == { 4, 1, 0, -1, 2, 3 } @endcode You can use letters `x`, `y`, `z`, `w` and `r`, `g`, `b`, `a` for addressing components or letters `0` and `1` for zero and one. Count of elements is unlimited, but must be at least one. If the resulting vector is two, three or four-component, corresponding Vector2, Vector3 or Vector4 specialization is returned. @attention This function is more convenient to write than swizzle(const T&), but unless the result is marked with `constexpr`, the evaluation of the swizzling operation probably won't be evaluated at compile time, but at runtime. @see @ref matrix-vector-component-access, Vector4::xyz(), Color4::rgb(), Vector4::xy(), Vector3::xy() */ template inline constexpr typename Implementation::TypeForSize::Type swizzle(const T& vector, const char(&components)[newSize]) { return Implementation::swizzleFrom(typename Implementation::GenerateSequence::Type(), vector, components); } } #endif