Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -1,10 +1,11 @@
---
title: Insert
excerpt: Insert workflows for assemblies in Zoo Design Studio.
title: Import
excerpt: Import workflows for assemblies in Zoo Design Studio.
sidebarPosition: 0
---

Insert is the current point-and-click assembly workflow in Zoo Design Studio. Use it to place an
Import is the current point-and-click assembly workflow in Zoo Design Studio. Use it to place an
existing single-body part into the active main assembly so it can be positioned and referenced.
The Import command generates a KCL `import` statement for the selected project file.
Current support is focused on single-body part insertion, not nested subassemblies or broader
multi-body assembly structures.
Original file line number Diff line number Diff line change
Expand Up @@ -8,4 +8,4 @@ Assemblies define how separate parts are positioned and oriented within a single
Current assembly workflows focus on inserting single-body parts into the main assembly. Nested
subassemblies and broader multi-body insertion workflows are not yet part of the supported assembly
flow. For the current in-app workflow, start with
[Insert](/docs/zoo-design-studio/features/3d-design/assemblies/insert).
[Import](/docs/zoo-design-studio/features/3d-design/assemblies/import).
Original file line number Diff line number Diff line change
Expand Up @@ -116,22 +116,9 @@ Use the **Add file to project** command to import local files or Zoo sample mode
4. Select sample from library
5. Choose to add to current or new project

### Import File from URL
### Import Command (KCL)

Import remote files directly from web URLs:

1. Open Command Bar
2. Select "Import file from URL"
3. Specify import method (add to current or create new project)
4. Enter remote file URL
5. Specify filename and optional project name

Supported URL formats:
- Direct file links (https://example.com/model.step)
- Cloud storage shared links (Google Drive, Dropbox, OneDrive)
- Repository raw file URLs (GitHub, GitLab)

### Insert Command (KCL)
Previously named **Insert**, the **Import** command can be found by searching for either name in the Command Bar.

Reference existing project files from within KCL code:

Expand All @@ -146,7 +133,7 @@ import utils from "./library/utils.kcl"
import reference from "./reference/concept.glb"
```

The `Insert` command (available via Command Bar) provides a UI workflow for the same functionality:
The `Import` command (available via Command Bar and the toolbar) provides a UI workflow for the same functionality:
1. Select file from project directory
2. Specify local variable name for the imported geometry
3. KCL import statement is automatically generated
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -50,19 +50,19 @@ before referencing it from KCL.

## Add the STEP import to KCL

With the STEP file in Project Files, use the insert action to add the import statement to the
With the STEP file in Project Files, use the Import action to add the import statement to the
active KCL file. Zoo Design Studio writes the import line for you, so you do not need to type the
filename manually.

<FramedImage
src="/documentation-assets/docs/zoo-design-studio/features/data-management/import/step/import-step-to-kcl.gif"
alt="Using the Project Files insert action to add a STEP import statement to main.kcl"
alt="Using the Project Files Import action to add a STEP import statement to main.kcl"
aspect="1280 / 733"
maxHeightPx="780"
/>
<br />
<div>
Use the insert action from Project Files to add the STEP import line to `main.kcl`
Use the Import action from Project Files to add the STEP import line to `main.kcl`
</div>

## Recommended KCL syntax
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -66,8 +66,6 @@ Settings commands control application preferences, display options, and modeling

**Rename project:** Change project name (old name → new name).

**Import file from URL:** Import remote files into project (STEP, KCL, etc.).

### File Operations Commands

**Add file to project:** Import local files or Zoo samples into project.
Expand Down Expand Up @@ -136,7 +134,7 @@ Parameters:

**Set experimental features flag:** Enable/disable experimental KCL features (`warn`, `allow`, `none`).

**Insert:** Import from project file (STEP, GLB, FBX, KCL) with local variable binding.
**Import:** Import from project file (STEP, GLB, FBX, KCL) with local variable binding.

**Format Code:** Apply standard formatting to KCL code editor content.

Expand Down
2 changes: 1 addition & 1 deletion content/pages/docs/zoo-design-studio/getting-started.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -178,6 +178,6 @@ Click Create from Sample on the project dashboard to browse available KCL exampl

Zoo Design Studio supports various file formats for interoperability with other CAD systems:

- **Importing**: Add external models to your project by selecting Insert from the top command bar. Supported formats include `STEP`, `.sldprt` and `STL`. For further details see the [KCL docs](https://zoo.dev/docs/kcl-lang/foreign-imports).
- **Importing**: Add external models to your project by selecting Import from the top command bar. Supported formats include `STEP`, `.sldprt` and `STL`. For further details see the [KCL docs](https://zoo.dev/docs/kcl-lang/foreign-imports).
- **Exporting**: Save your designs for use in other applications by choosing File → Export and selecting your desired format: `STEP`, `STL`, `gLTF`, `OBJ`, or `PLY`.
- For models created with Zookeeper, your generated geometry is automatically saved in the project folder and can be exported to any supported format at any time.
Loading