Added support for Phone Contacts

LemonUI/Phone/CallBehavior.cs

@@ -0,0 +1,17 @@
+namespace LemonUI.Phone
+{
+    /// <summary>
+    /// The behavior of a call after is initiated by the user.
+    /// </summary>
+    public enum CallBehavior
+    {
+        /// <summary>
+        /// The contact being called is busy.
+        /// </summary>
+        Busy = 0,
+        /// <summary>
+        /// The contact is available and will answer.
+        /// </summary>
+        Available = 1
+    }
+}

LemonUI/Phone/CallOrigin.cs

@@ -0,0 +1,17 @@
+namespace LemonUI.Phone
+{
+    /// <summary>
+    /// The origin of the call.
+    /// </summary>
+    public enum CallOrigin
+    {
+        /// <summary>
+        /// The Contact called the Player.
+        /// </summary>
+        Contact = 0,
+        /// <summary>
+        /// The Player called the Contact.
+        /// </summary>
+        Player = 1
+    }
+}

LemonUI/Phone/CallStatus.cs

@@ -0,0 +1,33 @@
+namespace LemonUI.Phone
+{
+    /// <summary>
+    /// The status of the current call.
+    /// </summary>
+    internal enum CallStatus
+    {
+        /// <summary>
+        /// The contact is not being called.
+        /// </summary>
+        Inactive = -1,
+        /// <summary>
+        /// The contact has been triggered and is currently idling.
+        /// </summary>
+        Idle = 0,
+        /// <summary>
+        /// The contact is currently being called.
+        /// </summary>
+        Calling = 1,
+        /// <summary>
+        /// The contact has been called and has answered as Busy or Connected.
+        /// </summary>
+        Called = 2,
+        /// <summary>
+        /// The contact is busy.
+        /// </summary>
+        Busy = 3,
+        /// <summary>
+        /// The contact has been connected.
+        /// </summary>
+        Connected = 4
+    }
+}

LemonUI/Phone/CalledEventArgs.cs

@@ -0,0 +1,38 @@
+#if SHVDN3
+using System;
+
+namespace LemonUI.Phone
+{
+    /// <summary>
+    /// Represents the call process when the player initiates a call
+    /// </summary>
+    public class CalledEventArgs : EventArgs
+    {
+        #region Properties
+
+        /// <summary>
+        /// The contact that was called by the player.
+        /// </summary>
+        public PhoneContact Contact { get; }
+        /// <summary>
+        /// The behavior of the call after the wait.
+        /// </summary>
+        public CallBehavior Behavior { get; set; } = CallBehavior.Busy;
+        /// <summary>
+        /// The time to wait before the <see cref="Behavior"/> is applied.
+        /// </summary>
+        public int Wait { get; set; } = 3000;
+
+        #endregion
+
+        #region Constructors
+
+        internal CalledEventArgs(PhoneContact contact)
+        {
+            Contact = contact;
+        }
+
+        #endregion
+    }
+}
+#endif

LemonUI/Phone/CalledEventHandler.cs

@@ -0,0 +1,11 @@
+#if SHVDN3
+namespace LemonUI.Phone
+{
+    /// <summary>
+    /// Represents the method that is called when the value on a grid is changed.
+    /// </summary>
+    /// <param name="sender">The source of the event.</param>
+    /// <param name="e">An <see cref="CalledEventArgs"/> with the call information.</param>
+    public delegate void CalledEventHandler(object sender, CalledEventArgs e);
+}
+#endif

LemonUI/Phone/ConnectedEventArgs.cs

@@ -0,0 +1,34 @@
+#if SHVDN3
+using System;
+
+namespace LemonUI.Phone
+{
+    /// <summary>
+    /// Represents the call process when the player answers the phone and the call is connected.
+    /// </summary>
+    public class ConnectedEventArgs : EventArgs
+    {
+        #region Properties
+
+        /// <summary>
+        /// The contact that was called by the player.
+        /// </summary>
+        public PhoneContact Contact { get; }
+        /// <summary>
+        /// After how much time should the call be disconnected automatically.
+        /// </summary>
+        public int DisconnectAfter { get; set; }
+
+        #endregion
+
+        #region Constructors
+
+        internal ConnectedEventArgs(PhoneContact contact)
+        {
+            Contact = contact;
+        }
+
+        #endregion
+    }
+}
+#endif

