Struct BasicData 

pub struct BasicData<A: ActionSet, T: Debug + 'static = ()> {
    pub font: FontAtlasDef,
    pub images: ImageTable,
    pub bundle: Bundle,
    pub own: T,
    /* private fields */
}

A game’s data on the short path: what the engine reads from the standard files, the files themselves and the game’s own part T. Its actions are A (most simply UiAction), its colours the engine’s.

Fields

font: FontAtlasDef

The font atlas.

images: ImageTable

Every picture of the bundle but the font’s.

bundle: Bundle

The bundle the data was read from: the pictures’ bytes.

own: T

The game’s own part.

Implementations

impl<A: ActionSet, T: Debug + 'static> BasicData<A, T>

pub fn formats() -> Formats

The formats it reads with: the engine’s standard ones, the palette with the engine’s colours and the font atlas with BASIC_GLYPHS in their place, the keymap of A and the English.

pub fn load( bundle: Bundle, console: ConsoleSpec, own: Own<T>, ) -> Result<Self, Vec<ContentError>>

The data in bundle, on console, with the game’s own part read by own; or every problem of every file at once, each naming its file.

Trait Implementations

impl<A: Debug + ActionSet, T: Debug + Debug + 'static> Debug for BasicData<A, T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<A: ActionSet, T: Debug + 'static> GameData for BasicData<A, T>

type Action = A

The game’s input actions.

type Colors = EngineColor

The colors the game’s code draws with.

type Voice = ()

Which of a voiced line’s clips plays.

type Settings = ()

The settings the game adds to the engine’s, and their saved form.

fn lang(&self) -> &Lang

The screen text by key, in every language.

fn keymap_def(&self) -> &KeymapDef<A>

The keymap file: every layout’s default keys, the layout picker’s and the controller buttons.

fn audio_manifest(&self) -> &AudioManifest

The sound and music cues.

fn palette_def(&self) -> &PaletteDef

The palette the game starts with, before the settings are read.

fn console(&self) -> ConsoleSpec

The console the game starts on (Ctx::console).

fn theme_def( &self, theme: <Self::Settings as GameSettings>::Theme, ) -> Option<&PaletteDef>

The palette of a color theme; None keeps the palette there is. By default the game has one palette: always None.

fn audio_config(&self) -> AudioConfig

Which of the game’s sound cues the engine’s widgets and screens play for a menu’s moves and choices and a cursor’s steps: by default the cues named after what they are (AudioConfig::DEFAULT).

fn debug_lang(&self) -> Option<&str>

The language only a build with debug tools shows (a test pack), if the game has one: without debug tools it is English.

fn key_text( &self, name: &str, keys: HelpKeys<'_, Self::Action>, ) -> Option<String>

The text of a {name} placeholder that names a key (Ctx::text_with): by default the cursor keys for {Cursor} and the key of the action called name (text::key_text); None leaves it as written.

fn voice_variant(&self) -> Self::Voice

Which clip of a line plays now, where a line has several (who the player made the hero, say). By default the variant’s default: a line’s only clip.

fn voices(&self, _manifest: &str) -> Result<Playable<Self::Voice>, String>

The clips that may be played, from the text of the voice manifest the platform read: those whose line still says what they say. Err says why the manifest can’t be used. By default the game has no voices, and a manifest is refused.

fn apply_settings( &mut self, _now: &Settings<Self::Settings>, _before: Option<&Settings<Self::Settings>>, )

Takes what the settings say that the game draws with (a map’s look, say): before is what they were (None when they were just loaded). The engine applies the theme itself.

fn blank_cell(&self, palette: &Palette) -> Cell

The cell the frame is cleared to before the screens draw: by default a blank in the engine’s text color on its panel color.

fn keys_before_profiles(&self) -> Vec<String>

The Storage keys the game kept a player’s data under before it had profiles: a first launch with profiles moves them into the first one (profiles::migrate). None by default.

fn old_layout_key(&self) -> Option<&'static str>

The Storage key a layout’s name was saved under before the settings held it, if the game had one: still read when the settings name none, never written.