StdDraw

java.lang.Object
- princeton.introcs.StdDraw

All Implemented Interfaces:

ActionListener, KeyListener, MouseListener, MouseMotionListener, EventListener
```
public final class StdDraw
extends Object
implements ActionListener, MouseListener, MouseMotionListener, KeyListener
```
Standard draw. This class provides a basic capability for creating drawings with your programs. It uses a simple graphics model that allows you to create drawings consisting of points, lines, and curves in a window on your computer and to save the drawings to a file.
For additional documentation, see Section 1.5 of Introduction to Programming in Java: An Interdisciplinary Approach by Robert Sedgewick and Kevin Wayne.

Field Summary

Fields
Modifier and Type	Field and Description
`static Color`	`BLACK`
`static Color`	`BLUE`
`static Color`	`BOOK_BLUE` Shade of blue used in Introduction to Programming in Java.
`static Color`	`BOOK_LIGHT_BLUE`
`static Color`	`BOOK_RED` Shade of red used in Algorithms 4th edition.
`static Color`	`CYAN`
`static Color`	`DARK_GRAY`
`static Color`	`GRAY`
`static Color`	`GREEN`
`static Color`	`LIGHT_GRAY`
`static Color`	`MAGENTA`
`static Color`	`ORANGE`
`static Color`	`PINK`
`static Color`	`RED`
`static Color`	`WHITE`
`static Color`	`YELLOW`

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`actionPerformed(ActionEvent e)` This method cannot be called directly.
`static void`	`arc(double x, double y, double r, double angle1, double angle2)` Draw an arc of radius r, centered on (x, y), from angle1 to angle2 (in degrees).
`static void`	`circle(double x, double y, double r)` Draw a circle of radius r, centered on (x, y).
`static void`	`clear()` Clear the screen to the default color (white).
`static void`	`clear(Color color)` Clear the screen to the given color.
`static void`	`ellipse(double x, double y, double semiMajorAxis, double semiMinorAxis)` Draw an ellipse with given semimajor and semiminor axes, centered on (x, y).
`static void`	`filledCircle(double x, double y, double r)` Draw filled circle of radius r, centered on (x, y).
`static void`	`filledEllipse(double x, double y, double semiMajorAxis, double semiMinorAxis)` Draw an ellipse with given semimajor and semiminor axes, centered on (x, y).
`static void`	`filledPolygon(double[] x, double[] y)` Draw a filled polygon with the given (x[i], y[i]) coordinates.
`static void`	`filledRectangle(double x, double y, double halfWidth, double halfHeight)` Draw a filled rectangle of given half width and half height, centered on (x, y).
`static void`	`filledSquare(double x, double y, double r)` Draw a filled square of side length 2r, centered on (x, y).
`static Font`	`getFont()` Get the current font.
`static Color`	`getPenColor()` Get the current pen color.
`static double`	`getPenRadius()` Get the current pen radius.
`static boolean`	`hasNextKeyTyped()` Has the user typed a key?
`static boolean`	`isKeyPressed(int keycode)` Is the keycode currently being pressed? This method takes as an argument the keycode (corresponding to a physical key).
`void`	`keyPressed(KeyEvent e)` This method cannot be called directly.
`void`	`keyReleased(KeyEvent e)` This method cannot be called directly.
`void`	`keyTyped(KeyEvent e)` This method cannot be called directly.
`static void`	`line(double x0, double y0, double x1, double y1)` Draw a line from (x0, y0) to (x1, y1).
`static void`	`main(String[] args)` Test client.
`void`	`mouseClicked(MouseEvent e)` This method cannot be called directly.
`void`	`mouseDragged(MouseEvent e)` This method cannot be called directly.
`void`	`mouseEntered(MouseEvent e)` This method cannot be called directly.
`void`	`mouseExited(MouseEvent e)` This method cannot be called directly.
`void`	`mouseMoved(MouseEvent e)` This method cannot be called directly.
`static boolean`	`mousePressed()` Is the mouse being pressed?
`void`	`mousePressed(MouseEvent e)` This method cannot be called directly.
`void`	`mouseReleased(MouseEvent e)` This method cannot be called directly.
`static double`	`mouseX()` What is the x-coordinate of the mouse?
`static double`	`mouseY()` What is the y-coordinate of the mouse?
`static char`	`nextKeyTyped()` What is the next key that was typed by the user? This method returns a Unicode character corresponding to the key typed (such as 'a' or 'A').
`static void`	`picture(double x, double y, String s)` Draw picture (gif, jpg, or png) centered on (x, y).
`static void`	`picture(double x, double y, String s, double degrees)` Draw picture (gif, jpg, or png) centered on (x, y), rotated given number of degrees
`static void`	`picture(double x, double y, String s, double w, double h)` Draw picture (gif, jpg, or png) centered on (x, y), rescaled to w-by-h.
`static void`	`picture(double x, double y, String s, double w, double h, double degrees)` Draw picture (gif, jpg, or png) centered on (x, y), rotated given number of degrees, rescaled to w-by-h.
`static void`	`point(double x, double y)` Draw a point at (x, y).
`static void`	`polygon(double[] x, double[] y)` Draw a polygon with the given (x[i], y[i]) coordinates.
`static void`	`rectangle(double x, double y, double halfWidth, double halfHeight)` Draw a rectangle of given half width and half height, centered on (x, y).
`static void`	`save(String filename)` Save to file - suffix must be png, jpg, or gif.
`static void`	`setCanvasSize()` Set the window size to the default size 512-by-512 pixels.
`static void`	`setCanvasSize(int w, int h)` Set the window size to w-by-h pixels.
`static void`	`setFont()` Set the font to the default font (sans serif, 16 point).
`static void`	`setFont(Font f)` Set the font to the given value.
`static void`	`setPenColor()` Set the pen color to the default color (black).
`static void`	`setPenColor(Color color)` Set the pen color to the given color.
`static void`	`setPenRadius()` Set the pen size to the default (.002).
`static void`	`setPenRadius(double r)` Set the radius of the pen to the given size.
`static void`	`setScale(double min, double max)` Set the x-scale and y-scale (a 10% border is added to the values)
`static void`	`setXscale()` Set the x-scale to be the default (between 0.0 and 1.0).
`static void`	`setXscale(double min, double max)` Set the x-scale (a 10% border is added to the values)
`static void`	`setYscale()` Set the y-scale to be the default (between 0.0 and 1.0).
`static void`	`setYscale(double min, double max)` Set the y-scale (a 10% border is added to the values).
`static void`	`show()` Display on-screen and turn off animation mode: subsequent calls to drawing methods such as `line()`, `circle()`, and `square()` will be displayed on screen when called.
`static void`	`show(int t)` Display on screen, pause for t milliseconds, and turn on animation mode: subsequent calls to drawing methods such as `line()`, `circle()`, and `square()` will not be displayed on screen until the next call to `show()`.
`static void`	`square(double x, double y, double r)` Draw a square of side length 2r, centered on (x, y).
`static void`	`text(double x, double y, String s)` Write the given text string in the current font, centered on (x, y).
`static void`	`text(double x, double y, String s, double degrees)` Write the given text string in the current font, centered on (x, y) and rotated by the specified number of degrees
`static void`	`textLeft(double x, double y, String s)` Write the given text string in the current font, left-aligned at (x, y).
`static void`	`textRight(double x, double y, String s)` Write the given text string in the current font, right-aligned at (x, y).

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - BLACK
```
public static final Color BLACK
```
  - BLUE
