We've moved!

Starting from MRTK 2.6, we are publishing both conceptual docs and API references on docs.microsoft.com. For conceptual docs, please visit our new landing page. For API references, please visit the MRTK-Unity section of the dot net API explorer. Existing content will remain here but will not be updated further.

    Show / Hide Table of Contents

    Interface IMixedRealityBoundarySystem

    Manager interface for a Boundary system in the Mixed Reality Toolkit All replacement systems for providing Boundary functionality should derive from this interface

    Inherited Members
    IMixedRealityEventSystem.EventListeners
    IMixedRealityEventSystem.HandleEvent<T>(BaseEventData, ExecuteEvents.EventFunction<T>)
    IMixedRealityEventSystem.Register(GameObject)
    IMixedRealityEventSystem.Unregister(GameObject)
    IMixedRealityEventSystem.RegisterHandler<T>(IEventSystemHandler)
    IMixedRealityEventSystem.UnregisterHandler<T>(IEventSystemHandler)
    IMixedRealityService.Name
    IMixedRealityService.Priority
    IMixedRealityService.ConfigurationProfile
    IMixedRealityService.Initialize()
    IMixedRealityService.Reset()
    IMixedRealityService.Enable()
    IMixedRealityService.Update()
    IMixedRealityService.LateUpdate()
    IMixedRealityService.Disable()
    IMixedRealityService.Destroy()
    IMixedRealityEventSource.SourceId
    IMixedRealityEventSource.SourceName
    Namespace: Microsoft.MixedReality.Toolkit.Boundary
    Assembly: cs.temp.dll.dll
    Syntax
    public interface IMixedRealityBoundarySystem : IMixedRealityEventSystem, IMixedRealityService, IDisposable, IMixedRealityEventSource, IEqualityComparer

    Properties

    BoundaryHeight

    The height of the play space, in meters.

    Declaration
    float BoundaryHeight { get; set; }
    Property Value
    Type Description
    Single
    Remarks

    This is used to create a three dimensional boundary volume.

    BoundaryVisualizationProfile

    Typed representation of the ConfigurationProfile property.

    Declaration
    MixedRealityBoundaryVisualizationProfile BoundaryVisualizationProfile { get; }
    Property Value
    Type Description
    MixedRealityBoundaryVisualizationProfile

    BoundaryWallsPhysicsLayer

    The physics layer that the generated boundary walls are assigned to.

    Declaration
    int BoundaryWallsPhysicsLayer { get; set; }
    Property Value
    Type Description
    Int32

    Bounds

    Two dimensional representation of the geometry of the boundary, as provided by the platform.

    Declaration
    Edge[] Bounds { get; }
    Property Value
    Type Description
    Edge[]
    Remarks

    BoundaryGeometry should be treated as the outline of the player's space, placed on the floor.

    CeilingPhysicsLayer

    The physics layer that the generated boundary ceiling is assigned to.

    Declaration
    int CeilingPhysicsLayer { get; set; }
    Property Value
    Type Description
    Int32

    FloorHeight

    Indicates the height of the floor, in relation to the coordinate system origin.

    Declaration
    float? FloorHeight { get; }
    Property Value
    Type Description
    Nullable<Single>
    Remarks

    If a floor has been located, FloorHeight.HasValue will be true, otherwise it will be false.

    FloorPhysicsLayer

    The physics layer that the generated floor is assigned to.

    Declaration
    int FloorPhysicsLayer { get; set; }
    Property Value
    Type Description
    Int32

    PlayAreaPhysicsLayer

    The physics layer that the generated play area is assigned to.

    Declaration
    int PlayAreaPhysicsLayer { get; set; }
    Property Value
    Type Description
    Int32

    Scale

    The scale (ex: World Scale) of the experience.

    Declaration
    ExperienceScale Scale { get; set; }
    Property Value
    Type Description
    ExperienceScale

    ShowBoundaryCeiling

    Enable / disable ceiling rendering.

    Declaration
    bool ShowBoundaryCeiling { get; set; }
    Property Value
    Type Description
    Boolean
    Remarks

    The ceiling is defined as a GameObject positioned BoundaryHeight above the floor.

    ShowBoundaryWalls

    Enable / disable boundary wall rendering.

    Declaration
    bool ShowBoundaryWalls { get; set; }
    Property Value
    Type Description
    Boolean

    ShowFloor

    Enable / disable floor rendering.

    Declaration
    bool ShowFloor { get; set; }
    Property Value
    Type Description
    Boolean

    ShowPlayArea

    Enable / disable play area rendering.

    Declaration
    bool ShowPlayArea { get; set; }
    Property Value
    Type Description
    Boolean

    ShowTrackedArea

    Enable / disable tracked area rendering.

    Declaration
    bool ShowTrackedArea { get; set; }
    Property Value
    Type Description
    Boolean

    TrackedAreaPhysicsLayer

    The physics layer that the generated tracked area is assigned to.

    Declaration
    int TrackedAreaPhysicsLayer { get; set; }
    Property Value
    Type Description
    Int32

    Methods

    Contains(Vector3, BoundaryType)

    Determines if a location is within the specified area of the boundary space.

    Declaration
    bool Contains(Vector3 location, BoundaryType boundaryType = BoundaryType.TrackedArea)
    Parameters
    Type Name Description
    Vector3 location

    The location to be checked.

    BoundaryType boundaryType

    The type of boundary space being checked.

    Returns
    Type Description
    Boolean

    True if the location is within the specified area of the boundary space.

    Remarks

    Use: BoundaryType.PlayArea for the inscribed volume BoundaryType.TrackedArea for the area defined by the boundary edges.

    GetBoundaryCeilingVisualization()

    Gets the GameObject that represents the upper surface of the user's boundary.

    Declaration
    GameObject GetBoundaryCeilingVisualization()
    Returns
    Type Description
    GameObject

    The boundary ceiling visualization object or null if one does not exist.

    GetBoundaryWallVisualization()

    Gets the GameObject that represents the user's boundary walls.

    Declaration
    GameObject GetBoundaryWallVisualization()
    Returns
    Type Description
    GameObject

    The boundary wall visualization object or null if one does not exist.

    GetFloorVisualization()

    Gets the GameObject that represents the user's floor.

    Declaration
    GameObject GetFloorVisualization()
    Returns
    Type Description
    GameObject

    The floor visualization object or null if one does not exist.

    GetPlayAreaVisualization()

    Gets the GameObject that represents the user's play area.

    Declaration
    GameObject GetPlayAreaVisualization()
    Returns
    Type Description
    GameObject

    The play area visualization object or null if one does not exist.

    GetTrackedAreaVisualization()

    Gets the GameObject that represents the user's tracked area.

    Declaration
    GameObject GetTrackedAreaVisualization()
    Returns
    Type Description
    GameObject

    The tracked area visualization object or null if one does not exist.

    TryGetRectangularBoundsParams(out Vector2, out Single, out Single, out Single)

    Returns the description of the inscribed rectangular bounds.

    Declaration
    bool TryGetRectangularBoundsParams(out Vector2 center, out float angle, out float width, out float height)
    Parameters
    Type Name Description
    Vector2 center

    The center of the rectangle.

    Single angle

    The orientation of the rectangle.

    Single width

    The width of the rectangle.

    Single height

    The height of the rectangle.

    Returns
    Type Description
    Boolean

    True if an inscribed rectangle was found in the boundary geometry, false otherwise.

    Back to top Generated by DocFX