Struct GfxContext 

pub struct GfxContext(/* private fields */);

Handle to the GPU and draw capabilities for a single render frame.

Valid only within an on_hud_render or on_world_render callback. Do not store across frames — store GPU resource handles (u32) instead.

Implementations

impl GfxContext

pub fn screen_size(&self) -> (i32, i32)

GUI pixel dimensions of the screen for this frame.

pub fn delta_tick(&self) -> f32

Partial-tick interpolation factor (0.0–1.0).

pub fn view_proj(&self) -> [f32; 16]

View-projection matrix in camera-relative space (column-major, 16 × f32). Zeros during on_hud_render; filled during on_world_render.

pub fn camera_pos(&self) -> [f32; 3]

Camera world-space position. All zeros during on_hud_render.

pub fn player_pos(&self) -> [f32; 3]

Local player world-space position (eye height). All zeros during on_hud_render. Use this to anchor geometry to the player; differs from camera_pos in third-person.

pub fn create_buffer(&self) -> Buffer

Allocate a new GPU buffer (VBO or EBO). Returns handle 0 on failure.

pub fn delete_buffer(&self, buf: Buffer)

Delete a buffer allocated by create_buffer.

pub fn create_vao(&self) -> VertexArray

Allocate a new vertex array object. Returns handle 0 on failure.

pub fn delete_vao(&self, vao: VertexArray)

Delete a vertex array allocated by create_vao.

pub fn create_shader( &self, vert_src: &str, frag_src: &str, ) -> Result<ShaderProgram, ()>

Compile and link a GLSL shader program. Returns Err(()) and logs on compile/link failure.

pub fn delete_shader(&self, prog: ShaderProgram)

Delete a shader program.

pub fn create_texture_rgba( &self, w: u32, h: u32, pixels: &[u8], linear: bool, ) -> Texture

Upload RGBA8 pixel data as a new GPU texture. linear: true = bilinear filter, false = nearest.

pub fn texture_from_mc(&self, id: &str) -> Texture

Get the GL texture handle that Minecraft uses for an identifier (e.g. "minecraft:textures/gui/icons.png"). Returns handle 0 if not found.

pub fn delete_texture(&self, tex: Texture)

Delete a texture.

pub fn bind_texture(&self, unit: u32, tex: &Texture)

Bind a texture to the given sampler unit (0–7).

pub fn draw_arrays( &self, vao: &VertexArray, prog: &ShaderProgram, mode: DrawMode, first: u32, count: u32, )

Draw primitives using a vertex array (no index buffer).

pub fn draw_elements( &self, vao: &VertexArray, ebo: &Buffer, prog: &ShaderProgram, mode: DrawMode, count: u32, u32_indices: bool, )

Draw primitives via an index buffer. u32_indices: true = u32 indices, false = u16 indices.

pub fn set_blend(&self, enabled: bool, src: u32, dst: u32)

Enable or disable alpha blending. src/dst: GL blend factor constants from core::blend.

pub fn set_depth(&self, test: bool, write: bool)

Enable or disable depth testing and writing.

pub fn set_scissor(&self, x: i32, y: i32, w: i32, h: i32)

Enable scissor clipping to a GUI-pixel rectangle.

pub fn clear_scissor(&self)

Disable scissor clipping.

pub fn set_viewport(&self, x: i32, y: i32, w: i32, h: i32)

Set the GL viewport in physical pixels (x, y, width, height).

pub fn draw2d(&self) -> Draw2D<'_>

Access the 2D drawing helpers (text, rectangles, MC textures). These only work during on_hud_render.

Trait Implementations

impl Clone for GfxContext

fn clone(&self) -> GfxContext

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for GfxContext

impl Send for GfxContext

impl Sync for GfxContext