Dans cette page, nous vous décrivons chacun des blocs Sélectionner par que vous pouvez utiliser dans le système Visual Dataprep pour identifier les éléments de scène sur lesquels vous souhaitez effectuer des opérations.
Chaque type de bloc Sélectionner par propose un ensemble différent de critères que vous pouvez renseigner. Lorsque le système Visual Dataprep exécute chaque action dans votre graphique Dataprep, il suppose d'abord que toutes les opérations définies dans cette action doivent s'appliquer à l'ensemble des acteurs et des ressources de la scène importée. Cependant, si votre action contient l'un des blocs Sélectionner par décrits sur cette page, le système Visual Dataprep vérifie chacun de ces éléments de scène pour déterminer s'il correspond aux critères que vous avez définis dans le bloc Sélectionner par. Si l'élément de scène ne répond pas à vos critères, le système Visual Dataprep supprime cet élément de la liste des éléments de scène auxquels il applique des opérations pour l'action en cours. Pour obtenir davantage d'informations contextuelles, consultez la page Dataprep Import Customization (Personnalisation de l'importation Dataprep).
Pour en savoir plus sur les opérations que vous pouvez effectuer sur les éléments de scène identifiés par vos critères Sélectionner par, consultez la page Dataprep Operation Reference (Référence des opérations Dataprep).
Sélectionner par condition
Les blocs Sélectionner par condition sélectionnent un élément de scène uniquement si une condition donnée est définie sur True pour cet élément.
Est une classe de
Utilisez le bloc Est une classe de pour sélectionner un élément de scène uniquement si sa classe après l'importation dans l'Unreal Engine correspond au nom de classe que vous spécifiez dans le paramètre Classe.
Ce filtre peut sélectionner des ressources, des acteurs et des composants.
Cliquez sur l'image pour l'afficher à taille réelle.
Paramètre | Description |
---|---|
Classe | Classe à laquelle tous les éléments de scène doivent correspondre pour que ce bloc les sélectionne. |
Doit inclure la classe enfant | Détermine si ce bloc considère qu'un élément de scène doit correspondre si sa classe Unreal Engine est dérivée de la classe que vous avez définie dans le paramètre Classe.
Par exemple, supposons que vous définissiez le paramètre Classe sur Acteur et qu'un élément de scène considéré possède la classe StaticMeshActor. Dans ce cas, dans la mesure où StaticMeshActor hérite de la classe Acteur de base, le bloc Est une classe de sélectionne cet élément de scène uniquement si le paramètre Doit inclure la classe enfant est activé. |
Gainage/Sélectionner les éléments masqués
Pour utiliser ce filtre, vous devez activer le plug-in Opérations de géométrie Dataprep.
Utilisez le filtre Gainage/Sélectionner les éléments masqués pour sélectionner les éléments qui se trouvent à l'intérieur d'un ou de plusieurs acteurs que vous avez précédemment sélectionnés.
Cliquez sur l'image pour l'afficher à taille réelle.
Paramètre | Description |
---|---|
Précision | Définit la précision de la grille de voxels que Datasmith utilise pour déterminer les éléments qui se trouvent à l'intérieur ou à l'extérieur des limites d'un acteur. |
Distance de fusion | Définit la taille maximale des espaces dans les volumes occlusifs que les tests d'occlusion considèrent comme comblés. |
Sélectionner par Float
Les blocs Sélectionner par Float sélectionnent les éléments de scène uniquement si une propriété numérique de ces éléments de scène est Inférieure à, Supérieure à ou Est presque égale à une valeur de seuil donnée.
Les blocs Sélectionner par Float considèrent deux nombres comme étant presque égaux si la différence entre eux est inférieure à 0.0001
.
Volume englobant
Utilisez le bloc Volume englobant pour sélectionner un élément de scène uniquement s'il possède des longueurs dans l'espace 3D (et donc une boîte englobante), et seulement si le volume total de cette boîte englobante satisfait la comparaison que vous spécifiez dans les paramètres.
Ce filtre peut sélectionner des ressources, des acteurs et des composants.
Cliquez sur l'image pour l'afficher à taille réelle.
Paramètre | Description |
---|---|
Menu déroulant | Type de comparaison mathématique que vous souhaitez effectuer entre le volume englobant de l'objet et le volume que vous spécifiez : Inférieur à, Supérieur à ou Est presque égal. |
Valeur Float | Volume auquel vous souhaitez comparer le volume englobant de votre objet, en centimètres cubes. |
Par exemple, supposons qu'un maillage statique dispose d'un volume englobant de 100 centimètres sur 100 centimètres. Le volume de sa boîte englobante est de 100x100, soit 10 000 centimètres cubes. Par conséquent, ce bloc sélectionnerait ce maillage statique si vous le définissiez sur inférieur à tout nombre supérieur à 10 000, ou supérieur à tout nombre inférieur à 10 000.
Sélectionner par entier
Les blocs Sélectionner par entier sélectionnent les éléments de scène uniquement si une propriété numérique de ces éléments de scène est inférieure à, supérieure à ou presque égale à une valeur de seuil donnée.
Nombre de triangles
Utilisez le bloc Nombre de triangles pour sélectionner uniquement les acteurs de maillage statique et les ressources de maillage statique dont le nombre de triangles satisfait la comparaison que vous spécifiez dans les paramètres.
Ce filtre peut sélectionner des ressources, des acteurs et des composants.
Cliquez sur l'image pour l'afficher à taille réelle.
Paramètre | Description |
---|---|
Menu déroulant | Type de comparaison mathématique que vous souhaitez effectuer entre le nombre de triangles dans le maillage et le nombre que vous spécifiez : Inférieur à, Supérieur à ou Est presque égal. |
Valeur entière | Nombre avec lequel vous souhaitez comparer le nombre de triangles de votre objet. |
Par exemple, si un acteur ou une ressource de maillage statique comporte 2 000 triangles, ce bloc sélectionnerait cet objet si vous le définissiez sur inférieur à tout nombre supérieur à 2 000 ou supérieur à tout nombre inférieur à 2 000.
Nombre de vertex
Utilisez le bloc Nombre de vertex pour sélectionner uniquement les acteurs de maillage statique et les ressources de maillage statique dont le nombre de vertex satisfait la comparaison que vous spécifiez dans les paramètres.
Ce filtre peut sélectionner des ressources, des acteurs et des composants.
Cliquez sur l'image pour l'afficher à taille réelle.
Paramètre | Description |
---|---|
Menu déroulant | Type de comparaison mathématique que vous souhaitez effectuer entre le nombre de vertex du maillage et le nombre que vous spécifiez : Inférieur à, Supérieur à ou Est presque égal. |
Valeur entière | Nombre avec lequel vous souhaitez comparer le nombre de vertex de votre objet. |
Par exemple, si un acteur ou une ressource de maillage statique comporte 5 000 vertex, ce bloc sélectionnerait cet objet si vous le définissiez sur inférieur à tout nombre supérieur à 5 000 ou supérieur à tout nombre inférieur à 5 000.
Sélectionner par chaîne
Les blocs Sélectionner par chaîne sélectionnent des éléments de scène uniquement si une propriété de chaîne donnée de ces éléments de scène correspond à un modèle de chaîne que vous spécifiez.
Toutes les conditions de chaîne peuvent utiliser soit une chaîne unique, soit une matrice de chaînes. Pour basculer entre ces deux options, cliquez sur le bouton Basculer sur une chaîne/Basculer sur une matrice de chaînes. Pour les matrices de chaînes, le filtre renvoie tous les objets (acteurs, ressources et/ou composants, selon les limitations du filtre) qui correspondent à au moins l'un des éléments de la matrice.
Cliquez sur l'image pour l'afficher à taille réelle.
Ces blocs offrent trois comparaisons de chaînes :
Paramètre | Description |
---|---|
Contient | La comparaison réussit si la chaîne que vous fournissez est contenue dans son intégralité n'importe où dans la valeur de la propriété de chaîne de l'élément de scène considéré. Vous ne pouvez pas utiliser de caractères génériques dans ce type de comparaison, les caractères * et ? sont traités de façon littérale. |
Correspond au caractère générique | La comparaison réussit si la longueur totale de la chaîne que vous fournissez correspond à la longueur totale de la propriété de chaîne de l'élément de scène considéré, en utilisant les caractères génériques suivants :
Le modèle doit correspondre à toute la longueur de la chaîne. Si vous souhaitez spécifier une chaîne partielle susceptible d'apparaître n'importe où dans la valeur de la propriété de chaîne que vous comparez, commencez et terminez votre modèle de chaîne par un astérisque ( |
Correspondance exacte | La comparaison réussit uniquement si la chaîne que vous fournissez correspond exactement à la valeur de la propriété de chaîne de l'élément de scène considéré. Elle doit avoir la même longueur et doit contenir le même ensemble de caractères, tous dans le même ordre. |
Étiquette d'acteur
Utilisez le bloc Étiquette d'acteur pour sélectionner les acteurs dans la scène d'aperçu de Dataprep (c'est-à-dire tous les éléments affichés dans le panneau Aperçu de l'organiseur) uniquement si la chaîne que vous spécifiez correspond aux noms attribués à ces acteurs dans l'aperçu de l'organiseur.
Ce filtre ne peut sélectionner que des acteurs et des ressources.
Cliquez sur l'image pour l'afficher à taille réelle.
Paramètre | Description |
---|---|
Menu déroulant | Type de comparaison de chaîne que vous souhaitez effectuer entre l'étiquette d'acteur et la chaîne que vous fournissez. Consultez la section Sélectionner par chaîne ci-dessus pour en savoir plus. |
Zone Étiquette d'acteur (Chaîne) | Modèle de chaîne que vous souhaitez tester par rapport à l'étiquette d'acteur. |
Valeur de métadonnées
Utilisez le bloc Valeur de métadonnées pour sélectionner des acteurs dans la scène d'aperçu de Dataprep (c'est-à-dire tous les éléments affichés dans le panneau Aperçu de l'organiseur) uniquement si l'acteur dispose de métadonnées Datasmith avec la clé que vous spécifiez dans les paramètres et que la valeur de cette clé de métadonnées Datasmith correspond à la valeur de chaîne que vous fournissez dans les paramètres.
Ce filtre peut sélectionner des ressources, des acteurs et des composants.
Cliquez sur l'image pour l'afficher à taille réelle.
Paramètre | Description |
---|---|
Menu déroulant | Type de comparaison de chaîne que vous souhaitez effectuer entre la valeur de métadonnées Datasmith de l'acteur et la chaîne que vous spécifiez. Consultez la section Sélectionner par chaîne ci-dessus pour en savoir plus. |
Zone Métadonnées (chaîne) | Modèle de chaîne que vous souhaitez tester par rapport à la valeur des métadonnées Datasmith de l'acteur. |
Zone clé | Nom de la clé que vous souhaitez rechercher dans les métadonnées Datasmith de l'acteur. |
Par exemple, supposons que vous disposiez d'un acteur auquel est attribué l'ensemble suivant de métadonnées Datasmith après l'importation :
Cliquez sur l'image pour l'afficher à taille réelle.
Si vous définissez la valeur Clé sur Catégorie, vous pouvez sélectionner cet acteur en choisissant l'opération Contient et en définissant le modèle de chaîne dans la troisième colonne sur Floor
ou Floors
.
Pour en savoir plus sur les métadonnées Datasmith, consultez la page Using Datasmith Metadata (Utiliser les métadonnées Datasmith).
Nom de l'objet
Utilisez le bloc Nom de l'objet pour sélectionner des ressources (c'est-à-dire des maillages statiques, des textures, des matériaux et des animations répertoriés dans le panneau Aperçu du navigateur de contenu) uniquement si la chaîne que vous spécifiez correspond aux noms attribués à ces ressources dans l'aperçu du navigateur de contenu.
Ce filtre peut sélectionner des ressources, des acteurs et des composants.
Cliquez sur l'image pour l'afficher à taille réelle.
Paramètre | Description |
---|---|
Menu déroulant | Type de comparaison de chaîne que vous souhaitez effectuer entre le nom de l'élément de scène et la chaîne que vous spécifiez. Consultez la section Sélectionner par chaîne ci-dessus pour en savoir plus. |
Zone Nom de l'objet (Chaîne) | Modèle de chaîne que vous souhaitez tester par rapport au nom de l'objet. |
Couche d'acteur
Utilisez le bloc Couche d'acteur pour sélectionner des acteurs dans la scène d'aperçu de Dataprep (c'est-à-dire tous les éléments affichés dans le panneau Aperçu de l'organiseur) uniquement si cet acteur se trouve dans la couche que vous spécifiez.
Ce filtre ne peut sélectionner que des acteurs.
Cliquez sur l'image pour l'afficher à taille réelle.
Paramètre | Description |
---|---|
Menu déroulant | Type de comparaison de chaînes que vous souhaitez effectuer entre la couche d'acteur et la chaîne que vous spécifiez. Consultez la section Sélectionner par chaîne ci-dessus pour en savoir plus. |
Zone Étiquette d'acteur (Chaîne) | Modèle de chaîne que vous souhaitez tester par rapport à la couche d'acteur. |
Valeur de balise
Utilisez le bloc Valeur de balise pour sélectionner un élément de scène uniquement s'il possède la balise Acteur que vous spécifiez dans le paramètre Balise.
Ce filtre peut sélectionner des ressources, des acteurs et des composants.
Cliquez sur l'image pour l'afficher à taille réelle.
Paramètre | Description |
---|---|
Menu déroulant | Type de comparaison de chaîne que vous souhaitez effectuer entre l'étiquette de l'acteur et la chaîne que vous spécifiez. Consultez la section Sélectionner par chaîne ci-dessus pour en savoir plus. |
Zone Balise (Chaîne) | Nom de la balise que vous souhaitez rechercher. |
Par exemple, si votre acteur est importé avec l'ensemble de balises suivant :
Cliquez sur l'image pour l'afficher à taille réelle.
Vous pouvez sélectionner cet acteur dans votre bloc Balise Acteur en définissant la valeur du paramètre Clé sur Max.superclassof : GeometryClass
, Max.classof: EditablePolyMesh
, Max.handle: 407
, ou toute autre valeur indiquée dans la liste ci-dessus.
Pour en savoir plus sur les balises Acteur importées par Datasmith, consultez la page About the Datasmith Import Process (À propos du processus d'importation de Datasmith).