Редактирование:Рендер блоков

<div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output">
<h1> <span style="font-size:18.0pt"><span style="line-height:107%">Введение в рендер блоков</span></span> </h1>
<p>Кроме формы из одного параллелепипеда, которой обладает большинство блоков, Inner Core позволяет задать им почти любой внешний вид. &#160;
</p>
<h2> Формат описания текстуры и ее наложение на блок </h2>
<p>Хоть наложение текстур и было описано ранее, оно имеет непосредственное отношение к дальнейшему описанию.
</p><p>Ссылка на каждую отдельную текстуру блока состоит из двух элементов - ее названия и индекса, напомню, что название и индекс задаются для файла текстуры в ресурсах в формате "имя_индекс.png", где имя - произвольная строка, а индекс - неотрицательное целое число.
</p><p>Текстура целого блока может быть описана либо двумя параметрами - именем и индексом текстуры, в таком случае весь блок будет иметь одну и ту же текстуру, либо массивом текстур, формат которого приведен ниже.
</p><p>&#160;
<pre class="fck_mw_syntaxhighlight"><syntaxhighlight lang="Javascript">[
    [&quot;название1&quot;, индекс1], // bottom
    [&quot;название2&quot;, индекс2], // top
    [&quot;название3&quot;, индекс3], // back
    [&quot;название4&quot;, индекс4], // front
    [&quot;название5&quot;, индекс5], // left
    [&quot;название6&quot;, индекс6]  // right
]</syntaxhighlight></pre>
</p><p>&#160;
</p><p>Каждый из элементов массива отвечает за одну текстуру, если элементов меньше 6, то текстуры недостающих сторон скопируют последний элемент массива.
</p>
<h2> Статичная модель блока </h2>
<p>Статичная модель является самым простым типом рендера блока и представляет из себя набор различных элементов внешнего вида блока, которые могут быть отрисованы на произвольных координатах. Внешний вид статичной модели не зависит от того, что ее окружает.
</p><p>Основной, хоть и не единственный элемент модели - бокс - является текстурированным параллелепипедом с заданными начальными и конечными координатами x1, y1, z1, x2, y2, z2 в пространстве конкретного блока (0 означает начало блока, 1 - конец по данной координате, координаты могут выходить за пределы 0-1).&#160;&#160;
</p><p>Пустая статичная модель создается с помощью конструктора <i>new BlockRenderer.Model()</i> и обладает следующими методами:
</p><p><span style="line-height:108%"><i>model.addBox(x1, y1, z1, x2, y2, z2, id, data) - добавляет бокс с текстурой блока с данными id, data</i></span>
</p><p><span style="line-height:108%"><i>model.addBox(x1, y1, z1, x2, y2, z2, "name", index) - добавляет бокс с текстурой с именем name и индексом index на всех сторонах</i></span>
</p><p><span style="line-height:108%"><i>model.addBox(x1, y1, z1, x2, y2, z2, [… texture set ...]) - добавляет бокс с заданным массивом текстур (формат см. выше)</i></span>
</p><p><span style="line-height:108%"><i>model.addMesh(mesh) - добавляет в модель объект RenderMesh - произвольную полигональную 3D модель, о которых будет рассказано позднее</i></span>
</p><p>Существуют так же другие конструкторы, упрощающие быстрое создание простых моделей:
</p><p><span style="line-height:108%"><i>new BlockRenderer.Model(mesh) - создает модель, которая содержит в себе данный объект RenderMesh</i></span>
</p><p><span style="line-height:108%"><i>new BlockRenderer.Model(x1, y1, z1, x2, y2, z2, [… texture set ...]) - создает модель, которая является одним боксом с данным массивом текстур</i></span>
</p><p><span style="line-height:108%"><i>new BlockRenderer.Model([… texture set ...]) - создает модель, которая является полным блоком с данным массивом текстур</i></span>
</p><p><span style="line-height:108%"><i>new BlockRenderer.Model(x1, y1, z1, x2, y2, z2, "name", index) - создает модель, которая является одним боксом с данной текстурой на всех сторонах</i></span>
</p><p><span style="line-height:108%"><i>new BlockRenderer.Model("name", index) - создает модель, которая является полным блоком с данной текстурой на всех сторонах</i></span>
</p><p><span style="line-height:108%"><i>new BlockRenderer.Model(x1, y1, z1, x2, y2, z2, id, data) - создает модель, которая является одним боксом, копирующим текстуру из блока с данными id, data</i></span>
</p><p><span style="line-height:108%"><i>new BlockRenderer.Model(id, data) -&#160; создает модель, которая является полным блоком, копирующим текстуру из блока с данными id, data</i></span>
</p>
<h2> Основы ICRender </h2>
<p>ICRender является системой, позволяющей заранее задать блоку внешний вид в зависимости от внешних условий. Основным объектом для рендера блоков является модель ICRender, которая является набором статических моделей и условий, при которых они будут отрисовываться.
</p><p>Для создания модели ICRender используется конструктор <i>new ICRender.Model(), </i>для добавления статичной модели в модель ICRender используется метод <i>addEntry(model)</i>: <i>var staticModel = new BlockRenderer.Model(); // модификация модели staticModel var icRenderModel = new ICRender.Model(); icRenderModel.addEntry(staticModel);&#160;</i>
</p><p>Чтобы установить блоку модель ICRender используется метод
</p>
<p style="margin-top:0cm; margin-right:3.2pt; margin-bottom:7.85pt; margin-left:0cm; text-align:justify"><span style="text-justify:inter-ideograph"><span style="line-height:108%"><i>BlockRenderer.setStaticICRender(id, data, model) - </i>где id и data - целевой блок (если надо установить для любого значения data, вместо него нужно передать -1), а model - модель ICRender.</span></span></p> 
<p>Пример:
</p><p><span style="line-height:108%"><i>BlockRenderer.setStaticICRender(BlockID.testRenderBlock, -1, icRenderModel); // после этого требуемый блок будет иметь созданную ранее модель</i></span>
</p>
<h2> Маппинг рендера<i> </h2></i>
<p>Кроме обычной установки ICRender блокам, им можно так же включить режим <i>маппинга рендера</i>. Он позволяет устанавливать любые модели ICRender конкретным блокам в мире, для которых маппинг включен, не затрагивая остальные блоки.
</p><p>Для включения маппинга используется метод <i>BlockRenderer.enableCoordMapping(id, data, model) - </i>где id и data - целевой блок, а model - модель ICRender, которая будет использована для данного блока по умолчанию.
</p><p>Без дополнительных действий такой вызов ничем не будет отличаться по действию от вызова <i>BlockRenderer.setStaticICRender. </i>Для маппинга используются следующие методы:
</p><p><span style="line-height:108%"><i>BlockRenderer.mapAtCoords(x, y, z, model) - устанавливает данную модель ICRender на данные координаты, любой блок, для которого включен маппинг и который стоит на этих координатах, будет иметь эту модель.</i></span>
</p><p><span style="line-height:108%"><i>BlockRender.unmapAtCoords(x, y, z) - отменяет действие предыдущей функции на данных координатах, возвращая стандартную модель любого блока.</i></span>
</p><p><u style="text-underline:black">Важно отметить:</u> <i>&#160;</i>
</p>
<ol><li>Все установленные на координатах модели очищаются при выходе из мира. </li>
<li>Наличие блока никак не связано с тем, что на данных координатах установлена модель, это значит, что если сломать блок, подверженный маппингу, у которого была изменена модель и поставить на его место другой блок, тоже подверженный маппингу, то модель сохранится. Потому важно следить, на какой именно блок вызывается mapAtCoords и обязательно вызывать unmapAtCoords при уничтожении блока. </li></ol>
</div></div>
</div>
@@ Строка 1: / Строка 1: @@
-<div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output">
-<div class="mw-parser-output"><div class="mw-parser-output">
 <div class="mw-parser-output">
 <div class="mw-parser-output">
