The kimage_proc library (libkip.a) contains image processing operators such as frequency filter generation, color compression, data generation, image filtering, postscript conversion, rotation, and geometric warping. All kimage_proc functions are written to operate on width-height planes of the polymorphic data model. If the depth, time, or elements dimensions of data object are greater than one, the operation is repeated for each width-height plane. The kimage_proc operators are implemented using the polymorphic data services, which is a part of the Khoros 2.0 kappserv library. .IP "Side Effects" The function calls in kimage_proc should have no side effects on the source objects passed into them, and should only affect those segments and attributes of the destination object that the operation needs to modify. For example, if a destination object is passed in that already has value, mask, and geometry data, and a multiplication operation is performed on the source value data, the destination mask and geometry data will not be modified, and will remain intact.
Each function call frees all memory that has been allocated within the call, and closes all temporary objects that were opened within the call. The function call will not free memory or close objects that were passed into it. .IP "DISCLAIMER \(em WARNING" The kimage_proc library is in its first prototype stage, therefore, the behavior and API of these functions may change in the future.
ALL programs that utilize these function calls MUST include the statement:
#include <image.h>
$IMAGE/objects/library/kimage_proc/src
$IMAGE/include/kimage_proc/kimage_proc.h
#include <image.h>