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

# Annotate and Share

<Frame>
  <img src="https://mintcdn.com/altoura-785c3552/EArVUaWKh2hZAQMu/frontline/images/remote-expert/how-it-works/remote-expert-panel-live-meeting.png?fit=max&auto=format&n=EArVUaWKh2hZAQMu&q=85&s=9249e673bafd86a4fc456f20561d117a" alt="Altoura Remote Expert panel in a live Teams meeting with annotation active and the SHARE FILES drop area" noZoom width="3189" height="1896" data-path="frontline/images/remote-expert/how-it-works/remote-expert-panel-live-meeting.png" />
</Frame>

### Overview

This guide is for the **remote expert** working in Microsoft Teams on desktop. By the end, you will know how to annotate the worker's live view and share PDF and 3D model files into their space.

The **Altoura Remote Expert** panel provides two capabilities during a live session:

* **Annotate**: Capture the HMD user's live view and draw visual annotations that appear in their physical environment.
* **Share Files**: Send 3D models (`.glb`) or PDF documents (`.pdf`) to the HMD user.

Annotation and file sharing are independent. You do not need to capture a screenshot to share files.

***

## Annotate the HMD View

### Start Annotating

1. In the Remote Expert panel, click **Start Annotating**.
2. Ask the HMD user to position their camera toward the area that requires guidance.

<Frame>
  <img src="https://mintcdn.com/altoura-785c3552/EArVUaWKh2hZAQMu/frontline/images/remote-expert/how-it-works/remote-expert-panel-live-meeting.png?fit=max&auto=format&n=EArVUaWKh2hZAQMu&q=85&s=9249e673bafd86a4fc456f20561d117a" alt="Annotation mode active with the drawing toolbar and empty SHARE FILES drop area" noZoom width="3189" height="1896" data-path="frontline/images/remote-expert/how-it-works/remote-expert-panel-live-meeting.png" />
</Frame>

### What Happens Next

* The HMD user's live camera feed fills the main canvas area.
* The **Start Annotating** button changes to **Stop Annotating**.
* Annotation tools appear in the right panel:
  * **Arrow**: Place directional arrows on the view.
  * **Pen**: Freehand drawing on the captured view.
  * **Color**: Change the annotation color.
  * **Undo**: Undo the last annotation action.
  * **Delete**: Remove all annotations.

### Drawing Annotations

1. Select a tool (arrow or pen) from the toolbar.
2. Draw directly on the HMD user's view in the main canvas.
3. The annotations are transmitted to the HMD device and appear anchored in the user's physical space.

The HMD user can see these markings overlaid in their environment, enabling precise visual guidance in real time.

### Rotate an Arrow

Arrows can be rotated to point in any direction while they are being placed — so you can indicate not just *where* to look, but which way to push, turn, or move. Arrow rotation is available on **both** the Teams (expert) side and the HoloLens (worker) side; the gesture differs to match the input device.

#### From Microsoft Teams (Expert)

<Note>
  **TODO — add a screenshot.** Capture the Teams-side arrow-rotation flow (mouse pressed and held while dragging to rotate the arrow) and place it here.
</Note>

Because the expert is on a desktop, rotation uses the mouse:

1. Select the **Arrow** tool from the annotation toolbar.
2. Move the cursor to the point on the captured view where the arrow should land.
3. **Press and hold** the left mouse button.
4. While keeping the button held, **drag the mouse** in a clockwise or anticlockwise direction to point the arrow.
5. When the arrow points in the direction you want, **release the mouse button**.

The arrow stays placed at that spot, in that direction, and is transmitted to the HMD user's physical space.

#### From the HoloLens (Worker)

<Note>
  **TODO — add screenshots.** Capture the HMD-side flow — one shot of the ghost / shadow arrow on a target surface, and one of the coloured arrow being rotated by pinch — and place them here.
</Note>

On the HoloLens, rotation uses the pinch gesture:

1. With the **Arrow** tool selected, look at the surface where the arrow should be placed.
2. A **ghost / shadow arrow** appears on the target surface — it shows exactly which surface the arrow will land on and how it will orient against it, so you can decide before committing.
3. When you are happy with the surface, **pinch and hold** (thumb + index finger). The ghost turns into a solid arrow in the currently selected annotation colour.
4. **Keeping your fingers pinched**, rotate your hand **clockwise or anticlockwise** to point the arrow in the direction you want.
5. When the arrow is pointing in the desired direction, **release the pinch**.

The arrow stays placed at that spot, in that direction, in the physical space — visible to both the worker and the expert.

### Stop Annotating

1. Click **Stop Annotating** to exit annotation mode.
2. The view returns to the standard live video feed.

***

## Share Files

You can share 3D models and PDF documents with the HMD user without entering annotation mode.

### Supported File Types

| Type          | Extension |
| ------------- | --------- |
| 3D Models     | `.glb`    |
| PDF Documents | `.pdf`    |

### Share a PDF

1. In the **SHARE FILES** section, drag and drop a PDF file into the drop area, or click to browse.

<Frame>
  <img src="https://mintcdn.com/altoura-785c3552/EArVUaWKh2hZAQMu/frontline/images/remote-expert/guide-the-worker/remote-expert-panel-shared-files.png?fit=max&auto=format&n=EArVUaWKh2hZAQMu&q=85&s=93e7d25f930ddbfed7c319ab10b4094f" alt="Remote Expert panel showing a PDF and a 3D model sent to the HMD user under SHARE FILES" noZoom width="3182" height="1901" data-path="frontline/images/remote-expert/guide-the-worker/remote-expert-panel-shared-files.png" />
</Frame>

2. The file appears in the list with a confirmation checkmark and **Sent** status.
3. You can share multiple files. Each appears as a separate entry.
4. To remove a file, click the **X** icon next to it.

<Note>
  Removing a file from the panel only removes it from the Teams app view. It does not remove the file from the HMD user's space.
</Note>

### Share a 3D Model

1. In the **SHARE FILES** section, drag and drop a `.glb` file into the drop area, or click to browse.

<Frame>
  <img src="https://mintcdn.com/altoura-785c3552/EArVUaWKh2hZAQMu/frontline/images/remote-expert/guide-the-worker/remote-expert-panel-shared-files.png?fit=max&auto=format&n=EArVUaWKh2hZAQMu&q=85&s=93e7d25f930ddbfed7c319ab10b4094f" alt="Remote Expert panel showing a 3D model (.glb) and a PDF sent to the HMD user under SHARE FILES" noZoom width="3182" height="1901" data-path="frontline/images/remote-expert/guide-the-worker/remote-expert-panel-shared-files.png" />
</Frame>

2. The file appears in the list with a confirmation checkmark and **Sent** status.

***

## Summary

| Action                  | Requires Annotation Mode?       |
| ----------------------- | ------------------------------- |
| Draw on the HMD view    | Yes, click **Start Annotating** |
| Share a PDF file        | No                              |
| Share a 3D model (.glb) | No                              |

***

Next: back to [How Remote Expert Works](/frontline/remote-expert/how-it-works), or see the [troubleshooting checks](/frontline/remote-expert/verify-teams-app#troubleshooting) if the app is not behaving as expected.
