Repository navigation
Releases
Releases · trq-lol/lol.trq.helios
lol.trq.helios 0.1.0
First release. Requires Minecraft Forge 1.8.9 on LWJGL 3 through lol.trq.lazarus 0.2.0 or newer in core mode
(-Dlazarus.gl=core), Java 17 or newer.
Added
- OpenGL 4.1 core profile only:
GlBackendseam andGl41CoreBackend, which checks the context at start-up. Every
shader is#version 410 core; the preprocessor rejects other versions. Seedocs/opengl.md. StreamBuffer: a fenced ring of three vertex buffers rotated byHelios.tick(), withglBufferSubDataby default
and unsynchronized mapping behind-Dhelios.stream=map. Program, vertex array, array buffer, matrices and viewport
are read from Lazarus's state tracker when it has them.StateGuard: saves each GL state slot on first touch and restores newest first; cached state goes through a
GlStateCache, implemented for the MinecraftGlStateManager. Covers blend, depth, cull, program, framebuffer,
viewport, array buffer, vertex array, texture units, scissor, stencil and colour mask.- Shader loader:
#include(relative and root), injected defines,#linemapping so driver errors read
file:line, uniform location cache, reload that keeps the last good program; hot reload from a source directory. FramebufferPoolsized in framebuffer pixels, with resize handling.ShapeBatch: batched signed distance shapes (rounded rects, outlines, circles, arcs, lines, polylines, drop
shadows, inner glow, textured images with tint) anti-aliased over exactly one pixel, drawn as indexed triangles
from its own vertex array;Paintfor solid, four-corner, linear and radial gradients.- Effects: dual Kawase blur, blur behind a shape, bloom, post-processing chains of custom full-screen passes.
ScissorStackfor nested clipping;StencilMaskto clip drawing to any shape;MinecraftHelios.enableStencil().- MSDF text:
MsdfFont(.hfntatlases),TextRendererwith kerning,§colour and format codes (bold, italic,
underline, strikethrough, obfuscated), classic and soft shadows, weight and letter spacing; glyphs share the
shape batch. Inter Regular is bundled. fontgen: a Java port of msdfgen's generator that builds.hfntatlases from TrueType and OpenType fonts at build
time.MeshRenderer(Helios.meshes()): 3D drawing throughQuadSink(position and colour),LineSink(lines a given
number of pixels wide, anti-aliased, clipped at the near plane) andTexturedSink(position, texture coordinates,
normal and tint, with Minecraft 1.8.9's two-light entity lighting). Sinks transform on the CPU so meshes with
different transforms share a draw call;MeshRecorderandStaticMeshupload a mesh once withGL_STATIC_DRAW.PlayerModelandPlayerPose: the 1.8.9 player transform chain withAttachmentanchors at the head, body and
back, following body and head yaw, pitch, sneaking, the riding limit and armour.Colors: packed ARGB maths, HSB/HSL, sRGB, linear-light and hue interpolation, rainbow and ping-pong, hex
parsing and formatting, readable text colour.Easingcurves,Animationthat reverses mid-flight without jumping, frame-rate independentSmooth,
Stopwatch; all driven by an injectableClock.Maths, column-majorMat4, andProjectorfor world-to-screen projection and 2D bounding boxes.- Minecraft wiring by reflection, no Mixin:
MinecraftHelios,MinecraftGlStateCache,MinecraftWorld(partial
ticks, camera, interpolated entity positions and boxes) andMinecraftPlayerPose(a live player's pose). - JMH benchmarks and harness GPU timings; see
BENCHMARKS.md. - Development harness that boots Forge 1.8.9 on LWJGL 3 through the Lazarus release in core mode and checks rendering
in game: every primitive against a software model, blur, bloom, text and stencil against reference images, state
restoration, and any[lazarus] GL errorfails the run.-Pworldchecks projection, player anchors and mesh
drawing in a singleplayer world. Runs in CI under Xvfb with Mesa.