DRY0001 - ADD BODY OR GEOMETRICAL SET - DOCUMENTATION

DRY0001 - Add Body or Geometrical Set

DRYCAD Suite tool that adds a Body, Geometrical Set, or Ordered Geometrical Set to the active CATIA V5 Part with configurable naming, coloring, parent selection, and Boolean operations.

DRYCAD Suite | User Documentation | v1.0.0


Table of Contents

  1. Overview
  2. Getting Started
  3. User Interface
  4. Configuration: settings.ini
  5. Examples
  6. Troubleshooting
  7. Version History

1. Overview

CATIA’s default workflow for adding Bodies and Geometrical Sets means navigating menus, accepting whatever generic name the application assigns, and cleaning up graphical properties afterwards, every single time. DRY0001 collapses all of that into one panel: pick the feature type, confirm the name, select a parent if needed, and you’re done. It also handles progressive numbering automatically, so you never end up with three things called Body.1.

What it does:

  • Creates Bodies, Geometrical Sets, and Ordered Geometrical Sets inside the active CATIA V5 Part
  • Pre-fills the name field with a configurable default and applies automatic case conversion at creation time
  • Appends a numeric suffix when a feature with the same base name already exists
  • Lets you target any Body or Geometrical Set as the parent, or reset to the top-level Part with one click
  • Assigns a Boolean operation (Add, Assemble, Remove, Intersect) when inserting a Body inside another Body
  • Applies color and line width automatically, based on your configuration, fixed, random, or none
  • Sets the newly created feature as the active In Work Object and centers the CATIA display on it

Supported CAD platforms: CATIA V5

Workspace requirement: An active Part document must be open in CATIA.


2. Getting Started

Prerequisites

  • CATIA V5 must be running
  • You must be logged into the DRYCAD Suite
  • An active Part document must be open in CATIA

Launching the Tool

DRY0001 is launched from the DRYCAD Suite CommandBar inside CATIA V5. Click the corresponding button to open the panel.

The tool checks the following conditions at startup, and will show an error and close if any fail:

  • A valid user session is found, if not: “User not found. Please login and try again.”
  • CATIA V5 is running and accessible, if not: “CATIA is not open. Please open CATIA and try again.”
  • The active document is a Part, if not, an “Invalid Workspace” error is shown and the panel does not open

A background watchdog checks every 5 seconds whether CATIA is still running and whether the active document is still a Part. If either condition changes, the panel closes automatically.

The DRYCAD Menu

Every DRYCAD Suite tool with a user interface includes a menu in the top bar, accessed via the hamburger icon next to the window controls.

OptionDescription
Release 1.0.0Displays the current version of the tool. Informational only, not an action.
DocumentationOpens this documentation page in your default browser.
Open SettingsOpens settings.ini in your system’s default text editor.
Clear SettingsResets settings.ini to a clean default version. Shows a confirmation warning before proceeding.

3. User Interface

The panel is organized in four horizontal rows: feature type selection at the top, then name and color, then parent and Boolean operation, and finally the action buttons. The Name field receives keyboard focus automatically when the panel opens.

3.1 Add New, Feature Type Selection

Three toggle buttons let you choose what to create. Only one can be active at a time.

ControlIconDescription
BODY Body icon Creates a standard solid Body
GEOMETRICAL SET Geometrical Set icon Creates a Geometrical Set for surface and wireframe geometry
ORDERED GEOMETRICAL SET Ordered Geometrical Set icon Creates an Ordered Geometrical Set

Switching type also updates the Name field to the configured default for that type and reloads the Color picker with that type’s defaults. The Boolean Operation buttons are only enabled when BODY is active and the selected parent is not the top-level Part.

Note: The type shown on open is controlled by DEFAULT_STARTING_FEATURE in settings.ini. If OVERRIDE_STARTING_FEATURE_ON_SELECTION is enabled and a compatible object is selected in CATIA at launch, the type will match that selection instead.

3.2 Name and Color

The Name field is pre-filled with the configured default for the active feature type. You can edit it freely before confirming. Pressing Enter triggers OK.

If APPLY_PROGRESSIVE_NUMBERING is enabled, the tool searches the Part for existing features sharing the same base name and appends the first available numeric suffix, e.g. BODY becomes BODY.2, then BODY.3. Case conversion defined in settings.ini is applied at the moment of creation, not while typing.

The Color picker loads its palette from settings.ini. It can include fixed RGB or HEX colors, a no-color option (shown as transparent), and a random slot at the end.

