x4UI

[EN]

Graphics Abstraction (IGraphics)

• Immediate Graphics Layer: Introduced IGraphics and GLGraphics, decoupling component rendering from direct OpenGL and LWJGL calls.
• State Stack: Hierarchical management for matrix transformations, global alpha (pushAlpha/popAlpha), color tint (pushColorTint/popColorTint), active font, and scissor clipping (pushClip/popClip) via save() and restore().
• Drawing Primitives: Built-in methods for flat and rounded rectangles, borders, lines, circles, and gradients.

Typography System (IFont, FontRegistry)

• IFont Abstraction: Unified text rendering and metrics interface decoupled from vanilla FontRenderer.
• TrueTypeFont Engine: Hardware-accelerated rasterization for vector fonts (.ttf/.otf) and system fonts with anti-aliasing and full vanilla format code support (§0-§f).
• FontRegistry: Centralized registry for loading, resolving, and hot-reloading fonts on resource reload events (F3 + T).
• Integration: Custom font support propagated through IGraphics.setFont() and GuiComponent.withFont().

Component Architecture & Lifecycle (GuiComponent)

• Standardized Lifecycle: Added onAttached(), onDetached(), onDestroy() hooks and per-frame updates via update(float deltaTime).
• Percentage Sizing and Positioning: withPercentWidth(), withPercentHeight(), and withPercentPosition() dynamically resolved against parent bounds.
• Direct Fluent API: Chainable builder methods for position, size, margins, padding, layer ordering (withLayer), font, and theme directly on GuiComponent.
• Reactive State Lifecycle: Automatic unbinding and cleanup of State<T> listeners upon component destruction to eliminate memory retention.

Visual Components

• GuiImage (9-Slice): Native 9-slice border scaling support configured via NineSliceConfig.
• GuiSprite: 2D frame animation engine supporting sprite sheets (SpriteSheetSource) and image sequences (SequenceSource) with FPS control and playback loop modes (LoopMode).
• GuiSlider: Typed modular refactor (GuiSliderInt, GuiSliderFloat, GuiSliderDouble) with full horizontal and vertical orientation support.
• GuiTextInput: Long text horizontal scrolling, mouse-drag text selection, and word-level navigation/deletion shortcuts (Ctrl+Backspace, Ctrl+Delete).

Non-Intrusive GUI Overlays (GuiOverlayManager)

• Screen Injection: Pipeline to mount X4UI components onto vanilla (GuiContainer) or third-party screens without replacing the original screen class.
• Docking Engine (OverlayDockManager): Border anchoring (ContainerAnchor) with collision-free multi-panel stacking.

JEI (Just Enough Items) Integration

• JEI Compatibility: Automatic registration of exclusion areas for active X4UI containers and overlays, preventing visual overlap with the JEI item grid.
• Interaction: Support for recipe (R) and usage (U) lookup hotkeys over GuiSlot components.

Global Buses & Registries

• UIStateBus: Decoupled central bus for reactive state and event communication between independent UI modules.
• ThemeRegistry: Centralized registry to store, look up, and switch ITheme instances across mods.

Sidedness & Network Architecture

• Proxy Sidedness Separation (@SidedProxy): Strict separation into ClientProxy and CommonProxy, preventing client, rendering, and media classes from loading on dedicated servers.
• Server-Optional Handshake (@NetworkCheckHandler): Asymmetric network handshake allowing clients with X4UI to connect to vanilla and modded servers without requiring X4UI on the server.

Multimedia & Zero-Copy Video/Audio Playback

