To take advantage of the automatic creation of options inside the configurator it is important to properly prepare and organize your 3D scene. The automatic conversion relies heavily on grouping objects together or placing them under empty/NULL nodes and following a specific naming convention.
- In https://expivi.atlassian.net/wiki/spaces/GSD/pages/1979744300 these nodes are created by the “empty group” function.
- In https://expivi.atlassian.net/wiki/spaces/GSD/pages/1979875329 these nodes are created by the “helpers->container” function.
- In https://expivi.atlassian.net/wiki/spaces/GSD/pages/1979711548 these nodes are created by the “empty” function.
Expivi works with naming conventions for certain functions. You can find a list below of all the naming conventions and the corresponding function. All conventions start with the name followed by a lower dash “_” next comes the name of the group you are working on. To close, type “_e” the “e” stands for ‘end’ and closes the loop, everything typed afterwards will not be taken into account.
- Category: A category creates a question for Expivi
Suffix: cat_”group name”_e
Categories are for the questions in Expivi, these can be answered by options, options are used to configure your product. A Category can never sit inside another Category.
- Option: Are parts of your product that can be configured
Suffix: opt_”group name”_e
All meshes placed in the Option will be affected by the attribute assigned to it in Expivi. A option function always needs to be nested inside a Category function.
- Material Group: used to assign the same material to all meshes in the group.
Suffix: mat_”group name”_e
All meshes placed in the group will be linked to the same material group, a material group in Expivi tells the program to change the material of the entire group. Material groups are not limited in placement in your hierarchy.
- Offset Group: used to create moveable elements.
Suffix: off_”group name”_e
All things placed in the Offset group will use the same offset point. The offset point or pivot indicates the location of where the group will move or turn. You can place all other functions in a offset group if you wish, making it so that everything below the offset group moves uniformly.
- ID Reference: used to reference and duplicate parts of a model without having that part loaded twice in your 3D program. This is a combination of 2 functions; ref and id.
Suffix: ref_”same group name”_e
Suffix: id_”same group name”_e
ID references can be set up in your 3D program to let Expivi know to duplicate the meshes inside your ‘’ref’’ group to all ‘’id’’ groups without actually having that model duplicated in your 3D software. Start by placing the model you want to reference in your ‘’ref_example_e’’ group. Next, whenever you make a ‘’id’’ group which has the same name as the ref group, the mesh inside the ref group will be duplicated to the id group. The placement of the ‘’id’’ model depends on the coordinates of the ‘’id’’ group in your scene. The ‘’id’’ group does not need to contain any geometry for this to work.
The referencing happens in Expivi and will not show in your 3D program. This function is useful to quickly deploy a change across all ID’d models while only adjusting the referenced model.
- Product Reference is used to reference and duplicate entire configured products within Expivi. This can be useful when you want multiple products to load at the same time.
This function calls another configured product inside your backend into your current product. The function opens with ‘’Product_” followed by the product ID number that can be found in the backend, closed off with ‘’_e’’.
- A category always has to be followed by an option. You can, however, add another question inside of that option.
- You can also leave an option empty to be able to switch a mesh on and off.
- Material and offset nodes can be placed anywhere inside of the hierarchy.
Example of a finished hierarchy:
This product has 2 categories; cubes and spheres. Each has 2 options, ‘Big’ and ‘Small’. Both options have 4 material groups assigned to them. Uploading this to Expivi will result in these options:
Cubes → 1 – BigCubes, 2 – Smallcubes
Spheres → 1 – BigSpheres. 2 – Smallspheres
Besides the options, all 4 materials can be edited separately thanks to MatGroups. For instance, changing the ‘’Blue’’ material within Expivi’s material editor will result in all blue shapes changing at the same time.