SMARTMODULE DOCS v1.8.0 PRO
Inicio
Manual Técnico Oficial

SmartModule v1.8.0 PRO

Referencia completa de parámetros, herramientas interactivas, motores de cálculo y flujos de producción de SmartModule para Trimble SketchUp.

1. Requisitos del Sistema y Barra Oficial

Compatibilidad de Versión: SmartModule está programado y optimizado exclusivamente para Trimble SketchUp 2024 o posterior. No es compatible con versiones anteriores debido a dependencias del motor interno de Ruby y de CEF (Chromium Embedded Framework) en los cuadros de diálogo HTML5.

Comandos de la Barra de Herramientas (Toolbar Oficial)

La barra registrada en el cargador main.rb contiene los siguientes elementos exactos:

Comando / Acción Icono Asociado Función Exacta en SmartModule
Configuración Global icon_config.png Abre la ventana de ajustes generales del proyecto (holguras por defecto, espesores y tolerancias).
Crear Módulo icon_new.png Abre el asistente de diseño paramétrico de 2 pasos. Si la licencia no está validada, ejecuta el inicio de sesión.
Editar Módulo icon_edit.png Permite editar el módulo SmartModule seleccionado individualmente, reabriendo el asistente sin deformar piezas.
Diseño Libre icon_free_design.png Despliega la paleta flotante lateral para diseño a medida no lineal.
Smart Extrude (Normal) (Menú Plugins / Atajo) Herramienta que extruye cualquier cara poligonal bloqueando el espesor de la placa activa.
Smart Extrude (Inverso) (Menú Plugins / Atajo) Invierte la extrusión hacia el vector opuesto preservando la cara exterior seleccionada.
Edición Grupal icon_batch.png Modificación masiva simultánea de parámetros para múltiples módulos SmartModule seleccionados (Plan PRO).
Girar Veta icon_grain.png Herramienta de clic directo para rotar 90° la dirección de veta en una pieza (impacta en 3D y en lista de corte).
Tapacantos icon_pointer.png Herramienta manual para asignar, cambiar o quitar tapacantos arista por arista.
Ver Tapacantos icon_edge.png Modo de inspección visual: resalta en colores las aristas chapeadas en todo el modelo.
Girar Horizontal icon_horiz.png Rotación rápida de 90° del objeto seleccionado en el plano horizontal (Fast Rotate).
Girar Vertical icon_vert.png Rotación rápida de 90° del objeto seleccionado en el plano vertical (Fast Rotate).
Generador de Espacios icon_room_builder.png Abre el lienzo 2D/3D (Room Builder) para trazar muros, vanos y generar recintos arquitectónicos (Plan PRO).
Despiece y Costeo icon_report.png Genera la tabla analítica de despiece con medidas de corte, ranuras, tapacantos y exportación (requiere guardar el archivo).
Plano de Armado (Visor) icon_armado.png Visor técnico aislado para generar hojas de montaje A4 con 7 vistas y cotas milimétricas (Plan PRO).
Optimizador de Corte icon_optimizador.png Motor de nesting 2D para calcular el aprovechamiento de tableros, retales y patrones de corte de sierra (Plan PRO).
Generador de Presupuestos icon_presupuesto.png Cálculo comercial con tableros, tapacantos, herrajes, servicios, utilidades y exportación de cotización PDF (Plan PRO).
Importar icon_import_mats.png Importador masivo de texturas y materiales de melamina locales al modelo activo.
Catálogo icon_catalog.png Librería de electrodomésticos empotrables paramétricos con recorte automático de encimeras (Plan PRO).
Guardar Local icon_save.png Guarda el módulo o componente seleccionado en la biblioteca local del usuario con su ADN paramétrico.
Render IA icon_render_ia.png Generación de imagen fotorrealista asistida por IA desde el encuadre actual de la cámara de SketchUp.
Compartir Diseño 3D icon_share_3d.png Exporta a formato GLB nativo y sube el modelo al visor interactivo web 3D (enlace para clientes y WhatsApp).

