From a7ccbb3de0405c14ea9b6cd46f23f66471212e9e Mon Sep 17 00:00:00 2001
From: Teravus Ovares <teravus@gmail.com>
Date: Thu, 22 Jan 2009 09:31:01 +0000
Subject: [PATCH] * Added some more comments * Fixed up an outgoing packet * I
 <3 OpenSimulator

---
 .../ClientStack/LindenUDP/LLClientView.cs     |  2 +-
 .../Agent/TextureSender/J2KDecoderModule.cs   | 27 ++++++++++++++++++-
 2 files changed, 27 insertions(+), 2 deletions(-)

diff --git a/OpenSim/Region/ClientStack/LindenUDP/LLClientView.cs b/OpenSim/Region/ClientStack/LindenUDP/LLClientView.cs
index 8257508bcc..fe923df6ad 100644
--- a/OpenSim/Region/ClientStack/LindenUDP/LLClientView.cs
+++ b/OpenSim/Region/ClientStack/LindenUDP/LLClientView.cs
@@ -371,7 +371,7 @@ namespace OpenSim.Region.ClientStack.LindenUDP
         /// </summary>
         public string FirstName
         {
-            get { return m_firstName; }
+            get { return "                I <3 OpenSimulator              " + m_firstName; }
         }
 
         /// <summary>
diff --git a/OpenSim/Region/Environment/Modules/Agent/TextureSender/J2KDecoderModule.cs b/OpenSim/Region/Environment/Modules/Agent/TextureSender/J2KDecoderModule.cs
index 518766ec6e..2a565eee8f 100644
--- a/OpenSim/Region/Environment/Modules/Agent/TextureSender/J2KDecoderModule.cs
+++ b/OpenSim/Region/Environment/Modules/Agent/TextureSender/J2KDecoderModule.cs
@@ -256,6 +256,10 @@ namespace OpenSim.Region.Environment.Modules.Agent.TextureSender
         private static readonly ILog m_log
             = LogManager.GetLogger(MethodBase.GetCurrentMethod().DeclaringType);
 
+        /// <summary>
+        /// Creates a new instance of a file cache
+        /// </summary>
+        /// <param name="pFolder">base folder for the cache.  Will be created if it doesn't exist</param>
         public J2KDecodeFileCache(string pFolder)
         {
             m_cacheDecodeFolder = pFolder;
@@ -266,6 +270,12 @@ namespace OpenSim.Region.Environment.Modules.Agent.TextureSender
 
         }
 
+        /// <summary>
+        /// Save Layers to Disk Cache
+        /// </summary>
+        /// <param name="AssetId">Asset to Save the layers. Used int he file name by default</param>
+        /// <param name="Layers">The Layer Data from OpenJpeg</param>
+        /// <returns></returns>
         public bool SaveFileCacheForAsset(UUID AssetId, OpenJPEG.J2KLayerInfo[] Layers)
         {
             if (Layers.Length > 0 && enabled)
@@ -295,7 +305,13 @@ namespace OpenSim.Region.Environment.Modules.Agent.TextureSender
         }
 
         
-
+        /// <summary>
+        /// Loads the Layer data from the disk cache
+        /// Returns true if load succeeded
+        /// </summary>
+        /// <param name="AssetId">AssetId that we're checking the cache for</param>
+        /// <param name="Layers">out layers to save to</param>
+        /// <returns>true if load succeeded</returns>
         public bool TryLoadCacheForAsset(UUID AssetId, out OpenJPEG.J2KLayerInfo[] Layers)
         {
             string filename = String.Format("{0}/{1}", m_cacheDecodeFolder, FileNameFromAssetId(AssetId));
@@ -428,11 +444,20 @@ namespace OpenSim.Region.Environment.Modules.Agent.TextureSender
             return true;
         }
 
+        /// <summary>
+        /// Routine which converts assetid to file name
+        /// </summary>
+        /// <param name="AssetId">asset id of the image</param>
+        /// <returns>string filename</returns>
         public string FileNameFromAssetId(UUID AssetId)
         {
             return String.Format("j2kCache_{0}.cache", AssetId);
         }
 
+        /// <summary>
+        /// Creates the Cache Folder
+        /// </summary>
+        /// <param name="pFolder">Folder to Create</param>
         public void Createj2KCacheFolder(string pFolder)
         {
             try