> ## Documentation Index
> Fetch the complete documentation index at: https://speckle-assistant.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Coloring Objects in 3D

export const connector_0 = "PowerBI Visual"

<div class="callout my-4 px-5 py-4 overflow-hidden rounded-2xl flex gap-3 border-2 border-red-600 bg-red-100/50 dark:border-red-600 dark:bg-red-400/20" data-callout-type="warning">
  <div class="mt-0.5 w-4" data-component-part="callout-icon">
    <svg class="flex-none w-5 h-5 text-red-700 dark:text-red-300" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2" aria-label="Warning">
      <path stroke-linecap="round" stroke-linejoin="round" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z" />
    </svg>
  </div>

  <div class="text-sm prose min-w-0 w-full text-red-700 dark:text-red-300" data-component-part="callout-content">
    <b>Notice</b>: This user guide is based on the legacy {connector_0} connector.<br />
    We recommend using our new connectors instead, as they are easier to use and actively maintained. This legacy documentation may not be up to date.
  </div>
</div>

<Frame>
  <img src="https://mintcdn.com/speckle-assistant/WU-XhQlBBfFr6sbO/images/legacy/powerbi/11-coloring-objects.gif?s=d99918d0b7fb952775d13505bc3edbc1" alt="Coloring objects demonstration" width="960" height="550" data-path="images/legacy/powerbi/11-coloring-objects.gif" />
</Frame>

Once a field has been added to **Color By,** the viewer will color the data by the provided field when available. The objects' colors will be automatically generated and assigned using the Power BI dashboard color palette.

## Aligning colors across visuals

You may notice that, initially, the colors of your visual don't match the other colors assigned in other visuals of your report.

You can fix this by aligning the sorting of the 3D visual to match the sorting performed by other visuals. If they are sorted by name (or any other parameter you defined), change 3D Viewer Visual's sorting to match that. Objects get assigned by Power BI in order, so if the order of your visual matches the others, the colors should too.

<Frame>
  <img src="https://mintcdn.com/speckle-assistant/WU-XhQlBBfFr6sbO/images/legacy/powerbi/12-aligning-colors.gif?s=9fdc24f94933d9faebf7063c2784326c" alt="Aligning colors demonstration" width="960" height="550" data-path="images/legacy/powerbi/12-aligning-colors.gif" />
</Frame>

<Warning>
  Currently, 3D Viewer Visual doesn't automatically detect your changes. So you need to manually reload the visual. One way of doing is Ctrl+X -> Ctrl+V.
</Warning>

## Highlighting objects across visuals

<Frame>
  <img src="https://mintcdn.com/speckle-assistant/WU-XhQlBBfFr6sbO/images/legacy/powerbi/13-highlight-across-visuals.gif?s=279296dd1d545a44968dcef4bb85f6bc" alt="Highlighting across visuals demonstration" width="960" height="550" data-path="images/legacy/powerbi/13-highlight-across-visuals.gif" />
</Frame>

Connect a field on the **Color By** or **Tooltip Data** to enable highlighting across report visuals. This could be any field in your data source (the object id, volume, level name, beam type...)

Once a field has been added, any objects highlighted in another visual (such as a Table, Matrix, Slicer...) will be filtered out in the viewer, showing any other objects *ghosted out (grey transparent material) or hidden (depending on your visual setting).*

This also works in reverse order: Selecting something on the visual will filter it on any other visual in the report configured to do so.