---
alias: user-guide-create-fablive
tags:
- fablive
description: "Create and manage FabLive environments, adding layers and objects for 3D visualization"
---

# Create FabLive

:lock: fabLive3D.**Create**

## Creating a FabLive

To create a **FabLive**, select the **Administration** menu and then the **FabLive** entity. When you are in the **FabLive** page, select **New** on the top ribbon and follow the steps below:

1. Enter a **Name**.
2. Optionally, enter a **Description**.
3. Optionally, enter a **Data Group**.
4. The **Folder** in which the **FabLive** will be stored is set to `\fabLives` by default.
5. Optionally, select if the **FabLive** will be private or public.
6. Optionally select a **Custom Location**.
7. If a custom location is selected, you need to define the coordinates (**Upper Right** and **Bottom Left**).

![CreateFabLive3D][createFabLive3D]

## Adding a FabLive Layer

A FabLive will always contain a default layer. A default layer is useful to add static elements to the layout, such as floors and walls. To visualize system objects in the FabLive you need to add a FabLive Layer. Do so by opening and entering the needed FabLive in **Edit** mode and then select :material-plus: on the **Layers** panel located on the right.

In the **Layer** tab:

1. Enter a **Name**.
2. Optionally enter a **Description**.
3. Select the **Entity Type** for the objects.
4. Optionally select a color for the objects.
5. Optionally select the **Automatic Positions** of the objects (as done with the coordinates).
6. Optionally select if the labels used during the creation of the FabLive, should always be visible or not.

In the **Appearance** tab:

1. Specify the **Property** for which the color of the shape must bind to.
2. For each entry in **Property Values** that should have a different color, specify a **Value** and a **Color**.
3. Select **Create** to complete the creation of the layer.

![createFabLive3DLayer1][createFabLive3DLayer1]
![createFabLive3DLayer2][createFabLive3DLayer2]
![createFabLive3DLayer3][createFabLive3DLayer3]

## Adding Objects and Linking them to Entity Instances

To add a shape to a layer, select the layer first and then from the **Objects** panel, drag and drop as many objects as needed to the plane. To link the object to a particular entity instance, select the shape to be linked, find the desired instance in the **Entities** panel on the left and select **Bind**.

![fabLive3DShapeLink][fabLive3DShapeLink]

## Additional FabLive Editor Options

The **FabLive** editor provides additional options as described below:

* General
    * Refresh - reload the FabLive from the database.
    * Save - save current FabLive into the database.
    * View - view the FabLive.
    * Undo - undo last action.
    * Duplicate - duplicate current selection.
    * Remove - deletes the object.
    * Group - group one or more objects together.
    * Ungroup - ungroup a group of objects.
    * Change Layer - changes the object from one layer to another.
    * Update Position - sets the coordinates of the entity instance that is currently linked with the object.
    * Reset Camera - restores the original view.
* Visualization/Camera
    * Perspective View (3D)
    * Top View (2D)
    * Side View (2D)
    * Front View (2D)
    * Isometric View (3D)
* Object Manipulation
    * Translate - move the object across one of the axes.
    * Scale - enlarge or shrink the object across one of the axes.
    * Rotate - rotate the object.
    * Edit Vertices - to edit one ore more vertices of a shape.
    * World Transform Space - transformations apply using the world space as the reference.
    * Local Transform Spaces - transformations apply using the local object as the reference.
* Zoom
    * Zoom In - zooms in into a certain area.
    * Zoom Out - zooms out from a certain area.

![fabLive3DOptions][fabLive3DOptions]

!!! info
	Use the mouse for better control and interaction with the **FabLive** editor.

The **FabLive** editor supports these additional options:

1. Importing a 3D object file - in the **Objects** panel select **Import** on the top-right and then select a .obj file.
2. Adding an object or a group of objects to a library of objects - in the **Mesh Library** panel select :material-plus:.
3. Adding a texture to an existing object - in the **Selection Properties** panel select **Import** and then select an image file (example: .jpg).
4. Changing the number of lines and visibility of the grid - in the **Grid** panel specify the grid subdivision size.
5. Configure additional settings - in the **Settings** panel you can configure the **Light Effects**, **Resolution**, and **Wireframe Mode**.

!!! info
	Be sure to select **Save** to commit the changes to the database.

!!! warning
	FabLive only supports .OBJ formats up to 1 MB in size.

!!! warning
	Geometric information is supported, such as Face and Vertex Normal Vectors. All other types of vectors are not supported.

!!! warning
	Failure to meet these guidelines may lead to abnormal behavior, including Chromium catastrophic crashes. Objects with complex details may not be properly handled by Fablive, which will load a series of objects instead of a single object. This may lead to unwanted situations when trying to work with those objects or when trying to save them.

[createFabLive3D]:../../images/createFabLive3D.png
[createFabLive3DLayer1]:../../images/createFabLive3DLayer1.png
[createFabLive3DLayer2]:../../images/createFabLive3DLayer2.png
[createFabLive3DLayer3]:../../images/createFabLive3DLayer3.png
[fabLive3DShapeLink]:../../images/fabLive3DShapeLink.png
[fabLive3DOptions]:../../images/fabLive3DOptions.png