source: ether_statistics/service/implementation/gov/noaa/pmel/sgt/RELEASE-NOTES-3.0.txt @ 569

Last change on this file since 569 was 569, checked in by vmipsl, 12 years ago

Nouveau projet
File size: 11.9 KB
Line 
1            Scientific Graphics Toolkit (sgt) Version 3.0
2                      SGT Beans Initial Release
3                            Release Notes
4
5$Id: RELEASE-NOTES-3.0.txt,v 1.4 2003/09/19 23:14:24 dwd Exp $
6
7Introduction:
8-------------
9
10This document describes the changes in the Scientific Graphics Toolkit
11from version 2.1 to 3.0 and introduces the first release of SGT Beans.
12
13Bug reports, comments, and suggestions can be sent to
14Donald.W.Denbo@noaa.gov, sgt@epic.noaa.gov or preferrably reported
15using the Mantis system at http://heron.pmel.noaa.gov:8082/mantis.
16
17New Features:
18-------------
19
20The biggest new feature is the initial delivery of SGT Beans. The
21three main beans Page, PanelModel, and DataModel can be used to
22produce graphics more easily. These beans also enable a user to more
23easily change the layout of existing graphics. [I will be making a
24tutorial available in about 2 months.]
25
26New classes have been added to support graphical annotation.  And a
27new GeoDateArray class has been added to improve performance.
28
29Bug Fixes:
30----------
31
32To many to list.  The major fixes include using repaint() internally
33to make the drawing more robust. Problems with placing multiple JPanes
34in a single JFrame have been addressed and printing has been updated
35to work after the above bug fixes :-). 
36
37Known Existing Problems:
38------------------------
39
40SGT Beans require jdk 1.4.  This requirement is because I use
41XMLEncoder to serialize SGT Beans.
42
43The JRealTimeDemo demonstrates a problem that occurs when SGT is
44forced to redraw too rapidly.  On Solaris, the JPanel goes blank until
45the repainting is done.
46
47Printing SGT Beans with titled borders cause the graphic to be shifted
48down but not rescaled.  The result is the border overplot on the
49graphic.
50
51The Page SGT Bean doesn't account for the extra space a pixel
52rendering requires, causing the pixels to overlap the axes.
53
54Future Features:
55---------------
56
57Presently SGT Beans don't use a LayoutManager to position Panels on
58the Page.  I will be developing the interface and visual customization
59classes necessary to support SpringLayout. Eventually :-(.
60
61Deprecated Classes:
62------------------
63
64The following classes are now deprecated and will be removed at some
65future sgt release.
66
67gov.noaa.pmel.sgt.Pane -- use gov.noaa.pmel.sgt.JPane
68gov.noaa.pmel.sgt.swing.JLineProfileLayout -- use gov.noaa.pmel.sgt.swing.JPlotLayout
69
70in gov.noaa.pmel.util:
71
72SoTRange.GeoDate -- use SoTRange.Time
73SoTValue.GeoDate -- use SoTValue.Time
74TimePoint -- use SoTPoint
75TimeRange -- use SoTRange
76
77New Packages:
78-------------
79
80gov.noaa.pmel.sgt.beans
81
82New Classes:
83------------
84For details see the JavaDoc.
85
86gov.noaa.pmel.sgt
87        AnnotationCartesianRenderer
88        AttributeChangeEvent
89        DataKey
90        LayerControl
91        NegativeLogException
92
93gov.noaa.pmel.sgt.demo
94        JLogLogDemo
95        BeanDemo
96
97gov.noaa.pmel.sgt.dm
98        Annotation
99        Annote
100        SGT3DVector
101
102gov.noaa.pmel.sgt.swing.prop
103        ColorDialog
104        ColorEntryPanel
105        RulerDialog
106
107gov.noaa.pmel.swing
108        FocusableSwatch
109        MRJUtil
110        Swatch
111        SwatchGroup
112        ThreeDotsButton
113        ThreeDotsIcon
114
115gov.noaa.pmel.util
116        EPICSystem
117        GeoDateArray
118        SimpleFileFilter
119
120New Methods and Constructors:
121-----------------------------
122For details see the JavaDoc.
123
124gov.noaa.pmel.sgt
125        AbstractPane
126          new fields
127            DEFAULT_SCALE
128            TO_FIT
129            SHRINK_TO_FIT
130          new methods
131            Object[] getObjectsAt(int x,int y),
132            Object[] getObjectsAt(Point pt)
133            Point getZoomStart()
134            void setMouseEventsEnabled(boolean en)
135            boolean isMouseEventsEnabled()
136            void setPageScaleMode(int mode)
137            int getPageScaleMode()
138
139        Attribute
140          new methods
141            void setId(String id)
142            String getId()
143            void setBatch(boolean batch)
144            void setBatch(boolean batch, boolean local)
145            boolean isBatch()
146
147        Axis       
148          new methods
149            void setLineColor(Color color)
150            Color getLineColor()
151
152        AxisTransform
153          new constructors
154            AxisTransform(double p1, double p2, long t1, long t2)
155          new methods
156            double getTransP(long t)
157            long getLongTimeTransU(double p)
158
159        CLIndexedColorMap
160          new methods
161            Color getColorByIndex(int indx)
162
163        CartesianGraph
164          new methods
165            void setClip(long tmin, long tmax, double min, double max)
166            double getXUtoD2(double u)
167            double getYUtoD2(double u)
168            double getXUtoP(long t)
169            double getYUtoP(long t)
170            int getXUtoD(long t)
171            int getYUtoD(long t)
172            double getXUtoD2(GeoDate t)
173            double getYUtoD2(GeoDate t)
174            double getXUtoD2(long t)
175            double getYUtoD2(long t)
176            int getXUtoD(SoTValue val)
177            int getYUtoD(SoTValue val)
178            double getXUtoD2(SoTValue val)
179            double getYUtoD2(SoTValue val)
180            double getXUtoP(SoTValue val)
181            double getYUtoP(SoTValue val)
182            SoTValue getXPtoSoT(double p)
183            SoTValue getYPtoSoT(double p)
184            long getXPtoLongTime(double p)
185            long getYPtoLongTime(double p)
186            SoTPoint getPtoU(Point2D.Double loc)
187            SGTData getDataAt(Point pt)
188
189        CartesianRenderer
190          new methdos
191            SGTData getDataAt(int x, int y)
192            SGTData getDataAt(Point pt)
193
194        ColorKey
195          Fixed vertical orientation.
196          new constructor
197            ColorKey(Point2D.Double pt, Dimension2D size, int valign, int halign)
198          new methods
199            void addGraph(CartesianRenderer rend, SGLabel label)
200            void setColumns(int col)
201            void setLineLengthP(double len)
202
203        ColorMap
204          new methods
205            void setBatch(boolean batch)
206            void setBatch(boolean batch, boolean local)
207            boolean isBatch()
208
209        Graph
210          new methods
211            SGTData getDataAt(Point pt)
212
213        GridAttribute
214          new methods
215            void setId(String id)
216            String getId()
217            void setBatch(boolean batch)
218            void setBatch(boolean batch, boolean local)
219            boolean isBatch()
220
221        GridCartesianRenderer
222          new methdos
223            SGTData getDataAt(Point pt) - unimplemented
224
225        IndexedColor
226          new methods
227            Color getColorByIndex(int index)
228
229        IndexedColorMap
230          new methods
231            Color getColorByIndex(int index)
232
233        JPane
234          new methods
235            String getVersion()
236            Point getZoomStart()
237            Object[] getObjectsAt(int x, int y)
238            Object[] getObjectsAt(Point pt)
239            void setMouseEventsEnabled(boolean enable)
240            boolean isMouseEventsEnabled()
241            void setPageScaleMode(int mode)
242            int getPageScaleMode()
243
244        Layer
245          new methods
246            double getXPtoD2(double xp)
247            double getYPtoD2(double yp)
248            LayerChild findChild(String id)
249            Iterator childIterator()
250            LayerChild[] getChildren()
251            Object[] getObjectsAt(int x, int y, boolean check)
252
253        LayerContainer - unimplemented
254
255        LayerStack - unimplemented
256
257        LineAttribute
258          new methods
259            boolean  equals(Object obj)
260            void setId(String id)
261            String getId()
262            void setBatch(boolean batch)
263            void setBatch(boolean batch, boolean local)
264            boolean isBatch()
265
266        LineCartesianRenderer
267          new methods
268            SGTData getDataAt(Point pt) - unimplemented
269
270        LineKey
271          new methods
272            void addGraph(CartesianRenderer rend, SGLabel label)
273
274        LinearTransform
275          new methods
276            double getTransP(long t)
277            long  getLongTimeTransU(double p)
278
279        LogAxis - new implementation
280
281        LogTransform - new implementation
282
283        Pane
284          mew methods
285            String getVersion()
286            Point getZoomStart()
287            Object[] getObjectsAt(int x, int y)
288            Object[] getObjectsAt(point pt)
289            void setMouseEventsEnabled(boolean enable)
290            boolean isMouseEventsEnabled()
291            void setPageScaleMode(int mode)
292            int getPageScaleMode()
293
294        PaneProxy
295          new methods
296            String getVersion()
297            Object[] getObjectsAt(int x, int y)
298            void setMouseEventsEnabled(boolean enable)
299            boolean isMouseEventsEnabled()
300
301        PointAttribute
302          new methods
303            boolean equals(Object obj)
304            void setId(String id)
305            String getId()
306            void setBatch(boolean batch)
307            void setBatch(boolean batch, boolean local)
308            boolean isBatch()
309
310        PointCartesianRenderer
311          new methods
312            SGTData getDataAt(Point pt) - unimplemented
313
314        PointCollectionKey
315          new methods
316            void addGraph(CartesianRenderer rend, SGLabel label)
317
318        Ruler
319          new methods
320            int getLabelInterval()
321            void setLabelInterval(int interval)
322            int getSignificantDigits()
323            void setSignificantDigist(int sig)
324            String getLabelFormat()
325            void setLabelFormat(String format)
326            Color getLabelColor()
327            void setLabelColor(Color color)
328            Color getLineColor()
329            void setLineColor(Color color)
330
331        SGLabel
332          new methods
333            boolean equals(Object obj)
334
335        VectorAttribute
336          new methods
337            void setId(String id)
338            String getId()
339            void setBatch(boolean batch)
340            void setBatch(boolean batch, boolean local)
341            boolean isBatch()
342
343        VectorCartesianRenderer
344          new methods
345            SGTData getDataAt(Point pt) - unimplemented
346
347        VectorKey
348          new methods
349            void setLineLengthP(double len)
350            void addGraph(CartesianRenderer rend, SGLabel label)
351
352gov.noaa.pmel.sgt.beans
353        all new package
354
355gov.noaa.pmel.sgt.contour
356
357gov.noaa.pmel.sgt.demo
358
359gov.noaa.pmel.sgt.dm
360        SGTGrid
361          new methods
362            GeoDateArray getGeoDateArray()
363            GeoDateArray getGeoDateArrayEdges()
364
365        SGTLine
366          new methods
367            GeoDateArray getGeoDateArray()
368
369        SGTPoint
370          new methods
371            long getLongTime()
372
373        SGTTuple
374
375        SGTVector
376
377        SimpleGrid
378          new methods
379            GeoDateArray getGeoDateArray()
380            GeoDateArray getGeoDateArrayEdges()
381            void setTimeEdges(GeoDateArray tarray)
382            void setTimeArray(GeoDateArray tarray)
383
384        SimpleLine
385          new constructor
386            SimpleLine(GeoDateArray tloc, double[] yloc, String title)
387            SimpleLine(double[] xloc, GeoDateArray tloc, String title)
388          new methods
389            GeoDateArray getGeoDateArray()
390            void setTimeArray(GeodDateArray tarray)
391
392        SimplePoint
393          new constructor
394            SimplePoint(SoTPoint loc, String title)
395          new methods
396            long getLongTime()
397            void setTime(GeoDate date)
398            void setTime(long t)
399
400        SimpleTuple
401          new methods
402            void setXArray(GeoDateArray tArray)
403            void setYArray(GeoDateArray tArray)
404            GeoDateArray getGeoDateArray()
405
406gov.noaa.pmel.sgt.swing
407        Draggable
408          new method
409            void setLocation(Point loc, boolean fireEvent)
410
411        JGraphicLayout
412          new methods
413            Attribute findAttribute(String id)
414            void setAllClip(long tmin, long tmax, double min, double max)
415
416        JPlotLayout
417          new methods
418            SoTDomain getGraphDomain()
419
420        UserIcon
421          new methods
422            SoTPoint getLocationU()
423            void setLocationUNoVeto(SoTPoint loc)
424            void setLocationU(SoTPoint loc)
425
426        ValueIcon
427          new methods
428            SoTPoint getLocationU()
429            void setLocationUNoVeto(SoTPoint loc)
430            void setLocationU(SoTPoint loc)
431
432        ValueIconFormat
433          new methods
434            void setTimeFormat(String tfrmt)
435            String format(SoTPoint pt)
436
437gov.noaa.pmel.sgt.swing.prop
438
439gov.noaa.pmel.swing
440        SelectTimeDialog
441          new method
442            void setRange(long min, long max)
443
444gov.noaa.pmel.util
445        Domain
446          new constructors
447            Domain(Range2D xRange, Range2D yrange, boolean xRev, boolean yRev)
448            Domain(TimeRange tRange, Range2D yRange, boolean xRev, boolean yRev)
449            Domain(Range2D xRange, TimeRange tRange, boolean xRev, boolean yRev)
450          new methods
451            void setYReversed(boolean rev)
452            boolean isYReversed()
453            void setXReversed(boolean rev)
454            boolean isXReversed()
455
456        Point2D
457          new methods
458            boolean equals(Object obj)
459            Point2D copy()
460
461        Rectangle2D
462          new subclass
463            Rectangle2D.Float
464          new methods
465            void setWidth(double w)
466            double getWidth()
467            void setHeight(double h)
468            double getHeight()
469            void setX(double x)
470            double getX()
471            void setY(double y)
472            double getY()
473            Rectangle2D copy()
474
475        SoTDomain
476          new constructor
477            SoTDomain(SoTRange xRange, SoTRange yRange, boolean xRev, boolean yRev)
478          new methods
479            SoTPoint getCenter()
480            void setXReversed(boolean rev)
481            boolean isXReversed()
482            void setYReversed(boolean rev)
483            boolean isYReversed()
484
485        SoTPoint
486          new constructors
487            SoTPoint(double x, long y)
488            SoTPoint(long x, double y)
489          new methods
490            void setX(SoTValue x)
491            void setY(SoTValue y)
492            void add(SoTPoint point)
493            SoTPoint copy()
494
495        SoTRange
496          new subclass
497            SoTRange.Time
498
499        SoTValue
500          new sublcass
501            SoTValue.Time
502          new methods
503            void add(SoTValue val)
504            long getLongTime()
505            GeoDate getGeoDate()
506
507        TimeRange
508          new constructor
509            TimeRange(long start, long end, long delta)
Note: See TracBrowser for help on using the repository browser.