# 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:

  • Stream URL 👈
  • URL Type
  • Commit Object ID🆕 👈
  • Object ID 👈
  • speckle_type
  • data

Stream URL, Commit 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 "Stream URL" column from your data into the "Stream URL" input field.
  2. Drag the "Commit Object ID" column from your data into the "Commit 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 Stream URLCommit 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.