Moving examples, mapgenerator, and VisualParamGenerator to Programs folder (SVN is seriously ruined still, don't check out yet)

git-svn-id: http://libopenmetaverse.googlecode.com/svn/trunk@1961 52acb1d6-8a22-11de-b505-999d5b087335

Programs/examples/TestClient/Commands/Friends/MapFriendCommand.cs

@@ -0,0 +1,53 @@
+using System;
+using System.Collections.Generic;
+using System.Threading;
+using OpenMetaverse;
+using OpenMetaverse.Packets;
+using System.Text;
+
+namespace OpenMetaverse.TestClient
+{
+    public class MapFriendCommand : Command
+    {
+        ManualResetEvent WaitforFriend = new ManualResetEvent(false);
+
+        public MapFriendCommand(TestClient testClient)
+        {
+            Name = "mapfriend";
+            Description = "Show a friends location. Usage: mapfriend UUID";
+        }
+        public override string Execute(string[] args, LLUUID fromAgentID)
+        {
+            if (args.Length != 1)
+                return Description;
+
+            LLUUID targetID;
+
+            if (!LLUUID.TryParse(args[0], out targetID))
+                return Description;
+
+            StringBuilder sb = new StringBuilder();
+
+            FriendsManager.FriendFoundEvent del = 
+                delegate(LLUUID agentID, ulong regionHandle, LLVector3 location) 
+                {
+                    if (!regionHandle.Equals(0))
+                        sb.AppendFormat("Found Friend {0} in {1} at {2}/{3}", agentID, regionHandle, location.X, location.Y);
+                    else
+                        sb.AppendFormat("Found Friend {0}, But they appear to be offline", agentID);
+
+                    WaitforFriend.Set();
+                };
+
+            Client.Friends.OnFriendFound += del;
+            WaitforFriend.Reset();
+            Client.Friends.MapFriend(targetID);
+            if (!WaitforFriend.WaitOne(10000, false))
+            {
+                sb.AppendFormat("Timeout waiting for reply, Do you have mapping rights on {0}?", targetID);
+            }
+            Client.Friends.OnFriendFound -= del;
+            return sb.ToString();
+        }
+    }
+}