> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognite.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Contextualize 360° images

> Manually contextualize 360° images by using a single 360° image file or leveraging the 360° image contextualization within a scene.

<Tip>
  When **contextualizing 3D objects** (CAD models, point clouds, and 360° images), you can use the unified 3D contextualization editor available in [scene](/cdf/3d/guides/scene#unified-3d-contextualization).

  By selecting this option, you'll see where each 360° image is located in the scene, which helps you link the images to the right assets.
</Tip>

## Before you start

Make sure you've uploaded the 360° images you want to contextualize.
For more information on uploading 360° images, see [Upload 360° images](/cdf/3d/guides/360images_upload).

<a id="trigger-text-detection-dm-only" />

### Trigger text detection (data modeling projects)

Before contextualizing, you can **trigger text detection** to create contextualization suggestions for text regions that you can link to the correct asset to accelerate contextualization.

<Warning>
  This feature is available in **data modeling** projects only.
</Warning>

<Steps>
  <Step title="Select the 360° image collection">
    In **Data fusion** > **Configure** > **3D**, select the 360° image collection you want to process.
  </Step>

  <Step title="Trigger text detection">
    Select the `...` menu in the lower right of the collection view and select <span class="ui-element">Trigger text detection</span>.

    Processing runs on the images in the collection and generates contextualization suggestions.
    After it has been triggered, the option is grayed out because it cannot be triggered multiple times.
  </Step>

  <Step title="Open the collection to view and link suggestions">
    After text detection completes, open the 360° image collection to see the contextualization suggestions (yellow areas). To link each suggestion to an asset, follow **Find the asset** and **Link the asset** steps in [Contextualize](#contextualize).
  </Step>
</Steps>

<a id="contextualize" />

## Contextualize

<Steps>
  <Step title="Open the 360° image collection">
    Select the 360° image collection and **Open** it to start the contextualization process within the 3D environment.

    <Info>
      **Contextualize 360° images within a scene**

      From the scene tree view, select the 360° image collection you want to contextualize. Select <span class="ui-element">Contextualize</span> to start. For more information, see [Unified 3D contextualization](/cdf/3d/guides/scene#unified-3d-contextualization).
    </Info>
  </Step>

  <Step title="Open a 360° image">
    Select a 360° image to open it. Inside the 360° image, you'll have the contextualization tools.
  </Step>

  <Step title="Create a bounding area">
    Select <Icon icon="vector-square" /> to create a bounding area in a 360° image. Select a point and move the cursor to create a box of any shape. Press <kbd>Esc</kbd> to complete the drawing.

    You can create multiple bounding areas. By default, the color of the area is blue, but it switches to pink once you link it to an asset.
  </Step>

  <Step title="Find the asset">
    Use the search bar in the resource selector on the top right to find the asset you want to map to the selected object.
  </Step>

  <Step title="Link the asset">
    Select the asset, verify it is correct, and select **Link**. {/*The object's color changes to purple.*/}

    You've created an annotation (contextualized bounding area).
  </Step>
</Steps>

The newly created annotation appears under the selected image in the left sidebar. You can see which 360° images have annotations.

### Tools in contextualization

* In the top bar, you can navigate between 360° images. <span class="ui-element">X</span> closes the image, and you can return to the last one you opened.

* <span class="ui-element">Settings</span> <Icon icon="settings" /> opens visualization controls:

  * <span class="ui-element">Image transparency</span>: Use the slider to control the transparency level of the 360° image with the CAD model in the background. This fine-tunes the visibility between the two layers.
  * <span class="ui-element">Marker transparency</span>: Adjust marker transparency to balance visibility with other visual elements.
  * <span class="ui-element">360° markers</span>: Customize marker visibility to enhance your image analysis and inspection experience:
    * <span class="ui-element">X-ray</span>: Reveal the hidden markers or display all the 360° markers within the same view.
    * <span class="ui-element">Visible</span>: Turn markers on and off.

* Turn on and off grid axis directions using <span class="ui-element">Show or hide axis</span> in the toolbar.

* To zoom an annotation, select <span class="ui-element">Zoom to annotation</span>.

## Delete annotation

To delete the annotation:

<Steps>
  <Step title="Select the annotated area">
    Select the <Icon icon="mouse-pointer" /> icon from the toolbar and select the annotated area.
  </Step>

  <Step title="Delete the annotation">
    Select <Icon icon="trash-2" /> in the top right corner.

    You've deleted the annotation.
  </Step>
</Steps>