From 401e9bc3b9083e106a9eb1b6bc6f2902e23cf9c0 Mon Sep 17 00:00:00 2001
From: Justin Clarke Casey
Date: Thu, 22 May 2008 17:09:33 +0000
Subject: * Documentation for load/save xml methods * Insert the very rough
 beginning stubs for a save/load OpenSim archive facility that will load/save
 prim assets (textures & inventory) as well as the prim details themselves
 (our existing xml facilities). * This won't be ready for even rough testing
 for quite some time. * I'm doing this directly in the region server for now
 since this will be quicker to get something working (hence giving me the
 Serotonin boost that I need).  However, there are very good arguments for
 later also including it (or moving it entirely) to the separate export
 executable which Sean stubbed out some time ago.

---
 OpenSim/Region/Environment/Scenes/SceneManager.cs | 39 ++++++++++++++++++++++-
 1 file changed, 38 insertions(+), 1 deletion(-)

(limited to 'OpenSim/Region/Environment/Scenes/SceneManager.cs')

diff --git a/OpenSim/Region/Environment/Scenes/SceneManager.cs b/OpenSim/Region/Environment/Scenes/SceneManager.cs
index 1568632..68dfa2f 100644
--- a/OpenSim/Region/Environment/Scenes/SceneManager.cs
+++ b/OpenSim/Region/Environment/Scenes/SceneManager.cs
@@ -157,25 +157,62 @@ namespace OpenSim.Region.Environment.Scenes
             }
         }
 
+        /// <summary>
+        /// Save the prims in the current scene to an xml file in OpenSimulator's original 'xml' format
+        /// </summary>
+        /// <param name="filename"></param>
         public void SaveCurrentSceneToXml(string filename)
         {
             CurrentOrFirstScene.SavePrimsToXml(filename);
         }
 
+        /// <summary>
+        /// Load an xml file of prims in OpenSimulator's original 'xml' file format to the current scene
+        /// </summary>
+        /// <param name="filename"></param>
+        /// <param name="generateNewIDs"></param>
+        /// <param name="loadOffset"></param>
         public void LoadCurrentSceneFromXml(string filename, bool generateNewIDs, LLVector3 loadOffset)
         {
             CurrentOrFirstScene.LoadPrimsFromXml(filename, generateNewIDs, loadOffset);
         }
-
+                
+        /// <summary>
+        /// Save the prims in the current scene to an xml file in OpenSimulator's current 'xml2' format
+        /// </summary>
+        /// <param name="filename"></param>
         public void SaveCurrentSceneToXml2(string filename)
         {
             CurrentOrFirstScene.SavePrimsToXml2(filename);
         }
 
+        /// <summary>
+        /// Load an xml file of prims in OpenSimulator's current 'xml2' file format to the current scene
+        /// </summary>        
         public void LoadCurrentSceneFromXml2(string filename)
         {
             CurrentOrFirstScene.LoadPrimsFromXml2(filename);
         }
+        
+        /// <summary>
+        /// Save the current scene to an OpenSimulator archive.  This archive will eventually include the prim's assets
+        /// as well as the details of the prims themselves.
+        /// </summary>
+        /// <param name="filename"></param>
+        public void SaveCurrentSceneToOar(string filename)
+        {
+            // TODO Nothing yet
+        }
+        
+        /// <summary>
+        /// Load an OpenSim archive into the current scene.  This will load both the shapes of the prims and upload
+        /// their assets to the asset service.
+        /// </summary>
+        /// <param name="filename"></param>
+        public void LoadCurrentSceneFromOar(string filename)
+        {
+            // TODO Nothing yet
+        }
 
         [Obsolete("TODO: Remove this warning by 0.7")]
         public bool RunTerrainCmdOnCurrentScene(string[] cmdparams, ref string result)
-- 
cgit v1.1