UnrollSurface

Flattens (develops) a surface or polysurface to a planar surface. For more information on developable surfaces, see the Rhino help file.

Syntax

rhinoscriptsyntax.UnrollSurface (surface_id, explode=False, following_geometry=None, absolute_tolerance=None, relative_tolerance=None)

Parameters

surface_id

Required.  String or Guid.  The identifier of the surface or polysurface to unroll.

explode

Optional.  Boolean.  If True, then resulting surfaces are not joined. If False (Default), then resulting surfaces are joined along the same edges that were joined in the original polysurface.

following_geometry

Optional. List of strings or guids. Identifiers of curves or textdots that are on the unrolled surface and should be unrolled along with the surface

Returns

List

If following_geometry is None, list of the flattened surfaces or polysurfaces if successful

Tuple of two Lists

If following_geometry is not None, a tuple of two lists

List 1 - The identifiers of the flatten surfaces or polysurfaces if successful.

List 2- The identifiers of the flatten following geometry that was unrolled with the surface

None

If not successful, or on error.

Example

import rhinoscriptsyntax as rs

surface = rs.GetObject("Select surface or polysurface to unroll", rs.filter.surface + rs.filter.polysurface)

if surface: rs.UnrollSurface(surface)

Also See

IsSurfaceUnrollable