Struct AttrAccess 

pub struct AttrAccess<'a> { /* private fields */ }

Available on crate feature cgb only.

Proof that the attribute plane is the grid mapped at the tilemap addresses.

The plane is a second 32 by 32 grid in VRAM bank 1, sharing the tilemap’s addresses. Each byte holds the palette, the flips, the object priority and the tile bank for the cell of the same coordinates. Pan Docs calls these the BG map attributes, but they reach the window too: whichever layer reads a tilemap reads its attributes alongside.

They belong to the cell, not to the tile it names. Two cells showing one tile can be drawn from different palettes, and giving a cell a different tile leaves its attributes where they were.

BgAttr::bank says which VRAM bank the PPU fetches that cell’s tile from, a separate question from which bank the CPU has mapped. edit_attrs settles the second so that a write lands in the plane rather than in the tile indices.

Handed out by edit_attrs and bounded to its closure, the way Access::Direct is. See https://gbdev.io/pandocs/Tile_Maps.html#bg-map-attributes-cgb-mode-only.

Implementations

impl AttrAccess<'_>

pub fn set(self, access: Access<'_>, map: Map, x: u8, y: u8, attr: BgAttr)

Give one cell its attributes.

pub fn fill( self, access: Access<'_>, map: Map, x: u8, y: u8, w: u8, h: u8, attr: BgAttr, )

Give every cell of a rectangle the same attributes.

Panics

As fill.

pub fn write( self, access: Access<'_>, map: Map, x: u8, y: u8, src: AttrGrid<'_>, )

Copy a rectangle of attribute bytes in, its top left at (x, y).

Panics

As write().

Trait Implementations

impl<'a> !Send for AttrAccess<'a>

impl<'a> !Sync for AttrAccess<'a>

impl<'a> Clone for AttrAccess<'a>

fn clone(&self) -> AttrAccess<'a>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a> Copy for AttrAccess<'a>