Difference between revisions of "V2/CMS Tutorial/User Tools/Creating Content/Site/Add Site/Bespoke"

From Senfi Docs
Jump to: navigation, search
m (→‎Assigning 3D Objects to BBL: changed "by it's name" to "by its name")
 
(20 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
<h1 class="main-heading">Add Site with Bespoke Model</h1>
 
<h1 class="main-heading">Add Site with Bespoke Model</h1>
  
Adding a Site using a User Drawn Model can be broken down into six major steps:
+
Adding a Site using a Bespoke Model can be broken down into seven major steps:
 
# [[#Create New Site|Create New Site]]
 
# [[#Create New Site|Create New Site]]
 
# [[#Fill in General Information|Fill in General Information]]
 
# [[#Fill in General Information|Fill in General Information]]
Line 8: Line 8:
 
# [[#Set Default View and Thumbnail|Set Default View and Thumbnail]]
 
# [[#Set Default View and Thumbnail|Set Default View and Thumbnail]]
 
# [[#Create BBL Structure|Create BBL Structure]]
 
# [[#Create BBL Structure|Create BBL Structure]]
 +
# [[#Assigning 3D Objects to BBL|Assigning 3D Objects to BBL]]
  
 
<div class="important">Note: Mandatory fields are marked with an ‘*’. The following steps assume that the user is already logged in to the [https://app.senfi.io/cms/ CMS]. </div>
 
<div class="important">Note: Mandatory fields are marked with an ‘*’. The following steps assume that the user is already logged in to the [https://app.senfi.io/cms/ CMS]. </div>
Line 57: Line 58:
 
# Select "SAVE" or "SAVE & EXIT" (top right corner).
 
# Select "SAVE" or "SAVE & EXIT" (top right corner).
  
===Create BBL Structure===
+
=== Create BBL Structure ===
 
[[File:BBL_Add_Building.png|thumb|center|700px|Steps to add BBL (Building)|link=]]
 
[[File:BBL_Add_Building.png|thumb|center|700px|Steps to add BBL (Building)|link=]]
 
# Select [[File:Edit.png|40px|link=]] '''Edit''' beside the site you just created.
 
# Select [[File:Edit.png|40px|link=]] '''Edit''' beside the site you just created.
Line 70: Line 71:
 
# To delete the block, just click on the [[File:BBL_Delete.png|24px|link=]] '''DELETE''' button beside the block name.
 
# To delete the block, just click on the [[File:BBL_Delete.png|24px|link=]] '''DELETE''' button beside the block name.
 
# To create the levels under each block, just click on the [[File:BBL_Next.png|24px|link=]] '''NEXT''' arrow button beside the block name.
 
# To create the levels under each block, just click on the [[File:BBL_Next.png|24px|link=]] '''NEXT''' arrow button beside the block name.
 +
# To return to the previous listing, click on the '''BACK''' arrow button beside the BBL breadcrumbs. [[File:BBL_Back.png|200px|link=]]
 +
# Repeat steps 8 to 12 for every building in the BBL.
 
# A default level called '''Level Name''' has been created by the system. If you require more than one level, you can add more by clicking on '''ADD NEW LEVEL'''.
 
# A default level called '''Level Name''' has been created by the system. If you require more than one level, you can add more by clicking on '''ADD NEW LEVEL'''.
 
# To edit the level's name, just click on the level's name. After editing, click '''SAVE''' to update the level's name. [[File:BBL_Save_New_NameLevel.png|thumb|center|300px|Change block name|link=]]
 
# To edit the level's name, just click on the level's name. After editing, click '''SAVE''' to update the level's name. [[File:BBL_Save_New_NameLevel.png|thumb|center|300px|Change block name|link=]]
 
# To delete the level, just click on the [[File:BBL_Delete.png|24px|link=]] '''DELETE''' button beside the level name.
 
# To delete the level, just click on the [[File:BBL_Delete.png|24px|link=]] '''DELETE''' button beside the level name.
# Repeat steps
+
# Repeat steps 14 to 16 for every block in the BBL.
 +
# Select "SAVE" (top right corner) after you have finished creating the BBL structure.
 +
 
 +
=== Assigning 3D Objects to BBL ===
 +
Now that we have created the BBL structure, we can proceed to assign objects to each building, block and level.
 +
 
 +
# To do so, go to the level listing in the BBL, and click on the [[File:BBL_Next.png|24px|link=]] '''NEXT''' arrow button beside the block name you want to assign objects to. [[File:BBL_Assign_Object_001.png|thumb|center|700px|Choosing level to assign 3D objects to|link=]]
 +
# First, you will need to define the level extent (vertical space where the level will extent to, from floor to ceiling). To do so, you can either:
 +
## Fill in the floor position and ceiling position under the '''Level Extent''' section, if you have the information. Or,
 +
## Select the floor 3D object for the level, and click on '''Update from Selected''' to update the floor position based on the selected 3D object's position. Repeat the same step for ceiling 3D object for the level. [[File:BBL_Assign_Object_002.png|thumb|center|700px|Update floor position from selected 3D object|link=]] [[File:BBL_Assign_Object_003.png|thumb|center|700px|Update ceiling position from selected 3D object|link=]]
 +
## For levels with objects already assigned, you can also update the floor and ceiling position by selecting '''Update from Assigned'''.
 +
# Under the '''Object Visibility''' section, click on '''HIDE''' button beside '''Outside Level Extent''' to hide objects outside of the level extent. [[File:BBL_Assign_Object_004.png|thumb|center|700px|Hide objects outside of level extent|link=]]
 +
# Select all the objects belonging to this level extent. To select multiple 3D objects in the 3D scene, you can:
 +
## Select one by one, by '''CTRL + Click''' on each object.
 +
## Use the [[File:Select_Button.png|24px|link=]] '''Select''' tool, and draw a rectangle encompassing the objects to be selected. [[File:BBL_Assign_Object_005.png|thumb|center|700px|Using select tool to select objects|link=]]
 +
## Right click on 3D scene and click on '''Select All Visible''' for quicker selection. [[File:BBL_Assign_Object_006.png|thumb|center|700px|Select all visible|link=]]
 +
# With the 3D objects selected, under the '''Object Assignment''' section, click '''ASSIGN SELECTED''' to assign these objects to the level. [[File:BBL_Assign_Object_007.png|thumb|center|700px|Assigning selected|link=]]
 +
# Upon successful assigning of objects, the number of assigned objects to this level will be updated. [[File:BBL_Assign_Object_008.png|thumb|center|700px|Total assigned objects number updated|link=]]
 +
# You can use '''HIGHLIGHT ASSIGNED''' to temporary highlight and view the objects assigned to the level [[File:BBL_Assign_Object_015.png|thumb|center|700px|Highlight objects assigned to level|link=]]
 +
# To remove all assigned objects from level, select '''CLEAR ASSIGNED''' button.
 +
# To remove selected assigned objects from level, select the objects and click on '''UNASSIGN SELECTED''' button.
 +
# Select "SAVE" (top right corner) after you have finished assigning the objects for this level.
 +
# Return to levels listing and continue with the rest of the building, blocks and level assignment. [[File:BBL_Assign_Object_009.png|thumb|center|700px|Select another level to continue object assignment|link=]]
 +
# If the objects are hidden, you can click on '''UNHIDE''' All to unhide all hidden objects [[File:BBL_Assign_Object_010.png|thumb|center|700px|Unhide all|link=]]
 +
# You can use the options under the '''Object Visibility''' section to help you in showing or hiding 3D objects during objects selection.
 +
## '''Outside Level Extent''': Show or hide objects outside of level extent
 +
## '''Above Level Extent''': Show or hide objects above level extent
 +
## '''Below Level Extent''': Show or hide objects below level extent
 +
## '''Assigned to Level''': Show or hide objects already assigned to this level
 +
## '''Not Assigned to Level''': Show or hide objects not assigned to this level
 +
## '''Assigned to Other Levels''': Show or hide objects already assigned to other levels
 +
## '''Unassigned''': Show or hide objects not assigned to any levels
 +
## '''All''': Show or hide all 3D objects [[File:BBL_Assign_Object_011.png|thumb|center|700px|Examples of using the object visibility options|link=]]
 +
# Senfi CMS also provides '''Model Browser''' to allow you to search and select individual object by its name. In the toolbar, click on '''Model Browser''' to bring out the model object listing pop-up. [[File:BBL_Assign_Object_012.png|thumb|center|700px|Activate Model Browser|link=]]
 +
## Enter object name into the search bar. Objects with the relevant keywords will be filtered out. [[File:BBL_Assign_Object_013.png|thumb|center|700px|Enter object name into search bar|link=]]
 +
## Selecting on an item in the search result isolates the object [[File:BBL_Assign_Object_014.png|thumb|center|700px|Isolate selected search object|link=]]
 +
# Right clicking in the 3D scene without selecting any object brings up a menu with four options:
 +
## '''Show all objects''': Unhides all hidden objects.
 +
## '''Pivot''': Uses the point where the mouse click is as the pivot for all camera interactions (zoom/pan/rotate).
 +
## '''Invert Visibility''': Hides all visible objects and unhides all hidden objects.
 +
## '''Select All Visible''': Selects all visible objects. [[File:BBL_Assign_Object_016.png|thumb|center|700px|Right click menu|link=]]
 +
# Right clicking in the 3D scene after selecting an object brings up a menu with eleven options:
 +
## '''Show properties''': Displays properties of selected object.
 +
## '''Isolate''': Isolates selected object.
 +
## '''Hide selected''': Hides selected object.
 +
## '''Show all objects''': Unhides all hidden objects.
 +
## '''Focus''': Zooms view into selected object.
 +
## '''Pivot''': Uses the selected object as the pivot for all camera interactions (zoom/pan/rotate).
 +
## '''Clear selection''': Clears all selection.
 +
## '''Invert Selection''': Unselects selected object and selects all unselected objects.
 +
## '''Invert Visibility''': Hides all visible objects and unhides all hidden objects.
 +
## '''Select All Visible''': Selects all visible objects.
 +
## '''Section''': Isolate and section up the selected object according to the mode selected.
 +
### '''Section Box''': Uses a box to section the selected object.
 +
### '''Section Plane''': Uses a plane to section the selected object. [[File:BBL_Assign_Object_017.png|thumb|center|700px|Right click menu|link=]]

Latest revision as of 17:17, 31 March 2022

Add Site with Bespoke Model

Adding a Site using a Bespoke Model can be broken down into seven major steps:

  1. Create New Site
  2. Fill in General Information
  3. Choose Model Type
  4. Upload 3D Model
  5. Set Default View and Thumbnail
  6. Create BBL Structure
  7. Assigning 3D Objects to BBL
Note: Mandatory fields are marked with an ‘*’. The following steps assume that the user is already logged in to the CMS.

Create New Site

Steps to create a new Site
  1. Go to the Site icon.pngSite tab.
  2. Select Add.pngADD NEW. Go to Fill in General Information.

Fill in General Information

Fill in Site's general information
  1. Fill in the necessary fields (E.g. Site Name, Description, Country, Address etc.).
  2. Add Geolocation (optional):
    1. Select Geolocation.
    2. There are two ways to select location:
      • Search:
      1. Use the Search.pngSearch function to look for the specific location.
      • Drop Pin:
      1. Drag the map to the required location.
      2. Select "EDIT".
      3. Drop pin at the site location on the map.
      • See Tip and Note (below).
    3. Select 'OK' to add geolocation. This will automatically update the country of the site but not its address.
  3. Select "NEXT". Go to Choose Model Type.
Tip: Subsequently, the pin can be dragged to different positions on the map.
Note: For subsequent changes, the displayed address will not be automatically updated. The Use address.pngUse Address button must be selected to update the address.

Choose Model Type

Choose Bespoke Model Type
  1. Choose Bespoke model type.
  2. Go to Upload 3D Model.

Upload 3D Model

Steps to upload 3D Model to build Site
  1. Select "Choose file" to select and upload a 3D building model Zip File.
  2. Select SUBMIT (top right corner) to add the Site.
  3. Once the 3D model has been processed, further action will be prompted.
    Prompt for further action
  4. Go to Set Default View and Thumbnail.

Set Default View and Thumbnail

Steps to add Site's default view and thumbnail
  1. Select Edit.pngEdit beside the site you just created.
  2. Select the Warning set default.pngwarning at the top of the screen.
  3. Set the site’s default view.
  4. Set the site’s thumbnail (optional).
  5. Assign Objects to BBL (optional).
  6. Add 2D Floorplans for each level (optional).
  7. Select "SAVE" or "SAVE & EXIT" (top right corner).

Create BBL Structure

Steps to add BBL (Building)
  1. Select Edit.pngEdit beside the site you just created.
  2. Select MODEL tab
  3. Select Edit Building/Block/Level
  4. A default building called Main Building has been created by the system. If you require more than one building, you can add more by clicking on ADD NEW BUILDING.
  5. To edit the building's name, just click on the building's name. After editing, click SAVE to update the building's name.
    Change building name
  6. To delete the building, just click on the BBL Delete.pngDELETE button beside the building name.
  7. To create the blocks under each building, just click on the BBL Next.pngNEXT arrow button beside the building name.
  8. A default block called Main Block has been created by the system. If you require more than one block, you can add more by clicking on ADD NEW BLOCK.
  9. To edit the block's name, just click on the block's name. After editing, click SAVE to update the block's name.
    Change block name
  10. To delete the block, just click on the BBL Delete.pngDELETE button beside the block name.
  11. To create the levels under each block, just click on the BBL Next.pngNEXT arrow button beside the block name.
  12. To return to the previous listing, click on the BACK arrow button beside the BBL breadcrumbs. BBL Back.png
  13. Repeat steps 8 to 12 for every building in the BBL.
  14. A default level called Level Name has been created by the system. If you require more than one level, you can add more by clicking on ADD NEW LEVEL.
  15. To edit the level's name, just click on the level's name. After editing, click SAVE to update the level's name.
    Change block name
  16. To delete the level, just click on the BBL Delete.pngDELETE button beside the level name.
  17. Repeat steps 14 to 16 for every block in the BBL.
  18. Select "SAVE" (top right corner) after you have finished creating the BBL structure.

Assigning 3D Objects to BBL

Now that we have created the BBL structure, we can proceed to assign objects to each building, block and level.

  1. To do so, go to the level listing in the BBL, and click on the BBL Next.pngNEXT arrow button beside the block name you want to assign objects to.
    Choosing level to assign 3D objects to
  2. First, you will need to define the level extent (vertical space where the level will extent to, from floor to ceiling). To do so, you can either:
    1. Fill in the floor position and ceiling position under the Level Extent section, if you have the information. Or,
    2. Select the floor 3D object for the level, and click on Update from Selected to update the floor position based on the selected 3D object's position. Repeat the same step for ceiling 3D object for the level.
      Update floor position from selected 3D object
      Update ceiling position from selected 3D object
    3. For levels with objects already assigned, you can also update the floor and ceiling position by selecting Update from Assigned.
  3. Under the Object Visibility section, click on HIDE button beside Outside Level Extent to hide objects outside of the level extent.
    Hide objects outside of level extent
  4. Select all the objects belonging to this level extent. To select multiple 3D objects in the 3D scene, you can:
    1. Select one by one, by CTRL + Click on each object.
    2. Use the Select Button.pngSelect tool, and draw a rectangle encompassing the objects to be selected.
      Using select tool to select objects
    3. Right click on 3D scene and click on Select All Visible for quicker selection.
      Select all visible
  5. With the 3D objects selected, under the Object Assignment section, click ASSIGN SELECTED to assign these objects to the level.
    Assigning selected
  6. Upon successful assigning of objects, the number of assigned objects to this level will be updated.
    Total assigned objects number updated
  7. You can use HIGHLIGHT ASSIGNED to temporary highlight and view the objects assigned to the level
    Highlight objects assigned to level
  8. To remove all assigned objects from level, select CLEAR ASSIGNED button.
  9. To remove selected assigned objects from level, select the objects and click on UNASSIGN SELECTED button.
  10. Select "SAVE" (top right corner) after you have finished assigning the objects for this level.
  11. Return to levels listing and continue with the rest of the building, blocks and level assignment.
    Select another level to continue object assignment
  12. If the objects are hidden, you can click on UNHIDE All to unhide all hidden objects
    Unhide all
  13. You can use the options under the Object Visibility section to help you in showing or hiding 3D objects during objects selection.
    1. Outside Level Extent: Show or hide objects outside of level extent
    2. Above Level Extent: Show or hide objects above level extent
    3. Below Level Extent: Show or hide objects below level extent
    4. Assigned to Level: Show or hide objects already assigned to this level
    5. Not Assigned to Level: Show or hide objects not assigned to this level
    6. Assigned to Other Levels: Show or hide objects already assigned to other levels
    7. Unassigned: Show or hide objects not assigned to any levels
    8. All: Show or hide all 3D objects
      Examples of using the object visibility options
  14. Senfi CMS also provides Model Browser to allow you to search and select individual object by its name. In the toolbar, click on Model Browser to bring out the model object listing pop-up.
    Activate Model Browser
    1. Enter object name into the search bar. Objects with the relevant keywords will be filtered out.
      Enter object name into search bar
    2. Selecting on an item in the search result isolates the object
      Isolate selected search object
  15. Right clicking in the 3D scene without selecting any object brings up a menu with four options:
    1. Show all objects: Unhides all hidden objects.
    2. Pivot: Uses the point where the mouse click is as the pivot for all camera interactions (zoom/pan/rotate).
    3. Invert Visibility: Hides all visible objects and unhides all hidden objects.
    4. Select All Visible: Selects all visible objects.
      Right click menu
  16. Right clicking in the 3D scene after selecting an object brings up a menu with eleven options:
    1. Show properties: Displays properties of selected object.
    2. Isolate: Isolates selected object.
    3. Hide selected: Hides selected object.
    4. Show all objects: Unhides all hidden objects.
    5. Focus: Zooms view into selected object.
    6. Pivot: Uses the selected object as the pivot for all camera interactions (zoom/pan/rotate).
    7. Clear selection: Clears all selection.
    8. Invert Selection: Unselects selected object and selects all unselected objects.
    9. Invert Visibility: Hides all visible objects and unhides all hidden objects.
    10. Select All Visible: Selects all visible objects.
    11. Section: Isolate and section up the selected object according to the mode selected.
      1. Section Box: Uses a box to section the selected object.
      2. Section Plane: Uses a plane to section the selected object.
        Right click menu