All pages
Powered by GitBook
1 of 17

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

fadeDownDuration

Field in LinePresenter

Summary

The time that the fade effect will take to fade lines out.

Remarks

This value is only used when useFadeEffect is true .

See Also

  • LinePresenter.useFadeEffect: Controls whether the line view should fade in when lines appear, and fade out when lines disappear.

fadeUpDuration

Field in LinePresenter

Summary

The time that the fade effect will take to fade lines in.

Remarks

This value is only used when useFadeEffect is true .

See Also

  • LinePresenter.useFadeEffect: Controls whether the line view should fade in when lines appear, and fade out when lines disappear.

autoAdvanceDelay

Field in LinePresenter

Summary

The amount of time after the line finishes appearing before automatically ending the line, in seconds.

public float autoAdvanceDelay = 1f;

Remarks

This value is only used when autoAdvance is true .

lettersPerSecond

Field in LinePresenter

Summary

The number of characters per second that should appear during a typewriter effect.

public int lettersPerSecond = 60;

characterNameText

Field in LinePresenter

Summary

The TMPro.TMP_Text object that displays the character names found in dialogue lines.

public TMP_Text? characterNameText = null;

Remarks

If the LinePresenter receives a line that does not contain a character name, this object will be left blank.

lineText

Field in LinePresenter

Summary

The TMPro.TMP_Text object that displays the text of dialogue lines.

public TMP_Text? lineText;

customTypewriter

Field in LinePresenter

Summary

public UnityEngine.Object? customTypewriter;

characterNameContainer

Field in LinePresenter

Summary

The game object that holds the characterNameText text field.

public GameObject? characterNameContainer = null;

Remarks

This is needed in situations where the character name is contained within an entirely different game object. Most of the time this will just be the same game object as characterNameText .

OnDialogueCompleteAsync()

Method in LinePresenter

Summary

Called by the DialogueRunner to signal that the dialogue has ended, and no more lines will be delivered.

Remarks

This method is called after the last piece of content (that is, lines, options or commands) finished running.

This method is a good place to perform tasks like dismissing on-screen dialogue UI (for example, turning off a letterboxing effect, or hiding dialogue UI elements.)

The default implementation of this method does nothing.

Returns

A task that represents any work done by this dialogue presenter in order to clean up after running dialogue.

OnDialogueStartedAsync()

Method in LinePresenter

Summary

Called by the DialogueRunner to signal that dialogue has started.

Remarks

This method is called before any content (that is, lines, options or commands) are delivered.

This method is a good place to perform tasks like preparing on-screen dialogue UI (for example, turning on a letterboxing effect, or making dialogue UI elements visible.)

The default implementation of this method does nothing.

Returns

A task that represents any work done by this dialogue presenter in order to get ready for dialogue to run.

wordsPerSecond

Field in LinePresenter

Summary

public int wordsPerSecond = 10;
public float fadeDownDuration = 0.1f;
public float fadeUpDuration = 0.25f;
public override YarnTask OnDialogueCompleteAsync()
public override YarnTask OnDialogueStartedAsync()

autoAdvance

Field in LinePresenter

Summary

Controls whether this Line View will automatically tell the Dialogue Runner that the line is complete as soon as the line has finished appearing.

public bool autoAdvance = false;

Remarks

If this value is true, the Line View will

The will not proceed to the next piece of content (e.g. the next line, or the next options) until all Dialogue Presenters have reported that they have finished presenting their lines. If a doesn't report that it's finished until it receives input, the will end up pausing.

This is useful for games in which you want the player to be able to read lines of dialogue at their own pace, and give them control over when to advance to the next line.

showCharacterNameInLine

Field in LinePresenter

Summary

Controls whether the lineText object will show the character name present in the line or not.

public bool showCharacterNameInLine = true;

Remarks

This value is only used if is null.

If this value is true, any character names present in a line will be shown in the lineText object.

If this value is false, character names will not be shown in the lineText object.

useFadeEffect

Field in LinePresenter

Summary

Controls whether the line view should fade in when lines appear, and fade out when lines disappear.

public bool useFadeEffect = true;

Remarks

If this value is true, the canvasGroup object's alpha property will animate from 0 to 1 over the course of fadeUpDuration seconds when lines appear, and animate from 1 to zero over the course of fadeDownDuration seconds when lines disappear.

If this value is false, the canvasGroup object will appear instantaneously.

See Also

  • LinePresenter.canvasGroup: The canvas group that contains the UI elements used by this Line View.

  • : The time that the fade effect will take to fade lines in.

  • : The time that the fade effect will take to fade lines out.

RunLineAsync(LocalizedLine,LineCancellationToken)

Method in LinePresenter

Summary

Presents a line using the configured text view.

public override async YarnTask RunLineAsync(LocalizedLine line, LineCancellationToken token)

Parameters

Name
Description

line

The line to present.

token

A task that completes when the dialogue presenter has finished showing the line to the user.

canvasGroup

Field in

The canvas group that contains the UI elements used by this Line View.

If is true, then the alpha value of this UnityEngine.CanvasGroup will be animated during line presentation and dismissal.

  • : Controls whether the line view should fade in when lines appear, and fade out when lines disappear.

LinePresenter.fadeUpDuration
LinePresenter.fadeDownDuration
DialogueRunner
LinePresenter
DialogueRunner
characterNameText

Summary

Remarks

See Also

LinePresenter
useFadeEffect
LinePresenter.useFadeEffect
public CanvasGroup? canvasGroup;

A that represents whether the dialogue presenter should hurry it its presentation of the line, or stop showing the current line.

Returns

Yarn.Unity.LocalizedLine
Yarn.Unity.LineCancellationToken
LineCancellationToken

LinePresenter

Class in Yarn.Unity

Inherits from DialoguePresenterBase

Summary

A Dialogue Presenter that presents lines of dialogue, using Unity UI elements.

public sealed class LinePresenter : DialoguePresenterBase

Fields

Name
Description

Name
Description

Controls whether this Line View will automatically to the Dialogue Runner that the line is complete as soon as the line has finished appearing.

The amount of time after the line finishes appearing before automatically ending the line, in seconds.

The canvas group that contains the UI elements used by this Line View.

The game object that holds the text field.

The TMPro.TMP_Text object that displays the character names found in dialogue lines.

The time that the fade effect will take to fade lines out.

The time that the fade effect will take to fade lines in.

The number of characters per second that should appear during a typewriter effect.

The TMPro.TMP_Text object that displays the text of dialogue lines.

Controls whether the object will show the character name present in the line or not.

Controls whether the line view should fade in when lines appear, and fade out when lines disappear.

Called by the to signal that the dialogue has ended, and no more lines will be delivered.

Called by the to signal that dialogue has started.

Methods

autoAdvance

Presents a line using the configured text view.

autoAdvanceDelay
canvasGroup
characterNameContainer
characterNameText
characterNameText
customTypewriter
fadeDownDuration
fadeUpDuration
lettersPerSecond
lineText
showCharacterNameInLine
lineText
useFadeEffect
wordsPerSecond
OnDialogueCompleteAsync()
DialogueRunner
OnDialogueStartedAsync()
DialogueRunner
RunLineAsync(LocalizedLine,LineCancellationToken)