# Video Recording Best Practices

This guide provides recommendations for recording videos that will produce
high-quality motion capture results with the Aja Motion Pipeline.

## Camera Setup

### Resolution

| Quality Level | Recommended Resolution | Minimum Resolution |
| ------------- | ---------------------- | ------------------ |
| Draft         | 720p (1280x720)        | 480p (854x480)     |
| Standard      | 1080p (1920x1080)      | 720p (1280x720)    |
| High          | 1080p (1920x1080)      | 1080p (1920x1080)  |
| Ultra         | 4K (3840x2160)         | 1080p (1920x1080)  |

### Frame Rate

- **Minimum:** 24 fps
- **Recommended:** 30 fps for standard motion
- **Optimal:** 60 fps for fast movements (dance, martial arts, sports)
- **Maximum processed:** 120 fps (downsampled to 60 fps)

Higher frame rates significantly improve motion quality for fast movements.

### Camera Position

#### Single Camera Setup

```
        Subject
           │
           │ 3-5 meters
           │
           ▼
      ┌─────────┐
      │ Camera  │ Height: Subject's hip level
      └─────────┘
```

**Recommendations:**

- Distance: 3-5 meters from subject
- Height: At hip level of subject (approximately 1 meter)
- Angle: Perpendicular to subject's main movement direction
- Keep entire body in frame with 20% margin on all sides

#### Multi-Camera Setup (for best results)

```
           Camera 1 (Front)
                │
                ▼
        ┌───────────────┐
        │               │
Camera 3│    Subject    │Camera 2
(Left)  │               │(Right)
        └───────────────┘
                │
                ▼
           Camera 4 (Back)
```

Multi-camera setup significantly improves:

- Occlusion handling
- Depth estimation
- Joint rotation accuracy

## Lighting

### Indoor Lighting

**Ideal Setup:**

- Soft, diffused lighting from multiple sources
- Avoid harsh shadows on the subject
- Color temperature: 5000-5600K (daylight balanced)
- Brightness: 500-1000 lux at subject

**Common Issues to Avoid:**

- Strong backlighting (silhouettes)
- Flickering artificial lights (especially LED)
- Mixed color temperatures (creates color casts)
- Direct spotlight (harsh shadows obscure joints)

### Outdoor Lighting

**Best Conditions:**

- Overcast sky (natural diffusion)
- Golden hour (1 hour after sunrise, 1 hour before sunset)
- Open shade (shaded area with reflected light)

**Avoid:**

- Direct midday sun (harsh shadows)
- Dappled light through trees (inconsistent lighting)
- Strong backlight (subject in shadow)

## Subject Preparation

### Clothing

**Recommended:**

- Form-fitting clothes that show body shape
- Solid colors (avoid patterns)
- Contrasting colors from background
- Neutral colors (black, white, gray) work well

**Avoid:**

- Loose, flowing garments (hide body shape)
- Stripes, checkers, or complex patterns (confuse tracking)
- Colors matching background (poor contrast)
- Shiny or reflective materials (cause artifacts)

### Markers (Optional Enhancement)

For highest accuracy, apply visual markers:

```
       Head
        ○
       ╱ ╲
      ●   ● Shoulders
       ╲ ╱
        ● Sternum
        │
    ●───●───● Hips
        │
    ●───●───● Knees
        │
    ●───●───● Ankles
```

**Marker Recommendations:**

- Use 3cm diameter colored dots
- Contrasting color to clothing
- Stick-on fabric markers or sports tape
- Place on visible joint locations

## Background

### Recommended

- Plain, solid color background
- Contrasting with subject's clothing
- Green/blue screens work well (though not required)
- Minimal clutter in frame

### Avoid

- Moving backgrounds (people, traffic)
- Mirrors or reflective surfaces
- Complex patterns (bookshelves, brick walls)
- Other people in frame

## Movement Guidelines

### General Tips

