/*
 * @(#)SVGFigureFactory.java
 *
 * Copyright (c) 1996-2010 by the original authors of JHotDraw and all its
 * contributors. All rights reserved.
 *
 * You may not use, copy or modify this file, except in compliance with the 
 * license agreement you entered into with the copyright holders. For details
 * see accompanying license terms.
 */

package org.jhotdraw.samples.svg.io;

import edu.umd.cs.findbugs.annotations.Nullable;
import java.awt.*;
import java.awt.geom.*;
import java.awt.image.*;
import java.util.*;
import javax.swing.text.*;
import org.jhotdraw.draw.*;
import org.jhotdraw.geom.*;
import org.jhotdraw.samples.svg.*;

/**
 * Creates Figures for SVG elements.
 * 

 * Design pattern:

 * Name: Abstract Factory.

 * Role: Abstract Factory.

 * Partners: {@link SVGInputFormat} as Client. 
 *
 * @author Werner Randelshofer
 * @version $Id: SVGFigureFactory.java 717 2010-11-21 12:30:57Z rawcoder $
 */
public interface SVGFigureFactory {
    public Figure createRect(
            double x, double y, double width, double height, double rx, double ry, 
            Map attributes);
    
    public Figure createCircle(
            double cx, double cy, double r, 
            Map attributes);
    
    public Figure createEllipse(
            double cx, double cy, double rx, double ry, 
            Map attributes);

    public Figure createLine(
            double x1, double y1, double x2, double y2, 
            Map attributes);

    public Figure createPolyline(
            Point2D.Double[] points, 
            Map attributes);
    
    public Figure createPolygon(
            Point2D.Double[] points, 
            Map attributes);

    public Figure createPath(
            BezierPath[] beziers, 
            Map attributes);

    public CompositeFigure createG(Map attributes);
    
    public Figure createText(
            Point2D.Double[] coordinates, double[] rotate,
            StyledDocument text,  
            Map attributes);
    
    public Figure createTextArea(double x, double y, double w, double h, 
            StyledDocument doc, Map attributes);

    /**
     * Creates a Figure from an image element.
     *
     * @param x The x coordinate.
     * @param y The y coordinate.
     * @param width The width.
     * @param height The height.
     * @param imageData Holds the image data. Can be null, if the buffered image
     * has not been created from a file.
     * @param bufferedImage Holds the buffered image. Can be null, if the 
     * image data has not been interpreted.
     * @param attributes Figure attributes.
     */
    public Figure createImage(double x, double y, double width, double height, 
           @Nullable byte[] imageData, @Nullable BufferedImage bufferedImage, Map attributes);


    public Gradient createLinearGradient(
            double x1, double y1, double x2, double y2, 
            double[] stopOffsets, Color[] stopColors, double[] stopOpacities,
            boolean isRelativeToFigureBounds, AffineTransform tx);
    
    public Gradient createRadialGradient(
            double cx, double cy, double fx, double fy, double r, 
            double[] stopOffsets, Color[] stopColors, double[] stopOpacities,
            boolean isRelativeToFigureBounds, AffineTransform tx);

}