ImageGear .NET v25.2 - Updated
ImageGear.Art Assembly / ImageGear.ART Namespace / ImGearART Class / BurnIn Method
ImageGear.Core.ImGearPage class to burn marks in.
ART page to get marks from.
BurnIn options.
List of group indexes to apply burn in to, null - all groups.
Example




In This Topic
    BurnIn Method
    In This Topic
    Merges marks permanently into ImageGear.Core.ImGearPage class.
    Syntax
    'Declaration
     
    Public Shared Function BurnIn( _
       ByVal page As ImGearPage, _
       ByVal artPage As ImGearARTPage, _
       ByVal burnOptions As ImGearARTBurnInOptions, _
       ByVal groupIndexes() As Integer _
    ) As ImGearPage
    'Usage
     
    Dim page As ImGearPage
    Dim artPage As ImGearARTPage
    Dim burnOptions As ImGearARTBurnInOptions
    Dim groupIndexes() As Integer
    Dim value As ImGearPage
     
    value = ImGearART.BurnIn(page, artPage, burnOptions, groupIndexes)
    public static ImGearPage BurnIn( 
       ImGearPage page,
       ImGearARTPage artPage,
       ImGearARTBurnInOptions burnOptions,
       int[] groupIndexes
    )
    public: static ImGearPage* BurnIn( 
       ImGearPage* page,
       ImGearARTPage* artPage,
       ImGearARTBurnInOptions burnOptions,
       int[]* groupIndexes
    ) 

    Parameters

    page
    ImageGear.Core.ImGearPage class to burn marks in.
    artPage
    ART page to get marks from.
    burnOptions
    BurnIn options.
    groupIndexes
    List of group indexes to apply burn in to, null - all groups.

    Return Value

    Remarks
    The marks are converted from vector-format constructs into raster-format. The image may be temporarily promoted to a higher bit-depth for the purpose of the merge (see ImGearARTBurnInOptions enumeration).
    Example
    // Select half of the annotations.
    int count = 0;
    foreach (ImGearARTMark igARTMark in igARTPage)
    {
        if (count++ % 2 == 1)
            igARTPage.MarkSelect(igARTMark, true);
    }
    // Burn the selected annotations into the image.
    ImGearPage igPageNew = ImGearART.BurnIn(igPage, igARTPage, ImGearARTBurnInOptions.SELECTED, null);
    igPageView.Page = igPageNew;
    // Remove the burned in annotations from the art page.
    foreach (ImGearARTMark igARTMark in igARTPage)
    {
        if (igARTPage.MarkIsSelected(igARTMark))
            igARTPage.MarkRemove(igARTMark);
    }
    ' Select half of the annotations.
    Dim count As Integer = 0
    For Each igARTMark As ImGearARTMark In igARTPage
        If System.Math.Max(System.Threading.Interlocked.Increment(count), count - 1) Mod 2 = 1 Then
            igARTPage.MarkSelect(igARTMark, True)
        End If
    Next
    ' Burn the selected annotations into the image.
    Dim igPageNew As ImGearPage = ImGearART.BurnIn(igPage, igARTPage, ImGearARTBurnInOptions.SELECTED, Nothing)
    igPageView.Page = igPageNew
    ' Remove the burned in annotations from the art page.
    For Each igARTMark As ImGearARTMark In igARTPage
        If igARTPage.MarkIsSelected(igARTMark) Then
            igARTPage.MarkRemove(igARTMark)
        End If
    Next
    See Also