ExtractSurface

Separates or copies a surface (face) or a copy of a surface from a polysurface.

Syntax

Rhino.ExtractSurface (strObject, intFaceIndex [, blnCopy [, blnSurface]])

Rhino.ExtractSurface (strObject, arrFaceIndices [, blnCopy [, blnSurface]])

Parameters

Parameters

strObject

Required.  String.  The polysurface object's identifier.

intFaceIndex

Required.  Number.  The index of the face to extract.

arrFaceIndices

Required.  Array.  The indices of the faces to extract.

blnCopy

Optional.  Boolean.  If True, the faces are copied. If False (Default), the faces are extracted.

blnSurface

Optional.  Boolean.  If True, the underlying, untrimmed surfaces are copied. If False (Default), the faces are extracted.  Note, if this parameter is True, then blnCopy will automatically be set to True.

Returns

String

If intFaceIndex is specified, the identifier of the extracted surface object if successful.

Array

If arrFaceIndices is specified, the identifiers of the extracted surface objects if successful.

Null

If not successful, or on error.

Example

Const rhPolysrf = 16

Dim strObject

strObject = Rhino.GetObject("Select polysurface", rhPolysrf, true)

If Not IsNull(strObject) Then

  Call Rhino.ExtractSurface(strObject, 0)

End If

Also See

BrepClosestPoint

IsSurface

IsPolysurface

SurfaceCount