Applied-Energistics-2-tilera-Edition/src/api/java/appeng/api/parts/IPartRenderHelper.java

/*
 * The MIT License (MIT)
 *
 * Copyright (c) 2013 AlgorithmX2
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy of
 * this software and associated documentation files (the "Software"), to deal in
 * the Software without restriction, including without limitation the rights to
 * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
 * the Software, and to permit persons to whom the Software is furnished to do so,
 * subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in all
 * copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
 * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
 * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
 * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 */

package appeng.api.parts;


import java.util.EnumSet;

import net.minecraft.block.Block;
import net.minecraft.util.BlockPos;
import net.minecraft.util.EnumFacing;
import net.minecraftforge.fml.relauncher.Side;
import net.minecraftforge.fml.relauncher.SideOnly;
import appeng.client.render.IRenderHelper;
import appeng.client.texture.IAESprite;


public interface IPartRenderHelper
{

	/**
	 * sets the Render Helpers Block Bounds. 0.0 - 16.0 block coords.
	 *
	 * No complaints about the size, I like using pixels :P
	 *
	 * @param minX minimal x bound
	 * @param minY minimal y bound
	 * @param minZ minimal z bound
	 * @param maxX maximal x bound
	 * @param maxY maximal y bound
	 * @param maxZ maximal z bound
	 */
	void setBounds( float minX, float minY, float minZ, float maxX, float maxY, float maxZ );

	/**
	 * static renderer
	 *
	 * render a single face.
	 *
	 * @param pos	   POSITION of part
	 * @param ico      icon of part
	 * @param face     direction its facing
	 * @param renderer renderer of part
	 */
	@SideOnly( Side.CLIENT )
	void renderFace( BlockPos pos, IAESprite ico, EnumFacing face, IRenderHelper renderer );

	/**
	 * static renderer
	 *
	 * render a box with a cut out box in the center.
	 *
	 * @param pos			pos of part
	 * @param ico           icon of part
	 * @param face          face of part
	 * @param edgeThickness thickness of the edge
	 * @param renderer      renderer
	 */
	@SideOnly( Side.CLIENT )
	void renderFaceCutout( BlockPos pos, IAESprite ico, EnumFacing face, float edgeThickness, IRenderHelper renderer );

	/**
	 * static renderer
	 *
	 * render a block of specified bounds.
	 *
	 * @param x        x pos of block
	 * @param y        y pos of block
	 * @param z        z pos of block
	 * @param renderer renderer
	 */
	@SideOnly( Side.CLIENT )
	void renderBlock( BlockPos pos, IRenderHelper renderer );

	/**
	 * render a single face in inventory renderer.
	 *
	 * @param TextureAtlasSprite     icon of part
	 * @param direction face of part
	 * @param renderer  renderer
	 */
	@SideOnly( Side.CLIENT )
	void renderInventoryFace( IAESprite IIcon, EnumFacing direction, IRenderHelper renderer );

	/**
	 * render a box in inventory renderer.
	 *
	 * @param renderer renderer
	 */
	@SideOnly( Side.CLIENT )
	void renderInventoryBox( IRenderHelper renderer );

	/**
	 * inventory, and static renderer.
	 *
	 * set unique icons for each side of the block.
	 *
	 * @param down  down face
	 * @param up    up face
	 * @param north north face
	 * @param south south face
	 * @param west  west face
	 * @param east  east face
	 */
	void setTexture( IAESprite down, IAESprite up, IAESprite north, IAESprite south, IAESprite west, IAESprite east );

	/**
	 * inventory, and static renderer.
	 *
	 * set all sides to a single TextureAtlasSprite.
	 *
	 * @param ico to be set icon
	 */
	void setTexture( IAESprite ico );

	/**
	 * configure the color multiplier for the inventory renderer.
	 *
	 * @param whiteVariant color multiplier
	 */
	void setInvColor( int whiteVariant );

	/**
	 * @return the block used for rendering, might need it for some reason...
	 */
	Block getBlock();

	/**
	 * @return the east vector in world directions, rather then renderer
	 */
	EnumFacing getWorldX();

	/**
	 * @return the up vector in world directions, rather then renderer.
	 */
	EnumFacing getWorldY();

	/**
	 * @return the forward vector in world directions, rather then renderer.
	 */
	EnumFacing getWorldZ();

	/**
	 * render a block using the current renderer state.
	 *
	 * @param x        x pos of part
	 * @param y        y pos of part
	 * @param z        z pos of part
	 * @param renderer renderer of part
	 */
	void renderBlockCurrentBounds( BlockPos pos, IRenderHelper renderer );

	/**
	 * allow you to enable your part to render during the alpha pass or the standard pass.
	 *
	 * @param pass render pass
	 */
	void renderForPass( int pass );

	/**
	 * Set which faces to render, remember to set back to ALL when you are done.
	 *
	 * @param complementOf sides to render
	 */
	void setFacesToRender( EnumSet<EnumFacing> complementOf );
}