Class SceneTransitionService

Inheritance

Object

BaseService

BaseExtensionService

SceneTransitionService

Implements

ISceneTransitionService

IMixedRealityExtensionService

IMixedRealityService

IDisposable

Inherited Members

BaseExtensionService.Registrar

BaseService.DefaultPriority

BaseService.Name

BaseService.Priority

BaseService.ConfigurationProfile

BaseService.Reset()

BaseService.Update()

BaseService.LateUpdate()

BaseService.Disable()

BaseService.disposed

BaseService.Dispose()

BaseService.Dispose(Boolean)

Object.ToString()

Object.Equals(Object)

Object.Equals(Object, Object)

Object.ReferenceEquals(Object, Object)

Object.GetHashCode()

Object.GetType()

Object.MemberwiseClone()

Namespace: Microsoft.MixedReality.Toolkit.Extensions.SceneTransitions

Assembly: cs.temp.dll.dll

Syntax

public class SceneTransitionService : BaseExtensionService, ISceneTransitionService, IMixedRealityExtensionService, IMixedRealityService, IDisposable

Constructors

SceneTransitionService(IMixedRealityServiceRegistrar, String, UInt32, BaseMixedRealityProfile)

Constructor.

Declaration

[Obsolete("This constructor is obsolete (registrar parameter is no longer required) and will be removed in a future version of the Microsoft Mixed Reality Toolkit.")]
public SceneTransitionService(IMixedRealityServiceRegistrar registrar, string name, uint priority, BaseMixedRealityProfile profile)

Parameters

Type	Name	Description
IMixedRealityServiceRegistrar	registrar	The IMixedRealityServiceRegistrar instance that loaded the service.
String	name	Friendly name of the service.
UInt32	priority	Service priority. Used to determine order of instantiation.
BaseMixedRealityProfile	profile	The service's configuration profile.

SceneTransitionService(String, UInt32, BaseMixedRealityProfile)

Constructor.

Declaration

public SceneTransitionService(string name, uint priority, BaseMixedRealityProfile profile)

Parameters

Type	Name	Description
String	name	Friendly name of the service.
UInt32	priority	Service priority. Used to determine order of instantiation.
BaseMixedRealityProfile	profile	The service's configuration profile.

Properties

FadeColor

The color to use when fading out.

Declaration

public Color FadeColor { get; set; }

Property Value

Type	Description
Color

FadeInTime

The default time in seconds for fade in to complete.

Declaration

public float FadeInTime { get; set; }

Property Value

Type	Description
Single

FadeOutTime

The default time in seconds for fade out to complete.

Declaration

public float FadeOutTime { get; set; }

Property Value

Type	Description
Single

FadeTargets

Which cameras to target when fading.

Declaration

public CameraFaderTargets FadeTargets { get; set; }

Property Value

Type	Description
CameraFaderTargets

OnTransitionCompleted

Called when transition ends. This is called at the end of a transition, not at the end of a scene load. For scene load events, we recommend using IMixedRealitySceneSystem.

Declaration

public Action OnTransitionCompleted { get; set; }

Property Value

Type	Description
Action

OnTransitionStarted

Called when transition starts. This is called at the beginning of a transition, not at the beginning of a scene load. For scene load events, we recommend using IMixedRealitySceneSystem.

Declaration

public Action OnTransitionStarted { get; set; }

Property Value

Type	Description
Action

TransitionInProgress

True when a scene transition is in progress.

Declaration

public bool TransitionInProgress { get; set; }

Property Value

Type	Description
Boolean

TransitionProgress

From 0 to 1

Declaration

public float TransitionProgress { get; set; }

Property Value

Type	Description
Single

UseFadeColor

Whether to use a fade color during transitions.

Declaration

public bool UseFadeColor { get; set; }

Property Value

Type	Description
Boolean

Methods

Destroy()

Optional Destroy function to perform cleanup of the service before the Mixed Reality Toolkit is destroyed.

Declaration

public override void Destroy()

Overrides

BaseService.Destroy()

DoSceneTransition(IEnumerable<Func<Task>>, IProgressIndicator)

Fades out, enables progress indicator, execute scene operations in order, disables progress indicator, fades back in

Declaration

public Task DoSceneTransition(IEnumerable<Func<Task>> sceneOperations, IProgressIndicator progressIndicator = null)

Parameters

Type	Name	Description
IEnumerable<Func<Task>>	sceneOperations	A set of tasks from the Scene System.
IProgressIndicator	progressIndicator	If null, default progress indicator prefab will be used (or none if default is disabled in profile)