-= Введение в рендер блоков =
+= <span style="font-size:18.0pt"><span style="line-height:107%">Введение в рендер блоков</span></span> =
-Кроме формы из одного параллелепипеда, которой обладает большинство блоков, Inner Core позволяет задать им почти любой внешний вид.&nbsp;&nbsp;
+Кроме формы из одного параллелепипеда, которой обладает большинство блоков, Inner Core позволяет задать им почти любой внешний вид. &nbsp;
-</div>
 == Формат описания текстуры и ее наложение на блок ==
@@ Строка 15: / Строка 12: @@
 Текстура целого блока может быть описана либо двумя параметрами - именем и индексом текстуры, в таком случае весь блок будет иметь одну и ту же текстуру, либо массивом текстур, формат которого приведен ниже.
+&nbsp;
 <syntaxhighlight lang="Javascript">[
      ["название1", индекс1], // bottom
@@ Строка 21: / Строка 20: @@
      ["название4", индекс4], // front
      ["название5", индекс5], // left
-     ["название6", индекс6]  // right
+     ["название6", индекс6]  // right
 ]</syntaxhighlight>
-Каждый из элементов массива отвечает за одну текстуру, если элементов меньше 6, то текстуры недостающих сторон скопируют последний элемент массива.</div> </div> </div> </div>
+&nbsp;
+Каждый из элементов массива отвечает за одну текстуру, если элементов меньше 6, то текстуры недостающих сторон скопируют последний элемент массива.
 == Статичная модель блока ==
