Últimas noticias
GPT-6.2 Astra y Sol: nuevas capacidades para el diseño 3DAutomatización de modelos con SketchUp Ruby API: selección, geometría y componentesCrear y editar mallas en la escena con Modeling Mode de Unreal Engine¿Cómo hacer texture baking en Blender? De UV a bake, paso a pasoFalling Leaves: herramienta gratuita para esparcir y animar hojas en BlenderSe publican nuevas fotos de la construcción de Shenzhen Opera HouseMadrid EDITION: John Pawson reinterpreta un portal histórico con una escalera blancaGuía de rendimiento de Blender Cycles: gestione el tiempo de render y la memoriaCómo ajustar el resplandor de luz con Glare Node en BlenderMódulos Hotlink en Archicad 29: guía para espacios repetidos
Consejos y guíasSketchUpOMAMAS

Automatización de modelos con SketchUp Ruby API: selección, geometría y componentes

SketchUp Ruby API permite acceder programáticamente a la geometría, la selección y los componentes del modelo abierto. Esta guía aborda cómo inspeccionar y editar el contenido del modelo con métodos básicos de la documentación oficial.

Modelo arquitectónico con componentes modulares y geometría lineal sobre una mesaImagen IA
Imagen ilustrativa generada con IA.Imagen: 3dsınıfı / FCA AI

En resumen

  1. Sketchup.active_model devuelve el objeto Model que se usa en las operaciones de la API sobre el modelo abierto.
  2. Model.entities devuelve el contexto de dibujo raíz, mientras que Model.active_entities devuelve el contenido del grupo o componente abierto.
  3. Al recorrer una selección, usar Selection#each es más eficiente que acceder a los elementos uno por uno mediante índices.
  4. Las instancias de componentes pueden compartir una definición; se puede usar make_unique para hacer que una sola instancia sea independiente.

SketchUp Ruby API ofrece un punto de partida para inspeccionar y modificar los elementos de dibujo del modelo abierto en SketchUp. En la documentación oficial de la API, las clases Model, Entities, Selection y ComponentInstance explican los métodos básicos para trabajar con modelos, geometría, selecciones y componentes. Esta guía se centra en crear pequeños pasos de automatización controlables con los métodos que se muestran en la documentación. Aunque la versión básica de estas clases se indica como SketchUp 6.0, algunos métodos se añadieron en versiones posteriores; por ello, conviene revisar también las notas de versión del método que se vaya a utilizar.

1. Empieza por el modelo activo

Para trabajar con la API, primero obtén el objeto del modelo abierto. Sketchup.active_model devuelve el modelo en el que está trabajando el usuario en ese momento. A través del objeto Model se puede acceder a los elementos de dibujo, los materiales, las definiciones de componentes y la selección. Este enfoque permite obtener una referencia a las colecciones necesarias al principio, en lugar de buscar el modelo una y otra vez para operaciones distintas.

ruby
model = Sketchup.active_model
entities = model.entities
materials = model.materials
definitions = model.definitions
selection = model.selection

Es importante distinguir entre model.entities y model.active_entities. El primero contiene los elementos del nivel raíz del modelo. Si el usuario ha abierto un grupo o componente para editarlo, active_entities devuelve los elementos del contexto en el que está trabajando; si no hay ningún contexto de edición abierto, devuelve el mismo resultado que entities. Por tanto, si el objetivo es trabajar con el contenido que el usuario está editando en ese momento, y no con el nivel superior del modelo, hay que elegir la colección adecuada.

2. Inspecciona la selección de forma eficiente y segura

model.selection representa los elementos de dibujo seleccionados en ese momento. Para acceder a cada elemento de la selección, recorrerla con each es más eficiente que llamar a los índices uno por uno. Tampoco debe suponerse que el orden de la selección reflejará el orden en el que el usuario seleccionó los elementos: la documentación indica expresamente que el orden de los elementos no está definido.

ruby
selection = Sketchup.active_model.selection

puts "Selementos seleccionados: #{selection.length}"
selection.each do |element|
  puts element.typename
end

Si la operación solo afecta a un elemento, se puede usar first; si la selección está vacía, este método devuelve nil. empty? permite comprobar si hay elementos seleccionados, mientras que single_object? sirve para determinar si la selección puede considerarse un único objeto. Se puede usar include? para comprobar si un elemento está seleccionado.

Eliminar elementos de la misma colección mientras se recorre la selección puede cambiar su tamaño y sus índices, lo que puede hacer que se omitan algunos elementos. El enfoque seguro recomendado en la documentación consiste en copiar primero los elementos que se van a eliminar en un array y, después, operar sobre esa copia. Además, el acceso por índice, como selection[0], no es una opción eficiente para inspeccionar todos los elementos. Para quitar elementos de la selección o vaciarla, se pueden usar los métodos remove y clear.

3. Crea geometría en el contexto de dibujo adecuado

Los elementos nuevos, como líneas o caras, se añaden a la colección Entities que se haya elegido. Por ejemplo, add_line crea una arista entre dos puntos; add_face añade una cara y add_group crea un grupo nuevo. Para trabajar en el nivel raíz, se debe usar model.entities; para hacerlo dentro del contexto de un grupo o componente abierto, conviene usar model.active_entities. Así, la geometría generada se añade a la parte prevista del modelo.

Si una operación consta de varios cambios en el modelo, el mecanismo de operaciones de SketchUp ayuda a registrar esos cambios como una operación reversible. start_operation inicia una operación, commit_operation la completa y, en caso de error, abort_operation puede cancelar la operación iniciada. Usa estos métodos para gestionar de forma coherente varios cambios pequeños dentro de un mismo flujo de automatización.

ruby
model = Sketchup.active_model
model.start_operation("Añadir línea")

