1
0

IClientAPI.cs 64 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483
  1. /*
  2. * Copyright (c) Contributors, http://opensimulator.org/
  3. * See CONTRIBUTORS.TXT for a full list of copyright holders.
  4. *
  5. * Redistribution and use in source and binary forms, with or without
  6. * modification, are permitted provided that the following conditions are met:
  7. * * Redistributions of source code must retain the above copyright
  8. * notice, this list of conditions and the following disclaimer.
  9. * * Redistributions in binary form must reproduce the above copyright
  10. * notice, this list of conditions and the following disclaimer in the
  11. * documentation and/or other materials provided with the distribution.
  12. * * Neither the name of the OpenSimulator Project nor the
  13. * names of its contributors may be used to endorse or promote products
  14. * derived from this software without specific prior written permission.
  15. *
  16. * THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY
  17. * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  18. * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  19. * DISCLAIMED. IN NO EVENT SHALL THE CONTRIBUTORS BE LIABLE FOR ANY
  20. * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  21. * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  22. * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  23. * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  24. * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  25. * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  26. */
  27. using System;
  28. using System.Collections.Generic;
  29. using System.Net;
  30. using OpenMetaverse;
  31. using OpenMetaverse.Packets;
  32. namespace OpenSim.Framework
  33. {
  34. #region Client API Delegate definitions
  35. public delegate void ViewerEffectEventHandler(IClientAPI sender, List<ViewerEffectEventHandlerArg> args);
  36. public delegate void ChatMessage(Object sender, OSChatMessage e);
  37. public delegate void GenericMessage(Object sender, string method, List<String> args);
  38. public delegate void TextureRequest(Object sender, TextureRequestArgs e);
  39. public delegate void AvatarNowWearing(IClientAPI sender, AvatarWearingArgs e);
  40. public delegate void ImprovedInstantMessage(IClientAPI remoteclient, GridInstantMessage im);
  41. public delegate void RezObject(IClientAPI remoteClient, UUID itemID, Vector3 RayEnd, Vector3 RayStart,
  42. UUID RayTargetID, byte BypassRayCast, bool RayEndIsIntersection,
  43. bool RezSelected, bool RemoveItem, UUID fromTaskID);
  44. public delegate ISceneEntity RezSingleAttachmentFromInv(IClientAPI remoteClient, UUID itemID, uint AttachmentPt);
  45. public delegate void RezMultipleAttachmentsFromInv(IClientAPI remoteClient, List<KeyValuePair<UUID, uint>> rezlist );
  46. public delegate void ObjectAttach(
  47. IClientAPI remoteClient, uint objectLocalID, uint AttachmentPt, bool silent);
  48. public delegate void ModifyTerrain(UUID user,
  49. float height, float seconds, byte size, byte action, float north, float west, float south, float east,
  50. UUID agentId);
  51. public delegate void NetworkStats(int inPackets, int outPackets, int unAckedBytes);
  52. public delegate void CachedTextureRequest(IClientAPI remoteClient, int serial, List<CachedTextureRequestArg> cachedTextureRequest);
  53. public delegate void SetAppearance(IClientAPI remoteClient, Primitive.TextureEntry textureEntry, byte[] visualParams, List<CachedTextureRequestArg> cachedTextureData);
  54. public delegate void StartAnim(IClientAPI remoteClient, UUID animID);
  55. public delegate void StopAnim(IClientAPI remoteClient, UUID animID);
  56. public delegate void LinkObjects(IClientAPI remoteClient, uint parent, List<uint> children);
  57. public delegate void DelinkObjects(List<uint> primIds, IClientAPI client);
  58. public delegate void RequestMapBlocks(IClientAPI remoteClient, int minX, int minY, int maxX, int maxY, uint flag);
  59. public delegate void RequestMapName(IClientAPI remoteClient, string mapName, uint flags);
  60. public delegate void TeleportLocationRequest(
  61. IClientAPI remoteClient, ulong regionHandle, Vector3 position, Vector3 lookAt, uint flags);
  62. public delegate void TeleportLandmarkRequest(
  63. IClientAPI remoteClient, AssetLandmark lm);
  64. public delegate void TeleportCancel(IClientAPI remoteClient);
  65. public delegate void DisconnectUser();
  66. public delegate void RequestAvatarProperties(IClientAPI remoteClient, UUID avatarID);
  67. public delegate void UpdateAvatarProperties(IClientAPI remoteClient, UserProfileData ProfileData);
  68. public delegate void SetAlwaysRun(IClientAPI remoteClient, bool SetAlwaysRun);
  69. public delegate void GenericCall1(IClientAPI remoteClient);
  70. public delegate void GenericCall2();
  71. // really don't want to be passing packets in these events, so this is very temporary.
  72. public delegate void GenericCall4(Packet packet, IClientAPI remoteClient);
  73. public delegate void DeRezObject(
  74. IClientAPI remoteClient, List<uint> localIDs, UUID groupID, DeRezAction action, UUID destinationID);
  75. public delegate void GenericCall5(IClientAPI remoteClient, bool status);
  76. public delegate void GenericCall7(IClientAPI remoteClient, uint localID, string message);
  77. public delegate void UpdateShape(UUID agentID, uint localID, UpdateShapeArgs shapeBlock);
  78. public delegate void ObjectExtraParams(UUID agentID, uint localID, ushort type, bool inUse, byte[] data);
  79. public delegate void ObjectSelect(uint localID, IClientAPI remoteClient);
  80. public delegate void ObjectRequest(uint localID, IClientAPI remoteClient);
  81. public delegate void RequestObjectPropertiesFamily(
  82. IClientAPI remoteClient, UUID AgentID, uint RequestFlags, UUID TaskID);
  83. public delegate void ObjectDeselect(uint localID, IClientAPI remoteClient);
  84. public delegate void ObjectDrop(uint localID, IClientAPI remoteClient);
  85. public delegate void UpdatePrimFlags(
  86. uint localID, bool UsePhysics, bool IsTemporary, bool IsPhantom, ExtraPhysicsData PhysData, IClientAPI remoteClient);
  87. public delegate void UpdatePrimTexture(uint localID, byte[] texture, IClientAPI remoteClient);
  88. public delegate void UpdateVector(uint localID, Vector3 pos, IClientAPI remoteClient);
  89. public delegate void UpdatePrimRotation(uint localID, Quaternion rot, IClientAPI remoteClient);
  90. public delegate void UpdatePrimSingleRotation(uint localID, Quaternion rot, IClientAPI remoteClient);
  91. public delegate void UpdatePrimSingleRotationPosition(uint localID, Quaternion rot, Vector3 pos, IClientAPI remoteClient);
  92. public delegate void UpdatePrimGroupRotation(uint localID, Vector3 pos, Quaternion rot, IClientAPI remoteClient);
  93. public delegate void ObjectDuplicate(uint localID, Vector3 offset, uint dupeFlags, UUID AgentID, UUID GroupID);
  94. public delegate void ObjectDuplicateOnRay(uint localID, uint dupeFlags, UUID AgentID, UUID GroupID,
  95. UUID RayTargetObj, Vector3 RayEnd, Vector3 RayStart,
  96. bool BypassRaycast, bool RayEndIsIntersection, bool CopyCenters,
  97. bool CopyRotates);
  98. public delegate void StatusChange(bool status);
  99. public delegate void NewAvatar(IClientAPI remoteClient, UUID agentID, bool status);
  100. public delegate void UpdateAgent(IClientAPI remoteClient, AgentUpdateArgs agentData);
  101. public delegate void AgentRequestSit(IClientAPI remoteClient, UUID agentID, UUID targetID, Vector3 offset);
  102. public delegate void AgentSit(IClientAPI remoteClient, UUID agentID);
  103. public delegate void LandUndo(IClientAPI remoteClient);
  104. public delegate void AvatarPickerRequest(IClientAPI remoteClient, UUID agentdata, UUID queryID, string UserQuery);
  105. public delegate void GrabObject(
  106. uint localID, Vector3 pos, IClientAPI remoteClient, List<SurfaceTouchEventArgs> surfaceArgs);
  107. public delegate void DeGrabObject(
  108. uint localID, IClientAPI remoteClient, List<SurfaceTouchEventArgs> surfaceArgs);
  109. public delegate void MoveObject(
  110. UUID objectID, Vector3 offset, Vector3 grapPos, IClientAPI remoteClient, List<SurfaceTouchEventArgs> surfaceArgs);
  111. public delegate void SpinStart(UUID objectID, IClientAPI remoteClient);
  112. public delegate void SpinObject(UUID objectID, Quaternion rotation, IClientAPI remoteClient);
  113. public delegate void SpinStop(UUID objectID, IClientAPI remoteClient);
  114. public delegate void ParcelAccessListRequest(
  115. UUID agentID, UUID sessionID, uint flags, int sequenceID, int landLocalID, IClientAPI remote_client);
  116. public delegate void ParcelAccessListUpdateRequest(UUID agentID, uint flags,
  117. int landLocalID, UUID transactionID, int sequenceID,
  118. int sections, List<LandAccessEntry> entries,
  119. IClientAPI remote_client);
  120. public delegate void ParcelPropertiesRequest(
  121. int start_x, int start_y, int end_x, int end_y, int sequence_id, bool snap_selection, IClientAPI remote_client);
  122. public delegate void ParcelDivideRequest(int west, int south, int east, int north, IClientAPI remote_client);
  123. public delegate void ParcelJoinRequest(int west, int south, int east, int north, IClientAPI remote_client);
  124. public delegate void ParcelPropertiesUpdateRequest(LandUpdateArgs args, int local_id, IClientAPI remote_client);
  125. public delegate void ParcelSelectObjects(int land_local_id, int request_type, List<UUID> returnIDs, IClientAPI remote_client);
  126. public delegate void ParcelObjectOwnerRequest(int local_id, IClientAPI remote_client);
  127. public delegate void ParcelAbandonRequest(int local_id, IClientAPI remote_client);
  128. public delegate void ParcelGodForceOwner(int local_id, UUID ownerID, IClientAPI remote_client);
  129. public delegate void ParcelReclaim(int local_id, IClientAPI remote_client);
  130. public delegate void ParcelReturnObjectsRequest(
  131. int local_id, uint return_type, UUID[] agent_ids, UUID[] selected_ids, IClientAPI remote_client);
  132. public delegate void ParcelDeedToGroup(int local_id, UUID group_id, IClientAPI remote_client);
  133. public delegate void EstateOwnerMessageRequest(
  134. UUID AgentID, UUID SessionID, UUID TransactionID, UUID Invoice, byte[] Method, byte[][] Parameters,
  135. IClientAPI remote_client);
  136. public delegate void RegionInfoRequest(IClientAPI remote_client);
  137. public delegate void EstateCovenantRequest(IClientAPI remote_client);
  138. public delegate void UUIDNameRequest(UUID id, IClientAPI remote_client);
  139. public delegate void AddNewPrim(
  140. UUID ownerID, UUID groupID, Vector3 RayEnd, Quaternion rot, PrimitiveBaseShape shape, byte bypassRaycast, Vector3 RayStart,
  141. UUID RayTargetID,
  142. byte RayEndIsIntersection);
  143. public delegate void RequestGodlikePowers(
  144. UUID AgentID, UUID SessionID, UUID token, bool GodLike, IClientAPI remote_client);
  145. public delegate void GodKickUser(
  146. UUID GodAgentID, UUID GodSessionID, UUID AgentID, uint kickflags, byte[] reason);
  147. public delegate void CreateInventoryFolder(
  148. IClientAPI remoteClient, UUID folderID, ushort folderType, string folderName, UUID parentID);
  149. public delegate void UpdateInventoryFolder(
  150. IClientAPI remoteClient, UUID folderID, ushort type, string name, UUID parentID);
  151. public delegate void MoveInventoryFolder(
  152. IClientAPI remoteClient, UUID folderID, UUID parentID);
  153. public delegate void CreateNewInventoryItem(
  154. IClientAPI remoteClient, UUID transActionID, UUID folderID, uint callbackID, string description, string name,
  155. sbyte invType, sbyte type, byte wearableType, uint nextOwnerMask, int creationDate);
  156. public delegate void LinkInventoryItem(
  157. IClientAPI remoteClient, UUID transActionID, UUID folderID, uint callbackID, string description, string name,
  158. sbyte invType, sbyte type, UUID olditemID);
  159. public delegate void FetchInventoryDescendents(
  160. IClientAPI remoteClient, UUID folderID, UUID ownerID, bool fetchFolders, bool fetchItems, int sortOrder);
  161. public delegate void PurgeInventoryDescendents(
  162. IClientAPI remoteClient, UUID folderID);
  163. public delegate void FetchInventory(IClientAPI remoteClient, UUID itemID, UUID ownerID);
  164. public delegate void RequestTaskInventory(IClientAPI remoteClient, uint localID);
  165. /* public delegate void UpdateInventoryItem(
  166. IClientAPI remoteClient, UUID transactionID, UUID itemID, string name, string description,
  167. uint nextOwnerMask);*/
  168. public delegate void UpdateInventoryItem(
  169. IClientAPI remoteClient, UUID transactionID, UUID itemID, InventoryItemBase itemUpd);
  170. public delegate void CopyInventoryItem(
  171. IClientAPI remoteClient, uint callbackID, UUID oldAgentID, UUID oldItemID, UUID newFolderID,
  172. string newName);
  173. public delegate void MoveInventoryItem(
  174. IClientAPI remoteClient, List<InventoryItemBase> items);
  175. public delegate void RemoveInventoryItem(
  176. IClientAPI remoteClient, List<UUID> itemIDs);
  177. public delegate void RemoveInventoryFolder(
  178. IClientAPI remoteClient, List<UUID> folderIDs);
  179. public delegate void RequestAsset(IClientAPI remoteClient, RequestAssetArgs transferRequest);
  180. public delegate void AbortXfer(IClientAPI remoteClient, ulong xferID);
  181. public delegate void RezScript(IClientAPI remoteClient, InventoryItemBase item, UUID transactionID, uint localID);
  182. public delegate void UpdateTaskInventory(
  183. IClientAPI remoteClient, UUID transactionID, TaskInventoryItem item, uint localID);
  184. public delegate void MoveTaskInventory(IClientAPI remoteClient, UUID folderID, uint localID, UUID itemID);
  185. public delegate void RemoveTaskInventory(IClientAPI remoteClient, UUID itemID, uint localID);
  186. public delegate void UDPAssetUploadRequest(
  187. IClientAPI remoteClient, UUID assetID, UUID transaction, sbyte type, byte[] data, bool storeLocal,
  188. bool tempFile);
  189. public delegate void XferReceive(IClientAPI remoteClient, ulong xferID, uint packetID, byte[] data);
  190. public delegate void RequestXfer(IClientAPI remoteClient, ulong xferID, string fileName);
  191. public delegate void ConfirmXfer(IClientAPI remoteClient, ulong xferID, uint packetID);
  192. public delegate void FriendActionDelegate(
  193. IClientAPI remoteClient, UUID transactionID, List<UUID> callingCardFolders);
  194. public delegate void FriendshipTermination(IClientAPI remoteClient, UUID ExID);
  195. public delegate void MoneyTransferRequest(
  196. UUID sourceID, UUID destID, int amount, int transactionType, string description);
  197. public delegate void ParcelBuy(UUID agentId, UUID groupId, bool final, bool groupOwned,
  198. bool removeContribution, int parcelLocalID, int parcelArea, int parcelPrice,
  199. bool authenticated);
  200. // We keep all this information for fraud purposes in the future.
  201. public delegate void MoneyBalanceRequest(IClientAPI remoteClient, UUID agentID, UUID sessionID, UUID TransactionID);
  202. public delegate void ObjectPermissions(
  203. IClientAPI controller, UUID agentID, UUID sessionID, byte field, uint localId, uint mask, byte set);
  204. public delegate void EconomyDataRequest(IClientAPI client);
  205. public delegate void ObjectIncludeInSearch(IClientAPI remoteClient, bool IncludeInSearch, uint localID);
  206. public delegate void ScriptAnswer(IClientAPI remoteClient, UUID objectID, UUID itemID, int answer);
  207. public delegate void RequestPayPrice(IClientAPI remoteClient, UUID objectID);
  208. public delegate void ObjectSaleInfo(
  209. IClientAPI remoteClient, UUID agentID, UUID sessionID, uint localID, byte saleType, int salePrice);
  210. public delegate void ObjectBuy(
  211. IClientAPI remoteClient, UUID agentID, UUID sessionID, UUID groupID, UUID categoryID, uint localID,
  212. byte saleType, int salePrice);
  213. public delegate void BuyObjectInventory(
  214. IClientAPI remoteClient, UUID agentID, UUID sessionID, UUID objectID, UUID itemID, UUID folderID);
  215. public delegate void ForceReleaseControls(IClientAPI remoteClient, UUID agentID);
  216. public delegate void GodLandStatRequest(
  217. int parcelID, uint reportType, uint requestflags, string filter, IClientAPI remoteClient);
  218. //Estate Requests
  219. public delegate void DetailedEstateDataRequest(IClientAPI remoteClient, UUID invoice);
  220. public delegate void SetEstateFlagsRequest(
  221. bool blockTerraform, bool noFly, bool allowDamage, bool blockLandResell, int maxAgents, float objectBonusFactor,
  222. int matureLevel, bool restrictPushObject, bool allowParcelChanges);
  223. public delegate void SetEstateTerrainBaseTexture(IClientAPI remoteClient, int corner, UUID side);
  224. public delegate void SetEstateTerrainDetailTexture(IClientAPI remoteClient, int corner, UUID side);
  225. public delegate void SetEstateTerrainTextureHeights(IClientAPI remoteClient, int corner, float lowVal, float highVal
  226. );
  227. public delegate void CommitEstateTerrainTextureRequest(IClientAPI remoteClient);
  228. public delegate void SetRegionTerrainSettings(
  229. float waterHeight, float terrainRaiseLimit, float terrainLowerLimit, bool estateSun, bool fixedSun,
  230. float sunHour, bool globalSun, bool estateFixed, float estateSunHour);
  231. public delegate void EstateChangeInfo(IClientAPI client, UUID invoice, UUID senderID, UInt32 param1, UInt32 param2);
  232. public delegate void EstateManageTelehub(IClientAPI client, UUID invoice, UUID senderID, string cmd, UInt32 param1);
  233. public delegate void RequestTerrain(IClientAPI remoteClient, string clientFileName);
  234. public delegate void BakeTerrain(IClientAPI remoteClient);
  235. public delegate void EstateRestartSimRequest(IClientAPI remoteClient, int secondsTilReboot);
  236. public delegate void EstateChangeCovenantRequest(IClientAPI remoteClient, UUID newCovenantID);
  237. public delegate void UpdateEstateAccessDeltaRequest(
  238. IClientAPI remote_client, UUID invoice, int estateAccessType, UUID user);
  239. public delegate void SimulatorBlueBoxMessageRequest(
  240. IClientAPI remoteClient, UUID invoice, UUID senderID, UUID sessionID, string senderName, string message);
  241. public delegate void EstateBlueBoxMessageRequest(
  242. IClientAPI remoteClient, UUID invoice, UUID senderID, UUID sessionID, string senderName, string message);
  243. public delegate void EstateDebugRegionRequest(
  244. IClientAPI remoteClient, UUID invoice, UUID senderID, bool scripted, bool collisionEvents, bool physics);
  245. public delegate void EstateTeleportOneUserHomeRequest(
  246. IClientAPI remoteClient, UUID invoice, UUID senderID, UUID prey);
  247. public delegate void EstateTeleportAllUsersHomeRequest(IClientAPI remoteClient, UUID invoice, UUID senderID);
  248. public delegate void RegionHandleRequest(IClientAPI remoteClient, UUID regionID);
  249. public delegate void ParcelInfoRequest(IClientAPI remoteClient, UUID parcelID);
  250. public delegate void ScriptReset(IClientAPI remoteClient, UUID objectID, UUID itemID);
  251. public delegate void GetScriptRunning(IClientAPI remoteClient, UUID objectID, UUID itemID);
  252. public delegate void SetScriptRunning(IClientAPI remoteClient, UUID objectID, UUID itemID, bool running);
  253. public delegate void ActivateGesture(IClientAPI client, UUID gestureid, UUID assetId);
  254. public delegate void DeactivateGesture(IClientAPI client, UUID gestureid);
  255. public delegate void TerrainUnacked(IClientAPI remoteClient, int patchX, int patchY);
  256. public delegate void ObjectOwner(IClientAPI remoteClient, UUID ownerID, UUID groupID, List<uint> localIDs);
  257. public delegate void DirPlacesQuery(
  258. IClientAPI remoteClient, UUID queryID, string queryText, int queryFlags, int category, string simName,
  259. int queryStart);
  260. public delegate void DirFindQuery(
  261. IClientAPI remoteClient, UUID queryID, string queryText, uint queryFlags, int queryStart);
  262. public delegate void DirLandQuery(
  263. IClientAPI remoteClient, UUID queryID, uint queryFlags, uint searchType, int price, int area, int queryStart);
  264. public delegate void DirPopularQuery(IClientAPI remoteClient, UUID queryID, uint queryFlags);
  265. public delegate void DirClassifiedQuery(
  266. IClientAPI remoteClient, UUID queryID, string queryText, uint queryFlags, uint category, int queryStart);
  267. public delegate void EventInfoRequest(IClientAPI remoteClient, uint eventID);
  268. public delegate void ParcelSetOtherCleanTime(IClientAPI remoteClient, int localID, int otherCleanTime);
  269. public delegate void MapItemRequest(
  270. IClientAPI remoteClient, uint flags, uint EstateID, bool godlike, uint itemtype, ulong regionhandle);
  271. public delegate void OfferCallingCard(IClientAPI remoteClient, UUID destID, UUID transactionID);
  272. public delegate void AcceptCallingCard(IClientAPI remoteClient, UUID transactionID, UUID folderID);
  273. public delegate void DeclineCallingCard(IClientAPI remoteClient, UUID transactionID);
  274. public delegate void SoundTrigger(
  275. UUID soundId, UUID ownerid, UUID objid, UUID parentid, double Gain, Vector3 Position, UInt64 Handle, float radius);
  276. public delegate void StartLure(byte lureType, string message, UUID targetID, IClientAPI client);
  277. public delegate void TeleportLureRequest(UUID lureID, uint teleportFlags, IClientAPI client);
  278. public delegate void ClassifiedInfoRequest(UUID classifiedID, IClientAPI client);
  279. public delegate void ClassifiedInfoUpdate(UUID classifiedID, uint category, string name, string description, UUID parcelID, uint parentEstate, UUID snapshotID, Vector3 globalPos, byte classifiedFlags, int price, IClientAPI client);
  280. public delegate void ClassifiedDelete(UUID classifiedID, IClientAPI client);
  281. public delegate void EventNotificationAddRequest(uint EventID, IClientAPI client);
  282. public delegate void EventNotificationRemoveRequest(uint EventID, IClientAPI client);
  283. public delegate void EventGodDelete(uint eventID, UUID queryID, string queryText, uint queryFlags, int queryStart, IClientAPI client);
  284. public delegate void ParcelDwellRequest(int localID, IClientAPI client);
  285. public delegate void UserInfoRequest(IClientAPI client);
  286. public delegate void UpdateUserInfo(bool imViaEmail, bool visible, IClientAPI client);
  287. public delegate void RetrieveInstantMessages(IClientAPI client);
  288. public delegate void PickDelete(IClientAPI client, UUID pickID);
  289. public delegate void PickGodDelete(IClientAPI client, UUID agentID, UUID pickID, UUID queryID);
  290. public delegate void PickInfoUpdate(IClientAPI client, UUID pickID, UUID creatorID, bool topPick, string name, string desc, UUID snapshotID, int sortOrder, bool enabled);
  291. public delegate void AvatarNotesUpdate(IClientAPI client, UUID targetID, string notes);
  292. public delegate void MuteListRequest(IClientAPI client, uint muteCRC);
  293. public delegate void AvatarInterestUpdate(IClientAPI client, uint wantmask, string wanttext, uint skillsmask, string skillstext, string languages);
  294. public delegate void GrantUserFriendRights(IClientAPI client, UUID target, int rights);
  295. public delegate void PlacesQuery(UUID QueryID, UUID TransactionID, string QueryText, uint QueryFlags, byte Category, string SimName, IClientAPI client);
  296. public delegate void AgentFOV(IClientAPI client, float verticalAngle);
  297. public delegate void MuteListEntryUpdate(IClientAPI client, UUID MuteID, string Name, int Flags,UUID AgentID);
  298. public delegate void MuteListEntryRemove(IClientAPI client, UUID MuteID, string Name, UUID AgentID);
  299. public delegate void AvatarInterestReply(IClientAPI client,UUID target, uint wantmask, string wanttext, uint skillsmask, string skillstext, string languages);
  300. public delegate void FindAgentUpdate(IClientAPI client, UUID hunter, UUID target);
  301. public delegate void TrackAgentUpdate(IClientAPI client, UUID hunter, UUID target);
  302. public delegate void FreezeUserUpdate(IClientAPI client, UUID parcelowner,uint flags, UUID target);
  303. public delegate void EjectUserUpdate(IClientAPI client, UUID parcelowner,uint flags, UUID target);
  304. public delegate void NewUserReport(IClientAPI client, string regionName,UUID abuserID, byte catagory, byte checkflags, string details, UUID objectID, Vector3 postion, byte reportType ,UUID screenshotID, string Summary, UUID reporter);
  305. public delegate void GodUpdateRegionInfoUpdate(IClientAPI client, float BillableFactor, ulong EstateID, ulong RegionFlags, byte[] SimName,int RedirectX, int RedirectY);
  306. public delegate void GodlikeMessage(IClientAPI client, UUID requester, byte[] Method, byte[] Parameter);
  307. public delegate void SaveStateHandler(IClientAPI client,UUID agentID);
  308. public delegate void GroupAccountSummaryRequest(IClientAPI client,UUID agentID, UUID groupID);
  309. public delegate void GroupAccountDetailsRequest(IClientAPI client,UUID agentID, UUID groupID, UUID transactionID, UUID sessionID);
  310. public delegate void GroupAccountTransactionsRequest(IClientAPI client,UUID agentID, UUID groupID, UUID transactionID, UUID sessionID);
  311. public delegate void ParcelBuyPass(IClientAPI client, UUID agentID, int ParcelLocalID);
  312. public delegate void ParcelGodMark(IClientAPI client, UUID agentID, int ParcelLocalID);
  313. public delegate void GroupActiveProposalsRequest(IClientAPI client,UUID agentID, UUID groupID, UUID transactionID, UUID sessionID);
  314. public delegate void GroupVoteHistoryRequest(IClientAPI client,UUID agentID, UUID groupID, UUID transactionID, UUID sessionID);
  315. public delegate void SimWideDeletesDelegate(IClientAPI client,UUID agentID, int flags, UUID targetID);
  316. public delegate void SendPostcard(IClientAPI client);
  317. #endregion
  318. public struct DirPlacesReplyData
  319. {
  320. public UUID parcelID;
  321. public string name;
  322. public bool forSale;
  323. public bool auction;
  324. public float dwell;
  325. public uint Status;
  326. }
  327. public struct DirPeopleReplyData
  328. {
  329. public UUID agentID;
  330. public string firstName;
  331. public string lastName;
  332. public string group;
  333. public bool online;
  334. public int reputation;
  335. }
  336. public struct DirEventsReplyData
  337. {
  338. public UUID ownerID;
  339. public string name;
  340. public uint eventID;
  341. public string date;
  342. public uint unixTime;
  343. public uint eventFlags;
  344. public uint Status;
  345. }
  346. public struct DirGroupsReplyData
  347. {
  348. public UUID groupID;
  349. public string groupName;
  350. public int members;
  351. public float searchOrder;
  352. }
  353. public struct DirClassifiedReplyData
  354. {
  355. public UUID classifiedID;
  356. public string name;
  357. public byte classifiedFlags;
  358. public uint creationDate;
  359. public uint expirationDate;
  360. public int price;
  361. public uint Status;
  362. }
  363. public struct DirLandReplyData
  364. {
  365. public UUID parcelID;
  366. public string name;
  367. public bool auction;
  368. public bool forSale;
  369. public int salePrice;
  370. public int actualArea;
  371. }
  372. public struct DirPopularReplyData
  373. {
  374. public UUID parcelID;
  375. public string name;
  376. public float dwell;
  377. }
  378. public class IEntityUpdate
  379. {
  380. private ISceneEntity m_entity;
  381. private uint m_flags;
  382. private int m_updateTime;
  383. public ISceneEntity Entity
  384. {
  385. get { return m_entity; }
  386. }
  387. public uint Flags
  388. {
  389. get { return m_flags; }
  390. }
  391. public int UpdateTime
  392. {
  393. get { return m_updateTime; }
  394. }
  395. public virtual void Update(IEntityUpdate update)
  396. {
  397. m_flags |= update.Flags;
  398. // Use the older of the updates as the updateTime
  399. if (Util.EnvironmentTickCountCompare(UpdateTime, update.UpdateTime) > 0)
  400. m_updateTime = update.UpdateTime;
  401. }
  402. public IEntityUpdate(ISceneEntity entity, uint flags)
  403. {
  404. m_entity = entity;
  405. m_flags = flags;
  406. m_updateTime = Util.EnvironmentTickCount();
  407. }
  408. public IEntityUpdate(ISceneEntity entity, uint flags, Int32 updateTime)
  409. {
  410. m_entity = entity;
  411. m_flags = flags;
  412. m_updateTime = updateTime;
  413. }
  414. }
  415. public class EntityUpdate : IEntityUpdate
  416. {
  417. private float m_timeDilation;
  418. public float TimeDilation
  419. {
  420. get { return m_timeDilation; }
  421. }
  422. public EntityUpdate(ISceneEntity entity, PrimUpdateFlags flags, float timedilation)
  423. : base(entity, (uint)flags)
  424. {
  425. // Flags = flags;
  426. m_timeDilation = timedilation;
  427. }
  428. public EntityUpdate(ISceneEntity entity, PrimUpdateFlags flags, float timedilation, Int32 updateTime)
  429. : base(entity,(uint)flags,updateTime)
  430. {
  431. m_timeDilation = timedilation;
  432. }
  433. }
  434. public class PlacesReplyData
  435. {
  436. public UUID OwnerID;
  437. public string Name;
  438. public string Desc;
  439. public int ActualArea;
  440. public int BillableArea;
  441. public byte Flags;
  442. public uint GlobalX;
  443. public uint GlobalY;
  444. public uint GlobalZ;
  445. public string SimName;
  446. public UUID SnapshotID;
  447. public uint Dwell;
  448. public int Price;
  449. }
  450. /// <summary>
  451. /// Specifies the fields that have been changed when sending a prim or
  452. /// avatar update
  453. /// </summary>
  454. [Flags]
  455. public enum PrimUpdateFlags : uint
  456. {
  457. None = 0,
  458. AttachmentPoint = 1 << 0,
  459. Material = 1 << 1,
  460. ClickAction = 1 << 2,
  461. Scale = 1 << 3,
  462. ParentID = 1 << 4,
  463. PrimFlags = 1 << 5,
  464. PrimData = 1 << 6,
  465. MediaURL = 1 << 7,
  466. ScratchPad = 1 << 8,
  467. Textures = 1 << 9,
  468. TextureAnim = 1 << 10,
  469. NameValue = 1 << 11,
  470. Position = 1 << 12,
  471. Rotation = 1 << 13,
  472. Velocity = 1 << 14,
  473. Acceleration = 1 << 15,
  474. AngularVelocity = 1 << 16,
  475. CollisionPlane = 1 << 17,
  476. Text = 1 << 18,
  477. Particles = 1 << 19,
  478. ExtraData = 1 << 20,
  479. Sound = 1 << 21,
  480. Joint = 1 << 22,
  481. FullUpdate = UInt32.MaxValue
  482. }
  483. public static class PrimUpdateFlagsExtensions
  484. {
  485. public static bool HasFlag(this PrimUpdateFlags updateFlags, PrimUpdateFlags flag)
  486. {
  487. return (updateFlags & flag) == flag;
  488. }
  489. }
  490. public interface IClientAPI
  491. {
  492. Vector3 StartPos { get; set; }
  493. UUID AgentId { get; }
  494. /// <summary>
  495. /// The scene agent for this client. This will only be set if the client has an agent in a scene (i.e. if it
  496. /// is connected).
  497. /// </summary>
  498. ISceneAgent SceneAgent { get; set; }
  499. UUID SessionId { get; }
  500. UUID SecureSessionId { get; }
  501. UUID ActiveGroupId { get; }
  502. string ActiveGroupName { get; }
  503. ulong ActiveGroupPowers { get; }
  504. ulong GetGroupPowers(UUID groupID);
  505. bool IsGroupMember(UUID GroupID);
  506. string FirstName { get; }
  507. string LastName { get; }
  508. IScene Scene { get; }
  509. // [Obsolete("LLClientView Specific - Replace with ???")]
  510. int NextAnimationSequenceNumber { get; }
  511. /// <summary>
  512. /// Returns the full name of the agent/avatar represented by this client
  513. /// </summary>
  514. string Name { get; }
  515. /// <summary>
  516. /// True if the client is active (sending and receiving new UDP messages). False if the client is being closed.
  517. /// </summary>
  518. bool IsActive { get; set; }
  519. /// <summary>
  520. /// Set if the client is closing due to a logout request
  521. /// </summary>
  522. /// <remarks>
  523. /// Do not use this flag if you want to know if the client is closing, since it will not be set in other
  524. /// circumstances (e.g. if a child agent is closed or the agent is kicked off the simulator). Use IsActive
  525. /// instead with a IClientAPI.SceneAgent.IsChildAgent check if necessary.
  526. ///
  527. /// Only set for root agents.
  528. /// </remarks>
  529. bool IsLoggingOut { get; set; }
  530. bool SendLogoutPacketWhenClosing { set; }
  531. // [Obsolete("LLClientView Specific - Circuits are unique to LLClientView")]
  532. uint CircuitCode { get; }
  533. IPEndPoint RemoteEndPoint { get; }
  534. event GenericMessage OnGenericMessage;
  535. // [Obsolete("LLClientView Specific - Replace with more bare-bones arguments.")]
  536. event ImprovedInstantMessage OnInstantMessage;
  537. // [Obsolete("LLClientView Specific - Replace with more bare-bones arguments. Rename OnChat.")]
  538. event ChatMessage OnChatFromClient;
  539. // [Obsolete("LLClientView Specific - Replace with more bare-bones arguments.")]
  540. event TextureRequest OnRequestTexture;
  541. // [Obsolete("LLClientView Specific - Remove bitbuckets. Adam, can you be more specific here.. as I don't see any bit buckets.")]
  542. event RezObject OnRezObject;
  543. // [Obsolete("LLClientView Specific - Replace with more suitable arguments.")]
  544. event ModifyTerrain OnModifyTerrain;
  545. event BakeTerrain OnBakeTerrain;
  546. event EstateChangeInfo OnEstateChangeInfo;
  547. event EstateManageTelehub OnEstateManageTelehub;
  548. // [Obsolete("LLClientView Specific.")]
  549. event CachedTextureRequest OnCachedTextureRequest;
  550. event SetAppearance OnSetAppearance;
  551. // [Obsolete("LLClientView Specific - Replace and rename OnAvatarUpdate. Difference from SetAppearance?")]
  552. event AvatarNowWearing OnAvatarNowWearing;
  553. event RezSingleAttachmentFromInv OnRezSingleAttachmentFromInv;
  554. event RezMultipleAttachmentsFromInv OnRezMultipleAttachmentsFromInv;
  555. event UUIDNameRequest OnDetachAttachmentIntoInv;
  556. event ObjectAttach OnObjectAttach;
  557. event ObjectDeselect OnObjectDetach;
  558. event ObjectDrop OnObjectDrop;
  559. event StartAnim OnStartAnim;
  560. event StopAnim OnStopAnim;
  561. event LinkObjects OnLinkObjects;
  562. event DelinkObjects OnDelinkObjects;
  563. event RequestMapBlocks OnRequestMapBlocks;
  564. event RequestMapName OnMapNameRequest;
  565. event TeleportLocationRequest OnTeleportLocationRequest;
  566. event DisconnectUser OnDisconnectUser;
  567. event RequestAvatarProperties OnRequestAvatarProperties;
  568. event SetAlwaysRun OnSetAlwaysRun;
  569. event TeleportLandmarkRequest OnTeleportLandmarkRequest;
  570. event TeleportCancel OnTeleportCancel;
  571. event DeRezObject OnDeRezObject;
  572. event Action<IClientAPI> OnRegionHandShakeReply;
  573. event GenericCall1 OnRequestWearables;
  574. event Action<IClientAPI, bool> OnCompleteMovementToRegion;
  575. /// <summary>
  576. /// Called when an AgentUpdate message is received and before OnAgentUpdate.
  577. /// </summary>
  578. /// <remarks>
  579. /// Listeners must not retain a reference to AgentUpdateArgs since this object may be reused for subsequent AgentUpdates.
  580. /// </remarks>
  581. event UpdateAgent OnPreAgentUpdate;
  582. /// <summary>
  583. /// Called when an AgentUpdate message is received and after OnPreAgentUpdate.
  584. /// </summary>
  585. /// <remarks>
  586. /// Listeners must not retain a reference to AgentUpdateArgs since this object may be reused for subsequent AgentUpdates.
  587. /// </remarks>
  588. event UpdateAgent OnAgentUpdate;
  589. event UpdateAgent OnAgentCameraUpdate;
  590. event AgentRequestSit OnAgentRequestSit;
  591. event AgentSit OnAgentSit;
  592. event AvatarPickerRequest OnAvatarPickerRequest;
  593. event Action<IClientAPI> OnRequestAvatarsData;
  594. event AddNewPrim OnAddPrim;
  595. event FetchInventory OnAgentDataUpdateRequest;
  596. event TeleportLocationRequest OnSetStartLocationRequest;
  597. event RequestGodlikePowers OnRequestGodlikePowers;
  598. event GodKickUser OnGodKickUser;
  599. event ObjectDuplicate OnObjectDuplicate;
  600. event ObjectDuplicateOnRay OnObjectDuplicateOnRay;
  601. event GrabObject OnGrabObject;
  602. event DeGrabObject OnDeGrabObject;
  603. event MoveObject OnGrabUpdate;
  604. event SpinStart OnSpinStart;
  605. event SpinObject OnSpinUpdate;
  606. event SpinStop OnSpinStop;
  607. event UpdateShape OnUpdatePrimShape;
  608. event ObjectExtraParams OnUpdateExtraParams;
  609. event ObjectRequest OnObjectRequest;
  610. event ObjectSelect OnObjectSelect;
  611. event ObjectDeselect OnObjectDeselect;
  612. event GenericCall7 OnObjectDescription;
  613. event GenericCall7 OnObjectName;
  614. event GenericCall7 OnObjectClickAction;
  615. event GenericCall7 OnObjectMaterial;
  616. event RequestObjectPropertiesFamily OnRequestObjectPropertiesFamily;
  617. event UpdatePrimFlags OnUpdatePrimFlags;
  618. event UpdatePrimTexture OnUpdatePrimTexture;
  619. event UpdateVector OnUpdatePrimGroupPosition;
  620. event UpdateVector OnUpdatePrimSinglePosition;
  621. event UpdatePrimRotation OnUpdatePrimGroupRotation;
  622. event UpdatePrimSingleRotation OnUpdatePrimSingleRotation;
  623. event UpdatePrimSingleRotationPosition OnUpdatePrimSingleRotationPosition;
  624. event UpdatePrimGroupRotation OnUpdatePrimGroupMouseRotation;
  625. event UpdateVector OnUpdatePrimScale;
  626. event UpdateVector OnUpdatePrimGroupScale;
  627. event StatusChange OnChildAgentStatus;
  628. event GenericCall2 OnStopMovement;
  629. event Action<UUID> OnRemoveAvatar;
  630. event ObjectPermissions OnObjectPermissions;
  631. event CreateNewInventoryItem OnCreateNewInventoryItem;
  632. event LinkInventoryItem OnLinkInventoryItem;
  633. event CreateInventoryFolder OnCreateNewInventoryFolder;
  634. event UpdateInventoryFolder OnUpdateInventoryFolder;
  635. event MoveInventoryFolder OnMoveInventoryFolder;
  636. event FetchInventoryDescendents OnFetchInventoryDescendents;
  637. event PurgeInventoryDescendents OnPurgeInventoryDescendents;
  638. event FetchInventory OnFetchInventory;
  639. event RequestTaskInventory OnRequestTaskInventory;
  640. event UpdateInventoryItem OnUpdateInventoryItem;
  641. event CopyInventoryItem OnCopyInventoryItem;
  642. event MoveInventoryItem OnMoveInventoryItem;
  643. event RemoveInventoryFolder OnRemoveInventoryFolder;
  644. event RemoveInventoryItem OnRemoveInventoryItem;
  645. event UDPAssetUploadRequest OnAssetUploadRequest;
  646. event XferReceive OnXferReceive;
  647. event RequestXfer OnRequestXfer;
  648. event ConfirmXfer OnConfirmXfer;
  649. event AbortXfer OnAbortXfer;
  650. event RezScript OnRezScript;
  651. event UpdateTaskInventory OnUpdateTaskInventory;
  652. event MoveTaskInventory OnMoveTaskItem;
  653. event RemoveTaskInventory OnRemoveTaskItem;
  654. event RequestAsset OnRequestAsset;
  655. event UUIDNameRequest OnNameFromUUIDRequest;
  656. event ParcelAccessListRequest OnParcelAccessListRequest;
  657. event ParcelAccessListUpdateRequest OnParcelAccessListUpdateRequest;
  658. event ParcelPropertiesRequest OnParcelPropertiesRequest;
  659. event ParcelDivideRequest OnParcelDivideRequest;
  660. event ParcelJoinRequest OnParcelJoinRequest;
  661. event ParcelPropertiesUpdateRequest OnParcelPropertiesUpdateRequest;
  662. event ParcelSelectObjects OnParcelSelectObjects;
  663. event ParcelObjectOwnerRequest OnParcelObjectOwnerRequest;
  664. event ParcelAbandonRequest OnParcelAbandonRequest;
  665. event ParcelGodForceOwner OnParcelGodForceOwner;
  666. event ParcelReclaim OnParcelReclaim;
  667. event ParcelReturnObjectsRequest OnParcelReturnObjectsRequest;
  668. event ParcelDeedToGroup OnParcelDeedToGroup;
  669. event RegionInfoRequest OnRegionInfoRequest;
  670. event EstateCovenantRequest OnEstateCovenantRequest;
  671. event FriendActionDelegate OnApproveFriendRequest;
  672. event FriendActionDelegate OnDenyFriendRequest;
  673. event FriendshipTermination OnTerminateFriendship;
  674. // Financial packets
  675. event MoneyTransferRequest OnMoneyTransferRequest;
  676. event EconomyDataRequest OnEconomyDataRequest;
  677. event MoneyBalanceRequest OnMoneyBalanceRequest;
  678. event UpdateAvatarProperties OnUpdateAvatarProperties;
  679. event ParcelBuy OnParcelBuy;
  680. event RequestPayPrice OnRequestPayPrice;
  681. event ObjectSaleInfo OnObjectSaleInfo;
  682. event ObjectBuy OnObjectBuy;
  683. event BuyObjectInventory OnBuyObjectInventory;
  684. event RequestTerrain OnRequestTerrain;
  685. event RequestTerrain OnUploadTerrain;
  686. event ObjectIncludeInSearch OnObjectIncludeInSearch;
  687. event UUIDNameRequest OnTeleportHomeRequest;
  688. event ScriptAnswer OnScriptAnswer;
  689. event AgentSit OnUndo;
  690. event AgentSit OnRedo;
  691. event LandUndo OnLandUndo;
  692. event ForceReleaseControls OnForceReleaseControls;
  693. event GodLandStatRequest OnLandStatRequest;
  694. event DetailedEstateDataRequest OnDetailedEstateDataRequest;
  695. event SetEstateFlagsRequest OnSetEstateFlagsRequest;
  696. event SetEstateTerrainBaseTexture OnSetEstateTerrainBaseTexture;
  697. event SetEstateTerrainDetailTexture OnSetEstateTerrainDetailTexture;
  698. event SetEstateTerrainTextureHeights OnSetEstateTerrainTextureHeights;
  699. event CommitEstateTerrainTextureRequest OnCommitEstateTerrainTextureRequest;
  700. event SetRegionTerrainSettings OnSetRegionTerrainSettings;
  701. event EstateRestartSimRequest OnEstateRestartSimRequest;
  702. event EstateChangeCovenantRequest OnEstateChangeCovenantRequest;
  703. event UpdateEstateAccessDeltaRequest OnUpdateEstateAccessDeltaRequest;
  704. event SimulatorBlueBoxMessageRequest OnSimulatorBlueBoxMessageRequest;
  705. event EstateBlueBoxMessageRequest OnEstateBlueBoxMessageRequest;
  706. event EstateDebugRegionRequest OnEstateDebugRegionRequest;
  707. event EstateTeleportOneUserHomeRequest OnEstateTeleportOneUserHomeRequest;
  708. event EstateTeleportAllUsersHomeRequest OnEstateTeleportAllUsersHomeRequest;
  709. event UUIDNameRequest OnUUIDGroupNameRequest;
  710. event RegionHandleRequest OnRegionHandleRequest;
  711. event ParcelInfoRequest OnParcelInfoRequest;
  712. event RequestObjectPropertiesFamily OnObjectGroupRequest;
  713. event ScriptReset OnScriptReset;
  714. event GetScriptRunning OnGetScriptRunning;
  715. event SetScriptRunning OnSetScriptRunning;
  716. event Action<Vector3, bool, bool> OnAutoPilotGo;
  717. event TerrainUnacked OnUnackedTerrain;
  718. event ActivateGesture OnActivateGesture;
  719. event DeactivateGesture OnDeactivateGesture;
  720. event ObjectOwner OnObjectOwner;
  721. event DirPlacesQuery OnDirPlacesQuery;
  722. event DirFindQuery OnDirFindQuery;
  723. event DirLandQuery OnDirLandQuery;
  724. event DirPopularQuery OnDirPopularQuery;
  725. event DirClassifiedQuery OnDirClassifiedQuery;
  726. event EventInfoRequest OnEventInfoRequest;
  727. event ParcelSetOtherCleanTime OnParcelSetOtherCleanTime;
  728. event MapItemRequest OnMapItemRequest;
  729. event OfferCallingCard OnOfferCallingCard;
  730. event AcceptCallingCard OnAcceptCallingCard;
  731. event DeclineCallingCard OnDeclineCallingCard;
  732. event SoundTrigger OnSoundTrigger;
  733. event StartLure OnStartLure;
  734. event TeleportLureRequest OnTeleportLureRequest;
  735. event NetworkStats OnNetworkStatsUpdate;
  736. event ClassifiedInfoRequest OnClassifiedInfoRequest;
  737. event ClassifiedInfoUpdate OnClassifiedInfoUpdate;
  738. event ClassifiedDelete OnClassifiedDelete;
  739. event ClassifiedDelete OnClassifiedGodDelete;
  740. event EventNotificationAddRequest OnEventNotificationAddRequest;
  741. event EventNotificationRemoveRequest OnEventNotificationRemoveRequest;
  742. event EventGodDelete OnEventGodDelete;
  743. event ParcelDwellRequest OnParcelDwellRequest;
  744. event UserInfoRequest OnUserInfoRequest;
  745. event UpdateUserInfo OnUpdateUserInfo;
  746. event RetrieveInstantMessages OnRetrieveInstantMessages;
  747. event PickDelete OnPickDelete;
  748. event PickGodDelete OnPickGodDelete;
  749. event PickInfoUpdate OnPickInfoUpdate;
  750. event AvatarNotesUpdate OnAvatarNotesUpdate;
  751. event AvatarInterestUpdate OnAvatarInterestUpdate;
  752. event GrantUserFriendRights OnGrantUserRights;
  753. event MuteListRequest OnMuteListRequest;
  754. event PlacesQuery OnPlacesQuery;
  755. event FindAgentUpdate OnFindAgent;
  756. event TrackAgentUpdate OnTrackAgent;
  757. event NewUserReport OnUserReport;
  758. event SaveStateHandler OnSaveState;
  759. event GroupAccountSummaryRequest OnGroupAccountSummaryRequest;
  760. event GroupAccountDetailsRequest OnGroupAccountDetailsRequest;
  761. event GroupAccountTransactionsRequest OnGroupAccountTransactionsRequest;
  762. event FreezeUserUpdate OnParcelFreezeUser;
  763. event EjectUserUpdate OnParcelEjectUser;
  764. event ParcelBuyPass OnParcelBuyPass;
  765. event ParcelGodMark OnParcelGodMark;
  766. event GroupActiveProposalsRequest OnGroupActiveProposalsRequest;
  767. event GroupVoteHistoryRequest OnGroupVoteHistoryRequest;
  768. event SimWideDeletesDelegate OnSimWideDeletes;
  769. event SendPostcard OnSendPostcard;
  770. event MuteListEntryUpdate OnUpdateMuteListEntry;
  771. event MuteListEntryRemove OnRemoveMuteListEntry;
  772. event GodlikeMessage onGodlikeMessage;
  773. event GodUpdateRegionInfoUpdate OnGodUpdateRegionInfoUpdate;
  774. /// <summary>
  775. /// Set the debug level at which packet output should be printed to console.
  776. /// </summary>
  777. int DebugPacketLevel { get; set; }
  778. void InPacket(object NewPack);
  779. void ProcessInPacket(Packet NewPack);
  780. /// <summary>
  781. /// Close this client
  782. /// </summary>
  783. void Close();
  784. /// <summary>
  785. /// Close this client
  786. /// </summary>
  787. /// <param name='force'>
  788. /// If true, attempts the close without checking active status. You do not want to try this except as a last
  789. /// ditch attempt where Active == false but the ScenePresence still exists.
  790. /// </param>
  791. void Close(bool force);
  792. void Kick(string message);
  793. /// <summary>
  794. /// Start processing for this client.
  795. /// </summary>
  796. void Start();
  797. void Stop();
  798. // void ActivateGesture(UUID assetId, UUID gestureId);
  799. /// <summary>
  800. /// Tell this client what items it should be wearing now
  801. /// </summary>
  802. void SendWearables(AvatarWearable[] wearables, int serial);
  803. /// <summary>
  804. /// Send information about the given agent's appearance to another client.
  805. /// </summary>
  806. /// <param name="agentID">The id of the agent associated with the appearance</param>
  807. /// <param name="visualParams"></param>
  808. /// <param name="textureEntry"></param>
  809. void SendAppearance(UUID agentID, byte[] visualParams, byte[] textureEntry);
  810. void SendCachedTextureResponse(ISceneEntity avatar, int serial, List<CachedTextureResponseArg> cachedTextures);
  811. void SendStartPingCheck(byte seq);
  812. /// <summary>
  813. /// Tell the client that an object has been deleted
  814. /// </summary>
  815. /// <param name="localID"></param>
  816. void SendKillObject(List<uint> localID);
  817. void SendAnimations(UUID[] animID, int[] seqs, UUID sourceAgentId, UUID[] objectIDs);
  818. void SendRegionHandshake(RegionInfo regionInfo, RegionHandshakeArgs args);
  819. /// <summary>
  820. /// Send chat to the viewer.
  821. /// </summary>
  822. /// <param name='message'></param>
  823. /// <param name='type'></param>
  824. /// <param name='fromPos'></param>
  825. /// <param name='fromName'></param>
  826. /// <param name='fromAgentID'></param>
  827. /// <param name='ownerID'></param>
  828. /// <param name='source'></param>
  829. /// <param name='audible'></param>
  830. void SendChatMessage(
  831. string message, byte type, Vector3 fromPos, string fromName, UUID fromAgentID, UUID ownerID, byte source,
  832. byte audible);
  833. void SendInstantMessage(GridInstantMessage im);
  834. void SendGenericMessage(string method, UUID invoice, List<string> message);
  835. void SendGenericMessage(string method, UUID invoice, List<byte[]> message);
  836. void SendLayerData(float[] map);
  837. void SendLayerData(int px, int py, float[] map);
  838. void SendWindData(Vector2[] windSpeeds);
  839. void SendCloudData(float[] cloudCover);
  840. /// <summary>
  841. /// Sent when an agent completes its movement into a region.
  842. /// </summary>
  843. /// <remarks>
  844. /// This packet marks completion of the arrival of a root avatar in a region, whether through login, region
  845. /// crossing or direct teleport.
  846. /// </remarks>
  847. void MoveAgentIntoRegion(RegionInfo regInfo, Vector3 pos, Vector3 look);
  848. void InformClientOfNeighbour(ulong neighbourHandle, IPEndPoint neighbourExternalEndPoint);
  849. /// <summary>
  850. /// Return circuit information for this client.
  851. /// </summary>
  852. /// <returns></returns>
  853. AgentCircuitData RequestClientInfo();
  854. void CrossRegion(ulong newRegionHandle, Vector3 pos, Vector3 lookAt, IPEndPoint newRegionExternalEndPoint,
  855. string capsURL);
  856. void SendMapBlock(List<MapBlockData> mapBlocks, uint flag);
  857. void SendLocalTeleport(Vector3 position, Vector3 lookAt, uint flags);
  858. void SendRegionTeleport(ulong regionHandle, byte simAccess, IPEndPoint regionExternalEndPoint, uint locationID,
  859. uint flags, string capsURL);
  860. void SendTeleportFailed(string reason);
  861. void SendTeleportStart(uint flags);
  862. void SendTeleportProgress(uint flags, string message);
  863. void SendMoneyBalance(UUID transaction, bool success, byte[] description, int balance, int transactionType, UUID sourceID, bool sourceIsGroup, UUID destID, bool destIsGroup, int amount, string item);
  864. void SendPayPrice(UUID objectID, int[] payPrice);
  865. void SendCoarseLocationUpdate(List<UUID> users, List<Vector3> CoarseLocations);
  866. void SetChildAgentThrottle(byte[] throttle);
  867. void SendAvatarDataImmediate(ISceneEntity avatar);
  868. /// <summary>
  869. /// Send a positional, velocity, etc. update to the viewer for a given entity.
  870. /// </summary>
  871. /// <param name="entity"></param>
  872. /// <param name="updateFlags"></param>
  873. void SendEntityUpdate(ISceneEntity entity, PrimUpdateFlags updateFlags);
  874. void ReprioritizeUpdates();
  875. void FlushPrimUpdates();
  876. void SendInventoryFolderDetails(UUID ownerID, UUID folderID, List<InventoryItemBase> items,
  877. List<InventoryFolderBase> folders, int version, bool fetchFolders,
  878. bool fetchItems);
  879. void SendInventoryItemDetails(UUID ownerID, InventoryItemBase item);
  880. /// <summary>
  881. /// Tell the client that we have created the item it requested.
  882. /// </summary>
  883. /// <param name="Item"></param>
  884. void SendInventoryItemCreateUpdate(InventoryItemBase Item, uint callbackId);
  885. void SendRemoveInventoryItem(UUID itemID);
  886. void SendTakeControls(int controls, bool passToAgent, bool TakeControls);
  887. void SendTaskInventory(UUID taskID, short serial, byte[] fileName);
  888. void SendTelehubInfo(UUID ObjectID, string ObjectName, Vector3 ObjectPos, Quaternion ObjectRot, List<Vector3> SpawnPoint);
  889. /// <summary>
  890. /// Used by the server to inform the client of new inventory items and folders.
  891. /// </summary>
  892. ///
  893. /// If the node is a folder then the contents will be transferred
  894. /// (including all descendent folders) as well as the folder itself.
  895. ///
  896. /// <param name="node"></param>
  897. void SendBulkUpdateInventory(InventoryNodeBase node);
  898. void SendXferPacket(ulong xferID, uint packet, byte[] data);
  899. void SendAbortXferPacket(ulong xferID);
  900. void SendEconomyData(float EnergyEfficiency, int ObjectCapacity, int ObjectCount, int PriceEnergyUnit,
  901. int PriceGroupCreate, int PriceObjectClaim, float PriceObjectRent,
  902. float PriceObjectScaleFactor,
  903. int PriceParcelClaim, float PriceParcelClaimFactor, int PriceParcelRent,
  904. int PricePublicObjectDecay,
  905. int PricePublicObjectDelete, int PriceRentLight, int PriceUpload, int TeleportMinPrice,
  906. float TeleportPriceExponent);
  907. void SendAvatarPickerReply(AvatarPickerReplyAgentDataArgs AgentData, List<AvatarPickerReplyDataArgs> Data);
  908. void SendAgentDataUpdate(UUID agentid, UUID activegroupid, string firstname, string lastname, ulong grouppowers,
  909. string groupname, string grouptitle);
  910. void SendPreLoadSound(UUID objectID, UUID ownerID, UUID soundID);
  911. void SendPlayAttachedSound(UUID soundID, UUID objectID, UUID ownerID, float gain, byte flags);
  912. void SendTriggeredSound(UUID soundID, UUID ownerID, UUID objectID, UUID parentID, ulong handle, Vector3 position,
  913. float gain);
  914. void SendAttachedSoundGainChange(UUID objectID, float gain);
  915. void SendNameReply(UUID profileId, string firstname, string lastname);
  916. void SendAlertMessage(string message);
  917. void SendAgentAlertMessage(string message, bool modal);
  918. void SendLoadURL(string objectname, UUID objectID, UUID ownerID, bool groupOwned, string message, string url);
  919. /// <summary>
  920. /// Open a dialog box on the client.
  921. /// </summary>
  922. /// <param name="objectname"></param>
  923. /// <param name="objectID"></param>
  924. /// <param name="ownerID">/param>
  925. /// <param name="ownerFirstName"></param>
  926. /// <param name="ownerLastName"></param>
  927. /// <param name="msg"></param>
  928. /// <param name="textureID"></param>
  929. /// <param name="ch"></param>
  930. /// <param name="buttonlabels"></param>
  931. void SendDialog(string objectname, UUID objectID, UUID ownerID, string ownerFirstName, string ownerLastName, string msg, UUID textureID, int ch,
  932. string[] buttonlabels);
  933. /// <summary>
  934. /// Update the client as to where the sun is currently located.
  935. /// </summary>
  936. /// <param name="sunPos"></param>
  937. /// <param name="sunVel"></param>
  938. /// <param name="CurrentTime">Seconds since Unix Epoch 01/01/1970 00:00:00</param>
  939. /// <param name="SecondsPerSunCycle"></param>
  940. /// <param name="SecondsPerYear"></param>
  941. /// <param name="OrbitalPosition">The orbital position is given in radians, and must be "adjusted" for the linden client, see LLClientView</param>
  942. void SendSunPos(Vector3 sunPos, Vector3 sunVel, ulong CurrentTime, uint SecondsPerSunCycle, uint SecondsPerYear,
  943. float OrbitalPosition);
  944. void SendViewerEffect(ViewerEffectPacket.EffectBlock[] effectBlocks);
  945. void SendViewerTime(int phase);
  946. void SendAvatarProperties(UUID avatarID, string aboutText, string bornOn, Byte[] charterMember, string flAbout,
  947. uint flags, UUID flImageID, UUID imageID, string profileURL, UUID partnerID);
  948. void SendScriptQuestion(UUID taskID, string taskName, string ownerName, UUID itemID, int question);
  949. void SendHealth(float health);
  950. void SendEstateList(UUID invoice, int code, UUID[] Data, uint estateID);
  951. void SendBannedUserList(UUID invoice, EstateBan[] banlist, uint estateID);
  952. void SendRegionInfoToEstateMenu(RegionInfoForEstateMenuArgs args);
  953. void SendEstateCovenantInformation(UUID covenant);
  954. void SendDetailedEstateData(UUID invoice, string estateName, uint estateID, uint parentEstate, uint estateFlags,
  955. uint sunPosition, UUID covenant, uint covenantChanged, string abuseEmail, UUID estateOwner);
  956. /// <summary>
  957. /// Send land properties to the client.
  958. /// </summary>
  959. /// <param name="sequence_id"></param>
  960. /// <param name="snap_selection"></param>
  961. /// <param name="request_result"></param>
  962. /// <param name="lo"></param></param>
  963. /// <param name="parcelObjectCapacity">/param>
  964. /// <param name="simObjectCapacity"></param>
  965. /// <param name="regionFlags"></param>
  966. void SendLandProperties(int sequence_id, bool snap_selection, int request_result, ILandObject lo,
  967. float simObjectBonusFactor, int parcelObjectCapacity, int simObjectCapacity,
  968. uint regionFlags);
  969. void SendLandAccessListData(List<LandAccessEntry> accessList, uint accessFlag, int localLandID);
  970. void SendForceClientSelectObjects(List<uint> objectIDs);
  971. void SendCameraConstraint(Vector4 ConstraintPlane);
  972. void SendLandObjectOwners(LandData land, List<UUID> groups, Dictionary<UUID, int> ownersAndCount);
  973. void SendLandParcelOverlay(byte[] data, int sequence_id);
  974. #region Parcel Methods
  975. void SendParcelMediaCommand(uint flags, ParcelMediaCommandEnum command, float time);
  976. void SendParcelMediaUpdate(string mediaUrl, UUID mediaTextureID,
  977. byte autoScale, string mediaType, string mediaDesc, int mediaWidth, int mediaHeight,
  978. byte mediaLoop);
  979. #endregion
  980. void SendAssetUploadCompleteMessage(sbyte AssetType, bool Success, UUID AssetFullID);
  981. void SendConfirmXfer(ulong xferID, uint PacketID);
  982. void SendXferRequest(ulong XferID, short AssetType, UUID vFileID, byte FilePath, byte[] FileName);
  983. void SendInitiateDownload(string simFileName, string clientFileName);
  984. /// <summary>
  985. /// Send the first part of a texture. For sufficiently small textures, this may be the only packet.
  986. /// </summary>
  987. /// <param name="numParts"></param>
  988. /// <param name="ImageUUID"></param>
  989. /// <param name="ImageSize"></param>
  990. /// <param name="ImageData"></param>
  991. /// <param name="imageCodec"></param>
  992. void SendImageFirstPart(ushort numParts, UUID ImageUUID, uint ImageSize, byte[] ImageData, byte imageCodec);
  993. /// <summary>
  994. /// Send the next packet for a series of packets making up a single texture,
  995. /// as established by SendImageFirstPart()
  996. /// </summary>
  997. /// <param name="partNumber"></param>
  998. /// <param name="imageUuid"></param>
  999. /// <param name="imageData"></param>
  1000. void SendImageNextPart(ushort partNumber, UUID imageUuid, byte[] imageData);
  1001. /// <summary>
  1002. /// Tell the client that the requested texture cannot be found
  1003. /// </summary>
  1004. void SendImageNotFound(UUID imageid);
  1005. void SendShutdownConnectionNotice();
  1006. /// <summary>
  1007. /// Send statistical information about the sim to the client.
  1008. /// </summary>
  1009. /// <param name="stats"></param>
  1010. void SendSimStats(SimStats stats);
  1011. void SendObjectPropertiesFamilyData(ISceneEntity Entity, uint RequestFlags);
  1012. void SendObjectPropertiesReply(ISceneEntity Entity);
  1013. void SendPartPhysicsProprieties(ISceneEntity Entity);
  1014. void SendAgentOffline(UUID[] agentIDs);
  1015. void SendAgentOnline(UUID[] agentIDs);
  1016. void SendSitResponse(UUID TargetID, Vector3 OffsetPos, Quaternion SitOrientation, bool autopilot,
  1017. Vector3 CameraAtOffset, Vector3 CameraEyeOffset, bool ForceMouseLook);
  1018. void SendAdminResponse(UUID Token, uint AdminLevel);
  1019. void SendGroupMembership(GroupMembershipData[] GroupMembership);
  1020. void SendGroupNameReply(UUID groupLLUID, string GroupName);
  1021. void SendJoinGroupReply(UUID groupID, bool success);
  1022. void SendEjectGroupMemberReply(UUID agentID, UUID groupID, bool success);
  1023. void SendLeaveGroupReply(UUID groupID, bool success);
  1024. void SendCreateGroupReply(UUID groupID, bool success, string message);
  1025. void SendLandStatReply(uint reportType, uint requestFlags, uint resultCount, LandStatReportItem[] lsrpia);
  1026. void SendScriptRunningReply(UUID objectID, UUID itemID, bool running);
  1027. void SendAsset(AssetRequestToClient req);
  1028. void SendTexture(AssetBase TextureAsset);
  1029. byte[] GetThrottlesPacked(float multiplier);
  1030. event ViewerEffectEventHandler OnViewerEffect;
  1031. event Action<IClientAPI> OnLogout;
  1032. event Action<IClientAPI> OnConnectionClosed;
  1033. void SendBlueBoxMessage(UUID FromAvatarID, String FromAvatarName, String Message);
  1034. void SendLogoutPacket();
  1035. // WARNING WARNING WARNING
  1036. //
  1037. // The two following methods are EXCLUSIVELY for the load balancer.
  1038. // they cause a MASSIVE performance hit!
  1039. //
  1040. ClientInfo GetClientInfo();
  1041. void SetClientInfo(ClientInfo info);
  1042. void SetClientOption(string option, string value);
  1043. string GetClientOption(string option);
  1044. void SendSetFollowCamProperties(UUID objectID, SortedDictionary<int, float> parameters);
  1045. void SendClearFollowCamProperties(UUID objectID);
  1046. void SendRegionHandle(UUID regoinID, ulong handle);
  1047. void SendParcelInfo(RegionInfo info, LandData land, UUID parcelID, uint x, uint y);
  1048. void SendScriptTeleportRequest(string objName, string simName, Vector3 pos, Vector3 lookAt);
  1049. void SendDirPlacesReply(UUID queryID, DirPlacesReplyData[] data);
  1050. void SendDirPeopleReply(UUID queryID, DirPeopleReplyData[] data);
  1051. void SendDirEventsReply(UUID queryID, DirEventsReplyData[] data);
  1052. void SendDirGroupsReply(UUID queryID, DirGroupsReplyData[] data);
  1053. void SendDirClassifiedReply(UUID queryID, DirClassifiedReplyData[] data);
  1054. void SendDirLandReply(UUID queryID, DirLandReplyData[] data);
  1055. void SendDirPopularReply(UUID queryID, DirPopularReplyData[] data);
  1056. void SendEventInfoReply(EventData info);
  1057. void SendMapItemReply(mapItemReply[] replies, uint mapitemtype, uint flags);
  1058. void SendAvatarGroupsReply(UUID avatarID, GroupMembershipData[] data);
  1059. void SendOfferCallingCard(UUID srcID, UUID transactionID);
  1060. void SendAcceptCallingCard(UUID transactionID);
  1061. void SendDeclineCallingCard(UUID transactionID);
  1062. void SendTerminateFriend(UUID exFriendID);
  1063. void SendAvatarClassifiedReply(UUID targetID, UUID[] classifiedID, string[] name);
  1064. void SendClassifiedInfoReply(UUID classifiedID, UUID creatorID, uint creationDate, uint expirationDate, uint category, string name, string description, UUID parcelID, uint parentEstate, UUID snapshotID, string simName, Vector3 globalPos, string parcelName, byte classifiedFlags, int price);
  1065. void SendAgentDropGroup(UUID groupID);
  1066. void RefreshGroupMembership();
  1067. void SendAvatarNotesReply(UUID targetID, string text);
  1068. void SendAvatarPicksReply(UUID targetID, Dictionary<UUID, string> picks);
  1069. void SendPickInfoReply(UUID pickID,UUID creatorID, bool topPick, UUID parcelID, string name, string desc, UUID snapshotID, string user, string originalName, string simName, Vector3 posGlobal, int sortOrder, bool enabled);
  1070. void SendAvatarClassifiedReply(UUID targetID, Dictionary<UUID, string> classifieds);
  1071. void SendParcelDwellReply(int localID, UUID parcelID, float dwell);
  1072. void SendUserInfoReply(bool imViaEmail, bool visible, string email);
  1073. void SendUseCachedMuteList();
  1074. void SendMuteListUpdate(string filename);
  1075. void SendGroupActiveProposals(UUID groupID, UUID transactionID, GroupActiveProposals[] Proposals);
  1076. void SendGroupVoteHistory(UUID groupID, UUID transactionID, GroupVoteHistory[] Votes);
  1077. bool AddGenericPacketHandler(string MethodName, GenericMessage handler);
  1078. void SendRebakeAvatarTextures(UUID textureID);
  1079. void SendAvatarInterestsReply(UUID avatarID, uint wantMask, string wantText, uint skillsMask, string skillsText, string languages);
  1080. void SendGroupAccountingDetails(IClientAPI sender,UUID groupID, UUID transactionID, UUID sessionID, int amt);
  1081. void SendGroupAccountingSummary(IClientAPI sender,UUID groupID, uint moneyAmt, int totalTier, int usedTier);
  1082. void SendGroupTransactionsSummaryDetails(IClientAPI sender,UUID groupID, UUID transactionID, UUID sessionID,int amt);
  1083. void SendChangeUserRights(UUID agentID, UUID friendID, int rights);
  1084. void SendTextBoxRequest(string message, int chatChannel, string objectname, UUID ownerID, string ownerFirstName, string ownerLastName, UUID objectId);
  1085. void SendAgentTerseUpdate(ISceneEntity presence);
  1086. void SendPlacesReply(UUID queryID, UUID transactionID, PlacesReplyData[] data);
  1087. }
  1088. }