aima.core.util.math.geom.IGroupParser Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of aima-core Show documentation

AIMA-Java Core Algorithms from the book Artificial Intelligence a Modern Approach 3rd Ed.

The newest version!

package aima.core.util.math.geom;

import java.io.File;
import java.io.InputStream;
import java.util.ArrayList;

import aima.core.util.math.geom.shapes.IGeometric2D;
import aima.core.util.math.geom.shapes.Rect2D;

/**
 * This interface defines a parser that creates {@code ArrayList}s for geometric shapes represented through {@link IGeometric2D}
 * and their boundaries represented through {@link Rect2D} out of a given file.

 * The parser uses a {@link File} as an input and a {@code String} representing the ID of a group of shapes.
 * 
 * @author Arno von Borries
 * @author Jan Phillip Kretzschmar
 * @author Andreas Walscheid
 * 
 */
public interface IGroupParser {
	/**
	 * Parses the given {@link File} into a group of geometric shapes.
	 * @param input the given input stream.
	 * @param groupID the identifier for the group.
	 * @throws Exception if an error is found while parsing the input.
	 * @return the constructed list of geometric shapes.
	 */
	ArrayList parse(InputStream input, String groupID) throws Exception;
}