Struct Draw2D 

pub struct Draw2D<'ctx>(/* private fields */);

2D drawing helpers, valid only within on_hud_render.

Obtain via GfxContext::draw2d.

Implementations

impl<'ctx> Draw2D<'ctx>

pub fn text(&self, text: &str, x: f32, y: f32, color: u32, shadow: bool)

Draw a text string at GUI position (x, y). color is 0xAARRGGBB. shadow adds a drop-shadow.

pub fn text_font( &self, text: &str, font: &str, x: f32, y: f32, color: u32, shadow: bool, )

Self::text in the font font ("minecraft:uniform", a resource-pack font id, …; empty or "minecraft:default" = the default font).

pub fn text_width(&self, text: &str, font: &str) -> f32

Width in GUI pixels of text in font (empty = default), measured by the host’s text renderer.

pub fn rect(&self, x1: f32, y1: f32, x2: f32, y2: f32, color: u32)

Fill a rectangle with a flat color (0xAARRGGBB).

pub fn gradient( &self, x1: f32, y1: f32, x2: f32, y2: f32, top: u32, bottom: u32, )

Fill a rectangle with a vertical gradient (top → bottom, 0xAARRGGBB).

pub fn item(&self, id: &str, x: f32, y: f32, size: f32)

Render an item stack (3D block models included) via Minecraft’s item renderer — like inventory slots or Patchouli’s item icons.

• id: item registry id, e.g. "minecraft:crafting_table"
• (x, y): screen position in GUI pixels
• size: on-screen size in GUI pixels (16 = inventory icon size)

pub fn image(&self, source: &str, x: f32, y: f32, w: f32, h: f32)

Draw the image source — a Yog image source such as "item:apple", "block:stone", "sprite:button" or "mymod:gui/logo" (see crate::image) — scaled into (x, y, w, h). The host resolves it for its Minecraft version.

pub fn image_region( &self, source: &str, x: f32, y: f32, w: f32, h: f32, region: [f32; 4], tint: u32, )

Self::image drawing only region ([u, v, w, h] in the image’s own pixels; all zero = the whole image) multiplied by tint (0xAARRGGBB, 0xFFFFFFFF = none). Items and sprites are always drawn whole, and items ignore the tint.

pub fn svg(&self, data: &str, x: f32, y: f32, w: f32, h: f32)

Draws the SVG document data scaled into (x, y, w, h) (sharp at any GUI scale: the host rasterizes it at the screen’s resolution). An .svg file is an image source like any other — mymod:gui/logo.svg — for Self::image.

pub fn text_scaled( &self, text: &str, font: &str, x: f32, y: f32, scale: f32, color: u32, shadow: bool, )

Self::text_font scale times its size (1 = the font’s own).

pub fn blocks( &self, blocks: &[((i32, i32, i32), &str)], x: f32, y: f32, w: f32, h: f32, yaw: f32, pitch: f32, )

Draws blocks in 3D, as big as fits in (x, y, w, h) — a multiblock structure, a block on display: each is ((x, y, z), state) with a full block state (minecraft:furnace[facing=north]), turned yaw degrees about the vertical and tilted pitch degrees toward the viewer (30 looks down on it like Patchouli does).

pub fn entity( &self, entity: &str, x: f32, y: f32, w: f32, h: f32, yaw: f32, pitch: f32, )

Draws a living entity of type entity (minecraft:zombie, mymod:wisp) standing in (x, y, w, h), as big as fits, turned yaw degrees (0 = facing the viewer) and tilted pitch degrees.

pub fn image_size(&self, source: &str) -> Option<(f32, f32)>

Natural size in GUI pixels of the image source (None if the host can’t resolve it).