(enumerated)
(See Notes)
(enumerated)
Does not change the colors of annotations for non-bilevel images (for example, color and gray-scale images)| Example-VB | Example-VC++ |
Burns annotations onto an image, causing them to be permanently incorporated into the image. Use this method with caution because once annotations are burned-in, they can no longer be removed or modified.
| Ö | Imaging for Windows Professional Edition V1.0, V1.1, and V2.0 |
| Ö | Imaging for Windows 95 and 98 |
| Ö | Imaging for Windows NT 4.0 |
Image Edit control
object.BurnInAnnotations Option,MarkOption[,GroupName]
| Parameter | Data Type | Setting | Description |
| Option | Integer (enumerated) |
0 | All annotations marks, invisible and visible, are saved to the base image |
| 1 | All annotations that are visible are saved to the base image | ||
| 2 | All annotations that are selected are saved to the base image | ||
| MarkOption (See Notes) |
Integer (enumerated) |
0 | Changes annotations to black (on black-and-white images only) |
| 1 | Changes annotations to white (on black-and-white images only) | ||
| 2 | Default rendering Does not change the colors of annotations for non-bilevel images (for example, color and gray-scale images) |
||
| GroupName | String | Name | The name of the group that contains the annotations (if specified, the Option parameter is ignored) |
MarkOption Set to 0
For black-and-white page types, the BurnInAnnotations method with a MarkOption of 0 changes annotations to black.
MarkOption Set to 1
For black-and-white page types, the BurnInAnnotations method with a MarkOption of 1 changes annotations to white.
MarkOption Set to 2
For black-and-white page types, the BurnInAnnotations method with a MarkOption of 2 changes annotations to black, white, or black-and-white dither patterns based on the type of annotation mark, its color, and its transparency setting. Refer to the following list:
| Annotation Type | MarkOption2 Burn-In Format |
| Attach-a-Note | Burned-in as a black or white rectangle based on the original background color, with text burned-in as black or white based on the original color of the font. Light colors, like yellow, are burned-in as white; dark colors, like red, are burned-in as black. The underlying image data is obscured. |
| Freehand Line, Hollow Rectangle, Straight Line, Text, Text From File, and Text Stamp Hyperlink |
Burned-in as black or white based on the original color of the annotation. Light colors, like yellow, are burned-in as white; dark colors, like red, are burned-in as black. Linked annotations cease to function as hypertext jumps when they are burned in. |
| Filled Rectangle | Burned-in as black-and-white dithered rectangles. The underlying image data is obscured. |
| Highlighter | Burned-in as black-and-white transparent dithered rectangles. The underlying image data is visible. |
| Image Embedded and Image Reference |
Burned-in as a black-and-white representation of the original image. |
| OCR Zones | You cannot burn-in OCR Zone annotations. |
For all other page types, the BurnInAnnotations method with a MarkOption of 2 burns annotations onto the image using the displayed colors. Then it converts the image to a 24-bit color image (BGR24 or RGB24). Because 24-bit color images require a large amount of memory and disk space, use caution when selecting this option. To minimize the memory and disk space requirements of 24-bit color images, you can use the SaveAs or Save Page method to save the 24-bit color images as 8-bit Palettized images (recommended).
To save color annotations on a black-and-white image, use the ConvertPageType method to convert the image to a page type other than black-and-white. Then invoke the BurnInAnnotations method with a Mark Option of 2; the BurnInAnnotations method burns the annotations onto the image in color.
None
After invoking the BurnInAnnotations method, the Save, SaveAs, or SavePage method must be invoked to save the combined image and annotation.
When a GroupName is specified, the Option parameter is ignored and all annotation marks in the specified GroupName are burned-in.
Keep in mind that if you burn-in a Hyperlink annotation, it ceases to function as a hypertext jump.
Invoking the BurnInAnnotations method sets the ImageModified property to True.
Note: Hyperlink and OCR Zone annotations are available with Imaging for Windows Professional Edition V1.0, V1.1, and V2.0 only.