Struct DlgNode 

pub struct DlgNode {

    pub animations: Vec<DlgAnimation>,
    pub text: GffLocalizedString,
    pub script: ResRef,
    pub speaker: String,
    pub wait_flags: u32,
    pub quest: String,
    pub quest_entry: u32,
    pub plot_index: i32,
    pub plot_xp_percentage: f32,
    pub delay: u32,
    pub fade_type: u8,
    pub fade_color: [f32; 3],
    pub fade_delay: f32,
    pub fade_length: f32,
    pub sound: ResRef,
    pub vo_resref: ResRef,
    pub sound_exists: u8,
    pub listener: String,
    pub camera_angle: u32,
    pub camera_id: i32,
    pub cam_height_offset: f32,
    pub tar_height_offset: f32,
    pub camera_animation: u16,
    pub cam_vid_effect: i32,
    pub cam_field_of_view: f32,
    pub links: Vec<DlgLink>,
}

A dialogue node (entry = NPC line, reply = PC choice).

Entry and reply nodes share the same field layout. The difference is which link list they carry: entry nodes have RepliesList, reply nodes have EntriesList. The Dlg struct handles serializing the correct field name based on position.

Fields

animations: Vec<DlgAnimation>

Lip-sync animations (AnimList).

text: GffLocalizedString

Localized display text (Text).

script: ResRef

Script to run when this node fires (Script).

speaker: String

Speaker tag override (Speaker). Vanilla leaves the label out where it would be the empty string the read substitutes.

wait_flags: u32

Wait flags (WaitFlags).

quest: String

Journal quest tag (Quest).

quest_entry: u32

Journal quest entry ID (QuestEntry).

plot_index: i32

Plot index (PlotIndex).

plot_xp_percentage: f32

Plot XP percentage (PlotXPPercentage).

delay: u32

Delay in milliseconds (Delay). The sentinel value 0xFFFFFFFF instructs the engine to read from the root delay_entry / delay_reply instead and modulate wait_flags. With no sound and parent delay 0, the node terminates instantly.

fade_type: u8

Fade type (FadeType).

fade_color: [f32; 3]

Fade color as RGB floats (FadeColor). GFF Vector3 type. Discarded if FadeType is 0.

fade_delay: f32

Fade delay in seconds (FadeDelay). Discarded if FadeType is 0.

fade_length: f32

Fade length in seconds (FadeLength). Discarded if FadeType is 0.

sound: ResRef

Sound resref (Sound). If playback fails, the engine falls back to vo_resref.

vo_resref: ResRef

Voice-over resref (VO_ResRef). Played as a fallback when sound fails to execute.

sound_exists: u8

Sound-presence bitmask (SoundExists).

A bitmask rather than a flag, which is why it is a byte. An absent one resolves to SOUND_EXISTS_ABSENT, a value a boolean could not carry, and the engine forces it to 0 at runtime when both Sound and VO_ResRef fail to resolve.

listener: String

Listener tag override (Listener).

camera_angle: u32

Camera angle preset (CameraAngle).

camera_id: i32

Static camera ID (CameraID). Ignored by engine unless CameraAngle is 6.

cam_height_offset: f32

Camera height offset (CamHeightOffset).

tar_height_offset: f32

Target height offset (TarHeightOffset).

camera_animation: u16

Camera animation ID (CameraAnimation).

cam_vid_effect: i32

Camera video effect (CamVidEffect).

cam_field_of_view: f32

Camera field of view (CamFieldOfView). Aggressively validated; the engine forces this to -1.0 if the field is missing or explicitly negative.

links: Vec<DlgLink>

Links to the next nodes. For entry nodes these point into ReplyList; for reply nodes they point into EntryList.

No #[gff], because the label is the list’s rather than this type’s: it is declared on DlgNodeRepliesTail and DlgNodeEntriesTail, and both codec halves are this type’s for the same reason.

Implementations

impl DlgNode

pub const SCHEMA: [Field; 26]

This view’s schema, one entry per declared field.

pub const PARTS: &'static [&'static [Field]]

This type’s schema in parts, which is what a container holding it references.

Own fields first, then one part per flattened child in the order they are declared.

pub fn read_declared(root: &GffStruct) -> Self

Reads every declared field off root.

Absent fields take the entry’s own answer, so a fallback is derived from the declaration rather than restated beside it.

A field declaring a hand-written read is left at that answer for the view to overwrite.

pub fn write_declared(&self, root: &mut GffStruct)

Writes every declared field onto root, leaving out the ones their entry says the engine’s own writer leaves out.

A field declaring a hand-written write is not touched here.

pub fn read_element(structure: &GffStruct) -> Self

Reads one element of a list of this type.

pub fn write_element(&self, structure: &mut GffStruct)

Writes one element of a list of this type.

Trait Implementations

impl Clone for DlgNode

fn clone(&self) -> DlgNode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DlgNode

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

Formats the value using the given formatter.

impl Default for DlgNode

fn default() -> Self

What a file omitting every label loads to, which is what makes an authored file land in a known state rather than at zero.

impl HasSchema for DlgNode

fn schema() -> &'static [Field]

The root field schema for this resource type.

fn parts() -> &'static [&'static [Field]]

The same schema in parts, own fields first.

impl PartialEq for DlgNode

fn eq(&self, other: &DlgNode) -> 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 StructuralPartialEq for DlgNode