]> granicus.if.org Git - handbrake/commitdiff
Interop: Add in a bunch of missing comments.
authorsr55 <sr55.hb@outlook.com>
Sat, 17 Sep 2011 19:23:28 +0000 (19:23 +0000)
committersr55 <sr55.hb@outlook.com>
Sat, 17 Sep 2011 19:23:28 +0000 (19:23 +0000)
git-svn-id: svn://svn.handbrake.fr/HandBrake/trunk@4229 b64f7644-9d1e-0410-96f1-a4d463321fa5

win/CS/HandBrake.Interop/HandBrakeInterop/Converters.cs
win/CS/HandBrake.Interop/HandBrakeInterop/EncodeCompletedEventArgs.cs
win/CS/HandBrake.Interop/HandBrakeInterop/EncodeProgressEventArgs.cs
win/CS/HandBrake.Interop/HandBrakeInterop/HandBrakeInstance.cs
win/CS/HandBrake.Interop/HandBrakeInterop/HandBrakeUtils.cs
win/CS/HandBrake.Interop/HandBrakeInterop/MarshalingConstants.cs
win/CS/HandBrake.Interop/HandBrakeInterop/MessageLoggedEventArgs.cs
win/CS/HandBrake.Interop/HandBrakeInterop/NativeList.cs
win/CS/HandBrake.Interop/HandBrakeInterop/ScanProgressEventArgs.cs

