Drawing on the HUD and in screens
A HUD layer, a screen or a tooltip hook draws through the DrawContext it is handed, in GUI pixels. Each call
is one of vanilla's GuiGraphics calls: fill, text, sprite, item_stack and the others. gui_paint
takes a buffer of GuiDraw ops for the same calls, with Push / Pop for the pose. Native and wasm mods use
the same methods and the same ops.
Gradient fills
DrawContext::fill_gradient(rect, top, bottom) is vanilla's GuiGraphics.fillGradient, the call screen
backgrounds and tooltips are drawn with. rect is [x, y, w, h] in GUI pixels, as fill takes it. top and
bottom are straight-alpha ARGB colours (0xAARRGGBB): top at y, blending to bottom at y + h.
With positive extents these are the visual top and bottom edges. Alpha blends with the colours, so a gradient can
fade out. The current HUD shader discards interpolated alpha below 0.004, not just exact zero; near-transparent
fragments can therefore differ from vanilla's exact-zero discard.
fn gui_render_post(&self, _: &dyn ClientHost, event: &mut GuiRenderPostEvent<'_>) {
// A panel shaded from dark purple at the top to black at the bottom.
event.batch.fill_gradient([20.0, 20.0, 120.0, 60.0], 0xF010_0010, 0xF000_0000);
// A shade that fades out downwards.
event.batch.fill_gradient([20.0, 80.0, 120.0, 10.0], 0x8000_0000, 0x0000_0000);
}
In a gui_paint buffer the same call is the op GuiDraw::FillGradient { x0, y0, x1, y1, top, bottom }, with
vanilla's corner arguments: top stays on the y0 edge and bottom on the y1 edge.
- Pose and clip. A gradient follows the current pose (a
gui_paintbuffer'sPush) and the hook call's clip (push_clip), asfilldoes. A clip that cuts the rectangle keeps the colour ramp: the cut edge has the colour that was there. - Empty or inverted. Zero width or height draws nothing, as does inversion on exactly one axis.
Inverting both axes (
w < 0andh < 0, orx1 < x0andy1 < y0) draws sorted bounds with the colours flipped: the first colour stays on its input y edge, now the lower edge. This preserves vanilla's visible winding and colour placement. Afill_gradientrectangle with a NaN or infinite coordinate draws nothing. Zero-area calls are culled here; vanilla can retain their layering bounds without drawing pixels. - Cost. One quad on the GUI batch, as
fill; nothing is drawn or kept when a mod doesn't call it. - Wire layout.
GuiDrawgained theFillGradientvariant: rebuild wasm mods against the new SDK.