Trait gfx_core::factory::Factory [] [src]

pub trait Factory<R: Resources> {
    type CommandBuffer: CommandBuffer<R>;
    type Mapper: Clone + Raw;
    fn get_capabilities<'a>(&'a self) -> &'a Capabilities;
    fn create_command_buffer(&mut self) -> Self::CommandBuffer;
    fn create_buffer_raw(&mut self, size: usize, BufferRole, BufferUsage) -> RawBuffer<R>;
    fn create_buffer_static_raw(&mut self, data: &[u8], BufferRole) -> RawBuffer<R>;
    fn create_pipeline_state_raw(&mut self, &Program<R>, &Descriptor) -> Result<RawPipelineState<R>, CreationError>;
    fn create_program(&mut self, shader_set: &ShaderSet<R>) -> Result<Program<R>, CreateProgramError>;
    fn create_shader(&mut self, stage: Stage, code: &[u8]) -> Result<Shader<R>, CreateShaderError>;
    fn create_sampler(&mut self, SamplerInfo) -> Sampler<R>;
    fn update_buffer_raw(&mut self, buf: &RawBuffer<R>, data: &[u8], offset_bytes: usize) -> Result<()BufferUpdateError>;
    fn map_buffer_raw(&mut self, &RawBuffer<R>, MapAccess) -> Self::Mapper;
    fn unmap_buffer_raw(&mut self, Self::Mapper);
    fn map_buffer_readable<T: Copy>(&mut self, &Buffer<R, T>) -> Readable<T, R, Self> where Self: Sized;
    fn map_buffer_writable<T: Copy>(&mut self, &Buffer<R, T>) -> Writable<T, R, Self> where Self: Sized;
    fn map_buffer_rw<T: Copy>(&mut self, &Buffer<R, T>) -> RW<T, R, Self> where Self: Sized;
    fn update_texture_raw(&mut self, &RawTexture<R>, &RawImageInfo, &[u8], Option<CubeFace>) -> Result<()Error>;
    fn generate_mipmap_raw(&mut self, &RawTexture<R>);
    fn create_texture_raw(&mut self, Descriptor, Option<ChannelType>) -> Result<RawTexture<R>, Error>;
    fn view_buffer_as_shader_resource_raw(&mut self, &RawBuffer<R>) -> Result<RawShaderResourceView<R>, ResourceViewError>;
    fn view_buffer_as_unordered_access_raw(&mut self, &RawBuffer<R>) -> Result<RawUnorderedAccessView<R>, ResourceViewError>;
    fn view_texture_as_shader_resource_raw(&mut self, &RawTexture<R>, ViewDesc) -> Result<RawShaderResourceView<R>, ResourceViewError>;
    fn view_texture_as_unordered_access_raw(&mut self, &RawTexture<R>) -> Result<RawUnorderedAccessView<R>, ResourceViewError>;
    fn view_texture_as_render_target_raw(&mut self, &RawTexture<R>, Level, Option<Layer>) -> Result<RawRenderTargetView<R>, TargetViewError>;
    fn view_texture_as_depth_stencil_raw(&mut self, &RawTexture<R>, Option<Layer>) -> Result<RawDepthStencilView<R>, TargetViewError>;

    fn create_buffer_static<T: Copy>(&mut self, data: &[T], role: BufferRole) -> Buffer<R, T> { ... }
    fn create_buffer_dynamic<T>(&mut self, num: usize, role: BufferRole) -> Buffer<R, T> { ... }
    fn create_shader_vertex(&mut self, code: &[u8]) -> Result<VertexShader<R>, CreateShaderError> { ... }
    fn create_shader_geometry(&mut self, code: &[u8]) -> Result<GeometryShader<R>, CreateShaderError> { ... }
    fn create_shader_pixel(&mut self, code: &[u8]) -> Result<PixelShader<R>, CreateShaderError> { ... }
    fn update_buffer<T: Copy>(&mut self, buf: &Buffer<R, T>, data: &[T], offset_elements: usize) -> Result<()BufferUpdateError> { ... }
    fn update_texture<T: Formatted>(&mut self, tex: &Texture<R, T::Surface>, image: &NewImageInfo, data: &[T::Surface::DataType], face: Option<CubeFace>) -> Result<()Error> { ... }
    fn create_texture_with_data(&mut self, desc: Descriptor, channel: ChannelType, data: &[u8]) -> Result<RawTexture<R>, Error> { ... }
    fn create_texture<S>(&mut self, kind: Kind, levels: Level, bind: Bind, channel_hint: Option<ChannelType>) -> Result<Texture<R, S>, Error> where S: SurfaceTyped { ... }
    fn view_buffer_as_shader_resource<T>(&mut self, buf: &Buffer<R, T>) -> Result<ShaderResourceView<R, T>, ResourceViewError> { ... }
    fn view_buffer_as_unordered_access<T>(&mut self, buf: &Buffer<R, T>) -> Result<UnorderedAccessView<R, T>, ResourceViewError> { ... }
    fn view_texture_as_shader_resource<T: TextureFormat>(&mut self, tex: &Texture<R, T::Surface>, levels: (Level, Level), swizzle: Swizzle) -> Result<ShaderResourceView<R, T::View>, ResourceViewError> { ... }
    fn view_texture_as_unordered_access<T: TextureFormat>(&mut self, tex: &Texture<R, T::Surface>) -> Result<UnorderedAccessView<R, T::View>, ResourceViewError> { ... }
    fn view_texture_as_render_target<T: RenderFormat>(&mut self, tex: &Texture<R, T::Surface>, level: Level, layer: Option<Layer>) -> Result<RenderTargetView<R, T>, TargetViewError> { ... }
    fn view_texture_as_depth_stencil<T: DepthFormat>(&mut self, tex: &Texture<R, T::Surface>, layer: Option<Layer>) -> Result<DepthStencilView<R, T>, TargetViewError> { ... }
    fn create_texture_const<T: TextureFormat>(&mut self, kind: Kind, data: &[T::Surface::DataType], mipmap: bool) -> Result<(Texture<R, T::Surface>, ShaderResourceView<R, T::View>)CombinedError> { ... }
    fn create_render_target<T: RenderFormat + TextureFormat>(&mut self, width: Size, height: Size, allocate_mipmap: bool) -> Result<(Texture<R, T::Surface>, ShaderResourceView<R, T::View>, RenderTargetView<R, T>)CombinedError> { ... }
    fn create_depth_stencil<T: DepthFormat + TextureFormat>(&mut self, width: Size, height: Size) -> Result<(Texture<R, T::Surface>, ShaderResourceView<R, T::View>, DepthStencilView<R, T>)CombinedError> { ... }
}