ControlIconDescription
Random Color Random color icon Generates a new random color and selects it immediately
Color dropdown-Choose from the preconfigured palette

If the default for the active type is set to RANDOM, a new random color is pre-selected each time the panel opens. Selecting the transparent slot means no graphical color is applied to the new feature.

3.3 Parent and Boolean Operation

The Parent field shows the object that will contain the new feature. By default this is the top-level Part.

ControlIconDescription
Reset to Top Reset to top node icon Resets the parent to the top-level Part. Disabled when already at top level.
Select Parent Select parent icon Prompts you to click a Body, Geometrical Set, or Ordered Geometrical Set in CATIA to use as the parent

The parent field is read-only and truncates long names. The accepted parent types depend on the active feature type: for Ordered Geometrical Sets, only other Ordered Geometrical Sets or the Part root are valid.

The four Boolean Operation buttons are enabled only when BODY is active and the parent is not the top-level Part. Inserting a Body inside another Body requires one of these operations to be selected before OK becomes available.

ControlIconDescription
Add Boolean Add icon Adds the new Body’s solid to the parent
Assemble Boolean Assemble icon Assembles the new Body with the parent
Remove Boolean Remove icon Subtracts the new Body from the parent
Intersect Boolean Intersect icon Intersects the new Body with the parent

3.4 Cancel / OK

ButtonAction
CancelCloses the panel without making any changes to the CATIA document.
OKCreates the feature, applies graphical properties, sets it as the In Work Object, and closes the panel. Also triggered by pressing Enter.

OK is disabled if: no feature type is selected, the Name field is empty, or a Body is being inserted under a parent Body without a Boolean operation selected.


4. Configuration: settings.ini

File Location

<install_folder>/DRY0001/settings.ini

Can also be opened directly via Open Settings in the DRYCAD Menu (see Section 2), or reset via Clear Settings.

Structure

; DRY0001 - ADD BODY OR GEOMETRICAL SET - SETTINGS FILE

[FeatureTypeSelection]
DEFAULT_STARTING_FEATURE=0
OVERRIDE_STARTING_FEATURE_ON_SELECTION=1

[NamingConventions]
DEFAULT_BODY_NAME="NEW BODY"
BODY_NAME_CASE_SELECTOR=1
DEFAULT_GEOSET_NAME="DRY_GEOSET"
GEOSET_NAME_CASE_SELECTOR=3
DEFAULT_ORDERED_GEOSET_NAME="DRY_Ordered_GeoSet"
ORDERED_GEOSET_NAME_CASE_SELECTOR=0
APPLY_PROGRESSIVE_NUMBERING=1
NUMBERING_SEPARATOR="."

[GraphicalProperties]
DEFAULT_BODY_COLOR=""
DEFAULT_BODY_LINEWIDTH=1
DEFAULT_GEOSET_COLOR="RANDOM"
DEFAULT_GEOSET_LINEWIDTH=1
DEFAULT_ORDERED_GEOSET_COLOR="50,100,150"
DEFAULT_ORDERED_GEOSET_LINEWIDTH=1

[BooleanProperties]
DEFAULT_BOOLEAN_OPERATION=0

[Colors]
CUSTOM_COLORS="ff0000 ff8000 ffff00 00ff00 00ffff 0000ff 7f00ff 000000 ffffff b0b0b0 808080 d4af35 94af57 cd8032"

Lines starting with ; are comments and are ignored.

Parameters

DEFAULT_STARTING_FEATURE

PropertyValue
Section[FeatureTypeSelection]
TypeInteger (0–4)
RequiredNo
Default0

Controls which feature type is pre-selected when the panel opens.

; 0 = None (no type pre-selected)
; 1 = Previous Feature (remembers the last type used in the session)
; 2 = Body
; 3 = Geometrical Set
; 4 = Ordered Geometrical Set
DEFAULT_STARTING_FEATURE=2

OVERRIDE_STARTING_FEATURE_ON_SELECTION

PropertyValue
Section[FeatureTypeSelection]
TypeBoolean (0 / 1)
RequiredNo
Default0

When set to 1, if a single compatible object is selected in CATIA at launch, the feature type is overridden to match, a selected Body opens the panel on BODY, a selected Geometrical Set opens it on GEOMETRICAL SET.

OVERRIDE_STARTING_FEATURE_ON_SELECTION=1

DEFAULT_BODY_NAME

PropertyValue
Section[NamingConventions]
TypeString
RequiredNo
Default"BODY"

The default name pre-filled in the Name field when BODY is the active type.

DEFAULT_BODY_NAME="SOLID_BODY"

