/*

 * Copyright (c) 1997, 2005, 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 javax.swing;

import java.awt.Color;

import java.awt.Font;

import javax.swing.JComponent;

import javax.swing.border.*;

/**

 * Factory class for vending standard <code>Border</code> objects.  Wherever

 * possible, this factory will hand out references to shared

 * <code>Border</code> instances.

 * For further information and examples see

 * <a href="http://java.sun.com/docs/books/tutorial/uiswing/misc/border.html">How

 to Use Borders</a>,

 * a section in <em>The Java Tutorial</em>.

 *

 * @author David Kloba

 */

public class BorderFactory

{

    /** Don't let anyone instantiate this class */

    private BorderFactory() {

    }

//// LineBorder ///////////////////////////////////////////////////////////////

    /**

     * Creates a line border withe the specified color.

     *

     * @param color  a <code>Color</code> to use for the line

     * @return the <code>Border</code> object

     */

    public static Border createLineBorder(Color color) {

        return new LineBorder(color, 1);

    }

    /**

     * Creates a line border with the specified color

     * and width. The width applies to all four sides of the

     * border. To specify widths individually for the top,

     * bottom, left, and right, use

     * {@link #createMatteBorder(int,int,int,int,Color)}.

     *

     * @param color  a <code>Color</code> to use for the line

     * @param thickness  an integer specifying the width in pixels

     * @return the <code>Border</code> object

     */

    public static Border createLineBorder(Color color, int thickness)  {

        return new LineBorder(color, thickness);

    }

//    public static Border createLineBorder(Color color, int thickness,

//                                      boolean drawRounded)  {

//        return new JLineBorder(color, thickness, drawRounded);

//    }

//// BevelBorder /////////////////////////////////////////////////////////////

///////////////////////////////////////////////////////////////////////////////

    static final Border sharedRaisedBevel = new BevelBorder(BevelBorder.RAISED);

    static final Border sharedLoweredBevel = new BevelBorder(BevelBorder.LOWERED);

    /**

     * Creates a border with a raised beveled edge, using

     * brighter shades of the component's current background color

     * for highlighting, and darker shading for shadows.

     * (In a raised border, highlights are on top and shadows

     *  are underneath.)

     *

     * @return the <code>Border</code> object

     */

    public static Border createRaisedBevelBorder() {

        return createSharedBevel(BevelBorder.RAISED);

    }

    /**

     * Creates a border with a lowered beveled edge, using

     * brighter shades of the component's current background color

     * for highlighting, and darker shading for shadows.

     * (In a lowered border, shadows are on top and highlights

     *  are underneath.)

     *

     * @return the <code>Border</code> object

     */

    public static Border createLoweredBevelBorder() {

        return createSharedBevel(BevelBorder.LOWERED);

    }

    /**

     * Creates a beveled border of the specified type, using

     * brighter shades of the component's current background color

     * for highlighting, and darker shading for shadows.

     * (In a lowered border, shadows are on top and highlights

     *  are underneath.)

     *

     * @param type  an integer specifying either

     *                  <code>BevelBorder.LOWERED</code> or

     *                  <code>BevelBorder.RAISED</code>

     * @return the <code>Border</code> object

     */

    public static Border createBevelBorder(int type) {

        return createSharedBevel(type);

    }

    /**

     * Creates a beveled border of the specified type, using

     * the specified highlighting and shadowing. The outer

     * edge of the highlighted area uses a brighter shade of

     * the highlight color. The inner edge of the shadow area

     * uses a brighter shade of the shadow color.

     *

     * @param type  an integer specifying either

     *                  <code>BevelBorder.LOWERED</code> or

     *                  <code>BevelBorder.RAISED</code>

     * @param highlight  a <code>Color</code> object for highlights

     * @param shadow     a <code>Color</code> object for shadows

     * @return the <code>Border</code> object

     */

    public static Border createBevelBorder(int type, Color highlight, Color shadow) {

        return new BevelBorder(type, highlight, shadow);

    }

    /**

     * Creates a beveled border of the specified type, using

     * the specified colors for the inner and outer highlight

     * and shadow areas.

     * <p>

     * Note: The shadow inner and outer colors are

     * switched for a lowered bevel border.

     *

     * @param type  an integer specifying either

     *          <code>BevelBorder.LOWERED</code> or

     *          <code>BevelBorder.RAISED</code>

     * @param highlightOuter  a <code>Color</code> object for the

     *                  outer edge of the highlight area

     * @param highlightInner  a <code>Color</code> object for the

     *                  inner edge of the highlight area

     * @param shadowOuter     a <code>Color</code> object for the

     *                  outer edge of the shadow area

     * @param shadowInner     a <code>Color</code> object for the

     *                  inner edge of the shadow area

     * @return the <code>Border</code> object

     */

