Struct ds_rom::rom::Arm9

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

ARM9 program.

Implementations

impl<'a> Arm9<'a>

pub fn new<T: Into<Cow<'a, [u8]>>>( data: T, header_version: HeaderVersion, offsets: Arm9Offsets, ) -> Self

Creates a new ARM9 program from raw data.

pub fn with_two_tcms( data: Vec<u8>, itcm: Autoload<'_>, dtcm: Autoload<'_>, header_version: HeaderVersion, offsets: Arm9Offsets, ) -> Result<Self, RawBuildInfoError>

Creates a new ARM9 program with raw data and two autoloads (ITCM and DTCM).

Errors

See Self::build_info_mut.

pub fn is_encrypted(&self) -> bool

Returns whether the secure area is encrypted.

pub fn decrypt( &mut self, key: &BlowfishKey, gamecode: u32, ) -> Result<(), Arm9Error>

Decrypts the secure area. Does nothing if already decrypted.

Errors

This function will return an error if the program is too small to contain a secure area, Blowfish::decrypt fails or “encryObj” was not found.

pub fn encrypt( &mut self, key: &BlowfishKey, gamecode: u32, ) -> Result<(), Arm9Error>

Encrypts the secure area. Does nothing if already encrypted.

Errors

This function will return an error if the program is too small to contain a secure area, or the secure area ID was not found.

pub fn encrypted_secure_area( &self, key: &BlowfishKey, gamecode: u32, ) -> [u8; 16384]

Returns an encrypted copy of the secure area.

pub fn secure_area_crc(&self, key: &BlowfishKey, gamecode: u32) -> u16

Returns a CRC checksum of the encrypted secure area.

pub fn build_info(&self) -> Result<&BuildInfo, RawBuildInfoError>

Returns a reference to the build info.

Errors

See BuildInfo::borrow_from_slice.

pub fn build_info_mut(&mut self) -> Result<&mut BuildInfo, RawBuildInfoError>

Returns a mutable reference to the build info.

Errors

See BuildInfo::borrow_from_slice_mut.

pub fn is_compressed(&self) -> Result<bool, RawBuildInfoError>

Returns whether this ARM9 program is compressed.

Errors

See Self::build_info.

pub fn decompress(&mut self) -> Result<(), Arm9Error>

Decompresses this ARM9 program. Does nothing if already decompressed.

Errors

See Self::is_compressed and Self::build_info_mut.

pub fn compress(&mut self) -> Result<(), Arm9Error>

Compresses this ARM9 program. Does nothing if already compressed.

Errors

See Self::is_compressed, Lz77::compress and Self::build_info_mut.

pub fn autoload_infos(&self) -> Result<&[AutoloadInfo], Arm9AutoloadError>

Returns the autoload infos of this Arm9.

Errors

This function will return an error if Self::build_info or Self::get_autoload_infos fails or this ARM9 program is compressed.

pub fn autoloads(&self) -> Result<Box<[Autoload<'_>]>, Arm9AutoloadError>

Returns the autoloads of this Arm9.

Errors

This function will return an error if Self::build_info or Self::get_autoload_infos fails or this ARM9 program is compressed.

pub fn code(&self) -> Result<&[u8], RawBuildInfoError>

Returns the code of this ARM9 program.

Errors

See Self::build_info.

pub fn full_data(&self) -> &[u8]

Returns a reference to the full data.

pub fn base_address(&self) -> u32

Returns the base address.

pub fn entry_function(&self) -> u32

Returns the entry function address.

pub fn build_info_offset(&self) -> u32

Returns the build info offset.

pub fn autoload_callback(&self) -> u32

Returns the autoload callback address.

pub fn bss(&self) -> Result<Range<u32>, RawBuildInfoError>

Returns the Range of uninitialized data in this ARM9 program.

Errors

See Self::build_info.

pub fn offsets(&self) -> &Arm9Offsets

Returns a reference to the ARM9 offsets.

Trait Implementations

impl<'a> AsRef<[u8]> for Arm9<'a>

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl<'a> Clone for Arm9<'a>

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

Returns a copy of the value.

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

Performs copy-assignment from source.