daily update on 20231214 by nitload youmu

2023-12-14 07:01:01 +08:00
parent f97fb137ba
commit 8b14599233
54 changed files with 537 additions and 241 deletions
@@ -5,6 +5,28 @@ namespace StgSharp.Graphics
 {
    public interface IglFunc
    {
+        /// <summary>
+        /// Align a sets of code to frame update of a <see cref="Form"/>.
+        /// Usually, a call of <see cref="AfterAlign(Form,Action)"/> is required.
+        /// This method is used as sigle thread method. If more than one
+        /// alignment is requested, a <see cref="InvalidOperationException"/> will throw.
+        /// </summary>
+        /// <param name="form">The form used as frame update benchmark.</param>
+        /// <exception cref="InvalidOperationException">More than one alingment attached to one form timer</exception>
+        void AlignFrame(Form form);
+
+        /// <summary>
+        /// Operation after alignment by calling <see cref="AlignFrame(Form)"/>.
+        /// No calling of this method is acceptable, but it will bring the risk 
+        /// of that relevant code will not run if it is interrupted by frame overtime.
+        /// Please call this method immediately after calling <see cref="AlignFrame(Form)"/>,
+        /// too early or sonner may cause <see cref="InvalidOperationException"/>.
+        /// </summary>
+        /// <param name="form">The form used as frame update benchmark.</param>
+        /// <param name="action">Operation after frame update alignment.</param>
+        /// <exception cref="InvalidOperationException">The action binded to a wrong alignment.</exception>
+        void AfterAlign(Form form, Action action);
+
        /// <summary>
        /// Same function as OpenGL api glActiveTexture
        /// </summary>