Справка н.у. модулей

InstallerSamples/OpenGL и OpenCL/Гайд по использованию OpenGL и OpenCL.html

@@ -1042,7 +1042,7 @@ MyProc(default(gl_buffer));
 <p>Многие параметры подпрограмм в исходных библиотеках принимают перечисления (enum'ы).</p>
 <p>Перечисления, как и имена, это числа. Но в отличии от имён - перечисления принимают заданные заранее константные значения.</p>
 <p>В качестве примера:</p>
-<pre><code>procedure gl.BeginQuery(target: QueryTarget; id: QueryName);
+<pre><code>procedure gl.BeginQuery(target: QueryTarget; id: gl_query)
 </code></pre>
 <p>Параметр <code>target</code> принимает одно из значений, сгрупированных в записи <code>QueryTarget</code>:</p>
 <pre><code>  QueryTarget = record
@@ -1087,8 +1087,8 @@ gl.BeginQuery(QueryTarget.VERTICES_SUBMITTED, name);
 <pre><code>procedure gl.Clear(mask: ClearBufferMask);
 </code></pre>
 <pre><code>gl.Clear(
-  ClearBufferMask.COLOR_BUFFER_BIT + // очистка поверхности рисования одним цветом
-  ClearBufferMask.DEPTH_BUFFER_BIT   // очистка буфера глубины - обязательна при рисовании 3D
+  ClearBufferMask.COLOR_BUFFER_BIT + // Очистка поверхности рисования одним цветом
+  ClearBufferMask.DEPTH_BUFFER_BIT   // Очистка буфера глубины - нужна при рисовании 3D
 );
 </code></pre>
 </div>
@@ -1102,12 +1102,18 @@ gl.BeginQuery(QueryTarget.VERTICES_SUBMITTED, name);
 </code></pre>
 <p>По нажатию точки после <code>cl</code> вам так же покажет список всех функций в ядре OpenCL.</p>
 <hr />
-<p>С OpenGL немного сложнее: в каждом контексте у каждой подпрограммы может быть свой адрес.
-Поэтому подпрограммы надо получать в зависимости от контекста. В модуле <code>OpenGL</code> это реализовано так:</p>
+<p>С OpenGL немного сложнее:</p>
+<ol>
+<li>В каждом контексте у каждой подпрограммы может быть свой адрес.</li>
+<li>Получение адреса подпрограммы выглядит по-разному на разных платформах.</li>
+</ol>
+<p>В модуле <code>OpenGL</code> это реализовано так:</p>
 <pre><code>//ToDo Создание контекста и привязка его к текущему потоку
 
 // Все адреса и экземпляры делегатов создаются в конструкторе
-var gl := new OpenGL.gl;
+// В &quot;&lt;&gt;&quot; указывается имя платформы
+// Можете написать &quot;Pl&quot; и нажать Ctrl+пробел, чтоб получить список платформ
+var gl := new OpenGL.gl&lt;PlWin&gt;;
 
 while true do
 begin
@@ -1123,25 +1129,26 @@ end;
 <p>У каждого расширения есть свой класс. К примеру, так используется расширение <code>GL_AMD_debug_output</code>:</p>
 <pre><code>//ToDo Опять же, сначала контекст
 
-var glDebugOutputAMD := new OpenGL.glDebugOutputAMD;
+var glDebugOutputAMD := new OpenGL.glDebugOutputAMD&lt;PlWin&gt;;
 ...
 glDebugOutputAMD.DebugMessageEnableAMD(...);
 </code></pre>
 <hr />
-<p>В модуле <code>OpenGL</code> так же есть особые классы, <code>wgl</code> и <code>gdi</code>:</p>
+<p>В модуле <code>OpenGL</code> так же есть особые классы, <code>wgl</code>, <code>gdi</code> и <code>glx</code>:</p>
 <ul>
 <li><p><code>gdi</code> содержит несколько методов библиотеки <code>gdi32.dll</code>. На этой библиотеке основано всё в <code>System.Windows.Forms</code>.<br />
-Подпрограммы включённые в класс <code>gdi</code> - это то что может понадобиться вам чтоб настроить и подготовить форму для рисования на ней с помощью OpenGL.</p>
+Подпрограммы включённые в класс <code>gdi</code> - это то, что может понадобиться вам, чтоб настроить и подготовить форму для рисования на ней с помощью OpenGL.</p>
 </li>
-<li><p><code>wgl</code> содержит методы для работы с OpenGL на Windows. Для других ОС есть класс <code>glX</code>, но он сейчас выключен из релиза.
-Это потому, что у меня нет компьютера, на котором установлена не_Windows, а значит я не могу
-заняться тестированием чтоб узнать как правильно объявлять всё в этом классе. Если у вас есть
-другая ОС и вы хотите помочь мне разобраться - пожалуйста, свяжитесь со мной (желательно в issue).</p>
+<li><p><code>wgl</code> содержит методы для подключения OpenGL к окну Windows.</p>
+</li>
+<li><p><code>glx</code> содержит методы для подключения OpenGL к окну XWindow.</p>
 </li>
 </ul>
 <p>Оба этих класса работают как класс <code>cl</code>, то есть им <strong>не</strong> надо создавать экземпляр.</p>
 <hr />
-<p>И последнее что вам надо знать об этих классах: Если вы получаете <code>NullReferenceException</code>:</p>
+<p>И последнее что вам надо знать об этих классах:<br />
+Если вы получаете <code>NullReferenceException</code>,
+при попытке вызова функции из инициализируемых классов, как <code>gl</code>:</p>
 <ol>
 <li><p>Скорее всего вы попытались вызвать подпрограмму, которой нет в реализации библиотеки на вашем компьютере.<br />
 Проверьте версию библиотеки, или, если это подпрограмма из расширения - проверьте существование у вас этого расширения.</p>
@@ -1826,10 +1833,16 @@ begin
   d.DynamicInvoke(5); // вообще .DynamicInvoke это очень медленно
   
   var p: integer-&gt;();
-//  var p: Action&lt;integer&gt;; // такое же объявление как на предыдущей строчке, но в другом стиле
+  // Такое же объявление как на предыдущей строчке, но в другом стиле
+//  var p: Action&lt;integer&gt;;
+  // И ещё один стиль. Этот особенный, потому что
+  // он неявно создаёт новый тип делегата
+//  var p: procedure(i: integer);
   p := p1;
   
-  p(5); // типизированные делегаты можно вызывать быстрее и проще, так же как обычные подпрограммы
+  // Типизированные делегаты можно вызывать быстрее и проще,
+  // так же как обычные подпрограммы
+  p(5);
   
 end.
 </code></pre>
@@ -1863,7 +1876,7 @@ end.
 <ol>
 <li><p><code>cl.SetEventCallback</code> вызывает свой коллбек тогда, когда посчитает нужным (но обычно после того как вызов <code>cl.SetEventCallback</code> завершился);</p>
 </li>
-<li><p>Делегаты - это классы. И на самом деле кроме самого адреса хранят ещё много всякой информации (как типы параметров);</p>
+<li><p>Делегаты - это классы.</p>
 </li>
 <li><p>Сборщик мусора распоряжается памятью классов и удаляет их, тоже когда посчитает нужным.</p>
 </li>
@@ -1874,9 +1887,9 @@ end.
 <p>Если сборщик мусора удалит делегат, а затем .dll попытается его вызвать -
 это приведёт или к ошибке доступа, или к моментальному беззвучному вылету.</p>
 <p>Чтоб запретить сборщику мусора удалять делегать - нужно создать <code>GCHandle</code>, привязанный к нему.<br />
-Но в отличии от массивов - <code>GCHandleType.Pinned</code> не нужно, потому что сборщик мусора может перемещать
-в памяти данные о параметрах делегата, но не сам адрес (а он единственное что передаётся в .dll).
-Это потому что адрес хранится в виде указателя на неуправляемый код.</p>
+Но в отличии от массивов - <code>GCHandleType.Pinned</code> не нужно, потому что сборщик мусора
+не может перемещать адрес исполняемого кода (а он единственное что передаётся в .dll).
+Это потому, что этот адрес хранится в виде указателя на неуправляемый код.</p>
 <pre><code>uses System.Runtime.InteropServices;
 uses System;
 uses OpenCL;
@@ -1889,8 +1902,8 @@ begin
     
     Writeln($'{ev} перешёл в состояние {st}');
     
-    // в данном случае освобождать GCHandle станет можно тогда, когда делегат 1 раз выполнится,
-    // а значит очень удобно поставить освобождение в конец самого делегата
+    // В данном случае освобождать GCHandle станет можно тогда, когда делегат 1 раз выполнится,
+    // А значит очень удобно поставить освобождение в конец самого делегата
     gc_hnd.Free;
   end;
   gc_hnd := GCHandle.Alloc(cb);

InstallerSamples/OpenGL и OpenCL/Справка OpenGLABC.html

@@ -878,7 +878,7 @@ window.onload = ()=>{
 <div id="page-1" page_name="" hidden=true>
 <p><code>ToDo</code> модуль <code>OpenGLABC</code> пока что не существует. Когда то он появится, но пока что есть только это сообщение.</p>
 <p>Если хотите понять, было ли это сообщение оставлено тут 10 лет назад и забыто - вот дата, когда автор сообщения последний раз прочитал его:<br />
-03.08.2020</p>
+2021.01.05</p>
 </div>
 <script>on_start_folder("GL ABC", document.getElementById("page-1"))</script>
 <script>on_end_folder()</script>