From 678c9a6e1e7a3a1127c40ae5c3dda7ef4519bfb7 Mon Sep 17 00:00:00 2001
From: Léa Gris <lea.gris@noiraude.net>
Date: Thu, 20 May 2021 22:57:12 +0200
Subject: feat(render): implementation-free api texture factory

Provides an implementation-free API Texture factory an builder.
Deprecates gregtech.api.objects.GT_*Texture.java classes

Once all GregTech add-on will be migrated to the new implemnetation-free API,
changes to the implementation will not affect the add-on.

For now, this API allow rendering of in-world glow textures.
In-inventory/hand rendering of glow texture require implementation changes
that are postponed until no add-on uses the deprecated embedded implementation API.
---
 .../gregtech/api/interfaces/IBlockContainer.java   |  8 +++
 .../java/gregtech/api/interfaces/ITexture.java     |  7 +++
 .../gregtech/api/interfaces/ITextureBuilder.java   | 72 ++++++++++++++++++++++
 3 files changed, 87 insertions(+)
 create mode 100644 src/main/java/gregtech/api/interfaces/IBlockContainer.java
 create mode 100644 src/main/java/gregtech/api/interfaces/ITextureBuilder.java

(limited to 'src/main/java/gregtech/api/interfaces')

diff --git a/src/main/java/gregtech/api/interfaces/IBlockContainer.java b/src/main/java/gregtech/api/interfaces/IBlockContainer.java
new file mode 100644
index 0000000000..7949ae90ce
--- /dev/null
+++ b/src/main/java/gregtech/api/interfaces/IBlockContainer.java
@@ -0,0 +1,8 @@
+package gregtech.api.interfaces;
+
+import net.minecraft.block.Block;
+
+public interface IBlockContainer {
+    Block getBlock();
+    byte getMeta();
+}
diff --git a/src/main/java/gregtech/api/interfaces/ITexture.java b/src/main/java/gregtech/api/interfaces/ITexture.java
index 61244a10ae..4c0b1984ca 100644
--- a/src/main/java/gregtech/api/interfaces/ITexture.java
+++ b/src/main/java/gregtech/api/interfaces/ITexture.java
@@ -19,6 +19,13 @@ public interface ITexture {
 
     boolean isValidTexture();
 
+    /**
+     * @return {@code true} if this texture is from the old package
+     */
+    default boolean isOldTexture() {
+        return getClass().toString().startsWith("gregtech.api.objects");
+    }
+
     /**
      * Will initialize the {@link Tessellator} if rendering off-world (Inventory)
      * @param aRenderer The {@link RenderBlocks} Renderer
diff --git a/src/main/java/gregtech/api/interfaces/ITextureBuilder.java b/src/main/java/gregtech/api/interfaces/ITextureBuilder.java
new file mode 100644
index 0000000000..fde7f2e27b
--- /dev/null
+++ b/src/main/java/gregtech/api/interfaces/ITextureBuilder.java
@@ -0,0 +1,72 @@
+package gregtech.api.interfaces;
+
+import gregtech.api.render.TextureFactory;
+import net.minecraft.block.Block;
+import net.minecraftforge.common.util.ForgeDirection;
+
+/**
+ * <p>This Interface defines operations to configure and build instances of the {@link ITexture} implementations</p>
+ * <p>Use the {@link TextureFactory#builder()} method to get an instance of the {@link ITextureBuilder} implementation.</p>
+ */
+public interface ITextureBuilder {
+    /**
+     * Build the {@link ITexture}
+     *
+     * @return The built {@link ITexture}
+     */
+    ITexture build();
+
+    /**
+     * @param block The {@link Block}
+     * @param meta The meta value for the Block
+     * @return {@link ITextureBuilder} for chaining
+     */
+    ITextureBuilder setFromBlock(Block block, int meta);
+
+    /**
+     * @param side <p>The {@link ForgeDirection} side providing the texture</p>
+     *             <p>Default is {@link ForgeDirection#UNKNOWN} to use same side as rendered</p>
+     * @return {@link ITextureBuilder} for chaining
+     */
+    ITextureBuilder setFromSide(ForgeDirection side);
+
+    /**
+     * @param iconContainers The {@link IIconContainer}s to add
+     * @return {@link ITextureBuilder} for chaining
+     */
+    ITextureBuilder addIcon(IIconContainer... iconContainers);
+
+    /**
+     * @param rgba The RGBA tint for this {@link ITexture}
+     * @return {@link ITextureBuilder} for chaining
+     */
+    ITextureBuilder setRGBA(short[] rgba);
+
+    /**
+     * @param iTextures The {@link ITexture} layers to add
+     * @return {@link ITextureBuilder} for chaining
+     */
+    ITextureBuilder addLayer(ITexture... iTextures);
+
+    /**
+     * Set alpha blending
+     * @param allowAlpha to set
+     *
+     * @return {@link ITextureBuilder} for chaining
+     */
+    ITextureBuilder setAllowAlpha(boolean allowAlpha);
+
+    /**
+     * Texture will render with same orientation as with vanilla blocks
+     *
+     * @return {@link ITextureBuilder} for chaining
+     */
+    ITextureBuilder stdOrient();
+
+    /**
+     * Texture always render with full brightness to glow in the dark
+     *
+     * @return {@link ITextureBuilder} for chaining
+     */
+    ITextureBuilder glow();
+}
-- 
cgit