Navigate (FacetCollection)

Introduced

3.0

Description

Allows you to navigate through the facets of the associated geometry. This method returns one facet for each corresponding component in the collection. For example, if you have a FacetCollection containing 5 facets and you call this method with the direction set to siLastComponent, the returned collection will contain 5 instances of the last facet in the original FacetCollection.

Scripting Syntax

    FacetCollection.Navigate( Navigation )

C# Syntax

    FacetCollection FacetCollection.Navigate( siNavigateComponentType in_siNavigate );

Parameters

Parameter | Type | Description
Navigation | siNavigateComponentType | Select the direction of navigation.

Return Value

FacetCollection

Examples

VBScript Example

    set oObj = ActiveSceneRoot.AddGeometry( "Cube", "MeshSurface" )
    set oSubComp = oObj.ActivePrimitive.Geometry.Facets(2).SubComponent
    oSubComp.AddElement(3)
    set oFacets = oSubComp.ComponentCollection
    set oFirstFacets = oFacets.Navigate(siFirstComponent)
    LogMessage "The associated first facets are "
    for each facet in oFirstFacets
    LogMessage facet.index & " "
    next

    set oLastFacets = oFacets.Navigate(siLastComponent)
    LogMessage "The associated last facets are "
    for each facet in oLastFacets
    LogMessage facet.index & " "
    next

    set oNextFacets = oFacets.Navigate(siNextComponent)
    LogMessage "The associated next facets are "
    for each facet in oNextFacets
    LogMessage facet.index & " "
    next

    set oPreviousFacets = oFacets.Navigate(siPreviousComponent)
    LogMessage "The associated previous facets are "
    for each facet in oPreviousFacets
    LogMessage facet.index & " "
    next

See Also

Facet.Navigate | Geometry.Facets | SubComponent.AddElement | SubComponent.ComponentCollection

Autodesk Softimage v7.5