OpenVDB: OpenCapsuleWedgeVoxelizer< GridType, InterruptT > Class Template Reference

OpenVDB 12.1.0

Loading...
Searching...
No Matches
OpenCapsuleWedgeVoxelizer< GridType, InterruptT > Class Template Reference

Class used to generate a grid of type `GridType` containing a narrow-band level set representation of an open wedge. The only parts of the level set populated are within a sector of a capsule. The sector is defined by the intersection of two half spaces. More...

`#include <openvdb/tools/impl/LevelSetDilatedMeshImpl.h>`

Inheritance diagram for OpenCapsuleWedgeVoxelizer< GridType, InterruptT >:

## Public Member Functions
| OpenCapsuleWedgeVoxelizer (GridPtr &grid, const bool &threaded=false, InterruptT *interrupter=nullptr)
| Constructor.
template<typename ScalarType>
void | operator() (const math::Vec3< ScalarType > &pt1, const math::Vec3< ScalarType > &pt2, const ScalarType &radius, const math::Vec3< ScalarType > &nrml1, const math::Vec3< ScalarType > &nrml2)
| Create an open wedge.
ValueT | voxelSize () const
| Return the voxel size of the grid.
ValueT | halfWidth () const
| Return the half width of the narrow-band level set.

## Protected Member Functions
void | iterate ()
| The function the derived class calls to create the level set, working in index space other than setting signed distance values.
ValueT | tilePointSignedDistance (const Vec3T &p) const
| Computes the signed distance for tiles in index space, considering the center of the tile. This method is optional to override and defaults to `signedDistance`.

## Static Protected Member Functions
static ValueT | tileCeil (const ValueT &x, const ValueT &step)
| Rounds an input scalar up to the nearest valid ordinate of tile of a specified size.
static ValueT | tileFloor (const ValueT &x, const ValueT &step)
| Rounds an input scalar down to the nearest valid ordinate of tile of a specified size.
static ValueT | circleBottom (const ValueT &x0, const ValueT &y0, const ValueT &r, const ValueT &x)
| Computes the bottom y-coordinate of a circle at a given x position.
static ValueT | circleTop (const ValueT &x0, const ValueT &y0, const ValueT &r, const ValueT &x)
| Computes the top y-coordinate of a circle at a given x position.
static ValueT | sphereBottom (const ValueT &x0, const ValueT &y0, const ValueT &z0, const ValueT &r, const ValueT &x, const ValueT &y)
| Computes the bottom z-coordinate of a sphere at a given (x, y) position.
static ValueT | sphereTop (const ValueT &x0, const ValueT &y0, const ValueT &z0, const ValueT &r, const ValueT &x, const ValueT &y)
| Computes the top z-coordinate of a sphere at a given (x, y) position.

## Protected Attributes
std::function< bool(ValueT &, ValueT &, const ValueT &, const ValueT &)> | bottomTop
| Find where a vertical infinite line intersects a convex region dilated by the half width.

## Friends
class | ConvexVoxelizer< GridType, OpenCapsuleWedgeVoxelizer< GridType, InterruptT >, InterruptT >

## Detailed Description

template<typename GridType, typename InterruptT = util::NullInterrupter>
class openvdb::v12_1::tools::lvlset::OpenCapsuleWedgeVoxelizer< GridType, InterruptT >

Class used to generate a grid of type `GridType` containing a narrow-band level set representation of an open wedge. The only parts of the level set populated are within a sector of a capsule. The sector is defined by the intersection of two half spaces.

Note
  `GridType::ValueType` must be a floating-point scalar.

## Constructor & Destructor Documentation

## ◆ OpenCapsuleWedgeVoxelizer()

template<typename GridType, typename InterruptT = util::NullInterrupter>

OpenCapsuleWedgeVoxelizer | ( | GridPtr & | grid,
|  | const bool & | threaded = false,
|  | InterruptT * | interrupter = nullptr )
| inline

Constructor.

Parameters

  grid | scalar grid to populate the level set in
  threaded | center of the sphere in world units
  interrupter | pointer to optional interrupter. Use template argument util::NullInterrupter if no interruption is desired.

Note
  The voxel size and half width are determined from the input grid, meaning the voxel size and background value need to be set prior to voxelization

## Member Function Documentation

## ◆ circleBottom()

ValueT circleBottom | ( | const ValueT & | x0,
|  | const ValueT & | y0,
|  | const ValueT & | r,
|  | const ValueT & | x )
| inlinestaticprotectedinherited

Computes the bottom y-coordinate of a circle at a given x position.

Parameters

  x0 | X-coordinate of the circle's center.
  y0 | Y-coordinate of the circle's center.
  r | Radius of the circle.
  x | X-coordinate for which to compute the bottom y-coordinate.

Returns
  The y-coordinate at the bottom of the circle for the given x position.

## ◆ circleTop()

ValueT circleTop | ( | const ValueT & | x0,
|  | const ValueT & | y0,
|  | const ValueT & | r,
|  | const ValueT & | x )
| inlinestaticprotectedinherited

Computes the top y-coordinate of a circle at a given x position.

Parameters

  x0 | X-coordinate of the circle's center.
  y0 | Y-coordinate of the circle's center.
  r | Radius of the circle.
  x | X-coordinate for which to compute the top y-coordinate.

Returns
  The y-coordinate at the top of the circle for the given x position.

## ◆ halfWidth()

