Drake
Drake C++ Documentation
Convex Class Referencefinal

Detailed Description

Definition of a convex surface mesh.

This shape is not the mesh contained in the file named by filename. It is the convex hull of that mesh. As such, the only contents of the mesh file that matter are the vertex positions. All other data is ignored. This includes materials, textures, normals etc. This is true for all roles. Its appearance in an illustration or perception role, will be a faceted polytope whose color is defined by its assigned properties (or by the geometry consumer's defaults).

Because Drake computes the convex hull, the named mesh file need not be convex.

The mesh is defined in a canonical frame C, implicit in the file parsed. Upon loading it in SceneGraph it can be scaled around the origin of C by a given scale amount.

#include <drake/geometry/shape_specification.h>

Public Member Functions

 Convex (const std::string &filename, double scale=1.0)
 Constructs a convex shape specification from the file located at the given file path. More...
 
 ~Convex () final
 
const std::string & filename () const
 
const std::string & extension () const
 Returns the extension of the mesh filename – all lower case and including the dot. More...
 
double scale () const
 
const PolygonSurfaceMesh< double > & convex_hull () const
 Reports the convex hull of the named mesh. More...
 
Implements CopyConstructible, CopyAssignable, MoveConstructible, MoveAssignable
 Convex (const Convex &)=default
 
Convexoperator= (const Convex &)=default
 
 Convex (Convex &&)=default
 
Convexoperator= (Convex &&)=default
 
- Public Member Functions inherited from Shape
virtual ~Shape ()
 
void Reify (ShapeReifier *reifier, void *user_data=nullptr) const
 Causes this description to be reified in the given reifier. More...
 
std::unique_ptr< ShapeClone () const
 Creates a unique copy of this shape. More...
 
std::string_view type_name () const
 Returns the (unqualified) type name of this Shape, e.g., "Box". More...
 
std::string to_string () const
 Returns a string representation of this shape. More...
 
template<typename ReturnType = void, typename Visitor >
decltype(auto) Visit (Visitor &&visitor) const
 Calls the given visitor function with *this as the sole argument, but with *this downcast to be the shape's concrete subclass. More...
 

Additional Inherited Members

- Protected Types inherited from Shape
using VariantShapeConstPtr = std::variant< const Box *, const Capsule *, const Convex *, const Cylinder *, const Ellipsoid *, const HalfSpace *, const Mesh *, const MeshcatCone *, const Sphere * >
 (Internal use only) All concrete subclasses, as const pointers. More...
 
- Protected Member Functions inherited from Shape
 Shape ()
 (Internal use only) Constructor for use by derived classes. More...
 
 Shape (const Shape &)=default
 (Internal use only) For derived classes. More...
 
Shapeoperator= (const Shape &)=default
 (Internal use only) For derived classes. More...
 
 Shape (Shape &&)=default
 (Internal use only) For derived classes. More...
 
Shapeoperator= (Shape &&)=default
 (Internal use only) For derived classes. More...
 

Constructor & Destructor Documentation

◆ Convex() [1/3]

Convex ( const Convex )
default

◆ Convex() [2/3]

Convex ( Convex &&  )
default

◆ Convex() [3/3]

Convex ( const std::string &  filename,
double  scale = 1.0 
)
explicit

Constructs a convex shape specification from the file located at the given file path.

Optionally uniformly scaled by the given scale factor.

The mesh file referenced can be an .obj, .gltf, or a tetrahedral .vtk.

Parameters
filenameThe file name; if it is not absolute, it will be interpreted relative to the current working directory.
scaleAn optional scale to coordinates.
Exceptions
std::exceptionif |scale| < 1e-8. Note that a negative scale is considered valid. We want to preclude scales near zero but recognise that scale is a convenience tool for "tweaking" models. 8 orders of magnitude should be plenty without considering revisiting the model itself.

◆ ~Convex()

~Convex ( )
final

Member Function Documentation

◆ convex_hull()

const PolygonSurfaceMesh<double>& convex_hull ( ) const

Reports the convex hull of the named mesh.

Note: the convex hull is computed on demand on the first invocation. All subsequent invocations should have an O(1) cost.

Exceptions
ifthe referenced mesh data cannot be read or is degenerate (insufficient number of vertices, co-linear or coincident vertices, etc.) All of the vertices lying on a plane is not considered degenerate.

◆ extension()

const std::string& extension ( ) const

Returns the extension of the mesh filename – all lower case and including the dot.

In other words /foo/bar/mesh.obj and /foo/bar/mesh.OBJ would both report the ".obj" extension. The "extension" portion of the filename is defined as in std::filesystem::path::extension().

◆ filename()

const std::string& filename ( ) const

◆ operator=() [1/2]

Convex& operator= ( Convex &&  )
default

◆ operator=() [2/2]

Convex& operator= ( const Convex )
default

◆ scale()

double scale ( ) const

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