Extract Driver's License AAMVA Barcode - Python

This tutorial shows how to perform data extraction from a PDF417 barcode that follows the AAMVA specification in a Python Console application using the LEADTOOLS SDK.

Required Knowledge

Before working on the Extract Driver's License AAMVA Barcode - Python tutorial, get familiar with the basic steps of creating a project by reviewing the Add References and Set a License and Load and Save Images tutorials. Saving the image is not necessary in this tutorial, so comment out or remove the saving code.

Create the Project and Add the LEADTOOLS References

Start with a copy of the project created in the Load and Save Images tutorial. If you do not have that project, follow the steps in that tutorial to create it.

This tutorial requires the following .net DLLs:

• Leadtools.dll
• Leadtools.Barcode.dll
• Leadtools.Codecs.dll

For a complete list of which DLLs are required for specific barcode features, refer to Barcode Support.

Set the License File

The License unlocks the features needed for the project. It must be set before any toolkit function is called. For details, including tutorials for different platforms, refer to Setting a Runtime License.

There are two types of runtime licenses:

• Evaluation license, obtained at the time the evaluation toolkit is downloaded. It allows the toolkit to be evaluated.
• Deployment license. If a Deployment license file and developer key are required, refer to Obtaining a License.

Add the AAMVA PDF417 Extraction Code

With the project created, the references added, the license set, and the load image code added, coding can begin.

In the Solution Explorer, open Project-Name.py and place the following references below the "Add references to LEADTOOLS" comment

# Add references to LEADTOOLS 
from leadtools import LibraryLoader 
LibraryLoader.add_reference("Leadtools") 
from Leadtools import * 
LibraryLoader.add_reference("Leadtools.Codecs") 
from Leadtools.Codecs import * 
LibraryLoader.add_reference("Leadtools.Barcode") 
from Leadtools.Barcode import * 
 
from System.IO import * 

Add a new method called load_image(filename). Call the new method in the main() method below the set_license call. Add the below code to the new method, use the commented code when using Memory Stream.

def load_image(filename): 
    codecs = RasterCodecs() 
 
    # If Wanting to load from memory 
    # byte = File.ReadAllBytes(filename) 
    # ms = MemoryStream(byte) 
    # ms.Position = 0 
    # return codecs.Load(filename) 
 
    return codecs.Load(filename) 

Add a new method called extract_pdf417_data(image). Call the new method in the main() method below the load_image(r"C:\LEADTOOLS23\Resources\Images\license_sample_rear_aamva.png") call.

def main(): 
 
    Support.set_license(os.path.join(DemosTools.get_root(), "C:/LEADTOOLS23/Support/Common/License")) 
 
    image = load_image(r"C:\LEADTOOLS23\Resources\Images\license_sample_rear_aamva.png") 
    extract_pdf417_data(image) 

The method's parameter will be the RasterImage loaded in the load_image() method. This tutorial uses this AAMVA PDF417 sample image. Add the below PDF417 AAMVA extraction code inside the new method.

def extract_pdf417_data(image): 
 
    engine = BarcodeEngine() 
    data = engine.Reader.ReadBarcode(image, LeadRect.Empty, BarcodeSymbology.PDF417) 
    if (data.Value != None and data.Symbology == BarcodeSymbology.PDF417): 
        id = BarcodeData.ParseAAMVAData(data.GetData(), False) 
        if (id != None): 
            print("AAMVA PDF417 Barcode Found!\n" +  
               "===============================================") 
            print(f"Issuer Identification Number: {id.IssuerIdentificationNumber}\n" +  
               f"First Name: {id.FirstName.Value}\n" +  
               f"Last Name: {id.LastName.Value}\n" +  
               f"Over 21? {id.Over21}\n")  
        else: 
            print("Does not meet AAMVA specifications") 
    else: 
        print("PDF417 Barcode Not Found!") 

Note: There are more properties inside the AAMVAID class, the snippet above showcases a few commonly used properties.

Run the Project

Run the project by pressing F5, or by selecting Debug -> Start Debugging.

If the steps were followed correctly, the application runs and displays the data inside the PDF417 Barcode.

Wrap-Up

This tutorial showed how to use the BarcodeData and AAMVAID classes.

See Also

• LEADTOOLS BarcodeEngine Documentation
• LEADTOOLS BarcodeData Documentation
• LEADTOOLS AAMVAID Documentation
• LEADTOOLS SDK Download