Union operator. More...

#include <sdf.h>

Inheritance diagram for SDFUnion:

Public Member Functions
	SDFUnion (SDFNode , SDFNode )
	Create a union node.

	SDFUnion (SDFNode , SDFNode , SDFNode *)
	Create a union hierarchy ((A ∪ B) ∪ C).

	SDFUnion (SDFNode , SDFNode , SDFNode , SDFNode )
	Create a union hierarchy ((A ∪ B) ∪ (C ∪ D)).

	SDFUnion (const QVector< SDFNode * > &)
	Creates a union operator node given an array of nodes.

virtual	~SDFUnion ()
	Destructor.

double	BID (const Vector &) const
	Compute a lower bound of the signed distance.

virtual void	ComputeCostBID (const Vector &)
	Compute the number of reccursive calls to BID() and Signed().

virtual double	Signed (const Vector &) const
	Compute the signed distance.

virtual Vector	Gradient (const Vector &) const
	Compute the gradient of the field.

virtual Color	GetColor (const Vector &) const
	Compute the color.

QString	GetShader (PrimitiveManager , std::list< QString > , bool *) const
	Compute the GLSL code to render the node.

QString	GetCostShader (PrimitiveManager , std::list< QString > , bool *) const
	Compute the GLSL code to compute the cost of a call to sdf.

QString	GetGradientShader (PrimitiveManager , std::list< QString > , bool *) const
	Compute the GLSL code to compute the gradient the sdf.

QString	GetMaterialShader (PrimitiveManager , std::list< QString > , bool *) const
	Compute the GLSL code to compute the material the sdf at a given point 'p' with a given normal 'n'.

virtual int	Memory () const
	Return the size of a sub-tree.

virtual SDFNode *	Copy () const
	Deep copy.

Public Member Functions inherited from SDFBinary
	SDFBinary (SDFNode , SDFNode )
	Create a binary node.

virtual	~SDFBinary ()
	Recursively destroy the sub-trees.

virtual double	K (const Box &) const
	Return the local Lipschitz constant.

virtual void	ComputeCostSigned (const Vector &)
	Compute the number of reccursive calls to Signed().

int	Nodes () const
	Compute the number of nodes in the sub-tree.

Public Member Functions inherited from SDFNode
	SDFNode ()
	Create a generic node.

virtual	~SDFNode ()
	Destructor.

virtual bool	Inside (const Vector &) const
	Check if a point is inside or outside.

virtual double	K () const
	Return the Lipschitz constant of the node.

Box	GetBox () const
	Return the bounding box of the node.

Static Public Member Functions
static double	Signed (const double &, const double &)
	Compute the union, i.e. the minimum of two distance field values.

static SDFNode *	QuadricCurve (const double &, const QuadricCurveSet &)
	This function creates a quadric B�zier curve controled by an array of control knots.

static SDFNode *	RevolutionQuadricTubeSet (const Vector &, const Vector &, const double &, const QuadricCurve2Set &)
	Creates a surface of revolution.

static SDFNode *	RevolutionQuadricTubeSet (const double &, const QuadricCurve2Set &)
	Creates a surface of revolution.

Static Public Member Functions inherited from SDFNode
static void	ResetReccursiveCalls ()
	Reset the reccursive call property of the tree.

static int	ReccursiveCalls ()
	Returns the number of reccursive calls to Value() and BID().

static void	addReccursiveCalls (int)
	Add a nulber to the nbreccursiveCalls.

static SDFNode *	Stalactite (const Vector &p, const double &h, const double &r, bool noise=true, Random &random=Random::R239, const double &largeur=0.25, const double &espacement=0.61)
	Procedural parameterized stalactite.

static SDFNode *	SpherePieces ()
	Sphere carved, placed on a cylinder. Nice scene for testing sharp features reconstruction.

Additional Inherited Members
Protected Attributes inherited from SDFBinary
SDFNode *	e [2] = { nullptr,nullptr }
	Sub-trees.

Protected Attributes inherited from SDFNode
Box	box = Box::Infinity
	Box bounding the surface.

double	k = 1.0
	Lipschitz constant.

int	cost = 1
	Relative computation cost.

Static Protected Attributes inherited from SDFNode
static constexpr double	Epsilon = 0.01
	Small constant used for bounding volumes.

static int	reccursiveCalls = 0
	Recursive calls to BID or Value.

Detailed Description

Union operator.

The union between two signed Euclidean distance functions yields another Euclidean signed distance function. ,

Constructor & Destructor Documentation

◆ SDFUnion() [1/4]

SDFUnion::SDFUnion	(	SDFNode *	a,
		SDFNode *	b )

explicit

Create a union node.

Parameters

a,b	Sub-trees.

◆ SDFUnion() [2/4]

SDFUnion::SDFUnion	(	SDFNode *	a,
		SDFNode *	b,
		SDFNode *	c )

explicit

Create a union hierarchy ((A ∪ B) ∪ C).

Parameters

a,b,c Sub-trees.

◆ SDFUnion() [3/4]

SDFUnion::SDFUnion	(	SDFNode *	a,
		SDFNode *	b,
		SDFNode *	c,
		SDFNode *	d )

explicit

Create a union hierarchy ((A ∪ B) ∪ (C ∪ D)).

