Skip to content

menu.py - Documentación Técnica

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

El archivo menu.py define el Menú Pie principal de DAMTools, permitiendo el acceso rápido a todas las herramientas del addon desde un menú radial (pie menu) invocable con Shift+W (o el atajo configurado). También incluye submenús y operadores auxiliares para opciones de importación y organización.

Índice

Proposito General

  • Define el menú pie principal de DAMTools y sus submenús.
  • Permite el acceso rápido a todas las herramientas desde el 3D Viewport.
  • Integra operadores auxiliares para opciones avanzadas.

Estructura del Archivo

  1. Colores: Diccionario de colores para personalización visual (opcional).
  2. Operador de opciones de importación: Permite mostrar un diálogo de opciones antes de importar.
  3. Menú Pie principal: Clase BATCHTOOLS_MT_MainMenu con la estructura radial y botones.
  4. Submenú Arrange X (Alt): Permite elegir entre organizar en X normal o con reset de rotación.
  5. Registro de clases: Lista de clases a registrar en Blender.

Bloques Clave y Explicación

Colores y Utilidades

COLORS = {
    "blue": (0.2, 0.6, 1.0, 1.0),
    ...
}
- Diccionario de colores para personalización visual (no esencial para el menú).

Operador de Opciones de Importación

class DAMTools_MT_ImportOptions(Operator):
    bl_idname = "DAMTools.import_options"
    ...
    def draw(self, context):
        # Dibuja opciones de importación en un diálogo
- Permite mostrar un diálogo de opciones antes de importar archivos en lote.

Definicion del Menú Pie Principal

class BATCHTOOLS_MT_MainMenu(Menu):
    bl_idname = "BATCHTOOLS_MT_main_menu"
    bl_label = "DAMTools"
    def draw(self, context):
        layout = self.layout
        pie = layout.menu_pie()
        # Estructura de cuadrantes y botones
- Define el menú pie principal, con secciones para importar, exportar, transformar, ayuda, branding y acceso a QuickSnap.

class BATCHTOOLS_MT_arrange_x_alt_menu(Menu):
    bl_idname = "BATCHTOOLS_MT_arrange_x_alt_menu"
    ...
    def draw(self, context):
        # Permite elegir entre arrange normal y arrange+reset rotación
- Permite elegir entre organizar en X normal o con reset de rotación usando Alt.

Registro de Clases

classes = (
    BATCHTOOLS_MT_MainMenu,
    DAMTools_MT_ImportOptions,
    BATCHTOOLS_MT_arrange_x_alt_menu,
)
- Lista de clases a registrar en Blender.

Snippets de Codigo Clave

Estructura del Menú Pie

class BATCHTOOLS_MT_MainMenu(Menu):
    def draw(self, context):
        layout = self.layout
        pie = layout.menu_pie()
        # ...

Botón de QuickSnap en el Menú Pie

col_quicksnap_pie.operator("object.quicksnap", text="Activar QuickSnap (Ctrl+Shift+V)", icon='SNAP_ON')

Imagenes Sugeridas

  • COLOCAR IMAGEN DEL CÓDIGO FUENTE DE menu.py EN EL EDITOR
  • COLOCAR CAPTURA DEL MENU PIE ABIERTO EN BLENDER
  • COLOCAR DIAGRAMA DE LA ESTRUCTURA RADIAL DEL MENÚ

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