Struct agb::display::affine::AffineMatrix

source ·

pub struct AffineMatrix { /* private fields */ }

Expand description

An affine matrix stored in a way that is efficient for the GBA to perform operations on. This implements multiplication.

Implementations§

source §

impl AffineMatrix

source

pub fn identity() -> Self

The Identity matrix. The identity matrix can be thought of as 1 and is represented by I. For a matrix A, A ≡ A * I ≡ I * A.

source

pub fn from_rotation<const N: usize>(angle: Num<i32, N>) -> Self

Generates the matrix that represents a rotation

Examples found in repository ?

examples/sprites.rs (line 29)

fn all_sprites(gfx: &OamManaged, rotation_speed: Num<i32, 16>) {
    let mut input = agb::input::ButtonController::new();
    let mut objs = Vec::new();

    let mut rotation: Num<i32, 16> = num!(0.);

    let rotation_matrix = AffineMatrix::from_rotation(rotation);
    let matrix = object::AffineMatrixInstance::new(rotation_matrix.to_object_wrapping());

    for y in 0..9 {
        for x in 0..14 {
            let mut obj = gfx.object_sprite(&SPRITES[0]);
            obj.set_affine_matrix(matrix.clone());
            obj.show_affine(object::AffineMode::Affine);
            obj.set_position((x * 16 + 8, y * 16 + 8).into());
            objs.push(obj);
        }
    }

    let mut count = 0;
    let mut image = 0;

    let vblank = agb::interrupt::VBlank::get();

    loop {
        vblank.wait_for_vblank();
        input.update();

        if input.is_just_pressed(agb::input::Button::A) {
            break;
        }

        rotation += rotation_speed;
        let rotation_matrix = AffineMatrix::from_rotation(rotation);

        let matrix = object::AffineMatrixInstance::new(rotation_matrix.to_object_wrapping());

        for obj in objs.iter_mut() {
            obj.set_affine_matrix(matrix.clone());
        }

        count += 1;

        if count % 5 == 0 {
            image += 1;
            image %= SPRITES.len();
            for (i, obj) in objs.iter_mut().enumerate() {
                let this_image = (image + i) % SPRITES.len();
                obj.set_sprite(gfx.sprite(&SPRITES[this_image]));
            }
        }
        gfx.commit();
    }
}

source

pub fn from_translation(position: Vector2D<Num<i32, 8>>) -> Self

Generates the matrix that represents a translation by the position

source

pub fn position(&self) -> Vector2D<Num<i32, 8>>

The position fields of the matrix

source

pub fn try_to_background(&self) -> Result<AffineMatrixBackground, OverflowError>

Attempts to convert the matrix to one which can be used in affine backgrounds.

source

pub fn to_background_wrapping(&self) -> AffineMatrixBackground

Converts the matrix to one which can be used in affine backgrounds wrapping any value which is too large to be represented there.

source

pub fn try_to_object(&self) -> Result<AffineMatrixObject, OverflowError>

Attempts to convert the matrix to one which can be used in affine objects.

source

pub fn to_object_wrapping(&self) -> AffineMatrixObject

Converts the matrix to one which can be used in affine objects wrapping any value which is too large to be represented there.

Examples found in repository ?

examples/sprites.rs (line 30)

fn all_sprites(gfx: &OamManaged, rotation_speed: Num<i32, 16>) {
    let mut input = agb::input::ButtonController::new();
    let mut objs = Vec::new();

    let mut rotation: Num<i32, 16> = num!(0.);

    let rotation_matrix = AffineMatrix::from_rotation(rotation);
    let matrix = object::AffineMatrixInstance::new(rotation_matrix.to_object_wrapping());

    for y in 0..9 {
        for x in 0..14 {
            let mut obj = gfx.object_sprite(&SPRITES[0]);
            obj.set_affine_matrix(matrix.clone());
            obj.show_affine(object::AffineMode::Affine);
            obj.set_position((x * 16 + 8, y * 16 + 8).into());
            objs.push(obj);
        }
    }

    let mut count = 0;
    let mut image = 0;

    let vblank = agb::interrupt::VBlank::get();

    loop {
        vblank.wait_for_vblank();
        input.update();

        if input.is_just_pressed(agb::input::Button::A) {
            break;
        }

        rotation += rotation_speed;
        let rotation_matrix = AffineMatrix::from_rotation(rotation);

        let matrix = object::AffineMatrixInstance::new(rotation_matrix.to_object_wrapping());

        for obj in objs.iter_mut() {
            obj.set_affine_matrix(matrix.clone());
        }

        count += 1;

        if count % 5 == 0 {
            image += 1;
            image %= SPRITES.len();
            for (i, obj) in objs.iter_mut().enumerate() {
                let this_image = (image + i) % SPRITES.len();
                obj.set_sprite(gfx.sprite(&SPRITES[this_image]));
            }
        }
        gfx.commit();
    }
}