116 lines
3.5 KiB
Java
116 lines
3.5 KiB
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.networking;
|
|
|
|
|
|
import java.util.EnumSet;
|
|
|
|
import net.minecraft.item.ItemStack;
|
|
import net.minecraft.util.EnumFacing;
|
|
|
|
import appeng.api.parts.IPart;
|
|
import appeng.api.util.AEColor;
|
|
import appeng.api.util.DimensionalCoord;
|
|
|
|
|
|
/**
|
|
* An Implementation is required to create your node for IGridHost
|
|
*
|
|
* Implement for use with IGridHost
|
|
*/
|
|
public interface IGridBlock
|
|
{
|
|
|
|
/**
|
|
* how much power to drain per tick as part of idle network usage.
|
|
*
|
|
* if the value of this changes, you must post a MENetworkPowerIdleChange
|
|
*
|
|
* @return ae/t to use.
|
|
*/
|
|
double getIdlePowerUsage();
|
|
|
|
/**
|
|
* Various flags that AE uses to modify basic behavior for various parts of the network.
|
|
*
|
|
* @return Set of flags for this IGridBlock
|
|
*/
|
|
EnumSet<GridFlags> getFlags();
|
|
|
|
/**
|
|
* generally speaking you will return true for this, the one exception is buses, or worm holes where the node
|
|
* represents something that isn't a real connection in the world, but rather one represented internally to the
|
|
* block.
|
|
*
|
|
* @return if the world can connect to this node, and the node can connect to the world.
|
|
*/
|
|
boolean isWorldAccessible();
|
|
|
|
/**
|
|
* @return current location of this node
|
|
*/
|
|
DimensionalCoord getLocation();
|
|
|
|
/**
|
|
* @return Transparent, or a valid color, NULL IS NOT A VALID RETURN
|
|
*/
|
|
AEColor getGridColor();
|
|
|
|
/**
|
|
* Notifies your IGridBlock that changes were made to your connections
|
|
*/
|
|
void onGridNotification( GridNotification notification );
|
|
|
|
/**
|
|
* Update Blocks network/connection/booting status. grid,
|
|
*
|
|
* @param grid grid
|
|
* @param channelsInUse used channels
|
|
*/
|
|
void setNetworkStatus( IGrid grid, int channelsInUse );
|
|
|
|
/**
|
|
* Determine which sides of the block can be connected too, only used when isWorldAccessible returns true, not used
|
|
* for {@link IPart} implementations.
|
|
*/
|
|
EnumSet<EnumFacing> getConnectableSides();
|
|
|
|
/**
|
|
* @return the IGridHost for the node, this will be an IGridPart or a TileEntity generally speaking.
|
|
*/
|
|
IGridHost getMachine();
|
|
|
|
/**
|
|
* called when the grid for the node has changed, the general grid state should not be trusted at this point.
|
|
*/
|
|
void gridChanged();
|
|
|
|
/**
|
|
* Determines what item stack is used to render this node in the GUI.
|
|
*
|
|
* @return the render item stack to use to render this node, null is valid, and will not show this node.
|
|
*/
|
|
ItemStack getMachineRepresentation();
|
|
}
|