```
public static final Color BLUE
```
  - CYAN
```
public static final Color CYAN
```
  - DARK_GRAY
```
public static final Color DARK_GRAY
```
  - GRAY
```
public static final Color GRAY
```
  - GREEN
```
public static final Color GREEN
```
  - LIGHT_GRAY
```
public static final Color LIGHT_GRAY
```
  - MAGENTA
```
public static final Color MAGENTA
```
  - ORANGE
```
public static final Color ORANGE
```
  - PINK
```
public static final Color PINK
```
  - RED
```
public static final Color RED
```
  - WHITE
```
public static final Color WHITE
```
  - YELLOW
```
public static final Color YELLOW
```
  - BOOK_BLUE
```
public static final Color BOOK_BLUE
```
    Shade of blue used in Introduction to Programming in Java. It is Pantone 300U. The RGB values are approximately (9, 90, 266).
  - BOOK_LIGHT_BLUE
```
public static final Color BOOK_LIGHT_BLUE
```
  - BOOK_RED
```
public static final Color BOOK_RED
```
    Shade of red used in Algorithms 4th edition. It is Pantone 1805U. The RGB values are approximately (150, 35, 31).
- Method Detail
  - setCanvasSize
```
public static void setCanvasSize()
```
    Set the window size to the default size 512-by-512 pixels.
  - setCanvasSize
