HM_ExtAPI::GeomSurfaceGetParameterBounds()
Returns information about parameter range of the surface.
Syntax
bool GeomSurfaceGetParameterBounds(
const HM_EntityGeometrySurface & surf,
double& u_start_param,
double& u_end_param,
double& v_start_param,
double& v_end_param,
bool& no_u_bounds,
bool& no_v_bounds,
bool& u_periodic,
bool& v_periodic
);
Type
HyperMesh Ext API Function
Description
The function is supported for NURBS_SURFACE type only.
If one or more of extension value parameters (u_start_extend_value, u_end_extend_value, v_start_extend_value, v_end_extend_value) are zero or negative then those parameters are ignored and no extension is added to corresponding parametric boundary of the surface. If none of parameters is positive then the function returns false.
All parametric values are given in units relative to corresponding parametric range of the input surface. For example, if U parametric range of the surface is [-3…7] then extension value u_end_extend_value equal to 0.1 corresponds to absolute extension value of 1 (assuming extend_by_length3d is false) and will result in extension of the U parametric range of the surface to [-3…8]. The value of v_start_ref3d_u equal to 0.8 in this case corresponds to absolute U parameter value of reference point equal to 5.
Use the function HM_ExtAPI::GeomSurfaceGetParameterBounds() to obtain parametric range of the surface.
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
- surf
- [in] - Handle to surface object that was returned by previous calls to API functions.
- u_start_param
- [out] - Lower bound of surface U parameter range.
- u_end_param
- [out] - Upper bound of surface U parameter range.
- v_start_param
- [out] - Lower bound of surface V parameter range.
- v_end_param
- [out] - Upper bound of surface V parameter range.
- no_u_bounds
- [out] - Flag that specifies whether U parameterization of the surface has bounds. When function returns, this parameter can have one of following values.
- no_v_bounds
- [out] - Flag that specifies whether V parameterization of the surface has bounds. When function returns, this parameter can have one of following values.
- u_periodic
- [out] - Flag that specifies whether the surface is periodic on U parameter. When function returns, this parameter can have one of following values.
- v_periodic
- [out] - Flag that specifies whether the surface is periodic on V parameter. When function returns, this parameter can have one of following values.
Errors
None.