2. Asistente Paramétrico: Paso 1 y Paso 2

Paso 1: Configuración Estructural Base

El formulario de entrada del Paso 1 contiene exactamente los siguientes campos:

  • 1. Identificación: Nombre del Módulo (opcional), botón ABRIR LIBRERÍA y selector de PERFIL TÉCNICO (13 perfiles: Bajo, Alto, Fregadero, Campana, Microondas, Torre Hornos Doble, Torre Horno Simple, Nevera, Clóset, Velador, Librero, Esquinero en L, Base Zócalo).
  • 2. Dimensiones Generales: Ancho (600 mm por defecto), Alto (720 mm por defecto) y Fondo (560 mm por defecto).
  • 3. Base / Zócalo:
    • Interruptor Zócalo Ergonómico con campo numérico de Alto (100 mm por defecto).
    • Zócalo Contenido: 0 = No (Entero) / 1 = Sí (Entre Lats).
    • Laterales al Suelo: 0 = No / 1 = Sí.
  • 4. Estructura y Casco:
    • Sistema de Montaje: Selector segmentado entre Solapado y Embutido.
    • Tipo de Tapa: Amarres (listones) o Tapa completa (panel sólido).
    • Amarres bajo tapa: 0 = No / 1 = Sí.
    • Tipo de Fondo: Ranurado, Atornillado, Clavado o Sin fondo.
  • 5. Espesores y Materiales:
    • Espesor Estructura (Placa): 15 mm (o 18 mm).
    • Espesor Frentes: 15 mm (o 18 mm).
    • Espesor de Fondo: numérico en mm (ej. 3 mm).
    • Selectores de Textura: Estructura, Fondo Mueble y Frentes.
    • Color de Gola: Mismo que frente o Mismo que estructura.

Paso 1: Modal de Ajustes Avanzados

Al abrir la ventana emergente AJUSTES AVANZADOS, se despliegan los 8 bloques técnicos:

Bloque Técnico Parámetros y Opciones Exactas
1. Ensambles Base (Caja) • Montaje Techo: 0 = Entre Laterales, 1 = Sobre Laterales, 2 = Corte a 45° (Solo Básica).
• Montaje Piso: 0 = Entre Laterales, 1 = Bajo Laterales, 2 = Corte a 45° (Solo Básica).
2. Amarres y Estructura • Ancho de amarres: 100 mm por defecto.
• Ancho amarre frontal: 60 mm por defecto.
• Tipo amarres superiores: 0 = Normales (Planos/Frontal) / 1 = Ninguno (Libre / Lavadero).
• Ocultar amarre frontal: 0 = No / 1 = Sí.
• Cant. amarres post.: 2 por defecto.
3. Configuración de Ranuras • Ancho de ranura: 4.0 mm (paso de 0.5 mm).
• Profundidad de ranura: 8.0 mm (paso de 0.5 mm).
4. Retiros y Luces • Retiro de repisas: mm de retranqueo frontal.
• Retiro post. repisas: holgura contra fondo.
• Retiro post. divs: holgura contra fondo en montantes.
• Retiro de divisiones: retranqueo frontal de montantes.
• Retiro de cajones: 0 mm por defecto.
• Retiro fondo clavado: 2 mm por defecto.
• Luz sup. frente: 20 mm por defecto.
• Luz perimetral embutido: 3.0 mm por defecto.
• Luz lat. frentes: 1.5 mm por defecto.
• Luz inf. frente: 1.5 mm por defecto.
5. Sistemas de Apertura • Altura jalador aluminio: 30 mm.
• Altura perfil Gola: 47 mm.
• Profundidad Gola melamina: 50 mm.
• Alto Gola melamina (L): 57 mm.
• Alto Gola melamina (C): 72 mm.
• Muesca lateral para Gola: Toggle (activa calado en laterales).
6. Volados • Volado frontal, lateral y posterior: en mm.
• Volado piso (Micro - Libre): extensión saliente del piso.
7. Cubreducto y Ducto • Hay ducto (Hueco): No / Sí (Diámetro: 100 mm).
• Hay cubreducto: No / Sí (Ancho: 200 mm, Profundidad: 160 mm).
8. Tapa Cantos • Canto delgado: 0.5 mm.
• Canto grueso: 3.0 mm.
• Descontar cantos en la medida de corte: Toggle (activo por defecto).
• Omitir cantos posteriores e inferiores: Toggle.
• Cantos frontales color frentes: Toggle.

