Guide de Scene Explorer dans 3ds Max : créer des colonnes avec MAXScript

La documentation MAXScript d’Autodesk présente l’interface SceneExplorerManager et les méthodes de création de colonnes personnalisées pour gérer Scene Explorer par script. Ce guide détaille, à partir de la documentation officielle, la création d’explorateurs dans les scènes 3ds Max, le choix des colonnes visibles, l’affichage des propriétés des objets sous forme de colonnes et la réutilisation des configurations. L’interface SceneExplorerManager est disponible dans 3ds Max 2008 et les versions ultérieures, mais certaines méthodes nécessitent une version plus récente.

Les exemples de code ci-dessous s’appuient sur les méthodes MAXScript présentées dans la documentation d’Autodesk. Avant d’exécuter un script dans une scène de production, vérifiez que la version de 3ds Max ciblée prend en charge la méthode concernée et que les noms des colonnes correspondent aux propriétés de la scène.

1. Vérifier la prise en charge par la version et définir le besoin

Commencez par déterminer la tâche à automatiser : configurer une disposition de colonnes existante, afficher les propriétés des objets ou enregistrer puis recharger une configuration d’explorateur. Les conditions de version varient selon les méthodes. Par exemple, CreateExplorer et SetExplorerVisibleColumns sont documentées pour 3ds Max 2010 et les versions ultérieures. GetExplorer est disponible dans 3ds Max 2015 et les versions ultérieures.

La présence de l’interface SceneExplorerManager ne signifie pas que toutes ses méthodes fonctionnent également dans les anciennes versions. Lorsqu’aucune version minimale n’est explicitement indiquée dans la documentation, il ne faut pas en supposer une ici. Il est donc important de tester les scripts d’équipe sur les versions cibles avant de les utiliser dans différentes installations de 3ds Max.

2. Créer un explorateur et configurer les colonnes visibles

1. Pour créer un explorateur avec les paramètres par défaut, utilisez la méthode CreateADefaultExplorer. Elle renvoie True si l’opération réussit et False si elle échoue.

2. Indiquez ensuite les colonnes à afficher sous forme de tableau de noms avec SetExplorerVisibleColumns. Dans l’exemple d’Autodesk, les colonnes de nom, de type et de couleur sont affichées dans l’explorateur « Object Colors ».

3. Pour créer un nouvel explorateur avec des colonnes précises, utilisez la méthode CreateExplorer. Elle prend le nom de l’explorateur et un tableau de noms de colonnes ; il ne faut pas supposer qu’elle crée un explorateur avec les paramètres par défaut.

SceneExplorerManager.CreateADefaultExplorer "Object Colors"
SceneExplorerManager.SetExplorerVisibleColumns "Object Colors" #("Name","Type","Color")

SceneExplorerManager.CreateExplorer "Geometry Counts" #("Name","Type","Faces")

Les valeurs ci-dessous figurent dans les exemples de la documentation d’Autodesk. Elles ne constituent pas une disposition obligatoire pour toutes les scènes, mais illustrent l’utilisation des méthodes.

Si un nom du tableau de colonnes ne correspond à aucun filtre de colonne existant, la colonne peut être ignorée sans générer d’erreur. Il faut donc vérifier que les colonnes attendues s’affichent bien. La documentation donne aussi l’exemple d’un nom tel que « Bananas », à condition qu’il soit défini comme filtre ; sans filtre personnalisé correspondant, la colonne n’est pas ajoutée.

3. Transformer des propriétés personnalisées en colonnes de Scene Explorer

Pour afficher une propriété présente sur les objets de la scène, vous pouvez définir un filtre de colonne avec addProperty. Cette méthode reçoit le nom de la propriété, une fonction qui lit sa valeur et une fonction qui la modifie. Dans l’exemple d’Autodesk, la valeur Radius est lue et mise à jour si l’objet possède cette propriété.

Lorsque la propriété n’est pas nécessairement présente sur chaque objet, le contrôle isProperty est important. L’exemple ci-dessous accède à la valeur Radius uniquement si l’objet possède la propriété correspondante :

fn getRad theNode = (
    if isProperty theNode "Radius" then theNode.Radius
)

