X4UI r1.0b3

[ES]

Resumen de Cambios

Actualización de la arquitectura interna de renderizado y eventos, introduciendo soporte nativo de Z-Index, interpolaciones basadas en DeltaTime, y gestión segura de recortes OpenGL anidados, además de una gran cantidad de nuevos componentes interactivos.

Arquitectura y Núcleo

• Soporte Z-Index: Implementada la propiedad layer para componentes, proporcionando un ordenamiento determinista para el renderizado y la propagación de eventos (bubbling).
• Animaciones DeltaTime: Integrada lógica de DeltaTime en todo el framework para lograr animaciones e interpolaciones independientes de los FPS.
• Seguridad de Memoria: Implementado FontWidthCache con política de limpieza LRU para mitigar fugas de memoria durante el análisis de textos complejos (ej. Markdown).
• Recorte OpenGL Anidado: Implementado ScissorHelper para gestionar de manera robusta el uso de GL_SCISSOR_TEST en componentes anidados.
• Construcción Fluida: Añadida la clase de utilidad GuiBuilder que proporciona una API fluida (Fluent API) para facilitar la construcción de interfaces.
• Reactividad: Integrado un sistema de gestión de estado reactivo (State).

Componentes y Funcionalidades

• Arrastrar y Soltar (Drag & Drop): Añadida capacidad de arrastre nativa a GuiComponent con límites configurables (DragConstraint.NONE, DragConstraint.PARENT_BOUNDS).
• Tooltips Integrados: Añadido soporte nativo de renderizado de Tooltips en GuiBaseScreen y GuiBaseContainer mediante setTooltip().
• Diseños FlexWrap: Añadida la funcionalidad flexWrap a GuiPanel para el ajuste automático y multilínea de elementos en diseños horizontales y verticales.
• Nuevos Componentes:
  • GuiDropdown para menús desplegables.
  • GuiImage y GuiSprite para la renderización flexible de texturas.
  • GuiTextInput para campos de entrada de texto avanzados.
  • GuiSlot para gestionar inventarios y stacks de ítems dentro del DOM.
  • GuiSlider y sus variantes (GuiSliderDouble, GuiSliderFloat, GuiSliderInt).
  • GuiModelRender para soporte de renderizado de entidades 3D e ítems.
  • GuiVideo para reproducción de vídeo in-game.

Mejoras y Correcciones

• Refactorización de GuiScrollPanel:
  • Migración a ScissorHelper para la resolución adecuada de recortes anidados.
  • Implementado descarte de componentes (culling) para omitir la renderización y procesamiento de eventos de elementos fuera del área visible.
  • Resueltos los problemas de jerarquía de propagación de eventos, permitiendo que los paneles de scroll anidados funcionen correctamente y de manera independiente.
• Solucionada la fuga de memoria en GuiBaseContainer causada por la adición duplicada de áreas en jeiRecipeAreas al redimensionar la ventana.
• Refactorizado GuiMarkdown para utilizar FontWidthCache, mejorando notablemente el rendimiento.
• Estandarizadas las animaciones en GuiButton, GuiToggle y GuiScrollPanel para escalar con DeltaTime en lugar de ticks en crudo.
• Expuestos los métodos getGuiLeft() y getGuiTop() en GuiBaseContainer.
• Reestructurada y completada la documentación técnica en el directorio Docs/ (Disponible en inglés y español).

[/ES]

[EN]

Changelog Summary

Core rendering and event architecture update, introducing native Z-Index support, DeltaTime-based interpolations, and safe management of nested OpenGL clipping, along with a massive batch of new interactive components.

Architecture & Core

• Z-Index Support: Implemented the layer property for components, providing deterministic sorting for rendering and event bubbling priorities.
• DeltaTime Animations: Integrated DeltaTime logic throughout the framework for FPS-independent animations and transitions.
• Memory Safety: Implemented FontWidthCache incorporating an LRU eviction policy to mitigate memory leaks during intensive text parsing tasks (e.g. Markdown rendering).
• Nested OpenGL Clipping: Implemented ScissorHelper to robustly manage nested GL_SCISSOR_TEST applications.
• Fluent Construction: Added GuiBuilder utility class providing a fluent API to streamline interface construction.
• Reactivity: Integrated a reactive State management system.

Components & Features

• Drag & Drop: Added native drag-and-drop capability to GuiComponent with flexible boundaries (DragConstraint.NONE, DragConstraint.PARENT_BOUNDS).
• Native Tooltips: Added internal Tooltip rendering support to GuiBaseScreen and GuiBaseContainer via setTooltip().
• FlexWrap Layouts: Added flexWrap functionality to GuiPanel for automatic multi-line wrapping of elements in horizontal and vertical configurations.
• New Components:
  • GuiDropdown for standard dropdown menu structures.
  • GuiImage and GuiSprite components for flexible texture and sprite rendering.
  • GuiTextInput for advanced text input fields.
  • GuiSlot component to integrate and manage item stacks and inventories within the DOM.
  • GuiSlider architecture with specific implementations (GuiSliderDouble, GuiSliderFloat, GuiSliderInt).
  • GuiModelRender to support 3D entity and item rendering directly inside the user interface.
  • GuiVideo for in-game video playback support.

Fixes & Improvements

• GuiScrollPanel Refactor:
  • Migrated from raw GL calls to ScissorHelper for proper nested clipping resolution.
  • Implemented strict component culling to skip rendering and event processing for elements outside the visible viewport.
  • Resolved event bubbling hierarchy issues, enabling nested scroll panels to function correctly independently of parent containers.
• Resolved memory leak in GuiBaseContainer caused by duplicate instances appending to jeiRecipeAreas upon window resize.
• Refactored GuiMarkdown to utilize FontWidthCache for significantly improved parsing and rendering performance.
• Standardized animations in GuiButton, GuiToggle, and GuiScrollPanel to scale consistently with DeltaTime instead of raw ticks.
• Exposed getGuiLeft() and getGuiTop() within GuiBaseContainer for external utility consumption.
• Restructured and populated the Docs/ directory with comprehensive technical documentation in English (en-us) and Spanish (es-latam).

[/EN]