Trait gfx::traits::FactoryExt
[−]
[src]
pub trait FactoryExt<R: Resources>: Factory<R> { fn create_vertex_buffer<T>(&mut self, vertices: &[T]) -> Buffer<R, T> where T: Pod + Structure<Format> { ... } fn create_vertex_buffer_with_slice<B, V>(&mut self,
vertices: &[V],
indices: B)
-> (Buffer<R, V>, Slice<R>) where V: Pod + Structure<Format>, B: IntoIndexBuffer<R> { ... } fn create_constant_buffer<T>(&mut self, num: usize) -> Buffer<R, T> where T: Copy { ... } fn create_upload_buffer<T>(&mut self,
num: usize)
-> Result<Buffer<R, T>, CreationError> { ... } fn create_download_buffer<T>(&mut self,
num: usize)
-> Result<Buffer<R, T>, CreationError> { ... } fn create_shader_set(&mut self,
vs_code: &[u8],
ps_code: &[u8])
-> Result<ShaderSet<R>, ProgramError> { ... } fn create_shader_set_tessellation(&mut self,
vs_code: &[u8],
hs_code: &[u8],
ds_code: &[u8],
ps_code: &[u8])
-> Result<ShaderSet<R>, ProgramError> { ... } fn link_program(&mut self,
vs_code: &[u8],
ps_code: &[u8])
-> Result<Program<R>, ProgramError> { ... } fn create_pipeline_state<I: PipelineInit>(&mut self,
shaders: &ShaderSet<R>,
primitive: Primitive,
rasterizer: Rasterizer,
init: I)
-> Result<PipelineState<R, I::Meta>, PipelineStateError<String>> { ... } fn create_pipeline_from_program<'a, I: PipelineInit>(&mut self,
program: &'a Program<R>,
primitive: Primitive,
rasterizer: Rasterizer,
init: I)
-> Result<PipelineState<R, I::Meta>, PipelineStateError<&'a str>> { ... } fn create_pipeline_simple<I: PipelineInit>(&mut self,
vs: &[u8],
ps: &[u8],
init: I)
-> Result<PipelineState<R, I::Meta>, PipelineStateError<String>> { ... } fn create_sampler_linear(&mut self) -> Sampler<R> { ... } }
This trait is responsible for creating and managing graphics resources, much like the Factory
trait in the gfx
crate. Every Factory
automatically implements FactoryExt
.
Provided Methods
fn create_vertex_buffer<T>(&mut self, vertices: &[T]) -> Buffer<R, T> where T: Pod + Structure<Format>
Creates an immutable vertex buffer from the supplied vertices.
A Slice
will have to manually be constructed.
fn create_vertex_buffer_with_slice<B, V>(&mut self,
vertices: &[V],
indices: B)
-> (Buffer<R, V>, Slice<R>) where V: Pod + Structure<Format>, B: IntoIndexBuffer<R>
vertices: &[V],
indices: B)
-> (Buffer<R, V>, Slice<R>) where V: Pod + Structure<Format>, B: IntoIndexBuffer<R>
Creates an immutable vertex buffer from the supplied vertices,
together with a Slice
from the supplied indices.
fn create_constant_buffer<T>(&mut self, num: usize) -> Buffer<R, T> where T: Copy
Creates a constant buffer for num
identical elements of type T
.
fn create_upload_buffer<T>(&mut self,
num: usize)
-> Result<Buffer<R, T>, CreationError>
num: usize)
-> Result<Buffer<R, T>, CreationError>
Creates an upload buffer for num
elements of type T
.
fn create_download_buffer<T>(&mut self,
num: usize)
-> Result<Buffer<R, T>, CreationError>
num: usize)
-> Result<Buffer<R, T>, CreationError>
Creates a download buffer for num
elements of type T
.
fn create_shader_set(&mut self,
vs_code: &[u8],
ps_code: &[u8])
-> Result<ShaderSet<R>, ProgramError>
vs_code: &[u8],
ps_code: &[u8])
-> Result<ShaderSet<R>, ProgramError>
Creates a ShaderSet
from the supplied vertex and pixel shader source code.
fn create_shader_set_tessellation(&mut self,
vs_code: &[u8],
hs_code: &[u8],
ds_code: &[u8],
ps_code: &[u8])
-> Result<ShaderSet<R>, ProgramError>
vs_code: &[u8],
hs_code: &[u8],
ds_code: &[u8],
ps_code: &[u8])
-> Result<ShaderSet<R>, ProgramError>
Mainly for testing
fn link_program(&mut self,
vs_code: &[u8],
ps_code: &[u8])
-> Result<Program<R>, ProgramError>
vs_code: &[u8],
ps_code: &[u8])
-> Result<Program<R>, ProgramError>
Creates a basic shader Program
from the supplied vertex and pixel shader source code.
fn create_pipeline_state<I: PipelineInit>(&mut self,
shaders: &ShaderSet<R>,
primitive: Primitive,
rasterizer: Rasterizer,
init: I)
-> Result<PipelineState<R, I::Meta>, PipelineStateError<String>>
shaders: &ShaderSet<R>,
primitive: Primitive,
rasterizer: Rasterizer,
init: I)
-> Result<PipelineState<R, I::Meta>, PipelineStateError<String>>
Similar to create_pipeline_from_program(..)
, but takes a ShaderSet
as opposed to a
shader Program
.
fn create_pipeline_from_program<'a, I: PipelineInit>(&mut self,
program: &'a Program<R>,
primitive: Primitive,
rasterizer: Rasterizer,
init: I)
-> Result<PipelineState<R, I::Meta>, PipelineStateError<&'a str>>
program: &'a Program<R>,
primitive: Primitive,
rasterizer: Rasterizer,
init: I)
-> Result<PipelineState<R, I::Meta>, PipelineStateError<&'a str>>
Creates a strongly typed PipelineState
from its Init
structure, a shader Program
, a
primitive type and a Rasterizer
.
fn create_pipeline_simple<I: PipelineInit>(&mut self,
vs: &[u8],
ps: &[u8],
init: I)
-> Result<PipelineState<R, I::Meta>, PipelineStateError<String>>
vs: &[u8],
ps: &[u8],
init: I)
-> Result<PipelineState<R, I::Meta>, PipelineStateError<String>>
Creates a strongly typed PipelineState
from its Init
structure. Automatically creates a
shader Program
from a vertex and pixel shader source, as well as a Rasterizer
capable
of rendering triangle faces without culling.
fn create_sampler_linear(&mut self) -> Sampler<R>
Create a linear sampler with clamping to border.