CIP Visual Basic.NET documentation for interface "IpfcSurface"

Interface IpfcSurface

Description

This class defines a surface.

Direct Parent Classes:: IpfcModelItem

Direct Known Subclasses:: IpfcTransformedSurface, IpfcCoonsPatch, IpfcFilletSurface, IpfcSpline2DerSurface, IpfcSplineSurface, IpfcNURBSSurface

Property Summary


`Property`	`IsVisible`	`as Boolean`
	true if the geometry is visible and active, false if it is invisible and inactive. Inactive geometry may not have all geometric properties defined.

`Property`	`OwnerQuilt`	`as IpfcQuilt [readonly, optional]`
	The quilt that contains the surface.

Method Summary


`Function`	`Eval3DData (Params as IpfcUVParams) as IpfcSurfXYZData`
	Evaluates the surface in the specified UV point.

`Function`	`EvalArea () as Double`
	Finds the surface area.

`Function`	`EvalClosestPoint (ToPoint as IpfcPoint3D) as IpfcPoint3D [optional]`
	Finds the point on the surface that is closest to the given point.

`Function`	`EvalClosestPointOnSurface (ToPoint as IpfcPoint3D) as IpfcPoint3D [optional]`
	Determines whether the specified point is within a small epsilon value of the invoking surface.

`Function`	`EvalDiameter (Params as IpfcUVParams [optional]) as Double`
	Finds the surface diameter at the specified UV point.

`Function`	`EvalMaximum (Proj as IpfcVector3D) as IpfcPoint3D`
	Finds the coordinates of the surface edge at the maximum projection, in the specified direction. The accuracy of this result is limited to the accuracy of the edge tessellation.

`Function`	`EvalMinimum (Proj as IpfcVector3D) as IpfcPoint3D`
	Finds the coordinates of the surface edge at the minimum projection, in the specified direction. The accuracy of this result is limited to the accuracy of the edge tessellation.

`Function`	`EvalParameters (Point as IpfcPoint3D) as IpfcUVParams`
	Finds the corresponding UV point on the surface, given the XYZ point.

`Function`	`EvalPrincipalCurv (Params as IpfcUVParams) as IpfcCurvatureData`
	This method returns the principal curvatures and directions of a surface at a specified UV point.

`Function`	`GetFeature () as IpfcFeature`
	Returns the feature which contains the geometry.

`Function`	`GetNURBSRepresentation () as IpfcNURBSSurfaceDescriptor`
	This method calculates the surface geometry as a non-uniform rational B-spline surface.

`Function`	`GetOrientation () as IpfcSurfaceOrientation`
	This method returns the orientation of the surface

`Function`	`GetSurfaceDescriptor () as IpfcSurfaceDescriptor`
	This method returns a data object representing the geometry of the surface.

`Function`	`GetSurfaceType () as IpfcSurfaceType`
	This method returns the type of the surface.

`Function`	`GetUVExtents () as IpfcUVOutline`
	This method returns the UV parameters at the corners of the surface.

`Function`	`GetXYZExtents () as IpfcOutline3D`
	This method returns the XYZ points at the corners of the surface.

`Function`	`ListContours () as IpfcContours`
	Lists all the contours on the surface.

`Function`	`ListSameSurfaces () as IpfcSurfaces`
	Finds and returns an array of surfaces that are the same as the input surface. For example, in the case of a cylinder, Creo Parametric creates two, half-cylindrical surfaces. If you input one half of the cylinder, this function returns the other half.

`Function`	`VerifyUV (Params as IpfcUVParams) as IpfcPlacement`
	Verifies whether the specified UV point lies within the surface boundaries.

Property Detail

Property IsVisible as Boolean

true if the geometry is visible and active, false if it is invisible and inactive. Inactive geometry may not have all geometric properties defined.

Property OwnerQuilt as IpfcQuilt [readonly, optional]

The quilt that contains the surface.

Exceptions thrown (but not limited to):

IpfcXToolkitNotFound - The specified surface does not belong to any quilt.

Method Detail

Function Eval3DData (Params as IpfcUVParams) as IpfcSurfXYZData

Evaluates the surface in the specified UV point.

The function returns the following information:

The resulting XYZ point
The first and second derivatives
The normal to the surface

Parameters:

Params: The UV parameter on the surface

Returns:: The evaluation data

Function EvalArea () as Double

Finds the surface area.

Exceptions thrown (but not limited to):

