This function retrieves the digital watermark from a raster image.
Parameters
| Name | Explanation |
|---|---|
| Handle1 | The image handle of the original image. This is the image without a digital watermark that is used as a key to compare to another image and check if a watermark exists (24 bit color images only). |
| Handle2 | The image handle of the image that contains the watermark (24 bit color images only). |
| Level | The level at which to retrieve the watermark. (From -20 to 20 ) |
| UserProc | The address of the user function (If not using the user function then set to 0) |
| Caption | Sets the text displayed in the title bar of the progress dialog box |
| Message | Sets the message displayed in the progress dialog box |
| Button | Sets the name of the button displayed in the progress dialog box |
Return Value
Returns the raster image handle if successful (1 bit image). Returns 0 if unsuccessful.
Explanation
The IKCheckSecretImage function retrieves the digital watermark from a raster image whose watermark has been set with the IKSetSecretImage function. It CANNOT retrieve other types of watermarks.
To check whether an image contains a watermark, set the image handle of the original image in the Handle1 parameter and set the image handle of the image suspected to contain the watermark in the Handle2 parameter. The Level parameter should be set to a value that is the same as or slighly smaller than the Level at which the watermark was embedded into the image using the IKSetSecretImage function. Using a Level to retrieve the watermark that differs significantly from the Level at which the watermark was set can result in no watermark being retrieved. Furthermore, the orginal image and the watermarked image must be exactly the same size. If either image has been resized, no watermark can be retrieved. Furthermore, the orginal image and the watermarked image must be exactly the same size. If either image has been resized, no watermark can be retrieved.
The IKCheckSecretImage function returns the results, the image handle of a 1 bit raster image, if successful. If unsuccessful, 0 is returned. Note that neither Handle1 or Handle2 are freed after this method is executed.
If the user function is set or if the Caption, Message, and Button parameters are blank then the Progress dialog box is not displayed. If the Progress dialog box is displayed, it indicates the percentage of the current process completed. For more information about the user function please refer to the Definition of User Function in the Ik10Effect.dll, Ik10EffectA.dll, Ik10Effect64.dll, Ik10Effect64A.dlll section.