enumIGArtBurnInMode Enumeration

Description:

Enumerates the various image burn-in modes when calling ImageBurnIn Method.

Values:

burnInAll	Burns in all annotation marks.
burnInDeleteMarks	Deletes affected marks after burning them in.
burnInGroup	Burns in a group of marks.
burnInList	Burns in a list of marks.
burnInVisible	Burns in all visible marks.
burnInSelected	Burns in all selected marks.
burnInPromoteAuto	"Or" with any of the above. Automatically promotes the bit depth of the IGPage Object image to allow the marks to blend with it. The image is automatically reduced in bit depth after the mark(s) are burned in.
burnInPromoteNone	"Or" with any of the first 4 above. No bit depth promotion is made before the marks are burned in.
burnInThreshold	"Or" with ART_BURN_IN_AUTO_PROMOTE: Set threshold method for color reduction.

Remarks:

The settings ART_BURN_IN_AUTO_PROMOTE and ART_BURN_IN_NO_PROMOTE affect whether the IGPage Object image undergoes a bit depth promotion before the marks are burned in.

There are three variants of this method behavior for the bit depth promotion:

1. Default behavior (neither ART_BURN_IN_AUTO_PROMOTEnorART_BURN_IN_NO_PROMOTEis used):

For 1-bit images: promote to 8, burn-in, then reduce back to 1.
For 4 and 8: promote to 24, burn-in, then reduce to original bit depth.
For 24: no promote, burn-in, and no reducing.

2. When ART_BURN_IN_NO_PROMOTE is used:

All promotion is suppressed.

3. When ART_BURN_IN_AUTO_PROMOTE is used:

For 1 and 4-bit images: promote to 24, burn-in, then reduce to 4 bits per pixel.
For 8-bit images: promote to 24, burn-in, then reduce to 8 bits per pixel.
For 24: no promote, burn-in, and no reducing.