BODY_NAME_CASE_SELECTOR

PropertyValue
Section[NamingConventions]
TypeInteger (0–3)
RequiredNo
Default0

Case conversion applied to the Body name at the moment of creation, not while typing.

; 0 = None
; 1 = Upper Case
; 2 = Lower Case
; 3 = Proper Case
BODY_NAME_CASE_SELECTOR=1

DEFAULT_GEOSET_NAME

PropertyValue
Section[NamingConventions]
TypeString
RequiredNo
Default"GEOMETRICAL_SET"

The default name pre-filled when GEOMETRICAL SET is the active type.

DEFAULT_GEOSET_NAME="CONSTRUCTION"

GEOSET_NAME_CASE_SELECTOR

PropertyValue
Section[NamingConventions]
TypeInteger (0–3)
RequiredNo
Default0

Case conversion applied to the Geometrical Set name at creation. Same values as BODY_NAME_CASE_SELECTOR.

GEOSET_NAME_CASE_SELECTOR=3

DEFAULT_ORDERED_GEOSET_NAME

PropertyValue
Section[NamingConventions]
TypeString
RequiredNo
Default"ORDERED_GEOSET"

The default name pre-filled when ORDERED GEOMETRICAL SET is the active type.

DEFAULT_ORDERED_GEOSET_NAME="ORD_GS"

ORDERED_GEOSET_NAME_CASE_SELECTOR

PropertyValue
Section[NamingConventions]
TypeInteger (0–3)
RequiredNo
Default0

Case conversion applied to the Ordered Geometrical Set name at creation. Same values as BODY_NAME_CASE_SELECTOR.

ORDERED_GEOSET_NAME_CASE_SELECTOR=1

APPLY_PROGRESSIVE_NUMBERING

PropertyValue
Section[NamingConventions]
TypeBoolean (0 / 1)
RequiredNo
Default0

When set to 1, the tool searches the Part for existing features whose name starts with the same base name and appends the first available numeric suffix. The search covers the entire Part structure under the selected parent, not just the immediate level.

APPLY_PROGRESSIVE_NUMBERING=1

NUMBERING_SEPARATOR

PropertyValue
Section[NamingConventions]
TypeString (single character recommended)
RequiredNo
Default"."

The character inserted between the base name and the numeric suffix when progressive numbering is active.

; Results in: BODY.2, BODY.3
NUMBERING_SEPARATOR="."

; Results in: BODY_2, BODY_3
NUMBERING_SEPARATOR="_"

DEFAULT_BODY_COLOR

PropertyValue
Section[GraphicalProperties]
TypeString
RequiredNo
Default(empty)

The default color applied to newly created Bodies. Three formats are accepted:

DEFAULT_BODY_COLOR=""           ; no color applied
DEFAULT_BODY_COLOR="RANDOM"     ; random color on every open
DEFAULT_BODY_COLOR="255,128,0"  ; fixed RGB (values 0–255)
DEFAULT_BODY_COLOR="ff8000"     ; fixed HEX (6 digits)

DEFAULT_BODY_LINEWIDTH

PropertyValue
Section[GraphicalProperties]
TypeInteger (1–8)
RequiredNo
Default1

The line width applied to newly created Bodies. Valid values are 1 through 8, matching CATIA’s standard line width levels.

DEFAULT_BODY_LINEWIDTH=2

DEFAULT_GEOSET_COLOR

PropertyValue
Section[GraphicalProperties]
TypeString
RequiredNo
Default(empty)

The default color applied to newly created Geometrical Sets. Same format as DEFAULT_BODY_COLOR.

DEFAULT_GEOSET_COLOR="RANDOM"

DEFAULT_GEOSET_LINEWIDTH

PropertyValue
Section[GraphicalProperties]
TypeInteger (1–8)
RequiredNo
Default1

The line width applied to newly created Geometrical Sets.

DEFAULT_GEOSET_LINEWIDTH=1

DEFAULT_ORDERED_GEOSET_COLOR

PropertyValue
Section[GraphicalProperties]
TypeString
RequiredNo
Default(empty)

The default color applied to newly created Ordered Geometrical Sets. Same format as DEFAULT_BODY_COLOR.

DEFAULT_ORDERED_GEOSET_COLOR="50,100,150"

DEFAULT_ORDERED_GEOSET_LINEWIDTH

PropertyValue
Section[GraphicalProperties]
TypeInteger (1–8)
RequiredNo
Default1

The line width applied to newly created Ordered Geometrical Sets.

DEFAULT_ORDERED_GEOSET_LINEWIDTH=1

