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.
The table below lists all the definitions around 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
|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.
|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.
|Parameter used to define whether the handle is on the left or on the right side of the cabinet.
|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.
- 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.
- Mandatory information: The product reference, the brand and the product type.
- Product information: This information is not mandatory but highly recommended, especially the short and long descriptions that are displayed in the planner.
- 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.
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.
type is one of the most important parameters for handles because it defines their behavior on the front of the cabinet.
There are three types of handles, as illustrated below.
|classic front position
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
handleOrientation on the handle and front assemblies.
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.
|-1 (Left) and 1(Right)
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
|0 / 1
The values are:
- 0 = Force the position to centered
- 1 = Keep the position defined by the side parameter
|0 / 1
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
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