The L_CC_DetectionInfo structure contains the information (output) detected from the credit card.
struct L_CC_DetectionInfo
{
L_UINT StructSize;
L_CC_ScanFrameStatus Status;
L_BOOL Flipped;
L_UINT YOffset;
L_UINT XOffsets[16];
L_UINT XOffsetsCount;
L_BOOL TopEdgeFound;
L_BOOL BottomEdgeFound;
L_BOOL LeftEdgeFound;
L_BOOL RightEdgeFound;
L_FLOAT FocusScore;
L_UINT Prediction[16];
L_UINT PredictionCount;
L_UINT ExpiryMonth;
L_UINT ExpiryYear;
L_BOOL CreateCardImage;
BITMAPHANDLE* CardImage;
}
typedef struct L_CC_DetectionInfo L_CC_DetectionInfo;
Member |
Description |
StructSize | Size of this structure in bytes, for versioning. Use the sizeof() macro to calculate this value. |
Status | An L_CC_ScanFrameStatus value describing the status of the last detection. |
Flipped | Indicates whether the frame image data was flipped. Valid if Status is L_CC_ScanFrameStatus_NumbersFound. |
YOffset | Y-pixel where the top of the card numbers were found. Valid if Status is L_CC_ScanFrameStatus_NumbersFound. |
XOffsets | Array of the X-pixel offsets of each number on the card. Valid if Status is L_CC_ScanFrameStatus_NumbersFound. |
XOffsetsCount | The number of offsets in XOffsets. Valid if Status is L_CC_ScanFrameStatus_NumbersFound. |
TopEdgeFound | Top edge is found. Valid is Status if L_CC_ScanFrameStatus_NumbersFound or L_CC_ScanFrameStatus_MoreFramesNeeded. |
BottomEdgeFound | Bottom edge is found. Valid if Status is L_CC_ScanFrameStatus_NumbersFound or L_CC_ScanFrameStatus_MoreFramesNeeded. |
LeftEdgeFound | Left edge is found. Valid if Status is L_CC_ScanFrameStatus_NumbersFound or L_CC_ScanFrameStatus_MoreFramesNeeded. |
RightEdgeFound | Right edge is found. Valid if Status is L_CC_ScanFrameStatus_NumbersFound or L_CC_ScanFrameStatus_MoreFramesNeeded. |
FocusScore | Current Focus Score. Valid if Status is L_CC_ScanFrameStatus_NumbersFound or L_CC_ScanFrameStatus_MoreFramesNeeded. |
Prediction | An array representing the current prediction for the credit card number. Valid if Status is L_CC_ScanFrameStatus_NumbersFound. |
PredictionCount | The number of digits in the current prediction for the credit card number. Valid if Status is L_CC_ScanFrameStatus_NumbersFound. |
ExpiryMonth | Month the credit card expires. The month is in its two-digit natural form(January=1, ..., December=12). Valid if Status is L_CC_ScanFrameStatus_NumbersFound. |
ExpiryYear | Year the credit card expires. (4-digit number). Valid if Status is L_CC_ScanFrameStatus_NumbersFound. |
CreateCardImage | If L_TRUE and Status is L_CC_ScanFrameStatus_NumbersFound, a credit card image will be created from the frame image data. |
CardImage | Pointer to the image of the credit card from the last frame. Valid if Status is L_CC_ScanFrameStatus_MoreFramesNeeded or L_CC_ScanFrameStatus_NumbersFound. User is responsible for freeing this image after each call to L_CC_ScanFrame. |
L_CC_DetectionInfo is used with the L_CC_ScanFrame and L_CC_ToCreditCard functions.
Obtaining good results for the ExpiryMonth and ExpiryYear sometimes requires many frames. L_CC_ScanFrame can continue to be called (even after the L_CC_ScanFrameStatus is L_CC_ScanFrameStatus_NumbersFound), as long as ExpiryMonth and ExpiryYear are equal to 0.