• Zero-Copy Video Streaming (FFmpeg): Raw video frames streamed directly from OS pipes into off-heap direct buffers (DirectByteBuffer) via NIO channels (ReadableByteChannel).
• JVM Heap Allocation Elimination: Removed intermediate byte[] heap arrays, asIntBuffer() conversions, and DynamicTexture heap arrays, keeping steady-state Java Heap consumption completely flat during video playback.
• Direct OpenGL Texture Upload: Direct DMA-like upload of off-heap buffers into OpenGL VRAM textures via glTexSubImage2D with direct native memory pointers.
• VRAM Noise & Glitch Elimination: Added first-frame synchronization latch (hasUploadedFirstFrame) preventing uninitialized VRAM display before the first decoded frame is uploaded.
• Synchronized OpenAL Audio: OpenALAudioSink and FFmpegAudioDecoder streaming 48 kHz stereo PCM audio with real-time volume, mute controls, and master clock synchronization.
• Video Controls Overlay (IVideoControlsLayout): Modular overlay abstraction for GuiVideo. Includes DefaultVideoControlsLayout featuring Play/Pause toggling, interactive timeline seekbar (mouse scrub/drag, buffer track, time tooltip), formatted timestamps (00:15 / 02:45), mute toggle, and smooth 2.5s auto-hide fade on hover inactivity.
• Unified Media Pipeline (MediaPipeline): Sequential background downloading (1-by-1) and optimization using pinned official FFmpeg in x4ui/bin/ (zero host PATH queries). Universal recoding to strict JCodec specification: H.264 Baseline Level 3.1 (no B-frames, fast CAVLC entropy, yuv420p, even dimensions scale/pad <= 720p), AAC 48 kHz audio, and MP4 container with faststart (+faststart). Ensures that if native FFmpeg fails or is unavailable at runtime, the pure-Java JCodecVideoDecoder fallback plays the video smoothly without codec errors.
• Declarative Media Manifests: Automatic discovery during preInit via assets/<modid>/x4ui/media.json and batch registration via MediaRegistry.registerMedia(), avoiding individual one-by-one registration.
• Forge SplashScreen Integration (ProgressManager): Native progress bar tracking in Forge's loading splashscreen during loadComplete with a 35-second safety timeout ensuring dependable game startup.
• In-Game Dynamic Loading: Runtime URL playback requests automatically route through MediaPipeline with non-blocking download/transcode and an animated loading spinner inside GuiVideo.

Non-Destructive Flexbox Engine (hugContent)

• Default Non-Destructive Sizing: FlexLayout no longer destructively overrides or shrinks fixed or percentage-based parent container dimensions (parent.setWidth/setHeight).
• hugContent Property: Added hugContent(boolean) (defaults to false). When enabled, automatically resizes the parent container to hug the total bounds of its visible children.
• Panel Integration: Fluent setHugContent() and withHugContent() methods on GuiPanel. The internal viewport panel of GuiScrollPanel (contentPanel) now natively enables hugContent(true) to reliably track scrollable content height.
• Spacing Polish: Fixed spacing math to eliminate the trailing extra gap following the last visible flex child.

Video Performance & VRAM Bandwidth Optimization

• OpenGL Texture Upload Caching (lastUploadedPts): Eliminated redundant off-heap DMA texture transfers (glTexSubImage2D) occurring at 60/144 Hz when the decoded video frame has not changed, slashing PCIe and GPU memory bandwidth usage to the video's actual frame rate (~30 fps).
• Direct Buffer Frame Management: Proper popFrame() integration in DirectMemoryVideoDecoder to guarantee fluid frame consumption and prevent direct memory stalls.
• FFmpeg Subprocess Seeking: Implemented responsive seeking in FFmpegProcessDecoder via -ss process restart and accurate frame index recalculation.

Lifecycle & Core Event Pipeline

• Forge EventBus Subscription: Explicitly registered ClientProxy to MinecraftForge.EVENT_BUS during init(), restoring per-frame ticking for GuiAnimator.update() and automatic session cleanup (UIStateBus.clearSessionStates(), GuiAnimator.clearAnimations()) on client disconnection.
• Dynamic Text Dimension Propagation: GuiLabel and GuiMarkdown now call setWidth() and setHeight() instead of mutating fields directly, ensuring layout recalculation (parent.requestLayout()) cascades upward on text updates.

Security, Sandboxing & Remote Asset Network

• Mod ID Cache Sandboxing: Strict per-mod asset isolation under .minecraft/x4ui/cache/<modid>/, preventing cache collisions between independent mods.
• HTTP Network Resilience: Added standard browser User-Agent, automated HTTP 301/302/307 redirect resolution, and connection timeouts in DownloadManager.
• Unified Image Cache: Directed GuiImage.setUrl() disk cache to .minecraft/x4ui/cache/images/. [/EN]