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

<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"><h1> <span style="font-size:18.0pt"><span style="line-height:107%">Введение в рендер блоков</span></span> </h1>
<p>Кроме формы из одного параллелепипеда, которой обладает большинство блоков, Inner Core позволяет задать им почти любой внешний вид. &#160;
</p>
<div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output">
<h2> Формат описания текстуры и ее наложение на блок </h2>
<p>Хоть наложение текстур и было описано ранее, оно имеет непосредственное отношение к дальнейшему описанию.
</p><p>Ссылка на каждую отдельную текстуру блока состоит из двух элементов - ее названия и индекса, напомню, что название и индекс задаются для файла текстуры в ресурсах в формате "имя_индекс.png", где имя - произвольная строка, а индекс - неотрицательное целое число.
</p><p>Текстура целого блока может быть описана либо двумя параметрами - именем и индексом текстуры, в таком случае весь блок будет иметь одну и ту же текстуру, либо массивом текстур, формат которого приведен ниже.
<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>
Каждый из элементов массива отвечает за одну текстуру, если элементов меньше 6, то текстуры недостающих сторон скопируют последний элемент массива.</div> </div> </div> </div> 
<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%">model.addBox(x1, y1, z1, x2, y2, z2, id, data) - добавляет бокс с текстурой блока с данными id, data</span>
</p><p><span style="line-height:108%">model.addBox(x1, y1, z1, x2, y2, z2, "name", index) - добавляет бокс с текстурой с именем name и индексом index на всех сторонах</span>
</p><p><span style="line-height:108%">model.addBox(x1, y1, z1, x2, y2, z2, [… texture set ...]) - добавляет бокс с заданным массивом текстур (формат см. выше)</span>
</p><p><span style="line-height:108%">model.addMesh(mesh) - добавляет в модель объект RenderMesh - произвольную полигональную 3D модель, о которых будет рассказано позднее</span>
</p><p>Существуют так же другие конструкторы, упрощающие быстрое создание простых моделей:
</p><p><span style="line-height:108%">new BlockRenderer.Model(mesh) - создает модель, которая содержит в себе данный объект RenderMesh</span>
</p><p><span style="line-height:108%">new BlockRenderer.Model(x1, y1, z1, x2, y2, z2, [… texture set ...]) - создает модель, которая является одним боксом с данным массивом текстур</span>
</p><p><span style="line-height:108%">new BlockRenderer.Model([… texture set ...]) - создает модель, которая является полным блоком с данным массивом текстур</span>
</p><p><span style="line-height:108%">new BlockRenderer.Model(x1, y1, z1, x2, y2, z2, "name", index) - создает модель, которая является одним боксом с данной текстурой на всех сторонах</span>
</p><p><span style="line-height:108%">new BlockRenderer.Model("name", index) - создает модель, которая является полным блоком с данной текстурой на всех сторонах</span>
</p><p><span style="line-height:108%">new BlockRenderer.Model(x1, y1, z1, x2, y2, z2, id, data) - создает модель, которая является одним боксом, копирующим текстуру из блока с данными id, data</span>
</p><p><span style="line-height:108%">new BlockRenderer.Model(id, data) -&#160; создает модель, которая является полным блоком, копирующим текстуру из блока с данными id, data</span>
</p>
<h2> Основы ICRender </h2>
<p>ICRender является системой, позволяющей заранее задать блоку внешний вид в зависимости от внешних условий. Основным объектом для рендера блоков является модель ICRender, которая является набором статических моделей и условий, при которых они будут отрисовываться.
</p><p>Для создания модели ICRender используется конструктор <i>new ICRender.Model(), </i>для добавления статичной модели в модель ICRender используется метод <i>addEntry(model)</i>:
<pre class="fck_mw_syntaxhighlight"><syntaxhighlight lang="Javascript">var staticModel = new BlockRenderer.Model(); // модификация модели staticModel 
var icRenderModel = new ICRender.Model(); 
icRenderModel.addEntry(staticModel); </syntaxhighlight></pre>
</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>Пример:
<pre class="fck_mw_syntaxhighlight"><syntaxhighlight lang="Javascript">BlockRenderer.setStaticICRender(BlockID.testRenderBlock, -1, icRenderModel); // после этого требуемый блок будет иметь созданную ранее модель</syntaxhighlight></pre>
</p>
<div class="mw-parser-output"><div class="mw-parser-output">
<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%">BlockRenderer.mapAtCoords(x, y, z, model) - устанавливает данную модель ICRender на данные координаты, любой блок, для которого включен маппинг и который стоит на этих координатах, будет иметь эту модель.</span>
</p><p><span style="line-height:108%">BlockRender.unmapAtCoords(x, y, z) - отменяет действие предыдущей функции на данных координатах, возвращая стандартную модель любого блока.</span>
</p><p><u style="text-underline:black">Важно отметить:</u> <i>&#160;</i>
</p>
<ol><li>Все установленные на координатах модели очищаются при выходе из мира. </li>
<li>Наличие блока никак не связано с тем, что на данных координатах установлена модель, это значит, что если сломать блок, подверженный маппингу, у которого была изменена модель и поставить на его место другой блок, тоже подверженный маппингу, то модель сохранится. Потому важно следить, на какой именно блок вызывается mapAtCoords и обязательно вызывать unmapAtCoords при уничтожении блока. </li></ol>
</div> </div> </div> </div> </div> </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"><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> =
-<div class="mw-parser-output">
-<div class="mw-parser-output">
-= Введение в рендер блоков =
-Кроме формы из одного параллелепипеда, которой обладает большинство блоков, Inner Core позволяет задать им почти любой внешний вид.&nbsp;&nbsp;
-</div>
+Кроме формы из одного параллелепипеда, которой обладает большинство блоков, Inner Core позволяет задать им почти любой внешний вид. &nbsp;
+<div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output">
 == Формат описания текстуры и ее наложение на блок ==
@@ Строка 70: / Строка 66: @@
 <syntaxhighlight lang="Javascript">BlockRenderer.setStaticICRender(BlockID.testRenderBlock, -1, icRenderModel); // после этого требуемый блок будет иметь созданную ранее модель</syntaxhighlight>
 <div class="mw-parser-output"><div class="mw-parser-output">
-<div class="mw-parser-output">
 == Маппинг рендера'' ==
@@ Строка 81: / Строка 76: @@
 <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;''
@@ Строка 87: / Строка 82: @@
 #Все установленные на координатах модели очищаются при выходе из мира.
 #Наличие блока никак не связано с тем, что на данных координатах установлена модель, это значит, что если сломать блок, подверженный маппингу, у которого была изменена модель и поставить на его место другой блок, тоже подверженный маппингу, то модель сохранится. Потому важно следить, на какой именно блок вызывается mapAtCoords и обязательно вызывать unmapAtCoords при уничтожении блока.
-</div>
+</div> </div> </div> </div> </div> </div> </div>