bn::sp_direct_bitmap_bg_attributes_hbe_ptr class
#include <bn_sp_direct_bitmap_bg_attributes_hbe_ptr.h>

std::shared_ptr like smart pointer that retains shared ownership of a H-Blank effect which changes the attributes to commit to the GBA register of a single page direct bitmap background in each screen horizontal line.

Base classes

class hbe_ptr
std::shared_ptr like smart pointer that retains shared ownership of a H-Blank effect.

Public static functions

static auto create(sp_direct_bitmap_bg_ptr bg, const span<const bitmap_bg_attributes>& attributes_ref) -> sp_direct_bitmap_bg_attributes_hbe_ptr
Creates a sp_direct_bitmap_bg_attributes_hbe_ptr which changes the attributes to commit to the GBA register of a single page direct bitmap background in each screen horizontal line.
static auto create_optional(sp_direct_bitmap_bg_ptr bg, const span<const bitmap_bg_attributes>& attributes_ref) -> optional<sp_direct_bitmap_bg_attributes_hbe_ptr>
Creates a sp_direct_bitmap_bg_attributes_hbe_ptr which changes the attributes to commit to the GBA register of a single page direct bitmap background in each screen horizontal line.

Public functions

auto bg() const -> const sp_direct_bitmap_bg_ptr&
Returns the affine background modified by this H-Blank effect.
auto attributes_ref() const -> span<const bitmap_bg_attributes>
Returns the referenced array of 160 bitmap_bg_attributes objects with the attributes to commit to the GBA register of the managed background in each screen horizontal line.
void set_attributes_ref(const span<const bitmap_bg_attributes>& attributes_ref)
Sets the reference to an array of 160 bitmap_bg_attributes objects with the attributes to commit to the GBA register of the managed background in each screen horizontal line.
void reload_attributes_ref()
Rereads the content of the referenced attributes to the GBA register of the managed background in each screen horizontal line.
void swap(sp_direct_bitmap_bg_attributes_hbe_ptr& other)
Exchanges the contents of this sp_direct_bitmap_bg_attributes_hbe_ptr with those of the other one.

Friends

void swap(sp_direct_bitmap_bg_attributes_hbe_ptr& a, sp_direct_bitmap_bg_attributes_hbe_ptr& b)
Exchanges the contents of a sp_direct_bitmap_bg_attributes_hbe_ptr with those of another one.

Function documentation

static sp_direct_bitmap_bg_attributes_hbe_ptr bn::sp_direct_bitmap_bg_attributes_hbe_ptr::create(sp_direct_bitmap_bg_ptr bg, const span<const bitmap_bg_attributes>& attributes_ref)

Creates a sp_direct_bitmap_bg_attributes_hbe_ptr which changes the attributes to commit to the GBA register of a single page direct bitmap background in each screen horizontal line.

Parameters
bg Background to be modified.
attributes_ref Reference to an array of 160 bitmap_bg_attributes objects with the attributes to commit to the GBA register of the given background in each screen horizontal line.
Returns The requested sp_direct_bitmap_bg_attributes_hbe_ptr.

The attributes are not copied but referenced, so they should outlive the sp_direct_bitmap_bg_attributes_hbe_ptr to avoid dangling references.

static optional<sp_direct_bitmap_bg_attributes_hbe_ptr> bn::sp_direct_bitmap_bg_attributes_hbe_ptr::create_optional(sp_direct_bitmap_bg_ptr bg, const span<const bitmap_bg_attributes>& attributes_ref)

Creates a sp_direct_bitmap_bg_attributes_hbe_ptr which changes the attributes to commit to the GBA register of a single page direct bitmap background in each screen horizontal line.

Parameters
bg Background to be modified.
attributes_ref Reference to an array of 160 bitmap_bg_attributes objects with the attributes to commit to the GBA register of the given background in each screen horizontal line.
Returns The requested sp_direct_bitmap_bg_attributes_hbe_ptr if it could be allocated; bn::nullopt otherwise.

The attributes are not copied but referenced, so they should outlive the sp_direct_bitmap_bg_attributes_hbe_ptr to avoid dangling references.

span<const bitmap_bg_attributes> bn::sp_direct_bitmap_bg_attributes_hbe_ptr::attributes_ref() const

Returns the referenced array of 160 bitmap_bg_attributes objects with the attributes to commit to the GBA register of the managed background in each screen horizontal line.

The attributes are not copied but referenced, so they should outlive the sp_direct_bitmap_bg_attributes_hbe_ptr to avoid dangling references.

void bn::sp_direct_bitmap_bg_attributes_hbe_ptr::set_attributes_ref(const span<const bitmap_bg_attributes>& attributes_ref)

Sets the reference to an array of 160 bitmap_bg_attributes objects with the attributes to commit to the GBA register of the managed background in each screen horizontal line.

The attributes are not copied but referenced, so they should outlive the sp_direct_bitmap_bg_attributes_hbe_ptr to avoid dangling references.

void bn::sp_direct_bitmap_bg_attributes_hbe_ptr::reload_attributes_ref()

Rereads the content of the referenced attributes to the GBA register of the managed background in each screen horizontal line.

The attributes are not copied but referenced, so they should outlive the sp_direct_bitmap_bg_attributes_hbe_ptr to avoid dangling references.

void bn::sp_direct_bitmap_bg_attributes_hbe_ptr::swap(sp_direct_bitmap_bg_attributes_hbe_ptr& other)

Exchanges the contents of this sp_direct_bitmap_bg_attributes_hbe_ptr with those of the other one.

Parameters
other sp_direct_bitmap_bg_attributes_hbe_ptr to exchange the contents with.

void swap(sp_direct_bitmap_bg_attributes_hbe_ptr& a, sp_direct_bitmap_bg_attributes_hbe_ptr& b)

Exchanges the contents of a sp_direct_bitmap_bg_attributes_hbe_ptr with those of another one.

Parameters
a First sp_direct_bitmap_bg_attributes_hbe_ptr to exchange the contents with.
b Second sp_direct_bitmap_bg_attributes_hbe_ptr to exchange the contents with.