Struct Dat 

pub struct Dat { /* private fields */ }

Represents a DAT audio configuration file decoded in memory.

Contains six blocks of audio event configuration data including parameters, enumerations, and event lists used to configure Wwise sound playback.

Structure

The file is organized into six sequential blocks, each serving a different purpose in the audio configuration system. The exact semantic meaning of each block may vary between Total War games.

Fields

• event_0 - Event parameters with float values (e.g., volume, pitch defaults)
• block_1 - Event enumerations with multiple values (e.g., sound categories)
• block_2 - Event enumerations with multiple values (e.g., sound categories)
• voice_events - Voice event enumerations with associated values
• block_4 - Simple event enumeration list
• block_5 - Simple event enumeration list

Examples

let dat = Dat::decode(&mut data, &None)?;

// Iterate through event parameters
for (name, value) in dat.event_0() {
    println!("Parameter: {} = {}", name, value);
}

// Iterate through voice events
for (voice_event, voice_values) in dat.voice_events() {
    for value in voice_values {
        println!("  {} -> {}", voice_event, value);
    }
}

Implementations

impl Dat

pub fn event_0(&self) -> &Vec<(String, f32)>

Event parameters with floating-point values.

Maps event parameter names to their default float values. Typically used for parameters like volume, pitch, or other numeric settings.

pub fn block_1(&self) -> &Vec<(String, Vec<String>)>

Event enumerations with string lists.

Maps enumeration names to lists of possible string values. Used for categorical audio properties.

pub fn block_2(&self) -> &Vec<(String, Vec<String>)>

Event enumerations with string lists.

Maps enumeration names to lists of possible string values. Similar to block_1, potentially for different enumeration categories.

pub fn voice_events(&self) -> &Vec<(String, Vec<String>)>

Voice event enumerations with string lists.

Maps voice event names to lists of possible voice event values. Used for categorizing and organizing voice-related audio events.

pub fn block_4(&self) -> &Vec<String>

Simple event enumeration list.

List of event enumeration names without associated values. FIXME: Possible wrong implementation.

pub fn block_5(&self) -> &Vec<String>

Simple event enumeration list.

List of event enumeration names without associated values. Similar to block_4, potentially for a different category.

impl Dat

pub fn event_0_mut(&mut self) -> &mut Vec<(String, f32)>

Event parameters with floating-point values.

Maps event parameter names to their default float values. Typically used for parameters like volume, pitch, or other numeric settings.

pub fn block_1_mut(&mut self) -> &mut Vec<(String, Vec<String>)>

Event enumerations with string lists.

Maps enumeration names to lists of possible string values. Used for categorical audio properties.

pub fn block_2_mut(&mut self) -> &mut Vec<(String, Vec<String>)>

Event enumerations with string lists.

Maps enumeration names to lists of possible string values. Similar to block_1, potentially for different enumeration categories.

pub fn voice_events_mut(&mut self) -> &mut Vec<(String, Vec<String>)>

Voice event enumerations with string lists.

Maps voice event names to lists of possible voice event values. Used for categorizing and organizing voice-related audio events.

pub fn block_4_mut(&mut self) -> &mut Vec<String>

Simple event enumeration list.

List of event enumeration names without associated values. FIXME: Possible wrong implementation.

pub fn block_5_mut(&mut self) -> &mut Vec<String>

Simple event enumeration list.

List of event enumeration names without associated values. Similar to block_4, potentially for a different category.

impl Dat

pub fn set_event_0(&mut self, val: Vec<(String, f32)>) -> &mut Self

Event parameters with floating-point values.

Maps event parameter names to their default float values. Typically used for parameters like volume, pitch, or other numeric settings.

pub fn set_block_1(&mut self, val: Vec<(String, Vec<String>)>) -> &mut Self

Event enumerations with string lists.

Maps enumeration names to lists of possible string values. Used for categorical audio properties.

pub fn set_block_2(&mut self, val: Vec<(String, Vec<String>)>) -> &mut Self

Event enumerations with string lists.

Maps enumeration names to lists of possible string values. Similar to block_1, potentially for different enumeration categories.

pub fn set_voice_events(&mut self, val: Vec<(String, Vec<String>)>) -> &mut Self

Voice event enumerations with string lists.

Maps voice event names to lists of possible voice event values. Used for categorizing and organizing voice-related audio events.

pub fn set_block_4(&mut self, val: Vec<String>) -> &mut Self

Simple event enumeration list.

List of event enumeration names without associated values. FIXME: Possible wrong implementation.

pub fn set_block_5(&mut self, val: Vec<String>) -> &mut Self

Simple event enumeration list.

List of event enumeration names without associated values. Similar to block_4, potentially for a different category.

Trait Implementations

impl Clone for Dat

fn clone(&self) -> Dat

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Dat

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

Formats the value using the given formatter.

impl Decodeable for Dat

fn decode<R: ReadBytes>( data: &mut R, _extra_data: &Option<DecodeableExtraData<'_>>, ) -> Result<Self>

Decodes binary data into the implementing type.

impl Default for Dat

fn default() -> Dat

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Dat

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Encodeable for Dat

fn encode<W: WriteBytes>( &mut self, buffer: &mut W, _extra_data: &Option<EncodeableExtraData<'_>>, ) -> Result<()>

Encodes the implementing type into binary data.

impl PartialEq for Dat

fn eq(&self, other: &Dat) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Dat

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Dat