FreeHEP Java Library

Release Notes

These release notes are in reverse chronological order.

HEAD of CVS

General

• All but one of the java classes now compile without deprecation on JDK 1.5.0-beta-b31. Identifiers with the name "enum" were renamed since this is now a keyword. The show() and hide() method calls have all been replaced by setVisible(true/false).
  All but 1 warning (aid related) have been fixed.
• FREEHEP-414: Exceptions checked when classes are loaded, instantiated and searched (arrays).
• FREEHEP-418: Support for Linux-icc 8.0 compiler added.
• FREEHEP-443: Support for Linuxamd64-g++ added.
• FREEHEP-316: Support for WINDOWS-g++ 3.3 compiler added, including linkage with CERNLIB-WIN32-g++.
• FREEHEP-430: Dependency on g2c (g++) minimized to the libs with Fortran.
• FREEHEP-452: Value() can now be externalized and recreated from a special string.
• FREEHEP-499: zlib upgraded from 1.1.3 to 1.2.2.

AID

• FREEHEP-397: Separately packaged for users who only want AID. See separate ReleaseNotes.

Application Framework

• FREEHEP-449: Allow negative numbers to be used in version numbers.

FREEHEP JNI

• FREEHEP-476: Setting JNI_SHOW_DEBUG will print debug messages and exceptions for interaction with JNICUtil.

FreeHEP IO

• FREEHEP-354: Updates in zipios++ were handed back to zipios.sourceforge.net. Current FreeHEP version not updated yet.

Root IO

• Added support for reading files via a root daemon, using root: protocol.

Geant4

• FREEHEP-345: Removed geant4 driver from FreeHEP. Fully supported in Geant4 CVS repository.

HEPREP (C++)

• Moved to its own package, now separately documented.

JHepRep

• FREEHEP-497: Removed debug message about optimization
• XMLHepRepReader and DefaultHepRepReader now share the same AbstractHepRepReader.
• FREEHEP-481: AbstractHepRepReader fails to return true for hasNext() for last file.
• FREEHEP-458: Handles heprep.properties file.
• FREEHEP-459: Zip files now support sequential access.
• FREEHEP-460: Added "int skip(int n)" method to HepRepReader.
• FREEHEP-461: Added "int size()" method to HepRepReader.
• FREEHEP-462: .gz and .heprep and .xml files use XMLSequence to read multiple HepRep files.
• FREEHEP-463: Added entryName() and entryNames() methods to HepRepReader.
• Removed IOExceptions from factory for all but the createReader and createWriter methods.
• FREEHEP-451: Removed unnecessary public access to ref and xml classes. Almost all classes use factories now.
• FREEHEP-450: Added method HepRepFactory.createHepRepType(HepRepTypeTree tree,String name) to Factory
• Added HepRepConverter interface (see WIRED-244), for java only.
• Removal of InstanceTrees and TypeTrees corrected in HepRep implementations (corba, corbavalue, ref and rmi).
• FREEHEP-419: Added HepRep.xsd and HepRep.dtd to the web schema directory.
• FREEHEP-420: Java and C++ writer now use new Identifier for HepRep.xsd.
• FREEHEP-434: HepRepIterator now has attribute specific listeners. A HepRepIteratorAdapter is also available.
• FREEHEP-436: DefaultHepRepInstance now caches the layer attribute. The DefaultHepRepIterator is thus faster. Changes into layer attributes, on either HepRepType or HepRepInstance should be followed by validating all HepRepInstances.
• HepRepIteratorListener renamed to HepRepAttributeListener, HepRepIteratorAdapter renamed to HepRepAttributeAdapter. HepRepFrameListener added.
• DefaultHepRepIterator changed to handle frames correctly.
• DefaultHepRepIterator can now be called without layering.
• Changed HepRepWriter to be able to write out heprep.properties file.
• Changed some default attributes.

Other

• ColorConverter will now look at all 3 or 4 entries before deciding to convert from float or integer.
• FREEHEP-482: Add treetable to freehep.
• FREEHEP-472: Add table column resize routines for freehep.
• FREEHEP-479: Added TableSorter and helper classes.
• FREEHEP-395: added Argv package and additions for simpler command line parsing.
• ExportFileType now has 2 of the 4 exportToFile methods implemented, calling the other (array) 2.
• Cursors can be created with specific hotspots.