    public static Border createBevelBorder(int type,

                        Color highlightOuter, Color highlightInner,

                        Color shadowOuter, Color shadowInner) {

        return new BevelBorder(type, highlightOuter, highlightInner,

                                        shadowOuter, shadowInner);

    }

    static Border createSharedBevel(int type)   {

        if(type == BevelBorder.RAISED) {

            return sharedRaisedBevel;

        } else if(type == BevelBorder.LOWERED) {

            return sharedLoweredBevel;

        }

        return null;

    }

//// EtchedBorder ///////////////////////////////////////////////////////////

    static final Border sharedEtchedBorder = new EtchedBorder();

    private static Border sharedRaisedEtchedBorder;

    /**

     * Creates a border with an "etched" look using

     * the component's current background color for

     * highlighting and shading.

     *

     * @return the <code>Border</code> object

     */

    public static Border createEtchedBorder()    {

        return sharedEtchedBorder;

    }

    /**

     * Creates a border with an "etched" look using

     * the specified highlighting and shading colors.

     *

     * @param highlight  a <code>Color</code> object for the border highlights

     * @param shadow     a <code>Color</code> object for the border shadows

     * @return the <code>Border</code> object

     */

    public static Border createEtchedBorder(Color highlight, Color shadow)    {

        return new EtchedBorder(highlight, shadow);

    }

    /**

     * Creates a border with an "etched" look using

     * the component's current background color for

     * highlighting and shading.

     *

     * @param type      one of <code>EtchedBorder.RAISED</code>, or

     *                  <code>EtchedBorder.LOWERED</code>

     * @return the <code>Border</code> object

     * @exception IllegalArgumentException if type is not either

     *                  <code>EtchedBorder.RAISED</code> or

     *                  <code>EtchedBorder.LOWERED</code>

     * @since 1.3

     */

    public static Border createEtchedBorder(int type)    {

        switch (type) {

        case EtchedBorder.RAISED:

            if (sharedRaisedEtchedBorder == null) {

                sharedRaisedEtchedBorder = new EtchedBorder

                                           (EtchedBorder.RAISED);

            }

            return sharedRaisedEtchedBorder;

        case EtchedBorder.LOWERED:

            return sharedEtchedBorder;

        default:

            throw new IllegalArgumentException("type must be one of EtchedBorder.RAISED or EtchedBorder.LOWERED");

        }

    }

    /**

     * Creates a border with an "etched" look using

     * the specified highlighting and shading colors.

     *

     * @param type      one of <code>EtchedBorder.RAISED</code>, or

     *                  <code>EtchedBorder.LOWERED</code>

     * @param highlight  a <code>Color</code> object for the border highlights

     * @param shadow     a <code>Color</code> object for the border shadows

     * @return the <code>Border</code> object

     * @since 1.3

     */

    public static Border createEtchedBorder(int type, Color highlight,

                                            Color shadow)    {

        return new EtchedBorder(type, highlight, shadow);

    }

//// TitledBorder ////////////////////////////////////////////////////////////

    /**

     * Creates a new titled border with the specified title,

     * the default border type (determined by the current look and feel),

     * the default text position (sitting on the top line),

     * the default justification (leading), and the default

     * font and text color (determined by the current look and feel).

     *

     * @param title      a <code>String</code> containing the text of the title

     * @return the <code>TitledBorder</code> object

     */

    public static TitledBorder createTitledBorder(String title)     {

        return new TitledBorder(title);

    }

    /**

     * Creates a new titled border with an empty title,

     * the specified border object,

     * the default text position (sitting on the top line),

     * the default justification (leading), and the default

     * font and text color (determined by the current look and feel).

     *

     * @param border     the <code>Border</code> object to add the title to; if

     *                   <code>null</code> the <code>Border</code> is determined

     *                   by the current look and feel.

     * @return the <code>TitledBorder</code> object

     */

    public static TitledBorder createTitledBorder(Border border)       {

        return new TitledBorder(border);

    }

    /**

     * Adds a title to an existing border,

     * with default positioning (sitting on the top line),

     * default justification (leading) and the default

     * font and text color (determined by the current look and feel).

     *

     * @param border     the <code>Border</code> object to add the title to

     * @param title      a <code>String</code> containing the text of the title

     * @return the <code>TitledBorder</code> object

     */

