TreeTwist Class Reference

Twisting nodes. More...

#include <blobtree.h>

Inheritance diagram for TreeTwist:

Public Member Functions
	TreeTwist (TreeNode *, const Vector &, const Vector &, const double &)
	Creates a twisting operator.
virtual	~TreeTwist ()
	Destroy a twisting node in the tree.
double	Intensity (const Vector &) const
	Computes the intensity at a given point in space.
Vector	Gradient (const Vector &) const
	Computes the gradient of the field function modified by a twist operator.
virtual TreeNode *	Copy () const
	Create a deep copy of twist node.
int	Memory () const
	Compute the size of a node.
double	K () const
	Compute the Lipschitz constant of the node.
double	K (const Sphere &) const
	Compute the Lipschitz constant of the node.
double	K (const Segment &) const
	Compute the Lipschitz constant of the node.
double	K (const RayStep &) const
	Compute the Lipschitz constant of the node.
double	K (const Box &) const
	Compute the Lipschitz constant of the node if box intersects node.
double	K (const Ray &) const
	Compute the Lipschitz constant of the node along the ray.
Color	GetMaterial (const Vector &, const Vector &=Vector::Null) const
	Compute the texture for a twist node.
TreeNode *	Cut (const Box &) const
	Cuts the node to simplify its structure inside a box.
Public Member Functions inherited from TreeWarp
	TreeWarp (TreeNode *=nullptr)
	Create a warping node.
virtual	~TreeWarp ()
	Recursively destroys the structure.
Public Member Functions inherited from TreeUnary
	TreeUnary (TreeNode *)
	Create a generic warping node.
virtual	~TreeUnary ()
	Recursively destroys the structure.
virtual int	Nodes () const
	Compute the number of nodes of the sub-tree.
virtual int	Depth () const
	Compute the dpeth of the sub-tree.
virtual void	SetThreshold (const double &)
	Recursively setup the threshold value.
Public Member Functions inherited from TreeOperator
	TreeOperator ()
	Creates an operator node.
virtual	~TreeOperator ()
	Destroys an operator.
Public Member Functions inherited from TreeNode
	TreeNode ()
	Create a virtual node of the Blob-Tree structure.
virtual	~TreeNode ()
	Destroys a node.
virtual double	Omega (const Vector &) const
	Return the squared distance to the compact support of the node.
virtual void	IntensityGradient (const Vector &, double &, Vector &) const
	Computes the field value and the gradient at a given point in space.
virtual TreeNode *	Blend (TreeNode *)
	Insert a blending node that blends the old and the new sub-tree together.
virtual TreeNode *	Union (TreeNode *)
	Insert a union node that unions the old and the new sub-tree together.
virtual TreeNode *	Difference (TreeNode *)
	Insert a difference node.
virtual TreeNode *	Translate (const Vector &)
	Insert a translation node.
virtual TreeNode *	Rotate (const Matrix &)
	Insert a rotation node.
virtual TreeNode *	Scale (const Vector &)
	Insert a scaling node.
Box	GetBox () const
	Return the bounding box of the node.
virtual QString	Show (int=0) const
	Show the tree hierarchy.
virtual Vector	Dichotomy (Vector, Vector, double, double, double, const double &=1.0e-4)
	Compute the intersection between the implicit surface and a segment.

Protected Attributes
double	k
	Lipschitz constant.
Protected Attributes inherited from TreeNode
Box	box = Box::Null
	Bounding box of the node.
double	T = 0.5
	Threshold value.

Additional Inherited Members
Static Protected Attributes inherited from TreeNode
static const double	Epsilon = 1e-6
	Epsilon value for gradient computation.

Detailed Description

Twisting nodes.

,

Example of how to code a twist:

TreeNode *element=new TreeNodeEdge(Vector(1,0,-1),Vector(1,0,1),new BlendCubic(2.0,1.0));
TreeNode *twist=new TreeTwist(element,Vector(0,0,0),Vector(0,0,1),Math::Pi);

Constructor & Destructor Documentation

TreeTwist()

TreeTwist::TreeTwist ( TreeNode * node, const Vector & a, const Vector & b, const double & t )

explicit

Creates a twisting operator.

This function initializes some internal parameters such as the bounding box and the Lipschitz constant factor. The bounding box can be derived from the twisting axis and the bounding box of the child element in the tree.

The Lipschitz constant multiplier results from the extent of the bounding box and the twisting speed.

Parameters

node	The child node being twisted.
a,b	End vertices of the twisting axis.
t	the twisting angle between end vertices

~TreeTwist()

TreeTwist::~TreeTwist ( )

virtual

Destroy a twisting node in the tree.

Implicitly calls TreeWarp::~TreeWarp() that recursively calls the destructor of its child.

Member Function Documentation

Intensity()

double TreeTwist::Intensity ( const Vector & p ) const

virtual

Computes the intensity at a given point in space.

Bascially transform the point according to the twist parameters, and compute the intensity at the perturbed location.

Parameters

p

Point.

Implements TreeNode.

Gradient()

Vector TreeTwist::Gradient ( const Vector & p ) const

virtual

Computes the gradient of the field function modified by a twist operator.

This involves the computation of the Jacobian of the warping function at the transformed position in space.

Parameters

p

Point.

Reimplemented from TreeNode.

K() [1/5]

double TreeTwist::K ( const Sphere & s ) const

virtual

Compute the Lipschitz constant of the node.

Parameters

s	The sphere.

Reimplemented from TreeNode.

K() [2/5]

double TreeTwist::K ( const Segment & s ) const

virtual

Compute the Lipschitz constant of the node.

Parameters

s	The segment.

Reimplemented from TreeNode.

K() [3/5]

double TreeTwist::K ( const RayStep & raystep ) const

virtual

Compute the Lipschitz constant of the node.

Parameters

raystep

The segment.

Reimplemented from TreeNode.

K() [4/5]

double TreeTwist::K ( const Box & b ) const

virtual

Compute the Lipschitz constant of the node if box intersects node.

Parameters

b

The box.

Implements TreeNode.

K() [5/5]

double TreeTwist::K ( const Ray & ray ) const

virtual

Compute the Lipschitz constant of the node along the ray.

Parameters

ray

The ray.

Implements TreeNode.

GetMaterial()

Color TreeTwist::GetMaterial ( const Vector & p, const Vector & n = Vector::Null ) const

virtual

Compute the texture for a twist node.

Parameters

p	Point.
n	Normal.

Implements TreeWarp.

Cut()

TreeNode * TreeTwist::Cut ( const Box & b ) const

virtual

Cuts the node to simplify its structure inside a box.

Parameters

b

The box.

Implements TreeNode.