Parameters

a,b,c,d Sub-trees.

◆ SDFUnion() [4/4]

SDFUnion::SDFUnion ( const QVector< SDFNode * > & a )

explicit

Creates a union operator node given an array of nodes.

Note that the array should contain at least two elements.

Parameters

a	Set of nodes.

Member Function Documentation

◆ BID()

double SDFUnion::BID ( const Vector & p ) const

virtual

Compute a lower bound of the signed distance.

The bound is not continuous, not even monotonous, but is faster to compute than the actual distance.

Author: Hubert-Brierre Pierre

Parameters

p Point.

Reimplemented from SDFNode.

◆ ComputeCostBID()

void SDFUnion::ComputeCostBID ( const Vector & p )

virtual

Compute the number of reccursive calls to BID() and Signed().

Author: Hubert-Brierre Pierre

Reimplemented from SDFNode.

◆ GetColor()

Color SDFUnion::GetColor ( const Vector & p ) const

virtual

Compute the color.

Parameters

p Point.

Reimplemented from SDFNode.

◆ GetCostShader()

QString SDFUnion::GetCostShader	(	PrimitiveManager *	primitives,
		std::list< QString > *	dependency,
		bool *	valid_glsl ) const

virtual

Compute the GLSL code to compute the cost of a call to sdf.

Author: Hubert-Brierre Pierre

Reimplemented from SDFBinary.

◆ GetGradientShader()

QString SDFUnion::GetGradientShader	(	PrimitiveManager *	primitives,
		std::list< QString > *	dependency,
		bool *	valid_glsl ) const

virtual

Compute the GLSL code to compute the gradient the sdf.

Author: HUEBRT-BRIERRE Pierre

Reimplemented from SDFNode.

◆ GetMaterialShader()

QString SDFUnion::GetMaterialShader	(	PrimitiveManager *	primitives,
		std::list< QString > *	dependency,
		bool *	valid_glsl ) const

virtual

Compute the GLSL code to compute the material the sdf at a given point 'p' with a given normal 'n'.

Author: HUEBRT-BRIERRE Pierre

Reimplemented from SDFNode.

◆ GetShader()

QString SDFUnion::GetShader	(	PrimitiveManager *	primitives,
		std::list< QString > *	dependency,
		bool *	valid_glsl ) const

virtual

Compute the GLSL code to render the node.

Author: Hubert-Brierre Pierre

Reimplemented from SDFNode.

◆ Gradient()

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

virtual

Compute the gradient of the field.

Parameters

p Point.

Reimplemented from SDFNode.

Reimplemented in SDFSmoothUnion, SDFSmoothUnionSphereLOD, and SDFUnionR.

◆ Memory()

int SDFUnion::Memory ( ) const

virtual

Return the size of a sub-tree.

Reimplemented from SDFNode.

Reimplemented in SDFSmoothUnion, SDFSmoothUnionExp, SDFSmoothUnionSphereLOD, and SDFUnionR.

◆ QuadricCurve()

SDFNode * SDFUnion::QuadricCurve	(	const double &	r,
		const QuadricCurveSet &	q )

static

This function creates a quadric B�zier curve controled by an array of control knots.

Parameters

r	The radius.
q	The set of quadrics.

◆ RevolutionQuadricTubeSet() [1/2]

SDFNode * SDFUnion::RevolutionQuadricTubeSet	(	const double &	r,
		const QuadricCurve2Set &	q )

static

Creates a surface of revolution.

The profile is a quadric B�zier curve controled by an array of control knots, using origin and z-axis.

Parameters

r	Offset radius.
q	Set of quadrics.

◆ RevolutionQuadricTubeSet() [2/2]

SDFNode * SDFUnion::RevolutionQuadricTubeSet	(	const Vector &	a,
		const Vector &	b,
		const double &	r,
		const QuadricCurve2Set &	q )

static

Creates a surface of revolution.

The profile is a quadric B�zier curve controled by an array of control knots.

Parameters

a,b	The vertices of the axis.
r	The offset radius.
q	The set of quadrics.

◆ Signed() [1/2]

double SDFUnion::Signed	(	const double &	x,
		const double &	y )

static

Compute the union, i.e. the minimum of two distance field values.

Parameters

x,y Reals.

◆ Signed() [2/2]

double SDFUnion::Signed ( const Vector & p ) const

virtual

Compute the signed distance.

Parameters

p Point.

Reimplemented from SDFNode.

Reimplemented in SDFSmoothUnion, SDFSmoothUnionExp, SDFSmoothUnionSphereLOD, and SDFUnionR.

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ SDFUnion() [1/4]

◆ SDFUnion() [2/4]

◆ SDFUnion() [3/4]

◆ SDFUnion() [4/4]

Member Function Documentation

◆ BID()

◆ ComputeCostBID()

◆ GetColor()

◆ GetCostShader()

◆ GetGradientShader()

◆ GetMaterialShader()

◆ GetShader()

◆ Gradient()

◆ Memory()

◆ QuadricCurve()

◆ RevolutionQuadricTubeSet() [1/2]

◆ RevolutionQuadricTubeSet() [2/2]

◆ Signed() [1/2]

◆ Signed() [2/2]