Associated Types

type CommandBuffer: CommandBuffer<R>

Associated command buffer type

type Mapper: Clone + Raw

Associated mapper type

Required Methods

fn get_capabilities<'a>(&'a self) -> &'a Capabilities

Returns the capabilities available to the specific API implementation

fn create_command_buffer(&mut self) -> Self::CommandBuffer

fn create_buffer_raw(&mut self, size: usize, BufferRole, BufferUsage) -> RawBuffer<R>

fn create_buffer_static_raw(&mut self, data: &[u8], BufferRole) -> RawBuffer<R>

fn create_pipeline_state_raw(&mut self, &Program<R>, &Descriptor) -> Result<RawPipelineState<R>, CreationError>

fn create_program(&mut self, shader_set: &ShaderSet<R>) -> Result<Program<R>, CreateProgramError>

fn create_shader(&mut self, stage: Stage, code: &[u8]) -> Result<Shader<R>, CreateShaderError>

fn create_sampler(&mut self, SamplerInfo) -> Sampler<R>

fn update_buffer_raw(&mut self, buf: &RawBuffer<R>, data: &[u8], offset_bytes: usize) -> Result<()BufferUpdateError>

Update the information stored in a specific buffer

fn map_buffer_raw(&mut self, &RawBuffer<R>, MapAccess) -> Self::Mapper

fn unmap_buffer_raw(&mut self, Self::Mapper)

fn map_buffer_readable<T: Copy>(&mut self, &Buffer<R, T>) -> Readable<T, R, Self> where Self: Sized

fn map_buffer_writable<T: Copy>(&mut self, &Buffer<R, T>) -> Writable<T, R, Self> where Self: Sized

fn map_buffer_rw<T: Copy>(&mut self, &Buffer<R, T>) -> RW<T, R, Self> where Self: Sized

fn update_texture_raw(&mut self, &RawTexture<R>, &RawImageInfo, &[u8], Option<CubeFace>) -> Result<()Error>

fn generate_mipmap_raw(&mut self, &RawTexture<R>)

