Редактирование:Класс RenderMesh

<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%">Работа с RenderMesh</span></span> </h1>
<p><span style="font-size:12.0pt"><span style="line-height:107%">Класс RenderMesh позволяет создавать, загружать и использовать в любом типе рендера произвольные трехмерные модели, созданные из полигонов.</span></span>
</p><p><span style="font-size:12.0pt"><span style="line-height:107%"><img src="/images/5/5d/%D0%9A%D0%BE%D1%80%D0%BE%D0%B2%D0%B0.jpg" _fck_mw_filename="Корова.jpg" _fck_mw_upright="1" alt="Корова.jpg" title="Корова.jpg" style="vertical-align:middle;" /></span></span>
</p>
<h2> Принцип </h2>
<p><span style="font-size:12.0pt"><span style="line-height:107%">3D модель представлена как набор вершин, цветов, текстурных координат и полигонов, последние объединяют первые 3 в треугольники (каждая вершина треугольника является ссылкой на вершину, цвет и текстурные координаты). Из треугольников и создается модель.</span></span>
</p>
<h2> Формат OBJ </h2>
<p><span style="font-size:12.0pt"><span style="line-height:107%">Формат файлов .obj является достаточно распространенным не бинарным форматом 3D моделей, который поддерживают многие редакторы. RenderMesh позволяет одной функцией загружать модели из файлов с таким форматом. Загружаются данные о вершинах, текстурных координатах и полигонах, остальные данные избыточны и игнорируются.</span></span>
</p>
<div class="mw-parser-output">
<div class="mw-parser-output">
<h2> API моделей </h2>
<p><span style="line-height:162%"><span style="font-size:12.0pt"><span style="line-height:162%">Создание:</span></span> <i><span style="font-size:12.0pt"><span style="line-height:162%">var mesh = new RenderMesh() - создает пустую модель</span></span></i></span>
</p><p><span style="font-size:12.0pt"><span style="line-height:107%">Основные методы для модификации:</span></span>
</p><p><span style="line-height:108%"><i><span style="font-size:12.0pt"><span style="line-height:108%">mesh.addVertex(x, y, z, u, v) - добавляет вершину в модель, x, y, z - координаты в пространстве, u, v - координаты текстуры (от 0 до 1). Каждые 3 последовательно идущие вершины объединяются в треугольник, кол-во вершин обязательно должно быть кратно 3.&#160;</span></span></i></span>
</p><p><span style="line-height:135%"><i><span style="font-size:12.0pt"><span style="line-height:135%">mesh.setColor(r, g, b) - устанавливает цвет, который будет использован для всех добавленных далее вершин, пока цвет не изменится (по умолчанию белый)</span></span></i></span>
</p><p><span style="line-height:135%"><i><span style="font-size:12.0pt"><span style="line-height:135%">mesh.resetColor() - сбрасывает цвет обратно до белого</span></span></i></span>
</p><p><span style="line-height:108%"><i><span style="font-size:12.0pt"><span style="line-height:108%">mesh.setBlockTexture("name", index) - данный метод нужен в случае, когда модель используется для блока. После вызова этого метода все текстурные координаты будут заданы для конкретной текстуры блока.</span></span></i></span>
</p><p><span style="line-height:108%"><i><span style="font-size:12.0pt"><span style="line-height:108%">mesh.resetTexture() - сбрасывает состояние, полученное вызовом метода setBlockTexture.</span></span></i></span>
</p><p><span style="line-height:162%"><i><span style="font-size:12.0pt"><span style="line-height:162%">mesh.clear() - очищает модель</span></span></i></span>
</p><p><span style="line-height:162%"><i><span style="font-size:12.0pt"><span style="line-height:162%">mesh.translate(x, y, z) - смещает всю модель на вектор x, y, z</span></span></i></span>
</p><p><span style="line-height:108%"><i><span style="font-size:12.0pt"><span style="line-height:108%">mesh.scale(x, y, z) - изменяет размер модели по каждой координате соответственно в x, y, z раз</span></span></i></span>
</p>
<span style="line-height:108%"><i><span style="font-size:12.0pt"><span style="line-height:108%">mesh.rebuild() - пересчитывает нормали всех треугольников, нужные для корректного освещения, нужно вызвать это после завершения модификации модели.</span></span></i></span> </div>
</div>
<h2> Импорт из файла </h2>
<p><span style="font-size:12.0pt"><span style="line-height:107%">Для импорта модели из файла используется метод mesh.importFromFile(path, type, params) или конструктор с такими же аргументами. Импорт автоматически вызовет метод rebuild() после завершения.</span></span>
</p><p><span style="font-size:12.0pt"><span style="line-height:107%">Аргументы:</span></span>
</p>
<ul><li><span style="font-size:12.0pt"><span style="line-height:107%">path - абсолютный путь к файлу</span></span> </li>
<li><span style="font-size:12.0pt"><span style="line-height:107%">type - тип файла (на данный момент доступен только "obj")</span></span> </li>
<li><span style="font-size:12.0pt"><span style="line-height:107%">params - объект настроек импорта или null, если настройки должны быть по умолчанию.</span></span> </li></ul>
<p><span style="font-size:12.0pt"><span style="line-height:107%">Формат объекта настроек и их значения по умолчанию:</span></span>
<pre class="fck_mw_syntaxhighlight"><syntaxhighlight lang="Javascript">{
    clear: false, // очищать ли модель перед импортом
    invertV: false, // в некоторых моделях вторая текстурная координатаинвертирована, это инвертирует ее обратно. 
    translate: [0, 0, 0], // аналогичен по действию метода translate, но происходит прямо во время импорта, что ускоряет процесс
    scale: [1, 1, 1] // аналогичен методу scale, вызывается после примененияпараметра translate 
}
</syntaxhighlight></pre>
</p><p><span style="font-size:12.0pt"><span style="line-height:107%">Пример:</span></span>
<pre class="fck_mw_syntaxhighlight"><syntaxhighlight lang="Javascript">var mesh = new RenderMesh(__dir__ + &quot;models/barrel.obj&quot;, &quot;obj&quot;, null); // импортирует модель из &quot;директория мода/models/barrel.obj&quot; </syntaxhighlight></pre>
</p>
<h2> <span style="font-size:12.0pt"><span style="line-height:107%">Использование для рендера мобов:</span></span><i> </h2></i>
<p><span style="font-size:12.0pt"><span style="line-height:107%">Модель RenderMesh может быть установлена для конкретной части рендера моба и тогда она будет отрисовываться в ее системе координат. Модель заменит остальные элементы этой части рендера, и они не будут отрисовываться.</span></span>
</p><p><span style="font-size:12.0pt"><span style="line-height:107%">Для того, чтобы установить модель в объекте ModelPart есть метод setMesh(mesh), который может принимать объект модели или null.</span></span>
</p><p><span style="font-size:12.0pt"><span style="line-height:107%">Пример:</span></span>
<pre class="fck_mw_syntaxhighlight"><syntaxhighlight lang="Javascript">var mesh = new RenderMesh(__dir__ + &quot;models/barrel.obj&quot;, &quot;obj&quot;, null); // создать модель из файла (см. прошлый пример)  
var render = new Render(); // создать пустой рендер 
var bodyPart = render.getPart(&quot;body&quot;); // получить часть (ModelPart) с именем &quot;body&quot; 
bodyPart.setMesh(mesh); // установить модель для полученной части рендера моба
</syntaxhighlight></pre>
</p><p><span style="font-size:12.0pt"><span style="line-height:107%">После установки мобу текстуры для этой модели и созданного в примере рендера был получен следующий результат:</span></span>
</p><p><img src="/images/5/57/%D0%9D%D0%B5%D1%87%D1%82%D0%BE.jpg" _fck_mw_filename="Нечто.jpg" _fck_mw_upright="1" alt="Нечто.jpg" title="Нечто.jpg" style="vertical-align:middle;" />&#160;
</p><p><b><span style="font-size:12.0pt"><span style="line-height:107%">Использование для модели блока:</span></span></b>
</p><p><span style="font-size:12.0pt"><span style="line-height:107%">Модель RenderMesh может быть добавлена в модель объекта блока (BlockModel), при этом ее текстурой будет текстура всех блоков (см метод setBlockTexture). В одну модель блока может быть добавлено несколько моделей RenderMesh и они не будут заменять друг друга и другие части модели блока.</span></span>
</p><p><span style="font-size:12.0pt"><span style="line-height:107%">Для добавления RenderMesh в BlockModel используется метод последнего addMesh(mesh), который добавляет RenderMesh в модель блока, или конструктор new BlockModel(mesh), который создает модель блока из переданного RenderMesh.</span></span>
</p><p><span style="font-size:12.0pt"><span style="line-height:107%">В отличии от рендера мобов, рендер блоков имеет такую механику как culling (треугольники будут видны только с той стороны, с которой их вершины идут по часовой стрелке), это сделано в самом MCPE для оптимизации и при создании моделей для блоков это стоит учитывать.</span></span>
</p><p><span style="line-height:162%"><span style="font-size:12.0pt"><span style="line-height:162%">Пример:</span></span></span>
<pre class="fck_mw_syntaxhighlight"><syntaxhighlight lang="Javascript">var mesh = new RenderMesh(); // создать пустую модель
mesh.setBlockTexture(&quot;quartz_block_side&quot;, 0); // установить текстуру кварца (можно добавить произвольную текстуру, как текстуру блока и использовать ее)
mesh.importFromFile(__dir__ + &quot;models/barrel.obj&quot;, &quot;obj&quot;, null); // загрузить из файла с использованием текстуры кварца 
var blockModel = new BlockRenderer.Model(mesh); // создать модель для рендера 
</syntaxhighlight></pre>
</p><p><span style="line-height:135%"><span style="font-size:12.0pt"><span style="line-height:135%">После установки нашей модели блоку (к примеру с помощью ICRender), получаем результат:</span></span></span>
</p><p><img src="/images/c/cf/%D0%9D%D0%B5%D1%87%D1%82%D0%BE_%D0%B1%D0%BB%D0%BE%D0%BA%D0%BE%D0%BC_%D0%B1%D0%B5%D0%B7_%D1%82%D0%B5%D0%BA%D1%81%D1%82%D1%83%D1%80%D1%8B.jpg" _fck_mw_filename="Нечто блоком без текстуры.jpg" _fck_mw_upright="1" alt="Нечто блоком без текстуры.jpg" title="Нечто блоком без текстуры.jpg" style="vertical-align:middle;" />
</p><p><span style="font-size:12.0pt"><span style="line-height:107%">Заменяя текстуру кварца на развертку бочки, которая была использована до этого и добавляя ее в текстуры блоков получаем ту же самую модель, но для блока (подобные текстуры стоит изменять до квадрата размера степени 2, это оптимальнее и развертка при этом сохраняется):</span></span>
</p><p><img src="/images/0/00/%D0%9D%D0%B5%D1%87%D1%82%D0%BE_%D0%B1%D0%BB%D0%BE%D0%BA%D0%BE%D0%BC.jpg" _fck_mw_filename="Нечто блоком.jpg" _fck_mw_upright="1" alt="Нечто блоком.jpg" title="Нечто блоком.jpg" style="vertical-align:middle;" />&#160;
</p>
<h1> Освещение </h1>
<p><span style="line-height:108%"><span style="font-size:12.0pt"><span style="line-height:108%">Для моделей блоков актуальны настройки освещения моделей (для мобов оно рассчитывается самим MCPE). Они задаются следующими методами:<i><b>setLightParams(min, max, smooth) - задает значения освещения, рассчитанного по нормалям, min, max - минимальное и максимальное (от 0 до 1), smooth - значение сглаживания (больше 0, 1 является нейтральным элементом, по умолчанию 1.9)</b></i></span></span></span>
</p><p><span style="line-height:108%"><i><span style="font-size:12.0pt"><span style="line-height:108%">setLightDir(x, y, z) - устанавливает направление света, нужное для рассчета освещения по нормалям.</span></span></i></span>
</p><p><span style="line-height:108%"><i><span style="font-size:12.0pt"><span style="line-height:108%">setLightIgnore(ignoreBlockLight, ignoreSkyLight) - задает игнорирование разных типов освещения мира (если тип игнорируется, то освещение всегда максимальное)</span></span></i></span>
</p><p><span style="font-size:12.0pt"><span style="line-height:107%">Одна и та же модель при значениях по умолчанию и после вызова setLightParams(0, 1,</span></span><span style="font-size:12.0pt"><span style="line-height:107%">1):</span></span>
</p><p><span style="font-size:12.0pt"><span style="line-height:107%"><img src="/images/c/cf/%D0%9D%D0%B5%D1%87%D1%82%D0%BE_%D0%B1%D0%BB%D0%BE%D0%BA%D0%BE%D0%BC_%D0%B1%D0%B5%D0%B7_%D1%82%D0%B5%D0%BA%D1%81%D1%82%D1%83%D1%80%D1%8B.jpg" _fck_mw_filename="Нечто блоком без текстуры.jpg" _fck_mw_upright="1" alt="Нечто блоком без текстуры.jpg" title="Нечто блоком без текстуры.jpg" style="vertical-align:middle;" /><img src="/images/b/b8/%D0%9D%D0%B5%D1%87%D1%82%D0%BE_%D1%81%D0%BE_%D1%81%D0%B2%D0%B5%D1%82%D0%BE%D0%BC.jpg" _fck_mw_filename="Нечто со светом.jpg" _fck_mw_upright="1" alt="Нечто со светом.jpg" title="Нечто со светом.jpg" style="vertical-align:middle;" /></span></span>
</p>
</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">
 = <span style="font-size:18.0pt"><span style="line-height:107%">Работа с RenderMesh</span></span> =
@@ Строка 114: / Строка 114: @@
 <span style="font-size:12.0pt"><span style="line-height:107%">[[File:Нечто блоком без текстуры.jpg|upright|Нечто блоком без текстуры.jpg]][[File:Нечто со светом.jpg|upright|Нечто со светом.jpg]]</span></span>
-</div> </div> </div>
+</div> </div>