Utiliser Raycast et Sample Index dans Blender Geometry Nodes

Ce que vous apprendrez dans ce tutoriel

Les nœuds Raycast et Sample Index de Blender Geometry Nodes permettent de lire des données entre différentes géométries, mais ils ne remplissent pas la même fonction. Raycast détermine où les rayons émis depuis une géométrie intersectent une géométrie cible. Sample Index récupère les valeurs correspondant à des indices précis dans la géométrie source. Dans ce tutoriel, nous allons examiner pas à pas le rôle de ces deux nœuds, les entrées importantes et la manière d’exploiter leurs sorties.

Raycast est utile lorsque vous avez besoin d’informations sur une intersection, comme la position sur une surface, la normale ou la distance. Sample Index sert à faire correspondre des indices pour utiliser les valeurs d’une géométrie dans un autre contexte d’évaluation. Le nœud à choisir dépend donc de la nature des données recherchées : une intersection avec une surface ou une correspondance par index.

Prérequis

Pour suivre ce tutoriel, vous avez besoin d’une installation de Blender permettant d’utiliser Geometry Nodes, ainsi que d’une géométrie sur laquelle créer et évaluer des configurations de nœuds. Les sources ne précisent ni numéro de version de Blender, ni type de compte, ni exigence de paiement. Il n’est donc pas possible d’indiquer une version précise ; vérifiez que les nœuds Raycast et Sample Index sont disponibles dans votre installation.

Pour fonctionner, Raycast distingue la géométrie source, dans le contexte d’évaluation du nœud, de la géométrie cible sur laquelle les rayons sont testés. Pour Sample Index, il faut une entrée Geometry contenant les valeurs à récupérer, un champ Value à échantillonner et une entrée Index. Si les indices risquent de ne pas correspondre à la taille du champ source, tenez également compte à l’avance du fonctionnement de l’option Clamp.

Étape par étape : évaluer les intersections de surface avec Raycast

1. Définissez les géométries source et cible. La géométrie dans le contexte du nœud auquel Raycast est connecté sert de source aux rayons. Connectez à l’entrée Target Geometry du nœud Raycast la géométrie sur laquelle les rayons seront testés. Bien distinguer ces deux rôles aide à comprendre quelle géométrie émet les rayons.

2. Définissez la position de départ des rayons. Source Position détermine le point de départ de chaque rayon. Par défaut, cette entrée fonctionne comme si le nœud Position y était connecté. Si vous souhaitez définir la position de départ à l’aide d’un autre champ, utilisez-le sur cette entrée.

3. Réglez la direction et la distance maximale. Ray Direction définit la direction dans laquelle chaque rayon se déplace depuis son point de départ. Ce champ est évalué sur la géométrie du contexte d’évaluation du champ du nœud, et non sur la géométrie cible. Ray Length correspond à la distance maximale qu’un rayon peut parcourir pour être considéré comme ayant touché la cible. Si la surface cible se trouve au-delà de cette distance, le rayon est considéré comme n’ayant rien touché. La direction et la longueur doivent donc être adaptées à l’intersection recherchée.

4. Vérifiez les collisions et les sorties principales. Is Hit est une sortie booléenne qui indique si chaque rayon a atteint la géométrie cible. Hit Position renvoie la position de l’intersection, et Hit Normal la normale de la surface au point d’intersection. Hit Distance correspond à la distance entre le point de départ et le point d’intersection. Si un rayon ne touche pas la cible, la sortie Hit Distance renvoie la valeur Ray Length.

5. Récupérez, si nécessaire, un attribut de la surface cible. Vous pouvez connecter un champ facultatif à l’entrée Attribute de Raycast ; ce champ sera évalué sur la géométrie cible. Le nœud échantillonne sa valeur aux points d’intersection et la transmet à la sortie Attribute. L’option Interpolation définit la manière dont les valeurs du maillage cible sont interpolées : Interpolated calcule une interpolation régulière des attributs de sommet et de point de sommet ; Nearest sélectionne la valeur du sommet le plus proche. Le choix dépend de la représentation souhaitée au point d’intersection : une transition progressive ou l’échantillon le plus proche.

6. Utilisez les sorties dans la suite de la configuration. Servez-vous de Is Hit pour distinguer les rayons qui ont touché la cible de ceux qui ne l’ont pas touchée, puis transmettez les sorties Hit Position, Hit Normal, Hit Distance ou Attribute aux opérations suivantes. Le nœud Raycast dispose également de la propriété Data Type, qui définit le type de données évalué. Déterminer à l’avance le rôle des sorties vous aide à éviter de conserver des données inutiles dans la configuration.

Étape par étape : échantillonner des valeurs avec Sample Index

1. Connectez la géométrie source et la valeur à échantillonner. Branchez sur Geometry la géométrie dont vous voulez récupérer les données, et sur Value le champ à évaluer sur cette géométrie source. Sample Index récupère les valeurs du champ Value pour des indices précis et les fournit sur la sortie Value.

