Package org.apache.xmlgraphics.java2d

Class DefaultGraphics2D

  • All Implemented Interfaces:
    Cloneable
    public class DefaultGraphics2D
extends AbstractGraphics2D
    This concrete implementation of AbstractGraphics2D is a simple help to programmers to get started with their own implementation of Graphics2D. DefaultGraphics2D implements all the abstract methods is AbstractGraphics2D and makes it easy to start implementing a Graphic2D piece-meal.
    Version:
    $Id: DefaultGraphics2D.java 1732018 2016-02-24 04:51:06Z gadams $
    See Also:
    Originally authored by Vincent Hardy.

    • Constructor Detail

      • DefaultGraphics2D

        public DefaultGraphics2D​(boolean textAsShapes)
        Default constructor

      • DefaultGraphics2D

        public DefaultGraphics2D​(DefaultGraphics2D g)
        This constructor supports the create method

    • Method Detail

      • create

        public Graphics create()
        Creates a new Graphics object that is a copy of this Graphics object.
        Specified by:
        create in class Graphics
        Returns:
        a new graphics context that is a copy of this graphics context.

      • drawImage

        public boolean drawImage​(Image img,
                         int x,
                         int y,
                         ImageObserver observer)
        Draws as much of the specified image as is currently available. The image is drawn with its top-left corner at (x, y) in this graphics context's coordinate space. Transparent pixels in the image do not affect whatever pixels are already there.

        This method returns immediately in all cases, even if the complete image has not yet been loaded, and it has not been dithered and converted for the current output device.

        If the image has not yet been completely loaded, then drawImage returns false. As more of the image becomes available, the process that draws the image notifies the specified image observer.

        Specified by:
        drawImage in class Graphics
        Parameters:
        img - the specified image to be drawn.
        x - the x coordinate.
        y - the y coordinate.
        observer - object to be notified as more of the image is converted.
        See Also:
        Image, ImageObserver, ImageObserver.imageUpdate(java.awt.Image, int, int, int, int, int)

      • drawImage

        public boolean drawImage​(Image img,
                         int x,
                         int y,
                         int width,
                         int height,
                         ImageObserver observer)
        Draws as much of the specified image as has already been scaled to fit inside the specified rectangle.

        The image is drawn inside the specified rectangle of this graphics context's coordinate space, and is scaled if necessary. Transparent pixels do not affect whatever pixels are already there.

        This method returns immediately in all cases, even if the entire image has not yet been scaled, dithered, and converted for the current output device. If the current output representation is not yet complete, then drawImage returns false. As more of the image becomes available, the process that draws the image notifies the image observer by calling its imageUpdate method.

        A scaled version of an image will not necessarily be available immediately just because an unscaled version of the image has been constructed for this output device. Each size of the image may be cached separately and generated from the original data in a separate image production sequence.

        Specified by:
        drawImage in class Graphics
        Parameters:
        img - the specified image to be drawn.
        x - the x coordinate.
        y - the y coordinate.
        width - the width of the rectangle.
        height - the height of the rectangle.
        observer - object to be notified as more of the image is converted.
        See Also:
        Image, ImageObserver, ImageObserver.imageUpdate(java.awt.Image, int, int, int, int, int)

      • dispose

        public void dispose()
        Disposes of this graphics context and releases any system resources that it is using. A Graphics object cannot be used after disposehas been called.

        When a Java program runs, a large number of Graphics objects can be created within a short time frame. Although the finalization process of the garbage collector also disposes of the same system resources, it is preferable to manually free the associated resources by calling this method rather than to rely on a finalization process which may not run to completion for a long period of time.

        Graphics objects which are provided as arguments to the paint and update methods of components are automatically released by the system when those methods return. For efficiency, programmers should call dispose when finished using a Graphics object only if it was created directly from a component or another Graphics object.

        Specified by:
        dispose in class Graphics
        See Also:
        Graphics.finalize(), Component.paint(java.awt.Graphics), Component.update(java.awt.Graphics), Component.getGraphics(), Graphics.create()

      • setXORMode

        public void setXORMode​(Color c1)
        Sets the paint mode of this graphics context to alternate between this graphics context's current color and the new specified color. This specifies that logical pixel operations are performed in the XOR mode, which alternates pixels between the current color and a specified XOR color.

        When drawing operations are performed, pixels which are the current color are changed to the specified color, and vice versa.

        Pixels that are of colors other than those two colors are changed in an unpredictable but reversible manner; if the same figure is drawn twice, then all pixels are restored to their original values.

        Specified by:
        setXORMode in class Graphics
        Parameters:
        c1 - the XOR alternation color

      • copyArea

        public void copyArea​(int x,
                     int y,
                     int width,
                     int height,
                     int dx,
                     int dy)
        Copies an area of the component by a distance specified by dx and dy. From the point specified by x and y, this method copies downwards and to the right. To copy an area of the component to the left or upwards, specify a negative value for dx or dy. If a portion of the source rectangle lies outside the bounds of the component, or is obscured by another window or component, copyArea will be unable to copy the associated pixels. The area that is omitted can be refreshed by calling the component's paint method.
        Specified by:
        copyArea in class Graphics
        Parameters:
        x - the x coordinate of the source rectangle.
        y - the y coordinate of the source rectangle.
        width - the width of the source rectangle.
        height - the height of the source rectangle.
        dx - the horizontal distance to copy the pixels.
        dy - the vertical distance to copy the pixels.