frust-gpu 0.5.2

wgpu adapter, device and surface foundation for Frust: capability probing, surface lifecycle and pooled GPU resources.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

//! The `wgpu` adapter/device/surface substrate the render engine builds on.
//!
//! `frust-gpu` owns nothing rendering-specific — no scene display list, no
//! strip pipeline, no `glifo` dependency. Its whole job is the layer directly
//! above `wgpu` itself: probing what an adapter can actually do
//! ([`caps::TierCaps`]) and turning that into the instance, device, surfaces
//! and pooled GPU resources a renderer built on top of it consumes without
//! re-deriving adapter capabilities itself. [`context::RenderContext`] is that
//! foundation, and the one `frust-render` re-exports to its shells.
//!
//! [`caps::TierCaps::probe`] is the only place a real `wgpu::Adapter` is
//! consulted; every decision built on top of it takes the plain
//! [`caps::TierCaps`] value instead, so it stays testable with
//! [`caps::TierCaps::fake`] and no GPU in the loop. [`surface`] and
//! [`lifecycle`] follow the same split: every policy decision they make is a
//! pure function over plain values, and only a handful of named entry points
//! touch a live `wgpu::Device` or a real window handle.

pub mod arena;
pub mod caps;
pub mod context;
pub mod diag;
pub mod effects;
pub mod encoder;
pub mod headless;
pub mod lifecycle;
pub mod lint;
pub mod pipeline;
pub mod pipeline_cache;
pub mod pool;
pub mod shader;
pub mod surface;
pub mod texture;

pub use arena::{BufferSlice, BufferUploader, HostBuffer};
pub use caps::{DownlevelProfile, TierCaps};
pub use context::{ContextOptions, DeviceHandle, RenderContext, test_device_limits};
pub use diag::{GpuFrameSpans, TimestampRing};
pub use effects::ShaderEffects;
pub use encoder::CommandBuffer;
pub use headless::HeadlessTarget;
pub use lifecycle::{
    AcquireAction, AcquireOutcome, AcquireStatus, EncodeOutcome, FrameOutcome, SurfaceEvent,
    SurfacePhase,
};
pub use lint::{LintError, check_limits_against_webgl2, lint_pipeline_layout, lint_wgsl_dir};
pub use pipeline::{PipelineCache, RenderPipelineDesc, VertexLayout};
pub use pool::{PoolKey, PoolStats, PooledTexture, TextureAllocator, TexturePool};
pub use shader::{ShaderId, ShaderLibrary};
pub use surface::{
    ConfiguredSurface, DetachedSurface, SURFACE_FORMATS, SurfaceAlphaRequest, SurfaceFactory,
    compositor_expects_premultiplied,
};
pub use texture::{
    Attachment, ColorAttachment, DepthAttachment, RenderTarget, SceneTextureId, Texture,
    TextureDesc, TextureId, TextureRegistry,
};