ilAffineWarp is a subclass of ilWarp that extracts the first degree polynomial coordinate transformations that were formally embedded in ilPolyWarpImg. ilRotZoomImg uses this warp class to represent its transformations.

ilCallback is a new base class with two derived classes: ilFunctionCallback and ilMethodCallback. The derived classes provide a standard way to encode new function callbacks. The external interface uses derived classes from ilFunctionCallback and ilMethodCallback.

ilFunctionCallback creates a callback to a function that takes an argument, userArg. This argument is supplied when the callback is created and a second argument, callerArg, is passed from the callsite of the callback (when doit() is called).

ilMethodCallback is similar to ilFunctionCallback. You use both to create a callback to a method on an object of a specified class.

iflColormap is derived from iflLut. The only difference between the two is that iflColormap cannot have a one-to-one mapping onto the domain of the LUT. You use iflColormap to represent the colormap for image files that have an iflRGBPalette color model. All methods getting or setting colormaps now pass an iflColormap object instead of an ilLut.

ilCompoundImg is an abstract class that can be used to manage an IL subchain as if it were a single object. This can be useful for encapsulating an IL subchain used repeatedly in an application. You can use IL to create variable subchains since the parents and children of ilCompoundImg are attached to ilCompoundImg itself rather than internal subchains. For example, an ilCompoundImg could encapsulate two subchains which share common output processing but process input differently.

ilELTImg, together with ilDisplay, ilView, and ilStereoView, provide functions needed by Electronic Light Table (ELT) applications. ELT applications provide real time manipulation of images, compressed or not. ilELTImg is derived from ilCompoundImg and manages an image chain consisting of dewarp, convolution, table look-up and histogram. Image manipulation, such as roaming and wiping as well as multi-image display and stereo display, is supported in ilDisplay.

ilFPolarImg is a new base class for ilFMagImg and ilFPhaseImg that operate on fourier domain images.

ilFPolyadicImg is a new base class for ilFMonadicImg and ilFDyadicImg that work on fourier domain images. ilFMonadicImg and ilFDyadicImg are now derived from ilFPolyadicImg as special cases.

ilFrameBufferImg, derived from ilImage, is the basis for all IL access to frame buffer memory. IL maintains internal display and GL contexts to isolate its rendering from the user's code.

In ilMath.h, some useful mathematical templates for integer types are defined, for example, ilMod, ilDiv, ilDivUp, ilRoundUp, and ilRoundDown.

ilPolyWarp is a subclass of ilWarp that extracts the seventh-degree polynomial coordinate transformations that were formally embedded in ilPolyWarpImg.

ilPolyadicImg, derived from ilOpImg, is the base class for N-input operators. Many formerly ilDyadicImg-derived operators, for example, ilAddImg, ilAndImg, ilBlendImg, ilMaxImg, ilMinImg, ilMultiplyImg, ilOrImg, and ilXorImg, now allow multiple inputs. ilDyadicImg is now derived from ilPolyadicImg as a special case.

ilTiePointList manages a set of tie points used by ilTiePointImg. It provides methods to add, remove, and locate tie points.

ilTimeoutTimer provides a simple and efficient means of implementing a timeout period for a polling loop. The timer automatically adapts its internal time checking to avoid excessive reads of the hardware timer. Because of this optimization, the timeout period is within 10% of the actual period.

ilTimer provides an interface to the high-resolution interval timer. On most SGI machines this has a resolution of 1 usec or better.

ilWarp provides an abstract class to one-, two-, and three- dimensional coordinate system warps from, respectively, (u), (u, v), and (u, v, w) space to (x), (x, y), and (x, y, z) space. The subclasses ilPolyWarp, ilAffineWarp, and ilPerspWarp implement particular instances of the ilWarp abstraction. The ilWarp class hierarchy enables more convenient control of ilWarpImg.

To support asynchronous operations and aborting, the getPage() virtual function in ilOpImg has been replaced by three new virtual functions that break the processing of a page into three phases: prepareRequest(), executeRequest() and finishRequest().

In the prepare phase, an operator allocates input buffers and fills them with image data. In the execute phase, the operator processes the image. In the finish phase, any allocated buffers or locked pages are freed. The finish phase is separate from the execute phase to allow aborted requests that have been prepared, but not executed, to skip the processing phase and free allocated resources.

These changes are only visible to operators derived directly from ilOpImg. Operators derived from more typical classes, such as ilMonadicImg or ilSpatialImg, still use the calcPage() API.