fn create_texture_raw(&mut self, Descriptor, Option<ChannelType>) -> Result<RawTexture<R>, Error>

fn view_buffer_as_shader_resource_raw(&mut self, &RawBuffer<R>) -> Result<RawShaderResourceView<R>, ResourceViewError>

fn view_buffer_as_unordered_access_raw(&mut self, &RawBuffer<R>) -> Result<RawUnorderedAccessView<R>, ResourceViewError>

fn view_texture_as_shader_resource_raw(&mut self, &RawTexture<R>, ViewDesc) -> Result<RawShaderResourceView<R>, ResourceViewError>

fn view_texture_as_unordered_access_raw(&mut self, &RawTexture<R>) -> Result<RawUnorderedAccessView<R>, ResourceViewError>

fn view_texture_as_render_target_raw(&mut self, &RawTexture<R>, Level, Option<Layer>) -> Result<RawRenderTargetView<R>, TargetViewError>

fn view_texture_as_depth_stencil_raw(&mut self, &RawTexture<R>, Option<Layer>) -> Result<RawDepthStencilView<R>, TargetViewError>

Provided Methods

fn create_buffer_static<T: Copy>(&mut self, data: &[T], role: BufferRole) -> Buffer<R, T>

fn create_buffer_dynamic<T>(&mut self, num: usize, role: BufferRole) -> Buffer<R, T>

fn create_shader_vertex(&mut self, code: &[u8]) -> Result<VertexShader<R>, CreateShaderError>

fn create_shader_geometry(&mut self, code: &[u8]) -> Result<GeometryShader<R>, CreateShaderError>

fn create_shader_pixel(&mut self, code: &[u8]) -> Result<PixelShader<R>, CreateShaderError>

fn update_buffer<T: Copy>(&mut self, buf: &Buffer<R, T>, data: &[T], offset_elements: usize) -> Result<()BufferUpdateError>

fn update_texture<T: Formatted>(&mut self, tex: &Texture<R, T::Surface>, image: &NewImageInfo, data: &[T::Surface::DataType], face: Option<CubeFace>) -> Result<()Error>

fn create_texture_with_data(&mut self, desc: Descriptor, channel: ChannelType, data: &[u8]) -> Result<RawTexture<R>, Error>

fn create_texture<S>(&mut self, kind: Kind, levels: Level, bind: Bind, channel_hint: Option<ChannelType>) -> Result<Texture<R, S>, Error> where S: SurfaceTyped

fn view_buffer_as_shader_resource<T>(&mut self, buf: &Buffer<R, T>) -> Result<ShaderResourceView<R, T>, ResourceViewError>

fn view_buffer_as_unordered_access<T>(&mut self, buf: &Buffer<R, T>) -> Result<UnorderedAccessView<R, T>, ResourceViewError>

fn view_texture_as_shader_resource<T: TextureFormat>(&mut self, tex: &Texture<R, T::Surface>, levels: (Level, Level), swizzle: Swizzle) -> Result<ShaderResourceView<R, T::View>, ResourceViewError>

fn view_texture_as_unordered_access<T: TextureFormat>(&mut self, tex: &Texture<R, T::Surface>) -> Result<UnorderedAccessView<R, T::View>, ResourceViewError>

fn view_texture_as_render_target<T: RenderFormat>(&mut self, tex: &Texture<R, T::Surface>, level: Level, layer: Option<Layer>) -> Result<RenderTargetView<R, T>, TargetViewError>

fn view_texture_as_depth_stencil<T: DepthFormat>(&mut self, tex: &Texture<R, T::Surface>, layer: Option<Layer>) -> Result<DepthStencilView<R, T>, TargetViewError>

fn create_texture_const<T: TextureFormat>(&mut self, kind: Kind, data: &[T::Surface::DataType], mipmap: bool) -> Result<(Texture<R, T::Surface>, ShaderResourceView<R, T::View>)CombinedError>

fn create_render_target<T: RenderFormat + TextureFormat>(&mut self, width: Size, height: Size, allocate_mipmap: bool) -> Result<(Texture<R, T::Surface>, ShaderResourceView<R, T::View>, RenderTargetView<R, T>)CombinedError>

fn create_depth_stencil<T: DepthFormat + TextureFormat>(&mut self, width: Size, height: Size) -> Result<(Texture<R, T::Surface>, ShaderResourceView<R, T::View>, DepthStencilView<R, T>)CombinedError>

Implementors