home *** CD-ROM | disk | FTP | other *** search
/ PC World 2001 March / PCWorld_2001-03_cd.bin / Software / Komercni / VAgeJava / ivj35 / setup / REP.Cab / F20557_README.txt < prev    next >
Text File  |  2000-07-30  |  4KB  |  113 lines
  1. To run the Java2D demo :
  2.  
  3. % java Java2Demo
  4.  - or -
  5. % appletviewer Java2Demo.html
  6.  
  7.  
  8. -----------------------------------------------------------------------
  9. Introduction
  10. -----------------------------------------------------------------------
  11.  
  12. This Java2D demo consists of a set of demos housed in one GUI 
  13. framework that uses a JTabbedPane.  You can access different groups of 
  14. demos by clicking the tabs at the top of the pane. There are demo 
  15. groups for Arcs_Curves, Clipping, Colors, Composite, Fonts, Images, 
  16. Lines, Mix, Paint, Paths and Transforms.  On the right-hand side of the 
  17. pane, the GUI framework features individual and global controls for 
  18. changing graphics attributes. There's also a memory-usage monitor, and 
  19. a monitor for tracking the performance, in frames per second, of 
  20. animation demos.
  21.  
  22.  
  23. -----------------------------------------------------------------------
  24. Tips on usage 
  25. ----------------------------------------------------------------------- 
  26.  
  27. Click on one of the tabs at the top of the pane to select a demo group.  
  28. When you select a group, a set of surfaces is displayed, each of which 
  29. contains one of the group's demos. At the bottom of each surface is 
  30. small toolbar for controlling the demo. 
  31.  
  32. If you click on a demo surface, that demo is laid out by itself. A
  33. new icon buttons will appear in the demo's toolbar one that enables you 
  34. to create new instances of that demo's surface. 
  35.  
  36. To run the demo continuously without user interaction, select the 
  37. Run Window item in the Options menu and press the run button in the 
  38. new window that's displayed.
  39.  
  40. Appletviewer and Hotjava throw security exceptions when attempting
  41. to print.  To print run the demo as a stand alone application.
  42.  
  43.  
  44. -----------------------------------------------------------------------
  45. NOTE about demo surfaces 
  46. ----------------------------------------------------------------------- 
  47.  
  48. The demo groups are in separate packages with their class files stored 
  49. in directories named according to the demo group name.  This makes it 
  50. possible for the demos to be loaded dynamically. All drawing demos extend 
  51. the DemoSurface abstract class and implement the DemoSurface's drawDemo 
  52. method.  All animated demos implement the AnimatingContext interface.
  53.  
  54. You can run the demos in stand-alone mode by issuing a command like 
  55. this from the Java2D directory:
  56.     
  57.     java demos.Clipping.ClipAnim
  58.  
  59. You can run the demos in groups by issuing a command like this from
  60. the Java2D directory:
  61.  
  62.     java DemoGroup Clipping
  63.  
  64. To recompile a demo, issue this command from the Java2D directory:
  65.  
  66. For win32 :
  67.  
  68.     javac demos\Clipping\ClipAnim.java -d .
  69.  
  70. For solaris :
  71.  
  72.     javac demos/Clipping/ClipAnim.java -d .
  73.  
  74.  
  75. You can change a demo into a Canvas instead of a DemoSurface by making 
  76. it extend Canvas rather than DemoSurface. You'll also need to change 
  77. drawDemo(int w, int h, Graphics2D g2) to paint(Graphics g), and declare and 
  78. intialize g2. For those demos that animate, the run(), start() and 
  79. stop() methods will be needed to handle the thread, and you should 
  80. create and draw into an off screen image for double buffering.  As an 
  81. example, the conversion for Curves.java (non-animated) would be:
  82.  
  83. public class Curves extends DemoSurface {
  84.     public void drawDemo(int w, int h, Graphics2D g2) {
  85.         ...
  86.     }
  87. }
  88.  
  89. Becomes :
  90.  
  91. public class Curves extends Canvas {
  92.     public void paint(Graphics g) {
  93.         Graphics2D g2 = (Graphics2D) g;
  94.     Dimension d = getSize();
  95.         ...
  96.     }
  97. }
  98.  
  99.  
  100. ======================================================================
  101.  
  102. For a Java2D API Overview & Tutorial :
  103.  
  104. http://java.sun.com/products/jdk/1.2/docs/guide/2d/spec/j2d-bookTOC.doc.html
  105.  
  106. For the latest version of the Java2D demo :
  107.  
  108. http://java.sun.com/products/java-media/2D/index.html
  109.  
  110. You may send comments via the java2d-comments@sun.com alias, 
  111. which is a one-way alias to Sun's Java 2D API developers, or via the
  112. java2d-interest@sun.com alias, which is a public discussion list. 
  113.