SoShape.BeginShape Method (SoAction, SoShape.TriangleShapes, SoFaceDetail)

SoShapeBeginShape Method (SoAction, SoShapeTriangleShapes, SoFaceDetail)

These methods can be used by subclasses to generate triangles more easily when those triangles are part of a larger structure, such as a triangle strip, triangle fan, or triangulated polygon, according to the TriangleShape enumerated type.

Namespace: OIV.Inventor.Nodes
Assembly: OIV.Inventor (in OIV.Inventor.dll) Version: 2024.2.0.0 (2024.2.0)

Syntax

C++

Copy

[EditorBrowsableAttribute(EditorBrowsableState.Advanced)]
public void BeginShape(
	SoAction action,
	SoShapeTriangleShapes shapeType,
	SoFaceDetail faceDetail
)

<EditorBrowsableAttribute(EditorBrowsableState.Advanced)>
Public Sub BeginShape ( 
	action As SoAction,
	shapeType As SoShapeTriangleShapes,
	faceDetail As SoFaceDetail
)

public:
[EditorBrowsableAttribute(EditorBrowsableState::Advanced)]
void BeginShape(
	SoAction^ action, 
	SoShapeTriangleShapes shapeType, 
	SoFaceDetail^ faceDetail
)

[<EditorBrowsableAttribute(EditorBrowsableState.Advanced)>]
member BeginShape : 
        action : SoAction * 
        shapeType : SoShapeTriangleShapes * 
        faceDetail : SoFaceDetail -> unit

Parameters

action: Type: OIV.Inventor.ActionsSoAction
shapeType: Type: OIV.Inventor.NodesSoShapeTriangleShapes
faceDetail: Type: OIV.Inventor.DetailsSoFaceDetail

Remarks

The sequence of calls is similar to GL's: begin a shape, send vertices of that shape, then end the shape.

If the face detail passed to OIV.Inventor.Nodes.SoShape.BeginShape(OIV.Inventor.Actions.SoAction, OIV.Inventor.Nodes.SoShape.TriangleShapes, OIV.Inventor.Details.SoFaceDetail) is NULL (the default), the details in the vertices will be used as is. Note that some vertices may be copied into local storage; the detail pointers are copied as well, so the details themselves should be consistent for the duration of the shape generation.

If the face detail passed to OIV.Inventor.Nodes.SoShape.BeginShape(OIV.Inventor.Actions.SoAction, OIV.Inventor.Nodes.SoShape.TriangleShapes, OIV.Inventor.Details.SoFaceDetail) is non-NULL, the details in the vertices are assumed to be SoPointDetails. Each vertex of each triangle generated will contain a pointer to the face detail, which will be filled with three copies of the point details from the relevant vertices. Since copies of the point details are made, the storage for each point detail passed to OIV.Inventor.Nodes.SoShape.ShapeVertex(OIV.Inventor.SoPrimitiveVertex@) can be re-used by the caller.

Reference

SoShape Class

BeginShape Overload

OIV.Inventor.Nodes Namespace