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

# Set Hand Animation Color & Reset Hand Animation Color

> Customize the color of the learner's hand representation in the scene

## Overview

**Hand animations** are the visual representation of the learner's hands as they appear in the 3D scene. This is separate from instruction animations (the animated cues that show how to perform actions).

Use **Set Hand Animation Color** to customize how the learner's hands appear — useful for safety themes, branding, or visual distinction. Use **Reset Hand Animation Color** to restore the default color.

## Understanding Hand Animations

Learner hand animations appear:

* When the learner moves their hand/pointer to interact with objects
* During object manipulation (grabbing, moving, rotating)
* As visual feedback on where the learner is pointing or reaching
* In AR/mixed reality scenarios where hand presence is important

Hand color customization helps align the learner's virtual hands with your training context (e.g., making hands appear to wear gloves for safety trainings).

## Set Hand Animation Color

### When to Use

* **Safety training** — Make hands appear gloved or protected for hazmat/safety procedures
* **Branding** — Match learner hands to your training's color scheme
* **Visual distinction** — Use different hand colors for different learner personas or training scenarios
* **Accessibility** — Improve visibility or contrast for learners with visual needs

### Parameters

| Parameter | Type         | Required | Description                                                                  |
| --------- | ------------ | -------- | ---------------------------------------------------------------------------- |
| Color     | String (Hex) | Yes      | Hexadecimal color code (e.g., `"#FFA500"` for orange, `"#8B4513"` for brown) |

### Example 1: Orange Gloved Hands

```
Action: Set Hand Animation Color
Color: "#FFA500"
```

Learner hands appear orange, suggesting protective gloves or orange safety wear.

### Example 2: Blue Hands (Lab Coat Theme)

```
Action: Set Hand Animation Color
Color: "#0099FF"
```

Learner hands appear blue, aligning with a tech or lab coat theme.

### Example 3: Brown Hands (Work Gloves)

```
Action: Set Hand Animation Color
Color: "#8B4513"
```

Learner hands appear brown, suggesting heavy-duty work gloves.

## Reset Hand Animation Color

### When to Use

* Return to the default learner hand color after a custom phase
* Reset between training modules or sections
* Restore system defaults when custom coloring is no longer needed

### Parameters

| Parameter | Type | Required | Description                                               |
| --------- | ---- | -------- | --------------------------------------------------------- |
| None      | —    | —        | No parameters. Resets to the default hand animation color |

### Example

```
Action: Reset Hand Animation Color
```

Learner hands return to their default system color.

## Best Practices

<Steps>
  <Step title="Establish context early">
    Set the learner hand color early in the training to establish visual context.
  </Step>

  <Step title="Use colors that suggest safety">
    For safety trainings, use colors that imply protective equipment (orange, blue, yellow, brown).
  </Step>

  <Step title="Distinguish from instruction hands">
    Use different colors for learner hands vs. instruction animations to avoid confusion.
  </Step>

  <Step title="Keep consistent throughout">
    Maintain the same hand color throughout a training section unless you have a good reason to change.
  </Step>

  <Step title="Test visibility">
    Verify the hand color is visible against the 3D scene background on multiple devices.
  </Step>

  <Step title="Document the meaning">
    If using custom hand colors, explain what they represent (e.g., "Orange hands = safety gloves").
  </Step>
</Steps>

## Common Patterns

### Safety Equipment Visualization

```
State: HazmatProcedure
  onEntry:
    → Set Hand Animation Color (Color: "#FFD700")
    → Show Panel
        Title: "Hazmat Handling"
        Display Text: "Your hands appear gloved (gold color) to indicate protective equipment required for this procedure."
        Billboard: true
    → Show Text "Always wear protective gloves when handling hazardous materials."

  onExit:
    → Hide Panel
    → Hide Text
    → Reset Hand Animation Color
```

Learner hands turn gold to represent required protective gloves. The color resets after the hazmat phase.

### Lab Work Theme

```
State: LabExperiment
  onEntry:
    → Set Hand Animation Color (Color: "#0099FF")
    → Show Panel
        Title: "Lab Procedure"
        Display Text: "Your hands appear in blue, representing lab coat sleeves. Maintain sterile technique throughout."
        Billboard: true

  onExit:
    → Hide Panel
    → Reset Hand Animation Color
```

Blue hands suggest lab coat attire, reinforcing the laboratory context.

### Heavy Equipment Operation

```
State: MachineryOperation
  onEntry:
    → Set Hand Animation Color (Color: "#8B4513")
    → Show Panel
        Title: "Heavy Machinery"
        Display Text: "Your hands appear in brown, representing heavy-duty work gloves. Grip firmly and stay alert."
        Billboard: true

  onExit:
    → Hide Panel
    → Reset Hand Animation Color
```

Brown hands suggest rugged work gloves suitable for machinery operation.

### Multi-Step Procedure with Context Changes

```
State: UnprotectedInspection
  onEntry:
    → Reset Hand Animation Color
    → Show Text "Step 1: Visual inspection (hands unprotected for better precision)"

State: GlovedAssembly
  onEntry:
    → Set Hand Animation Color (Color: "#FFA500")
    → Show Text "Step 2: Assembly (hands gloved for safety)"

State: FinalVerification
  onEntry:
    → Reset Hand Animation Color
    → Show Text "Step 3: Verification (inspect for proper assembly)"
```

Hand color changes to reflect different safety requirements at each step.

## Color Reference for Safety Themes

| Color  | Hex Code  | Represents         | Use Case                    |
| ------ | --------- | ------------------ | --------------------------- |
| Orange | `#FFA500` | Safety gloves, PPE | General safety procedures   |
| Blue   | `#0099FF` | Lab coat, medical  | Lab and medical work        |
| Yellow | `#FFFF00` | High-visibility    | Hazard awareness, caution   |
| Brown  | `#8B4513` | Work gloves        | Heavy machinery, outdoor    |
| Red    | `#CC0000` | Protective wear    | Hazmat, critical procedures |
| Green  | `#00BB00` | Standard PPE       | Normal safe operations      |
| Purple | `#9933FF` | Specialty gloves   | Unique/specialized work     |
| White  | `#F5F5F5` | Sterile/clean      | Medical, clean room         |

## Related Actions

* **Set Instruction Animation Color** — Customize instruction animation color (separate from learner hands)
* **Set Tether Line Color** — Customize the interaction line color
* **Set Hand Representation** — Change the 3D model used for learner hands (beyond just color)
* **Show Text** — Explain the hand color meaning to learners