The image file format functionality has been separated into a library called Image Format Library (IFL). This library takes care of all I/O image processing. IL uses IFL to perform image I/O. IFL applications do not have to use IL, however, IFL also simplifies and standardizes the process of adding support for new image file formats.

The external interface to the IFL is encapsulated in two classes: iflFile and iflFormat. Note that IL users will normally continue to use ilFileImg directly; not the IFL API. Refer to the IFL man pages and release notes for more information on using IFL directly.

New image file formats such as PPM (portable pixmap file format) and PNG (new public domain replacement for GIF) are supported in IFL.

JPEG compression support in TIFF files had been added as has the ability to decompress JFIF images at reduced resolution and increased speed.

IFL also supports GIF file format writing, which was not supported in IL 2.5.

File format types, tile descriptors, list objects, vectors, and other generic types, such as ilBitArray, ilColor, ilConfig, ilCoord, ilDataSize, ilDictionary, ilHashTable, ilList, ilLut, ilMinMax, ilPixel, ilSize, ilSpace, ilTile, and ilTypes, shared by both IL and IFL are now in IFL. Consequently, the class name prefixes have changed from “il” to “ifl”.

A complete list of the name changes can be found in “Automatic Class Name Conversion”.

In ilCacheImg, all callback-related functionality has been changed to use the standard ilCallback interface. Specifically, the following callback-related functionality has been replaced: setPagingCallback, setPagingCallbackDefaultEnabled, getPagingCallback, getPagingCallbackArg, getPagingCallbackDefaultEnabled, enablePagingCallback, isPagingCallbackEnabled, and listResident. These callback-related routines are replaced by addPagingCallback, removePagingCallback, hasPagingCallbacks, and doPagingCallbacks. Either ilPagingMethodCallback or ilPagingFunctionCallback (newly defined) can be used with ilCacheImg::addPagingCallback().

ilClassId has changed to a const pointer to the ilClassList structure. ilConfig is now a derived class of iflConfig instead of a base class. The color model parameter in the constructor is now gone.

In ilDilateImg, the biasValue parameter in the constructor is gone.

ilDisplay uses an overloaded constructor to specify visual attributes and to automatically create an X window. getStart() and setStart() have been renamed to getMouse() and setMouse() because their values are updated by the current mouse position after one or more display operations.

ilDisplay::getVisibleArea() and ilDisplay::setVisibleArea() were added to clip painting for scrolled window support.

ilDisplay::mapXY() was added to handle from and to orientations. Note that ilCoordSpace has been renamed to iflOrientation.

enableFrontRedraw() and isFrontRedrawEnabled() were added to allow redraws to the front buffer in double buffer mode. This improves an application's perceived responsiveness.

setMode() and clrMode() were added to control the display mode used for adding new ilViews. New ilViews inherit dispMode() which makes it easier to defer painting while adding many new views.

Post-render callbacks were added which are called after all views have been rendered. There are three callbacks: prepare, render, and finish. The prepare and finish callbacks are called by an IL compute thread. The render callback is called by the IL render thread to maximize rendering performance. The prepare and finish callbacks can be NULL.

You can set and query a roam rate limit using setRoamLimit() and getRoamLimit(). You use the roam limit to smooth the roam motion. The limit sets the displacement, in pixels, between consecutively-rendered frames. Since the displacement is constant, regardless of the motion of the mouse, the roam speed is constant. For example, if the roam limit is four pixels, consecutively-rendered frames will be separated by four pixels regardless of how much or little the mouse moves.

ilDisplay no longer supports autoSwap. Instead, pass ilNoSwap in the mode argument to disable swapping.

ilDisplay::getScreenNum() was removed.

In ilErodeImg, the biasVal parameter in the constructor is gone.

cmplxVectorCalc() now has an extra argument to indicate whether the vector includes a dc value. getPage() is gone and its functionality is replaced by prepareRequest(), executeRequest(), and finishRequest().

ilFFTOp is no longer a public class. Forward and inverse transform, ilRfftf and ilRffti, can be done only using ilRFFTfImg and ilRFFTiImg.

getPage() has been replaced by prepareRequest(), executeRequest(), and finishRequest().

getPage() has been replaced by prepareRequest(), executeRequest(), and finishRequest().

In ilFalseColorImg, a NULL constructor was added.

