/*
 * Copyright (c) 2008, 2012, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the LICENSE file that accompanied this code.
 *
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */

package sun.java2d.pipe;

import sun.java2d.SunGraphics2D;

This interface defines the set of calls that pipeline objects
can use to pass on responsibility for drawing arbitrary
parallelogram shapes.
Six floating point numbers are provided and the parallelogram
is defined as the quadrilateral with the following vertices:
    origin: (x, y)
         => (x+dx1, y+dy1)
         => (x+dx1+dx2, y+dy1+dy2)
         => (x+dx2, y+dy2)
         => origin

The four u[xy][12] parameters are the unsorted extreme coordinates
of the primitive in user space.  They may have been generated by a
line or a rectangle so they could have u[xy]2 < u[xy]1 in some cases.
They should be sorted before calculating the bounds of the original
primitive (such as for calculating the user space bounds for the
Paint.createContext() method).
/**
 * This interface defines the set of calls that pipeline objects
 * can use to pass on responsibility for drawing arbitrary
 * parallelogram shapes.
 * Six floating point numbers are provided and the parallelogram
 * is defined as the quadrilateral with the following vertices:
 * <pre>
 *     origin: (x, y)
 *          => (x+dx1, y+dy1)
 *          => (x+dx1+dx2, y+dy1+dy2)
 *          => (x+dx2, y+dy2)
 *          => origin
 * </pre>
 * The four u[xy][12] parameters are the unsorted extreme coordinates
 * of the primitive in user space.  They may have been generated by a
 * line or a rectangle so they could have u[xy]2 < u[xy]1 in some cases.
 * They should be sorted before calculating the bounds of the original
 * primitive (such as for calculating the user space bounds for the
 * Paint.createContext() method).
 */
public interface ParallelogramPipe {
    public void fillParallelogram(SunGraphics2D sg,
                                  double ux1, double uy1,
                                  double ux2, double uy2,
                                  double x, double y,
                                  double dx1, double dy1,
                                  double dx2, double dy2);

    
Draw a Parallelogram with the indicated line widths
assuming a standard BasicStroke with MITER joins.
lw1 specifies the width of the stroke along the dx1,dy1
vector and lw2 specifies the width of the stroke along
the dx2,dy2 vector.
This is equivalent to outsetting the indicated
parallelogram by lw/2 pixels, then insetting the
same parallelogram by lw/2 pixels and filling the
difference between the outer and inner parallelograms.
/**
     * Draw a Parallelogram with the indicated line widths
     * assuming a standard BasicStroke with MITER joins.
     * lw1 specifies the width of the stroke along the dx1,dy1
     * vector and lw2 specifies the width of the stroke along
     * the dx2,dy2 vector.
     * This is equivalent to outsetting the indicated
     * parallelogram by lw/2 pixels, then insetting the
     * same parallelogram by lw/2 pixels and filling the
     * difference between the outer and inner parallelograms.
     */
    public void drawParallelogram(SunGraphics2D sg,
                                  double ux1, double uy1,
                                  double ux2, double uy2,
                                  double x, double y,
                                  double dx1, double dy1,
                                  double dx2, double dy2,
                                  double lw1, double lw2);
}