```
public static void setCanvasSize(int w,
                 int h)
```
    Set the window size to w-by-h pixels.
    
    Parameters:
    w - the width as a number of pixels
    h - the height as a number of pixels
    
    Throws:
    
    a - RunTimeException if the width or height is 0 or negative
  - setXscale
```
public static void setXscale()
```
    Set the x-scale to be the default (between 0.0 and 1.0).
  - setYscale
```
public static void setYscale()
```
    Set the y-scale to be the default (between 0.0 and 1.0).
  - setXscale
```
public static void setXscale(double min,
             double max)
```
    Set the x-scale (a 10% border is added to the values)
    
    Parameters:
    min - the minimum value of the x-scale
    max - the maximum value of the x-scale
  - setYscale
```
public static void setYscale(double min,
             double max)
```
    Set the y-scale (a 10% border is added to the values).
    
    Parameters:
    min - the minimum value of the y-scale
    max - the maximum value of the y-scale
  - setScale
```
public static void setScale(double min,
            double max)
```
    Set the x-scale and y-scale (a 10% border is added to the values)
    
    Parameters:
    min - the minimum value of the x- and y-scales
    max - the maximum value of the x- and y-scales
  - clear
```
public static void clear()
```
    Clear the screen to the default color (white).
  - clear
```
public static void clear(Color color)
```
    Clear the screen to the given color.
    
    Parameters:
    color - the Color to make the background
  - getPenRadius
```
public static double getPenRadius()
```
    Get the current pen radius.
  - setPenRadius
```
public static void setPenRadius()
```
    Set the pen size to the default (.002).
  - setPenRadius
```
public static void setPenRadius(double r)
```
    Set the radius of the pen to the given size.
    
    Parameters:
    r - the radius of the pen
    
    Throws:
    
    RuntimeException - if r is negative
  - getPenColor
```
public static Color getPenColor()
```
    Get the current pen color.
  - setPenColor
```
public static void setPenColor()
```
    Set the pen color to the default color (black).
  - setPenColor
```
public static void setPenColor(Color color)
```
    Set the pen color to the given color. The available pen colors are BLACK, BLUE, CYAN, DARK_GRAY, GRAY, GREEN, LIGHT_GRAY, MAGENTA, ORANGE, PINK, RED, WHITE, and YELLOW.
    
    Parameters:
    color - the Color to make the pen
  - getFont
```
public static Font getFont()
```
    Get the current font.
  - setFont
```
public static void setFont()
```
    Set the font to the default font (sans serif, 16 point).
  - setFont
```
public static void setFont(Font f)
```
    Set the font to the given value.
    
    Parameters:
    f - the font to make text
  - line
```
public static void line(double x0,
        double y0,
        double x1,
        double y1)
```
    Draw a line from (x0, y0) to (x1, y1).
    
    Parameters:
    x0 - the x-coordinate of the starting point
    y0 - the y-coordinate of the starting point
    x1 - the x-coordinate of the destination point
    y1 - the y-coordinate of the destination point
  - point
```
public static void point(double x,
         double y)
```
    Draw a point at (x, y).
    
    Parameters:
    x - the x-coordinate of the point
    y - the y-coordinate of the point
  - circle
```
public static void circle(double x,
          double y,
          double r)
```
    Draw a circle of radius r, centered on (x, y).
    
    Parameters:
    x - the x-coordinate of the center of the circle
    y - the y-coordinate of the center of the circle
    r - the radius of the circle
    
    Throws:
    
    RuntimeException - if the radius of the circle is negative
  - filledCircle
