1>Admin at 11:50, 20 January 2025

2025-01-20T11:50:26Z

New page

{{infobox function
|name=GIModel.New
|object=[[Объект GI#Атрибуты и функции моделей|Атрибуты и функции моделей]]
|caption=Общие функции моделей
|type=1
|status=2
|db=0
|exception=Неверные аргументы
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Объект GI]]}}
Функция сопоставляет буфер с микрокодом с текущей моделью. Буфер может быть как сопоставлен с текущей моделью (любые изменения в нем приведут к изменениям в модели), так и скопирован в независимую область памяти при сопоставлении, что медленнее при создании, но, возможно более удобно, если модель не изменяется вообще. Выбор подхода остается на усмотрении разработчика, обычно удобнее сопоставлять буфер и этот способ работает по умолчанию. Буфер обычно удобно заполнять функцией [[Buffer.AddValues|AddValues]], либо загружать заранее подготовленную модель из файла.

Микрокод зависит от текущей графической спецификации. Микрокод представляет собой последовательность двойных слов (32 бита, но могут быть и слова 64 бита) в буфере с номерами команд спецификации и их аргументами (чаще всего вещественные числа 32 бит или целые числа 32 бит) по данной ниже таблице. При прорисовке модели, система проходит по всем командам буфера до тех пор, пока она не встретит команду 0 или конец буфера. Данный способ прорисовки гораздо быстрее прямого вызова графических команд, так как он происходит на низком уровне. Ниже дана таблица микрокода для спецификации OpenGL:

