Set Up Handles

 

The purpose of this page is to explain how to set up the handle position management with 3DCloud.

Handles are not displayed as such to the customer in the kitchen planner, they are always part of a door/handle or drawer/handle sub-assembly. The handle product is at the lowest level in the tree that goes up to the full cabinet. The settings for handles depend on the number of sub-assemblies building the final product and the complexity of the .BMA files 🔗.

This page will deal with the most frequent handle positions.

➡️ Click here 🔗 to open the complete sample to define handles through API.

---

Definitions

The table below lists all the definitions around handles.

Term	Definition
Handles	Can be added on each front (door front or drawer front) of cabinets. Handles can have: ▪️ Various colors and shapes (defined in 3D asset) ▪️ Various positions ▪️ Various orientations
Handle type	Parameter that impact the position of the handle on the front.
Handle vertical position	Parameter used to define whether the handle is place on the top, the middle or the bottom of the front.
Handle layout	Parameter used to define the position of the handle on the front: either centered or on a side. To define which side, the "side" parameter is required.
Handle side	Parameter used to define whether the handle is on the left or on the right side of the cabinet.
Handle orientation	Parameter used to define if the handle is horizontally or vertically oriented.

---

Specify the Basic Information

The minimum information required to create an handle is common to every kind of products.

Connect to 3DCloud and click Products on the CONTENT menu. Then, click New product.

This is:

1. The name: The name will be displayed in the planner (in the Edit panel) and should be available for all languages. If not, the planner will display the name in the fallback language.
2. Mandatory information: The product reference, the brand and the product type.
3. Product information: This information is not mandatory but highly recommended, especially the short and long descriptions that are displayed in the planner.
4. Product representation: This is where you specify among others the 3D resource, the thumbnail and the parameters.

❗️ Select your product type carefully: Handles.

---

Specify the 3D Resource and the Thumbnail

An handle is defined by a 3D asset managed in Geometry Editor. The required resource is a .BM3 file compliant with the ByMe platform requirements.

The .BM3 file contains among others, the dimensions of the 3D asset and a smart scaling if one has been defined in Geometry Editor to enable product resizing in the planner.

📌 The best practice would be to not scale handles. If you want to have different sizes for the same handles, duplicate it in as many products (BM3 files) as there are sizes.

Click Upload a 3D model to browse for your .BM3 file and add it to the datasheet.

Click either Low, Medium or High to test the image resolution that will be displayed in the planner.

Click Upload a picture to specify the bitmap file that will be used as thumbnail in 3DCloud and in the planner. Follow the format and size recommendations.

---

Specify the Dimension Parameters

Although the dimensions of the asset are embedded in the .BM3 file they must be specify in 3DCloud. These parameters will be recovered in Assembly Editor and are mandatory.

Parameter	Type	Possible values
depth	Discrete length	[0 ;∞]
width	Discrete length	[0 ;∞]
height	Discrete length	[0 ;∞]

Click Add variable dimension in the Product representation tab to define the width, the depth and the height of the handle.

---

Specify the Option Parameters

The option parameters are not strictly mandatory, but they are required to ensure the behavior of the front in the assembly.

The type Parameter

type is one of the most important parameters for handles because it defines their behavior on the front of the cabinet.

Parameter	Type	Possible values	Default value
type	Discrete variation	[1;2;3]	1

Handle Types

There are three types of handles, as illustrated below.

Type value	Type name	Illustration
1	classic front position
2	edge position
3	drop position

---

Pricing

Like every product, handles support different pricing 🔗 types: regular, reduced, membership, etc. Click the Pricing tab to define the price(s).

📌 The recommended pricing method for handles is 'packAmount'.

---

Parameters to Add at Upper Levels

Deploying handles requires to set three additional parameters named side, handleLayout and handleOrientation on the handle and front assemblies.

The side Parameter

Set the side parameter on the front-handle sub-assembly and on the cabinet top-assembly to enable the customer to change the door opening side of the cabinet and the position of the handle on the door front at the same time.

Parameter	Type	Possible values	Default value
side	Discrete variation	-1 (Left) and 1(Right)	-1

The handleLayout Parameter

Set the handleLayout parameter on the cabinet top-assembly to enable the customer to force centered handle position instead of right and left position managed by the side parameter.

Parameter	Type	Possible values	Default value
handleLayout	Discrete variation	0 / 1	1

The values are:

• 0 = Force the position to centered
• 1 = Keep the position defined by the side parameter

The handleOrientation Parameter

Parameter	Type	Possible values	Default value
handleOrientation	Discrete variation	0 / 1	1

If handleLayout is set to 1 you can also define the handleOrientation parameter on the cabinet top-assembly to enable the customer to change the orientation of the handle. The values are:

• 1 = Vertical
• 0 = Horizontal

The handleVerticaPosition Parameter

Parameter	Type	Possible values	Default value
handleVerticalPosition	Discrete variation	[0;1;2]	1

Defines whether the vertical handle is placed on the bottom, the middle or the top of the door front. The possible values are:

• 0 = Bottom
• 1 = Middle
• 2 = Top