Locator 3D Node

Le Locator 3D prend un point 3D (position absolue XYZ ou position d'un objet cible) et le transforme en coordonnées 2D screen space à travers une caméra donnée. Il publie cette position 2D comme sortie numérique, utilisable par Connect To sur n'importe quel contrôle 2D (centre d'ellipse, position d'un Transform, input d'un Tracker).

Cas typique : faire suivre un texte ou un HUD 2D sur un élément 3D qui bouge dans la scène, sans tracker manuel.

• Effects Library : Tools > 3D > Locator 3D
• Ajout rapide : clic droit dans le Node Editor → Add Tool > 3D > Locator 3D

• SceneInput (orange) - requis. La sortie d'une scène 3D contenant la caméra à utiliser pour la projection.
• Target (vert) - optionnel. Un autre objet 3D. Si connecté, le Locator se positionne automatiquement au centre de cet objet, et les sliders XYZ fonctionnent alors en coordonnées locales par rapport à cet objet.

Placez le Locator 3D après le Merge 3D qui contient la caméra - sinon la caméra n'est pas dans la scène qui arrive au Locator, et la projection ne peut pas avoir lieu.

1. Merge 3D avec caméra + objets
2. → Locator 3D (input orange)
3. → (optionnel) Renderer 3D si vous voulez aussi le rendu visuel

Le Locator est un node de « passage » - il ne casse pas le flux 3D, il peut être placé n'importe où entre Merge et Renderer.

Paramètres de position

Position X / Y / Z (en unités Fusion, défaut : 0 / 0 / 0)

Coordonnées du point à projeter. En absence de Target, en world space ; avec Target, en coordonnées locales à l'objet.

Sub-Pixel Position (défaut : activé)

Active la précision sub-pixel pour les valeurs de sortie (évite le « staircase » quand on pilote un tracker).

Use Alpha

Prise en compte de l'alpha dans les calculs de visibilité.

Paramètres caméra

Camera

Menu déroulant qui liste toutes les caméras présentes dans la scène arrivant au Locator. C'est la caméra dont le point de vue servira à projeter le point 3D en 2D.

Use Frame Format Settings (défaut : activé)

Force les Width/Height/Aspect à matcher les préférences de la composition. Recommandé pour éviter les décalages entre la résolution projet et la résolution Locator.

Width / Height / Pixel Aspect

Dimensions de sortie utilisées pour la projection. Doivent matcher celles du Renderer 3D final, sinon le point 2D sortira à de mauvaises coordonnées.

Paramètres cosmétiques (viewer 3D)

Size

Taille du crosshair affiché dans le viewer 3D.

Color

Couleur du crosshair.

Make Renderable

Rend le crosshair visible dans un OpenGL viewer.

Unseen by Camera

Si coché (et Make Renderable actif), le crosshair est affiché dans le viewer 3D mais pas dans le rendu final via Renderer 3D.

Matte

Rend le Locator invisible ainsi que tout ce qui est occulté par lui.

Sub ID

Sélectionne un élément individuel dans une géométrie (caractère d'un texte 3D, une copie d'un Duplicate, …).

Connecter un objet 3D sur l'input vert Target change le comportement du Locator en profondeur :

• Le centre de transformation devient la position de l'objet cible.
• Les sliders XYZ deviennent des offsets locaux par rapport à cet objet.
• Quand l'objet bouge (animation, parenting), le Locator bouge avec lui sans aucune animation propre.

C'est la méthode pour « coller » durablement un overlay 2D à un objet 3D, même si cet objet change de position à cause d'un node en amont.

Le Locator publie une sortie Position en 2D (X, Y normalisés ou en pixels selon les réglages). Pour l'utiliser :

1. Sur le node 2D consommateur (un Ellipse Mask, un Transform, …), clic droit sur le contrôle Center.
2. Menu Connect To > Locator 3D > Position.
3. Le contrôle est maintenant piloté par le Locator. Plus de keyframe à poser.

• HUD qui suit un objet 3D - Target sur le node de l'objet, position locale à [0, 2, 0] (au-dessus), puis Connect To la position d'un Text+ 2D. Le texte suit l'objet même s'il tourne ou se déplace.
• Étiquettes sur plusieurs objets - un Locator par objet, chacun publie sa position 2D, chaque Text+ s'y accroche.
• Mask tracking via 3D - au lieu de tracker manuellement un masque en 2D, attachez son centre à un Locator qui suit un point 3D. Fiable même si le sujet sort du cadre temporairement (tant que la caméra et l'objet sont connus).
• Lens flare sur une lumière 3D - placer un Locator à la position d'une Point Light, brancher sa sortie sur le centre d'un effet flare 2D.
• Driver de particules 2D - la position 2D d'un Locator pilote le spawn des particules d'un pEmitter.

• Width/Height cohérents - le piège n°1 : si votre Renderer 3D rend en 1920×1080 mais le Locator est à 1280×720, la position 2D sera décalée. Activez Use Frame Format Settings pour garantir la cohérence.
• Point hors-champ - si le point 3D est derrière la caméra ou hors du frustum, la position 2D peut sortir en dehors de [0, résolution]. Ajoutez une logique de clamp sur les nodes consommateurs si c'est un problème.
• Occlusion - le Locator projette toujours le point, même s'il est caché derrière un autre objet. Pour gérer la visibilité « caché/visible », regardez plutôt du côté du renderer (render/z-depth pass).
• Caméra animée - le Locator recalcule à chaque frame. Animation fluide, pas besoin de bake.
• Si vous avez plusieurs caméras dans la même scène, vérifiez bien que le menu Camera pointe sur la bonne - l'erreur silencieuse est facile.
• Pour un debug visuel, activez Make Renderable + crosshair coloré, puis retirez Unseen by Camera pour voir le point dans le rendu final.