Struct GpuResourceBudget 

pub struct GpuResourceBudget {
    pub atlas_initial_size: u32,
    pub instance_buffer_initial_size: usize,
    pub instance_buffer_max_size: usize,
}

GPU resource budget.

instance_buffer_max_size is new in 0.9. Existing struct literals that listed only atlas and initial-buffer fields will not compile. Use Self::new or ..GpuResourceBudget::default() to keep a two-field update path; presets already fill the ceiling.

Fields

atlas_initial_size: u32

Initial width and height (in device pixels) for newly created atlas textures.

Atlas textures are allocated lazily when glyphs or images are first rasterized. This controls the minimum size of each texture. If a single glyph or image is larger, the texture will be sized to fit.

Default: 1024 (meaning 1024×1024). For minimal applications, 512 is recommended.

Memory impact (per texture):

• Monochrome (R8): size × size × 1 bytes
• Polychrome (BGRA): size × size × 4 bytes

instance_buffer_initial_size: usize

Initial renderer instance buffer capacity in bytes, where supported.

Instance buffers hold per-frame draw data uploaded to the GPU. This is an initial budget, not a hard cap: renderers may grow the buffer on demand for complex scenes. Lower values reduce idle GPU memory for small apps, while larger values avoid early reallocations for heavy UIs.

Default: 2 MiB for desktop applications.

instance_buffer_max_size: usize

Maximum renderer instance buffer capacity in bytes, where supported.

Batch upload sizes the GPU buffer to fit the whole scene at frame start. This is the growth ceiling after device limits are applied. Desktop matches Zed’s 256 MiB native cap; Utility and Minimal stay lower so a tray or dialog profile cannot balloon to a full-editor working set.

Values below Self::instance_buffer_initial_size are raised to that initial budget.

Callers that only set atlas and initial size should use Self::new instead of a struct literal.

Implementations

impl GpuResourceBudget

pub fn new( atlas_initial_size: u32, instance_buffer_initial_size: usize, ) -> GpuResourceBudget

Build a budget from atlas and initial instance-buffer sizes.

The growth ceiling defaults to Zed’s 256 MiB native cap — the implicit limit before this field existed — so two-argument construction stays source-compatible. Presets still apply tighter Utility/Minimal caps.

pub fn atlas_size(&self) -> Size<DevicePixels>

Returns the atlas initial size as a Size<DevicePixels> for renderer use.

Trait Implementations

impl Clone for GpuResourceBudget

fn clone(&self) -> GpuResourceBudget

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GpuResourceBudget

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

Formats the value using the given formatter.

impl Default for GpuResourceBudget

fn default() -> GpuResourceBudget

Returns the “default value” for a type.