New options for setting wallpaper and contact icons. Updated to 2.1

Fixed an issue where the contact icons were not appearing.
Added wallpaper and contact icon manipulation options.
Exposed some more methods for the user and hid some other ones that were
left by mistake.
Various fixes and code changes

Author: CamxxCore

CustomiFruit.cs

@@ -4,27 +4,41 @@
 
 namespace iFruitAddon
 {
+    public delegate void ContactSelectedEvent(iFruitContactCollection sender, iFruitContact selectedItem);
+
+    public delegate void ContactAnsweredEvent(iFruitContact contact);
+
     public class CustomiFruit
     {
         /// <summary>
-        /// Keypad Button Color
+        /// Left Button Color
+        /// </summary>
+        public Color LeftButtonColor { get; set; } = Color.Empty;
+
+        /// <summary>
+        /// Center Button Color
+        /// </summary>
+        public Color CenterButtonColor { get; set; } = Color.Empty;
+
+        /// <summary>
+        /// Right Button Color
         /// </summary>
-        public Color KeypadButtonColor { get; set; } = Color.Empty;
+        public Color RightButtonColor { get; set; } = Color.Empty;
 
         /// <summary>
-        /// Select Button Color
+        /// Left Button Icon
         /// </summary>
-        public Color SelectButtonColor { get; set; } = Color.Empty;
+        public SoftKeyIcon LeftButtonIcon { get; set; } = SoftKeyIcon.Blank;
 
         /// <summary>
-        /// Return Button Color
+        /// Center Button Icon
         /// </summary>
-        public Color ReturnButtonColor { get; set; } = Color.Empty;
+        public SoftKeyIcon CenterButtonIcon { get; set; } = SoftKeyIcon.Blank;
 
         /// <summary>
-        /// Header text shown in phone UI
+        /// Right Button Icon
         /// </summary>
-        public string HeaderText { get; set; } = string.Empty;
+        public SoftKeyIcon RightButtonIcon { get; set; } = SoftKeyIcon.Blank;
 
         /// <summary>
         /// List of custom contacts in the phone
@@ -35,6 +49,22 @@ public iFruitContactCollection Contacts
             set { _contacts = value; }
         }
 
+        public CustomiFruit() : this(new iFruitContactCollection())
+        { }
+
+        /// <summary>
+        /// Initialize the class.
+        /// </summary>
+        /// <param name="contacts"></param>
+        public CustomiFruit(iFruitContactCollection contacts)
+        {
+            _contacts = contacts;
+            _mHash = Function.Call<int>(Hash.GET_HASH_KEY, "cellphone_flashhand");
+        }
+
+        /// <summary>
+        /// Handle of the current scaleform.
+        /// </summary>
         public int Handle
         {
             get
@@ -53,36 +83,74 @@ public int Handle
             }
         }
 
-        public CustomiFruit() : this(new iFruitContactCollection())
-        { }
+        /// <summary>
+        /// Set text displayed at the top of the phone interface. Must be called every update!
+        /// </summary>
+        /// <param name="text"></param>
+        public void SetTextHeader(string text)
+        {
+            Function.Call(Hash._PUSH_SCALEFORM_MOVIE_FUNCTION, Handle, "SET_HEADER");
+            Function.Call(Hash._BEGIN_TEXT_COMPONENT, "STRING");
+            Function.Call(Hash._0x761B77454205A61D, text, -1);
+            Function.Call(Hash._END_TEXT_COMPONENT);
+            Function.Call(Hash._POP_SCALEFORM_MOVIE_FUNCTION_VOID);
+        }
 
-        public CustomiFruit(iFruitContactCollection contacts)
+        /// <summary>
+        /// Set icon of the soft key buttons directly.
+        /// </summary>
+        /// <param name="buttonID">The button index</param>
+        /// <param name="icon">Supplied icon</param>
+        public void SetSoftKeyIcon(int buttonID, SoftKeyIcon icon)
         {
-            _contacts = contacts;
-            _mHash = Function.Call<int>(Hash.GET_HASH_KEY, "cellphone_flashhand");
+            Function.Call(Hash._PUSH_SCALEFORM_MOVIE_FUNCTION, Handle, "SET_SOFT_KEYS");
+            Function.Call(Hash._PUSH_SCALEFORM_MOVIE_FUNCTION_PARAMETER_INT, buttonID);
+            Function.Call(Hash._PUSH_SCALEFORM_MOVIE_FUNCTION_PARAMETER_BOOL, true);
+            Function.Call(Hash._PUSH_SCALEFORM_MOVIE_FUNCTION_PARAMETER_INT, (int)icon);
+            Function.Call(Hash._POP_SCALEFORM_MOVIE_FUNCTION_VOID);
         }
 
