src/common/buildcraft/api/inventory/ISpecialInventory.java

package buildcraft.api.inventory;

import buildcraft.api.core.Orientations;
import net.minecraft.src.IInventory;
import net.minecraft.src.ItemStack;

public interface ISpecialInventory extends IInventory {
	
	/**
	 * Offers an ItemStack for addition to the inventory.
	 * @param stack ItemStack offered for addition. Do not manipulate this!
	 * @param doAdd If false no actual addition should take place. 
	 * @param from Orientation the ItemStack is offered from.
	 * @return Amount of items used from the passed stack.
	 */
	int addItem(ItemStack stack, boolean doAdd, Orientations from);
	/**
	 * Requests items to be extracted from the inventory
	 * @param doRemove If false no actual extraction may occur.
	 * @param from Orientation the ItemStack is requested from.
	 * @param maxItemCount Maximum amount of items to extract (spread over all returned item stacks) 
	 * @return Array of item stacks extracted from the inventory
	 */
	ItemStack[] extractItem(boolean doRemove, Orientations from, int maxItemCount);
	
}