Skip to content

Document clones created through Import #1035

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
pierremtb wants to merge 1 commit into
base: codex/rename-insert-to-import
Choose a base branch
from
Draft

Document clones created through Import #1035

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
12 changes: 11 additions & 1 deletion ...ent/pages/docs/zoo-design-studio/features/3d-design/assemblies/insert/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,16 @@ sidebarPosition: 0

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.

The first time you import a project file, Import generates a KCL `import` statement with the
local name you choose. If the file already has a whole-file import with an alias, Import adds
another instance using `clone(...)` instead of adding a second import statement.

You stay in Import to choose the new instance name and review the change. The review identifies
the existing part that will be cloned. Submitting generates code such as
`clone001 = clone(washer)`; cancelling leaves the code unchanged.

For STEP files, a clone reuses the original import's representation, so you do not choose
Mesh or B-rep again.
11 changes: 8 additions & 3 deletions content/pages/docs/zoo-design-studio/features/data-management/import.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -132,9 +132,14 @@ import reference from "./reference/concept.glb"
```

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
1. Select a file from the project directory.
2. Choose a local name for the imported geometry or the new instance.
3. Review and submit. For a new file, Import generates a KCL `import` statement. If the file
already has a whole-file import with an alias, it generates `clone(...)` using that alias.

For repeated imports, Import suggests an available instance name and the review identifies
which existing part will be cloned. Code changes only when you submit; cancelling leaves it
unchanged. Repeated STEP imports reuse the original representation and skip the Mesh/B-rep choice.

## Imported Geometry Behavior

Expand Down