    public static TitledBorder createTitledBorder(Border border,

                                                   String title) {

        return new TitledBorder(border, title);

    }

    /**

     * Adds a title to an existing border, with the specified

     * positioning and using the default

     * font and text color (determined by the current look and feel).

     *

     * @param border      the <code>Border</code> object to add the title to

     * @param title       a <code>String</code> containing the text of the title

     * @param titleJustification  an integer specifying the justification

     *        of the title -- one of the following:

     *<ul>

     *<li><code>TitledBorder.LEFT</code>

     *<li><code>TitledBorder.CENTER</code>

     *<li><code>TitledBorder.RIGHT</code>

     *<li><code>TitledBorder.LEADING</code>

     *<li><code>TitledBorder.TRAILING</code>

     *<li><code>TitledBorder.DEFAULT_JUSTIFICATION</code> (leading)

     *</ul>

     * @param titlePosition       an integer specifying the vertical position of

     *        the text in relation to the border -- one of the following:

     *<ul>

     *<li><code> TitledBorder.ABOVE_TOP</code>

     *<li><code>TitledBorder.TOP</code> (sitting on the top line)

     *<li><code>TitledBorder.BELOW_TOP</code>

     *<li><code>TitledBorder.ABOVE_BOTTOM</code>

     *<li><code>TitledBorder.BOTTOM</code> (sitting on the bottom line)

     *<li><code>TitledBorder.BELOW_BOTTOM</code>

     *<li><code>TitledBorder.DEFAULT_POSITION</code> (top)

     *</ul>

     * @return the <code>TitledBorder</code> object

     */

    public static TitledBorder createTitledBorder(Border border,

                        String title,

                        int titleJustification,

                        int titlePosition)      {

        return new TitledBorder(border, title, titleJustification,

                        titlePosition);

    }

    /**

     * Adds a title to an existing border, with the specified

     * positioning and font, and using the default text color

     * (determined by the current look and feel).

     *

     * @param border      the <code>Border</code> object to add the title to

     * @param title       a <code>String</code> containing the text of the title

     * @param titleJustification  an integer specifying the justification

     *        of the title -- one of the following:

     *<ul>

     *<li><code>TitledBorder.LEFT</code>

     *<li><code>TitledBorder.CENTER</code>

     *<li><code>TitledBorder.RIGHT</code>

     *<li><code>TitledBorder.LEADING</code>

     *<li><code>TitledBorder.TRAILING</code>

     *<li><code>TitledBorder.DEFAULT_JUSTIFICATION</code> (leading)

     *</ul>

     * @param titlePosition       an integer specifying the vertical position of

     *        the text in relation to the border -- one of the following:

     *<ul>

     *<li><code> TitledBorder.ABOVE_TOP</code>

     *<li><code>TitledBorder.TOP</code> (sitting on the top line)

     *<li><code>TitledBorder.BELOW_TOP</code>

     *<li><code>TitledBorder.ABOVE_BOTTOM</code>

     *<li><code>TitledBorder.BOTTOM</code> (sitting on the bottom line)

     *<li><code>TitledBorder.BELOW_BOTTOM</code>

     *<li><code>TitledBorder.DEFAULT_POSITION</code> (top)

     *</ul>

     * @param titleFont           a Font object specifying the title font

     * @return the TitledBorder object

     */

    public static TitledBorder createTitledBorder(Border border,

                        String title,

                        int titleJustification,

                        int titlePosition,

                        Font titleFont) {

        return new TitledBorder(border, title, titleJustification,

                        titlePosition, titleFont);

    }

    /**

     * Adds a title to an existing border, with the specified

     * positioning, font and color.

     *

     * @param border      the <code>Border</code> object to add the title to

     * @param title       a <code>String</code> containing the text of the title

     * @param titleJustification  an integer specifying the justification

     *        of the title -- one of the following:

     *<ul>

     *<li><code>TitledBorder.LEFT</code>

     *<li><code>TitledBorder.CENTER</code>

     *<li><code>TitledBorder.RIGHT</code>

     *<li><code>TitledBorder.LEADING</code>

     *<li><code>TitledBorder.TRAILING</code>

     *<li><code>TitledBorder.DEFAULT_JUSTIFICATION</code> (leading)

     *</ul>

     * @param titlePosition       an integer specifying the vertical position of

     *        the text in relation to the border -- one of the following:

     *<ul>

     *<li><code> TitledBorder.ABOVE_TOP</code>

     *<li><code>TitledBorder.TOP</code> (sitting on the top line)

     *<li><code>TitledBorder.BELOW_TOP</code>

     *<li><code>TitledBorder.ABOVE_BOTTOM</code>

     *<li><code>TitledBorder.BOTTOM</code> (sitting on the bottom line)

     *<li><code>TitledBorder.BELOW_BOTTOM</code>

     *<li><code>TitledBorder.DEFAULT_POSITION</code> (top)

     *</ul>

     * @param titleFont   a <code>Font</code> object specifying the title font

     * @param titleColor  a <code>Color</code> object specifying the title color

     * @return the <code>TitledBorder</code> object

     */

