Difference between revisions of "IWorldspaceSystem"
From Virtual World Web Wiki
(Documentation for the IWorldspaceSystem class) |
(Documentation for the IWorldspaceSystem class) |
||
Line 10: | Line 10: | ||
===Methods=== | ===Methods=== | ||
− | :{{CSharp| | + | :{{CSharp|void ActivateLayerVersion(Guid layerVersionID)}} |
− | + | :: | |
− | : | + | ::Makes the specified version of a layer the active version. Live instances will update to reflect the change. |
− | + | ||
− | : | + | |
− | :{{CSharp| | + | :{{CSharp|void AttachLayer(Guid layerID, Guid areaID)}} |
− | + | ||
− | + | ||
:: | :: | ||
− | :: | + | ::Attaches a layer to an area (part of worldspace), usually a scene |
− | :{{CSharp| | + | :{{CSharp|Guid CloneLayer(Guid layerID, Guid sceneID, bool activeVersionOnly {{=}} false, bool cloneContainers {{=}} true)}} |
:: | :: | ||
− | :: | + | ::Clones a layer and optionally its versions and containers as well. |
− | :{{CSharp|Guid | + | :{{CSharp|Guid CloneLayerVersion(Guid layerVersionID, string name)}} |
:: | :: | ||
− | :: | + | ::Clones an existing layer version. |
− | :{{CSharp| | + | :{{CSharp|Guid CloneScene(Guid sceneID, string newAlias, string newName, bool cloneContainers, bool cloneLayers, Guid? worldID {{=}} NULL)}} |
:: | :: | ||
− | :: | + | ::Clones a scene, optionally copying various other related data. |
:{{CSharp|Guid CreateAreaGroup(string name, AreaType allowedAreaTypes {{=}} AreaType.All)}} | :{{CSharp|Guid CreateAreaGroup(string name, AreaType allowedAreaTypes {{=}} AreaType.All)}} | ||
Line 38: | Line 34: | ||
::Creates a new area group, optionally as a child of another | ::Creates a new area group, optionally as a child of another | ||
− | :{{CSharp|Guid | + | :{{CSharp|Guid CreateLayer(Guid sceneID, string name)}} |
+ | :: | ||
+ | ::Creates a new layer. A layer is a container for a DOM document that is owned by a scene and can be linked to other scenes (shared layers). | ||
− | :{{CSharp|Guid | + | :{{CSharp|Guid CreateLayerVersion(Guid layerID, string name, Byte[] layout {{=}} NULL)}} |
+ | :: | ||
+ | ::Creates a new layer version. Layers can have multiple versions, one of which can be the active version. The active version is what users see in live instances. | ||
:{{CSharp|Guid CreateScene(string alias, string title, Guid worldID, Guid sceneTypeID, InstanceModes instanceMode, string modeMetadata {{=}} NULL)}} | :{{CSharp|Guid CreateScene(string alias, string title, Guid worldID, Guid sceneTypeID, InstanceModes instanceMode, string modeMetadata {{=}} NULL)}} | ||
Line 56: | Line 56: | ||
::Deletes an area group | ::Deletes an area group | ||
− | :{{CSharp|void | + | :{{CSharp|void DeleteLayer(Guid layerID, Action<PacketErrorStatus> onComplete {{=}} NULL)}} |
+ | :: | ||
+ | ::Deletes a layer | ||
+ | |||
+ | :{{CSharp|void DeleteLayerVersion(Guid layerVersionID)}} | ||
+ | :: | ||
+ | ::Deletes a layer version | ||
:{{CSharp|void DeleteScene(Guid sceneID, Action<PacketErrorStatus> onComplete {{=}} NULL)}} | :{{CSharp|void DeleteScene(Guid sceneID, Action<PacketErrorStatus> onComplete {{=}} NULL)}} | ||
Line 69: | Line 75: | ||
:: | :: | ||
::Begins the deletion of a world and all its child objects | ::Begins the deletion of a world and all its child objects | ||
+ | |||
+ | :{{CSharp|void DetachLayer(Guid layerID, Guid areaID)}} | ||
+ | :: | ||
+ | ::Detaches a layer from an area (part of worldspace), usually a scene | ||
:{{CSharp|Guid FindScene(string alias, Guid worldID)}} | :{{CSharp|Guid FindScene(string alias, Guid worldID)}} | ||
Line 90: | Line 100: | ||
::Gets a structure of information about an [[Area]] (a piece of [[Worldspace]]) | ::Gets a structure of information about an [[Area]] (a piece of [[Worldspace]]) | ||
− | :{{CSharp| | + | :{{CSharp|ILayerInfo[] GetAttachedLayers(Guid areaID)}} |
+ | :: | ||
+ | ::Gets the list of layers attached to an area | ||
− | :{{CSharp| | + | :{{CSharp|ILayerInfo GetLayerInfo(Guid layerID)}} |
+ | :: | ||
+ | ::Gets information about a layer and its versions | ||
− | :{{CSharp| | + | :{{CSharp|ILayerVersionInfo GetLayerVersionInfo(Guid layerVersionID)}} |
+ | :: | ||
+ | ::Gets information about a layer version | ||
− | :{{CSharp| | + | :{{CSharp|ILayerInfo[] GetOwnedLayers(Guid sceneID)}} |
− | + | :: | |
− | : | + | ::Gets the list of layers owned by a scene |
− | + | ||
− | : | + | |
:{{CSharp|Guid GetPersonaRootWorld(Guid personaID)}} | :{{CSharp|Guid GetPersonaRootWorld(Guid personaID)}} | ||
Line 129: | Line 143: | ||
:: | :: | ||
::Gets the name of a scene instance | ::Gets the name of a scene instance | ||
− | |||
− | |||
:{{CSharp|string GetSceneName(Guid sceneID)}} | :{{CSharp|string GetSceneName(Guid sceneID)}} | ||
Line 204: | Line 216: | ||
::Marks an area as a system area so it cannot be deleted with layer 1 tools | ::Marks an area as a system area so it cannot be deleted with layer 1 tools | ||
− | :{{CSharp|void | + | :{{CSharp|void SetAreaGroupName(Guid areaGroupID, string name)}} |
− | + | ||
− | + | ||
:: | :: | ||
− | :: | + | ::Sets the name of an area group |
− | :{{CSharp|void | + | :{{CSharp|void SetLayerName(Guid layerID, string name)}} |
:: | :: | ||
− | :: | + | ::Sets the name of a layer |
− | :{{CSharp|void | + | :{{CSharp|void SetLayerVersionName(Guid layerVersionID, string name)}} |
:: | :: | ||
− | + | ::Sets the name of a layer version | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | ::Sets the name of | + | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
:{{CSharp|void SetSceneAlias(Guid sceneID, string alias)}} | :{{CSharp|void SetSceneAlias(Guid sceneID, string alias)}} | ||
Line 245: | Line 235: | ||
:: | :: | ||
::Renames a scene instance. | ::Renames a scene instance. | ||
− | |||
− | |||
− | |||
− | |||
:{{CSharp|void SetSceneName(Guid sceneID, string name)}} | :{{CSharp|void SetSceneName(Guid sceneID, string name)}} | ||
:: | :: | ||
::Renames a scene. | ::Renames a scene. | ||
+ | |||
+ | :{{CSharp|void SetSceneType(Guid sceneID, Guid sceneTypeID)}} | ||
+ | :: | ||
+ | ::Changes the Scene Type of the scene | ||
:{{CSharp|void SetSecurableMetadata(Guid securableID, string key, ProtoValue value)}} | :{{CSharp|void SetSecurableMetadata(Guid securableID, string key, ProtoValue value)}} | ||
:: | :: | ||
::Sets a securable metadata value. Values can be retrieved through GetSecurableInfo | ::Sets a securable metadata value. Values can be retrieved through GetSecurableInfo | ||
+ | |||
+ | :{{CSharp|void SetSecurableMetadata(Guid securableID, IDictionary<string, ProtoValue> values)}} | ||
+ | :: | ||
+ | ::Sets several securable metadata values in one call, causing only one metadata change notification. | ||
:{{CSharp|void SetServiceProviderName(Guid serviceProviderID, string name)}} | :{{CSharp|void SetServiceProviderName(Guid serviceProviderID, string name)}} |
Revision as of 12:40, 6 September 2017
The worldspace system is a primary layer one interface. It provides methods for working with Worldspace, Layouts and EditLayouts, and area groups
Remarks [edit]
Properties
- IWorldInfo RootWorld {get;}
- Gets info about the system root world. This is the only world with a null parent world ID.
Methods
- void ActivateLayerVersion(Guid layerVersionID)
- Makes the specified version of a layer the active version. Live instances will update to reflect the change.
- void AttachLayer(Guid layerID, Guid areaID)
- Attaches a layer to an area (part of worldspace), usually a scene
- Guid CloneLayer(Guid layerID, Guid sceneID, bool activeVersionOnly = false, bool cloneContainers = true)
- Clones a layer and optionally its versions and containers as well.
- Guid CloneLayerVersion(Guid layerVersionID, string name)
- Clones an existing layer version.
- Guid CloneScene(Guid sceneID, string newAlias, string newName, bool cloneContainers, bool cloneLayers, Guid? worldID = NULL)
- Clones a scene, optionally copying various other related data.
- Guid CreateAreaGroup(string name, AreaType allowedAreaTypes = AreaType.All)
- Creates a new area group, optionally as a child of another
- Guid CreateLayer(Guid sceneID, string name)
- Creates a new layer. A layer is a container for a DOM document that is owned by a scene and can be linked to other scenes (shared layers).
- Guid CreateLayerVersion(Guid layerID, string name, Byte[] layout = NULL)
- Creates a new layer version. Layers can have multiple versions, one of which can be the active version. The active version is what users see in live instances.
- Guid CreateScene(string alias, string title, Guid worldID, Guid sceneTypeID, InstanceModes instanceMode, string modeMetadata = NULL)
- Guid CreateSceneType(Guid resourceItemID, string title)
- Creates a new Scene Type given an existing resource identifier
- Guid CreateWorld(string alias, string title, bool isContainer, bool isPermissionRoot, Guid? parentWorldID)
- Creates a new world, optionally under a parent world
- void DeleteAreaGroup(Guid areaGroupID, Action<PacketErrorStatus> onComplete = NULL)
- Deletes an area group
- void DeleteLayer(Guid layerID, Action<PacketErrorStatus> onComplete = NULL)
- Deletes a layer
- void DeleteLayerVersion(Guid layerVersionID)
- Deletes a layer version
- void DeleteScene(Guid sceneID, Action<PacketErrorStatus> onComplete = NULL)
- Begins the deletion of a scene.
- void DeleteSceneType(Guid sceneTypeID)
- Begins the deletion of a Scene Type and it's associated scenes.
- void DeleteWorld(Guid worldID, Action<PacketErrorStatus> onComplete = NULL)
- Begins the deletion of a world and all its child objects
- void DetachLayer(Guid layerID, Guid areaID)
- Detaches a layer from an area (part of worldspace), usually a scene
- Guid FindScene(string alias, Guid worldID)
- Finds a ID for a world given its alias and parent world
- Guid FindWorld(string alias, Guid parentWorldID)
- Gets the ID of a world with a given alias in a given parent world
- IAreaGroupInfo GetAreaGroupInfo(Guid areaGroupID)
- Gets a structure of information about an AreaGroup (a piece of Worldspace)
- string GetAreaGroupName(Guid areaGroupID)
- Gets the name of an area group
- IAreaInfo GetAreaInfo(Guid areaID)
- Gets a structure of information about an Area (a piece of Worldspace)
- ILayerInfo[] GetAttachedLayers(Guid areaID)
- Gets the list of layers attached to an area
- ILayerInfo GetLayerInfo(Guid layerID)
- Gets information about a layer and its versions
- ILayerVersionInfo GetLayerVersionInfo(Guid layerVersionID)
- Gets information about a layer version
- ILayerInfo[] GetOwnedLayers(Guid sceneID)
- Gets the list of layers owned by a scene
- Guid GetPersonaRootWorld(Guid personaID)
- Gets the world in which the given persona is rooted. This represents the highest level world this persona is valid in.
- Guid GetRootWorld(Guid areaID)
- Gets the ID of the next persona container (root world) up the worldspace hierarchy
- string GetSceneAlias(Guid sceneID)
- Gets the alias (URL safe name) of the requested scene
- Guid GetSceneForUri(IConnectionIdentity identity, Uri uri)
- Resolves a VWW URI to a Scene ID, Relative URIs willl be resolved relative to the identity's current location or worldspace root if there is no location
- Guid GetSceneForUri(Uri uri)
- Resolves a VWW URI to a Scene ID, Relative URIs willl be resolved relative to the worldspace root
- ISceneInfo GetSceneInfo(Guid sceneID)
- Gets a structure of information about a scene and its parent worlds
- string GetSceneInstanceName(Guid sceneInstanceID)
- Gets the name of a scene instance
- string GetSceneName(Guid sceneID)
- Gets the name of a scene
- Guid GetSceneType(Guid sceneID)
- Gets the Scene Type of the scene
- ISceneTypeInfo GetSceneTypeInfo(Guid sceneTypeID)
- Gets a structure of information about a scene type
- ISceneTypeInfo[] GetSceneTypeInfos()
- Gets a structure of information about all of the scene types registered with the system
- string GetSceneTypeName(Guid sceneTypeID)
- Gets the name of a scene type
- ISecurableInfo GetSecurableInfo(Guid securableID)
- Gets general information about a securable
- string GetSecurableName(Guid securableID)
- Gets the name of a securable
- SecurableType GetSecurableType(Guid securableID)
- Gets the type of a securable
- string GetServiceProviderName(Guid serviceProviderID)
- Gets the name of a service provider
- Uri GetUriForScene(Guid sceneID)
- The oposite of GetSceneForURI, this methof returns the full VWW URL for a scene
- string GetWorldAlias(Guid worldID)
- Gets the alias (URL safe name) of the requested world
- IWorldInfo GetWorldInfo(Guid worldID)
- Gets a structure of information about a world and its parent worlds
- string GetWorldName(Guid worldID)
- Gets the name of a world
- bool IsPersonaContainer(Guid worldID)
- Determines if a world is a persona container
- bool IsProtected(Guid areaID)
- Tests if an area is protected
- void JoinAreaGroup(Guid areaGroupID, Guid areaID)
- Adds an area to an area group
- void LeaveAreaGroup(Guid areaGroupID, Guid areaID)
- Removes an area from an area group
- void ProtectArea(Guid areaID)
- Marks an area as a system area so it cannot be deleted with layer 1 tools
- void SetAreaGroupName(Guid areaGroupID, string name)
- Sets the name of an area group
- void SetLayerName(Guid layerID, string name)
- Sets the name of a layer
- void SetLayerVersionName(Guid layerVersionID, string name)
- Sets the name of a layer version
- void SetSceneAlias(Guid sceneID, string alias)
- Sets the alias (URL safe name) of the requested scene
- void SetSceneInstanceName(Guid sceneInstanceID, string name)
- Renames a scene instance.
- void SetSceneName(Guid sceneID, string name)
- Renames a scene.
- void SetSceneType(Guid sceneID, Guid sceneTypeID)
- Changes the Scene Type of the scene
- void SetSecurableMetadata(Guid securableID, string key, ProtoValue value)
- Sets a securable metadata value. Values can be retrieved through GetSecurableInfo
- void SetSecurableMetadata(Guid securableID, IDictionary<string, ProtoValue> values)
- Sets several securable metadata values in one call, causing only one metadata change notification.
- void SetServiceProviderName(Guid serviceProviderID, string name)
- Renames a service provider.
- void SetWorldAlias(Guid worldID, string alias)
- Sets the alias (URL safe name) of the requested world
- void SetWorldName(Guid worldID, string name)
- Renames a world.
- void ShutdownSceneInstances(Guid sceneID)
- Forces a shutdown of any instances of the given scene
- void UnProtectArea(Guid areaID)
- Marks an area as no longer a system area so it can again be deleted
- void UpdateScene(Guid sceneID, string alias, string title, Guid? worldID, Byte instanceModeID, string modeMetadata = NULL)
- Updates the basic properties of a scene