Últimas noticias
Crear una escena USD en Houdini Solaris: guía de flujos por capasGPT-6 Astra contribuye a una demostración sobre un problema de la física de partículasGuía de Level Streaming en Unreal Engine: gestionar grandes escenas arquitectónicasNVIDIA Vera: plataforma HPC con 192 CPU para simulaciones científicasLimpieza de mallas en Blender: guía de Voxel Remesh y retopologíaPremio Ambasz–MoMA para Friendship Centre: arquitectura en armonía con la naturaleza¿Cómo gestionar escenas, cámaras y ajustes de render con Blender Python?Transferir escenas a Unreal Engine con Datasmith: guía de visualización arquitectónicaDesplegar UV en Blender: mapas UV limpios y controlados con costurasNVIDIA informa de su liderazgo de Vera Rubin en las pruebas MLPerf
TutorialesBlenderBlender Project Setup

¿Cómo gestionar escenas, cámaras y ajustes de render con Blender Python?

La API de Blender Python permite gestionar distintos ajustes, desde el rango de tiempo de la escena y la cámara activa hasta la resolución del render. Esta guía explica funciones básicas con ejemplos para visualización arquitectónica.

Cámara y detalles arquitectónicos en un interior bañado por luz naturalImagen IA
Imagen ilustrativa generada con IA.Imagen: 3dsınıfı / FCA AI

En resumen

  1. El rango de la escena, el fotograma actual y el intervalo de simulación se pueden ajustar con las propiedades de Scene.
  2. La cámara activa, la distancia focal y las guías de composición forman parte de las propiedades de Camera.
  3. La resolución del render, la velocidad de fotogramas y el comportamiento de salida se configuran mediante RenderSettings.
  4. Algunas propiedades antiguas de composición aparecen marcadas como obsoletas en la documentación actual de la API.

¿Qué aprenderás en esta guía?

La API de Blender Python permite modificar mediante código datos como el rango de tiempo de una escena y su cámara activa. Los ajustes de render también se pueden controlar a través de los datos de render de la misma escena. En esta guía abordamos ajustes básicos que pueden reutilizarse en flujos de visualización arquitectónica y presentaciones de interiores: fotogramas de la escena y de la simulación, distancia focal y guías de encuadre de la cámara, resolución de salida y velocidad de fotogramas.

Los ejemplos suponen que una Scene existente está disponible en la variable scene y que los datos de una cámara existente están disponibles en camera. Los fragmentos de código son asignaciones para las propiedades indicadas, no un script de configuración que prepare las variables. La documentación de la API describe los nombres de las propiedades y los rangos de valores admitidos. Por eso, probar los cambios en una copia del archivo del proyecto facilita comparar los resultados de ajustes que quizá no sean adecuados para la escena.

Requisitos

Se necesitan Blender y las propiedades Scene, RenderSettings y Camera descritas en la documentación de la API de Python. Las fuentes no especifican una versión concreta de Blender, un tipo de cuenta ni condiciones de pago. Los ejemplos de código deben ejecutarse en un contexto de Python con acceso a referencias Scene y Camera; esta guía no presupone rutas de menú ni pasos de instalación que no estén documentados para obtener esas referencias.

Cada ajuste cumple una función distinta. Las propiedades Scene definen el rango de fotogramas de la escena y la cámara activa, mientras que RenderSettings regula la salida y el comportamiento del render. Las propiedades de la cámara contienen datos como la distancia focal y las guías de encuadre. Determinar primero qué bloque de datos se va a modificar reduce el riesgo de cambiar una propiedad equivocada.

Paso 1: Ajusta el rango de fotogramas de la escena

En el bloque de datos Scene, frame_start y frame_end indican los fotogramas inicial y final del rango de reproducción y render. frame_current indica el fotograma actual. Definir estos valores explícitamente para una animación o una presentación arquitectónica por etapas hace que la temporización de la escena quede clara en el script.

En el ejemplo siguiente, el rango de la escena se establece entre 1 y 120. Son valores de ejemplo dentro del rango permitido indicado en la documentación, no una cantidad de fotogramas obligatoria para un proyecto concreto.

python
scene.frame_start = 1
scene.frame_end = 120
scene.frame_current = 1

El rango de tiempo de las simulaciones puede definirse por separado del rango general de la escena. simulation_frame_start y simulation_frame_end establecen los fotogramas inicial y final de la simulación. use_custom_simulation_range controla si se utiliza un rango de simulación distinto del rango de la escena. Esta opción es importante cuando se necesita diferenciar los rangos de una escena y una simulación que tienen duraciones distintas.

python
scene.use_custom_simulation_range = True
scene.simulation_frame_start = 1
scene.simulation_frame_end = 120

Cambiar estos valores no garantiza por sí solo el resultado visual de la simulación. También hay que tener en cuenta si los nodos de simulación del proyecto sobrescriben su propio rango de fotogramas; la descripción de la API señala que el rango personalizado se utiliza cuando este tipo de nodos no modifica el suyo.

Paso 2: Controla la cámara activa y la composición

La propiedad camera de la escena contiene la cámara activa que se utilizará para el render. lens en el bloque de datos de la cámara establece en milímetros la distancia focal de una cámara en perspectiva. Con lens_unit se puede elegir si la distancia focal se ajusta en la interfaz en milímetros o mediante el ángulo de visión. El ejemplo siguiente supone que los datos de la cámara ya están disponibles en una variable.

python
camera.lens_unit = 'MILLIMETERS'
camera.lens = 35.0

En la vista de cámara se pueden mostrar guías de composición. Por ejemplo, la guía de tercios se activa o desactiva con show_composition_thirds, y la guía de proporción áurea, con show_composition_golden. Estas guías ayudan a evaluar el encuadre; no modifican por sí mismas la geometría de la escena ni la posición de la cámara.

