You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

117 lines
3.6 KiB
C++

/*=========================================================================
Program: Visualization Toolkit
Module: vtkHomogeneousTransform.h
Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
All rights reserved.
See Copyright.txt or http://www.kitware.com/Copyright.htm for details.
This software is distributed WITHOUT ANY WARRANTY; without even
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the above copyright notice for more information.
=========================================================================*/
/**
* @class vtkHomogeneousTransform
* @brief superclass for homogeneous transformations
*
* vtkHomogeneousTransform provides a generic interface for homogeneous
* transformations, i.e. transformations which can be represented by
* multiplying a 4x4 matrix with a homogeneous coordinate.
* @sa
* vtkPerspectiveTransform vtkLinearTransform vtkIdentityTransform
*/
#ifndef vtkHomogeneousTransform_h
#define vtkHomogeneousTransform_h
#include "vtkAbstractTransform.h"
#include "vtkCommonTransformsModule.h" // For export macro
class vtkMatrix4x4;
class VTKCOMMONTRANSFORMS_EXPORT vtkHomogeneousTransform : public vtkAbstractTransform
{
public:
vtkTypeMacro(vtkHomogeneousTransform, vtkAbstractTransform);
void PrintSelf(ostream& os, vtkIndent indent) override;
/**
* Apply the transformation to a series of points, and append the
* results to outPts.
*/
void TransformPoints(vtkPoints* inPts, vtkPoints* outPts) override;
/**
* Apply the transformation to a combination of points, normals
* and vectors.
*/
void TransformPointsNormalsVectors(vtkPoints* inPts, vtkPoints* outPts, vtkDataArray* inNms,
vtkDataArray* outNms, vtkDataArray* inVrs, vtkDataArray* outVrs, int nOptionalVectors = 0,
vtkDataArray** inVrsArr = nullptr, vtkDataArray** outVrsArr = nullptr) override;
/**
* Get a copy of the internal transformation matrix. The
* transform is Updated first, to guarantee that the matrix
* is valid.
*/
void GetMatrix(vtkMatrix4x4* m);
/**
* Get a pointer to an internal vtkMatrix4x4 that represents
* the transformation. An Update() is called on the transform
* to ensure that the matrix is up-to-date when you get it.
* You should not store the matrix pointer anywhere because it
* might become stale.
*/
vtkMatrix4x4* GetMatrix()
{
this->Update();
return this->Matrix;
}
/**
* Just like GetInverse(), but includes typecast to vtkHomogeneousTransform.
*/
vtkHomogeneousTransform* GetHomogeneousInverse()
{
return static_cast<vtkHomogeneousTransform*>(this->GetInverse());
}
//@{
/**
* This will calculate the transformation without calling Update.
* Meant for use only within other VTK classes.
*/
void InternalTransformPoint(const float in[3], float out[3]) override;
void InternalTransformPoint(const double in[3], double out[3]) override;
//@}
//@{
/**
* This will calculate the transformation as well as its derivative
* without calling Update. Meant for use only within other VTK
* classes.
*/
void InternalTransformDerivative(
const float in[3], float out[3], float derivative[3][3]) override;
void InternalTransformDerivative(
const double in[3], double out[3], double derivative[3][3]) override;
//@}
protected:
vtkHomogeneousTransform();
~vtkHomogeneousTransform() override;
void InternalDeepCopy(vtkAbstractTransform* transform) override;
vtkMatrix4x4* Matrix;
private:
vtkHomogeneousTransform(const vtkHomogeneousTransform&) = delete;
void operator=(const vtkHomogeneousTransform&) = delete;
};
#endif