Returns

Type	Description
Task

DoSceneTransition(IEnumerable<Func<Task>>, Single, Single, IProgressIndicator)

Fades out, enables progress indicator, execute scene operations in order, disables progress indicator, fades back in

Declaration

public Task DoSceneTransition(IEnumerable<Func<Task>> sceneOperations, float fadeOutTime, float fadeInTime, IProgressIndicator progressIndicator = null)

Parameters

Type	Name	Description
IEnumerable<Func<Task>>	sceneOperations	A set of tasks from the Scene System.
Single	fadeOutTime	Overrides the default FadeOutTIme value.
Single	fadeInTime	Overrides the default FadeInTime value.
IProgressIndicator	progressIndicator	If null, default progress indicator prefab will be used (or none if default is disabled in profile)

Returns

Type	Description
Task

DoSceneTransition(Func<Task>, IProgressIndicator)

Fades out, enables progress indicator, execute scene operation, disables progress indicator, fades back in

Declaration

public Task DoSceneTransition(Func<Task> sceneOperation, IProgressIndicator progressIndicator = null)

Parameters

Type	Name	Description
Func<Task>	sceneOperation
IProgressIndicator	progressIndicator	If null, default progress indicator prefab will be used (or none if default is disabled in profile)

Returns

Type	Description
Task

DoSceneTransition(Func<Task>, Func<Task>, IProgressIndicator)

Fades out, enables progress indicator, executes scene op 1, executes scene op 2, disables progress indicator, fades back in

Declaration

public Task DoSceneTransition(Func<Task> sceneOp1, Func<Task> sceneOp2, IProgressIndicator progressIndicator = null)

Parameters

Type	Name	Description
Func<Task>	sceneOp1
Func<Task>	sceneOp2
IProgressIndicator	progressIndicator

Returns

Type	Description
Task

Enable()

Optional Enable function to enable / re-enable the service.

Declaration

public override void Enable()

Overrides

BaseService.Enable()

FadeIn()

Fades target cameras in. Instant fade-out will occur if fade state is not opaque. Can be used independently of scene transitions provided no transition is taking place. Uses default FadeInTime.

Declaration

public Task FadeIn()

Returns

Type	Description
Task

FadeIn(Single)

Fades target cameras in. Instant fade-out will occur if fade state is not opaque. Can be used independently of scene transitions provided no transition is taking place.

Declaration

public Task FadeIn(float fadeInTime)

Parameters

Type	Name	Description
Single	fadeInTime

Returns

Type	Description
Task

FadeOut()

Fades target cameras out to color. Can be used independently of scene transitions provided no transition is taking place. Uses default FadeOutTime.

Declaration

public Task FadeOut()

Returns

Type	Description
Task

FadeOut(Single)

Fades target cameras out to color. Can be used independently of scene transitions provided no transition is taking place.

Declaration

public Task FadeOut(float fadeOutTime)

Parameters

Type	Name	Description
Single	fadeOutTime

Returns

Type	Description
Task

HideProgressIndicator()

Hides the default progress indicator. Task completes when hide animation is done. Can be used independently of scene transitions provided no transition is taking place.

Declaration

public Task HideProgressIndicator()

Returns

Type	Description
Task

Initialize()

The initialize function is used to setup the service once created. This method is called once all services have been registered in the Mixed Reality Toolkit.

Declaration

public override void Initialize()

Overrides

BaseService.Initialize()

SetCustomFadeTargetCameras(IEnumerable<Camera>)

If FadeTargets is set to custom, you will need to provide a custom set of cameras for fading using this function PRIOR to calling DoSceneTransition.

Declaration

public void SetCustomFadeTargetCameras(IEnumerable<Camera> customFadeTargetCameras)

Parameters

Type	Name	Description
IEnumerable<Camera>	customFadeTargetCameras

SetProgressMessage(String)

Sets the message on displayed progress indicator. If no progress indicator exists, has no effect.

Declaration

public void SetProgressMessage(string message)

Parameters

Type	Name	Description
String	message

SetProgressValue(Single)

Sets progress to value from 0-1. If no progress indicator exists, has no effect.

Declaration

public void SetProgressValue(float progress)

Parameters

Type	Name	Description
Single	progress

ShowDefaultProgressIndicator()

Instantiates the default progress indicator and returns its main transform. Can be used independently of scene transitions provided no transition is taking place.

Declaration

public Transform ShowDefaultProgressIndicator()

Returns

Type	Description
Transform

Implements

ISceneTransitionService

IMixedRealityExtensionService

IMixedRealityService

System.IDisposable