# Using 3D Viewer Visual

The 3D Viewer Visual was designed to work alongside ourĀ Power BI Connector. TheĀ data connectorĀ will output a table containing the following columns:

  • Model URL šŸ‘ˆ
  • URL Type
  • Version Object IDšŸ†• šŸ‘ˆ
  • Object ID šŸ‘ˆ
  • speckle_type
  • data

Model URL, Version Object ID, and Object ID are used to visualize your Speckle data in 3D.

# Viewing Objects in 3D

With the Speckle 3D Viewer Visual added, you can now configure the input fields to display your Speckle data.

  1. Drag the "Model URL" column from your data into the "Model URL" input field.
  2. Drag the "Version Object ID" column from your data into the "Version Object ID" input field.
  3. Drag the "Object ID" column from your data into the "Object ID" input field.

Once all inputs are added, 3D Viewer Visual will load the objects into the scene.

There are two extra optional fields:

  • Color By: defines how the objects get grouped to be assigned colors.
  • Tooltip data: defines the information shown on the tooltip when selecting an object.

šŸ“ŒIMPORTANT

TheĀ Model URL,Ā Version Object ID,Ā andĀ Object IDĀ columns will exist on the resulting query when usingĀ the Get by URLĀ function.

If you're using the new (experimental)Ā Get by URL [Structured]Ā function, you must generate these columns in your final query table. The information is attached to the table as aĀ METAĀ that can be queried in your Query Editor.

# Context-Menu

When an object isĀ right-clicked, the context menu for that object will appear. This allows for easy object exclusion/isolation from the viewer in an interactive way.

If you want to reset the exclusions, click on the 3D Viewer Visual, go to the ā€œFiltersā€ pane, and remove the ā€œExcludedā€ filters.

šŸ“ŒIMPORTANT

Power BI provides the context menu; some features still need to be implemented in depth. More work will be done to improve context-menu functionality in the coming releases.