index 868a8b72028eabaef989180a77987da7d4f4cf51..b0e81fcd3e195990bc794a0626a72dae5293eebb 100644 (file)
@@ -18,7 +18,10 @@ namespace HandBrake.Interop
 \r
        public static class Converters\r
        {\r
-               private static Dictionary<double, int> vrates = new Dictionary<double, int>\r
+           /// <summary>\r
+           /// Video Frame Rates\r
+           /// </summary>\r
+           private static Dictionary<double, int> vrates = new Dictionary<double, int>\r
                {\r
                        {5, 5400000},\r
                        {10, 2700000},\r
@@ -30,7 +33,19 @@ namespace HandBrake.Interop
                        {29.97, 900900}\r
                };\r
 \r
-               public static int FramerateToVrate(double framerate)\r
+           /// <summary>\r
+        /// Convert Framerate to Video Rates\r
+           /// </summary>\r
+           /// <param name="framerate">\r
+           /// The framerate.\r
+           /// </param>\r
+           /// <returns>\r
+           /// The vrate if a valid framerate is passed in.\r
+           /// </returns>\r
+           /// <exception cref="ArgumentException">\r
+           /// Thrown when framerate is invalid.\r
+           /// </exception>\r
+           public static int FramerateToVrate(double framerate)\r
                {\r
                        if (!vrates.ContainsKey(framerate))\r
                        {\r
@@ -40,7 +55,19 @@ namespace HandBrake.Interop
                        return vrates[framerate];\r
                }\r
 \r
-               public static int MixdownToNative(Mixdown mixdown)\r
+           /// <summary>\r
+           /// Convert a Mixdown object to HandBrakes native mixdown constant.\r
+           /// </summary>\r
+           /// <param name="mixdown">\r
+           /// The mixdown.\r
+           /// </param>\r
+           /// <returns>\r
+           /// NativeContstant that represents the mixdown.\r
+           /// </returns>\r
+           /// <exception cref="ArgumentException">\r
+           /// Thrown for an invalid mixodown.\r
+           /// </exception>\r
+           public static int MixdownToNative(Mixdown mixdown)\r
                {\r
                        if (mixdown == Mixdown.Auto)\r
                        {\r
@@ -64,7 +91,19 @@ namespace HandBrake.Interop
                        return 0;\r
                }\r
 \r
-               public static Mixdown NativeToMixdown(int mixdown)\r
+           /// <summary>\r
+           /// Convert an native internal handbrake mixdown to a local mixdown enum.\r
+           /// </summary>\r
+           /// <param name="mixdown">\r
+           /// The mixdown.\r
+           /// </param>\r
+           /// <returns>\r
+           /// A mixdown object.\r
+           /// </returns>\r
+           /// <exception cref="ArgumentException">\r
+           /// thrown when mixdown is invalid.\r
+           /// </exception>\r
+           public static Mixdown NativeToMixdown(int mixdown)\r
                {\r
                        switch (mixdown)\r
                        {\r
@@ -117,7 +156,16 @@ namespace HandBrake.Interop
                        return 0;\r
                }\r
 \r
-               public static AudioCodec NativeToAudioCodec(uint codec)\r
+           /// <summary>\r
+           /// Convert Native HB Internal Audio int to a AudioCodec model.\r
+           /// </summary>\r
+           /// <param name="codec">\r
+           /// The codec.\r
+           /// </param>\r
+           /// <returns>\r
+           /// An AudioCodec object.\r
+           /// </returns>\r
+           public static AudioCodec NativeToAudioCodec(uint codec)\r
                {\r
                        switch (codec)\r
                        {\r
index 17e196e5948df7c88f20d3b5aa1c6b414d59208d..aa71b3a14fc417d9454849f90a17020f99e62c20 100644 (file)
@@ -11,8 +11,14 @@ namespace HandBrake.Interop
 {\r
        using System;\r
 \r
-       public class EncodeCompletedEventArgs : EventArgs\r
+    /// <summary>\r
+    /// Encode Completed Event Args\r
+    /// </summary>\r
+    public class EncodeCompletedEventArgs : EventArgs\r
        {\r
-               public bool Error { get; set; }\r
+           /// <summary>\r
+           /// Gets or sets a value indicating whether Error.\r
+           /// </summary>\r
+           public bool Error { get; set; }\r
        }\r
 }\r
index 3a742905704e510d87850bf68390e215a9ea0600..73802fafd4a6794af5a62aea765ba7465ba42f47 100644 (file)
@@ -11,12 +11,30 @@ namespace HandBrake.Interop
 {\r
        using System;\r
 \r
-       public class EncodeProgressEventArgs : EventArgs\r
+    /// <summary>\r
+    /// Encode Progress Event Args\r
+    /// </summary>\r
+    public class EncodeProgressEventArgs : EventArgs\r
        {\r
-               public float FractionComplete { get; set; }\r
-               public float CurrentFrameRate { get; set; }\r
-               public float AverageFrameRate { get; set; }\r
-               public TimeSpan EstimatedTimeLeft { get; set; }\r
+           /// <summary>\r
+           /// Gets or sets FractionComplete.\r
+           /// </summary>\r
+           public float FractionComplete { get; set; }\r
+\r
+           /// <summary>\r
+           /// Gets or sets CurrentFrameRate.\r
+           /// </summary>\r
+           public float CurrentFrameRate { get; set; }\r
+\r
+           /// <summary>\r
+           /// Gets or sets AverageFrameRate.\r
+           /// </summary>\r
+           public float AverageFrameRate { get; set; }\r
+\r
+           /// <summary>\r
+           /// Gets or sets EstimatedTimeLeft.\r
+           /// </summary>\r
+           public TimeSpan EstimatedTimeLeft { get; set; }\r
 \r
                /// <summary>\r
                /// Gets or sets the current encoding pass. (-1: subtitle scan, 1: first pass, 2: second pass)\r
index 12172993f360635921e319821adc212a0fcd4ea7..c7818cd7e9e697de4c33c15f39948d9829d9d665 100644 (file)
@@ -31,11 +31,6 @@ namespace HandBrake.Interop
                /// </summary>\r
                private const int PictureAutoSizeModulus = 2;\r
 \r
-               /// <summary>\r
-               /// Modulus used for picture size when using non-anamorphic.\r
-               /// </summary>\r
-               private const int NonAnamorphicAutoSizeModulus = 16;\r
-\r
                /// <summary>\r
                /// The number of MS between status polls when scanning.\r
                /// </summary>\r
index 047a69535171f18d002ff0dc4cb0764c27013965..b90387703adf218426f1b9d990deaf3acd9e5c6c 100644 (file)
@@ -17,7 +17,10 @@ namespace HandBrake.Interop
        using HandBrake.Interop.Model.Encoding;\r
        using HandBrake.Interop.SourceData;\r
 \r
-       public static class HandBrakeUtils\r
+    /// <summary>\r
+    /// HandBrake Interop Utilities\r
+    /// </summary>\r
+    public static class HandBrakeUtils\r
        {\r
                /// <summary>\r
                /// Estimated overhead in bytes for each frame in output container.\r
@@ -44,7 +47,10 @@ namespace HandBrake.Interop
                /// </summary>\r
                public static event EventHandler<MessageLoggedEventArgs> ErrorLogged;\r
 \r
-               public static void RegisterLogger()\r
+           /// <summary>\r
+           /// Register the logger.\r
+           /// </summary>\r
+           public static void RegisterLogger()\r
                {\r
                        // Register the logger if we have not already\r
                        if (loggingCallback == null)\r
index 2818844de7994ab25db63582e1f781e29da45bc9..66dc737fba48a12778d543a618e43b5c90f91a07 100644 (file)
@@ -15,8 +15,15 @@ namespace HandBrake.Interop
                public const int JobPaddingBytes = 24688;\r
                public const int AudioPaddingBytes = 24632;\r
 #else\r
-               public const int JobPaddingBytes = 24640;\r
-               public const int AudioPaddingBytes = 24604;\r
+           /// <summary>\r
+           /// Job Padding Bytes\r
+           /// </summary>\r
+           public const int JobPaddingBytes = 24640;\r
+\r
+           /// <summary>\r
+           /// Audio Padding Bytes\r
+           /// </summary>\r
+           public const int AudioPaddingBytes = 24604;\r
 #endif\r
        }\r
 }\r
index 8850daff5144d36a8eb348c0394105f2f9288331..fd33c9ef3bd7cbfe7618f8b2ae00d84c218201fa 100644 (file)
@@ -11,8 +11,14 @@ namespace HandBrake.Interop
 {\r
        using System;\r
 \r
+       /// <summary>\r
+       /// The Message Logged Event Args\r
+       /// </summary>\r
        public class MessageLoggedEventArgs : EventArgs\r
        {\r
+               /// <summary>\r
+               /// Gets or sets Message.\r
+               /// </summary>\r
                public string Message { get; set; }\r
        }\r
 }\r
index 1b01a87db1990d011312647ac9b9ec955dd02fc4..adc74c456613646f781b90bc4d761df84d0537aa 100644 (file)
@@ -12,7 +12,7 @@ namespace HandBrake.Interop
        using System;\r
        using System.Collections.Generic;\r
 \r
-    /// <summary>\r
+       /// <summary>\r
        /// Represents a HandBrake style native list.\r
        /// </summary>\r
        public class NativeList\r
index 2b96f84682e9fb36b9b74cd3a7a38d3302648b2b..ce20a4f9d695a8a4e2c93639e29ff2f22a5f7200 100644 (file)
@@ -11,9 +11,19 @@ namespace HandBrake.Interop
 {\r
        using System;\r
 \r
-       public class ScanProgressEventArgs : EventArgs\r
+    /// <summary>\r
+    /// The Scan Progress Event Args\r
+    /// </summary>\r
+    public class ScanProgressEventArgs : EventArgs\r
        {\r
-               public int CurrentTitle { get; set; }\r
-               public int Titles { get; set; }\r
+           /// <summary>\r
+           /// Gets or sets CurrentTitle.\r
+           /// </summary>\r
+           public int CurrentTitle { get; set; }\r
+\r
+           /// <summary>\r
+           /// Gets or sets Titles.\r
+           /// </summary>\r
+           public int Titles { get; set; }\r
        }\r
 }\r