CFacetRefArray Class Reference

Related Scripting Object: FacetCollection

An array of Facet objects representing all segments of the underlying Geometry object. More...

#include <xsi_facet.h>

Inheritance diagram for CFacetRefArray:

Detailed Description

Warning:

This specialized array is returned by Geometry::GetFacets, it is not meant to be created and modified in user-defined functions. If you want to add and remove arbitrary items to a collection, you must use a CRefArray instead.

See also:

Geometry::GetFacets

Example:

        using namespace XSI;
        using namespace MATH;

        Application app;
        Model root = app.GetActiveSceneRoot();

        X3DObject myCube;
        root.AddGeometry( L"Cube", L"MeshSurface", L"", myCube );

        CFacetRefArray facets( myCube.GetActivePrimitive().GetGeometry().GetFacets() );

        CVector3Array normArray = facets.GetNormalArray();

        app.LogMessage( facets.GetClassIDName() );
        app.LogMessage( CValue(normArray.GetCount()).GetAsText() );

        for (LONG i=0; i<normArray.GetCount(); i++)
        {
            app.LogMessage( L"Normal " + CValue(i).GetAsText() );

            app.LogMessage(
                CValue(normArray[i].GetX()).GetAsText() + L"," +
                CValue(normArray[i].GetY()).GetAsText() + L"," +
                CValue(normArray[i].GetZ()).GetAsText() );
        }

Constructor & Destructor Documentation

Copy constructor.

Parameters:

in_array

constant CFacetRefArray reference object.

Member Function Documentation

Returns the Facet object in the array matching the specified name.

Parameters:

in_name

The name of the Facet to get.

Returns:

A reference to the specified Facet object.

Reimplemented from CRefArray.

Reimplemented in CNurbsSurfaceRefArray, and CPolygonFaceRefArray.

Returns the number of Facet objects in the array.

Returns:

The number of Facet objects.

Reimplemented from CRefArray.

Reimplemented in CNurbsSurfaceRefArray, and CPolygonFaceRefArray.

Returns whether this array is a valid object.

Returns:

True if valid, false otherwise.

Reimplemented from CRefArray.

Reimplemented in CNurbsSurfaceRefArray, and CPolygonFaceRefArray.

Returns an array of normals expressed with CVector3 objects.

Returns:

Array of CVector3 objects.

Reimplemented in CPolygonFaceRefArray.

Returns an array of indices in this CFacetRefArray.

Returns:

Array of (LONG) indices.

Creates a SubComponent object from this Facet array,

Returns:

A SubComponent object

Navigates the Facet objects of the underlying geometry as specifed by the navigation component type (siNavigateComponentType). An array of Facet objects corresponding to each Facet object visited is returned. Navigation is circular -- for instance, navigating beyond the last component will return the first and vice versa.

Parameters:

in_siNavigate

Type of direction for navigating the Facet objects (one of the siNavigateComponentType values).

Returns:

An array of refernces to Facet objects.

• xsi_facet.h