QVM: Quaternions, Vectors, Matrices

mat_traits

#include <boost/qvm/mat_traits.hpp>[ORIG_END] -->

namespace boost
{
    namespace qvm
    {
        template <class M>
        struct mat_traits
        {
            /*main template members unspecified*/
        };
        
        /*
        User-defined (possibly partial) specializations:
        
        template <>
        struct mat_traits<M>
        {
            static int const rows = /*user-defined*/;        
            static int const cols = /*user-defined*/;        
            typedef /*user-defined*/ scalar_type;        
        
            template <int R,int C> static inline scalar_type read_element( Matrix const & m );        
            template <int R,int C> static inline scalar_type & write_element( Matrix & m );        
        
            static inline scalar_type read_element_idx( int r, int c, Matrix const & m );        
            static inline scalar_type & write_element_idx( int r, int c, Matrix & m );        
        };
        */
    }
}

Шаблонmat_traitsдолжен быть специализирован для (определяемых пользователем) типов матриц, чтобы включить векторные и матричные операции, определенные в заголовках Boost QVM для объектов этих типов.

Примечание:Типы матриц не требуются для копирования.

Основныеmat_traitsчлены шаблона не указаны. Для определения следующих членов требуются действительные специализации:

ряды: выражениеmat_traits::рядынеобходимо оценить до целочисленной константы времени компиляции, превышающей 0, которая определяет число строк в матрице.
Колзнеобходимо оценить до целочисленной константы времени компиляции, превышающей 0, которая определяет число столбцов в матрице.
scalar_type: выражениеmat_traits::scalar_typeдолжно быть значением типа, удовлетворяющимскалярным требованиям.

Кроме того, действующие специализацииmat_traitsшаблон может определять следующие функции доступа в качестве статических элементов, гдеmявляется объектом типаМатрица,RиCявляются целочисленными константами времени компиляции, аrиcявляются переменными типаint:

читать элемент: выражениеmat_traits::read_element(m)возвращает либо копию, либо ссылку на элемент в строкеRи столбцеCm.
напишите_элемент: выражениеmat_traits::write_element(m)возвращает изменчивую ссылку на элемент в строкеRи столбцеCm.
читать_element_idx: выражениеmat_traits::read_element_idx(r,c,m)возвращает либо копию, либо ссылку на элемент в строкеrи столбцеcm.
write_element_idx: выражениеmat_traits::write_element_idx(r,c,m)возвращает изменяемую ссылку на элемент в строкеrи столбцеcm.

Незаконно называть любую из вышеперечисленных функций, еслине является_mat::valueявляетсяистинной. Даже в этом случае типы матриц могут определять только подмножество функций доступа. Общими требованиями являются:

По крайней мере, один изread_elementилиwrite_elementдолжен быть определен;
Если определенread_element_idx,read_elementтакже должен быть определен;
Еслиwrite_element_idxопределено,write_elementтакже должно быть определено.

Ниже приведен пример определяемого пользователем типа матрицы 3x3 и соответствующей ему специализации шаблонаmat_traits:

#include <boost/qvm/mat_traits.hpp>
struct float33 { float a[3][3]; };
namespace boost
{
    namespace qvm
    {
        template <>
        struct mat_traits<float33>
        {
            static int const rows=3;
            static int const cols=3;
            typedef float scalar_type;
            template <int R,int C> static inline scalar_type & write_element( float33 & m ) { return m.a[R][C]; }
            template <int R,int C> static inline scalar_type read_element( float33 const & m ) { return m.a[R][C]; }
            static inline scalar_type & write_element_idx( int r, int c, float33 & m ) { return m.a[r][c]; }
            static inline scalar_type read_element_idx( int r, int c, float33 const & m ) { return m.a[r][c]; }
        };
    }
}

Статья mat_traits раздела может быть полезна для разработчиков на c++ и boost.

mat_traits

Boost , ,

Boost C++ Libraries

QVM: Quaternions, Vectors, Matrices

mat_traits