Infrastructure

• FREEHEP-405, FREEHEP-423: upgraded Ant to 1.6.1.
• FREEHEP-406: upgraded Doclet to JDK 1.4.2 source code.
• FREEHEP-407: upgraded JavaCC to 3.2 and got rid of the JavaCC 2.1 version and its support.
• FREEHEP-408: upgraded Java3D to 1.3.1.
• FREEHEP-409: upgraded LogKit to 1.2.2.
• FREEHEP-441: upgraded JDOM to beta 10.

Version 1.2.2 (December 11, 2003)

AID

• Added several java.util interfaces to default definitions.

AIDA

• Renamed PolinomialModelFunction into PolynomialModelFunction.
• Fixed typos in ExponentModelFunction.
• Review design of FTuple; removed unecessary methods.
• Java version updated to AIDA 3.2, C++ version kept at 3.0 for compatibility with Geant4.
• Finished the implementation of ITree; cp, mv, symlink methods
• Implemented AIDA style objects
• Moved AIDA-only JUnit tests to aida repository

AIDAJNI version 3.2.0

• AIDAJNI-20: All creation of Proxies routed through the ProxyFactory.
• AIDAJNI-9 (partially): Experimental CI classes available for Axis, Annotation, Histogram, Cloud and Profile.
• AIDAJNI-12: AIDA version 3.2.1 compliant for both Java and C++.

AIDAJNI version 3.0.4

• FREEHEP-349: Updated to use exceptions() instead of checkExceptions() when a bool is returned.
• AIDA-33: Tuple now returns "java.lang.String" for getColumnType() of a string column.
• AIDA-33: TupleFactory accepts both hep.aida.ITuple and ITuple as well as java.lang.String and string.
• AIDAJNI-14: allmost all methods in all JI classes are implemented. Exceptions are there where the C++ version is unimplementable.
• AIDAJNI-3: find method in tree will now return the correct IManagedObject.
• AIDAJNI-6: Implemented methods for Histogram Arithmetic.
• AIDAJNI-8: Implemented methods for DataPointSet, DataPoint and Measurement.
• AIDAJNI-10: Got rid of "hiding" warnings and string conversion on Solaris.
• AIDAJNI-4: Geant4 overlay now includes libs compiled with g++3.2
• Implements AIDA C++ version 3.0 using AIDA Java version 3.2.1
• Return empty strings and empty vectors instead of NULL. Fixed some memory leaks.

FREEHEP JNI

• FREEHEP-349: Changed return type of checkExceptions() to return void. exceptions() returns bool, and will not print anything.

FREEHEP IO

• Added NoCloseReader and NoCloseWriter classes.
• FREEHEP-361: Added popBufferBytes() for use by CGM to ByteCountOutputStream.
• FREEHEP-352: Added XMLSequence to allow reading of multiple XML segments from a stream, using the XMLParser.
• FREEHEP-306: Added zipios++ (0.1.5) and zlib (1.1.3) libraries so that we can write zip files from c++.

Infrastructure and Tools

• FREEHEP-346: added c++ .NET compilation and linking in WIN32-VC7 directories.
• INFRASTRUCTURE-18: JavaDoc now runs with -source 1.4 to document assert keyword correctly.
• FREEHEP-325: Upgraded to ant 1.5.4
• INFRASTRUCTURE-14: Fixed WebPage tool to strip head/body of included files, added title of main document as title of generated webpage
• FREEHEP-321: documented that JDK_HOME/bin should be in PATH.
• FREEHEP-320: fixed javah not to use unpublished SUN api. FreeHEP now compiles with jsdk 1.4.2
• Build.xml now adds classpath for running javah.
• FREEHEP-308: Modified c/c++ compilation setup to allow for libraries that are not linked to C++ (LINKNOCXX) and/or not linked to Java (LINKNOJAVA). CERNLibAdapters (minuit and hbook) now link without C++ or Java and are therefore compatible with any reasonable version of gcc/redhat.
• FREEHEP-309: Added sstream header for g++ 2.95.2 (old compiler on MacOS X).
• FREEHEP-288: CERNLIBAdapter for WIN32-VC now includes DFORMD.DLL in alignment with CERNLIB. DFORRT.DLL has been removed.
• FREEHEP-304: AID version 0.9.4 will not output semicolons for namespaces. Seems to produce warnings on the True64 compiler.
• FREEHEP-299: Added FreeHEPCommand task. Build file will now run idlj for out of date idl files. Setup different from before, look in freehep-heprep.properties for an example. Idl generated files removed from repository (heprep).

