Path

De BlinderKitten Documentation
Version datée du 15 décembre 2025 à 23:15 par Norb (discussion | contributions) (Page créée avec « = Paths = Un '''Path''' (ou BKPath) définit une disposition géométrique utilisée dans un '''Layout''' pour positionner des fixtures ou des subfixtures. Les paths servent à la fois à la visualisation dans le layout et comme base de calcul pour les filtres spatiaux (Direction, Circle, Wake, Perlin…). Un path associe chaque fixture ou subfixture sélectionnée à une position 2D calculée selon un type de path. == Paramètres généraux == {| class="wi... »)
(diff) ← Version précédente | Version actuelle (diff) | Version suivante → (diff)
Aller à la navigation Aller à la recherche

Paths

[modifier]

Un Path (ou BKPath) définit une disposition géométrique utilisée dans un Layout pour positionner des fixtures ou des subfixtures. Les paths servent à la fois à la visualisation dans le layout et comme base de calcul pour les filtres spatiaux (Direction, Circle, Wake, Perlin…).

Un path associe chaque fixture ou subfixture sélectionnée à une position 2D calculée selon un type de path.

Paramètres généraux

[modifier]
Paramètre Type Description
Type Enum Type de path utilisé (Point, Line, Rod, Grid, Circle, Preset).
Position Point2D Position d’origine du path dans le layout.
Spread Subfixtures Bool Si activé, les subfixtures sont réparties individuellement sur le path, sinon la position est calculée par fixture.

Apparence des tiles

[modifier]

Ces paramètres contrôlent l’affichage visuel des fixtures dans le layout pour ce path.

Paramètre Type Description
Tiles size Point2D Taille graphique des tiles.
Text size Float Taille du texte affiché.
Custom Text String Texte personnalisé affiché sur la tile.
Label position Enum Position du label (center, top, bottom, left, right, hidden).
Override stroke color Bool Active une couleur de contour personnalisée.
Stroke color Color Couleur du contour.
Override fill color Bool Active une couleur de remplissage personnalisée.
Fill color Color Couleur de remplissage.

Path Type : Point

[modifier]

Le path Point place toutes les fixtures ou subfixtures exactement au même endroit.

Paramètre Type Description
Position Point2D Position unique utilisée pour tous les éléments.

Path Type : Line

[modifier]

Le path Line distribue les éléments le long d’un segment entre deux points.

Paramètre Type Description
Position Point2D Point de départ de la ligne.
End position Point2D Point de fin de la ligne.

Path Type : Rod

[modifier]

Le path Rod est une ligne centrée sur la position d’origine, définie par une longueur et un angle.

Paramètre Type Description
Rod size Float Longueur totale du rod.
Rod angle Float Angle du rod en degrés.

Path Type : Grid

[modifier]

Le path Grid place les éléments sur une grille 2D configurable.

Paramètre Type Description
Size Point2D Taille totale de la grille.
Grid Angle Float Angle de rotation de la grille.
Number per line Int Nombre d’éléments par ligne.
Orientation Enum Orientation principale de la grille.
Zig zag Bool Inverse la direction à chaque ligne.
Reverse lines Bool Inverse l’ordre des lignes.

Path Type : Circle

[modifier]

Le path Circle répartit les éléments sur un arc ou un cercle.

Paramètre Type Description
Radius Float Rayon du cercle.
From angle Float Angle du premier élément.
To angle Float Angle du dernier élément.

Path Type : Preset

[modifier]

Le path Preset utilise un Path Preset existant comme source de positions.

Paramètre Type Description
Preset ID Int Identifiant du path preset utilisé.
Preset scale Float Facteur d’échelle appliqué au preset.
Preset angle Float Rotation appliquée au preset.

Utilisation des Paths

[modifier]

Les paths sont utilisés :

  • pour positionner les fixtures dans un layout,
  • comme base géométrique pour les filtres de sélection spatiaux,
  • pour calculer des ratios normalisés (0 → 1) selon la position,
  • pour déclencher des sélections par clic dans le layout.

Lorsqu’un path est modifié, toutes les positions associées sont automatiquement recalculées.