# 🔄 XML→SCL Converter - Modo Manual con GUI

## 📋 Descripción

`x8_manual_gui.py` es una interfaz gráfica de usuario (GUI) que facilita la conversión de archivos XML de Siemens TIA Portal a código SCL de manera manual e interactiva.

## 🚀 Características Principales

- **🖥️ Interfaz gráfica amigable** - Cuadros de diálogo de Windows nativos
- **📄 Selección de archivo XML** - Navegador de archivos integrado
- **📂 Selección de directorio destino** - Explorador de carpetas
- **📝 Generación automática de nombres** - El nombre del archivo SCL se genera automáticamente
- **📊 Progreso en tiempo real** - Visualización del proceso de conversión
- **✅ Verificación de resultados** - Confirmación de éxito y opción para abrir directorio
- **🔧 Manejo de errores** - Mensajes claros de error y advertencias

## 🎯 Modo de Uso

### 1. Ejecutar el Script
```bash
python x8_manual_gui.py
```

### 2. Pasos en la Interfaz

1. **📄 Seleccionar Archivo XML**
   - Haz clic en "📁 Examinar..." en la sección "Archivo XML de Origen"
   - Navega y selecciona tu archivo `.xml` de Siemens TIA Portal
   - El nombre del archivo SCL se generará automáticamente

2. **📂 Seleccionar Directorio de Destino**
   - Haz clic en "📁 Examinar..." en la sección "Directorio de Destino"
   - Selecciona la carpeta donde quieres guardar el archivo SCL

3. **🚀 Iniciar Conversión**
   - El botón "🚀 Convertir XML → SCL" se habilitará automáticamente
   - Haz clic para iniciar el proceso de conversión

4. **📊 Monitorear Progreso**
   - Observa los mensajes de progreso en tiempo real
   - La barra de progreso indica que el proceso está en ejecución

5. **✅ Verificar Resultados**
   - Al completarse, verás un mensaje de éxito
   - Opción para abrir automáticamente el directorio de destino

## 🔧 Funcionamiento Interno

El script GUI internamente:

1. **Valida** las selecciones del usuario
2. **Ejecuta** `x0_main.py` en modo simple con los parámetros:
   ```bash
   python x0_main.py --source-xml "archivo.xml" --dest-scl "destino/archivo.scl"
   ```
3. **Captura** la salida del proceso en tiempo real
4. **Muestra** los resultados de manera amigable

## 📋 Requisitos

- **Python 3.x** con tkinter (incluido en la mayoría de instalaciones)
- **x0_main.py** funcional con modo simple implementado
- **Sistema operativo Windows** (para cuadros de diálogo nativos)

## 🆚 Comparación con Otros Modos

| Modo | Comando | Uso Recomendado |
|------|---------|-----------------|
| **GUI (x8)** | `python x8_manual_gui.py` | 🎯 **Usuario final, conversiones manuales** |
| **Simple** | `python x0_main.py --source-xml file.xml --dest-scl file.scl` | 🔧 **Testing, desarrollo, scripts** |
| **PLC** | `python x0_main.py --plc-dir /path/to/plc` | 🏭 **Procesamiento de proyecto completo** |
| **Orquestador** | `python x0_main.py` | 🌐 **Procesamiento masivo multi-PLC** |

## 🎨 Capturas de Funcionalidad

### Interfaz Principal
- Sección clara para selección de archivo XML
- Área dedicada para directorio de destino
- Nombre de archivo auto-generado
- Botón prominente de conversión

### Área de Progreso
- Barra de progreso animada
- Log en tiempo real con timestamps
- Colores distintivos para diferentes tipos de mensajes
- Scroll automático para seguir el progreso

### Diálogos de Resultado
- **Éxito**: Confirmación con opción de abrir directorio
- **Error**: Detalles claros del problema encontrado

## 🚨 Solución de Problemas

### El script no inicia
- Verificar que Python tenga tkinter instalado
- Ejecutar desde el directorio correcto

### Error "x0_main.py no encontrado"
- Asegurarse de que `x0_main.py` esté en el mismo directorio
- Verificar permisos de archivo

### La conversión falla
- Revisar los mensajes en el área de log
- Verificar que el archivo XML sea válido
- Comprobar permisos de escritura en el directorio destino

## 💡 Consejos de Uso

1. **📁 Organización**: Mantén los archivos XML organizados en carpetas por proyecto
2. **🔄 Nombres**: Los nombres de archivo SCL se generan automáticamente basados en el XML
3. **📋 Log**: Revisa siempre el área de log para detalles del proceso
4. **💾 Backup**: Mantén copias de seguridad de tus archivos XML originales
5. **🔍 Verificación**: Siempre verifica el archivo SCL generado antes de usarlo en producción

---

*Creado para facilitar la conversión manual de archivos XML de Siemens TIA Portal a código SCL* 🎯