ilFileImg was the abstract base class for various file format subclasses, for example, ilJFIFImg, ilPCDImg, ilPCDOImg, ilFITImg, ilGIFImg, ilSGIImg, and ilTIFFImg. Those subclasses are now gone.

ilGenericImgFile and ilFileImg have been replaced by ilFileImg. ilFileImg provides a standard interface for opening or creating image files of all format types. All file format-specific implementations are hidden inside the IFL.

There are major changes in ilFileImg.

ilFsDitherer generates an optimal colormap for a full-color image and performs a high quality dithering to produce a color index image. The algorithm that generates this colormap is based on Heckbert's median cut algorithm. The function takes a pointer to the source image and to the number of colors you want in the color-index image. The function returns an optimal colormap based on the distribution of pixel values in the source image. The input image can be dithered using the Floyd-Steinberg algorithm. IL now maintains a global dithering mode that can be set and queried using two new, utility methods: ilSetDither() and ilGetDither(). So, when creating a color index image, one can either set the dithering to ilNoDither for no dithering, ilFSDither for Floyd-Steinberg dithering, or ilSGIDither for standard SGI dithering.

These functions and the ilDither enum are defined in ilConfigure.h.

In ilGBlurImg, getBlur() was added and setBlurKernelSize() was removed.

In lHistLutImg, getImgStat() and getRoi() were added.

In ilHistScaleImg, getImgStat() and getRoi() were added.

In ilImage, the following methods were added: hwAccelerate(), isAccelerated(), copy(), q[Get/Set]SubTile3D(), qCopyTileCfg(), qDrawTile(), qFillTile[3D/RGB](), q[Get/Set]Tile3D(), qLockPageSet(), drawTile(), [alloc/get/free]FillData(), fillTileRGB(), getDimensions(), getCopyConverter(), getHwOp(), getHwPassTable(), getLockTileSet(), getPageOrigin(), hwDefine(), isIntegral(), [get/set]MaxColormapLevels(), and [is/set]Writable().

The methods map[To/From]Input() replace the methods eval[XY/UV]().

The new methods accept 3D arguments which enables tracking of 3D coordinate transformations through a chain. Numerous overloaded versions of these methods, including the old 2D versions, are also provided.

Methods with a different argument or return type, for example, clipTile(), take a new parameter of type iflTile3Dint which embodies offsets and dimensions.

getColormap() returns cmap through a return instead of a reference parameter. getFill() returns fillValue through a return instead of a reference parameter.

The following methods are obsolete: [get/set]CacheSize(), [get/set]Cache[Window/WindowCopy](), copyConverted(), isDisplayImg(), needColorConv(), operator<<(), seekTile[/3D](), and eval[XY/UV].

map[To/From]Source() now supports 3D coordinate transformations. Numerous overloaded versions of this method, including the 2D one, are also provided.

[map/isMirror]Space() has been replaced by [map/isMirror]Orientation().

minValue() and maxValue() changed from ilPixel to scalar double. [get/set][Min/Max]Value no longer have the channel parameter which means that minimum and maximum values are no longer maintained separately for each channel.

getPageSize() now uses a return of type size_t instead of int.

getPageSize() returns nx and ny through reference parameters.

copyTile[_/3D/Cfg]() methods no longer have the fromOther parameter. Operations are now always from the “other" image to "this" image.

getStrides3D() is replaced by getStrides().

setPageSize() is overloaded to allow only x and y page sizes to be set (and individual flags added to reflect this). setPageSizeZ() and setPageSizeC() were added.

[get/set]SubTile3D(), copyTileCfg(), fillTile3D(), lockTile3D(), and lockPageSet() are no longer virtuals.

lockPageSet() takes a new parameter, perPageCb.

hwGetPass() replaces hwEval().d

getColorImg() no longer has the optional parameter, img.

In ilImgStat, the isAccelerated() method was added.

ilIndexableList is now a stand-alone class instead of a derived class from ilList. The new methods, get[Next/Prev](), were added.

In ilLink, all callback related methods have been simplified to use the standard ilCallback interface. Specifically, setResetCallback(), setResetCallbackDefaultEnabled(), getResetCallback(), getResetCallbackArg(), getResetCallbackDefaultEnabled(), enableResetCallback(), and isResetCallbackEnabled() have been replaced by addResetCallback(), removeResetCallback(), and hasResetCallbacks().

The following functions were removed: get[Depth/Child]() and [add/remove]Parent().

