UInkThread Class Reference

Base class for all ink threads. More...

#include <InkThread.h>

Inheritance diagram for UInkThread:

Public Member Functions
void	Yield ()
	Yields the thread immediately.
bool	IsYielding ()
	Checks if the thread is stopped.
void	Resume ()
	Resumes yielded thread.
void	Stop ()
	Kills thread at next possible moment.
AInkRuntime *	GetRuntime () const
	Access runtime the thread belongs to.
void	OnStartup ()
	triggered after initializing the runner
void	OnLineWritten (const FString &line, const UTagList *tags)
	triggered if a new line of context is available
void	OnKnotEntered (const UTagList *global_tags, const UTagList *knot_tags)
	triggered if a knew knot/stitch is entered (tunneling is ignored).
void	OnTag (const FString &tag_name)
	triggered when a tag is encountered
void	OnChoice (const TArray< UInkChoice * > &choices)
	triggered when reached a choice point.
void	OnShutdown ()
	triggered when the thread reached the end of context
bool	PickChoice (int index)
	picks a choice to continue with
void	RegisterTagFunction (FName functionName, const FTagFunctionDelegate &function)
	Register a callback for a named "tag function".
void	RegisterExternalFunction (const FString &functionName, const FExternalFunctionDelegate &function, bool lookaheadSafe=false)
	register a external function.
void	RegisterExternalEvent (const FString &functionName, const FExternalFunctionVoidDelegate &function, bool lookaheadSafe=false)
	register external event.
const UTagList *	GetKnotTags ()
	get knots assoziated with current knot.
const UTagList *	GetGlobalTags ()
	get global tags.

Friends
class	AInkRuntime

Detailed Description

Base class for all ink threads.

Member Function Documentation

GetGlobalTags()

const UTagList * UInkThread::GetGlobalTags

(

)

get global tags.

global tags are tags listed at the top of the file before the first line of content

Get Global Tags

Target

Return Value

GetKnotTags()

const UTagList * UInkThread::GetKnotTags

(

)

get knots assoziated with current knot.

knot tags are tags listed behind a knot == knot name == before the first line of content

Get Knot Tags

Target

Return Value

GetRuntime()

AInkRuntime * UInkThread::GetRuntime ( ) const

inline

Access runtime the thread belongs to.

Returns

runtime of the thread

Get Runtime

Target

Return Value

IsYielding()

bool UInkThread::IsYielding

(

)

Checks if the thread is stopped.

Return values

true	if the thread currently waiting to resume

See also

Yield() Resume()

Is Yielding

Target

Return Value

OnChoice()

void UInkThread::OnChoice

(

const TArray< UInkChoice * > &

choices

)

triggered when reached a choice point.

Parameters

choices

possible branches to choose from, in order to continue

See also

PickChoice()

Event OnChoice

Choices

OnKnotEntered()

void UInkThread::OnKnotEntered	(	const UTagList *	global_tags,
		const UTagList *	knot_tags )

triggered if a knew knot/stitch is entered (tunneling is ignored).

Triggers before the first line of a knot/stitch is written

Parameters

global_tags	tags assoziated with global file
knot_tags	tags assoziated with the current knot/stitch

Event OnKnotEntered

Global tags

Knot tags

OnLineWritten()

void UInkThread::OnLineWritten	(	const FString &	line,
		const UTagList *	tags )

triggered if a new line of context is available

Parameters

line	text of new line
tags	tags associated with this line

Event OnLineWritten

Line

Tags

OnShutdown()

void UInkThread::OnShutdown

(

)

triggered when the thread reached the end of context

See also

AInkRuntime::StartExisting()

Event OnShutdown

OnStartup()

void UInkThread::OnStartup

(

)

triggered after initializing the runner

Event OnStartup

OnTag()

void UInkThread::OnTag

(

const FString &

tag_name

)

triggered when a tag is encountered

Parameters

tag_name

the tag found

Event OnTag

Tag name

PickChoice()

bool UInkThread::PickChoice

(

int

index

)

picks a choice to continue with

See also

UInkChoice::GetIndex()

Return values

false

if the index is out of range

Pick Choice

Target

Index

0

Return Value

RegisterExternalEvent()

void UInkThread::RegisterExternalEvent	(	const FString &	functionName,
		const FExternalFunctionVoidDelegate &	function,
		bool	lookaheadSafe = false )

register external event.

A event has the return type void.

See also

If you want to return a value use RegisterExternalFunction()

Register External Event

Target

Function Name

Function

Lookahead Safe

RegisterExternalFunction()

void UInkThread::RegisterExternalFunction	(	const FString &	functionName,
		const FExternalFunctionDelegate &	function,
		bool	lookaheadSafe = false )

register a external function.

A function provides a return value

See also

if you do not want to return something RegisterExternalEvent()

Register External Function

Target

Function Name

Function

Lookahead Safe

RegisterTagFunction()

void UInkThread::RegisterTagFunction	(	FName	functionName,
		const FTagFunctionDelegate &	function )

Register a callback for a named "tag function".

See also

TagFunction

Register Tag Function

Target

Function Name

Function

Resume()

void UInkThread::Resume

(

)

Resumes yielded thread.

See also

Yield()

Resume

Target

Stop()

void UInkThread::Stop

(

)

Kills thread at next possible moment.

Stop

Target

Yield()

void UInkThread::Yield

(

)

Yields the thread immediately.

This will stop the execution (after finishing the current line). until Resume() is called.

Yield() and Resume() working with a reference counter. therefore a thread can be yield multiple times, and must then be resumed the same amount.

Yield

Target

---

The documentation for this class was generated from the following file:

• unreal/inkcpp/Source/inkcpp/Public/InkThread.h