Loading...
Searching...
No Matches
ScaleTranslateMap Class Reference

A specialized Affine transform that scales along the principal axis the scaling need not be uniform in the three-directions, and then translates the result. More...

`#include <openvdb/math/Maps.h>`

Inheritance diagram for ScaleTranslateMap:

## Public Types

using | Ptr = SharedPtr< ScaleTranslateMap >
using | ConstPtr = SharedPtr< const ScaleTranslateMap >
using | MapFactory = Ptr(*)()

## Public Member Functions

| ScaleTranslateMap ()
| ScaleTranslateMap (const Vec3d &scale, const Vec3d &translate)
| ScaleTranslateMap (const ScaleMap &scale, const TranslationMap &translate)
| ScaleTranslateMap (const ScaleTranslateMap &other)
| ~ScaleTranslateMap () override=default
MapBase::Ptr | copy () const override
| Return a MapBase::Ptr to a deep copy of this map.
MapBase::Ptr | inverseMap () const override
| Return a new map representing the inverse of this map.
Name | type () const override
| Return the name of this map's concrete type (e.g., `"AffineMap"`).
bool | isLinear () const final
| Return `true` (a ScaleTranslateMap is always linear).
bool | hasUniformScale () const final
| Return `true` if the scale values have the same magnitude (eg. -1, 1, -1 would be a rotation).
Vec3d | applyMap (const Vec3d &in) const final
| Return the image of `under` the map.
Vec3d | applyInverseMap (const Vec3d &in) const final
| Return the pre-image of `under` the map.
Vec3d | applyJacobian (const Vec3d &in, const Vec3d &) const final
| Return the Jacobian of the map applied to in.
Vec3d | applyJacobian (const Vec3d &in) const final
| Return the Jacobian of the map applied to in.
Vec3d | applyInverseJacobian (const Vec3d &in, const Vec3d &) const final
| Return the Inverse Jacobian of the map applied to in (i.e. inverse map with out translation)
Vec3d | applyInverseJacobian (const Vec3d &in) const final
| Return the Inverse Jacobian of the map applied to in (i.e. inverse map with out translation)
Vec3d | applyJT (const Vec3d &in, const Vec3d &) const final
| Return the Jacobian Transpose of the map applied to in.
Vec3d | applyJT (const Vec3d &in) const final
| Return the Jacobian Transpose of the map applied to in.
Vec3d | applyIJT (const Vec3d &in, const Vec3d &) const final
| Return the transpose of the inverse Jacobian of the map applied to in.
Vec3d | applyIJT (const Vec3d &in) const final
| Return the transpose of the inverse Jacobian of the map applied to `in`.
Mat3d | applyIJC (const Mat3d &in) const final
| Return the Jacobian Curvature: zero for a linear map.
Mat3d | applyIJC (const Mat3d &in, const Vec3d &, const Vec3d &) const final
double | determinant (const Vec3d &) const final
| Return the product of the scale values, ignores argument.
double | determinant () const final
| Return the product of the scale values.
Vec3d | voxelSize () const final
| Return the absolute values of the scale values.
Vec3d | voxelSize (const Vec3d &) const final
| Return the absolute values of the scale values, ignores argument.
const Vec3d & | getScale () const
| Returns the scale values.
const Vec3d & | getTranslation () const
| Returns the translation.
const Vec3d & | getInvScaleSqr () const
| Return the square of the scale. Used to optimize some finite difference calculations.
const Vec3d & | getInvTwiceScale () const
| Return 1/(2 scale). Used to optimize some finite difference calculations.
const Vec3d & | getInvScale () const
| Return 1/(scale)
void | read (std::istream &is) override
| read serialization
void | write (std::ostream &os) const override
| write serialization
std::string | str () const override
| string serialization, useful for debuging
bool | isEqual (const MapBase &other) const override
| Return `true` if this map is equal to the given map.
bool | operator== (const ScaleTranslateMap &other) const
bool | operator!= (const ScaleTranslateMap &other) const
AffineMap::Ptr | getAffineMap () const override
| Return AffineMap::Ptr to an AffineMap equivalent to *this.
MapBase::Ptr | preRotate (double radians, Axis axis) const override
| Return a MapBase::Ptr to a new map that is the result of prepending the appropraite operation.
MapBase::Ptr | preTranslate (const Vec3d &t) const override
MapBase::Ptr | preScale (const Vec3d &v) const override
MapBase::Ptr | preShear (double shear, Axis axis0, Axis axis1) const override
MapBase::Ptr | postRotate (double radians, Axis axis) const override
| Return a MapBase::Ptr to a new map that is the result of postfixing the appropraite operation.
MapBase::Ptr | postTranslate (const Vec3d &t) const override
MapBase::Ptr | postScale (const Vec3d &v) const override
MapBase::Ptr | postShear (double shear, Axis axis0, Axis axis1) const override
template<typename MapT >
bool | isType () const
| Return `true` if this map is of concrete type `MapT` (e.g., AffineMap).

## Static Public Member Functions

static MapBase::Ptr | create ()
| Return a MapBase::Ptr to a new ScaleTranslateMap.
static bool | isRegistered ()
static void | registerMap ()
static Name | mapType ()

