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: In Rhino 7: Defaulted options | 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 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 | |
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 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 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 Ignored options | Rhino 6 Helpfile (STEP export) Rhino 7 Helpfile (STEP export) |
STL | Allowed object types Available options 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. | |
