Skip to main content
Skip table of contents

Export Options

The ShapeDiver plugin comes with several new primitives added to Grasshopper, including the Export Options primitive. Export Options are one of the inputs of the Download Export and Email Export components. They are used to define the file format used for exporting, as well as various export options which correspond to the options that are available in Rhino when using the _Export command.

Typically, one would create Export Options using one of the components of the Outputs category. The current export options components available are listed below. For each of them, we link to the Rhino documentation page that lists the available options.

The available export options for each supported file type do not always include all the export options available in Rhino, either because those options do not make sense in the context of ShapeDiver or because they are not supported yet. Let us know if you are missing important export options in the forum.

File format

Options

Resources

3DM

Available options

In Rhino 6, the following options are available:

  • Version (between 1 and 6)

In Rhino 7:

  • Version (between 1 and 7)

Defaulted options

  • SaveSmall (always Yes)

  • GeometryOnly (always No)

  • SaveTextures (always No)

  • SaveNotes (alway No)

  • SavePlugInData (always Yes)

Rhino 6 Helpfile (3dm export)

Rhino 7 Helpfile (3dm export)

Rhino 6 Helpfile (Save As 3dm)

Rhino 7 Helpfile (Save As 3dm)

3DS

Allowed object types

  • Only meshes allowed, therefore no meshing options are exposed in the component.

Ignored options

  • SaveLights (always No, not available in Rhino 6)

  • SaveViews (always No, not available in Rhino 6)

And all meshing options.

Rhino 6 Helpfile (3ds export)

Rhino 7 Helpfile (3ds export)

3MF

Available options

  • Title (Text)

  • Designer (Text)

  • Description (Text)

  • Copyright (Text)

  • LicenseTerms (Text)

  • Rating (Text)

  • MoveOutputToXYZOctant (Yes or No)

DXF and DWG

Available options

  • SurfacesAs (Curves or Meshes or Solids)

  • MeshesAs (Meshes or 3dFaces)

  • Project (None or CPlane)

  • FullLayerPaths (Yes or No)

  • ColorMethod (RGB or ACI)

  • ArcNormals (Preserve or Flip)

  • UseLwPolys (Yes or No)

  • LinesAs (Lines or Polylines or 3dPolylines or Splines)

  • ArcsAs (Lines or Arcs or Polylines or Polybulges or 3dPolylines or Splines)

  • PolylinesAs (Lines or Polylines or 3dPolylines or Splines)

  • CurvesAs (Lines or Polylines or 3dPolylines or Splines)

  • PolycurvesAs (Lines or Arcs or Polylines or Polybulges or 3dPolylines or Splines)

  • UseMaxAngle (Yes or No)

  • MaxAngle (Number)

  • UseChordHeight (Yes or No)

  • ChordHeight (Number)

  • UseSegLength (Yes or No)

  • SegLength (Number)

  • ExplodePolycurves (Yes or No)

  • SplitAtKinks (Yes or No)

  • Simplify (Yes or No)

  • SimplifyTol (Number)

Rhino 6 Helpfile (dxf and dwg export)

Rhino 7 Helpfile (dxf and dwg export)

Rhino 6 Helpfile (AcadSchemes)

Rhino 7 Helpfile (AcadSchemes)

FBX

Allowed object types

  • Meshes and NURBS allowed, NURBS are converted to meshes

Available options

  • Map Rhino Z to FBX Y (Yes or No)

  • Export Vertex Normals (Rhino 7 only) (Yes or No)

  • Export file format (Version7Binary or Version7Ascii or Version6Binary or Version6Ascii)

Ignored options

  • Export NURBS objects as (always use Mesh)

  • Export materials as (no materials can be exported at the moment)

  • Export Lights (no lights can be exported at the moment)

  • Export Views (no views can be exported at the moment)

Rhino 6 Helpfile (FBX export)

Rhino 7 Helpfile (FBX export)

OBJ

Allowed object types

  • Only meshes allowed, therefore no meshing options are exposed in the component.