## Static Protected Member Functions

template<typename MapT >
static bool | isEqualBase (const MapT &self, const MapBase &other)

## Detailed Description

A specialized Affine transform that scales along the principal axis the scaling need not be uniform in the three-directions, and then translates the result.

Note
  This class is not marked final because UniformScaleMap inherits from it, so some of the member methods are marked final instead.

## Member Typedef Documentation

## ConstPtr

using ConstPtr = SharedPtr<const ScaleTranslateMap>

## MapFactory

using MapFactory = Ptr (*)()

inherited

## Ptr

using Ptr = SharedPtr<ScaleTranslateMap>

## Constructor & Destructor Documentation

## ScaleTranslateMap() [1/4]

ScaleTranslateMap | ( |  | ) |

inline

## ScaleTranslateMap() [2/4]

ScaleTranslateMap | ( | const Vec3d & | scale,
|  | const Vec3d & | translate
| ) |  |

inline

## ScaleTranslateMap() [3/4]

ScaleTranslateMap | ( | const ScaleMap & | scale,
|  | const TranslationMap & | translate
| ) |  |

inline

## ScaleTranslateMap() [4/4]

ScaleTranslateMap | ( | const ScaleTranslateMap & | other | ) |

inline

## ~ScaleTranslateMap()

~ScaleTranslateMap | ( |  | ) |

overridedefault

## Member Function Documentation

## applyIJC() [1/2]

Mat3d applyIJC | ( | const Mat3d & | in | ) | const

inlinefinalvirtual

Return the Jacobian Curvature: zero for a linear map.

Implements MapBase.

## applyIJC() [2/2]

Mat3d applyIJC | ( | const Mat3d & | in,
|  | const Vec3d & | ,
|  | const Vec3d & |
| ) |  | const

inlinefinalvirtual

Implements MapBase.

## applyIJT() [1/2]

Vec3d applyIJT | ( | const Vec3d & | in | ) | const

inlinefinalvirtual

Return the transpose of the inverse Jacobian of the map applied to `in`.

Implements MapBase.

## applyIJT() [2/2]

Vec3d applyIJT | ( | const Vec3d & | in,
|  | const Vec3d & |
| ) |  | const

inlinefinalvirtual

Return the transpose of the inverse Jacobian of the map applied to in.

Ignores second argument

Implements MapBase.

## applyInverseJacobian() [1/2]

Vec3d applyInverseJacobian | ( | const Vec3d & | in | ) | const

inlinefinalvirtual

Return the Inverse Jacobian of the map applied to in (i.e. inverse map with out translation)

Implements MapBase.

## applyInverseJacobian() [2/2]

Vec3d applyInverseJacobian | ( | const Vec3d & | in,
|  | const Vec3d & |
| ) |  | const

inlinefinalvirtual

Return the Inverse Jacobian of the map applied to in (i.e. inverse map with out translation)

Implements MapBase.

## applyInverseMap()

Vec3d applyInverseMap | ( | const Vec3d & | in | ) | const

inlinefinalvirtual

Return the pre-image of `under` the map.

Implements MapBase.

## applyJacobian() [1/2]

Vec3d applyJacobian | ( | const Vec3d & | in | ) | const

inlinefinalvirtual

Return the Jacobian of the map applied to in.

Implements MapBase.

## applyJacobian() [2/2]

Vec3d applyJacobian | ( | const Vec3d & | in,
|  | const Vec3d & |
| ) |  | const

inlinefinalvirtual

Return the Jacobian of the map applied to in.

Implements MapBase.

## applyJT() [1/2]

Vec3d applyJT | ( | const Vec3d & | in | ) | const

inlinefinalvirtual

Return the Jacobian Transpose of the map applied to in.

Implements MapBase.

## applyJT() [2/2]

Vec3d applyJT | ( | const Vec3d & | in,
|  | const Vec3d & |
| ) |  | const

inlinefinalvirtual

Return the Jacobian Transpose of the map applied to in.

This tranforms range-space gradients to domain-space gradients

Implements MapBase.

## applyMap()

Vec3d applyMap | ( | const Vec3d & | in | ) | const

inlinefinalvirtual

Return the image of `under` the map.

Implements MapBase.

## copy()

MapBase::Ptr copy | ( |  | ) | const

inlineoverridevirtual

Return a MapBase::Ptr to a deep copy of this map.

Implements MapBase.

Reimplemented in UniformScaleTranslateMap.

## create()

static MapBase::Ptr create | ( |  | ) |

inlinestatic

Return a MapBase::Ptr to a new ScaleTranslateMap.

## determinant() [1/2]

double determinant | ( |  | ) | const

inlinefinalvirtual

Return the product of the scale values.

Implements MapBase.

## determinant() [2/2]

double determinant | ( | const Vec3d & |  | ) | const

inlinefinalvirtual

Return the product of the scale values, ignores argument.

Implements MapBase.

## getAffineMap()

AffineMap::Ptr getAffineMap | ( |  | ) | const

inlineoverridevirtual

Return AffineMap::Ptr to an AffineMap equivalent to *this.

