Struct GBuffer 

pub struct GBuffer {
    pub layout: GBufferLayout,
    pub viewport: Viewport,
    pub fbo_handle: u64,
    pub texture_states: Vec<TextureState>,
    pub depth_texture_state: TextureState,
    pub mrt_config: MrtConfig,
    pub debug_view: GBufferDebugView,
    pub stats: GBufferStats,
    pub is_bound: bool,
    pub generation: u32,
    pub is_created: bool,
    /* private fields */
}

The main G-Buffer object that manages all attachment textures and the framebuffer. This struct owns the GPU resource handles (as opaque u64 IDs) and provides bind/unbind/resize/clear operations.

Fields

layout: GBufferLayout

The layout describing all attachments.

viewport: Viewport

Current viewport dimensions.

fbo_handle: u64

Framebuffer object handle.

texture_states: Vec<TextureState>

Per-attachment texture states.

depth_texture_state: TextureState

Depth texture state.

mrt_config: MrtConfig

MRT configuration derived from the layout.

debug_view: GBufferDebugView

Debug view state.

stats: GBufferStats

Statistics.

is_bound: bool

Whether the G-Buffer is currently bound as the render target.

generation: u32

Generation counter (incremented on resize).

is_created: bool

Whether the G-Buffer resources have been created.

Implementations

impl GBuffer

pub fn new(viewport: Viewport) -> Self

Create a new G-Buffer with the default layout.

pub fn with_layout(layout: GBufferLayout, viewport: Viewport) -> Self

Create a new G-Buffer with a custom layout.

pub fn create(&mut self) -> Result<(), GBufferError>

Allocate GPU resources for the G-Buffer. In a real engine this would call OpenGL/Vulkan; here we simulate handle allocation.

pub fn destroy(&mut self)

Destroy GPU resources.

pub fn bind(&mut self) -> Result<(), GBufferError>

Bind the G-Buffer as the current render target.

pub fn unbind(&mut self)

Unbind the G-Buffer (restore default framebuffer).

pub fn bind_for_reading(&self) -> Result<Vec<(u32, u64)>, GBufferError>

Bind all G-Buffer textures for reading in the lighting pass.

pub fn bind_attachment( &self, semantic: GBufferSemantic, texture_unit: u32, ) -> Result<u64, GBufferError>

Bind a single attachment for sampling.

pub fn resize(&mut self, width: u32, height: u32) -> Result<(), GBufferError>

Resize the G-Buffer to a new resolution. Recreates all textures.

pub fn clear_all(&mut self)

Clear all G-Buffer attachments using their configured clear values.

pub fn clear_attachment( &self, semantic: GBufferSemantic, ) -> Result<(), GBufferError>

Clear a specific attachment.

pub fn texture_handle(&self, semantic: GBufferSemantic) -> Option<u64>

Get the texture handle for a specific attachment.

pub fn viewport(&self) -> Viewport

Get the current viewport.

pub fn aspect_ratio(&self) -> f32

Get the aspect ratio.

pub fn stats(&self) -> &GBufferStats

Get a reference to the stats.

pub fn describe(&self) -> String

Get a human-readable description of the G-Buffer configuration.

pub fn needs_recreate(&self) -> bool

Check if the G-Buffer needs to be recreated (e.g., after layout change).

pub fn fullscreen_quad_vertices() -> ([f32; 12], [f32; 8])

Convenience: create a fullscreen quad vertex data for the lighting pass. Returns (positions, uvs) for two triangles covering NDC [-1, 1].

pub fn lighting_vertex_shader() -> &'static str

Generate the complete GLSL vertex shader for the fullscreen lighting quad.

pub fn lighting_fragment_preamble(&self) -> String

Generate the lighting pass fragment shader preamble (sampler uniforms).

Trait Implementations

impl Debug for GBuffer

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Drop for GBuffer

fn drop(&mut self)

Executes the destructor for this type.