-        private void SetSoftKeyColor(int key, Color color)
+        /// <summary>
+        /// Set the color of the soft key buttons directly.
+        /// </summary>
+        /// <param name="buttonID">The button index</param>
+        /// <param name="color">Supplied color</param>
+        public void SetSoftKeyColor(int buttonID, Color color)
         {
             Function.Call(Hash._PUSH_SCALEFORM_MOVIE_FUNCTION, Handle, "SET_SOFT_KEYS_COLOUR");
-            Function.Call(Hash._PUSH_SCALEFORM_MOVIE_FUNCTION_PARAMETER_INT, key);
+            Function.Call(Hash._PUSH_SCALEFORM_MOVIE_FUNCTION_PARAMETER_INT, buttonID);
             Function.Call(Hash._PUSH_SCALEFORM_MOVIE_FUNCTION_PARAMETER_INT, color.R);
             Function.Call(Hash._PUSH_SCALEFORM_MOVIE_FUNCTION_PARAMETER_INT, color.G);
             Function.Call(Hash._PUSH_SCALEFORM_MOVIE_FUNCTION_PARAMETER_INT, color.B);
-            Function.Call(Hash._PUSH_SCALEFORM_MOVIE_FUNCTION_PARAMETER_INT, -1);
             Function.Call(Hash._POP_SCALEFORM_MOVIE_FUNCTION_VOID);
         }
 
-        private void SetHeaderString(string text)
+        private void SetWallpaperTXD(string textureDict)
         {
-            Function.Call(Hash._PUSH_SCALEFORM_MOVIE_FUNCTION, Handle, "SET_HEADER");
-            Function.Call(Hash._BEGIN_TEXT_COMPONENT, "STRING");
-            Function.Call(Hash._0x761B77454205A61D, text, -1);
+            Function.Call(Hash._PUSH_SCALEFORM_MOVIE_FUNCTION, Handle, "SET_BACKGROUND_CREW_IMAGE");
+            Function.Call(Hash._BEGIN_TEXT_COMPONENT, "CELL_2000");
+            Function.Call(Hash._ADD_TEXT_COMPONENT_STRING, textureDict);
             Function.Call(Hash._END_TEXT_COMPONENT);
             Function.Call(Hash._POP_SCALEFORM_MOVIE_FUNCTION_VOID);
         }
 
-        private bool _shouldDraw = true;
+        public void SetWallpaper(Wallpaper wallpaper)
+        {
+            _wallpaper = wallpaper;
+        }
+
+        public void SetWallpaper(ContactIcon icon)
+        {
+            _wallpaper = icon;
+        }
+
+        public void SetWallpaper(string textureDict)
+        {
+            _wallpaper = new Wallpaper(textureDict);
+        }
+
+        private bool _shouldDraw = true;    
+        private PhoneImage _wallpaper;
         private iFruitContactCollection _contacts;
         private int _mHash;
 
@@ -92,19 +160,29 @@ public void Update()
             {
                 if (_shouldDraw)
                 {
-                    Script.Wait(10);
-                    if (KeypadButtonColor != Color.Empty)
-                        SetSoftKeyColor(1, KeypadButtonColor);
-                    if (SelectButtonColor != Color.Empty)
-                        SetSoftKeyColor(2, SelectButtonColor);
-                    if (ReturnButtonColor != Color.Empty)
-                        SetSoftKeyColor(3, ReturnButtonColor);
+                    Script.Wait(0);
 
-                    _shouldDraw = !_shouldDraw;
-                }
+                    if (LeftButtonColor != Color.Empty)
+                        SetSoftKeyColor(1, LeftButtonColor);
+                    if (CenterButtonColor != Color.Empty)
+                        SetSoftKeyColor(2, CenterButtonColor);
+                    if (RightButtonColor != Color.Empty)
+                        SetSoftKeyColor(3, RightButtonColor);
 
-                if (HeaderText != string.Empty)
-                    SetHeaderString(HeaderText);
+                    Script.Wait(0);
+
+                    if (LeftButtonIcon != SoftKeyIcon.Blank)
+                        SetSoftKeyIcon(1, LeftButtonIcon);
+                    if (CenterButtonIcon != SoftKeyIcon.Blank)
+                        SetSoftKeyIcon(2, CenterButtonIcon);
+                    if (RightButtonIcon != SoftKeyIcon.Blank)
+                        SetSoftKeyIcon(3, RightButtonIcon);
+
+                    if (_wallpaper != null)
+                        SetWallpaperTXD(_wallpaper.Name);
+
+                    _shouldDraw = !_shouldDraw;
+                }  
             }
 
             else