Implements MapBase.

## getInvScale()

const Vec3d & getInvScale | ( |  | ) | const

inline

Return 1/(scale)

## getInvScaleSqr()

const Vec3d & getInvScaleSqr | ( |  | ) | const

inline

Return the square of the scale. Used to optimize some finite difference calculations.

## getInvTwiceScale()

const Vec3d & getInvTwiceScale | ( |  | ) | const

inline

Return 1/(2 scale). Used to optimize some finite difference calculations.

## getScale()

const Vec3d & getScale | ( |  | ) | const

inline

Returns the scale values.

## getTranslation()

const Vec3d & getTranslation | ( |  | ) | const

inline

Returns the translation.

## hasUniformScale()

bool hasUniformScale | ( |  | ) | const

inlinefinalvirtual

Return `true` if the scale values have the same magnitude (eg. -1, 1, -1 would be a rotation).

Implements MapBase.

## inverseMap()

MapBase::Ptr inverseMap | ( |  | ) | const

inlineoverridevirtual

Return a new map representing the inverse of this map.

Exceptions

  NotImplementedError | if the map is a NonlinearFrustumMap.

Warning
  Houdini 12.5 uses an earlier version of OpenVDB, and maps created with that version lack a virtual table entry for this method. Do not call this method from Houdini 12.5.

Implements MapBase.

Reimplemented in UniformScaleTranslateMap.

## isEqual()

bool isEqual | ( | const MapBase & | other | ) | const

inlineoverridevirtual

Return `true` if this map is equal to the given map.

Implements MapBase.

Reimplemented in UniformScaleTranslateMap.

## isEqualBase()

template<typename MapT >

static bool isEqualBase | ( | const MapT & | self,
|  | const MapBase & | other
| ) |  |

inlinestaticprotectedinherited

## isLinear()

bool isLinear | ( |  | ) | const

inlinefinalvirtual

Return `true` (a ScaleTranslateMap is always linear).

Implements MapBase.

## isRegistered()

static bool isRegistered | ( |  | ) |

inlinestatic

## isType()

template<typename MapT >

bool isType | ( |  | ) | const

inlineinherited

Return `true` if this map is of concrete type `MapT` (e.g., AffineMap).

## mapType()

static Name mapType | ( |  | ) |

inlinestatic

## operator!=()

bool operator!= | ( | const ScaleTranslateMap & | other | ) | const

inline

## operator==()

bool operator== | ( | const ScaleTranslateMap & | other | ) | const

inline

## postRotate()

MapBase::Ptr postRotate | ( | double | radians,
|  | Axis | axis
| ) |  | const

inlineoverridevirtual

Return a MapBase::Ptr to a new map that is the result of postfixing the appropraite operation.

Implements MapBase.

## postScale()

MapBase::Ptr postScale | ( | const Vec3d & | v | ) | const

inlineoverridevirtual

Implements MapBase.

## postShear()

MapBase::Ptr postShear | ( | double | shear,
|  | Axis | axis0,
|  | Axis | axis1
| ) |  | const

inlineoverridevirtual

Implements MapBase.

## postTranslate()

MapBase::Ptr postTranslate | ( | const Vec3d & | t | ) | const

inlineoverridevirtual

Implements MapBase.

Reimplemented in UniformScaleTranslateMap.

## preRotate()

MapBase::Ptr preRotate | ( | double | radians,
|  | Axis | axis
| ) |  | const

inlineoverridevirtual

Return a MapBase::Ptr to a new map that is the result of prepending the appropraite operation.

Implements MapBase.

## preScale()

MapBase::Ptr preScale | ( | const Vec3d & | v | ) | const

inlineoverridevirtual

Implements MapBase.

## preShear()

MapBase::Ptr preShear | ( | double | shear,
|  | Axis | axis0,
|  | Axis | axis1
| ) |  | const

inlineoverridevirtual

Implements MapBase.

## preTranslate()

MapBase::Ptr preTranslate | ( | const Vec3d & | t | ) | const

inlineoverridevirtual

Implements MapBase.

Reimplemented in UniformScaleTranslateMap.

## read()

void read | ( | std::istream & | is | ) |

inlineoverridevirtual

read serialization

Implements MapBase.

## registerMap()

static void registerMap | ( |  | ) |

inlinestatic

## str()

std::string str | ( |  | ) | const

inlineoverridevirtual

string serialization, useful for debuging

Implements MapBase.

## type()

Name type | ( |  | ) | const

inlineoverridevirtual

Return the name of this map's concrete type (e.g., `"AffineMap"`).

Implements MapBase.

Reimplemented in UniformScaleTranslateMap.

## voxelSize() [1/2]

Vec3d voxelSize | ( |  | ) | const

inlinefinalvirtual

Return the absolute values of the scale values.

Implements MapBase.

## voxelSize() [2/2]

Vec3d voxelSize | ( | const Vec3d & |  | ) | const

inlinefinalvirtual

Return the absolute values of the scale values, ignores argument.

Implements MapBase.

## write()

void write | ( | std::ostream & | os | ) | const

inlineoverridevirtual

write serialization

Implements MapBase.