Skip to content

properties.py - Documentación Técnica

COLOCAR IMAGEN DEL CÓDIGO FUENTE DE properties.py EN EL EDITOR AQUÍ

El archivo properties.py define las propiedades globales y específicas utilizadas por DAMTools. Estas propiedades permiten almacenar configuraciones, opciones y estados que son compartidos entre operadores, paneles y menús del addon.


Índice


Proposito General

  • Define propiedades globales y específicas para el funcionamiento de DAMTools.
  • Permite almacenar configuraciones persistentes y estados temporales.
  • Facilita la comunicación entre operadores, paneles y menús.

Estructura del Archivo

  1. Definición de propiedades globales: Propiedades añadidas a Scene, Object o WindowManager.
  2. Propiedades específicas de herramientas: Opciones y estados para cada herramienta (importar, exportar, QuickSnap, etc).
  3. Registro de propiedades: Funciones para registrar y eliminar propiedades al activar/desactivar el addon.

Bloques Clave y Explicación

Definicion de Propiedades Globales

bpy.types.Scene.DAMTools_batch_import_path = StringProperty(
    name="Import Path",
    description="Ruta para importar archivos en lote",
    subtype='DIR_PATH',
)
- Define una propiedad global para la ruta de importación en lote.

Propiedades Específicas de Herramientas

bpy.types.Scene.DAMTools_quicksnap_enabled = BoolProperty(
    name="QuickSnap Enabled",
    description="Indica si QuickSnap está activo",
    default=False,
)
- Propiedad booleana para controlar el estado de QuickSnap.

Registro de Propiedades

def register():
    # Añade propiedades a bpy.types.Scene, Object, etc.
def unregister():
    # Elimina propiedades al desactivar el addon
- Funciones estándar para el ciclo de vida de las propiedades.


Snippets de Codigo Clave

Ejemplo de Propiedad de String

bpy.types.Scene.DAMTools_batch_export_path = StringProperty(
    name="Export Path",
    description="Ruta para exportar archivos en lote",
    subtype='DIR_PATH',
)

Ejemplo de Propiedad de Bool

bpy.types.Scene.DAMTools_align_floor_enabled = BoolProperty(
    name="Align Floor Enabled",
    description="Activa la herramienta de alineación al piso",
    default=False,
)

Imagenes Sugeridas

  • COLOCAR IMAGEN DEL CÓDIGO FUENTE DE properties.py EN EL EDITOR
  • COLOCAR CAPTURA DE LAS PROPIEDADES EN EL PANEL DE ESCENA DE BLENDER
  • COLOCAR DIAGRAMA DE LA RELACIÓN ENTRE PROPIEDADES Y OPERADORES

Para ver la integración con cada herramienta, consultar la documentación de los módulos correspondientes en la carpeta [DOCUMENTATION].