home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Developer / resources / classes / ContourView.README < prev    next >
Encoding:
Text File  |  1992-12-03  |  2.8 KB  |  61 lines
  1. ContourView class (a subclass of View)
  2.      Contour Plot object with optional color fills.
  3.      OS requirement: Release 3.0 or later.
  4.      Version: V0.92 92-12-03
  5.      [Archive maintainer, please put this into Objects/Classes directory.]
  6.  
  7.     -------------------------------------------------------------------------------
  8.      Distinguishing features of this ContourView class are:
  9.      [1] It does color fills within contours just like colored geographical maps.
  10.      I am not aware of any other free source code that does this. (That's
  11.      why I had to write this.)
  12.      [2] It is a pretty self contained object in the form of a View subclass.
  13.      [3] PostScript may be copied onto pasteboard and pasted into other apps that
  14.      accept EPS date.  Try pasting it into Yap document.
  15.  
  16.      There is really no documentation.  Look at the class implementation file
  17.      ContourView.m and an example test application CVtestApp.m for usage
  18.      information.  The app included here is just for testing ContourView
  19.      class.  ContourView is meant to be included in your apps like any other
  20.      objects.
  21.  
  22.      It is pretty easy to use.  If instantiated within IB, all you need to do
  23.      to get a plot is to call the following two method to get a default
  24.      plot.  If you understand the following method, you can use the
  25.      ContourView object easily.
  26.  
  27.      - setCartesianGridData:(float *)f :(float)xmin :(float)xmax
  28.                   :(float)ymin :(float)ymax
  29.                   ofSize:(int)nx :(int)ny
  30.                   withInterpolationTo:(int)n1x :(int)n1y;
  31.  
  32.     f[nx*ny] is a 1-d array containing 2-d grid data such that f[iy*nx+ix]
  33.     contains the value at (ix, iy).
  34.     Typicall, just 3 messages below will produce a contour plot with color
  35.     fills.
  36.  
  37.     [contourView setCartesianGridData: fdata :1.0 :5.0 :1.0 :5.0
  38.                 ofSize: 20 :20
  39.                 withInterpolationTo: 50 :50];
  40.     [contourView setFillEnable:YES];
  41.     [contourView display];
  42.  
  43.     -------------------------------------------------------------------------------
  44.  
  45.     This can use a lot more optimizations which should speed up the drawing
  46.     significantly.  Some of these are:
  47.     [1] All parameter changes currently trigger recomputation of all contour paths,
  48.     because almost everything is done in drawSelf:: method.
  49.     This should not be necessary for some.  E.g., changing fill colors, line
  50.     width etc should not cause recomputation of contour paths.
  51.     [2] Use DoUserPath() etc to optimize drawing.
  52.     [3] Some methods are not yet implemented (It does what I wanted now).
  53.     -------------------------------------------------------------------------------
  54.     Send comments, bug reports, suggestions and improvements to below:
  55.  
  56. ---
  57. Izumi Ohzawa, Ph.D.            [ $@Bg_78^=;(J ]
  58. USMail: University of California, 360 Minor Hall, Berkeley, CA 94720
  59. Telephone: (510) 642-6440     Fax:  (510) 642-3323
  60. Internet: izumi@pinoko.berkeley.edu (NeXT Mail OK)
  61.