Available options

  • EndOfLine (CRLF or LF or CR)

  • YUp (Yes or No)

  • WrapLongLines (Yes or No)

  • WritePrecision (integer >= 1)

  • ExportMeshTextureCoordinates (Yes or No)

  • ExportMeshVertexNormals (Yes or No)

  • ExportMeshVertexColors (Yes or No)

  • ExportOpenMeshes (Yes or No)

  • ExportRhinoGroupOrLayerNames (DoNotExportgroupNames or ExportObjectsasOBJGroups or ExportObjectsasOBJObjects)

Ignored options

  • Geometry (always use Mesh)

  • ExportRhinoObjectNames (always use DoNotExportObjectNames)

  • ExportMaterialDefinitions (always use No)

  • ChangeWhitespaceToUnderscores (does not apply, because ExportMaterialDefinitions=No)

  • UseDisplayColorForMaterial (only available in Rhino 7, does not apply, because ExportMaterialDefinitions=No)

  • VertexWelding (always use Unmodified)

  • SubDMeshing (only Rhino 7, does not apply because we will allow meshes only)

  • SubDLevel (only Rhino 7, does not apply because we will allow meshes only)

  • CreateNGons (only in Rhino 6, always use No)

  • NGonMode (only in Rhino 7, always use Preserve)

And all meshing options.

Rhino 6 Helpfile (OBJ export)

Rhino 7 Helpfile (OBJ export)

SKP

Available options

  • SaveAsType (Sketchup3 through Sketchup8 and Sketchup2013 through Sketchup2015 for Rhino 6, Sketchup2016 through Sketchup2021 additionally for Rhino 7)

  • ExportPlanarRegionsAsPolygons (Yes or No)

  • CullUnnecessaryVertices (Yes or No) - only used if ExportPlanarRegionsAsPolygons is true

  • MinimumFaceCount (Yes or No) - only used if ExportPlanarRegionsAsPolygons is true

Rhino 6 Helpfile (SKP export)

Rhino 7 Helpfile (SKP export)

STEP

Available options

  • Schema (AP203ConfigControlDesign or AP214AutomotiveDesign or AP214AutomotiveDesignCC2)

  • Space Curves (Yes or No)

  • Split Closed Surfaces (Yes or No)

Ignored options

  • LetImportingApplicationSetColorForBlackObjects (always use No).

Rhino 6 Helpfile (STEP export)

Rhino 7 Helpfile (STEP export)

STL

Allowed object types

  • Only meshes allowed, therefore no meshing options are exposed in the component.

Available options

  • ExportFileAs (Binary or ASCII)

Ignored options

  • ExportUnfinishedObjects (always Yes)

  • UseSimpleDialog (always No)

  • UseSimpleParameters (always No)

And all meshing options.

Rhino 6 Helpfile (STL export)

Rhino 7 Helpfile (STL export)

Stream

Available options

  • Content Type: This option lets you specify either a file ending (ex: txt), a MIME type (ex: text/plain) or both separated by a comma (ex: txt, text/plain). This option is a way to export any file type from the Download Export and Email Export components, so long as they are converted to data streams before being sent to the export component.

  • File Ending: This option lets you specify a custom file ending for the selected MIME type, different from the default one.

Set of options for image exports

Available options

  • Format (jpg, png, tiff, bmp, gif)

  • QualityLevel (integer between 1 and 100, only relevant for jpg files)

If no Options component is connected, Bitmap primitives are exported as png files by default (with QualityLevel not used so any value).

Set of options for text file exports

Available options

  • Extension (txt, csv, g, gcode, json, xml, ifc)

  • EndOfLine (CRLF or LF or CR)

  • Encoding (ASCII or UTF-8 or UTF-8-NO-BOM)

If no Options component is connected, Text primitives are exported as txt files by default (with CRLF and UTF-8 encoding).

Set of options for pdf exports

None. No export component for PDF files because all options are defined in the PDF components.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.