# sphere ref

**Référence bilingue pour étudier la couleur et l’éclairage sur une sphère 3D.**

sphere ref est une application web développée dans le cadre d’**Eigrutel Lab**, l’atelier d’outils libres pour la bande dessinée d’**Eigrutel BD Academy**.

Elle permet de composer un éclairage trois points, d’observer son effet sur une sphère lisse ou facettée, puis d’extraire et d’exporter la palette réellement visible dans le rendu.


## Aperçus

### Vue d’accueil

![Vue d’accueil de sphere ref](docs/images/sphereref-accueil.png)

### Mode facettes

![Mode facettes de sphere ref](docs/images/sphereref-facettes.png)

### Éclairage Spotlight

![Éclairage Spotlight de sphere ref](docs/images/sphereref-spotlight.png)

### Mode valeurs

![Mode valeurs de sphere ref](docs/images/sphereref-values.png)

## Fonctionnalités principales

- sphère 3D lisse ou facettée ;
- couleur de sphère réglable ;
- couleur de fond réglable ;
- éclairage trois points Key, Fill et Back ;
- choix indépendant entre lumière directionnelle et Spotlight ;
- réglage de la couleur et de la force de chaque source ;
- positionnement par angle horizontal et hauteur ;
- réglage de la distance et de l’ouverture pour les Spotlights ;
- affichage facultatif des positions et noms des lumières ;
- rotation libre ou verrouillage de la vue ;
- passage du rendu couleur aux valeurs ;
- extraction automatique des couleurs réellement visibles sur la sphère ;
- affichage de 5 couleurs, 12 couleurs ou de la palette complète ;
- copie des codes hexadécimaux ;
- export des palettes en `.TXT`, `.ASE` et `.ACO` ;
- schéma simple de l’éclairage trois points ;
- interface bilingue français–anglais ;
- mémorisation locale des réglages ;
- réinitialisation complète des valeurs par défaut.

## Utilisation

sphere ref ne nécessite aucune installation ni aucun serveur applicatif.

1. Télécharger le fichier `sphere_ref.html`.
2. L’ouvrir dans un navigateur web récent.
3. Régler la sphère, le fond et les trois lumières.
4. Choisir le mode lisse ou facetté.
5. Copier ou exporter la palette obtenue.

Babylon.js est chargé depuis son CDN officiel. Une connexion est donc nécessaire au premier chargement, sauf adaptation du fichier pour utiliser une copie locale de la bibliothèque.

## Lumières

Chaque source peut être configurée en :

- **Directionnelle** : rayons parallèles, intensité indépendante de la distance ;
- **Spotlight** : source localisée avec distance et ouverture de faisceau.

Les réglages disponibles comprennent selon le type :

- couleur ;
- force ;
- angle ;
- hauteur ;
- distance ;
- ouverture.

## Palette

La palette est prélevée directement dans le rendu WebGL de la sphère.

Le programme limite l’analyse à la projection visible de la sphère afin d’exclure :

- le fond ;
- les lignes des sources ;
- les marqueurs ;
- les cartouches.

Trois niveaux sont proposés :

- 5 couleurs ;
- 12 couleurs ;
- complète.

## Exports

Les palettes peuvent être exportées dans les formats suivants :

- `.TXT` : liste de codes hexadécimaux ;
- `.ASE` : Adobe Swatch Exchange ;
- `.ACO` : Adobe Color.

Le bouton **Copier** place les codes de la palette active dans le presse-papiers lorsque le navigateur l’autorise.

## Langues

L’interface est disponible en :

- français ;
- anglais.

Le bouton discret `FR / EN` placé dans l’en-tête permet de changer de langue. Le choix est mémorisé localement.

## Données et confidentialité

sphere ref ne demande aucun compte et n’envoie aucun réglage vers un serveur.

Les préférences sont conservées dans le stockage local du navigateur. Elles peuvent être supprimées avec les données du site.

La seule ressource distante appelée par défaut est Babylon.js.

## Compatibilité

sphere ref est conçu pour les navigateurs modernes :

- Safari ;
- Chrome ;
- Edge ;
- Firefox.

Avant diffusion, la version stable doit être vérifiée sur plusieurs supports, en particulier :

- Windows ;
- macOS ;
- iPadOS ;
- ordinateur ;
- tablette ;
- souris ;
- écran tactile.

## Structure minimale du dépôt


```text
eigrutel-sphere-ref/
├── sphere_ref.html
├── index.html
├── README.md
├── NOTICE.md
├── CHANGELOG.md
├── ARCHITECTURE.md
├── LICENSE.md
├── favicon/
│   └── favsphere.png
└── docs/
    └── images/
        ├── sphereref-accueil.png
        ├── sphereref-facettes.png
        ├── sphereref-spotlight.png
        └── sphereref-values.png
```

## Version

**Version stable : 1.0.0**  
**Date : 1er août 2026**

## Auteur

Programme conçu et développé par **Simon Léturgie** dans le cadre d’**Eigrutel BD Academy**.

Projet publié sous la bannière :

**Eigrutel Lab — Atelier d’outils libres pour la bande dessinée**

## Licences

- **Code source :** GNU Affero General Public License v3.0 ou version ultérieure.
- **Documentation et modèles :** Creative Commons Attribution — Partage dans les mêmes conditions 4.0 International, sauf mention contraire.
- **Marques, logos et signes distinctifs :** Eigrutel, Eigrutel Lab et Eigrutel BD Academy sont réservés.
- **Babylon.js :** bibliothèque tierce soumise à sa propre licence.

Les informations détaillées figurent dans les fichiers `LICENSE.md` et `NOTICE.md`.

## Dépôt officiel

https://github.com/Eigrutel/sphere-ref