LemonUI/Phone/ConnectedEventHandler.cs

@@ -0,0 +1,11 @@
+#if SHVDN3
+namespace LemonUI.Phone
+{
+    /// <summary>
+    /// Represents the method that is called when the phone call is connected.
+    /// </summary>
+    /// <param name="sender">The source of the event.</param>
+    /// <param name="e">An <see cref="CalledEventArgs"/> with the connection information.</param>
+    public delegate void ConnectedEventHandler(object sender, ConnectedEventArgs e);
+}
+#endif

LemonUI/Phone/Phone.cs

@@ -0,0 +1,135 @@
+#if SHVDN3
+using GTA;
+using GTA.Native;
+using System;
+using System.Collections.Generic;
+using LemonUI.Scaleform;
+
+namespace LemonUI.Phone
+{
+    /// <summary>
+    /// Class used to manage the phone.
+    /// </summary>
+    public class PhoneManager : Script
+    {
+        #region Fields
+
+        private static readonly List<PhoneContact> contacts = new List<PhoneContact>();
+        private static int total = -1;
+        private static Scaleform.Phone badger = new Scaleform.Phone(PhoneType.Badger);
+        private static Scaleform.Phone facade = new Scaleform.Phone(PhoneType.Facade);
+        private static Scaleform.Phone ifruit = new Scaleform.Phone(PhoneType.IFruit);
+
+        #endregion
+
+        #region Properties
+
+        private static Scaleform.Phone CurrentPhone
+        {
+            get
+            {
+                switch ((uint)Game.Player.Character.Model.Hash)
+                {
+                    case 0x9B22DBAF: // Franklin
+                        return badger;
+                    case 0x0D7114C9: // Michael
+                        return ifruit;
+                    case 0x9B810FA2: // Trevor
+                        return facade;
+                    default:
+                        return ifruit;
+                }
+            }
+        }
+        /// <summary>
+        /// If the phone's contact are open on the screen.
+        /// </summary>
+        public static bool AreContactsOpen => Function.Call<bool>(Hash._GET_NUMBER_OF_REFERENCES_OF_SCRIPT_WITH_NAME_HASH, Game.GenerateHash("appcontacts"));
+        /// <summary>
+        /// The contact currently being called.
+        /// </summary>
+        public static PhoneContact Current { get; private set; }
+
+        #endregion
+
+        #region Constructors
+
+        public PhoneManager()
+        {
+            Tick += Process;
+        }
+
+        #endregion
+
+        #region Functions
+
+        private static void Process(object sender, EventArgs e)
+        {
+            Scaleform.Phone currentPhone = CurrentPhone;
+
+            if (Current != null)
+            {
+                Current.Process(currentPhone);
+
+                if (!Current.IsActive)
+                {
+                    Current = null;
+                }
+                else
+                {
+                    return;
+                }
+            }
+
+            if (AreContactsOpen)
+            {
+                if (total == -1)
+                {
+                    total = currentPhone.Total;
+                }
+
+                int index = currentPhone.Index;
+
+                if (Game.IsControlPressed(Control.PhoneSelect) && index >= total)
+                {
+                    Function.Call(Hash.TERMINATE_ALL_SCRIPTS_WITH_THIS_NAME, "appcontacts");
+                    Current = contacts[index - total];
+                    Current.Call(currentPhone);
+                    return;
+                }
+
+                for (int i = 0; i < contacts.Count; i++)
+                {
+                    PhoneContact contact = contacts[i];
+                    currentPhone.AddContactAt(total + i, contact.Name, contact.Icon);
+                }
+            }
+            else
+            {
+                total = -1;
+            }
+        }
+        /// <summary>
+        /// Adds a new contact to the phone.
+        /// </summary>
+        /// <param name="contact">The contact to add.</param>
+        public static void Add(PhoneContact contact)
+        {
+            if (contacts.Contains(contact))
+            {
+                return;
+            }
+
+            contacts.Add(contact);
+        }
+        /// <summary>
+        /// Removes a contact from the phone.
+        /// </summary>
+        /// <param name="contact">The contact to remove.</param>
+        /// <returns><see langword="true"/> if the contact was removed, <see langword="false"/> otherwise.</returns>
+        public static bool Remove(PhoneContact contact) => contacts.Remove(contact);
+
+        #endregion
+    }
+}
+#endif