Struct evegfx::low_level::LowLevel

pub struct LowLevel<M: Model, I: Interface> { /* fields omitted */ }

LowLevel is a low-level interface to EVE controllers which matches the primitive operations used in Programmers Guides for the various EVE controllers.

This is slightly higher-level than the Interface trait, providing size-specific memory accesses, but doesn't have any special knowledge about the memory map or command set of any particular EVE implementation.

This struct tracks a "cursor" for appending display list entries using the dl method. Use dl_reset to reset that cursor to the beginning of display list memory, which you'll typically (but not necessarily) do after writing REG_DLSWAP to swap the display list double buffer. LowLevel doesn't manage display list buffer swapping itself, only the cursor for the next dl call.

Implementations

impl<M: Model, I: Interface> LowLevel<M, I>

pub fn new(interface: I) -> Self

pub fn take_interface(self) -> I

Consumes the LowLevel object and returns the interface it was originally created with.

pub fn borrow_interface<'a>(&'a mut self) -> &'a mut I

pub fn wr8<R: HostAccessible>(&mut self, addr: Ptr<R>, v: u8) -> Result<(), I>

pub fn wr16<R: HostAccessible>(&mut self, addr: Ptr<R>, v: u16) -> Result<(), I>

pub fn wr32<R: HostAccessible>(&mut self, addr: Ptr<R>, v: u32) -> Result<(), I>

pub fn wr8s<R: HostAccessible>(
    &mut self,
    addr: Ptr<R>,
    v: &[u8]
) -> Result<(), I>

pub fn rd8<R: HostAccessible>(&mut self, addr: Ptr<R>) -> Result<u8, I>

pub fn rd16<R: HostAccessible>(&mut self, addr: Ptr<R>) -> Result<u16, I>

pub fn rd32<R: HostAccessible>(&mut self, addr: Ptr<R>) -> Result<u32, I>

pub fn rd8s<R: HostAccessible>(
    &mut self,
    addr: Ptr<R>,
    into: &mut [u8]
) -> Result<(), I>

pub fn main_mem_ptr(&self, offset: u32) -> Ptr<M::MainMem>

pub fn reg_ptr(&self, reg: Register) -> Ptr<M::RegisterMem>

pub fn host_command(&mut self, cmd: HostCmd, a0: u8, a1: u8) -> Result<(), I>

pub fn dl_reset(&mut self)

pub fn dl(&mut self, cmd: DLCmd) -> Result<(), I>

Trait Implementations

impl<M, I> Builder for LowLevel<M, I> where
    M: Model,
    I: Interface, 

type Error = Error<I>

type Model = M

fn append_raw_command(&mut self, raw: u32) -> Result<(), I>

fn append_command(&mut self, cmd: DLCmd) -> Result<(), I>

fn alpha_test(&mut self, func: TestFunc, ref_val: u8) -> Result<(), Self::Error>

fn begin(&mut self, prim: GraphicsPrimitive) -> Result<(), Self::Error>

fn bitmap_cell(&mut self, idx: u8) -> Result<(), Self::Error>

fn bitmap_ext_format(
    &mut self,
    format: BitmapExtFormat
) -> Result<(), Self::Error>

fn bitmap_handle(&mut self, bmp: BitmapHandle) -> Result<(), Self::Error>

fn bitmap_layout_l(
    &mut self,
    format: BitmapFormat,
    line_stride: u16,
    height: u16
) -> Result<(), Self::Error>

fn bitmap_layout_h(
    &mut self,
    line_stride: u16,
    height: u16
) -> Result<(), Self::Error>

fn bitmap_layout(
    &mut self,
    format: BitmapFormat,
    line_stride: u16,
    height: u16
) -> Result<(), Self::Error>

fn bitmap_size_l(
    &mut self,
    width: u16,
    height: u16,
    filter: BitmapSizeFilter,
    wrap_x: BitmapWrapMode,
    wrap_y: BitmapWrapMode
) -> Result<(), Self::Error>

fn bitmap_size_h(&mut self, width: u16, height: u16) -> Result<(), Self::Error>

fn bitmap_size(
    &mut self,
    width: u16,
    height: u16,
    filter: BitmapSizeFilter,
    wrap_x: BitmapWrapMode,
    wrap_y: BitmapWrapMode
) -> Result<(), Self::Error>

fn bitmap_swizzle(&mut self, swizzle: BitmapSwizzle) -> Result<(), Self::Error>

fn bitmap_source(
    &mut self,
    ptr: Ptr<<Self::Model as Model>::MainMem>
) -> Result<(), Self::Error>

fn bitmap_source_all(
    &mut self,
    bitmap: Bitmap<<Self::Model as Model>::MainMem>
) -> Result<(), Self::Error>

fn bitmap_transform_a(
    &mut self,
    coeff: impl Into<MatrixCoeff>
) -> Result<(), Self::Error>

fn bitmap_transform_b(
    &mut self,
    coeff: impl Into<MatrixCoeff>
) -> Result<(), Self::Error>