ilDumpChain is now the dumpChain() method. The mpLock() method does not take the parameter, wait, anymore. The default value for parameter, spins, has changed.

The runtime type query methods are now const.

iflLut was formerly ilLut. iflLut now supports scale and bias on index which allows a LUT to have a different length than its domain, for example, a LUT can have floating point input values ranging from 0-1 and have 256 entries. [get/set]Val() now takes an index as a double. A new constructor takes LUT length. You can now use getDomainStep() to access sequential LUT entries.

getLookUpTable() now returns a pointer to the LUT through a function return instead of a reference parameter.

In ilMemCacheImg, the method getPageTime() was added which returns the average time to compute a page in the cache. The listResident() method now takes ilCallback as a parameter. lockPageSet() is now inherited from ilImage and has one extra parameter, perPageCb. [prepare/execute/finish]Request() methods now replace getPage().

ilFileImg, derived from ilMemCacheImg, is the only class still using getPage().

In ilMemoryImg, setAutoSync() was removed as was the parameter, autoSyncEnable, in the constructor.

A new method was added to iflName: setID().

In ilOpImg, checkDataType() was removed. getValidTypes() and getValidOrders() were added to query attribute values. The inherit() logic has been tuned to only re-inherit when inputs change.

In ilPage, the null constructor was removed. [get/set]PID() was added that gets or sets the process id that computes this page.

ilPropSet is a pure virtual class. Two subclasses of ilPropSet are provided, ilPropList and ilPropTable, which implement the abstract class as a linked list and as a hash table, respectively. ilPropList is now derived from iflList instead of ilIndexableList. Interface changes involved are: virtual functions, iterInit() and iterNext(), are removed from ilPropSet. To iterate through all of the elements in the set, use the methods provided in either iflList or iflHashTable.

The ilSepConvImg constructor takes two new parameters, zKernzel and zsize, to support three dimensional kernel specifications. Two methods, setZkernel() and getZkernel(), were added that support three dimensional kernels. set[X/Y/Z]kernel() takes a new, optional parameter, kernSize.

The constructor for ilSpatialImg no longer takes the parameters inputKernel and biasVal. It does, however, take a new parameter, inImg.

The atomicCreate() method takes one new optional parameter, name. The type of lockp in the same method is now declared differently. ilSpinLock objects now have names for monitoring (turned on with IL_MONITOR_LOCKS). New methods were added, including lock(), unlock(), cset(), getName(), monitoringLocks(), dumpLockStats(), and dumpLocks(). set() and unset() no longer return values.

ilSubImg now has a NULL constructor. ilSubImg is now derived from ilOpImg so its result is cached in memory.

ilRoiImg is now derived from ilCombineImg so its result is cached in memory.

ilMergeImg is now derived from ilOpImg so its result is cached in memory.

ilTieWarpImg now uses the generic warp functionality of ilWarp that is built into ilWarpImg. It is possible to specify the warp using tie points, providing the underlying ilWarp class supports warp inference using tie points. Also, ilTieWarpImg uses ilTiePointList internally to maintain tie points.

The moveTiePoint() method is obsolete because it is no longer possible to reference a tie point by an index.

ilView

Three border callbacks and three post-render callbacks were added to ilView. The border callbacks draw the view borders; the post-render callbacks are called after the view has been rendered. The three border and post-render callbacks are defined as follows:

borderPrepareCB = prepare;
borderRenderCB = render;
borderFinishCB = finish;

postPrepareCB = prepare;
postRenderCB = render;
postFinishCB = finish;

The prepare and finish callbacks are called by an IL compute thread. The render callback is called by the IL render thread to maximize rendering performance. The border callbacks as well as the post-render callbacks can be enabled or disabled.

---

Note: The prepare and finish callbacks may be NULL.

---

Several new border styles were added, including BdrSolidLines, BdrDashedLines, BdrCornerHandles, and BdrMiddleHandles. Use setBorderStyle() to change the border style.

getDel() is now protected instead of private. Its return value is overloaded to XYZ or XY image position (now in floating point). getImgLoc(), a new method, returns the location of an image relative to its window.

Added ability to get/set X event window. This is used to support events that occur in overlay drawables.

ilWarpImg has been substantially rearchitected. The addrGen() method is obsolete, and there are no longer any pure virtuals in ilWarpImg. The warp is now specified by the setWarp() method. The current warp can be accessed using getWarp(). Numerous other internal changes were made to support the new MP methodology.