```
public static void filledCircle(double x,
                double y,
                double r)
```
    Draw filled circle of radius r, centered on (x, y).
    
    Parameters:
    x - the x-coordinate of the center of the circle
    y - the y-coordinate of the center of the circle
    r - the radius of the circle
    
    Throws:
    
    RuntimeException - if the radius of the circle is negative
  - ellipse
```
public static void ellipse(double x,
           double y,
           double semiMajorAxis,
           double semiMinorAxis)
```
    Draw an ellipse with given semimajor and semiminor axes, centered on (x, y).
    
    Parameters:
    x - the x-coordinate of the center of the ellipse
    y - the y-coordinate of the center of the ellipse
    semiMajorAxis - is the semimajor axis of the ellipse
    semiMinorAxis - is the semiminor axis of the ellipse
    
    Throws:
    
    RuntimeException - if either of the axes are negative
  - filledEllipse
```
public static void filledEllipse(double x,
                 double y,
                 double semiMajorAxis,
                 double semiMinorAxis)
```
    Draw an ellipse with given semimajor and semiminor axes, centered on (x, y).
    
    Parameters:
    x - the x-coordinate of the center of the ellipse
    y - the y-coordinate of the center of the ellipse
    semiMajorAxis - is the semimajor axis of the ellipse
    semiMinorAxis - is the semiminor axis of the ellipse
    
    Throws:
    
    RuntimeException - if either of the axes are negative
  - arc
```
public static void arc(double x,
       double y,
       double r,
       double angle1,
       double angle2)
```
    Draw an arc of radius r, centered on (x, y), from angle1 to angle2 (in degrees).
    
    Parameters:
    x - the x-coordinate of the center of the circle
    y - the y-coordinate of the center of the circle
    r - the radius of the circle
    angle1 - the starting angle. 0 would mean an arc beginning at 3 o'clock.
    angle2 - the angle at the end of the arc. For example, if you want a 90 degree arc, then angle2 should be angle1 + 90.
    
    Throws:
    
    RuntimeException - if the radius of the circle is negative
  - square
```
public static void square(double x,
          double y,
          double r)
```
    Draw a square of side length 2r, centered on (x, y).
    
    Parameters:
    x - the x-coordinate of the center of the square
    y - the y-coordinate of the center of the square
    r - radius is half the length of any side of the square
    
    Throws:
    
    RuntimeException - if r is negative
  - filledSquare
```
public static void filledSquare(double x,
                double y,
                double r)
```
    Draw a filled square of side length 2r, centered on (x, y).
    
    Parameters:
    x - the x-coordinate of the center of the square
    y - the y-coordinate of the center of the square
    r - radius is half the length of any side of the square
    
    Throws:
    
    RuntimeException - if r is negative
  - rectangle
```
public static void rectangle(double x,
             double y,
             double halfWidth,
             double halfHeight)
```
    Draw a rectangle of given half width and half height, centered on (x, y).
    
    Parameters:
    x - the x-coordinate of the center of the rectangle
    y - the y-coordinate of the center of the rectangle
    halfWidth - is half the width of the rectangle
    halfHeight - is half the height of the rectangle
    
    Throws:
    
    RuntimeException - if halfWidth or halfHeight is negative
  - filledRectangle
```
public static void filledRectangle(double x,
                   double y,
                   double halfWidth,
                   double halfHeight)
```
    Draw a filled rectangle of given half width and half height, centered on (x, y).
    
    Parameters:
    x - the x-coordinate of the center of the rectangle
    y - the y-coordinate of the center of the rectangle
    halfWidth - is half the width of the rectangle
    halfHeight - is half the height of the rectangle
    
    Throws:
    
    RuntimeException - if halfWidth or halfHeight is negative
  - polygon
```
public static void polygon(double[] x,
           double[] y)
```
    Draw a polygon with the given (x[i], y[i]) coordinates.
    
    Parameters:
    x - an array of all the x-coordindates of the polygon
    y - an array of all the y-coordindates of the polygon
  - filledPolygon
```
public static void filledPolygon(double[] x,
                 double[] y)
```
    Draw a filled polygon with the given (x[i], y[i]) coordinates.
    
    Parameters:
    x - an array of all the x-coordindates of the polygon
    y - an array of all the y-coordindates of the polygon
  - picture
