Application: gvSIG desktop

package org.gvsig.gpe;

import java.io.IOException;

/**

 * An iterator over the current geometry being parsed intended to be given to the consumer

 * {@link IGPEContentHandler}.

 * <p>

 * This provides an abstraction for specific format parsers to optimize as needed without imposing a

 * coordinate structure to the consumer application which may be inefficient for its geometry model.

 * </p>

 * <p>

 * Basically, using this interface allows for the following optimizations:

 * <ul>

 * <li>Avoid unneeded coordinate parsing where not necessary

 * <li>Allows to serve geometry sequences of arbitrary dimensions

 * <li>Allows unnecessary copy of large coordinate buffers from different arrays of doubles,

 * letting the consumer iterate over the coordinates and build its geometries more efficiently

 * </ul>

 * </p>

 * 

 * @author Gabriel Roldan (TOPP)

 * @version $Id: ICoordinateIterator.java 19577 2008-03-12 12:50:37Z groldan $

 */

public interface ICoordinateIterator {

    public boolean hasNext() throws IOException;

    public int getDimension();

    public void next(double[] buffer) throws IOException;

}