Summary

Contains classes for working with compiled Yarn programs.

Classes

Property in

Gets the type representing strings.

Property in FunctionType

Summary

Gets a more verbose description of this type.

public string Description
{
            get; set; }

Property in Dialogue

Summary

Gets or sets the CommandHandler that is called when a command is to be delivered to the game.

public CommandHandler CommandHandler
{
            get; set; }

Property in FunctionType

Summary

Gets the parent of this type.

public IType Parent { get; }

Remarks

All types have Any as their ultimate parent type (except for Any itself.)

Property in FunctionType

Summary

Gets the name of this type.

public string Name { get; }

Delegate in Yarn

Inherits from System.MulticastDelegate

Summary

Represents the method that is called when the Dialogue delivers a Command .

public delegate void CommandHandler(Command command);

Parameters

• : Represents the method that is called when the Dialogue delivers a .

• : Represents the method that is called when the Dialogue delivers an .

• : Represents the method that is called when the Dialogue begins executing a node.

Method in Dialogue

Summary

Loads the nodes from the specified Program , and adds them to the nodes already loaded.

public void AddProgram(Program program)

Remarks

If Yarn.Dialogue.Program is null , this method has the effect as calling SetProgram(Program) .

Parameters

Constructor in Dialogue

Summary

Initializes a new instance of the Dialogue class.

public Dialogue(Yarn.IVariableStorage variableStorage)

Parameters

Property in

Gets or sets the that is called when a set of options are ready to be shown to the user.

The Options Handler delivers an to the game. Before can be called to resume execution, must be called to indicate which was selected by the user. If is not called, an exception is thrown.

Class in

Inherits from System.Object

Contains the built-in types available in the Yarn language.

Method in

Returns the string ID that contains the original, uncompiled source text for a node.

A node's source text will only be present in the string table if its tags header contains rawText.

Because the class is designed to be unaware of the contents of the string table, this method does not test to see if the string table contains an entry with the line ID. You will need to test for that yourself.

Property in

Gets the collection of methods that are available on this type.

Class in

Inherits from System.Exception

An exception that is thrown by when there is an error in executing a .

Property in

Gets the list of the parameter types that this function is called with.

The length of this list also determines the number of parameters this function accepts (also known as the function's arity ).

Property in

Gets the type representing numbers.

Method in

Immediately stops the .

The will not be called if the dialogue is ended by calling .

Method in

Method in

Method in

Method in

Method in

Property in

Gets the type of value that this function returns.

Method in

Gets a value indicating whether this contains a function named name .

Property in BuiltinTypes

Summary

Gets the type representing boolean values.

public static IType Boolean { get; };

Field in Line

Summary

The values that should be inserted into the user-facing text before delivery.

public string[] Substitutions;

Field in Line

Summary

The string ID for this line.

public string ID;

Method in Library

Summary

Removes a function from the Library.

public void DeregisterFunction(string name)

Remarks

If no function with the given name is present in the Library, this method does nothing.

Parameters

Class in

Inherits from System.Object

A type that represents functions.

Functions have parameters and a return type, and can be called from script. Instances of this type are created when the host application registers new functions (such as through using the methods or similar.)

Method in

Stores a bool in this VariableStorage.

Method in Library

Summary

Registers a new function that returns a value, which can be called from a Yarn program.

public void RegisterFunction<T1, TResult>(string name, Func<T1, TResult> implementation)

Parameters

Method in

Retrieves a value of type T by name.

Class in Yarn

Inherits from System.Object

Summary

A simple concrete implementation of IVariableStorage that keeps all variables in memory.

public class MemoryVariableStore : IVariableStorage

Methods

Class in Yarn

Inherits from System.Object

Summary

Co-ordinates the execution of Yarn programs.

public class Dialogue : IAttributeMarkerProcessor

Constructors

Property in

Method in

Constructor in

Constructor in

Method in Dialogue

Summary

Starts, or continues, execution of the current Program.

public void Continue()

Remarks

This method repeatedly executes instructions until one of the following conditions is encountered:

• The LineHandler or CommandHandler is called. After calling either of these handlers, the Dialogue will wait until Continue() is called. Continue may be called from inside the LineHandler or CommandHandler, or may be called at any future time.

• The is called. When this occurs, the Dialogue is waiting for the user to specify which of the options has been selected, and must be called before is called again.)

• The Program reaches its end. When this occurs, must be called before is called again.

• An error occurs while executing the Program.

This method has no effect if it is called while the is currently in the process of executing instructions.

• : Represents the method that is called when the Dialogue delivers a .

• : Represents the method that is called when the Dialogue delivers an .

