Struct tetra::graphics::CanvasBuilder [−][src]
pub struct CanvasBuilder { /* fields omitted */ }
Expand description
A builder for creating advanced canvas configurations.
By default, Tetra’s canvases are fairly simple - they just provide a Texture
that you
can render things to. However, they can also be configured with extra features via this
builder, such as multisampling and additional buffers.
Implementations
Creates a new canvas builder, which can be used to create a canvas with multisampling and/or additional buffers.
You can also use Canvas::builder
as a shortcut for this, if you want
to avoid the extra import.
Sets the level of multisample anti-aliasing to use.
The number of samples that can be used varies between graphics cards - 2
, 4
and 8
are reasonably
well supported. When set to 0
(the default), no multisampling will be used.
Resolving
In order to actually display a multisampled canvas, it first has to be downsampled (or ‘resolved’). This is
done automatically once you switch to a different canvas/the backbuffer. Until this step takes place,
your rendering will not be reflected in the canvas’ underlying texture
(and by
extension, in the output of draw
and get_data
).
Sets whether the canvas should have a stencil buffer.
Setting this to true
allows you to use stencils while rendering to the canvas, at the cost
of some extra video RAM usage.
Trait Implementations
Auto Trait Implementations
impl RefUnwindSafe for CanvasBuilder
impl Send for CanvasBuilder
impl Sync for CanvasBuilder
impl Unpin for CanvasBuilder
impl UnwindSafe for CanvasBuilder
Blanket Implementations
Mutably borrows from an owned value. Read more