0N/A/*
2362N/A * Copyright (c) 1998, 1999, Oracle and/or its affiliates. All rights reserved.
0N/A * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
0N/A *
0N/A * This code is free software; you can redistribute it and/or modify it
0N/A * under the terms of the GNU General Public License version 2 only, as
2362N/A * published by the Free Software Foundation. Oracle designates this
0N/A * particular file as subject to the "Classpath" exception as provided
2362N/A * by Oracle in the LICENSE file that accompanied this code.
0N/A *
0N/A * This code is distributed in the hope that it will be useful, but WITHOUT
0N/A * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
0N/A * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
0N/A * version 2 for more details (a copy is included in the LICENSE file that
0N/A * accompanied this code).
0N/A *
0N/A * You should have received a copy of the GNU General Public License version
0N/A * 2 along with this work; if not, write to the Free Software Foundation,
0N/A * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
0N/A *
2362N/A * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
2362N/A * or visit www.oracle.com if you need additional information or have any
2362N/A * questions.
0N/A */
0N/A
0N/Apackage sun.java2d.pipe;
0N/A
0N/A/**
0N/A * This interface defines a general method for iterating through the
0N/A * rectangular "spans" that represent the interior of a filled path.
0N/A * <p>
0N/A * There can be many kinds of span iterators used in the rendering
0N/A * pipeline, the most basic being an iterator that scan converts a
0N/A * path defined by any PathIterator, or an nested iterator which
0N/A * intersects another iterator's spans with a clip region.
0N/A * Other iterators can be created for scan converting some of the
0N/A * primitive shapes more explicitly for speed or quality.
0N/A *
0N/A * @author Jim Graham
0N/A */
0N/Apublic interface SpanIterator {
0N/A /**
0N/A * This method returns the bounding box of the spans that the
0N/A * iterator will be returning.
0N/A * The array must be of length at least 4 and upon return, it
0N/A * will be filled with the values:
0N/A * <pre>
0N/A * {PathMinX, PathMinY, PathMaxX, PathMaxY}.
0N/A * </pre>
0N/A */
0N/A public void getPathBox(int pathbox[]);
0N/A
0N/A /**
0N/A * This method constrains the spans returned by nextSpan() to the
0N/A * rectangle whose bounds are given.
0N/A */
0N/A public void intersectClipBox(int lox, int loy, int hix, int hiy);
0N/A
0N/A /**
0N/A * This method returns the next span in the shape being iterated.
0N/A * The array must be of length at least 4 and upon return, it
0N/A * will be filled with the values:
0N/A * <pre>
0N/A * {SpanMinX, SpanMinY, SpanMaxX, SpanMaxY}.
0N/A * </pre>
0N/A */
0N/A public boolean nextSpan(int spanbox[]);
0N/A
0N/A /**
0N/A * This method tells the iterator that it may skip all spans
0N/A * whose Y range is completely above the indicated Y coordinate.
0N/A * This method is used to provide feedback from the caller when
0N/A * clipping prevents the display of any data in a given Y range.
0N/A * Typically it will only be called when this iterator has returned
0N/A * a span whose MaxY coordinate is less than the indicated Y and
0N/A * the calling mechanism wants to avoid unnecessary iteration work.
0N/A * While this request could technically be ignored (i.e. a NOP),
0N/A * doing so could potentially cause the caller to make this callback
0N/A * for each span that is being skipped.
0N/A */
0N/A public void skipDownTo(int y);
0N/A
0N/A /**
0N/A * This method returns a native pointer to a function block that
0N/A * can be used by a native method to perform the same iteration
0N/A * cycle that the above methods provide while avoiding upcalls to
0N/A * the Java object.
0N/A * The definition of the structure whose pointer is returned by
0N/A * this method is defined in:
0N/A * <pre>
0N/A * src/share/native/sun/java2d/pipe/SpanIterator.h
0N/A * </pre>
0N/A */
0N/A public long getNativeIterator();
0N/A}
0N/A