From 32b1c5fe3a0a420fbcefa5b403beca2cdc22f77d Mon Sep 17 00:00:00 2001 From: Pierre Jacquier Date: Thu, 10 Sep 2026 09:15:26 -0400 Subject: [PATCH] Document repeated imports creating clones --- .../features/3d-design/assemblies/insert/index.mdx | 12 +++++++++++- .../features/data-management/import.mdx | 11 ++++++++--- 2 files changed, 19 insertions(+), 4 deletions(-) diff --git a/content/pages/docs/zoo-design-studio/features/3d-design/assemblies/insert/index.mdx b/content/pages/docs/zoo-design-studio/features/3d-design/assemblies/insert/index.mdx index 3b35b143..63d6324e 100644 --- a/content/pages/docs/zoo-design-studio/features/3d-design/assemblies/insert/index.mdx +++ b/content/pages/docs/zoo-design-studio/features/3d-design/assemblies/insert/index.mdx @@ -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. diff --git a/content/pages/docs/zoo-design-studio/features/data-management/import.mdx b/content/pages/docs/zoo-design-studio/features/data-management/import.mdx index 24244d54..6d1f5ffa 100644 --- a/content/pages/docs/zoo-design-studio/features/data-management/import.mdx +++ b/content/pages/docs/zoo-design-studio/features/data-management/import.mdx @@ -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