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)

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)

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)

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)

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)

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)

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)

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.