{|class="wikitable sortable" style="border-collapse:collapse;font-size:80%;width=95%;"
! width=10%|Команда (32 бит)
! Аргументы
! width=35%|Соответствующая команда OpenGL
|-
|-align="left"
|'''0'''
|Аргументов нет. Команда окончания рисования.
|
|-align="left"
|'''1'''
|Один аргумент int32, параметр glBegin. Может быть GI.GL_POINTS, GI.GL_LINES, GI.GL_QUADS и т.д.
|<code>glBegin</code>
|-align="left"
|'''2'''
|Аргументов нет. Окончание транзакции рисования glEnd.
|<code>glEnd</code>
|-align="left"
|'''3'''
|Один аргумент int32, параметр glEnable.
|<code>glEnable</code>
|-align="left"
|'''4'''
|Один аргумент int32, параметр glDisable.
|<code>glDisable</code>
|-align="left"
|'''5'''
|Два аргумента int32, один single, параметры glTexEnv.
|<code>glTexEnv</code>
|-align="left"
|'''6'''
|Два аргумента int32, параметр glBlendFunc.
|<code>glBlendFunc</code>
|-align="left"
|'''7'''
|Четыре аргумента int32, параметры glBlendFuncSeparate.
|<code>glBlendFuncSeparate</code>
|-align="left"
|'''8'''
|Один аргумент int32, параметр glBlendEquation.
|<code>glBlendEquation</code>
|-align="left"
|'''9'''
|Два аргумента int32, параметры glBlendEquationSeparate.
|<code>glBlendEquationSeparate</code>
|-align="left"
|'''10'''
|Четыре аргумент single, параметры glBlendColor.
|<code>glBlendColor</code>
|-align="left"
|'''11'''
|Четыре аргумента int32, параметр glColorMask.
|<code>glColorMask</code>
|-align="left"
|'''12'''
|Один аргумент int32, параметр glLogicOp.
|<code>glLogicOp</code>
|-align="left"
|'''13'''
|Один аргумент int32, параметр glDrawBuffer.
|<code>glDrawBuffer</code>
|-align="left"
|'''14'''
|Один аргумент int32 -- количество буферов (N), затем N-аргументов int32 перечисляющих эти буферы.
|<code>glDrawBuffers</code>
|-align="left"
|'''100'''
|Три аргумента single, параметры glVertex.
|<code>glVertex</code>
|-align="left"
|'''101'''
|Три аргумента single, параметры glColor.
|<code>glColor</code>
|-align="left"
|'''102'''
|Шесть аргументов single, параметры glMaterial (см. glMaterialfv)
|<code>glMaterial</code>
|-align="left"
|'''103'''
|Три аргумента single, параметры glTexCoord.
|<code>glTexCoord</code>
|-align="left"
|'''104'''
|Три аргумента single, параметры glNormal.
|<code>glNormal</code>
|-align="left"
|'''105'''
|Один аргумент int32, параметр glEdgeFlag.
|<code>glEdgeFlag</code>
|-align="left"
|'''106'''
|Один аргумент single, параметры glFogCoord.
|<code>glFogCoord</code>
|-align="left"
|'''110'''
|Три аргумента int32, параметры glDrawArrays.
|<code>glDrawArrays</code>
|-align="left"
|'''111'''
|Три аргумента int32 (mode, count, type), один аргумент int32 (размер данных в байтах), далее N-байт данных.
|<code>glDrawElements</code>
|-align="left"
|'''112'''
|Пять аргументов int32 (mode, starts, end, count, type), один аргумент int32 (размер данных в байтах), далее N-байт данных.
|<code>glDrawRangeElements</code>
|-align="left"
|'''113'''
|Четыре аргумента int32, параметры glDrawArraysInstanced.
|<code>glDrawArraysInstanced</code>
|-align="left"
|'''114'''
|Четыре аргумента int32 (mode, count, type, instancecount), один аргумент int32 (размер данных в байтах), далее N-байт данных.
|<code>glDrawElementsInstanced</code>
|-align="left"
|'''115'''
|Четыре аргумента int32 (mode, count, type, basevertex), один аргумент int32 (размер данных в байтах), далее N-байт данных.
|<code>glDrawElementsBaseVertex</code>
|-align="left"
|'''116'''
|Шесть аргументов int32 (mode, start, end, count, type, basevertex), один аргумент int32 (размер данных в байтах), далее N-байт данных.
|<code>glDrawRangeElementsBaseVertex</code>
|-align="left"
|'''117'''
|Пять аргументов int32 (mode, count, type, instancecount, basevertex), один аргумент int32 (размер данных в байтах), далее N-байт данных.
|<code>glDrawElementsInstancedBaseVertex</code>
|-align="left"
|'''118'''
|Один аргумент int32 (mode), один аргумент int32 (размер данных в байтах), далее N-байт данных.
|<code>glDrawArraysIndirect</code>
|-align="left"
|'''119'''
|Два аргумента int32 (mode, type), один аргумент int32 (размер данных в байтах), далее N-байт данных.
|<code>glDrawElementsIndirect</code>
|-align="left"
|'''120'''
|Два аргумента int32 (mode, id)
|<code>glDrawTransformFeedback</code>
|-align="left"
|'''121'''
|Три аргумента int32 (mode, id, stream)
|<code>glDrawTransformFeedbackStream</code>
|-align="left"
|'''122'''
|Пять аргументов int32, параметры glDrawArraysInstancedBaseInstance.
|<code>glDrawArraysInstancedBaseInstance</code>
|-align="left"
|'''123'''
|Пять аргументов int32 (mode, count, type, instancecount, baseinstance), один аргумент int32 (размер данных в байтах), далее N-байт данных.
|<code>glDrawElementsInstancedBaseInstance</code>
|-align="left"
|'''124'''
|Шесть аргументов int32 (mode, count, type, instancecount, basevertex, baseinstance), один аргумент int32 (размер данных в байтах), далее N-байт данных.
|<code>glDrawElementsInstancedBaseVertexBaseInstance</code>
|-align="left"
|'''125'''
|Три аргумента int32, параметры glDrawTransformFeedbackInstanced.
|<code>glDrawTransformFeedbackInstanced</code>
|-align="left"
|'''126'''
|Четыре аргумента int32, параметры glDrawTransformFeedbackStreamInstanced.
|<code>glDrawTransformFeedbackStreamInstanced</code>
|-align="left"
|'''130'''
|Два аргумента int32 (mode, drawcount), один аргумент int32 (размер массива начальных индексов "first" в '''байтах'''), один аргумент int32 (размер массива количеств индексов "count" в '''байтах'''), далее N-байт данных массив "first", далее N-байт массив "count".
|<code>glMultiDrawArrays</code>
|-align="left"
|'''131'''
|Три аргумента int32 (mode, type, drawcount), один аргумент int32 (размер массива количеств "count" в '''байтах'''), один аргумент int32 (размер массива индексов "*indices" в '''байтах'''), далее N-байт данных массив "count", далее N-байт массив "*indices". '''Внимание''': массив "*indices" должен содержать реальные адреса в памяти (см. [[Buffer.SystemAddress]]).
|<code>glMultiDrawElements</code>
|-align="left"
|'''132'''
|Три аргумента int32 (mode, type, drawcount), один аргумент int32 (размер массива количеств "count" в '''байтах'''), один аргумент int32 (размер массива индексов "*indices" в '''байтах'''), один аргумент int32 (размер массива вертексов "basevertex" в '''байтах'''), далее N-байт данных массив "count", далее N-байт массив "*indices", далее N-байт данных массив "basevertex". '''Внимание''': массив "*indices" должен содержать реальные адреса в памяти (см. [[Buffer.SystemAddress]]).
|<code>glMultiDrawElementsBaseVertex</code>
|-align="left"
|'''133'''
|Три аргумента int32 (mode, drawcount, stride), один аргумент int32 (размер массива записей "indirect" в '''байтах'''), далее N-байт данных массив "indirect" -- элементы этого массива содержат более одного значения, см. описание.
|<code>glMultiDrawArraysIndirect</code>
|-align="left"
|'''134'''
|Четыре аргумента int32 (mode, type, drawcount, stride), один аргумент int32 (размер массива записей "indirect" в '''байтах'''), далее N-байт данных массив "indirect" -- элементы этого массива содержат более одного значения, см. описание.
|<code>glMultiDrawElementsIndirect</code>
|-align="left"
|'''135'''
|Четыре аргумента int32 (mode, drawcount, maxdrawcount, stride), один аргумент int32 (размер массива записей "indirect" в '''байтах'''), далее N-байт данных массив "indirect" -- элементы этого массива содержат более одного значения, см. описание.
|<code>glMultiDrawArraysIndirectCount</code>
|-align="left"
|'''136'''
|Пять аргументов int32 (mode, type, drawcount, maxdrawcount, stride), один аргумент int32 (размер массива записей "indirect" в '''байтах'''), далее N-байт данных массив "indirect" -- элементы этого массива содержат более одного значения, см. описание.
|<code>glMultiDrawElementsIndirectCount</code>
|-align="left"
|'''200'''
|Одни аргумент int32, параметр glActiveTexture.
|<code>glActiveTexture</code>
|-align="left"
|'''201'''
|Два аргумента int32, параметры glBindTexture.
|<code>glBindTexture</code>
|-align="left"
|'''202'''
|Три аргумента int32 (size, type, stride), один аргумент int32 (размер массива "pointer" в '''байтах'''), далее N-байт данных массив "pointer".
|<code>glVertexPointer</code>
|-align="left"
|'''203'''
|Два аргумента int32 (type, stride), один аргумент int32 (размер массива "pointer" в '''байтах'''), далее N-байт данных массив "pointer".
|<code>glIndexPointer</code>
|-align="left"
|'''204'''
|Два аргумента int32 (type, stride), один аргумент int32 (размер массива "pointer" в '''байтах'''), далее N-байт данных массив "pointer".
|<code>glNormalPointer</code>
|-align="left"
|'''205'''
|Три аргумента int32 (size, type, stride), один аргумент int32 (размер массива "pointer" в '''байтах'''), далее N-байт данных массив "pointer".
|<code>glTexCoordPointer</code>
|-align="left"
|'''206'''
|Три аргумента int32 (size, type, stride), один аргумент int32 (размер массива "pointer" в '''байтах'''), далее N-байт данных массив "pointer".
|<code>glColorPointer</code>
|-align="left"
|'''207'''
|Один аргумент int32 (stride), один аргумент int32 (размер массива "pointer" в '''байтах'''), далее N-байт данных массив "pointer".
|<code>glEdgeFlagPointer</code>
|-align="left"
|'''208'''
|Пять аргументов int32 (index, size, type, normalized, stride), один аргумент int32 (размер массива "pointer" в '''байтах'''), далее N-байт данных массив "pointer".
|<code>glVertexAttribPointer</code>
|-align="left"
|'''210'''
|Один аргумент int32, параметр glEnableVertexAttribArray.
|<code>glEnableVertexAttribArray</code>
|-align="left"
|'''211'''
|Один аргумент int32, параметр glDisableVertexAttribArray.
|<code>glDisableVertexAttribArray</code>
|-align="left"
|'''220'''
|Один аргумент int32, параметр glBindVertexArray.
|<code>glBindVertexArray</code>
|-align="left"
|'''221'''
|Два аргумента int32, параметры glBindBuffer.
|<code>glBindBuffer</code>
|-align="left"
|'''222'''
|Четыре аргумента int32, параметры glBindVertexBuffer.
|<code>glBindVertexBuffer</code>
|-align="left"
|'''300'''
|Один аргумента int32, параметр glUseProgram.
|<code>glUseProgram</code>
|-align="left"
|'''301'''
|Три аргумента int32 (уникальный номер переменной программы шейдеров, количество значений для переменных-массивов (к примеру, см. <code>glUniform2fv</code>, для обычных переменных этот аргумент обычно равен '''1'''), тип значений). Далее, в зависимости от типа значений, следуют значения или их системный адрес. Тип значений представлят собой битовую маску со следующими битами (<code>ATttttSSSSssss</code>):
* '''биты 0..3''' (ssss): количество чисел в значении (к примеру, для <code>glUniform2f</code>, два числа).
* '''биты 4..7''' (SSSS): только для переменных-матриц, количество чисел в матрице по вертикали (к примеру, для <code>glUniformMatrix2f</code> равно 1, для <code>glUniformMatrix4x3f</code> равно 4).
* '''биты 8..11''' (tttt): числовой тип значений. '''0''' -- single float, '''1''' -- int32, '''2''' -- uint32 (без знака), '''3''' -- double float (если поддерживается драйвером)
* '''бит 12''' (T): только для переменных-матриц, '''1''', если матрица транспонирована (другой порядок значений).
* '''бит 13''' (A): вместо самих значений последующий аргумент -- 64-битный системный адрес массива значений. И для x86 и для x64 аргумент занимает 8 байт, для x86 последние 4 байта игнорируются.

Примеры: <code>glUniformMatrix2f</code>: '''$012''', <code>glUniformMatrix4x3f</code>: '''$043''', <code>glUniform3f</code>: '''$003''' и т.п.
|<code>glUniform???</code>
|-align="left"
|'''302'''
|Один аргумента int32 -- уникальный номер переменной программы шейдеров. Эта команда транслируется как <code>glUniform1f(<номер переменной>,<значение GI.WorldTime>)</code>.
|Заполнение <code>GI.WorldTime (u_time)</code>
|-align="left"
|'''303'''
|Один аргумента int32 -- уникальный номер переменной программы шейдеров. Эта команда транслируется как <code>glUniform2f(<номер переменной>,<значение GI.Width>,<значение GI.Height>)</code>.
|Заполнение <code>Width/Height (u_resolution)</code>
|-align="left"
|'''304'''
|Один аргумента int32 -- уникальный номер переменной программы шейдеров. Эта команда транслируется как <code>glUniform2f(<номер переменной>,<позиция мыши по X>,<позиция мыши по Y>)</code>.
|Заполнение <code>mouse.x/mouse.y (u_mouse)</code>
|-align="left"
|'''400'''
|Аргументов нет. Выполнение glPushMatrix.
|<code>glPushMatrix</code>
|-align="left"
|'''401'''
|Три аргумента single, движение текущей матрицы по x, y и z.
|<code>glTranslatef</code>
|-align="left"
|'''402'''
|Три аргумента single, поворот текущей матрицы вокрут осей x, y и z.
|<code>glRotatef</code>
|-align="left"
|'''403'''
|Три аргумента single, масштабирование текущей матрицы по осям x, y и z.
|<code>glScalef</code>
|-align="left"
|'''404'''
|Аргументов нет. Выполнение glPopMatrix.
|<code>glPopMatrix</code>
|-align="left"
|'''405'''
|Один аргумент int32, параметр glMatrixMode.
|<code>glMatrixMode</code>
|}

