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 mc_texture( &self, id: &str, x: f32, y: f32, u0: f32, v0: f32, w: f32, h: f32, tw: f32, th: f32, )

Blit a region from a Minecraft texture identified by namespace + path.

• id: e.g. "minecraft:textures/gui/icons.png"
• (x, y): screen position
• (u0, v0): top-left UV in texels
• (w, h): region size in pixels
• (tw, th): full texture size in pixels

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; prefer this over Self::mc_texture.

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 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).