DEFAULT_BOOLEAN_OPERATION

PropertyValue
Section[BooleanProperties]
TypeInteger (0–5)
RequiredNo
Default0

The Boolean operation pre-selected when inserting a Body inside another Body.

; 0 = None (no operation pre-selected)
; 1 = Previous Selection (remembers the last operation used in the session)
; 2 = Add
; 3 = Assemble
; 4 = Remove
; 5 = Intersect
DEFAULT_BOOLEAN_OPERATION=3

CUSTOM_COLORS

PropertyValue
Section[Colors]
TypeSpace-separated list of HEX or RGB color strings
RequiredNo
Default(empty)

Additional colors shown in the Color dropdown, after the default color and the no-color slot. A random color slot is always appended at the end automatically. Colors can be 6-digit HEX or R,G,B (0–255).

CUSTOM_COLORS="ff0000 00ff00 0000ff 128,128,128"

5. Examples

Example 1, Body-First Team, Assemble Default

A team that works predominantly with Bodies and always assembles them. Names are forced to upper case; progressive numbering is on.

[FeatureTypeSelection]
DEFAULT_STARTING_FEATURE=2
OVERRIDE_STARTING_FEATURE_ON_SELECTION=1

[NamingConventions]
DEFAULT_BODY_NAME="BODY"
BODY_NAME_CASE_SELECTOR=1
DEFAULT_GEOSET_NAME="GEO_SET"
GEOSET_NAME_CASE_SELECTOR=1
DEFAULT_ORDERED_GEOSET_NAME="ORD_GS"
ORDERED_GEOSET_NAME_CASE_SELECTOR=1
APPLY_PROGRESSIVE_NUMBERING=1
NUMBERING_SEPARATOR="."

[GraphicalProperties]
DEFAULT_BODY_COLOR=""
DEFAULT_BODY_LINEWIDTH=1
DEFAULT_GEOSET_COLOR=""
DEFAULT_GEOSET_LINEWIDTH=1
DEFAULT_ORDERED_GEOSET_COLOR=""
DEFAULT_ORDERED_GEOSET_LINEWIDTH=1

[BooleanProperties]
DEFAULT_BOOLEAN_OPERATION=3

[Colors]
CUSTOM_COLORS=""

What it creates: A Body named BODY (or BODY.2, BODY.3, etc. when names already exist), with no color and Assemble pre-selected as the Boolean operation.

Key points:

  • DEFAULT_STARTING_FEATURE=2 opens the panel on the Body type every time, no clicking required
  • BODY_NAME_CASE_SELECTOR=1 guarantees upper case regardless of how the name is typed
  • DEFAULT_BOOLEAN_OPERATION=3 pre-selects Assemble, covering the most common insertion scenario
  • Empty CUSTOM_COLORS means the dropdown shows only the no-color option and a random slot

Example 2, Geometrical Sets with Random Colors

A designer who uses Geometrical Sets for construction geometry and wants each set to have a visually distinct random color. Progressive numbering uses underscore separator.

[FeatureTypeSelection]
DEFAULT_STARTING_FEATURE=3
OVERRIDE_STARTING_FEATURE_ON_SELECTION=1

[NamingConventions]
DEFAULT_BODY_NAME="BODY"
BODY_NAME_CASE_SELECTOR=0
DEFAULT_GEOSET_NAME="CONSTRUCTION"
GEOSET_NAME_CASE_SELECTOR=3
DEFAULT_ORDERED_GEOSET_NAME="ORDERED_GS"
ORDERED_GEOSET_NAME_CASE_SELECTOR=0
APPLY_PROGRESSIVE_NUMBERING=1
NUMBERING_SEPARATOR="_"

[GraphicalProperties]
DEFAULT_BODY_COLOR=""
DEFAULT_BODY_LINEWIDTH=1
DEFAULT_GEOSET_COLOR="RANDOM"
DEFAULT_GEOSET_LINEWIDTH=2
DEFAULT_ORDERED_GEOSET_COLOR=""
DEFAULT_ORDERED_GEOSET_LINEWIDTH=1

[BooleanProperties]
DEFAULT_BOOLEAN_OPERATION=0

[Colors]
CUSTOM_COLORS="ff0000 ff8000 ffff00 00ff00 00ffff 0000ff 7f00ff"

What it creates: A Geometrical Set named Construction (Proper Case applied), assigned a random color, with line width 2. The second one becomes Construction_2.

