ivx-accessibility

Files (1)

• SKILL.md

SKILL.md (first lines)

# IntelliVerseX Accessibility

## Overview

The Accessibility module provides drop-in features for making games playable by everyone. It covers visual, auditory, motor, and cognitive accessibility needs, with built-in compliance checkers for WCAG 2.1, CVAA (21st Century Communications and Video Accessibility Act), Xbox Accessibility Guidelines (XAG), and PlayStation accessibility requirements.

```
IVXAccessibilityManager (central coordinator)
      │
      ├── IVXColorBlindFilter     → Simulation + correction shaders
      ├── IVXScreenReaderBridge   → TalkBack / VoiceOver / Narrator
      ├── IVXScalableUI           → Dynamic font sizing + layouts
      ├── IVXInputRemapper        → Custom bindings + one-handed modes
      ├── IVXSubtitleSystem       → Captions with speaker ID + settings
      ├── IVXHighContrastMode     → High contrast UI + outlines
      └── IVXAccessibilityAudit   → WCAG / XAG compliance checker
```

---

## 1. Configuration

### IVXAccessibilityConfig ScriptableObject

Create via **Create > IntelliVerseX > Accessibility Configuration**.

| Field | Description |
|-------|-------------|
| `EnableAccessibility` | Master toggle |
| `DefaultFontScale` | Initial font scale multiplier (default 1.0) |
| `MinFontScale` / `MaxFontScale` | Allowed range (default 0.75–2.0) |
| `DefaultColorBlindMode` | `None`, `Deuteranopia`, `Protanopia`, `Tritanopia` |
| `EnableScreenReader` | Toggle screen reader integration |
| `SubtitleDefaults` | Default subtitle size, background opacity, speaker colors |
| `ShowAccessibilityOnFirstLaunch` | Prompt accessibility settings on first run |
| `HighContrastDefault` | Start in high contrast mode (default false) |

---

## 2. Color Blind Support

### IVXColorBlindFilter

Post-processing shader that simulates or corrects for color vision deficiencies:

```csharp
using IntelliVerseX.Accessibility;

IVXColorBlindFilter.Instance.SetMode(ColorBlindMode.Deuteranopia);
```

### Modes

| Mode | Affects | Prevalence |
|------|---------|-----------|
| `None` | No filter | — |
| `Deuteranopia` | Red-green (green cone) | 6% of males |
| `Protanopia` | Red-green (red cone) | 2% of males |
| `Tritanopia` | Blue-yellow | 0.01% |
| `Achromatopsia` | Complete color blindness | 0.003% |

### Simulation Mode (Design Tool)

```csharp
IVXColorBlindFilter.Instance.SetSimulationMode(ColorBlindMode.Deuteranopia);
```

Use in the editor to preview how your game looks to color blind players.

### Color Palette Helper

```csharp
var palette = IVXColorBlindFilter.Instance.GetSafePalette(paletteSize: 8);

foreach (var color in palette)
{
    Debug.Log($"Safe color: #{ColorUtility.ToHtmlStringRGB(color)}");
}
```

Returns colors distinguishable across all common color vision types.

---

## 3. Screen Reader Integration

### IVXScreenReaderBridge

Bridges game UI to platform screen readers:

```csharp
IVXScreenReaderBridge.Instance.Announce("Level 5 complete. Score: 12,500 points.");

IVXScreenReaderBridge.Instance.SetFocusDescription(
    element: startButton,
    label: "Start Game",
    hint: "Double tap to begin playing"
);
```

### Platform Screen Readers

| Platform | Screen Reader | Integration |
|----------|--------------|-------------|
| **Android** | TalkBack | `AccessibilityService` API |
| **iOS** | VoiceOver | `UIAccessibility` protocol |
| **Windows** | Narrator / NVDA | `UI Automation` API |
| **macOS** | VoiceOver | `NSAccessibility` protocol |
| **Xbox** | Narrator | Xbox Accessibility API |
| **PlayStation** | System TTS | Sony TRC accessibility API |
| **WebGL** | Browser screen reader | ARIA attributes on DOM overlay |

### Accessible Navigation

```csharp
IVXScreenReaderBridge.Instance.SetNavigationOrder(new[]
{
    titleText,
    playButton,

From intelli-verse-x/Intelli-verse-X-SDK, MIT.

More from intelli-verse-x/Intelli-verse-X-SDK