ImageGear Professional DLL v17.1 for Windows Accusoft
IG_REC_redactor_textcolor_get
Send Feedback  
ImageGear Professional DLL v17.1 for Windows > API Reference Guide > Recognition Component API Reference > Recognition Component Functions Reference > Redactor Functions > IG_REC_redactor_textcolor_get

Glossary Item Box

Gets the text color used to redact match results.

Declaration:

  Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_redactor_textcolor_get(
   const HIG_REC_REDACTOR higRecRedactor,
   AT_RGBQUAD *const  lpColor,
   AT_INT *const  pnDataSize
);

Arguments:

higRecRedactor The handle to a redactor instance.
lpColor Pointer to storage for the text color value.
pnDataSize Pointer to the variable that on input contains size of buffer specified by lpColor parameter. On output it contains number of bytes copied to lpColor buffer:
  • If text color is specified for the redactor then this value is copied into output buffer lpColor and number of bytes copied is placed into pnDataSize.
  • If lpColor is NULL and pnDataSize is not NULL then on output pnDataSize contains the size of AT_RGBQUAD structure.
  • If lpColor is not NULL and pnDataSize is not NULL and there is no current text color for the redactor then on output pnDataSize contains zero.

Return Value:

The number of ImageGear errors that occurred during this function call. If there are no errors, the return value is IGE_SUCCESS.

Supported Raster Image Formats:

This function does not process image pixels.

Remarks:

This color is used when drawing text onto the redacted image.

The default value is NULL.

If text color is NULL, then the redactor will not draw the replacement text onto the redacted image.

Example:

  Copy Code
AT_ERRCOUNT errCount = 0 ;
HIG_REC_REDACTOR higRedactor = 0 ;
AT_RGBQUAD text_color = {0} ;
AT_INT bytes_written = 0 ; 

IG_REC_redactor_create( &higRedactor ) ;
errCount = IG_REC_redactor_textcolor_get 
                          ( higRedactor, 
                            &text_color,
                            &bytes_written
                          ) ;
IG_REC_redactor_delete( higRedactor ) ;

See Also

HIG_REC_REDACTOR

©2012. Accusoft Corporation. All Rights Reserved.