2. Définissez les indices. L’entrée Index sélectionne les valeurs à lire dans la géométrie source. Connecter un champ d’indices permet de récupérer les valeurs à différents indices et, ainsi, de les réordonner. Vérifiez ce que représentent les indices en fonction de la géométrie utilisée et du contexte d’évaluation du champ dans votre configuration.

3. Examinez les réglages Data Type et Domain. Data Type définit le type de données à récupérer ; Domain détermine le domaine utilisé pour transmettre et évaluer les données d’attribut. Par exemple, il est possible de récupérer des données sur les faces d’une géométrie source pour les évaluer sur les points d’une autre géométrie. Veillez à ce que ces réglages conviennent à la valeur recherchée et au champ source.

4. Choisissez le comportement de Clamp. Lorsque Clamp est activé, les indices sont limités à la taille du champ d’attribut. Lorsqu’il est désactivé, une valeur par défaut est renvoyée pour les indices non valides. Vérifiez donc si le champ d’indices se trouve dans la plage valide ; dans une configuration où cette limitation ne convient pas, ne considérez pas cette option comme une solution automatique.

5. Tenez compte des composants géométriques. Le domaine Point est commun aux composants Mesh, Point Cloud et Curve. Si l’entrée Geometry contient plusieurs composants, Sample Index échantillonne la valeur du premier composant non vide, dans l’ordre Mesh, Point Cloud, Curve. Si vous devez récupérer des données d’un composant spécifique, séparez les composants avec le nœud Separate Components et échantillonnez directement celui qui vous intéresse.

6. Vérifiez que la correspondance par index convient. Lorsque les géométries source et cible ont le même nombre de points et la même topologie, l’utilisation visant à copier les positions d’une géométrie vers l’autre donne de meilleurs résultats. La documentation indique que cette approche peut reproduire le comportement du nœud Transfer Attribute de Blender avant la version 3.4. Cela ne signifie pas qu’une correspondance exacte sera obtenue avec toutes les topologies différentes ; vérifiez que les indices ont la même signification dans les deux géométries.

Erreurs fréquentes

Avec Raycast, confondre la géométrie source et Target Geometry rend moins clair le sens dans lequel les rayons sont calculés. Attendre une intersection sans tenir compte de la valeur Ray Length peut également conduire à mal interpréter les rayons qui n’atteignent pas la surface cible. Vérifiez la sortie Is Hit ; en l’absence de collision, gardez à l’esprit que Hit Distance renvoie la valeur Ray Length.

Avec Sample Index, le point le plus souvent négligé est la correspondance des indices. Deux géométries qui se ressemblent peuvent ne pas avoir le même nombre de points ni la même topologie. Le renvoi d’une valeur par défaut pour les indices non valides et la limitation des indices par Clamp sont également deux comportements différents. Dans une géométrie comportant plusieurs composants, ne tirez pas de conclusions sans savoir quel composant est échantillonné ; séparez-les au besoin.

Utilisation dans les flux de travail d’architecture et de visualisation

En modélisation architecturale et en visualisation, Raycast peut être utilisé dans des configurations qui nécessitent les points où les rayons intersectent une surface cible, ainsi que les informations de normale ou de distance à ces points. Il est également possible de lire un attribut de la surface cible. Sample Index échantillonne les valeurs d’une géométrie par index ; il peut être particulièrement utile dans les configurations de transfert où la correspondance du nombre de points et de la topologie est importante.

Ces outils ne produisent pas automatiquement le même résultat sur tous les modèles. Avec Raycast, la direction, le point de départ et la distance maximale influent sur le résultat ; avec Sample Index, ce sont l’index, le domaine et le choix du composant qui comptent. Les sources ne fournissent aucune information sur les exigences matérielles, le modèle de licence ou la compatibilité avec d’autres logiciels. Avant de les utiliser dans un projet réel, testez les collisions, les indices non valides et les conditions de correspondance sur une petite géométrie afin de repérer rapidement les résultats inattendus.

Étapes suivantes

Commencez par tester Raycast dans une configuration simple où vous pouvez examiner uniquement les informations de collision et la sortie Hit Position. Vérifiez ensuite séparément le comportement des sorties Hit Normal, Hit Distance et Attribute, puis comparez les options Interpolated et Nearest. Pour Sample Index, commencez par un champ d’indices connu et modifiez successivement les réglages Data Type, Domain et Clamp.

Il n’est pas nécessaire d’ajouter les deux nœuds à une même configuration. Raycast produit des informations fondées sur les intersections de surface, tandis que Sample Index sélectionne des valeurs par index. Les utiliser ensemble avant d’avoir déterminé quelle méthode permet d’obtenir les données recherchées risque de complexifier inutilement le flux de données.

Sources et licence

Ce tutoriel est adapté en turc à partir des pages Raycast Node et Sample Index Node du Blender Manual. Les deux sources sont publiées sous licence CC BY-SA 4.0.