Removed unused code -- this was the previous version of UDP texture sending, which now lives entirely in LindenUDP space.
Diva Canto
parent
862da9a55f
commit
54418c5e69
|
|
@ -7189,34 +7189,26 @@ namespace OpenSim.Region.ClientStack.LindenUDP
|
||||||
//handlerTextureRequest = null;
|
//handlerTextureRequest = null;
|
||||||
for (int i = 0; i < imageRequest.RequestImage.Length; i++)
|
for (int i = 0; i < imageRequest.RequestImage.Length; i++)
|
||||||
{
|
{
|
||||||
if (OnRequestTexture != null)
|
TextureRequestArgs args = new TextureRequestArgs();
|
||||||
|
|
||||||
|
RequestImagePacket.RequestImageBlock block = imageRequest.RequestImage[i];
|
||||||
|
|
||||||
|
args.RequestedAssetID = block.Image;
|
||||||
|
args.DiscardLevel = block.DiscardLevel;
|
||||||
|
args.PacketNumber = block.Packet;
|
||||||
|
args.Priority = block.DownloadPriority;
|
||||||
|
args.requestSequence = imageRequest.Header.Sequence;
|
||||||
|
|
||||||
|
// NOTE: This is not a built in part of the LLUDP protocol, but we double the
|
||||||
|
// priority of avatar textures to get avatars rezzing in faster than the
|
||||||
|
// surrounding scene
|
||||||
|
if ((ImageType)block.Type == ImageType.Baked)
|
||||||
|
args.Priority *= 2.0f;
|
||||||
|
|
||||||
|
// in the end, we null this, so we have to check if it's null
|
||||||
|
if (m_imageManager != null)
|
||||||
{
|
{
|
||||||
TextureRequestArgs args = new TextureRequestArgs();
|
m_imageManager.EnqueueReq(args);
|
||||||
|
|
||||||
RequestImagePacket.RequestImageBlock block = imageRequest.RequestImage[i];
|
|
||||||
|
|
||||||
args.RequestedAssetID = block.Image;
|
|
||||||
args.DiscardLevel = block.DiscardLevel;
|
|
||||||
args.PacketNumber = block.Packet;
|
|
||||||
args.Priority = block.DownloadPriority;
|
|
||||||
args.requestSequence = imageRequest.Header.Sequence;
|
|
||||||
|
|
||||||
// NOTE: This is not a built in part of the LLUDP protocol, but we double the
|
|
||||||
// priority of avatar textures to get avatars rezzing in faster than the
|
|
||||||
// surrounding scene
|
|
||||||
if ((ImageType)block.Type == ImageType.Baked)
|
|
||||||
args.Priority *= 2.0f;
|
|
||||||
|
|
||||||
//handlerTextureRequest = OnRequestTexture;
|
|
||||||
|
|
||||||
//if (handlerTextureRequest != null)
|
|
||||||
//OnRequestTexture(this, args);
|
|
||||||
|
|
||||||
// in the end, we null this, so we have to check if it's null
|
|
||||||
if (m_imageManager != null)
|
|
||||||
{
|
|
||||||
m_imageManager.EnqueueReq(args);
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
return true;
|
return true;
|
||||||
|
|
|
||||||
|
|
@ -1,302 +0,0 @@
|
||||||
/*
|
|
||||||
* Copyright (c) Contributors, http://opensimulator.org/
|
|
||||||
* See CONTRIBUTORS.TXT for a full list of copyright holders.
|
|
||||||
*
|
|
||||||
* Redistribution and use in source and binary forms, with or without
|
|
||||||
* modification, are permitted provided that the following conditions are met:
|
|
||||||
* * Redistributions of source code must retain the above copyright
|
|
||||||
* notice, this list of conditions and the following disclaimer.
|
|
||||||
* * Redistributions in binary form must reproduce the above copyright
|
|
||||||
* notice, this list of conditions and the following disclaimer in the
|
|
||||||
* documentation and/or other materials provided with the distribution.
|
|
||||||
* * Neither the name of the OpenSimulator Project nor the
|
|
||||||
* names of its contributors may be used to endorse or promote products
|
|
||||||
* derived from this software without specific prior written permission.
|
|
||||||
*
|
|
||||||
* THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY
|
|
||||||
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
|
||||||
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
||||||
* DISCLAIMED. IN NO EVENT SHALL THE CONTRIBUTORS BE LIABLE FOR ANY
|
|
||||||
* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
|
||||||
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
|
||||||
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
|
|
||||||
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
||||||
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
|
|
||||||
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
||||||
*/
|
|
||||||
|
|
||||||
using System;
|
|
||||||
using System.Collections.Generic;
|
|
||||||
using System.Reflection;
|
|
||||||
using System.Threading;
|
|
||||||
using log4net;
|
|
||||||
using Nini.Config;
|
|
||||||
using OpenMetaverse;
|
|
||||||
using OpenSim.Framework;
|
|
||||||
|
|
||||||
using OpenSim.Region.Framework.Interfaces;
|
|
||||||
using OpenSim.Region.Framework.Scenes;
|
|
||||||
using BlockingQueue = OpenSim.Framework.BlockingQueue<OpenSim.Region.Framework.Interfaces.ITextureSender>;
|
|
||||||
using OpenSim.Services.Interfaces;
|
|
||||||
|
|
||||||
namespace OpenSim.Region.CoreModules.Agent.TextureDownload
|
|
||||||
{
|
|
||||||
public class TextureDownloadModule : IRegionModule
|
|
||||||
{
|
|
||||||
private static readonly ILog m_log
|
|
||||||
= LogManager.GetLogger(MethodBase.GetCurrentMethod().DeclaringType);
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// There is one queue for all textures waiting to be sent, regardless of the requesting user.
|
|
||||||
/// </summary>
|
|
||||||
private readonly BlockingQueue m_queueSenders
|
|
||||||
= new BlockingQueue();
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Each user has their own texture download service.
|
|
||||||
/// </summary>
|
|
||||||
private readonly Dictionary<UUID, UserTextureDownloadService> m_userTextureServices =
|
|
||||||
new Dictionary<UUID, UserTextureDownloadService>();
|
|
||||||
|
|
||||||
private Scene m_scene;
|
|
||||||
private List<Scene> m_scenes = new List<Scene>();
|
|
||||||
|
|
||||||
public TextureDownloadModule()
|
|
||||||
{
|
|
||||||
}
|
|
||||||
|
|
||||||
#region IRegionModule Members
|
|
||||||
|
|
||||||
public void Initialise(Scene scene, IConfigSource config)
|
|
||||||
{
|
|
||||||
|
|
||||||
if (m_scene == null)
|
|
||||||
{
|
|
||||||
//m_log.Debug("Creating Texture download module");
|
|
||||||
m_scene = scene;
|
|
||||||
//m_thread = new Thread(new ThreadStart(ProcessTextureSenders));
|
|
||||||
//m_thread.Name = "ProcessTextureSenderThread";
|
|
||||||
//m_thread.IsBackground = true;
|
|
||||||
//m_thread.Start();
|
|
||||||
//ThreadTracker.Add(m_thread);
|
|
||||||
}
|
|
||||||
|
|
||||||
if (!m_scenes.Contains(scene))
|
|
||||||
{
|
|
||||||
m_scenes.Add(scene);
|
|
||||||
m_scene = scene;
|
|
||||||
m_scene.EventManager.OnNewClient += NewClient;
|
|
||||||
m_scene.EventManager.OnRemovePresence += EventManager_OnRemovePresence;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
public void PostInitialise()
|
|
||||||
{
|
|
||||||
}
|
|
||||||
|
|
||||||
public void Close()
|
|
||||||
{
|
|
||||||
}
|
|
||||||
|
|
||||||
public string Name
|
|
||||||
{
|
|
||||||
get { return "TextureDownloadModule"; }
|
|
||||||
}
|
|
||||||
|
|
||||||
public bool IsSharedModule
|
|
||||||
{
|
|
||||||
get { return false; }
|
|
||||||
}
|
|
||||||
|
|
||||||
#endregion
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Cleanup the texture service related objects for the removed presence.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="agentId"> </param>
|
|
||||||
private void EventManager_OnRemovePresence(UUID agentId)
|
|
||||||
{
|
|
||||||
UserTextureDownloadService textureService;
|
|
||||||
|
|
||||||
lock (m_userTextureServices)
|
|
||||||
{
|
|
||||||
if (m_userTextureServices.TryGetValue(agentId, out textureService))
|
|
||||||
{
|
|
||||||
textureService.Close();
|
|
||||||
//m_log.DebugFormat("[TEXTURE MODULE]: Removing UserTextureServices from {0}", m_scene.RegionInfo.RegionName);
|
|
||||||
m_userTextureServices.Remove(agentId);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
public void NewClient(IClientAPI client)
|
|
||||||
{
|
|
||||||
UserTextureDownloadService textureService;
|
|
||||||
|
|
||||||
lock (m_userTextureServices)
|
|
||||||
{
|
|
||||||
if (m_userTextureServices.TryGetValue(client.AgentId, out textureService))
|
|
||||||
{
|
|
||||||
textureService.Close();
|
|
||||||
//m_log.DebugFormat("[TEXTURE MODULE]: Removing outdated UserTextureServices from {0}", m_scene.RegionInfo.RegionName);
|
|
||||||
m_userTextureServices.Remove(client.AgentId);
|
|
||||||
}
|
|
||||||
m_userTextureServices.Add(client.AgentId, new UserTextureDownloadService(client, m_scene, m_queueSenders));
|
|
||||||
}
|
|
||||||
|
|
||||||
client.OnRequestTexture += TextureRequest;
|
|
||||||
}
|
|
||||||
|
|
||||||
/// I'm commenting this out, and replacing it with the implementation below, which
|
|
||||||
/// may return a null value. This is necessary for avoiding race conditions
|
|
||||||
/// recreating UserTextureServices for clients that have just been closed.
|
|
||||||
/// That behavior of always returning a UserTextureServices was causing the
|
|
||||||
/// A-B-A problem (mantis #2855).
|
|
||||||
///
|
|
||||||
///// <summary>
|
|
||||||
///// Does this user have a registered texture download service?
|
|
||||||
///// </summary>
|
|
||||||
///// <param name="userID"></param>
|
|
||||||
///// <param name="textureService"></param>
|
|
||||||
///// <returns>Always returns true, since a service is created if one does not already exist</returns>
|
|
||||||
//private bool TryGetUserTextureService(
|
|
||||||
// IClientAPI client, out UserTextureDownloadService textureService)
|
|
||||||
//{
|
|
||||||
// lock (m_userTextureServices)
|
|
||||||
// {
|
|
||||||
// if (m_userTextureServices.TryGetValue(client.AgentId, out textureService))
|
|
||||||
// {
|
|
||||||
// //m_log.DebugFormat("[TEXTURE MODULE]: Found existing UserTextureServices in ", m_scene.RegionInfo.RegionName);
|
|
||||||
// return true;
|
|
||||||
// }
|
|
||||||
|
|
||||||
// m_log.DebugFormat("[TEXTURE MODULE]: Creating new UserTextureServices in ", m_scene.RegionInfo.RegionName);
|
|
||||||
// textureService = new UserTextureDownloadService(client, m_scene, m_queueSenders);
|
|
||||||
// m_userTextureServices.Add(client.AgentId, textureService);
|
|
||||||
|
|
||||||
// return true;
|
|
||||||
// }
|
|
||||||
//}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Does this user have a registered texture download service?
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="userID"></param>
|
|
||||||
/// <param name="textureService"></param>
|
|
||||||
/// <returns>A UserTextureDownloadService or null in the output parameter, and true or false accordingly.</returns>
|
|
||||||
private bool TryGetUserTextureService(IClientAPI client, out UserTextureDownloadService textureService)
|
|
||||||
{
|
|
||||||
lock (m_userTextureServices)
|
|
||||||
{
|
|
||||||
if (m_userTextureServices.TryGetValue(client.AgentId, out textureService))
|
|
||||||
{
|
|
||||||
//m_log.DebugFormat("[TEXTURE MODULE]: Found existing UserTextureServices in ", m_scene.RegionInfo.RegionName);
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
|
|
||||||
textureService = null;
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Start the process of requesting a given texture.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="sender"> </param>
|
|
||||||
/// <param name="e"></param>
|
|
||||||
public void TextureRequest(Object sender, TextureRequestArgs e)
|
|
||||||
{
|
|
||||||
IClientAPI client = (IClientAPI)sender;
|
|
||||||
|
|
||||||
if (e.Priority == 1016001f) // Preview
|
|
||||||
{
|
|
||||||
if (client.Scene is Scene)
|
|
||||||
{
|
|
||||||
Scene scene = (Scene)client.Scene;
|
|
||||||
|
|
||||||
ScenePresence sp = scene.GetScenePresence(client.AgentId);
|
|
||||||
if (sp == null) // Deny unknown user
|
|
||||||
return;
|
|
||||||
|
|
||||||
IInventoryService invService = scene.InventoryService;
|
|
||||||
if (invService.GetRootFolder(client.AgentId) == null) // Deny no inventory
|
|
||||||
return;
|
|
||||||
|
|
||||||
// Diva 2009-08-13: this test doesn't make any sense to many devs
|
|
||||||
//if (profile.UserProfile.GodLevel < 200 && profile.RootFolder.FindAsset(e.RequestedAssetID) == null) // Deny if not owned
|
|
||||||
//{
|
|
||||||
// m_log.WarnFormat("[TEXTURE]: user {0} doesn't have permissions to texture {1}");
|
|
||||||
// return;
|
|
||||||
//}
|
|
||||||
|
|
||||||
m_log.Debug("Texture preview");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
UserTextureDownloadService textureService;
|
|
||||||
|
|
||||||
if (TryGetUserTextureService(client, out textureService))
|
|
||||||
{
|
|
||||||
textureService.HandleTextureRequest(e);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Entry point for the thread dedicated to processing the texture queue.
|
|
||||||
/// </summary>
|
|
||||||
public void ProcessTextureSenders()
|
|
||||||
{
|
|
||||||
ITextureSender sender = null;
|
|
||||||
|
|
||||||
try
|
|
||||||
{
|
|
||||||
while (true)
|
|
||||||
{
|
|
||||||
sender = m_queueSenders.Dequeue();
|
|
||||||
|
|
||||||
if (sender.Cancel)
|
|
||||||
{
|
|
||||||
TextureSent(sender);
|
|
||||||
|
|
||||||
sender.Cancel = false;
|
|
||||||
}
|
|
||||||
else
|
|
||||||
{
|
|
||||||
bool finished = sender.SendTexturePacket();
|
|
||||||
if (finished)
|
|
||||||
{
|
|
||||||
TextureSent(sender);
|
|
||||||
}
|
|
||||||
else
|
|
||||||
{
|
|
||||||
m_queueSenders.Enqueue(sender);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Make sure that any sender we currently have can get garbage collected
|
|
||||||
sender = null;
|
|
||||||
|
|
||||||
//m_log.InfoFormat("[TEXTURE] Texture sender queue size: {0}", m_queueSenders.Count());
|
|
||||||
}
|
|
||||||
}
|
|
||||||
catch (Exception e)
|
|
||||||
{
|
|
||||||
// TODO: Let users in the sim and those entering it and possibly an external watchdog know what has happened
|
|
||||||
m_log.ErrorFormat(
|
|
||||||
"[TEXTURE]: Texture send thread terminating with exception. PLEASE REBOOT YOUR SIM - TEXTURES WILL NOT BE AVAILABLE UNTIL YOU DO. Exception is {0}",
|
|
||||||
e);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Called when the texture has finished sending.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="sender"></param>
|
|
||||||
private void TextureSent(ITextureSender sender)
|
|
||||||
{
|
|
||||||
sender.Sending = false;
|
|
||||||
//m_log.DebugFormat("[TEXTURE]: Removing download stat for {0}", sender.assetID);
|
|
||||||
m_scene.StatsReporter.AddPendingDownloads(-1);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
@ -1,87 +0,0 @@
|
||||||
/*
|
|
||||||
* Copyright (c) Contributors, http://opensimulator.org/
|
|
||||||
* See CONTRIBUTORS.TXT for a full list of copyright holders.
|
|
||||||
*
|
|
||||||
* Redistribution and use in source and binary forms, with or without
|
|
||||||
* modification, are permitted provided that the following conditions are met:
|
|
||||||
* * Redistributions of source code must retain the above copyright
|
|
||||||
* notice, this list of conditions and the following disclaimer.
|
|
||||||
* * Redistributions in binary form must reproduce the above copyright
|
|
||||||
* notice, this list of conditions and the following disclaimer in the
|
|
||||||
* documentation and/or other materials provided with the distribution.
|
|
||||||
* * Neither the name of the OpenSimulator Project nor the
|
|
||||||
* names of its contributors may be used to endorse or promote products
|
|
||||||
* derived from this software without specific prior written permission.
|
|
||||||
*
|
|
||||||
* THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY
|
|
||||||
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
|
||||||
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
||||||
* DISCLAIMED. IN NO EVENT SHALL THE CONTRIBUTORS BE LIABLE FOR ANY
|
|
||||||
* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
|
||||||
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
|
||||||
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
|
|
||||||
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
||||||
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
|
|
||||||
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
||||||
*/
|
|
||||||
|
|
||||||
using OpenMetaverse;
|
|
||||||
using OpenSim.Framework;
|
|
||||||
using OpenSim.Region.Framework.Interfaces;
|
|
||||||
|
|
||||||
namespace OpenSim.Region.CoreModules.Agent.TextureDownload
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Sends a 'texture not found' packet back to the client
|
|
||||||
/// </summary>
|
|
||||||
public class TextureNotFoundSender : ITextureSender
|
|
||||||
{
|
|
||||||
// private static readonly log4net.ILog m_log
|
|
||||||
// = log4net.LogManager.GetLogger(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);
|
|
||||||
|
|
||||||
// private IClientAPI m_client;
|
|
||||||
// private UUID m_textureId;
|
|
||||||
|
|
||||||
public TextureNotFoundSender(IClientAPI client, UUID textureID)
|
|
||||||
{
|
|
||||||
//m_client = client;
|
|
||||||
//m_textureId = textureID;
|
|
||||||
}
|
|
||||||
|
|
||||||
#region ITextureSender Members
|
|
||||||
|
|
||||||
public bool Sending
|
|
||||||
{
|
|
||||||
get { return false; }
|
|
||||||
set { }
|
|
||||||
}
|
|
||||||
|
|
||||||
public bool Cancel
|
|
||||||
{
|
|
||||||
get { return false; }
|
|
||||||
set { }
|
|
||||||
}
|
|
||||||
|
|
||||||
// See ITextureSender
|
|
||||||
public void UpdateRequest(int discardLevel, uint packetNumber)
|
|
||||||
{
|
|
||||||
// No need to implement since priority changes don't affect this operation
|
|
||||||
}
|
|
||||||
|
|
||||||
// See ITextureSender
|
|
||||||
public bool SendTexturePacket()
|
|
||||||
{
|
|
||||||
// m_log.DebugFormat(
|
|
||||||
// "[TEXTURE NOT FOUND SENDER]: Informing the client that texture {0} cannot be found",
|
|
||||||
// m_textureId);
|
|
||||||
|
|
||||||
// XXX Temporarily disabling as this appears to be causing client crashes on at least
|
|
||||||
// 1.19.0(5) of the Linden Second Life client.
|
|
||||||
// m_client.SendImageNotFound(m_textureId);
|
|
||||||
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
|
|
||||||
#endregion
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
@ -1,265 +0,0 @@
|
||||||
/*
|
|
||||||
* Copyright (c) Contributors, http://opensimulator.org/
|
|
||||||
* See CONTRIBUTORS.TXT for a full list of copyright holders.
|
|
||||||
*
|
|
||||||
* Redistribution and use in source and binary forms, with or without
|
|
||||||
* modification, are permitted provided that the following conditions are met:
|
|
||||||
* * Redistributions of source code must retain the above copyright
|
|
||||||
* notice, this list of conditions and the following disclaimer.
|
|
||||||
* * Redistributions in binary form must reproduce the above copyright
|
|
||||||
* notice, this list of conditions and the following disclaimer in the
|
|
||||||
* documentation and/or other materials provided with the distribution.
|
|
||||||
* * Neither the name of the OpenSimulator Project nor the
|
|
||||||
* names of its contributors may be used to endorse or promote products
|
|
||||||
* derived from this software without specific prior written permission.
|
|
||||||
*
|
|
||||||
* THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY
|
|
||||||
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
|
||||||
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
||||||
* DISCLAIMED. IN NO EVENT SHALL THE CONTRIBUTORS BE LIABLE FOR ANY
|
|
||||||
* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
|
||||||
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
|
||||||
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
|
|
||||||
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
||||||
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
|
|
||||||
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
||||||
*/
|
|
||||||
|
|
||||||
using System;
|
|
||||||
using System.Collections.Generic;
|
|
||||||
using System.Reflection;
|
|
||||||
using log4net;
|
|
||||||
using OpenMetaverse;
|
|
||||||
using OpenSim.Framework;
|
|
||||||
using OpenSim.Framework.Communications.Limit;
|
|
||||||
using OpenSim.Framework.Statistics;
|
|
||||||
using OpenSim.Region.Framework.Interfaces;
|
|
||||||
using OpenSim.Region.Framework.Scenes;
|
|
||||||
|
|
||||||
namespace OpenSim.Region.CoreModules.Agent.TextureDownload
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// This module sets up texture senders in response to client texture requests, and places them on a
|
|
||||||
/// processing queue once those senders have the appropriate data (i.e. a texture retrieved from the
|
|
||||||
/// asset cache).
|
|
||||||
/// </summary>
|
|
||||||
public class UserTextureDownloadService
|
|
||||||
{
|
|
||||||
// private static readonly ILog m_log = LogManager.GetLogger(MethodBase.GetCurrentMethod().DeclaringType);
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// True if the service has been closed, probably because a user with texture requests still queued
|
|
||||||
/// logged out.
|
|
||||||
/// </summary>
|
|
||||||
private bool closed;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// We will allow the client to request the same texture n times before dropping further requests
|
|
||||||
///
|
|
||||||
/// This number includes repeated requests for the same texture at different resolutions (which we don't
|
|
||||||
/// currently handle properly as far as I know). However, this situation should be handled in a more
|
|
||||||
/// sophisticated way.
|
|
||||||
/// </summary>
|
|
||||||
// private static readonly int MAX_ALLOWED_TEXTURE_REQUESTS = 5;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// XXX Also going to limit requests for found textures.
|
|
||||||
/// </summary>
|
|
||||||
// private readonly IRequestLimitStrategy<UUID> foundTextureLimitStrategy
|
|
||||||
// = new RepeatLimitStrategy<UUID>(MAX_ALLOWED_TEXTURE_REQUESTS);
|
|
||||||
|
|
||||||
// private readonly IClientAPI m_client;
|
|
||||||
private readonly Scene m_scene;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Texture Senders are placed in this queue once they have received their texture from the asset
|
|
||||||
/// cache. Another module actually invokes the send.
|
|
||||||
/// </summary>
|
|
||||||
// private readonly OpenSim.Framework.BlockingQueue<ITextureSender> m_sharedSendersQueue;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Holds texture senders before they have received the appropriate texture from the asset cache.
|
|
||||||
/// </summary>
|
|
||||||
private readonly Dictionary<UUID, TextureSender.TextureSender> m_textureSenders = new Dictionary<UUID, TextureSender.TextureSender>();
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// We're going to limit requests for the same missing texture.
|
|
||||||
/// XXX This is really a temporary solution to deal with the situation where a client continually requests
|
|
||||||
/// the same missing textures
|
|
||||||
/// </summary>
|
|
||||||
// private readonly IRequestLimitStrategy<UUID> missingTextureLimitStrategy
|
|
||||||
// = new RepeatLimitStrategy<UUID>(MAX_ALLOWED_TEXTURE_REQUESTS);
|
|
||||||
|
|
||||||
public UserTextureDownloadService(
|
|
||||||
IClientAPI client, Scene scene, OpenSim.Framework.BlockingQueue<ITextureSender> sharedQueue)
|
|
||||||
{
|
|
||||||
// m_client = client;
|
|
||||||
m_scene = scene;
|
|
||||||
// m_sharedSendersQueue = sharedQueue;
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Handle a texture request. This involves creating a texture sender and placing it on the
|
|
||||||
/// previously passed in shared queue.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="e"></param>
|
|
||||||
public void HandleTextureRequest(TextureRequestArgs e)
|
|
||||||
{
|
|
||||||
|
|
||||||
//TextureSender.TextureSender textureSender;
|
|
||||||
|
|
||||||
//TODO: should be working out the data size/ number of packets to be sent for each discard level
|
|
||||||
//if ((e.DiscardLevel >= 0) || (e.Priority != 0))
|
|
||||||
//{
|
|
||||||
//lock (m_textureSenders)
|
|
||||||
//{
|
|
||||||
//if (m_textureSenders.TryGetValue(e.RequestedAssetID, out textureSender))
|
|
||||||
//{
|
|
||||||
// If we've received new non UUID information for this request and it hasn't dispatched
|
|
||||||
// yet, then update the request accordingly.
|
|
||||||
// textureSender.UpdateRequest(e.DiscardLevel, e.PacketNumber);
|
|
||||||
//}
|
|
||||||
//else
|
|
||||||
//{
|
|
||||||
// m_log.DebugFormat("[TEXTURE]: Received a request for texture {0}", e.RequestedAssetID);
|
|
||||||
|
|
||||||
//if (!foundTextureLimitStrategy.AllowRequest(e.RequestedAssetID))
|
|
||||||
//{
|
|
||||||
// m_log.DebugFormat(
|
|
||||||
// "[TEXTURE]: Refusing request for {0} from client {1}",
|
|
||||||
// e.RequestedAssetID, m_client.AgentId);
|
|
||||||
|
|
||||||
//return;
|
|
||||||
//}
|
|
||||||
//else if (!missingTextureLimitStrategy.AllowRequest(e.RequestedAssetID))
|
|
||||||
//{
|
|
||||||
// if (missingTextureLimitStrategy.IsFirstRefusal(e.RequestedAssetID))
|
|
||||||
// {
|
|
||||||
// if (StatsManager.SimExtraStats != null)
|
|
||||||
// StatsManager.SimExtraStats.AddBlockedMissingTextureRequest();
|
|
||||||
|
|
||||||
// Commenting out this message for now as it causes too much noise with other
|
|
||||||
// debug messages.
|
|
||||||
// m_log.DebugFormat(
|
|
||||||
// "[TEXTURE]: Dropping requests for notified missing texture {0} for client {1} since we have received more than {2} requests",
|
|
||||||
// e.RequestedAssetID, m_client.AgentId, MAX_ALLOWED_TEXTURE_REQUESTS);
|
|
||||||
// }
|
|
||||||
|
|
||||||
// return;
|
|
||||||
//}
|
|
||||||
|
|
||||||
m_scene.StatsReporter.AddPendingDownloads(1);
|
|
||||||
|
|
||||||
//TextureSender.TextureSender requestHandler = new TextureSender.TextureSender(m_client, e.DiscardLevel, e.PacketNumber);
|
|
||||||
//m_textureSenders.Add(e.RequestedAssetID, null);
|
|
||||||
|
|
||||||
m_scene.AssetService.Get(e.RequestedAssetID.ToString(), this, TextureReceived);
|
|
||||||
|
|
||||||
|
|
||||||
}
|
|
||||||
|
|
||||||
protected void TextureReceived(string id, Object sender, AssetBase asset)
|
|
||||||
{
|
|
||||||
if (asset != null)
|
|
||||||
TextureCallback(asset.FullID, asset);
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// The callback for the asset cache when a texture has been retrieved. This method queues the
|
|
||||||
/// texture sender for processing.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="textureID"></param>
|
|
||||||
/// <param name="texture"></param>
|
|
||||||
public void TextureCallback(UUID textureID, AssetBase texture)
|
|
||||||
{
|
|
||||||
//m_log.DebugFormat("[USER TEXTURE DOWNLOAD SERVICE]: Calling TextureCallback with {0}, texture == null is {1}", textureID, (texture == null ? true : false));
|
|
||||||
|
|
||||||
// There may still be texture requests pending for a logged out client
|
|
||||||
if (closed)
|
|
||||||
return;
|
|
||||||
|
|
||||||
/*
|
|
||||||
lock (m_textureSenders)
|
|
||||||
{
|
|
||||||
TextureSender.TextureSender textureSender;
|
|
||||||
if (m_textureSenders.TryGetValue(textureID, out textureSender))
|
|
||||||
{
|
|
||||||
// XXX It may be perfectly valid for a texture to have no data... but if we pass
|
|
||||||
// this on to the TextureSender it will blow up, so just discard for now.
|
|
||||||
// Needs investigation.
|
|
||||||
if (texture == null || texture.Data == null)
|
|
||||||
{
|
|
||||||
if (!missingTextureLimitStrategy.IsMonitoringRequests(textureID))
|
|
||||||
{
|
|
||||||
missingTextureLimitStrategy.MonitorRequests(textureID);
|
|
||||||
|
|
||||||
// m_log.DebugFormat(
|
|
||||||
// "[TEXTURE]: Queueing first TextureNotFoundSender for {0}, client {1}",
|
|
||||||
// textureID, m_client.AgentId);
|
|
||||||
}
|
|
||||||
|
|
||||||
ITextureSender textureNotFoundSender = new TextureNotFoundSender(m_client, textureID);
|
|
||||||
EnqueueTextureSender(textureNotFoundSender);
|
|
||||||
}
|
|
||||||
else
|
|
||||||
{
|
|
||||||
if (!textureSender.ImageLoaded)
|
|
||||||
{
|
|
||||||
textureSender.TextureReceived(texture);
|
|
||||||
EnqueueTextureSender(textureSender);
|
|
||||||
|
|
||||||
foundTextureLimitStrategy.MonitorRequests(textureID);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
//m_log.InfoFormat("[TEXTURE] Removing texture sender with uuid {0}", textureID);
|
|
||||||
m_textureSenders.Remove(textureID);
|
|
||||||
//m_log.InfoFormat("[TEXTURE] Current texture senders in dictionary: {0}", m_textureSenders.Count);
|
|
||||||
}
|
|
||||||
else
|
|
||||||
{
|
|
||||||
m_log.WarnFormat(
|
|
||||||
"[TEXTURE]: Got a texture uuid {0} with no sender object to handle it, this shouldn't happen",
|
|
||||||
textureID);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
*/
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Place a ready texture sender on the processing queue.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="textureSender"></param>
|
|
||||||
// private void EnqueueTextureSender(ITextureSender textureSender)
|
|
||||||
// {
|
|
||||||
// textureSender.Cancel = false;
|
|
||||||
// textureSender.Sending = true;
|
|
||||||
//
|
|
||||||
// if (!m_sharedSendersQueue.Contains(textureSender))
|
|
||||||
// {
|
|
||||||
// m_sharedSendersQueue.Enqueue(textureSender);
|
|
||||||
// }
|
|
||||||
// }
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Close this module.
|
|
||||||
/// </summary>
|
|
||||||
internal void Close()
|
|
||||||
{
|
|
||||||
closed = true;
|
|
||||||
|
|
||||||
lock (m_textureSenders)
|
|
||||||
{
|
|
||||||
foreach (TextureSender.TextureSender textureSender in m_textureSenders.Values)
|
|
||||||
{
|
|
||||||
textureSender.Cancel = true;
|
|
||||||
}
|
|
||||||
|
|
||||||
m_textureSenders.Clear();
|
|
||||||
}
|
|
||||||
|
|
||||||
// XXX: It might be possible to also remove pending texture requests from the asset cache queues,
|
|
||||||
// though this might also be more trouble than it's worth.
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
@ -1,212 +0,0 @@
|
||||||
/*
|
|
||||||
* Copyright (c) Contributors, http://opensimulator.org/
|
|
||||||
* See CONTRIBUTORS.TXT for a full list of copyright holders.
|
|
||||||
*
|
|
||||||
* Redistribution and use in source and binary forms, with or without
|
|
||||||
* modification, are permitted provided that the following conditions are met:
|
|
||||||
* * Redistributions of source code must retain the above copyright
|
|
||||||
* notice, this list of conditions and the following disclaimer.
|
|
||||||
* * Redistributions in binary form must reproduce the above copyright
|
|
||||||
* notice, this list of conditions and the following disclaimer in the
|
|
||||||
* documentation and/or other materials provided with the distribution.
|
|
||||||
* * Neither the name of the OpenSimulator Project nor the
|
|
||||||
* names of its contributors may be used to endorse or promote products
|
|
||||||
* derived from this software without specific prior written permission.
|
|
||||||
*
|
|
||||||
* THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY
|
|
||||||
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
|
||||||
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
||||||
* DISCLAIMED. IN NO EVENT SHALL THE CONTRIBUTORS BE LIABLE FOR ANY
|
|
||||||
* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
|
||||||
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
|
||||||
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
|
|
||||||
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
||||||
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
|
|
||||||
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
||||||
*/
|
|
||||||
|
|
||||||
using System;
|
|
||||||
using System.Reflection;
|
|
||||||
using log4net;
|
|
||||||
using OpenSim.Framework;
|
|
||||||
using OpenSim.Region.Framework.Interfaces;
|
|
||||||
|
|
||||||
namespace OpenSim.Region.CoreModules.Agent.TextureSender
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// A TextureSender handles the process of receiving a texture requested by the client from the
|
|
||||||
/// AssetCache, and then sending that texture back to the client.
|
|
||||||
/// </summary>
|
|
||||||
public class TextureSender : ITextureSender
|
|
||||||
{
|
|
||||||
private static readonly ILog m_log
|
|
||||||
= LogManager.GetLogger(MethodBase.GetCurrentMethod().DeclaringType);
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Records the number of times texture send has been called.
|
|
||||||
/// </summary>
|
|
||||||
public int counter = 0;
|
|
||||||
|
|
||||||
public bool ImageLoaded = false;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Holds the texture asset to send.
|
|
||||||
/// </summary>
|
|
||||||
private AssetBase m_asset;
|
|
||||||
|
|
||||||
//public UUID assetID { get { return m_asset.FullID; } }
|
|
||||||
|
|
||||||
// private bool m_cancel = false;
|
|
||||||
|
|
||||||
// See ITextureSender
|
|
||||||
|
|
||||||
// private bool m_sending = false;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// This is actually the number of extra packets required to send the texture data! We always assume
|
|
||||||
/// at least one is required.
|
|
||||||
/// </summary>
|
|
||||||
private int NumPackets = 0;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Holds the packet number to send next. In this case, each packet is 1000 bytes long and starts
|
|
||||||
/// at the 600th byte (0th indexed).
|
|
||||||
/// </summary>
|
|
||||||
private int PacketCounter = 0;
|
|
||||||
|
|
||||||
private int RequestedDiscardLevel = -1;
|
|
||||||
private IClientAPI RequestUser;
|
|
||||||
private uint StartPacketNumber = 0;
|
|
||||||
|
|
||||||
public TextureSender(IClientAPI client, int discardLevel, uint packetNumber)
|
|
||||||
{
|
|
||||||
RequestUser = client;
|
|
||||||
RequestedDiscardLevel = discardLevel;
|
|
||||||
StartPacketNumber = packetNumber;
|
|
||||||
}
|
|
||||||
|
|
||||||
#region ITextureSender Members
|
|
||||||
|
|
||||||
public bool Cancel
|
|
||||||
{
|
|
||||||
get { return false; }
|
|
||||||
set
|
|
||||||
{
|
|
||||||
// m_cancel = value;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
public bool Sending
|
|
||||||
{
|
|
||||||
get { return false; }
|
|
||||||
set
|
|
||||||
{
|
|
||||||
// m_sending = value;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// See ITextureSender
|
|
||||||
public void UpdateRequest(int discardLevel, uint packetNumber)
|
|
||||||
{
|
|
||||||
RequestedDiscardLevel = discardLevel;
|
|
||||||
StartPacketNumber = packetNumber;
|
|
||||||
PacketCounter = (int)StartPacketNumber;
|
|
||||||
}
|
|
||||||
|
|
||||||
// See ITextureSender
|
|
||||||
public bool SendTexturePacket()
|
|
||||||
{
|
|
||||||
//m_log.DebugFormat("[TEXTURE SENDER]: Sending packet for {0}", m_asset.FullID);
|
|
||||||
|
|
||||||
SendPacket();
|
|
||||||
counter++;
|
|
||||||
if ((NumPackets == 0) || (RequestedDiscardLevel == -1) || (PacketCounter > NumPackets) ||
|
|
||||||
((RequestedDiscardLevel > 0) && (counter > 50 + (NumPackets / (RequestedDiscardLevel + 1)))))
|
|
||||||
{
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
|
|
||||||
#endregion
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Load up the texture data to send.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="asset"></param>
|
|
||||||
public void TextureReceived(AssetBase asset)
|
|
||||||
{
|
|
||||||
m_asset = asset;
|
|
||||||
NumPackets = CalculateNumPackets(asset.Data.Length);
|
|
||||||
PacketCounter = (int)StartPacketNumber;
|
|
||||||
ImageLoaded = true;
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Sends a texture packet to the client.
|
|
||||||
/// </summary>
|
|
||||||
private void SendPacket()
|
|
||||||
{
|
|
||||||
if (PacketCounter <= NumPackets)
|
|
||||||
{
|
|
||||||
if (PacketCounter == 0)
|
|
||||||
{
|
|
||||||
if (NumPackets == 0)
|
|
||||||
{
|
|
||||||
RequestUser.SendImageFirstPart(1, m_asset.FullID, (uint)m_asset.Data.Length, m_asset.Data, 2);
|
|
||||||
PacketCounter++;
|
|
||||||
}
|
|
||||||
else
|
|
||||||
{
|
|
||||||
byte[] ImageData1 = new byte[600];
|
|
||||||
Array.Copy(m_asset.Data, 0, ImageData1, 0, 600);
|
|
||||||
|
|
||||||
RequestUser.SendImageFirstPart(
|
|
||||||
(ushort)(NumPackets), m_asset.FullID, (uint)m_asset.Data.Length, ImageData1, 2);
|
|
||||||
PacketCounter++;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
else
|
|
||||||
{
|
|
||||||
int size = m_asset.Data.Length - 600 - (1000 * (PacketCounter - 1));
|
|
||||||
if (size > 1000) size = 1000;
|
|
||||||
byte[] imageData = new byte[size];
|
|
||||||
try
|
|
||||||
{
|
|
||||||
Array.Copy(m_asset.Data, 600 + (1000 * (PacketCounter - 1)), imageData, 0, size);
|
|
||||||
}
|
|
||||||
catch (ArgumentOutOfRangeException)
|
|
||||||
{
|
|
||||||
m_log.Error("[TEXTURE SENDER]: Unable to separate texture into multiple packets: Array bounds failure on asset:" +
|
|
||||||
m_asset.ID);
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
RequestUser.SendImageNextPart((ushort)PacketCounter, m_asset.FullID, imageData);
|
|
||||||
PacketCounter++;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Calculate the number of packets that will be required to send the texture loaded into this sender
|
|
||||||
/// This is actually the number of 1000 byte packets not including an initial 600 byte packet...
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="length"></param>
|
|
||||||
/// <returns></returns>
|
|
||||||
private int CalculateNumPackets(int length)
|
|
||||||
{
|
|
||||||
int numPackets = 0;
|
|
||||||
|
|
||||||
if (length > 600)
|
|
||||||
{
|
|
||||||
//over 600 bytes so split up file
|
|
||||||
int restData = (length - 600);
|
|
||||||
int restPackets = ((restData + 999) / 1000);
|
|
||||||
numPackets = restPackets;
|
|
||||||
}
|
|
||||||
|
|
||||||
return numPackets;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
@ -1,58 +0,0 @@
|
||||||
/*
|
|
||||||
* Copyright (c) Contributors, http://opensimulator.org/
|
|
||||||
* See CONTRIBUTORS.TXT for a full list of copyright holders.
|
|
||||||
*
|
|
||||||
* Redistribution and use in source and binary forms, with or without
|
|
||||||
* modification, are permitted provided that the following conditions are met:
|
|
||||||
* * Redistributions of source code must retain the above copyright
|
|
||||||
* notice, this list of conditions and the following disclaimer.
|
|
||||||
* * Redistributions in binary form must reproduce the above copyright
|
|
||||||
* notice, this list of conditions and the following disclaimer in the
|
|
||||||
* documentation and/or other materials provided with the distribution.
|
|
||||||
* * Neither the name of the OpenSimulator Project nor the
|
|
||||||
* names of its contributors may be used to endorse or promote products
|
|
||||||
* derived from this software without specific prior written permission.
|
|
||||||
*
|
|
||||||
* THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY
|
|
||||||
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
|
||||||
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
||||||
* DISCLAIMED. IN NO EVENT SHALL THE CONTRIBUTORS BE LIABLE FOR ANY
|
|
||||||
* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
|
||||||
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
|
||||||
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
|
|
||||||
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
||||||
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
|
|
||||||
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
||||||
*/
|
|
||||||
|
|
||||||
namespace OpenSim.Region.Framework.Interfaces
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Interface for an object which can send texture information to a client
|
|
||||||
/// </summary>
|
|
||||||
public interface ITextureSender
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Are we in the process of sending the texture?
|
|
||||||
/// </summary>
|
|
||||||
bool Sending { get; set; }
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Has the texture send been cancelled?
|
|
||||||
/// </summary>
|
|
||||||
bool Cancel { get; set; }
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Update the non data properties of a texture request
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="discardLevel"></param>
|
|
||||||
/// <param name="packetNumber"></param>
|
|
||||||
void UpdateRequest(int discardLevel, uint packetNumber);
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Send a texture packet to the client.
|
|
||||||
/// </summary>
|
|
||||||
/// <returns>True if the last packet has been sent, false otherwise.</returns>
|
|
||||||
bool SendTexturePacket();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
Loading…
Reference in New Issue