```
public static void picture(double x,
           double y,
           String s)
```
    Draw picture (gif, jpg, or png) centered on (x, y).
    
    Parameters:
    x - the center x-coordinate of the image
    y - the center y-coordinate of the image
    s - the name of the image/picture, e.g., "ball.gif"
    
    Throws:
    
    RuntimeException - if the image is corrupt
  - picture
```
public static void picture(double x,
           double y,
           String s,
           double degrees)
```
    Draw picture (gif, jpg, or png) centered on (x, y), rotated given number of degrees
    
    Parameters:
    x - the center x-coordinate of the image
    y - the center y-coordinate of the image
    s - the name of the image/picture, e.g., "ball.gif"
    degrees - is the number of degrees to rotate counterclockwise
    
    Throws:
    
    RuntimeException - if the image is corrupt
  - picture
```
public static void picture(double x,
           double y,
           String s,
           double w,
           double h)
```
    Draw picture (gif, jpg, or png) centered on (x, y), rescaled to w-by-h.
    
    Parameters:
    x - the center x coordinate of the image
    y - the center y coordinate of the image
    s - the name of the image/picture, e.g., "ball.gif"
    w - the width of the image
    h - the height of the image
    
    Throws:
    
    RuntimeException - if the width height are negative
    
    RuntimeException - if the image is corrupt
  - picture
```
public static void picture(double x,
           double y,
           String s,
           double w,
           double h,
           double degrees)
```
    Draw picture (gif, jpg, or png) centered on (x, y), rotated given number of degrees, rescaled to w-by-h.
    
    Parameters:
    x - the center x-coordinate of the image
    y - the center y-coordinate of the image
    s - the name of the image/picture, e.g., "ball.gif"
    w - the width of the image
    h - the height of the image
    degrees - is the number of degrees to rotate counterclockwise
    
    Throws:
    
    RuntimeException - if the image is corrupt
  - text
```
public static void text(double x,
        double y,
        String s)
```
    Write the given text string in the current font, centered on (x, y).
    
    Parameters:
    x - the center x-coordinate of the text
    y - the center y-coordinate of the text
    s - the text
  - text
```
public static void text(double x,
        double y,
        String s,
        double degrees)
```
    Write the given text string in the current font, centered on (x, y) and rotated by the specified number of degrees
    
    Parameters:
    x - the center x-coordinate of the text
    y - the center y-coordinate of the text
    s - the text
    degrees - is the number of degrees to rotate counterclockwise
  - textLeft
```
public static void textLeft(double x,
            double y,
            String s)
```
    Write the given text string in the current font, left-aligned at (x, y).
    
    Parameters:
    x - the x-coordinate of the text
    y - the y-coordinate of the text
    s - the text
  - textRight
```
public static void textRight(double x,
             double y,
             String s)
```
    Write the given text string in the current font, right-aligned at (x, y).
    
    Parameters:
    x - the x-coordinate of the text
    y - the y-coordinate of the text
    s - the text
  - show
```
public static void show(int t)
```
    Display on screen, pause for t milliseconds, and turn on animation mode: subsequent calls to drawing methods such as line(), circle(), and square() will not be displayed on screen until the next call to show(). This is useful for producing animations (clear the screen, draw a bunch of shapes, display on screen for a fixed amount of time, and repeat). It also speeds up drawing a huge number of shapes (call show(0) to defer drawing on screen, draw the shapes, and call show(0) to display them all on screen at once).
    
    Parameters:
    t - number of milliseconds
  - show
```
public static void show()
```
    Display on-screen and turn off animation mode: subsequent calls to drawing methods such as line(), circle(), and square() will be displayed on screen when called. This is the default.
  - save
```
public static void save(String filename)
```
    Save to file - suffix must be png, jpg, or gif.
    
    Parameters:
    filename - the name of the file with one of the required suffixes
  - actionPerformed
```
public void actionPerformed(ActionEvent e)
```
    This method cannot be called directly.
    
    Specified by:
    
    actionPerformed in interface ActionListener
  - mousePressed
