#189 - Add user provided name to MMALPortConfig.

src/MMALSharp/Ports/IMMALPortConfig.cs

@@ -84,5 +84,10 @@ public interface IMMALPortConfig
         /// Indicates whether motion vector data should be stored to a separate output stream. Only applies to Video recording.
         /// </summary>
         bool StoreMotionVectors { get; }
+
+        /// <summary>
+        /// User provided name for port. Helps with debugging.
+        /// </summary>
+        string UserPortName { get; }
     }
 }

src/MMALSharp/Ports/MMALPortConfig.cs

@@ -85,6 +85,11 @@ public class MMALPortConfig : IMMALPortConfig
         /// </summary>
         public bool StoreMotionVectors { get; }
 
+        /// <summary>
+        /// User provided name for port. Helps with debugging.
+        /// </summary>
+        public string UserPortName { get; set; }
+
         /// <summary>
         /// Create a new instance of <see cref="MMALPortConfig"/>.
         /// </summary>
@@ -102,6 +107,7 @@ public class MMALPortConfig : IMMALPortConfig
         /// <param name="bufferNum">Requested number of buffer headers.</param>
         /// <param name="bufferSize">Requested size of buffer headers.</param>
         /// <param name="crop">The Region of Interest requested.</param>
+        /// <param name="userPortName">User provided name for port. Helps with debugging..</param>
         public MMALPortConfig(
             MMALEncoding encodingType, 
             MMALEncoding pixelFormat, 
@@ -116,7 +122,8 @@ public MMALPortConfig(
             bool zeroCopy = false,
             int bufferNum = 0, 
             int bufferSize = 0, 
-            Rectangle? crop = null)
+            Rectangle? crop = null,
+            string userPortName = "")
         {
             this.EncodingType = encodingType;
             this.PixelFormat = pixelFormat;
@@ -132,6 +139,7 @@ public MMALPortConfig(
             this.BufferSize = bufferSize;
             this.Crop = crop;
             this.StoreMotionVectors = storeMotionVectors;
+            this.UserPortName = userPortName;
         }
     }
 }

src/MMALSharp/Ports/PortBase.cs

@@ -89,9 +89,15 @@ public abstract unsafe class PortBase<TCallback> : MMALObject, IPort
         public MMAL_PORT_T* Ptr { get; }
 
         /// <summary>
-        /// Native name of port.
+        /// Returns the Native name and user provided name of port (if set).
         /// </summary>
-        public string Name => Marshal.PtrToStringAnsi((IntPtr)this.Ptr->Name);
+        public string Name 
+        {
+            get
+            {
+                return $"{Marshal.PtrToStringAnsi((IntPtr)this.Ptr->Name)} {this.PortConfig?.UserPortName}";
+            }
+        }
 
         /// <summary>
         /// Indicates whether this port is enabled.