Основні концепції промальовування
Прочитайте про основні концепції промальовування, що використовує механізм промальовування гри.
WARNING
Ця сторінка написана для версії 1.21.10. Документація для старіших версій може бути неповною.
WARNING
Although Minecraft is built using OpenGL, as of version 1.17+ you cannot use legacy OpenGL methods to render your own things. Instead, you must use the new BufferBuilder system, which formats rendering data and uploads it to OpenGL to draw.
Загалом, ви можете використовувати систему промальовування Minecraft або створити власну, яка використовує GL.glDrawElements().
На цій сторінці описано основи промальовування за допомогою нової системи, а також ключову термінологію та поняття.
Хоча більша частина промальовування в Minecraft абстрагується за допомогою різних методів GuiGraphics, і вам, ймовірно, не потрібно чіпати нічого, згаданого тут, все одно важливо розуміти основи того, як працює промальовування.
Tesselator
Tesselator - це основний клас, який використовується для відтворення речей у Minecraft. В грі є лише один такий. Ви можете отримати екземпляр за допомогою Tesselator.getInstance().
BufferBuilder
BufferBuilder — це клас, який використовується для форматування та завантаження даних візуалізації в OpenGL. Він використовується для створення буфера, який потім завантажується в OpenGL для малювання.
Tesselator використовується для створення BufferBuilder, який використовується для форматування та завантаження даних візуалізації в OpenGL.
Ініціалізація BufferBuilder
Перш ніж ви зможете записати щось у BufferBuilder, ви повинні ініціалізувати його. Це робиться за допомогою методу Tesselator#begin(...), який використовує VertexFormat і режим малювання та повертає BufferBuilder.
Вершинні формати
VertexFormat визначає елементи, які ми включаємо в наш буфер даних, і описує, як ці елементи мають бути передані в OpenGL.
Доступні такі елементи VertexFormat:
| Елемент | Формат |
|---|---|
BLIT_SCREEN | { position (3 floats: x, y and z), uv (2 floats), color (4 ubytes) } |
POSITION_COLOR_TEXTURE_LIGHT_NORMAL | { position, color, texture uv, texture light (2 shorts), texture normal (3 sbytes) } |
POSITION_COLOR_TEXTURE_OVERLAY_LIGHT_NORMAL | { position, color, texture uv, overlay (2 shorts), texture light, normal (3 sbytes) } |
POSITION_TEXTURE_COLOR_LIGHT | { position, texture uv, color, texture light } |
POSITION | { position } |
POSITION_COLOR | { position, color } |
LINES | { position, color, normal } |
POSITION_COLOR_LIGHT | { position, color, light } |
POSITION_TEXTURE | { position, uv } |
POSITION_COLOR_TEXTURE | { position, color, uv } |
POSITION_TEXTURE_COLOR | { position, uv, color } |
POSITION_COLOR_TEXTURE_LIGHT | { position, color, uv, light } |
POSITION_TEXTURE_LIGHT_COLOR | { position, uv, light, color } |
POSITION_TEXTURE_COLOR_NORMAL | { position, uv, color, normal } |
Режими малювання
Режим малювання визначає спосіб малювання даних. Доступні такі режими малювання:
| Режим малювання | Опис |
|---|---|
Mode.LINES | Кожен елемент складається з 2 вершин і представлений у вигляді однієї лінії. |
Mode.LINE_STRIP | Для першого елемента потрібно 2 вершини. Додаткові елементи малюються лише з 1 новою вершиною, створюючи суцільну лінію. |
Mode.DEBUG_LINES | Подібно до Mode.LINES, але ширина лінії на екрані завжди становить рівно один піксель. |
Mode.DEBUG_LINE_STRIP | Те саме, що Mode.LINE_STRIP, але ширина ліній завжди один піксель. |
Mode.TRIANGLES | Кожен елемент складається з 3 вершин, які утворюють трикутник. |
Mode.TRIANGLE_STRIP | Починається з 3 вершин для першого трикутника. Кожна додаткова вершина утворює новий трикутник із двома останніми вершинами. |
Mode.TRIANGLE_FAN | Починається з 3 вершин для першого трикутника. Кожна додаткова вершина утворює новий трикутник з першою вершиною та останньою вершиною. |
Mode.QUADS | Кожен елемент складається з 4 вершин, що утворюють чотирикутник. |
Запис до BufferBuilder
Після ініціалізації BufferBuilder ви можете записати дані в нього.
BufferBuilder дозволяє нам побудувати наш буфер, вершина за вершиною. Щоб додати вершину, ми використовуємо метод buffer.addVertex(matrix, float, float, float). Параметр matrix — це матриця перетворення, яку ми обговоримо більш детально пізніше. Три параметри float представляють (x, y, z) координати положення вершини.
Цей метод повертає конструктор вершин, за допомогою якого ми можемо вказати додаткову інформацію для вершини. Під час додавання цієї інформації вкрай важливо дотримуватися порядку визначеного нами VertexFormat. Якщо ми цього не зробимо, OpenGL може неправильно інтерпретувати наші дані. Після того, як ми закінчили побудову вершини, просто продовжуйте додавати інші вершини та дані до буфера, доки не закінчите.
Також варто зрозуміти концепцію вибракування. Вибракування— це процес видалення меж тривимірної форми, які не видно з точки зору глядача. Якщо вершини межі вказано в неправильному порядку, межа може не відтворюватися належним чином через вибракування.
Що таке матриця перетворення?
Матриця перетворення — це матриця 4x4, яка використовується для перетворення вектора. У Minecraft матриця трансформації просто перетворює координати, які ми надаємо, у виклик вершини. Перетворення можуть масштабувати нашу модель, переміщувати її та обертати.
Її іноді називають матрицею позиції або матрицею моделі.
Зазвичай його отримують за допомогою класу PoseStack, який можна отримати за допомогою об’єкта GuiGraphics:
drawContext.getMatrices().peek().getPositionMatrix();Промальовування трикутної смуги
Простіше пояснити, як писати в BufferBuilder, використовуючи практичний приклад. Скажімо, ми хочемо промалювати щось за допомогою режиму малювання Mode.TRIANGLE_STRIP і формату вершини POSITION_COLOR.
Ми збираємося намалювати вершини в наступних точках на HUD (по черзі):
(20, 20)
(5, 40)
(35, 40)
(20, 60)Це має дати нам чудовий ромб - оскільки ми використовуємо режим малювання TRIANGLE_STRIP, промальовування виконає наступні кроки:
Оскільки в цьому прикладі ми малюємо HUD, ми використаємо подію HudRenderCallback:
No lines matched.Це призводить до того, що на HUD малюється наступне:
TIP
Спробуйте повозитися з кольорами та розташуванням вершин, щоб побачити, що вийде! Ви також можете спробувати використовувати різні режими малювання та формати вершин.
PoseStack
Навчившись писати в BufferBuilder, ви можете вдаватися в питання, як трансформувати вашу модель - або навіть анімувати її. Тут на допомогу приходить клас PoseStack.
Клас PoseStack має такі методи:
push()- надсилає нову матрицю в стек.pop()– знімає верхню матрицю зі стек.peek()- повертає верхню матрицю в стек.translate(x, y, z)– перекладає верхню матрицю в стек.scale(x, y, z)– масштабує верхню матрицю в стеці.
Ви також можете помножити верхню матрицю в стеці за допомогою кватерніонів, які ми розглянемо в наступному розділі.
Беручи з нашого прикладу вище, ми можемо збільшити та зменшити масштаб ромбу за допомогою PoseStack і tickDelta - це "прогрес" між останнім ігровим тиком і наступним ігровим тиком. Ми роз’яснимо це пізніше на сторінці промальовування в HUD.
WARNING
You must first push the matrix stack and then pop it after you're done with it. If you don't, you'll end up with a broken matrix stack, which will cause rendering issues.
Переконайтеся, що натиснули стек матриць, перш ніж отримати матрицю перетворення!
Matrix3x2fStack matrices = drawContext.pose();
// Store the total tick delta in a field, so we can use it later.
totalTickProgress += tickCounter.getGameTimeDeltaPartialTick(true);
// Push a new matrix onto the stack.
matrices.pushMatrix();
// Scale the matrix by 0.5 to make the triangle smaller and larger over time.
float scaleAmount = Mth.sin(totalTickProgress / 10F) / 2F + 1.5F;
// Apply the scaling amount to the matrix.
// We don't need to scale the Z axis since it's on the HUD and 2D.
matrices.scale(scaleAmount, scaleAmount);
// We do not need to manually write to the buffer. DrawContext methods write to GUI buffer in `GuiRenderer` at the end of preparation.
// Pop our matrix from the stack.
matrices.popMatrix();
Кватерніони (обертові речі)
Кватерніони — це спосіб представлення обертання в тривимірному просторі. Вони використовуються для обертання верхньої матриці в PoseStack за допомогою методу mulPose(Quaternion, x, y, z).
Дуже малоймовірно, що вам коли-небудь знадобиться безпосередньо використовувати клас кватерніонів, оскільки Minecraft надає різні попередньо зібрані екземпляри кватерніонів у своєму службовому класі RotationAxis.
Скажімо, ми хочемо обертати ромб навколо осі z. Ми можемо зробити це за допомогою методу PoseStack і mulPose(Quaternion, x, y, z).
// Lerp between 0 and 360 degrees over time.
float rotationAmount = totalTickProgress / 50F % 360;
matrices.rotate(rotationAmount);
// Shift entire square so that it rotates in its center.
matrices.translate(-20f, -40f);Результатом цього є наступне:
