Guía de Scene Explorer en 3ds Max: crear columnas personalizadas con MAXScript

La documentación de MAXScript de Autodesk explica cómo gestionar Scene Explorer mediante scripts con la interfaz SceneExplorerManager y cómo crear columnas personalizadas. Esta guía aborda, basándose en la documentación oficial, los pasos para crear Explorers en escenas de 3ds Max, elegir las columnas visibles, mostrar propiedades de objetos como columnas y reutilizar configuraciones. La interfaz SceneExplorerManager está disponible en 3ds Max 2008 y versiones posteriores, aunque algunos métodos requieren versiones más recientes.

Los ejemplos de código siguientes se basan en los métodos de MAXScript que muestra la documentación de Autodesk. Antes de ejecutar cualquier script en una escena de producción, comprueba que la versión de 3ds Max de destino admita el método correspondiente y que los nombres de las columnas coincidan con las propiedades de la escena.

1. Comprueba la compatibilidad de versiones y define lo que necesitas

Primero, determina qué quieres automatizar: aplicar una disposición existente de columnas, hacer visibles propiedades de los objetos o guardar y volver a cargar una configuración de Explorer. Los métodos no comparten los mismos requisitos de versión. Por ejemplo, CreateExplorer y SetExplorerVisibleColumns están documentados para 3ds Max 2010 y versiones posteriores. GetExplorer está disponible en 3ds Max 2015 y versiones posteriores.

Que la interfaz SceneExplorerManager esté disponible no significa que todos sus métodos funcionen en versiones anteriores. Si la documentación no especifica claramente la versión de un método, no se debe presuponer aquí un límite adicional. Por eso es importante probar los scripts del equipo en las versiones de destino antes de usarlos en distintas instalaciones de 3ds Max.

2. Crea un Explorer y configura las columnas visibles

1. Para crear un Explorer con la configuración predeterminada, utiliza el método CreateADefaultExplorer. Si la operación se completa correctamente, el método devuelve True; si falla, devuelve False.

2. A continuación, especifica las columnas que se mostrarán como una matriz de nombres mediante SetExplorerVisibleColumns. En el ejemplo de Autodesk, el Explorer llamado “Object Colors” muestra las columnas de nombre, tipo y color.

3. Para crear un Explorer nuevo con columnas específicas, utiliza CreateExplorer. Este método recibe el nombre del Explorer y una matriz con los nombres de las columnas; no debe suponerse que crea el Explorer con la configuración predeterminada.

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

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

Los valores siguientes aparecen en los ejemplos de la documentación de Autodesk. No son una disposición obligatoria para todas las escenas, sino muestras de uso de los métodos.

Si un nombre de la matriz de columnas no coincide con un filtro de columna existente, puede que se omita la columna sin que se produzca un error. Por este motivo, es necesario comprobar que las columnas previstas aparezcan realmente. La documentación muestra que también se puede utilizar un nombre como “Bananas” si está definido como filtro; si no existe ese filtro personalizado, no se añade la columna.

3. Convierte propiedades personalizadas en columnas de Scene Explorer

Para mostrar una propiedad presente en los objetos de la escena, se puede definir un filtro de columna mediante addProperty. Este método recibe el nombre de la propiedad, una función que lee su valor y otra que lo establece. En el ejemplo de Autodesk, si el objeto tiene la propiedad Radius, se puede leer y actualizar su valor.

Cuando es posible que la propiedad no exista en todos los objetos, es importante comprobarlo con isProperty. El ejemplo siguiente solo accede al valor de Radius si el objeto tiene esa propiedad:

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 solo quieres mostrar información y no modificar el valor desde Explorer, puedes utilizar addReadOnlyProperty. El ejemplo de la documentación crea un filtro de solo lectura llamado “Class” y devuelve la clase del objeto con classof:

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

Una vez definido el nuevo filtro, la columna aparece al final de la lista de Column Chooser. Para añadirla a Scene Explorer, arrástrala desde la lista hasta el Explorer. Definir la columna personalizada no basta para que aparezca en la disposición de columnas visibles; por eso, completa por separado los pasos de creación del filtro y de visualización en Explorer.

4. Guarda y administra la configuración de Explorer

Puedes guardar la configuración de un Explorer en el archivo especificado con SaveExplorerConfiguration y cargar una configuración guardada anteriormente con LoadExplorerConfiguration. En el siguiente ejemplo, la ruta del archivo debe adaptarse a la organización de trabajo del equipo correspondiente:

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

Los métodos OpenExplorer y CloseExplorer permiten abrir o cerrar un Explorer. ExplorerExists comprueba si existe un Explorer con el nombre indicado, y ExplorerIsOpen consulta si está abierto. GetExplorer devuelve la interfaz del Explorer indicado si existe; si no, el resultado es undefined.

Para que los filtros de propiedades personalizadas sigan disponibles en sesiones posteriores de 3ds Max, puedes guardar sus definiciones en un archivo de script y colocarlo en la carpeta Scripts\Startup. Para listar varios Explorers, GetExplorerCount devuelve el número total y GetExplorerName devuelve sus nombres para los índices del 1 a ese total. ClearAllExplorers cierra todos los Explorers y limpia la lista del menú Tools>Saved Scene Explorers>. Por tanto, no debe utilizarse para operar sobre un único Explorer.

Uso en flujos de trabajo de arquitectura y archviz

En escenas de arquitectura y visualización, examinar la información de los objetos en una misma ventana puede ayudar a los equipos a configurar una vista de Explorer que se adapte a su forma de trabajar. Las columnas de nombre, tipo, color o cantidad de caras que aparecen en la documentación son un punto de partida. Si una propiedad personalizada presente en los objetos de la escena es importante, también es posible definirla como una columna independiente. La utilidad de este enfoque depende de que los datos y filtros utilizados se ajusten a las necesidades de la escena.

Antes de compartir scripts en una oficina, comprueba la versión de 3ds Max y las propiedades de los objetos de las que dependen los filtros personalizados. En escenas con varios tipos de objetos, añadir una comprobación de propiedades ayuda a evitar intentos de lectura de valores inexistentes. La documentación de Autodesk no proporciona información sobre hardware, licencias ni costos del producto; no se deben presuponer requisitos adicionales en esos aspectos.

Errores frecuentes

• Añadir a la lista de columnas visibles el nombre de un filtro inexistente: la columna correspondiente puede omitirse sin que se produzca un error.

• Suponer que una columna aparecerá automáticamente después de definirla: hay que arrastrarla desde Column Chooser hasta Scene Explorer.

• Suponer que todos los objetos tienen la misma propiedad: se puede comprobar con isProperty antes de acceder a ella.

• Esperar que la llamada a GetExplorer siempre devuelva un Explorer: si no encuentra el nombre, el resultado es undefined.

• Utilizar ClearAllExplorers para cerrar un solo Explorer: el método cierra todos los Explorers y limpia la lista del menú de elementos guardados.