Enum surfman::SurfaceAccess [−][src]
Specifies how and if the CPU has direct access to the surface data.
No matter what value you choose here, the CPU can always indirectly upload data to the surface by, for example, drawing a full-screen quad. This enumeration simply describes whether the CPU has direct memory access to the surface, via a slice of pixel data.
You can achieve better performance by limiting surfaces to GPUOnly
unless you need to access
the data on the CPU. For surfaces marked as GPU-only, the GPU can use texture swizzling to
improve memory locality.
Variants
The surface data is accessible by the GPU only.
The lock_surface_data()
method will return the SurfaceDataInaccessible
error when
called on this surface.
This is typically the flag you will want to use.
The surface data is accessible by the GPU and CPU.
The surface data is accessible by the GPU and CPU, and the CPU will send surface data over the bus to the GPU using write-combining if available.
Specifically, what this means is that data transfer will be optimized for the following patterns:
-
Writing, not reading.
-
Writing sequentially, filling every byte in a range.
This flag has no effect on correctness (at least on x86), but not following the rules above may result in severe performance consequences.
The driver is free to treat this as identical to GPUCPU
.
Trait Implementations
impl Clone for SurfaceAccess
[src]
fn clone(&self) -> SurfaceAccess
[src]
pub fn clone_from(&mut self, source: &Self)
1.0.0[src]
impl Copy for SurfaceAccess
[src]
impl Debug for SurfaceAccess
[src]
impl PartialEq<SurfaceAccess> for SurfaceAccess
[src]
fn eq(&self, other: &SurfaceAccess) -> bool
[src]
#[must_use]pub fn ne(&self, other: &Rhs) -> bool
1.0.0[src]
impl StructuralPartialEq for SurfaceAccess
[src]
Auto Trait Implementations
impl RefUnwindSafe for SurfaceAccess
impl Send for SurfaceAccess
impl Sync for SurfaceAccess
impl Unpin for SurfaceAccess
impl UnwindSafe for SurfaceAccess
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
pub fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
type Owned = T
The resulting type after obtaining ownership.
pub fn to_owned(&self) -> T
[src]
pub fn clone_into(&self, target: &mut T)
[src]
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,