Importación Batch - Documentación Completa¶

COLOCAR IMAGEN DEL PANEL DE IMPORTACIÓN EN EL NPANEL DE DAMTools AQUÍ

La herramienta de Importación Batch de DAMTools permite importar múltiples archivos OBJ y STL de forma masiva, aplicando offsets automáticos por carpeta o por nombre, y soportando búsqueda recursiva en subcarpetas. Es ideal para flujos de trabajo de ingeniería, impresión 3D y organización de grandes volúmenes de archivos.

Que es la Importacion Batch¶

Permite importar decenas o cientos de archivos OBJ/STL en una sola operación, organizando automáticamente los objetos en el espacio 3D según la estructura de carpetas o el nombre de archivo. Soporta: - Offset automático en X por carpeta o por número final en el nombre. - Importación recursiva en subcarpetas. - Selección de formatos a importar (OBJ, STL). - Integración total con el panel lateral y menú pie de DAMTools.

COLOCAR IMAGEN DE LA VENTANA DE SELECCIÓN DE CARPETA DE IMPORTACIÓN AQUÍ

Flujo de Trabajo¶

Abrir el panel lateral DAMTools (N Panel).
Ir a la sección "Importación en Lote".
Configurar los formatos y opciones de búsqueda/offset.
Presionar "Importar desde Carpeta..." y seleccionar la carpeta base.
Los archivos se importan y se distribuyen automáticamente en X según la configuración.

COLOCAR GIF O SECUENCIA DE IMÁGENES DEL FLUJO DE IMPORTACIÓN AQUÍ

Opciones y Parametros¶

Formatos: OBJ, STL (pueden activarse/desactivarse).
Búsqueda Recursiva: Importa archivos en subcarpetas.
Offset por Carpeta: Aplica desplazamiento X por cada carpeta o grupo.
Offset por Nombre: Si no hay subcarpetas, usa el número final del nombre para agrupar.
Valor de Offset: Espaciado en X entre grupos.

Atajos y Accesos¶

Panel Lateral DAMTools: Sección "Importación en Lote".
Menú Pie DAMTools (Shift+W): Opción "Import Batch".
Operador: object.batch_import_files

COLOCAR IMAGEN DEL MENU PIE DAMTools CON LA OPCIÓN DE IMPORTACIÓN EN FOCO AQUÍ

Explicacion de Funcionalidades¶

Offset por Carpeta o Nombre¶

Si hay subcarpetas, cada carpeta recibe un offset X distinto.
Si no hay subcarpetas, se agrupa por número final en el nombre del archivo.
El offset es configurable.

Importacion Recursiva¶

Permite importar archivos de todas las subcarpetas de la carpeta base.
Ideal para proyectos con estructura jerárquica.

Soporte de Formatos¶

Se pueden importar archivos OBJ y/o STL.
El usuario puede activar/desactivar cada formato según necesidad.

Snippets de Codigo Clave¶

Búsqueda y Agrupación de Archivos¶

def process_file(filepath, root_dir):
    filename = os.path.basename(filepath)
    group_key = root_dir # Por defecto
    if self._use_name_pattern_for_offset:
        group_key = get_grouping_key_from_name(filename)
    if group_key is not None:
        self._files_to_process.append((filepath, group_key))
        temp_group_keys.add(group_key)

Aplicación de Offset al Importar¶

if imported_ok:
    self._imported_count += 1
    if x_offset != 0.0:
        context.view_layer.update()
        objects_after_import = set(context.scene.objects); newly_imported_objects = objects_after_import - objects_before_import
        for obj in newly_imported_objects:
            obj.location.x += x_offset

Imagenes Sugeridas¶

COLOCAR IMAGEN DEL PANEL DE IMPORTACIÓN EN EL NPANEL
COLOCAR IMAGEN DE LA VENTANA DE SELECCIÓN DE CARPETA
COLOCAR GIF DEL FLUJO DE IMPORTACIÓN MASIVA
COLOCAR IMAGEN DEL MENU PIE DAMTools CON IMPORT EN FOCO

Para detalles técnicos y explicación de cada archivo, ver la documentación técnica en la carpeta [DOCUMENTATION].