fn bitmap_transform_c(
    &mut self,
    coeff: impl Into<MatrixCoeff>
) -> Result<(), Self::Error>

fn bitmap_transform_d(
    &mut self,
    coeff: impl Into<MatrixCoeff>
) -> Result<(), Self::Error>

fn bitmap_transform_e(
    &mut self,
    coeff: impl Into<MatrixCoeff>
) -> Result<(), Self::Error>

fn bitmap_transform_f(
    &mut self,
    coeff: impl Into<MatrixCoeff>
) -> Result<(), Self::Error>

fn bitmap_transform_matrix(
    &mut self,
    matrix: impl Into<Matrix3x2>
) -> Result<(), Self::Error>

Appends six display list commands to set all six of the bitmap transform matrix coefficients to match the given matrix.

fn blend_func(
    &mut self,
    src: BlendFunc,
    dst: BlendFunc
) -> Result<(), Self::Error>

fn call(
    &mut self,
    addr: Ptr<<Self::Model as Model>::DisplayListMem>
) -> Result<(), Self::Error>

fn clear(
    &mut self,
    color: bool,
    stencil: bool,
    tag: bool
) -> Result<(), Self::Error>

fn clear_all(&mut self) -> Result<(), Self::Error>

fn clear_color_rgb(&mut self, color: RGB) -> Result<(), Self::Error>

fn clear_color_alpha(&mut self, alpha: u8) -> Result<(), Self::Error>

fn clear_color_rgba(&mut self, color: RGBA) -> Result<(), Self::Error>

fn clear_stencil(&mut self, v: u8) -> Result<(), Self::Error>

fn clear_tag(&mut self, v: u8) -> Result<(), Self::Error>

fn color_rgb(&mut self, color: RGB) -> Result<(), Self::Error>

fn color_mask(&mut self, mask: ColorMask) -> Result<(), Self::Error>

fn color_alpha(&mut self, alpha: u8) -> Result<(), Self::Error>

fn display(&mut self) -> Result<(), Self::Error>

fn draw(
    &mut self,
    prim: GraphicsPrimitive,
    f: impl FnOnce(VertexBuilder<'_, Self>) -> Result<(), Self::Error>
) -> Result<(), Self::Error>

Draw a graphics primitive of a particular type, with zero or vertices defined in a closure.

fn draw_iter(
    &mut self,
    prim: GraphicsPrimitive,
    iter: impl Iterator<Item = Vertex2F>
) -> Result<(), Self::Error>

Draw a graphics primitive of a particular type, with zero or vertices defined in an iterator of vertices.

fn end(&mut self) -> Result<(), Self::Error>

fn command_from_macro(&mut self, num: u8) -> Result<(), Self::Error>

fn jump(
    &mut self,
    addr: Ptr<<Self::Model as Model>::DisplayListMem>
) -> Result<(), Self::Error>

fn line_width(&mut self, v: u16) -> Result<(), Self::Error>

fn nop(&mut self) -> Result<(), Self::Error>

fn palette_source(
    &mut self,
    ptr: Ptr<<Self::Model as Model>::MainMem>
) -> Result<(), Self::Error>

fn point_size(&mut self, size: u16) -> Result<(), Self::Error>

fn restore_context(&mut self) -> Result<(), Self::Error>

fn return_from_call(&mut self) -> Result<(), Self::Error>

fn save_context(&mut self) -> Result<(), Self::Error>

fn scissor_size(&mut self, dims: (u16, u16)) -> Result<(), Self::Error>

fn scissor_pos(&mut self, pos: impl Into<ScissorPos>) -> Result<(), Self::Error>

fn scissor_rect(
    &mut self,
    rect: impl Into<ScissorRect>
) -> Result<(), Self::Error>

fn stencil_test(
    &mut self,
    func: TestFunc,
    ref_val: u8,
    mask: u8
) -> Result<(), Self::Error>

fn stencil_mask(&mut self, mask: u8) -> Result<(), Self::Error>

fn stencil_op(
    &mut self,
    fail: StencilOp,
    pass: StencilOp
) -> Result<(), Self::Error>

fn tag(&mut self, v: u8) -> Result<(), Self::Error>

fn tag_mask(&mut self, update: bool) -> Result<(), Self::Error>

fn vertex_2f<Pos: Into<Vertex2F>>(
    &mut self,
    pos: Pos
) -> Result<(), Self::Error>

fn vertex_2ii<Pos: Into<Vertex2II>>(
    &mut self,
    pos: Pos
) -> Result<(), Self::Error>

fn vertex_format(&mut self, fmt: VertexFormat) -> Result<(), Self::Error>

fn vertex_translate_x(&mut self, v: i16) -> Result<(), Self::Error>

fn vertex_translate_y(&mut self, v: i16) -> Result<(), Self::Error>

fn vertex_translate(&mut self, offset: (i16, i16)) -> Result<(), Self::Error>