# 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.
- Drag the "Model URL" column from your data into the "
Model URL
" input field. - Drag the "Version Object ID" column from your data into the "
Version Object ID
" input field. - 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.
ā Installation Coloring ā