1 The classes for the Java2D(TM) demo are contained in the J2Ddemo.jar file.  
   2 To run the J2D demo:
   3 
   4 % java -jar J2Ddemo.jar
   5 
   6 -----------------------------------------------------------------------
   7 Introduction
   8 -----------------------------------------------------------------------
   9 
  10 This Java2D demo consists of a set of demos housed in one GUI 
  11 framework that uses a JTabbedPane.  You can access different groups of 
  12 demos by clicking the tabs at the top of the pane. There are demo 
  13 groups for Arcs_Curves, Clipping, Colors, Composite, Fonts, Images, 
  14 Lines, Mix, Paint, Paths and Transforms.  On the right-hand side of the 
  15 pane, the GUI framework features individual and global controls for 
  16 changing graphics attributes. There's also a memory-usage monitor, and 
  17 a monitor for tracking the performance, in frames per second, of 
  18 animation demos.
  19 
  20 
  21 -----------------------------------------------------------------------
  22 Tips on usage 
  23 ----------------------------------------------------------------------- 
  24 
  25 Click on one of the tabs at the top of the pane to select a demo group.  
  26 When you select a group, a set of surfaces is displayed, each of which 
  27 contains one of the group's demos. At the bottom of each surface is 
  28 a set of tools for controlling the demo.  The tools can be displayed
  29 by selecting the Tools checkbox in the Global Controls panel or
  30 by clicking on the slim strip of gray bumps at the bottom of the demo
  31 panel.
  32 
  33 If you click on a demo surface, that demo is laid out by itself. A
  34 new icon button will appear in the demo's tools toolbar one that enables 
  35 you to create new instances of that demo's surface. 
  36 
  37 To run the demo continuously without user interaction, select the 
  38 Run Window item in the Options menu and press the run button in the 
  39 new window that's displayed.  To do this from the command line:
  40 
  41     java -jar J2Ddemo.jar -runs=10
  42 
  43 To view all the command line options for customizing demo runs:
  44 
  45     java -jar J2Ddemo.jar -help
  46 
  47 You can run the demos in stand-alone mode by issuing a command like this
  48 
  49     java -cp J2Ddemo.jar java2d.demos.Clipping.ClipAnim
  50 
  51 You can run the demos in groups by issuing a command like this
  52 
  53     java -cp J2Ddemo.jar java2d.DemoGroup Clipping    
  54 
  55 To increase or decrease the Memory Monitor sampling rate click on the
  56 Memory Monitor's title border, a panel with a TextField will appear.
  57 
  58 The J2Ddemo Intro (the 'J2D demo' tab) contains a scene table, click in 
  59 the gray border and a table will appear.
  60 
  61 Animated demos have a slider to control the animation rate.  Bring up
  62 the animated demo toolbar, then click in the gray area of the toolbar
  63 panel, the toolbar goes away and the slider appears.
  64 
  65 Demos that have Custom Controls can have their Custom Control Thread
  66 activated and stopped by clicking in the gray area of the demos Custom 
  67 Control panel.
  68 
  69 -----------------------------------------------------------------------
  70 NOTE about demo surfaces 
  71 ----------------------------------------------------------------------- 
  72 
  73 The demo groups are in separate packages with their class files stored 
  74 in directories named according to the demo group name.  All drawing 
  75 demos extend either the Surface, AnimatingSurface, ControlsSurface or
  76 AnimatingControlsSurface classes.  Surface is the base class, demos
  77 must implement the Surface's render method.  All animated demos extend 
  78 either the AnimatingSurface or the AnimatingControlsSurface classes.  
  79 Animated demos must implement the reset and step methods.  The demos
  80 with gui controls extend either the ControlsSurface or the 
  81 AnimatingControlsSurface classes.  Demos with controls must implement
  82 the methods in the CustomControlsContext interface.
  83 
  84 
  85 ======================================================================
  86 
  87 Here are some resources for learning about and using the Java2D(TM)
  88 
  89 OpenJDK group page: http://openjdk.java.net/groups/2d/
  90 
  91 Learning Java 2D: http://www.oracle.com/technetwork/articles/java/java2dpart1-137217.html
  92 
  93 Tutorial : http://download.oracle.com/javase/tutorial/2d/
  94 Specification: http://download.oracle.com/javase/8/docs/technotes/guides/2d/spec/j2d-bookTOC.html
  95 Java 2D (TM) API White Paper : http://www.oracle.com/technetwork/java/javase/tech/2d-142228.html
  96 2D FAQ: http://www.oracle.com/technetwork/java/index-137037.html