• : Represents the method that is called when the Dialogue delivers a .

Method in IVariableStorage

Summary

Stores a string in this VariableStorage.

void SetValue(string variableName, string stringValue);

Parameters

Delegate in

Inherits from System.MulticastDelegate

Represents a method that receives diagnostic messages and error information from a .

The text that this delegate receives may be output to a console, or sent to a log.

Property in

Gets the text of the command.

Field in

The node that execution will start from.

Method in Dialogue

Summary

Prepares the Dialogue that the user intends to start running a node.

public void SetNode(string startNode = DefaultStartNodeName)

Remarks

After this method is called, you call Continue() to start executing it.

If PrepareForLinesHandler has been set, it may be called when this method is invoked, as the Dialogue determines which lines may be delivered during the startNode node's execution.

Parameters

Property in

Gets or sets the 's locale, as an IETF BCP 47 code.

This code is used to determine how the plural and ordinal markers determine the plural class of numbers.

For example, the code "en-US" represents the English language as used in the United States.

Method in

Unloads all nodes from the Dialogue.

Property in

Method in

Removes all variables from storage.

Property in

Gets or sets the that is called when the dialogue reaches its end.

Method in Dialogue

Summary

Signals to the Dialogue that the user has selected a specified Option .

public void SetSelectedOption(int selectedOptionID)

Remarks

After the Dialogue delivers an OptionSet, this method must be called before Continue() is called.

The ID number that should be passed as the parameter to this method should be the ID field in the Option that represents the user's selection.

Parameters

• : Represents the method that is called when the Dialogue delivers an .

• : A set of s, sent from the to the game.

• : Starts, or continues, execution of the current Program.

Property in Dialogue

Summary

Invoked when the Dialogue needs to report debugging information.

public Logger LogDebugMessage { get; set; }

Interface in Yarn

Summary

Provides a mechanism for storing and retrieving instances of the Yarn.Value class.

public interface IVariableStorage

Methods

Property in

Gets or sets the that is called when a line is ready to be shown to the user.

Property in

Method in Library

Summary

Registers a new function that returns a value, which can be called from a Yarn program.

public void RegisterFunction<T1, T2, T3, T4, T5, TResult>(string name, Func<T1, T2, T3, T4, T5, TResult> implementation)

Parameters

Method in Library

Summary

Registers a new function that returns a value, which can be called from a Yarn program.

public void RegisterFunction<T1, T2, TResult>(string name, Func<T1, T2, TResult> implementation)

Parameters

Struct in Yarn

Inherits from System.ValueType

Summary

A line of dialogue, sent from the Dialogue to the game.

public struct Line

Remarks

When the game receives a Line, it should do the following things to prepare the line for presentation to the user.

1. Use the value in the ID field to look up the appropriate user-facing text in the string table.

2. Use to replace all substitutions in the user-facing text.

3. Use to parse all markup in the line.

You do not create instances of this struct yourself. They are created by the during program execution.

• : Gets or sets the that is called when a line is ready to be shown to the user.

Property in

Gets or sets the object that provides access to storing and retrieving the values of variables.

Method in Dialogue

Summary

Returns the tags for the node nodeName .

public IEnumerable<string> GetTagsForNode(string nodeName)

Remarks

The tags for a node are defined by setting the tags header in the node's source code. This header must be a space-separated list.

Parameters

The node's tags, or null if the node is not present in the Program.

Property in Dialogue

Summary

Gets or sets the NodeCompleteHandler that is called when a node is complete.

public NodeCompleteHandler NodeCompleteHandler
{
            get; set; }

Method in Dialogue

Summary

Replaces all substitution markers in a text with the given substitution list.

public static string ExpandSubstitutions(string text, IList<string> substitutions)

Remarks

This method replaces substitution markers - for example, {0}

• with the corresponding entry in substitutions . If text contains a substitution marker whose index is not present in substitutions , it is ignored.

Parameters

text , with the content from substitutions inserted.

Property in

Gets the parent of this type.

All types have as their ultimate parent type (except for itself.)

Method in IVariableStorage

Summary

Stores a bool in this VariableStorage.

void SetValue(string variableName, bool boolValue);

Parameters

Property in

Gets the names of the nodes in the currently loaded Program.

Method in Dialogue

Summary

Parses a line of text, and produces a MarkupParseResult containing the results.

public MarkupParseResult ParseMarkup(string line)

Remarks

The MarkupParseResult 's Text will have any select , plural or ordinal markers replaced with the appropriate text, following this Dialogue 's LanguageCode .

Parameters

The results of parsing the markup.

Method in

Method in