== Синтаксис ==
<code>
{{Grey|GIModel.}}'''SimpleModel'''(''<Источник микрокода (BUFFER)>''{{Optional|,<Режим модели (INT)>{{Default|{{Eq}}0}}}})
</code>

==== Аргументы ====
* <code>''<Источник микрокода (BUFFER)>''</code> - Аргумент задает буфер, в котором задан или будет задан микрокод для прорисовки модели.
* <code>''<Режим модели (INT)>''</code> - {{Optional}} Аргумент режим модели и буфера и является битовой маской со следующими битами:
** '''бит 0''': ''0'' -- использовать функции спецификации с числами single (по умолчанию), иначе использовать функции с числами double, где это возможно. Не все драйверы могут поддерживать числа double.
** '''бит 1''': ''0'' -- указанный буфер будет ассоциирован с моделью, все изменения в буфере будут сказываться на модели (по умолчанию), иначе содержимое буфера будет скопировано в особую область памяти и модель будет рисоваться по этим данным.

== Примеры ==
<pre>
//Используется фрагмент из обработки tetris.sfo

//Создадим новую простую модель с пустым буфером
аБуфер:=Buffer.Create();
аМодель:=GIModel.New();
аМодель.SimpleModel(аБуфер);

//Заполним буфер микрокодом
аСмещ:=0;
аБуфер.AddValues(аСмещ,4,201,aGI.GL_TEXTURE_2D,0);//glBindTexture
аБуфер.AddValues(аСмещ,4,300,лкПрограммы[3]);//ShaderProgramUse
аБуфер.AddValues(аСмещ,4,301,aGI.ShaderProgramGetVariableID(лкПрограммы[3],"u_scrpos"),4,$004);
аБуфер.AddValues(аСмещ,104,x,aGI.Height-y,2*dx,2*dx);//u_scrpos
аБуфер.AddValues(аСмещ,4,302,aGI.ShaderProgramGetVariableID(лкПрограммы[3],"u_time"));//u_time
аБуфер.AddValues(аСмещ,4,301,aGI.ShaderProgramGetVariableID(лкПрограммы[3],"u_starttime"),1,$001);
аБуфер.AddValues(аСмещ,104,aGI.WorldTime);//u_starttime

аБуфер.AddValues(аСмещ,4,1,aGI.GL_QUADS);//glBegin
аБуфер.AddValues(аСмещ,4,100);аБуфер.AddValues(аСмещ,104,x,y,-0.3);//glVertex
аБуфер.AddValues(аСмещ,4,100);аБуфер.AddValues(аСмещ,104,x,y+2*dx,-0.3);//glVertex
аБуфер.AddValues(аСмещ,4,100);аБуфер.AddValues(аСмещ,104,x+2*dx,y+2*dx,-0.3);//glVertex
аБуфер.AddValues(аСмещ,4,100);аБуфер.AddValues(аСмещ,104,x+2*dx,y,-0.3);//glVertex
аБуфер.AddValues(аСмещ,4,2);//glEnd
аБуфер.AddValues(аСмещ,4,0);//EOF

//Создадим новый объект и добавим к нему эту модель
аОбъект:=aGI.AddObject("EXP");
аОбъект.Model(аМодель);
</pre>

GIModel.SimpleModel - Revision history

Admin: 1 revision imported

1>Admin at 11:50, 20 January 2025

← Older revision	Revision as of 06:53, 22 January 2025
(No difference)