1. **Start with T-Pose:** Begin each recording with 2-3 seconds of T-pose for
   calibration

   ```
        ○
      ─ │ ─
        │
       ╱ ╲
   ```

2. **Smooth Movements:** Avoid jerky, sudden movements that can cause motion
   blur

3. **Face the Camera:** When possible, orient facing the camera for best results

4. **Stay in Frame:** Ensure full body remains visible throughout

5. **Avoid Self-Occlusion:** Minimize arm crossing body, turning back to camera

### Domain-Specific Guidelines

#### Yoga

- Hold poses for 2-3 seconds
- Transition slowly between poses
- Camera at 45-degree angle captures depth
- Consider mat markers for ground plane

#### Dance

- Use 60 fps minimum for fast movements
- Wide shot to capture full extensions
- Multiple angles for complex choreography
- Avoid loose costumes that obscure form

#### Fitness

- Consistent camera height relative to exercise
- Good lighting on face for expression
- Side angle for squats, deadlifts
- Front angle for pressing movements

#### Martial Arts

- 60 fps or higher required
- Wide frame for kicks and jumps
- Multiple cameras for spinning techniques
- Contrasting gi/uniform color

## Technical Settings

### Codec Recommendations

| Format      | Codec                | Quality   | File Size  |
| ----------- | -------------------- | --------- | ---------- |
| Best        | ProRes 422           | Highest   | Large      |
| Recommended | H.264 (High Profile) | Very Good | Medium     |
| Acceptable  | H.264 (Main Profile) | Good      | Small      |
| Avoid       | H.264 (Baseline)     | Poor      | Very Small |

### Bitrate Guidelines

| Resolution | Minimum Bitrate | Recommended Bitrate |
| ---------- | --------------- | ------------------- |
| 720p       | 5 Mbps          | 10 Mbps             |
| 1080p      | 10 Mbps         | 20 Mbps             |
| 4K         | 35 Mbps         | 50 Mbps             |

### Audio

- Audio is not processed but is preserved in output
- Can be used for synchronization reference
- Recommend recording audio for timing reference

## Common Issues and Solutions

### Issue: Limbs "Pop" or Jump

**Causes:**

- Fast movement with low frame rate
- Motion blur
- Occlusion

**Solutions:**

- Increase frame rate to 60 fps
- Improve lighting to reduce motion blur
- Use multiple camera angles

### Issue: Jittery/Unstable Motion

**Causes:**

- Camera shake
- Low resolution
- Poor contrast

**Solutions:**

- Use tripod or stabilization
- Increase resolution
- Improve subject/background contrast

### Issue: Foot Sliding

**Causes:**

- Inconsistent ground plane
- Poor depth estimation
- Subject moving relative to ground reference

**Solutions:**

- Use floor markers for reference
- Ensure stable camera position
- Enable foot contact cleanup in pipeline

### Issue: Incorrect Pose Estimation

**Causes:**

- Occlusion
- Similar colors to background
- Multiple people in frame

**Solutions:**

- Reposition camera to reduce occlusion
- Change subject's clothing color
- Ensure single subject in frame

## Pre-Recording Checklist

- [ ] Camera resolution set to 1080p or higher
- [ ] Frame rate set to 30 fps or higher
- [ ] Tripod stable and level
- [ ] Full body visible with margins
- [ ] Lighting even without harsh shadows
- [ ] Subject wearing form-fitting, solid colors
- [ ] Background clear and contrasting
- [ ] Test recording reviewed
- [ ] Memory card space verified
- [ ] Battery fully charged

## Post-Recording Verification

Before submitting to the pipeline:

1. **Playback Check:**
   - Watch full video at normal speed
   - Verify no dropped frames
   - Confirm full body always visible

2. **Quality Check:**
   - Sharp focus on subject
   - No excessive motion blur
   - Consistent exposure

3. **Technical Check:**
   - File format supported (MP4, MOV, etc.)
   - File not corrupted
   - Reasonable file size for upload