Paso 2: Canvas Interactivo y Tipos de Contenido

El Paso 2 cuenta con el lienzo de subdivisión 2D frontal a la izquierda y el panel Inspector a la derecha:

  • División Estructural: Botones para DIVISIÓN VERTICAL (agrega montantes) y DIVISIÓN HORIZONTAL (agrega repisas divisorias fijas).
  • Tipos de Contenido por Vano (Selector Exacto):
    1. VACÍO (ESPACIO LIBRE)
    2. PUERTA ÚNICA
    3. PUERTA DOBLE
    4. PUERTA DE VIDRIO
    5. PUERTA DOBLE DE VIDRIO
    6. CAJONERA
  • Control de Repisas Interiores: Botones + y - para definir estantes interiores flotantes en el espacio seleccionado.

Paso 2: Configuración de Cajoneras (Inspector)

Al seleccionar CAJONERA en un vano, el Inspector habilita:

  • Cantidad de cajones: Botones + y - con recálculo automático de frentes.
  • Gola L Superior: Toggle para activar/desactivar perfil Gola superior en el primer cajón.
  • Tabla de Alturas: Lista dinámica con número de cajón, altura de frente editable y altura de caja resultante.
  • Acabado Interior de Cajón:
    • Espesor pared cajón (mm).
    • Selector de textura exclusiva para la caja.
    • Selector de textura exclusiva para el piso/fondo.
  • Técnica de Carpintería de Cajones:
    • Sistema de Apertura: Tradicional, Gola, Gola Melamina, Jalador de Aluminio, Frente Volado (solape inferior en mm), Corte a 45° (Uñero).
    • Sistema de Corredera: Telescópica Lateral (13 mm) o Oculta Bajo Fondo (Blum Tandem / Movento / Ducasse).
    • Largo de Corredera: Automático (Máximo) o fijo entre 250, 300, 350, 400, 450, 500, 550, 600 mm.
    • Tipo de Piso de Cajón: Ranurado, Atornillado o Clavado.
    • Espesor de Piso: campo numérico en mm.
    • Holgura Máxima de Caja: límite de altura interna.
    • Luz entre frentes: 3 mm por defecto.
    • Luz superior: 0 mm por defecto.
    • Luz inferior: 0 mm por defecto.
    • Mín. alto caja cajón: 40 mm de seguridad.
    • Retiro superior caja (H): 35 mm por defecto.
    • Refuerzo Piso: Interruptor toggle para travesaño anti-pandeo bajo fondo.

Paso 2: Configuración de Puertas (Inspector)

  • Tipo de Apertura: Lateral (Bisagra Estándar), Vertical (Hacia Arriba) o Vertical (Hacia Abajo).
  • Sistema de Apertura: Tradicional (Tirador/Manija), Sistema Gola, Sistema Gola Melamina, Jalador de Aluminio, Frente Volado, Corte a 45° (Uñero).
  • Luz Superior (Excepción): 0 mm para mantener luz perimetral estándar o cota personalizada.
  • Luz entre Puertas: 3 mm para puertas dobles.
  • Sentido de Apertura: Automático, Izquierda o Derecha.
  • Medida de Solape Inferior: visible si se elige frente volado (30 mm por defecto).

Paso 2: Módulos Especiales