```
public static boolean mousePressed()
```
    Is the mouse being pressed?
    
    Returns:
    true or false
  - mouseX
```
public static double mouseX()
```
    What is the x-coordinate of the mouse?
    
    Returns:
    the value of the x-coordinate of the mouse
  - mouseY
```
public static double mouseY()
```
    What is the y-coordinate of the mouse?
    
    Returns:
    the value of the y-coordinate of the mouse
  - mouseClicked
```
public void mouseClicked(MouseEvent e)
```
    This method cannot be called directly.
    
    Specified by:
    
    mouseClicked in interface MouseListener
  - mouseEntered
```
public void mouseEntered(MouseEvent e)
```
    This method cannot be called directly.
    
    Specified by:
    
    mouseEntered in interface MouseListener
  - mouseExited
```
public void mouseExited(MouseEvent e)
```
    This method cannot be called directly.
    
    Specified by:
    
    mouseExited in interface MouseListener
  - mousePressed
```
public void mousePressed(MouseEvent e)
```
    This method cannot be called directly.
    
    Specified by:
    
    mousePressed in interface MouseListener
  - mouseReleased
```
public void mouseReleased(MouseEvent e)
```
    This method cannot be called directly.
    
    Specified by:
    
    mouseReleased in interface MouseListener
  - mouseDragged
```
public void mouseDragged(MouseEvent e)
```
    This method cannot be called directly.
    
    Specified by:
    
    mouseDragged in interface MouseMotionListener
  - mouseMoved
```
public void mouseMoved(MouseEvent e)
```
    This method cannot be called directly.
    
    Specified by:
    
    mouseMoved in interface MouseMotionListener
  - hasNextKeyTyped
```
public static boolean hasNextKeyTyped()
```
    Has the user typed a key?
    
    Returns:
    true if the user has typed a key, false otherwise
  - nextKeyTyped
```
public static char nextKeyTyped()
```
    What is the next key that was typed by the user? This method returns a Unicode character corresponding to the key typed (such as 'a' or 'A'). It cannot identify action keys (such as F1 and arrow keys) or modifier keys (such as control).
    
    Returns:
    the next Unicode key typed
  - isKeyPressed
```
public static boolean isKeyPressed(int keycode)
```
    Is the keycode currently being pressed? This method takes as an argument the keycode (corresponding to a physical key). It can handle action keys (such as F1 and arrow keys) and modifier keys (such as shift and control). See KeyEvent.java for a description of key codes.
    
    Returns:
    true if keycode is currently being pressed, false otherwise
  - keyTyped
```
public void keyTyped(KeyEvent e)
```
    This method cannot be called directly.
    
    Specified by:
    
    keyTyped in interface KeyListener
  - keyPressed
```
public void keyPressed(KeyEvent e)
```
    This method cannot be called directly.
    
    Specified by:
    
    keyPressed in interface KeyListener
  - keyReleased
```
public void keyReleased(KeyEvent e)
```
    This method cannot be called directly.
    
    Specified by:
    
    keyReleased in interface KeyListener
  - main
```
public static void main(String[] args)
```
    Test client.

Class StdDraw

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

BLACK

BLUE

CYAN

DARK_GRAY

GRAY

GREEN

LIGHT_GRAY

MAGENTA

ORANGE

PINK

RED

WHITE

YELLOW

BOOK_BLUE

BOOK_LIGHT_BLUE

BOOK_RED

Method Detail

setCanvasSize

setCanvasSize

setXscale

setYscale

setXscale

setYscale

setScale

clear

clear

getPenRadius

setPenRadius

setPenRadius

getPenColor

setPenColor

setPenColor

getFont

setFont

setFont

line

point

circle

filledCircle

ellipse

filledEllipse

arc

square

filledSquare

rectangle

filledRectangle

polygon

filledPolygon

picture

picture

picture

picture

text

text

textLeft

textRight

show

show

save

actionPerformed

mousePressed

mouseX

mouseY

mouseClicked

mouseEntered

mouseExited

mousePressed

mouseReleased

mouseDragged

mouseMoved

hasNextKeyTyped

nextKeyTyped

isKeyPressed

keyTyped

keyPressed