@@ Строка 32: / Строка 35: @@
 Пустая статичная модель создается с помощью конструктора ''new BlockRenderer.Model()'' и обладает следующими методами:
-<span style="line-height:108%">model.addBox(x1, y1, z1, x2, y2, z2, id, data) - добавляет бокс с текстурой блока с данными id, data</span>
+<span style="line-height:108%">''model.addBox(x1, y1, z1, x2, y2, z2, id, data) - добавляет бокс с текстурой блока с данными id, data''</span>
-<span style="line-height:108%">model.addBox(x1, y1, z1, x2, y2, z2, "name", index) - добавляет бокс с текстурой с именем name и индексом index на всех сторонах</span>
+<span style="line-height:108%">''model.addBox(x1, y1, z1, x2, y2, z2, "name", index) - добавляет бокс с текстурой с именем name и индексом index на всех сторонах''</span>
-<span style="line-height:108%">model.addBox(x1, y1, z1, x2, y2, z2, [… texture set ...]) - добавляет бокс с заданным массивом текстур (формат см. выше)</span>
+<span style="line-height:108%">''model.addBox(x1, y1, z1, x2, y2, z2, [… texture set ...]) - добавляет бокс с заданным массивом текстур (формат см. выше)''</span>
-<span style="line-height:108%">model.addMesh(mesh) - добавляет в модель объект RenderMesh - произвольную полигональную 3D модель, о которых будет рассказано позднее</span>
+<span style="line-height:108%">''model.addMesh(mesh) - добавляет в модель объект RenderMesh - произвольную полигональную 3D модель, о которых будет рассказано позднее''</span>
 Существуют так же другие конструкторы, упрощающие быстрое создание простых моделей:
-<span style="line-height:108%">new BlockRenderer.Model(mesh) - создает модель, которая содержит в себе данный объект RenderMesh</span>
+<span style="line-height:108%">''new BlockRenderer.Model(mesh) - создает модель, которая содержит в себе данный объект RenderMesh''</span>
-<span style="line-height:108%">new BlockRenderer.Model(x1, y1, z1, x2, y2, z2, [… texture set ...]) - создает модель, которая является одним боксом с данным массивом текстур</span>
+<span style="line-height:108%">''new BlockRenderer.Model(x1, y1, z1, x2, y2, z2, [… texture set ...]) - создает модель, которая является одним боксом с данным массивом текстур''</span>
-<span style="line-height:108%">new BlockRenderer.Model([… texture set ...]) - создает модель, которая является полным блоком с данным массивом текстур</span>
+<span style="line-height:108%">''new BlockRenderer.Model([… texture set ...]) - создает модель, которая является полным блоком с данным массивом текстур''</span>
-<span style="line-height:108%">new BlockRenderer.Model(x1, y1, z1, x2, y2, z2, "name", index) - создает модель, которая является одним боксом с данной текстурой на всех сторонах</span>
+<span style="line-height:108%">''new BlockRenderer.Model(x1, y1, z1, x2, y2, z2, "name", index) - создает модель, которая является одним боксом с данной текстурой на всех сторонах''</span>
-<span style="line-height:108%">new BlockRenderer.Model("name", index) - создает модель, которая является полным блоком с данной текстурой на всех сторонах</span>
+<span style="line-height:108%">''new BlockRenderer.Model("name", index) - создает модель, которая является полным блоком с данной текстурой на всех сторонах''</span>
-<span style="line-height:108%">new BlockRenderer.Model(x1, y1, z1, x2, y2, z2, id, data) - создает модель, которая является одним боксом, копирующим текстуру из блока с данными id, data</span>
+<span style="line-height:108%">''new BlockRenderer.Model(x1, y1, z1, x2, y2, z2, id, data) - создает модель, которая является одним боксом, копирующим текстуру из блока с данными id, data''</span>
-<span style="line-height:108%">new BlockRenderer.Model(id, data) -&nbsp; создает модель, которая является полным блоком, копирующим текстуру из блока с данными id, data</span>
+<span style="line-height:108%">''new BlockRenderer.Model(id, data) -&nbsp; создает модель, которая является полным блоком, копирующим текстуру из блока с данными id, data''</span>
 == Основы ICRender ==
