The image load filter is used to load images during the report generation process. This filter expects its datasource to return a java.net.URL. If the datasource does not return an URL,
null
is returned.
This filter is mostly used in conjunction with the URLFilter, which creates URLs from Strings and files if nessesary.
The url is used to create a new imagereference which is returned to the caller. The loaded/created imagereference is stored in an internal cache.
This filter can be used to dynamically change images of a report, a very nice feature for photo albums and catalogs for instance.
This filter will return null, if something else than an URL was retrieved from the assigned datasource
@author Thomas Morgner