begin
  model.active_entities.add_line([0, 0, 0], [500, 500, 0])
  model.commit_operation
rescue
  model.abort_operation
  raise
end

La documentación indica que abort_operation normalmente se invoca en un bloque de captura de errores. También advierte que no se debe usar este método en operaciones transparentes: cancelarlas puede cancelar asimismo la operación anterior a la que están vinculadas. Por ello, si la automatización trabaja con operaciones transparentes, hay que gestionar los errores por separado.

Si se van a generar muchos elementos geométricos, también se puede considerar Entities#build. La documentación de la API describe este método como una forma de crear un EntitiesBuilder pensado para construir geometría en bloque teniendo en cuenta el rendimiento. Sin embargo, no se debe deducir de lo que no especifica la documentación que se obtendrá una mejora de velocidad concreta o que el método será adecuado para todos los casos.

4. Separa las instancias de componentes de sus definiciones

Un ComponentInstance hace referencia a la definición del componente y a la transformación que determina su posición en el modelo. Esta estructura permite utilizar una misma definición en varias instancias dentro del modelo. Por ejemplo, se puede obtener la definición de una instancia con definition, examinar la transformación de su posición con transformation o asignarle otra definición mediante definition=.

Cuando se necesita editar una sola instancia sin afectar a las demás, se puede usar make_unique: este método crea una definición de componente que ninguna otra instancia utiliza para esa instancia concreta. Hay que decidir de antemano si la edición debe aplicarse a todas las instancias que comparten la definición o solo a la instancia elegida. De lo contrario, el alcance previsto del cambio podría no coincidir con el resultado en el modelo. La documentación también incluye el método explode, que convierte el componente en elementos de dibujo independientes; no debe usarse en flujos de trabajo que requieran conservarlo como una instancia de componente.

Uso en flujos de trabajo de arquitectura y visualización

Estos métodos ofrecen una base para arquitectos, diseñadores de interiores y desarrolladores de extensiones de SketchUp que quieran automatizar comprobaciones o modificaciones geométricas repetitivas del modelo. Por ejemplo, es posible inspeccionar los elementos del contexto de edición activo, evaluar en conjunto los objetos seleccionados o crear geometría repetitiva como una operación. La utilidad de este enfoque depende de definir con claridad en qué parte del modelo trabaja la automatización y a qué instancias afecta el cambio en un componente.

La documentación no especifica requisitos especiales de hardware ni condiciones de licencia para estos métodos de la API; por tanto, no se debe dar por sentada ninguna exigencia en esos aspectos. Antes de implementarlos, conviene consultar las notas sobre los métodos para la versión de SketchUp que se esté utilizando, especialmente en el caso de las funciones que llevan una etiqueta de versión más reciente. Si se va a generar geometría en bloque en modelos grandes, al evaluar Entities#build también se debe planificar cómo se gestionarán las operaciones reversibles en el flujo de trabajo actual.

Errores frecuentes

  • Usar siempre model.entities: si se está editando un grupo o componente abierto, active_entities puede ser el contexto adecuado.

  • Suponer que el orden de la selección coincide con el orden en que el usuario hizo clic: la documentación de la API señala que no está garantizado.

  • Eliminar elementos de la misma colección durante un each: hacer primero una copia con to_a evita el riesgo de omitir elementos.

  • Pasar por alto que la definición se comparte al editar una instancia de componente: si solo se debe separar una instancia, conviene considerar make_unique.

  • Cancelar una operación transparente con abort_operation: la documentación advierte que también podría cancelarse la operación anterior a la que está vinculada.

Fuentes

3 fuentes
R
ruby.sketchup.comruby.sketchup.com/Sketchup/Model.html
Resumen
R
ruby.sketchup.comruby.sketchup.com/Sketchup/Entities.html
Resumen
R
ruby.sketchup.comruby.sketchup.com/Sketchup/ComponentInstance.html
Resumen

No republicamos los textos de las fuentes; las citas breves van marcadas y el resto es resumen y comentario propios.

La opinión de 3dsınıfı
3dValoración del editor

Para los pequeños estudios de arquitectura y visualización de Turquía, el valor práctico de esta API reside en poder convertir las comprobaciones y modificaciones repetitivas de modelos en un flujo de automatización. Gestionar correctamente la selección, el contexto de edición activo y las definiciones de componentes puede reducir los pasos manuales y, al mismo tiempo, el riesgo de cambios inesperados en el modelo.

El principal coste inicial no está relacionado con nuevo hardware, sino con los conocimientos de Ruby API y la adaptación al flujo de trabajo de las extensiones existentes; las fuentes no especifican requisitos concretos de hardware o licencia. Es recomendable que los estudios prueben primero en un modelo pequeño la reversión de las operaciones, el uso compartido de instancias de componentes y la compatibilidad de los métodos con la versión de SketchUp que utilizan.

Preguntas frecuentes

¿Cómo se accede al modelo activo en SketchUp Ruby API?

`Sketchup.active_model` permite acceder al modelo abierto. A través del objeto Model se puede llegar a colecciones como la geometría, la selección, los materiales y las definiciones de componentes.

¿Cuál es la diferencia entre entities y active_entities en SketchUp Ruby API?

`entities` devuelve los elementos del nivel raíz del modelo. `active_entities` devuelve los elementos del contexto de edición de un grupo o componente abierto; si no hay ninguno, devuelve lo mismo que `entities`.

¿Cómo se separa una instancia de componente de las demás en SketchUp?

`ComponentInstance#make_unique` crea una definición de componente que no comparten otras instancias. Así, los cambios pueden aplicarse únicamente a la instancia separada.

Los comentarios y el foro están en turco.Únete al debate
+

Noticias relacionadas