Módulo Campos Exclusivos del Inspector
Esquinero en L • Incluir repisa en L (Toggle)
• Altura Z de la repisa y cantidad de repisas
• Profundidad independiente pata izquierda y pata derecha
• Ancho de puerta (0 = Auto)
Esquinero Ciego • Número de puertas: 1 Puerta o 2 Puertas
• Sentido de apertura: Izquierda o Derecha
• Ancho de puerta total: 450 mm por defecto
• Ancho regleta frontal: 50 mm
• Ancho regleta retorno (90°): 50 mm
Base Zócalo • Tipo de encuentro: Largueros pasan vs Cabezales pasan
• Cantidad de refuerzos manuales
• Repartición automática de soporte cada 600 mm
Microondas • Volado del piso (extensión saliente milimétrica)

3. Suite de Diseño Libre (Free Design)

Paleta Lateral y Botones de Acción

La paleta lateral (free_design_palette.html) cuenta con las siguientes opciones:

  • Sincronización:
    • Sinc. Escala: Recalcula dimensiones internas de componentes ante deformaciones.
    • Sinc. Colores: Unifica materiales y texturas en ensambles.
  • Categorías de Diseño: Acceso a ventanas de inyección para Puertas, Cajones, Repisas, Zócalo, Perfil Gola y Otros.
  • Acciones Rápidas:
    1. 1. Crear Volumen Guía: Inserta un prisma delimitador transparente.
    2. 2. Etiquetar Pieza Manual: Asigna identidad técnica a grupos dibujados a mano (Lateral, Piso, Techo, Repisa, Frente, Trasera).
    3. 3. Empaquetar a Módulo: Agrupa piezas individuales en un componente SmartModule estructurado.
    4. 4. Asignar Color / Textura: Selector directo de pinturas de melamina.
  • ⚙️ Configuración Global: Botón superior para definir espesor global de placa, luces y holguras predeterminadas.

Catálogo de Inyección de Piezas

1. Inyección de Puertas (Modelos Reales)

  • Tipo de Montaje: Solapado o Embutido.
  • Modelos Disponibles:
    • Abatible Simple y Abatible Doble
    • Abatible Simple Vidrio y Abatible Doble Vidrio
    • Abatible Vertical y Abatible Vertical Vidrio
    • Puerta con Espejo (Pegado): Con retiro de borde configurable en mm.
    • Puerta con Espejo Embutido: Marco perimetral de melamina (70 mm por defecto) con rebaje posterior.
    • Sistema Corredizo (2 Cuerpos) y Sistema Corredizo (3 Cuerpos): Parámetros de traslape (30 mm), descuento de altura para rieles (10 mm) y separación entre hojas en Z (5 mm).
  • Lados Compartidos: Casillas de verificación (Arriba, Abajo, Izquierda, Derecha) para descontar holguras contra paneles contiguos.

2. Inyección de Cajones

  • Modelos: Cajón Estándar (Con Frente) y Cajón Fregadero (En U).
  • Parámetros de Cajón en U: Ancho del hueco en U (200 mm) y Profundidad del hueco en U (250 mm) para paso de cañerías.
  • Carpintería: Profundidad de caja (Auto o mm), espesor de paredes (15 mm), tipo de piso (Ranurado, Atornillado, Clavado), ranura ancho (4 mm) y profundidad (8 mm), y correderas telescópicas u ocultas.

3. Inyección de Perfil Gola

  • Material: Aluminio o Melamina.
  • Tipo de Perfil: Perfil L (Superior) o Perfil C (Intermedio).
  • Cotas: Espesor melamina (15 mm), profundidad (50 mm), altura L (57 mm), altura C (72 mm), y altura aluminio (47 mm).