Util

• FREEHEP-357: added GZIPOutputStream in C++ for writing gzip files.

Swing

• WIRED-6: Moved org.freehep.swing.undo into FreeHEP from WIRED. this adds AnimatableEditSupport classes to deal with animation feedback for undoable edits.
• Added new package, org.freehep.swing.print.table with utilities for printing tables.
• Added new package, org.freehep.swing.wizard with a set of classes for creating wizards (dialogs with a set of pages).
• FREEHEP-232 Added new package, org.freehep.swing.popup with a set of utilities for handling popup menus.

Util

• FREEHEP-350: Merged EndingFileFilter into ExtensionFileFilter as part of org.freehep.swing.
• WIRED-6: Added DiscreteAngle class which given an Angle allows iteration over a set of discrete angles.

PS Viewer

• Separately packaged for users who only want the PS Viewer.
• See separate ReleaseNotes.

VectorGraphics

• Separately packaged for users who only want the VectorGraphics package.
• See separate ReleaseNotes.

Geant4

• FREEHEP-312: Geant4 Driver now 4.5.2 and 4.6 compliant.

HepRep

• XMLHepRepReader now uses InputStream rather than Reader to allow for usage of XMLSequence.
• HepRepIO.writeHepRep recognizes .heprep extension.
• FREEHEP-371: Major rewrite of the ref, corba, corbavalue and rmi HepRep classes to implement the equals() and hashCode() methods and to return Sets and Lists rather than Collections in cases where possible. HepRep interfaces have changed. C++ implementation was also modified accordingly.
• FREEHEP-281: Added overlay methods to HepRep, HepRepInstanceTree and HepRepInstance. Corba, CorbaValue and Streamer do not implement these. C++ and JNI ignore these calls. Reference Implementation partially ready.
• FREEHEP-370: Added boolean (true) attribute IsPickable (PickAction) to defaults.
• FREEHEP-363: Added boolean (false) attribute ShowParentAttributes (PickAction) to defaults.
• FREEHEP-362: Added boolean (false) attribute PickParent (PickAction) to defaults.
• FREEHEP-360: Added getSuperInstance() method to HepRepInstance.
• WIRED-170: HepRep can use either flat or a hierarchical namespace for its types. Method getFullName() was added to the HepRepType interface. The XMLReader and XMLWriter were modified to handle both types of namespaces.
• WIRED-173: added LineWidthMultiplier and MarkSizeMultiplier to defaults.
• FREEHEP-7: Reference implementation makes full use of intern() of Strings.
• HEPREP-4: Added HepRepViewer interface.
• FREEHEP-351: HepRepAttValue will now convert int/long to double for getDouble() and int to long for getLong().
• Made CreateTest.java up-to-date with HepRep2 standard.
• FREEHEP-349: Updated HepRepJNI to use exceptions() instead of checkExceptions() when a bool is returned.
• FREEHEP-342: Internal LinkedLists replaced by Lists.
• FREEHEP-341: Added HasHepRep interface.
• FREEHEP-310: Removed streamer and streamer-c++, since the interfaces (including) heprep itself would have become more complicated with extra stuff such as filenames for hepreps etc etc... the c++ interface, see FREEHEP-303 and the java ref implementation will do.
• FREEHEP-305, FREEHEP-8: The writer for HepRep now comes with extra parameters to write compressed and/or in random access mode. The default/xml writers write either .gz or .zip files repectively, when these flags are set. The C++ implementation only writes plain or .zip files.
• FREEHEP-303: Native C++ implementation of HepRep added. Only allows writing to XML and in memory inspection. No reader provided.

Version 1.2.1 (June 5, 2003)

AIDA

• Use services API to find store factories
• Modify IStoreFactory for compatibility with JAS3
• Add new test cases for Root and PAW
• Small mods to PAW store (now uses id for tuples)
• Small mods to Root store (now has option for controlling whether all cycles are listed, or only most recent (the default))
• Root tuples containing variable length arrays are now mapped to AIDA tuples with nested Folders
• Fixes for FreeHEP-282: unable to read specific root file. Problem with ordering of doubles.
• AIDA JNI, resolved warnings of uninitialized variables.