IpfcXToolkitOutOfRange - Surface area is too small (almost zero).

Returns:: The surface area

Function EvalClosestPoint (ToPoint as IpfcPoint3D) as IpfcPoint3D [optional]

Finds the point on the surface that is closest to the given point.

Exceptions thrown (but not limited to):

IpfcXToolkitNotFound - Projection of the point to the surface was not found.

Parameters:

ToPoint: The XYZ point

Returns:: The closest point in the surface

Function EvalClosestPointOnSurface (ToPoint as IpfcPoint3D) as IpfcPoint3D [optional]

Determines whether the specified point is within a small epsilon value of the invoking surface.

Parameters:

ToPoint: The point to evaluate

Returns:: If the point is within tolerance, the method returns the closest three-dimensional point that is on the surface. If the specified point is not within tolerance, the method returns null.

Function EvalDiameter (Params as IpfcUVParams [optional]) as Double

Finds the surface diameter at the specified UV point.

Parameters:

Params: The UV point. This is ignored when the surface diameter is constant.

Returns:: The resulting diameter

Function EvalMaximum (Proj as IpfcVector3D) as IpfcPoint3D

Finds the coordinates of the surface edge at the maximum projection, in the specified direction. The accuracy of this result is limited to the accuracy of the edge tessellation.

Parameters:

Proj: The direction of projection

Returns:: The coordinates of the point where the function finds the maximum projection

Function EvalMinimum (Proj as IpfcVector3D) as IpfcPoint3D

Finds the coordinates of the surface edge at the minimum projection, in the specified direction. The accuracy of this result is limited to the accuracy of the edge tessellation.

Parameters:

Proj: The direction of projection

Returns:: The coordinates of the point where the function finds the minimum projection

Function EvalParameters (Point as IpfcPoint3D) as IpfcUVParams

Finds the corresponding UV point on the surface, given the XYZ point.

Exceptions thrown (but not limited to):

IpfcXToolkitNotFound - Projection of the point to the surface was not found.

Parameters:

Point: The XYZ point. The point does not need to lie on the surface. If the point is off the surface, the function finds the closest surface point.

Returns:: The corresponding UV point

Function EvalPrincipalCurv (Params as IpfcUVParams) as IpfcCurvatureData

This method returns the principal curvatures and directions of a surface at a specified UV point.

Exceptions thrown (but not limited to):

IpfcXToolkitBadSrfCrv - The input argument is invalid.

Parameters:

Params: The UV point

Returns:: The minimum and maximum curvatures at the specified point and theprincipal directions at the point

Function GetFeature () as IpfcFeature

Returns the feature which contains the geometry.

Returns:: The feaature.

Function GetNURBSRepresentation () as IpfcNURBSSurfaceDescriptor

This method calculates the surface geometry as a non-uniform rational B-spline surface.

Returns:: The NURBS surface geometry.

Function GetOrientation () as IpfcSurfaceOrientation

This method returns the orientation of the surface

Returns:: The surface orientation

Function GetSurfaceDescriptor () as IpfcSurfaceDescriptor

This method returns a data object representing the geometry of the surface.

Returns:: The surface descriptor

Function GetSurfaceType () as IpfcSurfaceType

This method returns the type of the surface.

Returns:: The surface type

Function GetUVExtents () as IpfcUVOutline

This method returns the UV parameters at the corners of the surface.

Returns:: The UV parameters.

Function GetXYZExtents () as IpfcOutline3D

This method returns the XYZ points at the corners of the surface.

Returns:: The XYZ points.

Function ListContours () as IpfcContours

Lists all the contours on the surface.

Exceptions thrown (but not limited to):

IpfcXToolkitNotFound - No contours were visited (either because of the filter or for another reason).

Returns:: The list of contours

Function ListSameSurfaces () as IpfcSurfaces

Finds and returns an array of surfaces that are the same as the input surface. For example, in the case of a cylinder, Creo Parametric creates two, half-cylindrical surfaces. If you input one half of the cylinder, this function returns the other half.

Returns:: The array of surfaces

Function VerifyUV (Params as IpfcUVParams) as IpfcPlacement

Verifies whether the specified UV point lies within the surface boundaries.

Parameters:

Params: The UV point to test

Returns:

The resulting status. The function returns one of the following values:

PLACE_ON_BOUNDARY -- The point is on the contour.
PLACE_OUTSIDE -- The point is outside the contour.
PLACE_INSIDE -- The point is inside the contour.