UE3:UIScene properties (UDK)

Properties

Property group 'Animation'

SceneAnimation_Close

Type: name

the name of the animation sequence to play when the scene is closed

SceneAnimation_LoseFocus

Type: name

the name of the animation sequence to play when this scene opens another scene (and thus, becomes the background for the new scene, in at least in cases where the new scene has bRenderParentScenes set

SceneAnimation_Open

Type: name

the name of the animation sequence to play when the scene is opened

SceneAnimation_RegainedFocus

Type: name

the name of the animation sequence to play when the scene is about to become the active scene due to another scene closing

SceneAnimation_RegainingFocus

Type: name

the name of the animation sequence to play when the topmost scene has just begun its closing animation, and this scene will become the next topmost scene

Property group 'Controls'

DefaultContextMenuClass

Type: class<UIContextMenu>

Modifiers: const

The UIContextMenu class to use for the StandardContextMenu

Default value: Class'Engine.UIContextMenu'

Property group 'Flags'

bAlwaysRenderScene

Type: bool

Overrides the setting of bRenderParentScenes for any scenes higher in the stack

bCaptureMatchedInput

Type: bool

Indicates whether this scene should capture all input which wasn't processed by the scene. Only relevant for scenes with an input mode of INPUTMODE_MatchingOnly (all other input modes capture all input anyway).

Default value: True

bCloseOnLevelChange

Type: bool

Indicates whether the the scene should close itself when the level changes. This is useful for when you have a main menu and want to make certain it is closed when ever you switch to a new level.

Default value: True

bDisableWorldRendering

Type: bool

Displayed as: Disable World Rendering

TRUE to disable world rendering while this scene is active

bDisplayCursor

Type: bool

Controls whether the cursor is shown while this scene is active. Interactive scenes such as menus will generally want this enabled, while non-interactive scenes, such as the HUD generally want it disabled.

Todo: this bool may be unnecessary, since we can establish whether a scene should process mouse input by looking at the input events for the widgets of this scene; if any process any of the mouse keys (MouseX, MouseY, RMB, LMB, MMB, etc.) or if the scene can be a drop target, then this scene needs to process mouse input, and should probably display a cursor.... hmmm need to think about this assumption a bit more before implementing this

Default value: True

bEnableSceneDepthTesting

Type: bool

Controls whether depth testing is enabled for this scene. If TRUE then the 2d ui items are depth tested against the 3d ui scene

bExemptFromAutoClose

Type: bool

If true this scene is exempted from Auto closuer when a scene above it closes

bFlushPlayerInput

Type: bool

Displayed as: Flush Input

TRUE to flush all player input when this scene is opened.

Default value: True

bMenuLevelRestoresScene

Type: bool

TRUE indicates that this scene can be automatically reopened when the user returns to the main front-end menu.

bPauseGameWhileActive

Type: bool

Indicates whether the game should be paused while this scene is active.

Default value: True

bRenderParentScenes

Type: bool

Controls whether the scenes underneath this scene are rendered.

bRequiresNetwork

Type: bool

TRUE to indicate that this scene requires a valid network connection in order to be opened. If no network connection is available, the scene will be closed.

bRequiresOnlineService

Type: bool

Set to TRUE to indicate that the user must be signed into an online service (for example, Windows live) in order to view this scene. If the user is not signed into an online service, the scene will be closed.

bSaveSceneValuesOnClose

Type: bool

Indicates whether the scene should have its widgets save their values to the datastore on close.

Default value: True

Property group 'Interaction'

SceneInputMode

Type: UIRoot.EScreenInputMode

Modifiers: private

Controls how this scene responds to input from multiple players.

Default value: INPUTMODE_Locked

SceneRenderMode

Type: UIRoot.ESplitscreenRenderMode

Modifiers: protected

Controls how this scene will be rendered when split-screen is active.

Default value: SPLITRENDER_PlayerOwner

Property group 'PostProcess'

bEnableScenePostProcessing

Type: bool

Controls whether post-processing is enabled for this scene.

ScenePostProcessGroup

Type: UIRoot.EUIPostProcessGroup

Ordering of post process effects applied. UIPostProcess_None - No post process pass for the UI Scene UIPostProcess_Background - Only UIPostProcessBackground renders before the UI Scene UIPostProcess_Foreground - Only UIPostProcessForeground renders after the UI Scene UIPostProcess_BackgroundAndForeground - Both UIPostProcessBackground/UIPostProcessForeground render for the UI Scene

UIPostProcessBackground

Type: PostProcessChain

Post process applied to background before rendering the UI.

UIPostProcessForeground

Type: PostProcessChain

Post process applied after rendering the UI.

Property group 'Sound'

SceneClosedCue

Type: name

this sound is played when this scene is deactivated

Default value: 'SceneClosed'

SceneOpenedCue

Type: name

this sound is played when this scene is activated

Default value: 'SceneOpened'

Property group 'Style'

SceneSkin

Type: UISkin

Modifiers: const, editinlineuse

Provides a way to force this scene to use a specific skin. Useful for transitions between front-end and HUD scenes, for example.

Property group 'UIScene'

SceneStackPriority

Type: int

Sorting priority; when scenes are opened, they are placed in the stack at the location where all scenes have a SceneStackPriority less than or equal to this one. By default, the scene is placed at the top of the scene stack.

Default value: 10

SceneTag

Type: name

Modifiers: editconst

Semi-unique non-localized name for this scene which is used to reference the scene from unrealscript. For scenes which are gametype specific, each scene may wish to use the same SceneName (for example, if each game had a single scene which represented the HUD for that gametype, all of the HUD scenes might use "HUDScene" as their SceneName, so that the current game's HUD scene can be referenced using "HUDScene" regardless of which type of hud it is)

Internal variables

ActiveContextMenu

Type: UIContextMenu

Modifiers: const, transient, private

The context menu currently being displayed or pending display.

AnimatingObjects

Type: array<UIScreenObject>

Modifiers: transient, private

List of widgets in this scene that are currently animating.

bAnimationBlockingInput

Type: bool

Modifiers: transient, private

Indicates that an animation is playing which should block input.