Infrastructure and Tools

• FREEHEP-288: minuitAdapter and hbookAdapter now bundled together into CERNLIBAdapter. In the case of WIN32-VC this includes DFORRT.DLL.
• FREEHEP-283: void* now recognized as resultype. AID version 0.9.2
• Added hbookAdapter makefile to produce hbook distribution

Doc

• Fixed apidoc tags in most files. "ant sysdoc" still gives 6 warnings.
• FREEHEP-276: Removed test packages from apidoc..

Util

• ImageUtilities.createRenderedImage() will now return the given image, if it was a RenderedImage already and no background was requested.
• FreeHEPLookup will now also find classes registered using the services API.
• FREEHEP-290: ImageHandler will not throw HeadlessException anymore. Reference tests are corrected. SWF Testing disabled because of loop in CubicToQuadPathConstructor FREEHEP-286.

FreeHEP IO

• Removed classes ImageOutput, DCTOutputStream and all implementations of ImageOutput; use ImageGraphics2D.writeImage to write image in particular format (JPG, PNG or RAW)

VectorGraphics

• FREEHEP-277: Initialization of graphics context and background better handled.
• FREEHEP-104, FREEHEP-224: Images can now be embedded in their smallest size (JPG, PNG, ZLIB, RAW).
• RawWriter added to write plain image format, with padding and choice of format (ARGB, RGB, BGR, ...).
• ImageGraphics2D.writeImage now chooses preferred freehep imagewriter if more than one is available.

EMF

• FREEHEP-92: TextColor correctly set in EMF.

JAVA

• FREEHEP-275: Package can be set as property if needed. Test files will end up in correct directory.

PS

• FREEHEP-272: PageMargins have been changed to be Insets. Options can be set from Export Panel.

PDF

• FREEHEP-273: PDFWriterTest works again.
• FREEHEP-272: PageMargins have been changed to be Insets. Options can be set from Export Panel.
• FREEHEP-279: Width and height corrected for images on setPaint(TexturePaint).

SVG

• FREEHEP-21: Nesting of SVG tag is limited, would crash the browser. Drawing state (stroke, etc) now included in primitives. Files slightly larger, but work now in Adobe SVG Viewer 3.0 and are a lot quicker to display.
• FREEHEP-188: Texture Paint works now.
• FREEHEP-110: Vertical Text offset is now approximated.

SWF

• FREEHEP-23: LineStyles are now written as outlines if SWF does not support them.
• FREEHEP-201: Dashed lines work using outlines.

HepRep

• FREEHEP-274: HepRepStreamer for C++ can now write trees only.
• Resolved problems of warnings on Linux and Solaris.
• Geant4 driver changed, but currently writes incorrect HepRep files, see FREEHEP-267 and FREEHEP-292, use 1.2 instead.

Version 1.2 (May 16, 2003)

Application Framework

• Moved PrintHelper, PrintOptions and PrintDialog from JAS.

Libraries

• Removed xercesSamples.jar, xerces.jar and their tool file to check xml.
• Upgraded JavaHelp to 1.1.3
• Removed Log4J

Swing Extensions

• Added a TableLayout class which uses the standard GridBagLayout but allows easier setup and use.

Utility

• Added ImageUtilities class to convert different types of images.
• Removed classes: XercesDOMParser, StreamingCharFactory, DOMParser and DocumentFinishedException, and updated all XML related classes to be dependent on JAXP for their parser.
• Added a UserProperties class which allows for storage of non string types, and cascaded lookups.
• FREEHEP-258: XMLWriter now properly encodes in unicode for characters between 0x80 and 0xFF

Infrastructure and Tools

• FREEHEP-244: added "test" target to build.xml, which executes unit tests if defined.
• Upgraded JavaWebStart (jnlp) to 1.2
• FREEHEP-15: upgraded doclet to jdk 1.4.1
• Removed jar.inf from build.xml. You can now set jar.metainfdir and jar.metainf to include for instance a service directory
• FREEHEP-1: upgraded to Ant version 1.5.3.
• FREEHEP-1: build file now uses -source 1.4 for compilation.
• FREEHEP-206: upgraded JavaCC to version 3.0, and AID to version 0.9
• FREEHEP-176: a flag to control generation of exceptions in C++ code was added. In aid.cpp.properties you may set useExceptions to true/false. The default is set to true. AIDA and HEPREP have their flags set to false. AID version 0.9.1

