Skip to content

operators.py - Documentación Técnica

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

El archivo operators.py define los operadores principales de DAMTools. Los operadores son las acciones ejecutables (como importar, exportar, alinear, duplicar, etc.) que pueden ser invocadas desde el panel lateral, el menú pie o atajos de teclado.


Índice


Proposito General

  • Define los operadores (acciones) principales del addon DAMTools.
  • Permite ejecutar acciones desde el panel, menú pie o atajos.
  • Integra la lógica de cada herramienta (importar, exportar, QuickSnap, etc).

Estructura del Archivo

  1. Definición de operadores principales: Clases para cada acción (importar, exportar, alinear, organizar, etc).
  2. Integración con paneles y menús: Métodos para invocar operadores desde la UI.
  3. Registro de clases: Lista de operadores a registrar en Blender.

Bloques Clave y Explicación

Definicion de Operadores Principales

class DAMTools_OT_BatchImport(Operator):
    bl_idname = "DAMTools.batch_import"
    bl_label = "Batch Import"
    def execute(self, context):
        # Lógica de importación en lote
- Operador para importar archivos en lote.

class DAMTools_OT_BatchExport(Operator):
    bl_idname = "DAMTools.batch_export"
    bl_label = "Batch Export"
    def execute(self, context):
        # Lógica de exportación en lote
- Operador para exportar archivos en lote.

Integracion con Paneles y Menús

layout.operator("DAMTools.batch_import", text="Batch Import", icon='IMPORT')
- Permite invocar el operador desde la UI.

Registro de Clases

classes = (
    DAMTools_OT_BatchImport,
    DAMTools_OT_BatchExport,
    # ...otros operadores
)
- Lista de operadores a registrar en Blender.


Snippets de Codigo Clave

Ejemplo de Operador con Modal

class DAMTools_OT_AlignFloor(Operator):
    bl_idname = "DAMTools.align_floor"
    bl_label = "Align Floor"
    def modal(self, context, event):
        # Lógica modal para alineación interactiva

Ejemplo de Operador Simple

class DAMTools_OT_JoinNearby(Operator):
    bl_idname = "DAMTools.join_nearby"
    bl_label = "Join Nearby"
    def execute(self, context):
        # Lógica para unir objetos cercanos

Imagenes Sugeridas

  • COLOCAR IMAGEN DEL CÓDIGO FUENTE DE operators.py EN EL EDITOR
  • COLOCAR CAPTURA DE UN OPERADOR EN ACCIÓN EN BLENDER
  • COLOCAR DIAGRAMA DE FLUJO DE UN OPERADOR MODAL

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