fn setRad theNode theValue = (
    if isProperty theNode "Radius" then theNode.Radius = theValue
)

SceneExplorerManager.addProperty "Radius" getRad setRad

Si vous souhaitez uniquement afficher une information sans pouvoir modifier sa valeur depuis Explorer, utilisez addReadOnlyProperty. L’exemple de la documentation crée un filtre en lecture seule nommé « Class » en renvoyant la classe de l’objet avec classof :

fn getClass theNode = (classof theNode)
SceneExplorerManager.addReadOnlyProperty "Class" getClass

Une fois le nouveau filtre défini, la colonne apparaît en bas de la liste Column Chooser. Pour l’ajouter à Scene Explorer, faites-la glisser depuis la liste vers l’explorateur. La définition d’une colonne personnalisée ne l’ajoute pas à elle seule à la disposition des colonnes visibles : il faut donc définir le filtre, puis l’afficher dans l’explorateur.

4. Enregistrer et gérer la configuration d’un explorateur

Vous pouvez enregistrer la configuration d’un explorateur dans le fichier indiqué avec SaveExplorerConfiguration, puis charger une configuration précédemment enregistrée avec LoadExplorerConfiguration. Dans l’exemple ci-dessous, le chemin du fichier doit être adapté à l’organisation de travail de l’ordinateur concerné :

SceneExplorerManager.SaveExplorerConfiguration "Geometry Counts" "C:\\SceneExplorerConfig"
SceneExplorerManager.LoadExplorerConfiguration "C:\\SceneExplorerConfig"

Les méthodes OpenExplorer et CloseExplorer permettent d’ouvrir ou de fermer un explorateur. ExplorerExists vérifie si un explorateur portant le nom indiqué existe ; ExplorerIsOpen vérifie s’il est ouvert. GetExplorer renvoie l’interface de l’explorateur portant le nom donné, s’il existe ; sinon, le résultat est undefined.

Pour que les filtres de propriétés personnalisées restent disponibles lors des sessions 3ds Max suivantes, il est possible d’enregistrer leurs définitions dans un fichier de script et de le placer dans le dossier Scripts\Startup. Pour lister plusieurs explorateurs, GetExplorerCount renvoie leur nombre total ; GetExplorerName renvoie leur nom pour les index allant de 1 à ce nombre. ClearAllExplorers ferme tous les explorateurs et vide la liste du menu Tools>Saved Scene Explorers>. Cette méthode ne doit donc pas servir à agir sur un seul explorateur.

Utilisation dans les workflows d’architecture et d’archviz

Dans les scènes d’architecture et de visualisation, consulter les informations des objets dans une même fenêtre peut aider les équipes à configurer une vue Explorer adaptée à leur organisation. Les colonnes présentées dans la documentation, telles que le nom, le type, la couleur ou le nombre de faces, constituent un point de départ. Si une propriété spécifique des objets de la scène est importante, il est également possible de l’afficher dans une colonne distincte. L’intérêt de cette approche dépend de l’adéquation des données et des filtres aux besoins de la scène.

Avant de partager des scripts dans un bureau, vérifiez la version de 3ds Max utilisée ainsi que les propriétés des objets dont dépendent les filtres personnalisés. Dans les scènes contenant plusieurs types d’objets, l’ajout d’un contrôle de propriété aide à éviter les tentatives de lecture d’une valeur inexistante. Cette documentation d’Autodesk ne fournit aucune information sur le matériel, les licences ou le coût du produit ; il ne faut donc pas supposer d’exigences supplémentaires sur ces points.

Erreurs fréquentes

• Ajouter à la liste des colonnes visibles le nom d’un filtre inexistant : la colonne correspondante peut être ignorée sans message d’erreur.

• Supposer que la colonne s’affichera automatiquement après la définition d’une colonne personnalisée : il faut la faire glisser depuis Column Chooser vers Scene Explorer.

• Supposer que chaque objet possède la même propriété : vous pouvez vérifier avec isProperty avant d’y accéder.

• S’attendre à ce que GetExplorer renvoie toujours un explorateur : le résultat est undefined si le nom est introuvable.

• Utiliser ClearAllExplorers pour fermer un seul explorateur : cette méthode ferme tous les explorateurs et vide la liste du menu enregistré.