@@ -115,4 +193,28 @@ public void Update()
             _contacts.Update(Handle);
         }
     }
+
+    public enum SoftKeyIcon
+    {
+        Blank = 1,
+        Select = 2,
+        Pages = 3,
+        Back = 4,
+        Call = 5,
+        Hangup = 6,
+        HangupHuman = 7,
+        Week = 8,
+        Keypad = 9,
+        Open = 10,
+        Reply = 11,
+        Delete = 12,
+        Yes = 13,
+        No = 14,
+        Sort = 15,
+        Website = 16,
+        Police = 17,
+        Ambulance = 18,
+        Fire = 19,
+        Pages2 = 20
+    }
 }

ExampleScript.cs

@@ -12,27 +12,49 @@ public class ExampleScript : Script
 
         public ExampleScript()
         {
-            ifruit = new CustomiFruit() {
-                SelectButtonColor = System.Drawing.Color.Orange,
-                ReturnButtonColor = System.Drawing.Color.LimeGreen,
-                KeypadButtonColor = System.Drawing.Color.Purple
+            ifruit = new CustomiFruit()
+            {
+                CenterButtonColor = System.Drawing.Color.Orange,
+                LeftButtonColor = System.Drawing.Color.LimeGreen,
+                RightButtonColor = System.Drawing.Color.Purple,
+                CenterButtonIcon = SoftKeyIcon.Fire,
+                LeftButtonIcon = SoftKeyIcon.Police,
+                RightButtonIcon = SoftKeyIcon.Website
             };
 
-            var contact = new iFruitContact("Spawn Adder", 10);
-            contact.Selected += (sender, args) => Scripts.SpawnVehicle("ADDER", Game.Player.Character.Position);
+            ifruit.SetWallpaper(new Wallpaper("char_facebook"));
+            //or..
+            ifruit.SetWallpaper(Wallpaper.BadgerDefault);
+
+            var contact = new iFruitContact("Spawn Adder", 19);
+            contact.Answered += Contact_Answered;
+            contact.DialTimeout = 8000;
+
+            //set custom icons by instantiating the ContactIcon class
+            contact.Icon = new ContactIcon("char_sasquatch");
+
             ifruit.Contacts.Add(contact);
-            contact = new iFruitContact("Teleport to Waypoint", 11);
-            contact.Selected += (sender, args) => Scripts.TeleportToWaypoint();
+
+            contact = new iFruitContact("Teleport to Waypoint", 20);
+            contact.Selected += (s, a) => Scripts.TeleportToWaypoint();
+            contact.DialTimeout = 0;
+            contact.Icon = ContactIcon.Target;
+
             ifruit.Contacts.Add(contact);
-            this.Tick += OnTick;
 
+            Tick += OnTick;
+        }
+
+        private void Contact_Answered(iFruitContact contact)
+        {
+            Scripts.SpawnVehicle("ADDER");
+            UI.Notify("Your Adder has been delivered!");
         }
 
         void OnTick(object sender, EventArgs e)
         {
             ifruit.Update();
         }
-
     }
 
     public static class Scripts
@@ -52,13 +74,11 @@ public static void TeleportToWaypoint()
             }
         }
 
-        public static void SpawnVehicle(string vehiclename, Vector3 pos)
+        public static void SpawnVehicle(string vehiclename)
         {
             Model model = new Model(vehiclename);
             model.Request(1000);
-            var veh = Function.Call<Vehicle>((Hash)0xAF35D0D2583051B0, model.Hash, pos.X, pos.Y, pos.Z, Game.Player.Character.Heading, 0, 0);
-            Function.Call(Hash.SET_PED_INTO_VEHICLE, Game.Player.Character.Handle, veh.Handle, -1);
+            World.CreateVehicle(model, Game.Player.Character.Position + Game.Player.Character.ForwardVector * 5);
         }
     }
-
 }