FreeHEP IO

• Added LineNumberWriter to keep track of number of lines written. Allows a Listener.
• ByteOrderOutputStream and FlateOutputStream can now write images. An ImageOutput interface was added and all graphicsio drivers use this ImageOutput interface.
• FREEHEP-124: DCT Input and Output Stream handle the reader/writing of Images.
• FREEHEP-246: removed stacksize limitation from ByteCoutOutputStream.
• IndentPrintWriter now properly overloads all print() and println() methods. It was moved from org.freehep.util to org.freehep.util.io.
• Added NoCloseOutputStream which only flushes the output.
• FREEHEP-190: Added Base64 Input and Output Streams.
• FREEHEP-191: Added ReaderInputStream and WriterOutputStream.
• FREEHEP-210: Added DecompressableInputStream and CompressableOutputStream, which can start (de)compressing midstream. BitInputStream and BitOutputStream inherit from these respective classes now.

ROOTIO

• Added latest version of ROOTIO.

VectorGraphics

• FREEHEP-264: ExportDialog will properly append extension when browsing for a file name. It will also ignore the default name if a user preference was saved.
• VectorGraphicsTransferable was moved from org.freehep.graphicsio.exportchooser to org.freehep.util.export.
• FREEHEP-266: Added invert() method to PrintColor with guaranteed contrast. Used it in BackgroundPanel for selection of color and text.
• FREEHEP-230: Creator properly set for all output formats.
• FREEHEP-260: Background color can be set from options and Transperency can also be toggled. Applies to all formats.
• FREEHEP-254: The background is correctly set from the component (if available) and the formats now correctly write out the background if they do not support transparency (CGM, EMF, JPG, PS and PPM).
• Images handling redone, to handle images of different types and to avoid the PixelGrabber class.
• FREEHEP-249: Curly artifacts fonts of Type 1 (PDF/PS) inclusion are fixed.
• FREEHEP-247: Warnings and errors can be printed by setting AbstractVectorGraphicsIO.EMIT_WARNINGS, or EMIT_ERRORS property to true.
• FREEHEP-248: Tests were added for Preview and Thumbnails (PS and PDF).
• FREEHEP-49: Tests for Font Embedding added.
• FREEHEP-217: ExportDialog replaces SimpleExportDialog
• FREEHEP-217: Base classes for Exporting moved to package org.freehep.util.export. VectorGraphics and ImageIO Plugin classes stay in packages org.freehep.graphics2d and org.freehep.graphicsio and its subpackages. This allows you to add new ExportFileTypes and have a Dialog that uses them, by adding new plugin jar files to the classpath.
• FREEHEP-39, FREEHEP-57, FREEHEP-58: Redid all the option panels for all drivers
• FREEHEP-199: AbstractPathConstructor calls quad method rather than making cubics.
• FREEHEP-196: SymbolShape now has proper bounding box.
• FREEHEP-185 and FREEHEP-187: Added transparency for normal (non-image) drawing to the PDF and SVG formats.
• FREEHEP-202: Fixed PrintColor class to rely on JDK 1.4 Color constants.
• FREEHEP-204: Added WebColor class to create Colors following the 216-web color scheme.
• FREEHEP-207: endExport() now calls dispose() on top-level graphics context, which may call writeGraphicsSave().

PixelGraphics2D

• FREEHEP-218: Blitting of symbols made into renderinghint, which defaults to ON, except for JPG which uses non-transparent image to draw in, which would result in blitting of images with a black background. PPM does not suffer from this since it uses transparent images to write to a file, even if the format itself does not allow for transparency. JPEG images have to be written on TYPE_INT_RGB or they end up as blank pages, see SUN bug 4775930
• FREEHEP-256: Setting the font to Symbol or ZapfDingbats maps the ascii range into the corresponding unicode ranges.
• FREEHEP-205: The drawSymbol and fillSymbol methods in PixelGraphics2D will use image blitting of cached symbol images of max size 32x32, in the case the display is local (Windows32, MacOSX and X11local). In the X11 Remote case normal drawing procedures are used. The colors are converted to WebColors. For VectorGraphics export everything stays as normal.

