Skip to content

Releases

lol.trq.helios 0.1.0

Choose a tag to compare

@github-actions github-actions released this 19 Nov 07:19

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: GlBackend seam and Gl41CoreBackend, which checks the context at start-up. Every
    shader is #version 410 core; the preprocessor rejects other versions. See docs/opengl.md.
  • StreamBuffer: a fenced ring of three vertex buffers rotated by Helios.tick(), with glBufferSubData by 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 Minecraft GlStateManager. 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, #line mapping so driver errors read
    file:line, uniform location cache, reload that keeps the last good program; hot reload from a source directory.
  • FramebufferPool sized 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; Paint for solid, four-corner, linear and radial gradients.
  • Effects: dual Kawase blur, blur behind a shape, bloom, post-processing chains of custom full-screen passes.
  • ScissorStack for nested clipping; StencilMask to clip drawing to any shape; MinecraftHelios.enableStencil().
  • MSDF text: MsdfFont (.hfnt atlases), TextRenderer with 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 .hfnt atlases from TrueType and OpenType fonts at build
    time.
  • MeshRenderer (Helios.meshes()): 3D drawing through QuadSink (position and colour), LineSink (lines a given
    number of pixels wide, anti-aliased, clipped at the near plane) and TexturedSink (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; MeshRecorder and StaticMesh upload a mesh once with GL_STATIC_DRAW.
  • PlayerModel and PlayerPose: the 1.8.9 player transform chain with Attachment anchors 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.
  • Easing curves, Animation that reverses mid-flight without jumping, frame-rate independent Smooth,
    Stopwatch; all driven by an injectable Clock.
  • Maths, column-major Mat4, and Projector for 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) and MinecraftPlayerPose (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 error fails the run. -Pworld checks projection, player anchors and mesh
    drawing in a singleplayer world. Runs in CI under Xvfb with Mesa.