    public static TitledBorder createTitledBorder(Border border,

                        String title,

                        int titleJustification,

                        int titlePosition,

                        Font titleFont,

                        Color titleColor)       {

        return new TitledBorder(border, title, titleJustification,

                        titlePosition, titleFont, titleColor);

    }

//// EmptyBorder ///////////////////////////////////////////////////////////

    final static Border emptyBorder = new EmptyBorder(0, 0, 0, 0);

    /**

     * Creates an empty border that takes up no space. (The width

     * of the top, bottom, left, and right sides are all zero.)

     *

     * @return the <code>Border</code> object

     */

    public static Border createEmptyBorder() {

        return emptyBorder;

    }

    /**

     * Creates an empty border that takes up space but which does

     * no drawing, specifying the width of the top, left, bottom, and

     * right sides.

     *

     * @param top     an integer specifying the width of the top,

     *                  in pixels

     * @param left    an integer specifying the width of the left side,

     *                  in pixels

     * @param bottom  an integer specifying the width of the bottom,

     *                  in pixels

     * @param right   an integer specifying the width of the right side,

     *                  in pixels

     * @return the <code>Border</code> object

     */

    public static Border createEmptyBorder(int top, int left,

                                                int bottom, int right) {

        return new EmptyBorder(top, left, bottom, right);

    }

//// CompoundBorder ////////////////////////////////////////////////////////

    /**

     * Creates a compound border with a <code>null</code> inside edge and a

     * <code>null</code> outside edge.

     *

     * @return the <code>CompoundBorder</code> object

     */

    public static CompoundBorder createCompoundBorder() {

        return new CompoundBorder();

    }

    /**

     * Creates a compound border specifying the border objects to use

     * for the outside and inside edges.

     *

     * @param outsideBorder  a <code>Border</code> object for the outer

     *                          edge of the compound border

     * @param insideBorder   a <code>Border</code> object for the inner

     *                          edge of the compound border

     * @return the <code>CompoundBorder</code> object

     */

    public static CompoundBorder createCompoundBorder(Border outsideBorder,

                                                Border insideBorder) {

        return new CompoundBorder(outsideBorder, insideBorder);

    }

//// MatteBorder ////////////////////////////////////////////////////////

    /**

     * Creates a matte-look border using a solid color. (The difference between

     * this border and a line border is that you can specify the individual

     * border dimensions.)

     *

     * @param top     an integer specifying the width of the top,

     *                          in pixels

     * @param left    an integer specifying the width of the left side,

     *                          in pixels

     * @param bottom  an integer specifying the width of the right side,

     *                          in pixels

     * @param right   an integer specifying the width of the bottom,

     *                          in pixels

     * @param color   a <code>Color</code> to use for the border

     * @return the <code>MatteBorder</code> object

     */

    public static MatteBorder createMatteBorder(int top, int left, int bottom, int right,

                                                Color color) {

        return new MatteBorder(top, left, bottom, right, color);

    }

    /**

     * Creates a matte-look border that consists of multiple tiles of a

     * specified icon. Multiple copies of the icon are placed side-by-side

     * to fill up the border area.

     * <p>

     * Note:<br>

     * If the icon doesn't load, the border area is painted gray.

     *

     * @param top     an integer specifying the width of the top,

     *                          in pixels

     * @param left    an integer specifying the width of the left side,

     *                          in pixels

     * @param bottom  an integer specifying the width of the right side,

     *                          in pixels

     * @param right   an integer specifying the width of the bottom,

     *                          in pixels

     * @param tileIcon  the <code>Icon</code> object used for the border tiles

     * @return the <code>MatteBorder</code> object

     */

    public static MatteBorder createMatteBorder(int top, int left, int bottom, int right,

                                                Icon tileIcon) {

        return new MatteBorder(top, left, bottom, right, tileIcon);

    }

}