OpenALPR Commercial 64-bit binaries for Windows
=================================================

Test the program by opening the openalprnet-windemo.exe file.  Click the "Detect License Plate" button and select the "samples/us-1.jpg" image.
The top 20 possible results should show up on the middle-right pane.  The image of the cropped license plate should show up in the bottom-right pane.


Licensing
-----------

Before running the software you must obtain a commercial license key.  Please contact info@openalpr.com to request an evaluation key.
Paste the license key in the license.conf file to begin using the software.  Alternatively, you can set the license as an environment variable 
named OPENALPR_LICENSE_KEY.


CLI Application
---------------

alpr.exe is a command-line application that can analyze license plates.  Type alpr --help from the Windows command prompt for more information.

Examples: 

    # Recognize a US-style plate
    alpr -c us samples/us-1.jpg

    # Recognize a US-style plate and measure the processing time
    alpr -c us --clock samples/us-1.jpg

    # Recognize a European-style plate with JSON output
    alpr -c eu -j samples/eu-1.jpg

    # Get the top 30 possible plate numbers and match it against the Texas (tx) format
    alpr -p tx -n 30 samples/us-4.jpg



API Integration
----------

OpenALPR is written in C++ and has native support for integrating with C/C++ applications.

To include OpenALPR in your C/C++ application, include the alpr_c.h file in the include directory.  You must also link the libopenalprc.dll 
shared library to your code. 

OpenALPR also includes bindings for C#, Java, and Python.  Each of these bindings fully implement the OpenALPR API.

All of the DLLs in the root directory are required at runtime in order for the application to function.  If you run OpenALPR in C#, Java, 
or Python, for example, the native DLLs must be accessible to the program so that it can load.


C#
----

The C# integration is bundled into the DLL file "alprnet.dll"  You should add this as a reference to your .NET application to use the functionality.
You may also include the C# binding source code in your project.

The C# library includes two example applications.  The full source code is available at 
https://github.com/openalpr/openalpr/tree/master/src/bindings/csharp


Java
-------

Run the java_test.bat program to test the Java integration.  This assumes that javac and java are available on your system PATH.  

The java integration uses Java Native Interface (JNI) to connect java code to OpenALPR.  This requires the openalprjni.dll file is available at runtime. 
The java source code is in java/com/openalpr/jni and there is in example located in java/Main.java


Python
--------

Run the python_test.bat program to test the Python integration.  This assumes that python is available on your system PATH.

The Python integration uses ctypes to bind the OpenALPR functions to Python code.  This requires the libopenalprpy.dll file is available at runtime.
The python code is located in python/openalpr.py.  There is a test program in python/test.py


Additional Documentation
--------------------------

Please visit http://doc.openalpr.com for additional documentation