This document serves as the official guide for using the library, providing all the necessary instructions, guidelines, and best practices to ensure proper and standardized use of the available resources. It was created to support a clear understanding and effective application of the library's components.
Handles
Key details about handles, such as attributes, positioning, insertion points, and other influencing parameters.
Attributes
There are two sets of attributes for the handle positioning service, based on their intended users.
- For use in the manufacturer's library: these attributes must be used by the customer for non-standard positioning and to set handle sizes.
| Attribute | Usage |
|---|---|
| COMMON_PULL_LOCX | Move the handle horizontally. |
| COMMON_PULL_LOCY | Move the handle vertically. |
| COMMON_PULL_LOCZ | Move the handle on the depth axis. |
| COMMON_HANDLE_WIDTH | Door handle width. |
| COMMON_HANDLE_HEIGHT | Door handle height. |
| COMMON_DRAWERHANDLE_WIDTH | Drawer handle width. |
| COMMON_DRAWERHANDLE_HEIGHT | Drawer handle height. |
2. Only used by the Core Library team:
There are some internal attributes to assist in the handle positioning (only used by the Core team). Since the zero point of the handle design is in the middle of the holes, we use offsets to correct positioning when the handle differs from a knob.
| Attribute | Usage |
|---|---|
| COMMON_PULL_OFFSET_WIDTH | Assist in positioning. |
| COMMON_PULL_OFFSET_HEIGHT | Assist in positioning. |
| COMMON_PULL_OFFSET_DEPTH | Assist in positioning. |
Positioning service option
Determines if handle positioning should be sourced from Core, which already provides the UI for client use.
| Attribute | Options |
|---|---|
| COMMON_POSITIONING_SERVICE | TRUE or FALSE (default is True) |
Single definition on handle positioning service
To restrict a single option of placement. By default, the option ALL is used, then all options are exposed. If you only want one option, use the attribute with its respective value.
| Base Door | |
|---|---|
| Attribute | Options |
| COMMON_DEFINITION_HANDLES_POSITIONING_BASEDOOR | ALL |
| TOP_SIDE_VERTICAL | |
| TOP_CENTER_HORIZONTAL | |
| MIDDLE_CENTER_VERTICAL | |
| MIDDLE_CENTER_HORIZONTAL | |
| TOP_CENTER_VERTICAL | |
| MIDDLE_SIDE_HORIZONTAL | |
| TOP_SIDE_HORIZONTAL | |
| MIDDLE_SIDE_VERTICAL | |
| Wall Door | |
|---|---|
| Attribute | Options |
| COMMON_DEFINITION_HANDLES_POSITIONING_WALLDOOR | ALL |
| BOTTOM_SIDE_HORIZONTAL | |
| BOTTOM_SIDE_VERTICAL | |
| BOTTOM_CENTER_HORIZONTAL | |
| BOTTOM_CENTER_VERTICAL | |
| MIDDLE_CENTER_HORIZONTAL | |
| MIDDLE_CENTER_VERTICAL | |
| MIDDLE_SIDE_HORIZONTAL | |
| MIDDLE_SIDE_VERTICAL | |
| Tall Door | |
|---|---|
| Attribute | Options |
| COMMON_DEFINITION_HANDLES_POSITIONING_TALLDOOR | ALL |
| TOP_SIDE_VERTICAL | |
| TOP_CENTER_HORIZONTAL | |
| MIDDLE_CENTER_VERTICAL | |
| TOP_CENTER_VERTICAL | |
| MIDDLE_SIDE_HORIZONTAL | |
| TOP_SIDE_HORIZONTAL | |
| MIDDLE_SIDE_VERTICAL | |
| Pull Out Door | |
|---|---|
| Attribute | Options |
| COMMON_DEFINITION_HANDLES_POSITIONING_PULLOUT | ALL |
| TOP_CENTER_VERTICAL | |
| TOP_CENTER_HORIZONTAL | |
| MIDDLE_CENTER_VERTICAL | |
| MIDDLE_CENTER_HORIZONTAL | |
| Base Drawer | |
|---|---|
| Attribute | Options |
| COMMON_DEFINITION_HANDLES_POSITIONING_BASEDRAWER | ALL |
| TOP_CENTER_VERTICAL | |
| TOP_CENTER_HORIZONTAL | |
| MIDDLE_CENTER_VERTICAL | |
| MIDDLE_CENTER_HORIZONTAL | |
| Wall Drawer | |
|---|---|
| Attribute | Options |
| COMMON_DEFINITION_HANDLES_POSITIONING_WALLDRAWER | ALL |
| BOTTOM_CENTER_VERTICAL | |
| BOTTOM_CENTER_HORIZONTAL | |
| MIDDLE_CENTER_VERTICAL | |
| MIDDLE_CENTER_HORIZONTAL | |
Default option on handle positioning service
Attributes to define a default option for handle placement. Refer to the first table for the attribute and the second table for the value.
| Door Type | Attribute |
|---|---|
| Base Door | COMMON_DEFAULT_HANDLES_POSITIONING_BASEDOOR |
| Wall Door | COMMON_DEFAULT_HANDLES_POSITIONING_WALLDOOR |
| Tall Door | COMMON_DEFAULT_HANDLES_POSITIONING_TALLDOOR |
| Pull Out Door | COMMON_DEFAULT_HANDLES_POSITIONING_PULLOUTDOOR |
| Bifold Base Door | COMMON_DEFAULT_HANDLES_POSITIONING_BASEDOOR_BIFOLD |
| Bifold Wall Door | COMMON_DEFAULT_HANDLES_POSITIONING_WALLDOOR_BIFOLD |
| Bifold Tall Door | COMMON_DEFAULT_HANDLES_POSITIONING_TALLDOOR_BIFOLD |
| Base Drawer | COMMON_DEFAULT_HANDLES_POSITIONING_BASEDRAWER |
| Wall Drawer | COMMON_DEFAULT_HANDLES_POSITIONING_WALLDRAWER |
| Options |
|---|
| ALL |
| TOP_SIDE_VERTICAL |
| TOP_CENTER_HORIZONTAL |
| MIDDLE_CENTER_VERTICAL |
| MIDDLE_CENTER_HORIZONTAL |
| TOP_CENTER_VERTICAL |
| MIDDLE_SIDE_HORIZONTAL |
| TOP_SIDE_HORIZONTAL |
| MIDDLE_SIDE_VERTICAL |
| BOTTOM_SIDE_HORIZONTAL |
| BOTTOM_SIDE_VERTICAL |
| BOTTOM_CENTER_HORIZONTAL |
| BOTTOM_CENTER_VERTICAL |
Restriction on handle positioning service
New attributes for handle positioning service visibility have been created for certain customers. These attributes default to TRUE and should be set to FALSE if restrictions are needed.
NOTE: Used only when restrictions are defined as ALL.
Refer to the tables below:
| Base Door | ||
|---|---|---|
| Positioning | Attribute | Options |
| Top / Side / Vertical | COMMON_HANDLES_BASEDOOR_TOP_SIDE_VERTICAL | TRUE/FALSE |
| Top / Center / Vertical | COMMON_HANDLES_BASEDOOR_TOP_CENTER_VERTICAL | TRUE/FALSE |
| Top / Side / Horizontal | COMMON_HANDLES_BASEDOOR_TOP_SIDE_HORIZONTAL | TRUE/FALSE |
| Top / Center / Horizontal | COMMON_HANDLES_BASEDOOR_TOP_CENTER_HORIZONTAL | TRUE/FALSE |
| Middle / Side / Vertical | COMMON_HANDLES_BASEDOOR_MIDDLE_SIDE_VERTICAL | TRUE/FALSE |
| Middle / Side / Horizontal | COMMON_HANDLES_BASEDOOR_MIDDLE_SIDE_HORIZONTAL | TRUE/FALSE |
| Middle / Center / Vertical | COMMON_HANDLES_BASEDOOR_MIDDLE_CENTER_VERTICAL | TRUE/FALSE |
| Middle / Center / Horizontal | COMMON_HANDLES_BASEDOOR_MIDDLE_CENTER_HORIZONTAL | TRUE/FALSE |
| Wall Door | ||
|---|---|---|
| Positioning | Attribute | Options |
| Middle / Side / Vertical | COMMON_HANDLES_WALLDOOR_MIDDLE_SIDE_VERTICAL | TRUE/FALSE |
| Middle / Side / Horizontal | COMMON_HANDLES_WALLDOOR_MIDDLE_SIDE_HORIZONTAL | TRUE/FALSE |
| Middle / Center / Vertical | COMMON_HANDLES_WALLDOOR_MIDDLE_CENTER_VERTICAL | TRUE/FALSE |
| Middle / Center / Horizontal | COMMON_HANDLES_WALLDOOR_MIDDLE_CENTER_HORIZONTAL | TRUE/FALSE |
| Bottom / Side / Horizontal | COMMON_HANDLES_WALLDOOR_BOTTOM_SIDE_HORIZONTAL | TRUE/FALSE |
| Bottom / Side / Vertical | COMMON_HANDLES_WALLDOOR_BOTTOM_SIDE_VERTICAL | TRUE/FALSE |
| Bottom / Center / Horizontal | COMMON_HANDLES_WALLDOOR_BOTTOM_CENTER_HORIZONTAL | TRUE/FALSE |
| Bottom / Center / Vertical | COMMON_HANDLES_WALLDOOR_BOTTOM_CENTER_VERTICAL | TRUE/FALSE |
| Pull Out Door | ||
|---|---|---|
| Positioning | Attribute | Options |
| Top / Center / Horizontal | COMMON_HANDLES_PULLOUTDOOR_TOP_CENTER_HORIZONTAL | TRUE/FALSE |
| Top / Center / Vertical | COMMON_HANDLES_PULLOUTDOOR_TOP_CENTER_VERTICAL | TRUE/FALSE |
| Middle / Center / Vertical | COMMON_HANDLES_PULLOUT_DOOR_MIDDLE_CENTER_VERTICAL | TRUE/FALSE |
| Middle / Center / Horizontal | COMMON_HANDLES_PULLOUT_DOOR_MIDDLE_CENTER_HORIZONTAL | TRUE/FALSE |
| Tall Door | ||
|---|---|---|
| Positioning | Attribute | Options |
| Middle / Side / Vertical | COMMON_HANDLES_TALLDOOR_MIDDLE_SIDE_VERTICAL | TRUE/FALSE |
| Middle / Side / Horizontal | COMMON_HANDLES_TALLDOOR_MIDDLE_SIDE_HORIZONTAL | TRUE/FALSE |
| Top / Side / Horizontal | COMMON_HANDLES_TALLDOOR_TOP_SIDE_HORIZONTAL | TRUE/FALSE |
| Top / Side / Vertical | COMMON_HANDLES_TALLDOOR_TOP_SIDE_VERTICAL | TRUE/FALSE |
| Top / Center / Horizontal | COMMON_HANDLES_TALLDOOR_TOP_CENTER_HORIZONTAL | TRUE/FALSE |
| Top / Center / Vertical | COMMON_HANDLES_TALLDOOR_TOP_CENTER_VERTICAL | TRUE/FALSE |
| Middle / Center / Vertical | COMMON_HANDLES_TALLDOOR_MIDDLE_CENTER_VERTICAL | TRUE/FALSE |
| Base Drawer | ||
|---|---|---|
| Positioning | Attribute | Options |
| Middle / Center / Horizontal | COMMON_HANDLES_BASEDRAWER_MIDDLE_CENTER_HORIZONTAL | TRUE/FALSE |
| Middle / Center / Vertical | COMMON_HANDLES_BASEDRAWER_MIDDLE_CENTER_VERTICAL | TRUE/FALSE |
| Top / Center / Vertical | COMMON_HANDLES_BASEDRAWER_TOP_CENTER_VERTICAL | TRUE/FALSE |
| Top / Center / Horizontal | COMMON_HANDLES_BASEDRAWER_TOP_CENTER_HORIZONTAL | TRUE/FALSE |
| Wall Drawer | ||
|---|---|---|
| Positioning | Attribute | Options |
| Bottom / Center / Horizontal | COMMON_HANDLES_WALLDRAWER_BOTTOM_CENTER_HORIZONTAL | TRUE/FALSE |
| Bottom / Center / Vertical | COMMON_HANDLES_WALLDRAWER_BOTTOM_CENTER_VERTICAL | TRUE/FALSE |
| Middle / Center / Vertical | COMMON_HANDLES_WALLDRAWER_MIDDLE_CENTER_VERTICAL | TRUE/FALSE |
| Middle / Center / Horizontal | COMMON_HANDLES_WALLDRAWER_MIDDLE_CENTER_HORIZONTAL | TRUE/FALSE |
SpaceHolders for handles
Here you will find the attributes to activate the Handlestyles:
| Attribute | Utility | Default Value | Options |
|---|---|---|---|
| COMMON_DECORATIVE_TYPE_INTEGRATION_DOOR_HANDLESTYLE | For handle's doors | Static | Static |
| Manufacturer | |||
| Cross | |||
| COMMON_DECORATIVE_TYPE_INTEGRATION_DRAWER_HANDLESTYLE | For handle's drawers | Static | Static |
| Manufacturer | |||
| Cross |
Existing values:
- Static - which uses models from Core (default value).
- Manufacturer - If you want to use the ID coming from a specific catalogue. If selected, you must assign the desired ID to the attributes below:
| Attribute | Utility |
|---|---|
| COMMON_MANUFACTURER_DOOR_HANDLESTYLE | For Door Handle Style |
| COMMON_MANUFACTURER_DRAWER_HANDLESTYLE | For Drawer Handle Style |
- Spaceholder - If you want to enable the handle spaceholder, use the attributes below:
| Used in | Attribute | Default Value | Proposed Value |
|---|---|---|---|
| Doors | COMMON_DECORATIVE_TYPE_INTEGRATION_DRAWER_HANDLESTYLE | Static | Cross |
| Drawers | COMMON_DECORATIVE_TYPE_INTEGRATION_DOOR_HANDLESTYLE | Static | Cross |
Insertion Point
The handle's insertion point should align with the center of the drilling. Ensure the handle drawing is horizontal, as shown in the examples below:
Image 01:
Image 02:
Image 03:
Image 04:
Resizing:
For curved, dot, and shell handles, use None. For straight handles, use customizable resizing.
The original value starts at zero, and resizing should always be $W$/2.