HM_ExtAPI::CreateSurfaceRevolution()

Creates revolution surface object.

Syntax

bool CreateSurfaceRevolution(
HM_EntityGeometrySurface& new_surf,
const HM_EntityGeometryCurve& generator_curve,
const HM_Point& center,
const HM_Vector& axis
);

Type

HyperMesh Ext API Function

Description

The function creates the surface object of the type HM_ExtAPI::REVOLUTION_SURFACE().

Surface of revolution is defined by "generator" curve and rotation axis. The surface is obtained by rotating the curve around the axis in counter clockwise direction. Parameter V corresponds to the parameter of the curve. Parameter U corresponds to the rotation angle.

Parametrically, the surface of revolution can be represented as

S(U, V) = A + n (n R(V)) + [R(V) - n (n R(V))] cos U + [n X R(V)] sin U

Where n = N / | N | is the unit axis vector and R(V) = C(V) - A is the radius vector from the axis origin A to the point on the curve.

Parameters used by CreateSurfaceRevolution surface parameters
generator_curve C(V)
center A
axis N

If the function succeeds, the return value is true. If the function fails, the return value is false. To get extended value information, call HM_ExtAPI::GetLastErrorCode().

Requires including hm_extapi.h.

Inputs

new_surf
[out] - Handle to new surface object.
generator_curve
[in] - Handle to curve object that represents the curve used to generate revolution surface. The handle that was returned by previous calls to API functions must be used.
center
[in] - Point on revolution axis.
axis
[in] - Revolution on axis vector.

Errors

None.