Delegate in Yarn

Inherits from System.MulticastDelegate

Summary

Represents the method that is called when the dialogue has reached its end, and no more code remains to be run.

public delegate void DialogueCompleteHandler();

See Also

• LineHandler: Represents the method that is called when the Dialogue delivers a Line .

• : Represents the method that is called when the Dialogue delivers an .

• : Represents the method that is called when the Dialogue delivers a .

• : Represents the method that is called when the Dialogue begins executing a node.

• : Represents the method that is called when the Dialogue reaches the end of a node.

Method in Dialogue

Summary

Gets a value indicating whether a specified node exists in the Program.

Parameters

Returns

true if a node named nodeName exists in the Program, false otherwise.

Method in

Removes all variables from storage.

Method in Library

Summary

Returns a System.Delegate with a given name.

public Delegate GetFunction(string name)

Parameters

The System.Delegate .

Method in IVariableStorage

Summary

Stores a float in this VariableStorage.

void SetValue(string variableName, float floatValue);

Parameters

Property in Dialogue

Summary

Gets the Library that this Dialogue uses to locate functions.

public Library Library { get; internal set; }

Remarks

When the Dialogue is constructed, the Library is initialized with the built-in operators like + , - , and so on.

Property in Dialogue

Summary

Gets or sets the PrepareForLinesHandler that is called when the dialogue anticipates delivering some lines.

public PrepareForLinesHandler PrepareForLinesHandler
{
            get; set; }

Property in IType

Summary

Gets a more verbose description of this type.

string Description { get; }

Property in BuiltinTypes

Summary

Gets a dictionary that maps CLR types to their corresponding Yarn types.

public static IReadOnlyDictionary<System.Type, Yarn.IType> TypeMappings { get; };

Method in Library

Summary

Generates a unique tracking variable name. This is intended to be used to generate names for visting. Ideally these will very reproduceable and sensible. For now it will be something terrible and easy.

Parameters

Returns

The new variable name.

Method in

Registers a new function that returns a value, which can be called from a Yarn program.

Method in

Registers a new function that returns a value, which can be called from a Yarn program.

Field in

Field number for the "key" field.

Property in

Gets the name of this type.

Property in

Gets the type representing any value.

Interface in Yarn

Summary

Defines properties that describe a type in the Yarn language.

public interface IType

Properties

Class in

Inherits from System.Object

Property in

Method in Library

Summary

Registers a new function that returns a value, which can be called from a Yarn program.

public void RegisterFunction<T1, T2, T3, TResult>(string name, Func<T1, T2, T3, TResult> implementation)

Parameters

Struct in Yarn

Inherits from System.ValueType

Summary

A command, sent from the Dialogue to the game.

public struct Command

Remarks

You do not create instances of this struct yourself. They are created by the Dialogue during program execution.

Properties

• : Gets or sets the that is called when a command is to be delivered to the game.

Method in Library

Summary

Registers a new function that returns a value, which can be called from a Yarn program.

public void RegisterFunction<T1, T2, T3, T4, TResult>(string name, Func<T1, T2, T3, T4, TResult> implementation)

Parameters

Class in Yarn

Inherits from System.Object

Summary

A collection of functions that can be called from Yarn programs.

public class Library

Remarks

You do not create instances of this class yourself. The Dialogue class creates one of its own, which you can access via the Library property.

Methods

• : Co-ordinates the execution of Yarn programs.

Delegate in Yarn

Inherits from System.MulticastDelegate

Summary

Represents the method that is called when the Dialogue delivers a Line .

public delegate void LineHandler(Line line);

Parameters

• : Represents the method that is called when the Dialogue delivers an .

• : Represents the method that is called when the Dialogue delivers a .

• : Represents the method that is called when the Dialogue begins executing a node.

Property in

Gets a value indicating whether the Dialogue is currently executing Yarn instructions.

Property in

Gets the name of the node that this Dialogue is currently executing.

If has never been called, this value will be null .

Property in

Invoked when the Dialogue needs to report an error.

Method in

Method in Library

Summary

Loads functions from another Library .

public void ImportLibrary(Library otherLibrary)

Remarks

If the other library contains a function with the same name as one in this library, the function in the other library takes precedence.

Parameters

Field in

Field number for the "value" field.

Property in

Gets the collection of methods that are available on this type.

Method in Dialogue

Summary

Loads all nodes from the provided Program .

public void SetProgram(Program program)

Remarks

This method replaces any existing nodes have been loaded. If you want to load nodes from an additional Program, use the AddProgram(Program) method.

Parameters

Property in

Gets or sets the that is called when a node is started.