HOM/HOM_Matrix4.h

Go to the documentation of this file.

/*
 * PROPRIETARY INFORMATION.  This software is proprietary to
 * Side Effects Software Inc., and is not to be reproduced,
 * transmitted, or disclosed in any way without written permission.
 *
 * Produced by:
 *      Side Effects Software Inc
 *      123 Front Street West, Suite 1401
 *      Toronto, Ontario
 *      Canada   M5J 2M2
 *      416-504-9876
 *
 * COMMENTS:
 */

#ifndef __HOM_Matrix4_h__
#define __HOM_Matrix4_h__

#include "HOM_API.h"
#include "HOM_Defines.h"
#include "HOM_Errors.h"
#include "HOM_Module.h"
#include "HOM_Vector3.h"
#include "HOM_Matrix3.h"
#include <UT/UT_DMatrix4.h>
#include <vector>
#include <stdexcept>

SWIGOUT(%rename(Matrix4) HOM_Matrix4;)

class HOM_API HOM_Matrix4
{
public:
    HOM_Matrix4() throw(HOM_Error)
    {
        HOM_CONSTRUCT_OBJECT(this)
        myMatrix4.zero();
    }
    HOM_Matrix4(double diagonal_value) throw(HOM_Error)
    {
        HOM_CONSTRUCT_OBJECT(this)
        myMatrix4 = diagonal_value;
    }
    HOM_Matrix4(const std::vector<double> &values)
        throw(HOM_InvalidSize, HOM_Error)
    {
        HOM_CONSTRUCT_OBJECT(this);
        setTo(values);
    }
    HOM_Matrix4(const std::vector<std::vector<double> > &values)
        throw(HOM_InvalidSize, HOM_Error)
    {
        HOM_CONSTRUCT_OBJECT(this);
        setTo(values);
    }
    HOM_Matrix4(HOM_Matrix3 &matrix3)
    {
        HOM_CONSTRUCT_OBJECT(this);
        myMatrix4 = matrix3.myMatrix3;
    }

    SWIGOUT(%ignore HOM_Matrix4(const UT_DMatrix4&);)
    HOM_Matrix4(const UT_DMatrix4 &matrix4) throw(HOM_Error)
    : myMatrix4(matrix4)
    { HOM_CONSTRUCT_OBJECT(this) }

    ~HOM_Matrix4()
    { HOM_DESTRUCT_OBJECT(this) }

    bool operator==(HOM_Matrix4 &matrix4)
    { return myMatrix4 == matrix4.myMatrix4; }

    bool operator!=(HOM_Matrix4 &matrix4)
    { return myMatrix4 != matrix4.myMatrix4; }

    bool isAlmostEqual(HOM_Matrix4 &matrix4, double tolerance=0.00001);

    int __hash__();
    std::string __str__();
    std::string __repr__();

    SWIGOUT(%ignore operator=;)
    HOM_Matrix4 &operator=(const std::vector<std::vector<double> > &sequence)
        throw(HOM_InvalidSize);
    HOM_Matrix4 &operator=(const HOM_Matrix4& matrix4)
    {
        myMatrix4 = matrix4.myMatrix4;
        return *this;
    }

    double at(int row, int col) throw(std::out_of_range);

    SWIGPYTHONOUT(%feature("autodoc",
        "asTuple(self) -> tuple of floats") asTuple;)
    std::vector<double> asTuple();

    SWIGPYTHONOUT(%feature("autodoc",
        "asTupleOfTuples(self) -> tuple of tuple of floats") asTupleOfTuples;)
    std::vector<std::vector<double> > asTupleOfTuples();

    void setAt(int row, int col, double value) throw(std::out_of_range);
    void setTo(const std::vector<double> &sequence) throw(HOM_InvalidSize);
    void setTo(const std::vector<std::vector<double> > &sequence)
        throw(HOM_InvalidSize);

    void setToIdentity()
    { myMatrix4.identity(); }

    void setToZero()
    { myMatrix4.zero(); }

    HOM_Matrix4 __add__(HOM_Matrix4 &matrix4)
    { return HOM_Matrix4(myMatrix4 + matrix4.myMatrix4); }
    HOM_Matrix4 __sub__(HOM_Matrix4 &matrix4)
    { return HOM_Matrix4(myMatrix4 - matrix4.myMatrix4); }
    HOM_Matrix4 __mul__(HOM_Matrix4 &matrix4)
    { return HOM_Matrix4(myMatrix4 * matrix4.myMatrix4); }
    HOM_Matrix4 __mul__(double scalar)
    { return HOM_Matrix4(myMatrix4 * scalar); }
    HOM_Matrix4 preMult(HOM_Matrix4 &matrix4)
    { return HOM_Matrix4(matrix4.myMatrix4 * myMatrix4); }

    HOM_Matrix4 transposed();
    HOM_Matrix4 inverted() throw(HOM_OperationFailed);
    double determinant()
    { return myMatrix4.determinant(); }

    SWIGPYTHONOUT(%feature("autodoc",
        "explode(self, transform_order='srt', rotate_order='xyz') -> dict of string to Vector3") explode;)
    SWIGOUT(%kwargs explode;)
    std::map<std::string, HOM_Vector3> explode(
            const char *transform_order="srt",
            const char *rotate_order="xyz",
            const HOM_Vector3 &pivot=HOM_Vector3())
        throw(HOM_ValueError, HOM_OperationFailed);

    HOM_Vector3 extractTranslates(const char *transform_order="srt")
        throw(HOM_OperationFailed, HOM_ValueError);

    SWIGPYTHONOUT(%feature("autodoc",
        "extractRotates(self, transform_order='srt', rotate_order='xyz', pivot=hou.Vector3()) -> Vector3") extractRotates;)
    SWIGOUT(%kwargs extractRotates;)
    HOM_Vector3 extractRotates(
            const char *transform_order="srt",
            const char *rotate_order="xyz",
            const HOM_Vector3 &pivot=HOM_Vector3())
        throw(HOM_OperationFailed, HOM_ValueError);

    SWIGPYTHONOUT(%feature("autodoc",
        "extractScales(self, transform_order='srt', pivot=hou.Vector3()) -> Vector3") extractScales;)
    SWIGOUT(%kwargs extractScales;)
    HOM_Vector3 extractScales(
            const char *transform_order="srt",
            const HOM_Vector3 &pivot=HOM_Vector3())
        throw(HOM_OperationFailed, HOM_ValueError);

    SWIGPYTHONOUT(%feature("autodoc",
        "extractShears(self, transform_order='srt', pivot=hou.Vector3()) -> Vector3") extractShears;)
    SWIGOUT(%kwargs extractShears;)
    HOM_Vector3 extractShears(
            const char *transform_order="srt",
            const HOM_Vector3 &pivot=HOM_Vector3())
        throw(HOM_OperationFailed, HOM_ValueError);

    SWIGOUT(%newobject extractRotationMatrix3;)
    HOM_Matrix3 *extractRotationMatrix3()
        throw(HOM_Error);

    SWIGOUT(%ignore myMatrix4;)
    UT_DMatrix4 myMatrix4;
};

#endif

---