EMF

• FREEHEP-91, FREEHEP-179: Used AlphaBlend tag to implement Transparent Images.
• FREEHEP-63, FREEHEP-90: Logical fonts are now properly translated to Windows fonts.
• FREEHEP-88, FREEHEP-89: Symbol and ZapfDingbats are now mapped to "Arial Unicode MS", since there is no standard Unicode Serif font on Windows with all these encodings. If explicitly using Unicodes from a font, they may show as blocks.
• FREEHEP-253: Images are now properly padded and 1 pixel offset is corrected.
• FREEHEP-193: Header properly padded.

GIF, JPG, PNG, PPM

• FREEHEP-218: Blitting of symbols made into renderinghint, which defaults to ON, except for JPG which uses non-transparent image to draw in, which would result in blitting of images with a black background.
• FREEHEP-243: Antialias and AntialiasText are now options for ImageGraphics2D, so can be used on any of the image formats. Defaults are on for both, except for the GIF format, which defaults both to off since it would result in too many colors. The tests use AntialiasText off since it seems to generate time-dependent information in the image formats.
• FREEHEP-19: JPEG Driver was fixed, uses non-transparent RGB BufferedImage.
• FREEHEP-212: GIF and PPM are now ImageIO plugins, separately packaged as jar files.
• FREEHEP-212: PNG and JPG are now relying on Sun's implementation. Encoder for PNG is still available but may be removed in the future.
• GIF Driver separately packaged so that one can remove it for distribution.

JAVA

• FREEHEP-214, FREEHEP-238, FREEHEP-237, FREEHEP-263, FREEHEP-270: Added JAVA Driver which saves aa Java source file of what has been drawn to the screen. This is to enable users to easily generate test files. Limitations are currently:
  • no images can be written (FREEHEP-236),
  • displayed component will not resize (FREEHEP-239)

PDF

• FREEHEP-95, FREEHEP-255: Logical fonts are mapped to PDF standard fonts.
• FREEHEP-94: Implemented drawFrameAndBanner() method.
• Fixed Encoding for FontEmbedderType1
• FREEHEP-203: Cleaned up the PDF output regarding empty objects.

PS

• FREEHEP-250: No fonts are assumed standard in PS/EPS, so all are included when requested.
• FREEHEP-111: PSFontNames are properly encoded now. GhostScript does not complain anymore about Times, Helvetica and others. Symbol and ZapfDingbats do not come in Bold or Italic.
• FREEHEP-235: Changed encoding of PS from ISOLatin to STDLatin. The hyphen now encodes properly.
• Removed EPSIExportFileType since it was not used.

SVG

• FREEHEP-221: ImageSize can now be properly set and modified.
• FREEHEP-258: XML now properly unicode encoded for characters between 0x80 and 0xFF
• FREEHEP-116: Compressed SVG can be read (as .svg or .svgz) in Adobe SVG Viewer 3.0 build76. Default setting is now compressed.
• FREEHEP-108: Clipping along any path works.
• FREEHEP-189: PNG Images now embedded into SVG format.

SWF

• FREEHEP-109, FREEHEP-115: Logical Java fonts properly mapped, and symbol and zapfdingbats encoded.
• FREEHEP-200: Symbols and ZapfDingbats fonts are properly mapped to produce glyphs.
• FREEHEP-223: DefineJPEG2 and DefineJPEG3 implemented correctly. DefineBits and JPEGTables can only be read and written, but cannot be created.
• FREEHEP-59: upgraded to version 6.0
• FREEHEP-197: swf file can now be partially compressed for version 6.0
• FREEHEP-195: proper bounding boxes written.
• FREEHEP-75: glyphed text added to output.
• FREEHEP-74: Fixed a problem with curved shapes.
• FREEHEP-24, FREEHEP-119 and FREEHEP-171: Added imaging (including transparency) to the SWF format. It also handles setPaint(TexturePaint) now.
• FREEHEP-22: clip now properly written.

HepRep

• FREEHEP-9: HepRep output from C++ and Java now writes scientific format for doubles and floats with a precision of 6.

Version 1.1 (March 20, 2003)

• Initial public release.