@@ Строка 60: / Строка 63: @@
 ICRender является системой, позволяющей заранее задать блоку внешний вид в зависимости от внешних условий. Основным объектом для рендера блоков является модель ICRender, которая является набором статических моделей и условий, при которых они будут отрисовываться.
-Для создания модели ICRender используется конструктор ''new ICRender.Model(), ''для добавления статичной модели в модель ICRender используется метод ''addEntry(model)'':
+Для создания модели ICRender используется конструктор ''new ICRender.Model(), ''для добавления статичной модели в модель ICRender используется метод ''addEntry(model)'': ''var staticModel = new BlockRenderer.Model(); // модификация модели staticModel var icRenderModel = new ICRender.Model(); icRenderModel.addEntry(staticModel);&nbsp;''
-<syntaxhighlight lang="Javascript">var staticModel = new BlockRenderer.Model(); // модификация модели staticModel
-var icRenderModel = new ICRender.Model();
-icRenderModel.addEntry(staticModel); </syntaxhighlight>
 Чтобы установить блоку модель ICRender используется метод
 <p style="margin-top:0cm; margin-right:3.2pt; margin-bottom:7.85pt; margin-left:0cm; text-align:justify"><span style="text-justify:inter-ideograph"><span style="line-height:108%">''BlockRenderer.setStaticICRender(id, data, model) - ''где id и data - целевой блок (если надо установить для любого значения data, вместо него нужно передать -1), а model - модель ICRender.</span></span></p>
 Пример:
-<syntaxhighlight lang="Javascript">BlockRenderer.setStaticICRender(BlockID.testRenderBlock, -1, icRenderModel); // после этого требуемый блок будет иметь созданную ранее модель</syntaxhighlight>
-<div class="mw-parser-output"><div class="mw-parser-output">
+<span style="line-height:108%">''BlockRenderer.setStaticICRender(BlockID.testRenderBlock, -1, icRenderModel); // после этого требуемый блок будет иметь созданную ранее модель''</span>
-<div class="mw-parser-output">
 == Маппинг рендера'' ==
@@ Строка 79: / Строка 79: @@
 Без дополнительных действий такой вызов ничем не будет отличаться по действию от вызова ''BlockRenderer.setStaticICRender. ''Для маппинга используются следующие методы:
-<span style="line-height:108%">BlockRenderer.mapAtCoords(x, y, z, model) - устанавливает данную модель ICRender на данные координаты, любой блок, для которого включен маппинг и который стоит на этих координатах, будет иметь эту модель.</span>
+<span style="line-height:108%">''BlockRenderer.mapAtCoords(x, y, z, model) - устанавливает данную модель ICRender на данные координаты, любой блок, для которого включен маппинг и который стоит на этих координатах, будет иметь эту модель.''</span>
-<span style="line-height:108%">BlockRenderer.unmapAtCoords(x, y, z) - отменяет действие предыдущей функции на данных координатах, возвращая стандартную модель любого блока.</span>
+<span style="line-height:108%">''BlockRender.unmapAtCoords(x, y, z) - отменяет действие предыдущей функции на данных координатах, возвращая стандартную модель любого блока.''</span>
 <u style="text-underline:black">Важно отметить:</u> ''&nbsp;''