pub struct Texture { /* private fields */ }
Expand description
An image stored on the GPU.
Implementations§
source§impl Texture
impl Texture
sourcepub fn new(
graphics: &Graphics<'_>,
size: Size<UPx>,
format: TextureFormat,
usage: TextureUsages,
filter_mode: FilterMode,
) -> Self
pub fn new( graphics: &Graphics<'_>, size: Size<UPx>, format: TextureFormat, usage: TextureUsages, filter_mode: FilterMode, ) -> Self
Creates a new texture of the given size, format, and usages.
sourcepub fn multisampled(
graphics: &Graphics<'_>,
multisample_count: u32,
size: Size<UPx>,
format: TextureFormat,
usage: TextureUsages,
filter_mode: FilterMode,
) -> Self
pub fn multisampled( graphics: &Graphics<'_>, multisample_count: u32, size: Size<UPx>, format: TextureFormat, usage: TextureUsages, filter_mode: FilterMode, ) -> Self
Creates a new texture of the given multisample count, size, format, and usages.
sourcepub fn new_with_data(
graphics: &Graphics<'_>,
size: Size<UPx>,
format: TextureFormat,
usage: TextureUsages,
filter_mode: FilterMode,
data: &[u8],
) -> Self
pub fn new_with_data( graphics: &Graphics<'_>, size: Size<UPx>, format: TextureFormat, usage: TextureUsages, filter_mode: FilterMode, data: &[u8], ) -> Self
Returns a new texture of the given size, format, and usages. The texture
is initialized with data
. data
must match format
.
sourcepub fn from_image(
image: DynamicImage,
filter_mode: FilterMode,
graphics: &Graphics<'_>,
) -> Self
pub fn from_image( image: DynamicImage, filter_mode: FilterMode, graphics: &Graphics<'_>, ) -> Self
Creates a texture from image
.
sourcepub fn prepare_sized<Unit>(
&self,
origin: Origin<Unit>,
size: Size<Unit>,
graphics: &Graphics<'_>,
) -> PreparedGraphic<Unit>
pub fn prepare_sized<Unit>( &self, origin: Origin<Unit>, size: Size<Unit>, graphics: &Graphics<'_>, ) -> PreparedGraphic<Unit>
Prepares to render this texture with size
. The returned graphic will
be oriented around origin
.
sourcepub fn prepare<Unit>(
&self,
dest: Rect<Unit>,
graphics: &Graphics<'_>,
) -> PreparedGraphic<Unit>
pub fn prepare<Unit>( &self, dest: Rect<Unit>, graphics: &Graphics<'_>, ) -> PreparedGraphic<Unit>
Prepares to render this texture at the given location.
sourcepub fn prepare_partial<Unit>(
&self,
source: Rect<UPx>,
dest: Rect<Unit>,
graphics: &Graphics<'_>,
) -> PreparedGraphic<Unit>
pub fn prepare_partial<Unit>( &self, source: Rect<UPx>, dest: Rect<Unit>, graphics: &Graphics<'_>, ) -> PreparedGraphic<Unit>
Prepares the source
area to be rendered at dest
.
sourcepub const fn format(&self) -> TextureFormat
pub const fn format(&self) -> TextureFormat
The format of the texture.
sourcepub fn copy_to_buffer(
&self,
destination: ImageCopyBuffer<'_>,
encoder: &mut CommandEncoder,
)
pub fn copy_to_buffer( &self, destination: ImageCopyBuffer<'_>, encoder: &mut CommandEncoder, )
Copies the contents of this texture into destination
.
sourcepub fn copy_rect_to_buffer(
&self,
source: Rect<UPx>,
destination: ImageCopyBuffer<'_>,
encoder: &mut CommandEncoder,
)
pub fn copy_rect_to_buffer( &self, source: Rect<UPx>, destination: ImageCopyBuffer<'_>, encoder: &mut CommandEncoder, )
Copies the contents of a portion of this texture into destination
.
sourcepub const fn view(&self) -> &TextureView
pub const fn view(&self) -> &TextureView
Returns a view over the entire texture.
Trait Implementations§
source§impl CanRenderTo for Texture
impl CanRenderTo for Texture
source§fn can_render_to(&self, kludgine: &Kludgine) -> bool
fn can_render_to(&self, kludgine: &Kludgine) -> bool
Returns
true
if this resource can be rendered into a graphics context
for kludgine
.source§impl From<Texture> for AnyTexture
impl From<Texture> for AnyTexture
impl TextureSource for Texture
Auto Trait Implementations§
impl Freeze for Texture
impl !RefUnwindSafe for Texture
impl Send for Texture
impl Sync for Texture
impl Unpin for Texture
impl !UnwindSafe for Texture
Blanket Implementations§
source§impl<S, D, Swp, Dwp, T> AdaptInto<D, Swp, Dwp, T> for Swhere
T: Real + Zero + Arithmetics + Clone,
Swp: WhitePoint<T>,
Dwp: WhitePoint<T>,
D: AdaptFrom<S, Swp, Dwp, T>,
impl<S, D, Swp, Dwp, T> AdaptInto<D, Swp, Dwp, T> for Swhere
T: Real + Zero + Arithmetics + Clone,
Swp: WhitePoint<T>,
Dwp: WhitePoint<T>,
D: AdaptFrom<S, Swp, Dwp, T>,
source§fn adapt_into_using<M>(self, method: M) -> Dwhere
M: TransformMatrix<T>,
fn adapt_into_using<M>(self, method: M) -> Dwhere
M: TransformMatrix<T>,
Convert the source color to the destination color using the specified
method.
source§fn adapt_into(self) -> D
fn adapt_into(self) -> D
Convert the source color to the destination color using the bradford
method by default.
source§impl<T, C> ArraysFrom<C> for Twhere
C: IntoArrays<T>,
impl<T, C> ArraysFrom<C> for Twhere
C: IntoArrays<T>,
source§fn arrays_from(colors: C) -> T
fn arrays_from(colors: C) -> T
Cast a collection of colors into a collection of arrays.
source§impl<T, C> ArraysInto<C> for Twhere
C: FromArrays<T>,
impl<T, C> ArraysInto<C> for Twhere
C: FromArrays<T>,
source§fn arrays_into(self) -> C
fn arrays_into(self) -> C
Cast this collection of arrays into a collection of colors.
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
source§impl<WpParam, T, U> Cam16IntoUnclamped<WpParam, T> for Uwhere
T: FromCam16Unclamped<WpParam, U>,
impl<WpParam, T, U> Cam16IntoUnclamped<WpParam, T> for Uwhere
T: FromCam16Unclamped<WpParam, U>,
source§type Scalar = <T as FromCam16Unclamped<WpParam, U>>::Scalar
type Scalar = <T as FromCam16Unclamped<WpParam, U>>::Scalar
The number type that’s used in
parameters
when converting.source§fn cam16_into_unclamped(
self,
parameters: BakedParameters<WpParam, <U as Cam16IntoUnclamped<WpParam, T>>::Scalar>,
) -> T
fn cam16_into_unclamped( self, parameters: BakedParameters<WpParam, <U as Cam16IntoUnclamped<WpParam, T>>::Scalar>, ) -> T
Converts
self
into C
, using the provided parameters.source§impl<T, C> ComponentsFrom<C> for Twhere
C: IntoComponents<T>,
impl<T, C> ComponentsFrom<C> for Twhere
C: IntoComponents<T>,
source§fn components_from(colors: C) -> T
fn components_from(colors: C) -> T
Cast a collection of colors into a collection of color components.
source§impl<T> FromAngle<T> for T
impl<T> FromAngle<T> for T
source§fn from_angle(angle: T) -> T
fn from_angle(angle: T) -> T
Performs a conversion from
angle
.source§impl<T, U> FromStimulus<U> for Twhere
U: IntoStimulus<T>,
impl<T, U> FromStimulus<U> for Twhere
U: IntoStimulus<T>,
source§fn from_stimulus(other: U) -> T
fn from_stimulus(other: U) -> T
Converts
other
into Self
, while performing the appropriate scaling,
rounding and clamping.source§impl<T> Instrument for T
impl<T> Instrument for T
source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
source§impl<T, U> IntoAngle<U> for Twhere
U: FromAngle<T>,
impl<T, U> IntoAngle<U> for Twhere
U: FromAngle<T>,
source§fn into_angle(self) -> U
fn into_angle(self) -> U
Performs a conversion into
T
.source§impl<WpParam, T, U> IntoCam16Unclamped<WpParam, T> for Uwhere
T: Cam16FromUnclamped<WpParam, U>,
impl<WpParam, T, U> IntoCam16Unclamped<WpParam, T> for Uwhere
T: Cam16FromUnclamped<WpParam, U>,
source§type Scalar = <T as Cam16FromUnclamped<WpParam, U>>::Scalar
type Scalar = <T as Cam16FromUnclamped<WpParam, U>>::Scalar
The number type that’s used in
parameters
when converting.source§fn into_cam16_unclamped(
self,
parameters: BakedParameters<WpParam, <U as IntoCam16Unclamped<WpParam, T>>::Scalar>,
) -> T
fn into_cam16_unclamped( self, parameters: BakedParameters<WpParam, <U as IntoCam16Unclamped<WpParam, T>>::Scalar>, ) -> T
Converts
self
into C
, using the provided parameters.source§impl<T, U> IntoColor<U> for Twhere
U: FromColor<T>,
impl<T, U> IntoColor<U> for Twhere
U: FromColor<T>,
source§fn into_color(self) -> U
fn into_color(self) -> U
Convert into T with values clamped to the color defined bounds Read more
source§impl<T, U> IntoColorUnclamped<U> for Twhere
U: FromColorUnclamped<T>,
impl<T, U> IntoColorUnclamped<U> for Twhere
U: FromColorUnclamped<T>,
source§fn into_color_unclamped(self) -> U
fn into_color_unclamped(self) -> U
Convert into T. The resulting color might be invalid in its color space Read more
source§impl<T> IntoEither for T
impl<T> IntoEither for T
source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
Converts
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moresource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
Converts
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moresource§impl<T> IntoStimulus<T> for T
impl<T> IntoStimulus<T> for T
source§fn into_stimulus(self) -> T
fn into_stimulus(self) -> T
Converts
self
into T
, while performing the appropriate scaling,
rounding and clamping.source§impl<T> Pointable for T
impl<T> Pointable for T
source§impl<T, C> TryComponentsInto<C> for Twhere
C: TryFromComponents<T>,
impl<T, C> TryComponentsInto<C> for Twhere
C: TryFromComponents<T>,
source§type Error = <C as TryFromComponents<T>>::Error
type Error = <C as TryFromComponents<T>>::Error
The error for when
try_into_colors
fails to cast.source§fn try_components_into(self) -> Result<C, <T as TryComponentsInto<C>>::Error>
fn try_components_into(self) -> Result<C, <T as TryComponentsInto<C>>::Error>
Try to cast this collection of color components into a collection of
colors. Read more
source§impl<T, U> TryIntoColor<U> for Twhere
U: TryFromColor<T>,
impl<T, U> TryIntoColor<U> for Twhere
U: TryFromColor<T>,
source§fn try_into_color(self) -> Result<U, OutOfBounds<U>>
fn try_into_color(self) -> Result<U, OutOfBounds<U>>
Convert into T, returning ok if the color is inside of its defined
range, otherwise an
OutOfBounds
error is returned which contains
the unclamped color. Read moresource§impl<C, U> UintsFrom<C> for Uwhere
C: IntoUints<U>,
impl<C, U> UintsFrom<C> for Uwhere
C: IntoUints<U>,
source§fn uints_from(colors: C) -> U
fn uints_from(colors: C) -> U
Cast a collection of colors into a collection of unsigned integers.
source§impl<C, U> UintsInto<C> for Uwhere
C: FromUints<U>,
impl<C, U> UintsInto<C> for Uwhere
C: FromUints<U>,
source§fn uints_into(self) -> C
fn uints_into(self) -> C
Cast this collection of unsigned integers into a collection of colors.