CubbyFlow::VolumeGridEmitter2 Class Referencefinal

2-D grid-based volumetric emitter. More...

#include <Core/Emitter/VolumeGridEmitter2.h>

Inheritance diagram for CubbyFlow::VolumeGridEmitter2:
CubbyFlow::GridEmitter2

Classes

class  Builder
 Front-end to create VolumeGridEmitter2 objects step by step. More...
 

Public Types

using ScalarMapper = std::function< double(double, const Vector2D &, double)>
 Maps to a scalar value for given signed-dist, location, and old value. More...
 
using VectorMapper = std::function< Vector2D(double, const Vector2D &, const Vector2D &)>
 Maps to a vector value for given signed-dist, location, and old value. More...
 
- Public Types inherited from CubbyFlow::GridEmitter2
using OnBeginUpdateCallback = std::function< void(GridEmitter2 *, double, double)>
 Callback function type for update calls. More...
 

Public Member Functions

 VolumeGridEmitter2 (const ImplicitSurface2Ptr &sourceRegion, bool isOneShot=true)
 Constructs an emitter with a source and is-one-shot flag. More...
 
virtual ~VolumeGridEmitter2 ()
 Destructor. More...
 
void AddSignedDistanceTarget (const ScalarGrid2Ptr &scalarGridTarget)
 Adds signed-distance target to the scalar grid. More...
 
void AddStepFunctionTarget (const ScalarGrid2Ptr &scalarGridTarget, double minValue, double maxValue)
 Adds step function target to the scalar grid. More...
 
void AddTarget (const ScalarGrid2Ptr &scalarGridTarget, const ScalarMapper &customMapper)
 Adds a scalar grid target. More...
 
void AddTarget (const VectorGrid2Ptr &vectorGridTarget, const VectorMapper &customMapper)
 Adds a vector grid target. More...
 
const ImplicitSurface2PtrGetSourceRegion () const
 Returns implicit surface which defines the source region. More...
 
bool GetIsOneShot () const
 Returns true if this emits only once. More...
 
- Public Member Functions inherited from CubbyFlow::GridEmitter2
 GridEmitter2 ()
 Constructs an emitter. More...
 
virtual ~GridEmitter2 ()
 Destructor. More...
 
void Update (double currentTimeInSeconds, double timeIntervalInSeconds)
 
void SetOnBeginUpdateCallback (const OnBeginUpdateCallback &callback)
 Sets the callback function to be called when GridEmitter2::Update function is invoked. More...
 

Static Public Member Functions

static Builder GetBuilder ()
 Returns builder fox VolumeGridEmitter2. More...
 

Additional Inherited Members

- Protected Member Functions inherited from CubbyFlow::GridEmitter2
void CallOnBeginUpdateCallback (double currentTimeInSeconds, double timeIntervalInSeconds)
 

Detailed Description

2-D grid-based volumetric emitter.

Member Typedef Documentation

◆ ScalarMapper

using CubbyFlow::VolumeGridEmitter2::ScalarMapper = std::function<double(double, const Vector2D&, double)>

Maps to a scalar value for given signed-dist, location, and old value.

◆ VectorMapper

using CubbyFlow::VolumeGridEmitter2::VectorMapper = std::function<Vector2D(double, const Vector2D&, const Vector2D&)>

Maps to a vector value for given signed-dist, location, and old value.

Constructor & Destructor Documentation

◆ VolumeGridEmitter2()

CubbyFlow::VolumeGridEmitter2::VolumeGridEmitter2 ( const ImplicitSurface2Ptr sourceRegion,
bool  isOneShot = true 
)
explicit

Constructs an emitter with a source and is-one-shot flag.

◆ ~VolumeGridEmitter2()

virtual CubbyFlow::VolumeGridEmitter2::~VolumeGridEmitter2 ( )
virtual

Destructor.

Member Function Documentation

◆ AddSignedDistanceTarget()

void CubbyFlow::VolumeGridEmitter2::AddSignedDistanceTarget ( const ScalarGrid2Ptr scalarGridTarget)

Adds signed-distance target to the scalar grid.

◆ AddStepFunctionTarget()

void CubbyFlow::VolumeGridEmitter2::AddStepFunctionTarget ( const ScalarGrid2Ptr scalarGridTarget,
double  minValue,
double  maxValue 
)

Adds step function target to the scalar grid.

Parameters
[in]scalarGridTargetThe scalar grid target.
[in]minValueThe minimum value of the step function.
[in]maxValueThe maximum value of the step function.

◆ AddTarget() [1/2]

void CubbyFlow::VolumeGridEmitter2::AddTarget ( const ScalarGrid2Ptr scalarGridTarget,
const ScalarMapper customMapper 
)

Adds a scalar grid target.

This function adds a custom target to the emitter. The first parameter defines which grid should it write to. The second parameter, customMapper, defines how to map signed-distance field from the volume geometry and location of the point to the final scalar value that is going to be written to the target grid. The third parameter defines how to blend the old value from the target grid and the new value from the mapper function.

Parameters
[in]scalarGridTargetThe scalar grid target
[in]customMapperThe custom mapper.

◆ AddTarget() [2/2]

void CubbyFlow::VolumeGridEmitter2::AddTarget ( const VectorGrid2Ptr vectorGridTarget,
const VectorMapper customMapper 
)

Adds a vector grid target.

This function adds a custom target to the emitter. The first parameter defines which grid should it write to. The second parameter, customMapper, defines how to map signed-distance field from the volume geometry and location of the point to the final vector value that is going to be written to the target grid. The third parameter defines how to blend the old value from the target grid and the new value from the mapper function.

Parameters
[in]vectorGridTargetThe vector grid target
[in]customMapperThe custom mapper.

◆ GetBuilder()

static Builder CubbyFlow::VolumeGridEmitter2::GetBuilder ( )
static

Returns builder fox VolumeGridEmitter2.

◆ GetIsOneShot()

bool CubbyFlow::VolumeGridEmitter2::GetIsOneShot ( ) const

Returns true if this emits only once.

◆ GetSourceRegion()

const ImplicitSurface2Ptr& CubbyFlow::VolumeGridEmitter2::GetSourceRegion ( ) const

Returns implicit surface which defines the source region.


The documentation for this class was generated from the following file: