Package net.fabricmc.fabric.api.renderer.v1.mesh

Interface QuadEmitter

All Superinterfaces:
MutableQuadView, QuadView
public interface QuadEmitter extends MutableQuadView
Specialized MutableQuadView obtained via MeshBuilder.getEmitter() to append quads during mesh building.

Also obtained from RenderContext.getEmitter() to submit dynamic quads one-by-one at render time.

Instances of QuadEmitter will practically always be threadlocal and/or reused - do not retain references.

Only the renderer should implement or extend this interface.

  • Field Details

  • Method Details

    • material

      QuadEmitter material(RenderMaterial material)
      Description copied from interface: MutableQuadView
      Assigns a different material to this quad. Useful for transformation of existing meshes because lighting and texture blending are controlled by material.
      Specified by:
      material in interface MutableQuadView

    • cullFace

      QuadEmitter cullFace(Direction face)
      Description copied from interface: MutableQuadView
      If non-null, quad is coplanar with a block face which, if known, simplifies or shortcuts geometric analysis that might otherwise be needed. Set to null if quad is not coplanar or if this is not known. Also controls face culling during block rendering.

      Null by default.

      When called with a non-null value, also sets MutableQuadView.nominalFace(Direction) to the same value.

      This is different from the value reported by BakedQuad.getFace(). That value is computed based on face geometry and must be non-null in vanilla quads. That computed value is returned by QuadView.lightFace().

      Specified by:
      cullFace in interface MutableQuadView

    • nominalFace

      QuadEmitter nominalFace(Direction face)
      Description copied from interface: MutableQuadView
      Provides a hint to renderer about the facing of this quad. Not required, but if provided can shortcut some geometric analysis if the quad is parallel to a block face. Should be the expected value of QuadView.lightFace(). Value will be confirmed and if invalid the correct light face will be calculated.

      Null by default, and set automatically by QuadView.cullFace().

      Models may also find this useful as the face for texture UV locking and rotation semantics.

      Note: This value is not persisted independently when the quad is encoded. When reading encoded quads, this value will always be the same as QuadView.lightFace().

      Specified by:
      nominalFace in interface MutableQuadView

    • colorIndex

      QuadEmitter colorIndex(int colorIndex)
      Description copied from interface: MutableQuadView
      Value functions identically to BakedQuad.getColorIndex() and is used by renderer / model builder in same way. Default value is -1.
      Specified by:
      colorIndex in interface MutableQuadView

    • fromVanilla

      QuadEmitter fromVanilla(int[] quadData, int startIndex, boolean isItem)
      Description copied from interface: MutableQuadView
      Enables bulk vertex data transfer using the standard Minecraft vertex formats. This method should be performant whenever caller's vertex representation makes it feasible.

      Calling this method does not emit the quad.

      Specified by:
      fromVanilla in interface MutableQuadView

    • tag

      QuadEmitter tag(int tag)
      Description copied from interface: MutableQuadView
      Encodes an integer tag with this quad that can later be retrieved via QuadView.tag(). Useful for models that want to perform conditional transformation or filtering on static meshes.
      Specified by:
      tag in interface MutableQuadView

    • pos

      QuadEmitter pos(int vertexIndex, float x, float y, float z)
      Description copied from interface: MutableQuadView
      Sets the geometric vertex position for the given vertex, relative to block origin. (0,0,0). Minecraft rendering is designed for models that fit within a single block space and is recommended that coordinates remain in the 0-1 range, with multi-block meshes split into multiple per-block models.
      Specified by:
      pos in interface MutableQuadView

    • pos

      default QuadEmitter pos(int vertexIndex, Vector3f vec)
      Description copied from interface: MutableQuadView
      Same as MutableQuadView.pos(int, float, float, float) but accepts vector type.
      Specified by:
      pos in interface MutableQuadView

    • normal

      default QuadEmitter normal(int vertexIndex, Vector3f vec)
      Description copied from interface: MutableQuadView
      Same as MutableQuadView.normal(int, float, float, float) but accepts vector type.
      Specified by:
      normal in interface MutableQuadView

    • lightmap

      QuadEmitter lightmap(int vertexIndex, int lightmap)
      Description copied from interface: MutableQuadView
      Accept vanilla lightmap values. Input values will override lightmap values computed from world state if input values are higher. Exposed for completeness but some rendering implementations with non-standard lighting model may not honor it.

      For emissive rendering, it is better to use MaterialFinder.emissive(int, boolean).

      Specified by:
      lightmap in interface MutableQuadView

    • lightmap

      default QuadEmitter lightmap(int b0, int b1, int b2, int b3)
      Description copied from interface: MutableQuadView
      Convenience: set lightmap for all vertices at once.

      For emissive rendering, it is better to use MaterialFinder.emissive(int, boolean). See MutableQuadView.lightmap(int, int).

      Specified by:
      lightmap in interface MutableQuadView

    • spriteColor

      QuadEmitter spriteColor(int vertexIndex, int spriteIndex, int color)
      Description copied from interface: MutableQuadView
      Set sprite color. Behavior for spriteIndex > 0 is currently undefined.
      Specified by:
      spriteColor in interface MutableQuadView

    • spriteColor

      default QuadEmitter spriteColor(int spriteIndex, int c0, int c1, int c2, int c3)
      Description copied from interface: MutableQuadView
      Convenience: set sprite color for all vertices at once. Behavior for spriteIndex > 0 is currently undefined.
      Specified by:
      spriteColor in interface MutableQuadView

    • sprite

      QuadEmitter sprite(int vertexIndex, int spriteIndex, float u, float v)
      Description copied from interface: MutableQuadView
      Set sprite atlas coordinates. Behavior for spriteIndex > 0 is currently undefined.
      Specified by:
      sprite in interface MutableQuadView

    • sprite

      default QuadEmitter sprite(int vertexIndex, int spriteIndex, Vec2f uv)
      Set sprite atlas coordinates. Behavior for spriteIndex > 0 is currently undefined.

      Only use this function if you already have a Vec2f. Otherwise, see sprite(int, int, float, float).

      Specified by:
      sprite in interface MutableQuadView

    • spriteUnitSquare

      default QuadEmitter spriteUnitSquare(int spriteIndex)

    • spriteBake

      QuadEmitter spriteBake(int spriteIndex, Sprite sprite, int bakeFlags)
      Description copied from interface: MutableQuadView
      Assigns sprite atlas u,v coordinates to this quad for the given sprite. Can handle UV locking, rotation, interpolation, etc. Control this behavior by passing additive combinations of the BAKE_ flags defined in this interface. Behavior for spriteIndex > 0 is currently undefined.
      Specified by:
      spriteBake in interface MutableQuadView

    • square

      default QuadEmitter square(Direction nominalFace, float left, float bottom, float right, float top, float depth)
      Helper method to assign vertex coordinates for a square aligned with the given face. Ensures that vertex order is consistent with vanilla convention. (Incorrect order can lead to bad AO lighting unless enhanced lighting logic is available/enabled.)

      Square will be parallel to the given face and coplanar with the face (and culled if the face is occluded) if the depth parameter is approximately zero. See CULL_FACE_EPSILON.

      All coordinates should be normalized (0-1).

    • emit

      QuadEmitter emit()
      In static mesh building, causes quad to be appended to the mesh being built. In a dynamic render context, create a new quad to be output to rendering. In both cases, current instance is reset to default values.