ValueT halfWidth | ( |  | ) | const
| inlineinherited

Return the half width of the narrow-band level set.

## ◆ iterate()

void iterate | ( |  | ) |
| inlineprotectedinherited

The function the derived class calls to create the level set, working in index space other than setting signed distance values.

Note
  This function handles both parallel and serial iterations. If running in serial mode, it flood fills the tile topology immediately; otherwise, it avoids duplicating nontrivial tree topology over multiple threads. This method also checks for background tiles that are too thin to fit and delegates accordingly.

## ◆ operator()()

template<typename GridType, typename InterruptT = util::NullInterrupter>
template<typename ScalarType>

void operator() | ( | const math::Vec3< ScalarType > & | pt1,
|  | const math::Vec3< ScalarType > & | pt2,
|  | const ScalarType & | radius,
|  | const math::Vec3< ScalarType > & | nrml1,
|  | const math::Vec3< ScalarType > & | nrml2 )
| inline

Create an open wedge.

Parameters

  pt1 | first endpoint open wedge in world units
  pt2 | second endpoint open wedge in world units
  radius | radius of the open prism in world units
  nrml1 | normal of a half space the the capsule is clipped with to form the open wedge
  nrml2 | normal of the other half space the the capsule is clipped with to form the open wedge

Note
  The normal vectors point outward from the open wedge, and the clipping half space is defined by the set of points that satisfy .

## ◆ sphereBottom()

ValueT sphereBottom | ( | const ValueT & | x0,
|  | const ValueT & | y0,
|  | const ValueT & | z0,
|  | const ValueT & | r,
|  | const ValueT & | x,
|  | const ValueT & | y )
| inlinestaticprotectedinherited

Computes the bottom z-coordinate of a sphere at a given (x, y) position.

Parameters

  x0 | X-coordinate of the sphere's center.
  y0 | Y-coordinate of the sphere's center.
  z0 | Z-coordinate of the sphere's center.
  r | Radius of the sphere.
  x | X-coordinate for which to compute the bottom z-coordinate.
  y | Y-coordinate for which to compute the bottom z-coordinate.

Returns
  The z-coordinate at the bottom of the sphere for the given (x, y) position.

## ◆ sphereTop()

ValueT sphereTop | ( | const ValueT & | x0,
|  | const ValueT & | y0,
|  | const ValueT & | z0,
|  | const ValueT & | r,
|  | const ValueT & | x,
|  | const ValueT & | y )
| inlinestaticprotectedinherited

Computes the top z-coordinate of a sphere at a given (x, y) position.

Parameters

  x0 | X-coordinate of the sphere's center.
  y0 | Y-coordinate of the sphere's center.
  z0 | Z-coordinate of the sphere's center.
  r | Radius of the sphere.
  x | X-coordinate for which to compute the top z-coordinate.
  y | Y-coordinate for which to compute the top z-coordinate.

Returns
  The z-coordinate at the top of the sphere for the given (x, y) position.

## ◆ tileCeil()

ValueT tileCeil | ( | const ValueT & | x,
|  | const ValueT & | step )
| inlinestaticprotectedinherited

Rounds an input scalar up to the nearest valid ordinate of tile of a specified size.

Parameters

  x | Input value.
  step | Tile step size.

Returns
  The ceiling of the value based on the tile size.

## ◆ tileFloor()

ValueT tileFloor | ( | const ValueT & | x,
|  | const ValueT & | step )
| inlinestaticprotectedinherited

Rounds an input scalar down to the nearest valid ordinate of tile of a specified size.

Parameters

  x | Input value.
  step | Tile step size.

Returns
  The ceiling of the value based on the tile size.

## ◆ tilePointSignedDistance()

ValueT tilePointSignedDistance | ( | const Vec3T & | p | ) | const
| inlineprotectedinherited

Computes the signed distance for tiles in index space, considering the center of the tile. This method is optional to override and defaults to `signedDistance`.

Parameters

  p | The point at the center of the tile in 3D space.

Note
  This can be useful for cases that build objects from multiple primitives, e.g. dilated mesh is built by constructing and unioning open prisms and open tube wedges. A tile might not fully fit in an open prism but might fit in the union of a prism and wedge, and so in this case it might make sense to use the sdf for an offset triangle on tiles during the open prism scan.

## ◆ voxelSize()

ValueT voxelSize | ( |  | ) | const
| inlineinherited

Return the voxel size of the grid.

## Friends And Related Symbol Documentation

## ◆ ConvexVoxelizer< GridType, OpenCapsuleWedgeVoxelizer< GridType, InterruptT >, InterruptT >

template<typename GridType, typename InterruptT = util::NullInterrupter>

friend class ConvexVoxelizer< GridType, OpenCapsuleWedgeVoxelizer< GridType, InterruptT >, InterruptT >
| friend

## Member Data Documentation

## ◆ bottomTop

std::function<bool(ValueT&, ValueT&, const ValueT&, const ValueT&)> bottomTop
| protectedinherited

Find where a vertical infinite line intersects a convex region dilated by the half width.

Parameters

  [out] | zb | Reference to the z ordinate where the bottom intersection occurs.
  [out] | zt | Reference to the z ordinate where the top intersection occurs.
  [in] | x | The x ordinate of the infinte line.
  [in] | y | The y ordinate of the infinte line.

Returns
  true if an intersection occurs; otherwise false.

Note
  The derived class can override this lambda to implement different behavior for degenerate cases.