Celosías y Condimenteros (Categoría Otros)

  • Condimentero Melamina: Carro extraíble vertical con selector de 2, 3 o 4 niveles de bandejas.
  • Celosía Paramétrica (Panel Alistonado):
    • Fondo: Con Fondo (Plancha Trasera) o Sin Fondo (Solo Listones).
    • Espesor de plancha trasera: 15 mm; Material: Melamina o Madera.
    • Orientación del listón: Plano (Cara al frente) o De Canto (Canto al frente / Costillas).
    • Medidas: Espesor de listón (15 mm), saliente/ancho (40 mm), y separación entre listones (20 mm).
    • Bordes: Listón a Listón, Comenzar y Terminar con Espacio, Iniciar con Espacio, o Finalizar con Espacio.

4. Herramientas de Espacio y Equipamiento

Constructor 2D (Room Builder)

El planificador arquitectónico (room_builder_palette.html) incluye:

  • Parámetros de Recinto:
    • Altura de Pared / Techo (2400 mm por defecto).
    • Tipo de Muro: Muro Exterior (grosor 250 mm) o División Interior (grosor 100 mm).
    • Piso: Casilla INCLUIR PISO con espesor configurable (100 mm).
  • Trazado Interactivo: Botones Muro (+), Medir, Borrar Guías y Nuevo Espacio. Trazado mediante ingreso numérico de Longitud (mm) y Ángulo de esquina (°). Botón de Cerrar Habitación para generar automáticamente los muros sólidos en 3D.

Catálogo de Electrodomésticos

Comando cmd_catalog para inserción paramétrica:

  • Modelos de hornos, microondas, campanas, encimeras y fregaderos.
  • Corte Automático: Al situarse sobre muebles o encimeras, realiza el calado booleano exacto del vano sin destruir los grupos de carpintería.

5. Reportes, Optimización y Presupuestos

Flujo Obligatorio de Producción: Para garantizar la coherencia de datos, debe seguirse la secuencia: 1. Guardar modelo > 2. Despiece y Costeo > 3. Optimizador de Corte > 4. Generador de Presupuestos.

1. Despiece Técnico y Planos de Armado A4

  • Despiece (Reporte): Requiere que el archivo de SketchUp esté guardado previamente. Genera la lista completa de piezas con medidas finales, medidas de corte (con descuento de cantos aplicado si está activo), asignación de cantos en 4 lados (L1, L2, A1, A2), mecanizado de ranuras y sentido de veta.
  • Plano de Armado (Visor): Herramienta independiente en la barra (icon_armado.png) para previsualizar e imprimir fichas A4 de montaje con despiece explotado y cotas por módulo.

2. Optimizador de Corte 2D

  • Configuración de tableros comerciales (largo y ancho).
  • Espesor del disco de corte (Kerf, 4 mm) y refilado perimetral (10 mm).
  • Consideración de veta (bloquea rotación si el material tiene veta; rota a 90° si es color liso).
  • Cálculo de porcentaje de retal, placas necesarias y esquemas gráficos de corte.

3. Generador de Presupuestos PDF

  • Importación de costos de tableros desde el optimizador.
  • Cálculo lineal de tapacantos delgado y grueso.
  • Cuantificación de bisagras, correderas telescópicas/ocultas y tiradores.
  • Costos operativos (corte, enchapado, flete, instalación), margen de beneficio comercial y exportación formal en PDF firmado.

6. Render IA y Visor 3D Web

Render IA

Comando cmd_render_ia: genera renders fotorrealistas con iluminación ambiental y acabados de estudio directamente a partir de la escena activa en SketchUp mediante IA.

Compartir Diseño 3D (Visor Web)

Comando cmd_share_3d (share_dialog.rb):

Propiedad Detalle Técnico Verificado
Formato de Exportación GLB binario optimizado nativo de SketchUp.
Servidor de Alojamiento https://visor.melaminaecuador.com
Funciones del Visor Órbita 360°, paneo, zoom, estudio oscuro con tone mapping fílmico ACES y modo Realidad Aumentada (AR) para smartphones.
Compartir Copia de enlace web al portapapeles y botón para compartir directo vía WhatsApp.
Ciclo de Expiración Los modelos se almacenan durante 7 días en el servidor antes de ser eliminados automáticamente.