Struct rust_libretro::contexts::LoadGameSpecialContext

pub struct LoadGameSpecialContext<'a> {
    pub(crate) environment_callback: &'a retro_environment_t,
}

Functions that are safe to be called in Core::on_load_game_special

Fields

environment_callback: &'a retro_environment_t

Implementations

impl<'a> LoadGameSpecialContext<'a>

pub fn new(environment_callback: &'a retro_environment_t) -> Self

impl LoadGameSpecialContext<'_>

pub fn set_frame_time_callback(&self, data: retro_frame_time_callback) -> bool

Lets the core know how much time has passed since last invocation of Core::on_run. The frontend can tamper with the timing to fake fast-forward, slow-motion, frame stepping, etc. In this case the delta time will use the reference value in retro_frame_time_callback.

impl LoadGameSpecialContext<'_>

pub fn get_game_info_ext(&self) -> Option<retro_game_info_ext>

Allows an implementation to fetch extended game information, providing additional content path and memory buffer status details. This function may only be called inside Core::on_load_game or Core::on_load_game_special.

If callback returns false, extended game information is unsupported by the frontend. In this case, only regular retro_game_info will be available. get_game_info_ext is guaranteed to return true if set_content_info_override returns true.

‘data’ points to an array of [retro_game_info_ext structs].

For struct member descriptions, see the definition of struct retro_game_info_ext.

• If function is called inside Core::on_load_game, the retro_game_info_ext array is guaranteed to have a size of 1 - i.e. the returned pointer may be used to access directly the members of the first retro_game_info_ext struct, for example:

    struct retro_game_info_ext *game_info_ext;
    if (environ_cb(RETRO_ENVIRONMENT_GET_GAME_INFO_EXT, &game_info_ext))
     printf("Content Directory: %s\n", game_info_ext->dir);

• If the function is called inside Core::on_load_game_special, the retro_game_info_ext array is guaranteed to have a size equal to the num_info argument passed to Core::on_load_game_special

Trait Implementations

impl<'a> From<&'_ LoadGameSpecialContext<'a>> for GenericContext<'a>

fn from(other: &LoadGameSpecialContext<'a>) -> GenericContext<'a>

Performs the conversion.

impl<'a> From<&'_ mut LoadGameSpecialContext<'a>> for GenericContext<'a>

fn from(other: &mut LoadGameSpecialContext<'a>) -> GenericContext<'a>

Performs the conversion.