python
camera.show_composition_thirds = True

Al evaluar el encuadre de interiores arquitectónicos, conviene revisar conjuntamente la relación de aspecto y el campo de visión de la cámara. La API de Camera también incluye propiedades para el campo de visión horizontal y vertical. Además, hay opciones como la escala ortográfica y los tipos de panorama; sin embargo, como están vinculadas a distintos tipos de cámara y usos, no deben tratarse como ajustes predeterminados para una cámara de interior en perspectiva.

Paso 3: Ajusta las preferencias de salida del render y rendimiento

RenderSettings incluye la resolución horizontal y vertical, así como el porcentaje de resolución. La velocidad de fotogramas se define con la propiedad fps. El ejemplo siguiente asigna explícitamente los valores predeterminados de resolución y velocidad de fotogramas indicados en la documentación. Si el tamaño de imagen y los ajustes de animación requeridos para la entrega del proyecto son distintos, deben elegirse otros valores.

python
scene.render.resolution_x = 1920
scene.render.resolution_y = 1080
scene.render.resolution_percentage = 100
scene.render.fps = 24

Para obtener una vista previa más rápida, se puede reducir resolution_percentage; antes del render final hay que comprobarlo de nuevo. La documentación define esta propiedad como un porcentaje de la resolución del render. Para utilizar una región de render, están disponibles use_border y las coordenadas de los límites; use_crop_to_border controla si la salida se recorta según la región definida.

También conviene revisar la composición en el flujo de render. use_compositing, dentro de RenderSettings, controla si el resultado del render pasa por un grupo de nodos compositor asignado a la escena. La documentación indica que la antigua propiedad Scene.use_nodes ya no tiene efecto y que debe usarse scene.render.use_compositing para activar o desactivar la composición. La propiedad compositing_node_group también aparece marcada como obsoleta a partir de la versión 5.0; la documentación indica que su retirada está prevista para la versión 6.0. Por eso, hay que comparar los nombres de las propiedades en scripts antiguos con la descripción actual de la API.

Errores comunes y próximos pasos

Uno de los problemas más frecuentes es confundir el rango de la escena con el rango de la simulación. Otro es modificar las propiedades de un bloque de datos de cámara distinto de la cámara activa. Antes de generar la salida final, también hay que comprobar conjuntamente el porcentaje de resolución, las dimensiones y la velocidad de fotogramas. use_persistent_data puede conservar datos en memoria para acelerar los renders y los renders de animación; sin embargo, según la descripción de la API, esto aumenta el uso de memoria.

Como siguiente paso, prueba cada grupo de ajustes en un fragmento de script separado: primero el rango de fotogramas, luego el encuadre de la cámara y, por último, los ajustes de salida. Después de cada cambio, genera una vista previa breve y compara los resultados. Si necesitas utilizar los mismos valores en varios proyectos, reunir las asignaciones en un flujo de script ordenado puede mejorar la repetibilidad; aun así, asegúrate de que las referencias a la escena y la cámara activas sean correctas. Aunque los ajustes de render incluyan una opción de GPU, las fuentes no garantizan compatibilidad con hardware específico ni resultados de rendimiento; hay que hacer pruebas en el sistema disponible.

Fuentes y licencia

Esta guía se ha traducido y adaptado a partir de las descripciones de Scene, RenderSettings y Camera en la documentación de la API de Blender. Las fuentes se ofrecen bajo la licencia CC BY-SA 4.0: las páginas de Scene, RenderSettings y Camera de la API de Blender.

Fuentes

3 fuentes
D(
docs.blender.org (CC BY-SA 4.0)docs.blender.org/api/current/bpy.types.Scene.html
Resumen
D(
docs.blender.org (CC BY-SA 4.0)docs.blender.org/api/current/bpy.types.RenderSettings.html
Resumen
D(
docs.blender.org (CC BY-SA 4.0)docs.blender.org/api/current/bpy.types.Camera.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 estudios de arquitectura y los equipos de visualización de Turquía, el valor práctico de estas funciones reside en la posibilidad de dar más coherencia a los ajustes de escena y salida que se repiten con frecuencia. Gestionar mediante scripts el rango de animación, la resolución y el encuadre de la cámara puede facilitar el seguimiento de los ajustes al transferir un proyecto.

Sin embargo, usar la API no reduce por sí solo el tiempo de render; los datos de render persistentes pueden aumentar el uso de memoria y las ventajas de la opción GPU dependen del sistema disponible. Los estudios deben probar los scripts con la estructura de sus propias escenas y comparar el uso antiguo de `use_nodes` con las propiedades actuales. Como las fuentes no especifican precios de productos ni compatibilidad de hardware, esta guía no basta por sí sola para tomar decisiones de compra o rendimiento.

Preguntas frecuentes

¿Cómo se cambia el rango de fotogramas de una escena con la API de Blender Python?

Las propiedades `frame_start` y `frame_end` del bloque de datos Scene definen los fotogramas inicial y final. El fotograma actual se puede ajustar con `frame_current`.

¿Se puede configurar la resolución del render de Blender con Python?

Sí. Las propiedades `resolution_x`, `resolution_y` y `resolution_percentage` de RenderSettings controlan la resolución y su escala.

¿Se debe usar `Scene.use_nodes` en la API de Blender?

Según la documentación actual de la API, esta propiedad aparece marcada como obsoleta a partir de la versión 5.0 y modificarla no tiene efecto. Para controlar la composición, se indica la propiedad `scene.render.use_compositing`.

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

Noticias relacionadas