Key points:

  • DEFAULT_STARTING_FEATURE=3 opens directly on Geometrical Set type
  • GEOSET_NAME_CASE_SELECTOR=3 (Proper Case) means typing construction data produces Construction Data
  • DEFAULT_GEOSET_COLOR="RANDOM" selects a new color on every panel open, no manual picking needed
  • NUMBERING_SEPARATOR="_" produces Construction_2 instead of Construction.2

Example 3, Mixed Team with Company Color Standards

A larger team where different designers create different feature types. The tool adapts to whatever is selected in CATIA, and a shared company color palette enforces visual consistency.

[FeatureTypeSelection]
DEFAULT_STARTING_FEATURE=1
OVERRIDE_STARTING_FEATURE_ON_SELECTION=1

[NamingConventions]
DEFAULT_BODY_NAME="COMP_BODY"
BODY_NAME_CASE_SELECTOR=1
DEFAULT_GEOSET_NAME="COMP_GS"
GEOSET_NAME_CASE_SELECTOR=1
DEFAULT_ORDERED_GEOSET_NAME="COMP_OGS"
ORDERED_GEOSET_NAME_CASE_SELECTOR=1
APPLY_PROGRESSIVE_NUMBERING=1
NUMBERING_SEPARATOR="."

[GraphicalProperties]
DEFAULT_BODY_COLOR="50,100,200"
DEFAULT_BODY_LINEWIDTH=2
DEFAULT_GEOSET_COLOR="200,100,50"
DEFAULT_GEOSET_LINEWIDTH=1
DEFAULT_ORDERED_GEOSET_COLOR="50,150,50"
DEFAULT_ORDERED_GEOSET_LINEWIDTH=1

[BooleanProperties]
DEFAULT_BOOLEAN_OPERATION=1

[Colors]
CUSTOM_COLORS="3264c8 c86432 329632 c8c832 c83264 646464"

What it creates: The starting type follows the current CATIA selection (or falls back to the previous session type). Each feature type gets a company-standard color, blue for Bodies, orange for Geometrical Sets, green for Ordered Geometrical Sets.

Key points:

  • DEFAULT_STARTING_FEATURE=1 combined with OVERRIDE_STARTING_FEATURE_ON_SELECTION=1 makes the tool context-aware: it opens on the type matching the current selection, and remembers the last used type when nothing is selected
  • DEFAULT_BOOLEAN_OPERATION=1 (Previous Selection) remembers each designer’s last Boolean operation across the session
  • Fixed RGB colors per type enforce a visual standard without relying on manual selection
  • CUSTOM_COLORS mirrors the same company colors in HEX for manual override when needed

6. Troubleshooting

”User not found. Please login and try again.”

The tool could not identify the logged-in user at startup. Log out of the DRYCAD Suite, log back in, and relaunch.


”CATIA is not open. Please open CATIA and try again.”

The tool launched but could not find a running CATIA V5 process. Make sure CATIA is fully loaded before clicking the CommandBar button.


”Invalid Workspace”

The active document is not a Part. DRY0001 only operates on Part documents. Switch to or open a Part in CATIA, then relaunch.


Panel closes unexpectedly without any action

The background watchdog detected that CATIA has closed, or the active document is no longer a Part (e.g. you switched to a Drawing or Product). This is expected behavior, the panel shuts down to avoid operating on an unsupported context. Return to a Part document and reopen the panel.


OK button stays disabled

Check all of the following:

  1. A feature type must be selected, one of the three type buttons must be active
  2. The Name field must not be empty
  3. If inserting a Body under a parent Body (the Parent field shows a Body name, not the Part root), a Boolean operation must be selected

The new feature has the wrong name case

Case conversion is applied at the moment you click OK, not while typing. The name in the field is your raw input; the converted version is what ends up in CATIA. Check BODY_NAME_CASE_SELECTOR, GEOSET_NAME_CASE_SELECTOR, or ORDERED_GEOSET_NAME_CASE_SELECTOR in settings.ini.


Progressive numbering skips numbers or jumps unexpectedly

If the tool creates BODY.4 when you expected BODY.2, features with intermediate names already exist somewhere in the Part tree, possibly inside nested structures not visible in the current view. The search covers the entire Part under the selected parent, not just the immediate level.


No color is applied even though one appears selected

Check that the selected item in the Color dropdown is not the empty (transparent) slot, that option intentionally applies no color. Also verify that the relevant DEFAULT_*_COLOR parameter in settings.ini is not set to "" if you want a color applied by default.


7. Version History

VersionDateChanges
1.0.02026-06Initial release

DRY0001, Add Body or Geometrical Set | DRYCAD Solutions | v1.0.0