Class in

Inherits from System.Object

An abstract class that represents some content that is shown to the player.

This class is used, rather than the runtime classes Yarn.Line or Yarn.OptionSet, because when the program is being analysed, no values for any substitutions are available. Instead, these classes represent the data that is available offline.

Property in

Gets a descriptive name for the block.

If this block begins at a labelled instruction, the name will be [NodeName].[LabelName] . Otherwise, it will be [NodeName].[FirstInstructionIndex] .

Enumeration Member in

Enumeration Member in

The Destination is reached beacuse of an explicit instruction to go to this block.

Property in

Gets all descendants (that is, destinations, and destinations of those destinations, and so on), recursively.

Cycles are detected and avoided.

Method in

Property in

Gets all descendants (that is, destinations, and destinations of those destinations, and so on) that have any player-visible content, recursively.

Cycles are detected and avoided.

Field in

The text of the command.

Class in

Inherits from

A command that will be executed.

Property in

The condition that causes this destination to be reached.

Enumeration Member in Condition

Summary

The Destination is reached because the preceding BasicBlock reached the end of its execution, and the Destination's target is the block immediately following.

Fallthrough

Property in Destination

Summary

The block that this destination refers to.

public BasicBlock Block { get; set; }

Remarks

This value is only valid when Type is Block .

Enumeration Member in Condition

Summary

The Destination is reached because the player made an in-game choice to go to it.

Option

Property in BasicBlock

Summary

Gets the index of the first instruction of the node that this block is in.

public int FirstInstructionIndex { get; set; }

Enumeration Member in DestinationType

Summary

Node

Property in BasicBlock

Summary

Gets the collection of player-visible content that will be delivered when this block is run.

public IEnumerable<PlayerVisibleContentElement> PlayerVisibleContent
{
            get; }

Remarks

Player-visible content means lines, options and commands. When this block is run, the entire contents of this collection will be displayed to the player, in the same order as they appear in this collection.

If this collection is empty, then the block contains no visible content. This is the case for blocks that only contain logic, and do not contain any lines, options or commands.

To tell the difference between the different kinds of content, use the is operator to check the type of each item:

Property in Destination

Summary

The name of the node that this destination refers to.

public string NodeName { get; set; }

Remarks

This value is only valid when Type is Node .

Field in Option

Summary

The string table ID that will be shown to the player.

public string LineID;

Field in LineElement

Summary

The string table ID of the line that will be shown to the player.

public string LineID;

Property in Destination

Summary

Gets the Destination's type - whether the destination is a block, or a node.

public DestinationType Type { get; set; }

Property in BasicBlock

Summary

Gets the Instructions that form this block.

public IEnumerable<Instruction> Instructions { get; set; };

Field in Option

Summary

The destination that will be run if this option is selected by the player.

public string Destination;

Remarks

This will be the name of a label, or the name of a node.

Enumeration Member in Condition

Summary

The Destination is reached because an expression evaluated to false.

ExpressionIsFalse

Method in BasicBlock

Summary

Adds a new destination to this block, that points to a node.

public void AddDestination(string nodeName, Condition condition)

Parameters

Class in BasicBlock

Inherits from PlayerVisibleContentElement

Summary

A collection of options that should be shown to the player.

public class OptionsElement : PlayerVisibleContentElement

Fields

Structs

Struct in OptionsElement

Inherits from System.ValueType

Summary

Represents a single option that may be presented to the player.

public struct Option

Fields

Struct in

Inherits from System.ValueType

A destination represents a or node that may be run, following the execution of a .

Destination objects represent links between blocks, or between blocks and nodes.

Class in

Inherits from

A line of dialogue that should be shown to the player.

Property in

Gets the name of the label that this block begins at, or null if this basic block does not begin at a labelled instruction.

Field in

The collection of options that will be delivered to the player.

Property in

Gets the destinations of this block - that is, blocks or nodes that may run immediately after this block.

• : A destination represents a or node that may be run, following the execution of a .

Method in BasicBlock

Summary

Adds a new destination to this block, that points to another block.

public void AddDestination(BasicBlock descendant, Condition condition)

Parameters

Property in

Get the ancestors of this block - that is, blocks that may run immediately before this block.

Enum in Destination

Inherits from System.Enum

Summary

The type of a Destination.

public enum DestinationType
{
    Node,
    Block
}

Members

Property in

Gets the name of the node that this block is in.

Class in Yarn.Compiler

Inherits from System.Object

Summary

A basic block is a run of instructions inside a Node. Basic blocks group instructions up into segments such that execution only ever begins at the start of a block (that is, a program never jumps into the middle of a block), and execution only ever leaves at the end of a block.

public class BasicBlock

Classes

Enum in BasicBlock

Inherits from System.Enum

Summary

The conditions under which a Destination may be reached at the end of a BasicBlock.

public enum Condition
{
    Fallthrough,
    DirectJump,
    ExpressionIsTrue,
    ExpressionIsFalse,
    Option
}

Members

Enumeration Member in

The Destination is reached because an expression evaluated to true.