UE3:SequenceOp (UDK): Difference between revisions

From Unreal Wiki, The Unreal Engine Documentation Site
No edit summary
 
m 1 revision: class descriptions for UDK January update (part 5)
 
(One intermediate revision by the same user not shown)
Line 28: Line 28:


'''Default value:''' True
'''Default value:''' True
====bHaveMovingOutputConnector====
'''Type:''' [[bool]]
'''[[Variables#Modifiers|Modifiers]]:''' transient, editoronly
True if there is currently moving output connector
====bHaveMovingVarConnector====
'''Type:''' [[bool]]
'''[[Variables#Modifiers|Modifiers]]:''' transient, editoronly
True if there is currently a moving variable connector


====bLatentExecution====
====bLatentExecution====
Line 35: Line 49:


Does this op use latent execution (can it stay active multiple updates?)
Does this op use latent execution (can it stay active multiple updates?)
====bPendingOutputConnectorRecalc====
'''Type:''' [[bool]]
'''[[Variables#Modifiers|Modifiers]]:''' transient, editoronly
True if there is a pending output connector position recalculation (I.E when a connector has just moved, or a connector as added or deleted
====bPendingVarConnectorRecalc====
'''Type:''' [[bool]]
'''[[Variables#Modifiers|Modifiers]]:''' transient, editoronly
True if there is a pending variable connector position recalculation (I.E when a connector has just moved, or a connector as added or deleted


====EventLinks====
====EventLinks====
'''Type:''' [[array]]<{{tl|SeqEventLink}}>
'''Type:''' [[array]]<{{tl|SeqEventLink||SequenceOp structs}}>


<!-- enter variable description -->
<!-- enter variable description -->
Line 49: Line 77:


====InputLinks====
====InputLinks====
'''Type:''' [[array]]<{{tl|SeqOpInputLink}}>
'''Type:''' [[array]]<{{tl|SeqOpInputLink||SequenceOp structs}}>


<!-- enter variable description -->
<!-- enter variable description -->
Line 55: Line 83:
'''Default value:'''  
'''Default value:'''  
{| class="list defaults"
{| class="list defaults"
! {{tl|SeqOpInputLink|||Member}}
! {{tl|SeqOpInputLink||SequenceOp structs|Member}}
! Value
! Value
|-
|-
Line 63: Line 91:


====OutputLinks====
====OutputLinks====
'''Type:''' [[array]]<{{tl|SeqOpOutputLink}}>
'''Type:''' [[array]]<{{tl|SeqOpOutputLink||SequenceOp structs}}>


<!-- enter variable description -->
<!-- enter variable description -->
Line 69: Line 97:
'''Default value:'''  
'''Default value:'''  
{| class="list defaults"
{| class="list defaults"
! {{tl|SeqOpOutputLink|||Member}}
! {{tl|SeqOpOutputLink||SequenceOp structs|Member}}
! Value
! Value
|-
|-
Line 91: Line 119:


====VariableLinks====
====VariableLinks====
'''Type:''' [[array]]<{{tl|SeqVarLink}}>
'''Type:''' [[array]]<{{tl|SeqVarLink||SequenceOp structs}}>


All variables used by this operation, both input/output.
All variables used by this operation, both input/output.


==Structs==
==Structs==
===SeqEventLink===
See {{cl|SequenceOp structs}}.
'''[[Structs#Modifiers|Modifiers]]:''' native
 
Represents an event linked to the operation, similar to a variable link.  Necessary
only since SequenceEvent does not derive from SequenceVariable.
 
'''Todo:''' native interfaces - could be avoided by using interfaces, but requires support for native interfaces
; [[class]]<{{cl|SequenceEvent}}> ExpectedType : <!-- enter variable description -->
; [[array]]<{{cl|SequenceEvent}}> LinkedEvents : <!-- enter variable description -->
; [[string]] LinkDesc : <!-- enter variable description -->
; [[int]] DrawX : <!-- enter variable description -->
; [[bool]] bHidden : <!-- enter variable description -->
 
'''Default values:'''
{| class="list defaults"
! Property
! Value
|-
| ExpectedType
| [[Types#Class|Class]]'{{cl|SequenceEvent|Engine}}'
|}
 
===SeqOpInputLink===
'''[[Structs#Modifiers|Modifiers]]:''' native
 
Represents an input link for a SequenceOp, that is
connected via another SequenceOp's output link.
; [[string]] LinkDesc : Text description of this link
; [[bool]] bHasImpulse : Indicates whether this input is ready to provide data to this sequence operation.
; [[int]] QueuedActivations : Number of activations received for this input when bHasImpulse == TRUE
; [[bool]] bDisabled : Is this link disabled for debugging/testing?
; [[bool]] bDisabledPIE : Is this link disabled for PIE?
; {{cl|SequenceOp}} LinkedOp : Linked action that creates this input, for Sequences
; [[int]] DrawY : <!-- enter variable description -->
; [[bool]] bHidden : <!-- enter variable description -->
; [[float]] ActivateDelay : <!-- enter variable description -->
 
===SeqOpOutputInputLink===
'''[[Structs#Modifiers|Modifiers]]:''' native
 
Individual output link entry, for linking an output link
to an input link on another operation.
; {{cl|SequenceOp}} LinkedOp : SequenceOp this is linked to
; [[int]] InputLinkIdx : Index to LinkedOp's InputLinks array that this is linked to
 
===SeqOpOutputLink===
'''[[Structs#Modifiers|Modifiers]]:''' native
 
Actual output link for a SequenceOp, containing connection
information to multiple InputLinks in other SequenceOps.
; [[array]]<{{tl|SeqOpOutputInputLink}}> Links : List of actual connections for this output
; [[string]] LinkDesc : Text description of this link
; [[bool]] bHasImpulse : Indicates whether this link is pending activation.  If true, the SequenceOps attached to this
link will be activated the next time the sequence is ticked
; [[bool]] bDisabled : Is this link disabled for debugging/testing?
; [[bool]] bDisabledPIE : Is this link disabled for PIE?
; {{cl|SequenceOp}} LinkedOp : Linked op that creates this output, for Sequences
; [[float]] ActivateDelay : Delay applied before activating this output
; [[int]] DrawY : <!-- enter variable description -->
; [[bool]] bHidden : <!-- enter variable description -->
 
===SeqVarLink===
'''[[Structs#Modifiers|Modifiers]]:''' native
 
Represents a variable linked to the operation for manipulation upon
activation.
; [[class]]<{{cl|SequenceVariable}}> ExpectedType : Class of variable that can be attached to this connector.
; [[array]]<{{cl|SequenceVariable}}> LinkedVariables : SequenceVariables that we are linked to.
; [[string]] LinkDesc : Text description of this variable's use with this op
; [[name]] LinkVar : Name of the linked external variable that creates this link, for sub-Sequences
; [[name]] PropertyName : Name of the property this variable is associated with
; [[bool]] bWriteable : Is this variable written to by this op?
; [[bool]] bModifiesLinkedObject : do the object(s) pointed to by this variable get modified by this op? (ignored if not an object variable)
; [[bool]] bHidden : Should draw this connector in Kismet.
; [[int]] MinVars : Minimum number of variables that should be attached to this connector.
; [[int]] MaxVars : Maximum number of variables that should be attached to this connector.
; [[int]] DrawX : For drawing.
; {{cl|Property}} CachedProperty : Cached property ref
; [[bool]] bAllowAnyType : Does this link support any type of property?
 
'''Default values:'''
{| class="list defaults"
! Property
! Value
|-
| ExpectedType
| [[Types#Class|Class]]'{{cl|SequenceVariable|Engine}}'
|-
| MaxVars
| 255
|-
| MinVars
| 1
|}


==Functions==
==Functions==

Latest revision as of 05:47, 17 January 2010

UDK Object >> SequenceObject >> SequenceOp
Package:
Engine
Direct subclasses:
Sequence, SequenceAction, SequenceCondition, SequenceEvent
This class in other games:

Base class of any sequence object that can be executed, such as SequenceAction, SequenceCondtion, etc.

Properties

ActivateCount

Type: int

Modifiers: transient

Number of times that this Op has had Activate called on it. Used for finding often-hit ops and optimising levels.

bActive

Type: bool

Is this operation currently active?

bAutoActivateOutputLinks

Type: bool

indicates whether all output links should be activated when this op has finished executing

Default value: True

bHaveMovingOutputConnector

Type: bool

Modifiers: transient, editoronly

True if there is currently moving output connector

bHaveMovingVarConnector

Type: bool

Modifiers: transient, editoronly

True if there is currently a moving variable connector

bLatentExecution

Type: bool

Modifiers: const

Does this op use latent execution (can it stay active multiple updates?)

bPendingOutputConnectorRecalc

Type: bool

Modifiers: transient, editoronly

True if there is a pending output connector position recalculation (I.E when a connector has just moved, or a connector as added or deleted

bPendingVarConnectorRecalc

Type: bool

Modifiers: transient, editoronly

True if there is a pending variable connector position recalculation (I.E when a connector has just moved, or a connector as added or deleted

EventLinks

Type: array<SeqEventLink>


GamepadID

Type: byte

Modifiers: transient, noimport

The ControllerId for the player that generated this action; generally only relevant in UI sequences.

InputLinks

Type: array<SeqOpInputLink>


Default value:

Member Value
LinkDesc "In"

OutputLinks

Type: array<SeqOpOutputLink>


Default value:

Member Value
LinkDesc "Out"

PlayerIndex

Type: int

Modifiers: transient, noimport

The index [into the Engine.GamePlayers array] for the player that this action is associated with. Currently only used in UI sequences.

SearchTag

Type: int

Modifiers: transient, duplicatetransient, const, protected

used when searching for objects to avoid unnecessary recursion

VariableLinks

Type: array<SeqVarLink>

All variables used by this operation, both input/output.

Structs

See SequenceOp structs.

Functions

Iterator functions

LinkedVariables

native noexport final iterator function LinkedVariables (class<SequenceVariableVarClass, out SequenceVariable OutVariable, optional string InDesc)

returns all linked variables that are of the specified class or a subclass

Parameters:

  • VarClass - the class of variable to return
  • OutVariable - out) the returned variable for each iteration
  • InDesc - optional) if specified, only variables connected to the link with the given description are returned

Fixme: localization

Native functions

ActivateNamedOutputLink

native final function bool ActivateNamedOutputLink (string LinkDesc)

Activates an output link by searching for the one with a matching LinkDesc.

Parameters:

  • LinkDesc - the string used as the value for LinkDesc of the output link to activate.

Returns:

TRUE if the link was found and activated.

ActivateOutputLink

native final function bool ActivateOutputLink (int OutputIdx)

Activates an output link by index

Parameters:

  • OutputIdx - output index to set impulse on (if it's not disabled)

ForceActivateInput

native final function ForceActivateInput (int InputIdx)


GetBoolVars

native noexport final function GetBoolVars (out array<byteboolVars, optional string inDesc) const


GetInterpDataVars

native noexport final function GetInterpDataVars (out array<InterpDataoutIData, optional string inDesc)

Retrieve list of UInterpData objects connected to this sequence op.

GetLinkedObjects

native final function GetLinkedObjects (out array<SequenceObjectout_Objects, optional class<SequenceObjectObjectType, optional bool bRecurse)

Gets all SequenceObjects that are contained by this SequenceObject.

Parameters:

  • out_Objects - will be filled with all ops that are linked to this op via the VariableLinks, OutputLinks, or InputLinks arrays. This array is NOT cleared first.
  • ObjectType - if specified, only objects of this class (or derived) will be added to the output array.
  • bRecurse - if TRUE, recurse into linked ops and add their linked ops to the output array, recursively.

GetObjectVars

native noexport final function GetObjectVars (out array<ObjectobjVars, optional string inDesc) const

Returns all the objects linked via SeqVar_Object, optionally specifying the link to filter by.

Fixme: localization

HasLinkedOps

native final function bool HasLinkedOps (optional bool bConsiderInputLinks) const

Determines whether this sequence op is linked to any other sequence ops through its variable, output, event or (optionally) its input links.

Parameters:

  • bConsiderInputLinks - specify TRUE to check this sequence ops InputLinks array for linked ops as well

Returns:

TRUE if this sequence op is linked to at least one other sequence op.

PopulateLinkedVariableValues

native final virtual function PopulateLinkedVariableValues ()

Copies the values from member variables contained by this sequence op into any VariableLinks attached to that member variable.

PublishLinkedVariableValues

native final virtual function PublishLinkedVariableValues ()

Copies the values from all VariableLinks to the member variable [of this sequence op] associated with that VariableLink.

Events

Activated

event Activated ()

Called when this event is activated.

Deactivated

event Deactivated ()

Called when this event is deactivated.

VersionUpdated

event VersionUpdated (int OldVersion, int NewVersion)

Called when the version is updated, in case any special handling is desired script-side.

Other instance functions

GetController

function Controller GetController (Actor TheActor)

utility to try to get a Controller out of the given Actor (tries looking for a Pawn if necessary)

GetPawn

function Pawn GetPawn (Actor TheActor)

utility to try to get a Pawn out of the given Actor (tries looking for a Controller if necessary)

Reset

function Reset ()