org.apache.batik.ext.awt.g2d.DefaultGraphics2D Maven / Gradle / Ivy
/*
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
package org.apache.batik.ext.awt.g2d;
import java.awt.Color;
import java.awt.Font;
import java.awt.FontMetrics;
import java.awt.Graphics;
import java.awt.Graphics2D;
import java.awt.GraphicsConfiguration;
import java.awt.Image;
import java.awt.Shape;
import java.awt.geom.AffineTransform;
import java.awt.image.BufferedImage;
import java.awt.image.ImageObserver;
import java.awt.image.RenderedImage;
import java.awt.image.renderable.RenderableImage;
import java.text.AttributedCharacterIterator;
/**
* 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.
*
* @author Vincent Hardy
* @version $Id: DefaultGraphics2D.java 1733416 2016-03-03 07:07:13Z gadams $
* @see org.apache.batik.ext.awt.g2d.AbstractGraphics2D
*/
public class DefaultGraphics2D extends AbstractGraphics2D {
/**
* Default constructor
*/
public DefaultGraphics2D(boolean textAsShapes){
super(textAsShapes);
}
/**
* This constructor supports the create method
*/
public DefaultGraphics2D(DefaultGraphics2D g){
super(g);
}
/**
* Creates a new Graphics
object that is
* a copy of this Graphics
object.
* @return a new graphics context that is a copy of
* this graphics context.
*/
public Graphics create(){
return new DefaultGraphics2D(this);
}
/**
* 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.
* @param img the specified image to be drawn.
* @param x the x coordinate.
* @param y the y coordinate.
* @param observer object to be notified as more of
* the image is converted.
* @see java.awt.Image
* @see java.awt.image.ImageObserver
* @see java.awt.image.ImageObserver#imageUpdate(java.awt.Image, int, int, int, int, int)
*/
public boolean drawImage(Image img, int x, int y, ImageObserver observer){
System.err.println("drawImage");
return true;
}
/**
* 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.
* @param img the specified image to be drawn.
* @param x the x coordinate.
* @param y the y coordinate.
* @param width the width of the rectangle.
* @param height the height of the rectangle.
* @param observer object to be notified as more of
* the image is converted.
* @see java.awt.Image
* @see java.awt.image.ImageObserver
* @see java.awt.image.ImageObserver#imageUpdate(java.awt.Image, int, int, int, int, int)
*/
public boolean drawImage(Image img, int x, int y,
int width, int height,
ImageObserver observer) {
System.out.println("drawImage");
return true;
}
/**
* Disposes of this graphics context and releases
* any system resources that it is using.
* A Graphics
object cannot be used after
* dispose
has 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.
* @see java.awt.Graphics#finalize
* @see java.awt.Component#paint
* @see java.awt.Component#update
* @see java.awt.Component#getGraphics
* @see java.awt.Graphics#create()
*/
public void dispose(){
System.out.println("dispose");
}
/**
* Strokes the outline of a Shape
using the settings of the
* current Graphics2D
context. The rendering attributes
* applied include the Clip
, Transform
,
* Paint
, Composite
and
* Stroke
attributes.
* @param s the Shape
to be rendered
* @see #setStroke(java.awt.Stroke)
* @see #setPaint(java.awt.Paint)
* @see java.awt.Graphics#setColor
* @see #setTransform(AffineTransform)
* @see #setClip(Shape)
* @see #setComposite(java.awt.Composite)
*/
public void draw(Shape s){
System.out.println("draw(Shape)");
}
/**
* Renders a {@link RenderedImage},
* applying a transform from image
* space into user space before drawing.
* The transformation from user space into device space is done with
* the current Transform
in the Graphics2D
.
* The specified transformation is applied to the image before the
* transform attribute in the Graphics2D
context is applied.
* The rendering attributes applied include the Clip
,
* Transform
, and Composite
attributes. Note
* that no rendering is done if the specified transform is
* noninvertible.
* @param img the image to be rendered
* @param xform the transformation from image space into user space
* @see #setTransform(AffineTransform)
* @see #setComposite(java.awt.Composite)
* @see #setClip(Shape)
*/
public void drawRenderedImage(RenderedImage img,
AffineTransform xform) {
System.out.println("drawRenderedImage");
}
/**
* Renders a
* {@link RenderableImage},
* applying a transform from image space into user space before drawing.
* The transformation from user space into device space is done with
* the current Transform
in the Graphics2D
.
* The specified transformation is applied to the image before the
* transform attribute in the Graphics2D
context is applied.
* The rendering attributes applied include the Clip
,
* Transform
, and Composite
attributes. Note
* that no rendering is done if the specified transform is
* noninvertible.
*
* Rendering hints set on the Graphics2D
object might
* be used in rendering the RenderableImage
.
* If explicit control is required over specific hints recognized by a
* specific RenderableImage
, or if knowledge of which hints
* are used is required, then a RenderedImage
should be
* obtained directly from the RenderableImage
* and rendered using
*{@link #drawRenderedImage(RenderedImage, AffineTransform) drawRenderedImage}.
* @param img the image to be rendered
* @param xform the transformation from image space into user space
* @see #setTransform(AffineTransform)
* @see #setComposite(java.awt.Composite)
* @see #setClip(Shape)
* @see #drawRenderedImage
*/
public void drawRenderableImage(RenderableImage img,
AffineTransform xform){
System.out.println("drawRenderableImage");
}
/**
* Renders the text specified by the specified String
,
* using the current Font
and Paint
attributes
* in the Graphics2D
context.
* The baseline of the first character is at position
* (x, y) in the User Space.
* The rendering attributes applied include the Clip
,
* Transform
, Paint
, Font
and
* Composite
attributes. For characters in script systems
* such as Hebrew and Arabic, the glyphs can be rendered from right to
* left, in which case the coordinate supplied is the location of the
* leftmost character on the baseline.
* @param s the String
to be rendered
* @param x the x coordinate where the String
should be
* rendered
* @param y the y coordinate where the String
should be
* rendered
* @see #setPaint(java.awt.Paint)
* @see java.awt.Graphics#setColor
* @see java.awt.Graphics#setFont
* @see #setTransform(AffineTransform)
* @see #setComposite(java.awt.Composite)
* @see #setClip(Shape)
*/
public void drawString(String s, float x, float y){
System.out.println("drawString(String)");
}
/**
* Renders the text of the specified iterator, using the
* Graphics2D
context's current Paint
. The
* iterator must specify a font
* for each character. The baseline of the
* first character is at position (x, y) in the
* User Space.
* The rendering attributes applied include the Clip
,
* Transform
, Paint
, and
* Composite
attributes.
* For characters in script systems such as Hebrew and Arabic,
* the glyphs can be rendered from right to left, in which case the
* coordinate supplied is the location of the leftmost character
* on the baseline.
* @param iterator the iterator whose text is to be rendered
* @param x the x coordinate where the iterator's text is to be rendered
* @param y the y coordinate where the iterator's text is to be rendered
* @see #setPaint(java.awt.Paint)
* @see java.awt.Graphics#setColor
* @see #setTransform(AffineTransform)
* @see #setComposite(java.awt.Composite)
* @see #setClip(Shape)
*/
public void drawString(AttributedCharacterIterator iterator,
float x, float y) {
System.err.println("drawString(AttributedCharacterIterator)");
}
/**
* Fills the interior of a Shape
using the settings of the
* Graphics2D
context. The rendering attributes applied
* include the Clip
, Transform
,
* Paint
, and Composite
.
* @param s the Shape
to be filled
* @see #setPaint(java.awt.Paint)
* @see java.awt.Graphics#setColor
* @see #setTransform(AffineTransform)
* @see #setComposite(java.awt.Composite)
* @see #setClip(Shape)
*/
public void fill(Shape s){
System.err.println("fill");
}
/**
* Returns the device configuration associated with this
* Graphics2D
.
*/
public GraphicsConfiguration getDeviceConfiguration(){
System.out.println("getDeviceConfiguration");
return null;
}
/**
* Used to create proper font metrics
*/
private Graphics2D fmg;
{
BufferedImage bi
= new BufferedImage(1, 1, BufferedImage.TYPE_INT_ARGB);
fmg = bi.createGraphics();
}
/**
* Gets the font metrics for the specified font.
* @return the font metrics for the specified font.
* @param f the specified font
* @see java.awt.Graphics#getFont
* @see java.awt.FontMetrics
* @see java.awt.Graphics#getFontMetrics()
*/
public FontMetrics getFontMetrics(Font f){
return fmg.getFontMetrics(f);
}
/**
* 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.
* @param c1 the XOR alternation color
*/
public void setXORMode(Color c1){
System.out.println("setXORMode");
}
/**
* 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.
* @param x the x coordinate of the source rectangle.
* @param y the y coordinate of the source rectangle.
* @param width the width of the source rectangle.
* @param height the height of the source rectangle.
* @param dx the horizontal distance to copy the pixels.
* @param dy the vertical distance to copy the pixels.
*/
public void copyArea(int x, int y, int width, int height,
int dx, int dy){
System.out.println("copyArea");
}
}