# Streamingle Utilities

A Unity package containing reusable Streamingle utilities. The package is divided by feature while retaining the existing public namespaces for compatibility.

## Modules

- **Gaze** — Blendshape eye-gaze driver, Timeline track, guided calibration window, and tests.
- **Constraints** — Lightweight transform constraints and custom inspectors.
- **Camera** — `SmoothFollow` component.
- **Timeline/Subtitles** — TextMeshPro subtitle Timeline track and SRT installer API.
- **Animation** — Blendshape gap-edge cleanup editor window.

## Editor menu conventions

- `Tools/Streamingle Utilities/Gaze/Calibration`
- `Tools/Streamingle Utilities/Animation/Blend Shape Gap Cleanup`
- `Component/Streamingle Utilities/Constraints/...`
- `Assets/Create/Streamingle Utilities/Gaze/Blendshape Gaze Profile`

## Dependencies

- Unity Timeline 1.8.10 or later
- TextMeshPro 5.0.0 or later

## Compatibility

The initial package release is validated against Unity 6 (`6000.3`). Public namespaces and the Gaze assembly names are retained during the package extraction to preserve existing project references.

## Camera Work AI package

This repository also contains a separately installable Unity package for
high-quality Timeline camera generation. It is intentionally stored under
`CameraAI~` so installing the root `Streamingle Utilities` package does not
also import the camera tools or their large worker distribution.

Install **Git and Git LFS before opening Unity**, then use **Add package from
git URL** with:

```text
https://kindnick-git.duckdns.org/mingle/streamingle-unity-utilities.git?path=/CameraAI~#v0.1.17
```

The Camera AI package includes the complete Windows x64
`CWCameraWorker.exe` onedir build and a read-only prepared reference library,
so artist workstations do not need Python or a separate `CW-AI` checkout.
The executable must remain beside its `_internal` directory. A newer
access-controlled `CW-AI` data root containing `DatasetExports`,
`reports/training_index.json`, and `models/cut_ranker_v2.json` remains an
optional override.

After installation, open `Tools > Streamingle > AI 카메라 생성`. The package
automatically locates its bundled worker and validates the configured data
library before enabling generation. See
`CameraAI~/Documentation~/EXTERNAL_INSTALLATION.md` for the complete setup.
Reference data may be read-only; per-project caches are written under
`Library/CWAI` (or the optional `CWAI_CACHE_ROOT` override).