diff --git a/annotated.html b/annotated.html index 058ffe4..d032349 100644 --- a/annotated.html +++ b/annotated.html @@ -107,7 +107,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search'); diff --git a/classes.html b/classes.html index f593c61..f09543e 100644 --- a/classes.html +++ b/classes.html @@ -112,7 +112,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search'); diff --git a/files.html b/files.html index 4b527df..7dff409 100644 --- a/files.html +++ b/files.html @@ -110,7 +110,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search'); diff --git a/globals.html b/globals.html index b69e481..9538a29 100644 --- a/globals.html +++ b/globals.html @@ -271,7 +271,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search'); diff --git a/globals_defs.html b/globals_defs.html index b7615b6..52d38ee 100644 --- a/globals_defs.html +++ b/globals_defs.html @@ -121,7 +121,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search'); diff --git a/globals_func.html b/globals_func.html index 904731f..6a157a4 100644 --- a/globals_func.html +++ b/globals_func.html @@ -249,7 +249,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search'); diff --git a/index.html b/index.html index 30e4de3..430b260 100644 --- a/index.html +++ b/index.html @@ -81,7 +81,6 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
Author:
Bradlee Speice <bspeice@uncc.edu>
-
Date:
7/18/2012

Introduction

Welcome to Libcvautomation! Libcvautomation is a GUI automation and testing tool based on image recognition and response. This program was designed as a direct replacement for Sikuli and Xpresser. I was having incredible difficulty getting either of these solutions to work - Sikuli would crash whenever I tried to take a screenshot, and Xpresser was both too new for our Prominent North American Enterprise Linux systems, but also didn't work or import correctly. I really liked the way each of these programs approached GUI automation, but they simply didn't work. Additionally, I wanted to create a simple solution - it does what you want it to, and that's it.

@@ -89,7 +88,46 @@ Introduction How Libcvautomation Works

Libcvautomation represents two software products coming together - OpenCV and the XTest extension to the X11 server. OpenCV is used for image recognition, and XTest is used to actually drive the X server. You can dig into libcvautomation-xtest.h to get an idea of what all this library is capable of.
Basically what happens is that for whenever you need to do image recognition, OpenCV is used to find the images, and XTest is used to generate any events needed. Libcvautomation is mostly a wrapper to integrate both of these products, but also adds some functions like matchSubImage_X11() that allow you to match an image against the X11 root window in place. This means no more 'xwd | convert "<out_name>"'.

-

+

+Installing Libcvautomation

+

Installing Libcvautomation is easy. You can either manually install packages, add the Libcvautomation repository, or install from tarball (the first option is recommended).

+

+Install Libcvautomation RPM Repository

+

If you want to make sure that you're using the latest (stable) version of Libcvautomation, you can add the Libcvautomation repository to yum. First, a new configuration file for the Libcvautomation repository:

+
 sudo vim /etc/yum.repos.d/libcvautomation.repo 
+

After you have the file open, put the following content in it:

+
 [libcvautomation]
+ name=Libcvautomation RPM repository
+ baseurl=http://djbushido.github.com/libcvautomation/rpm
+ enabled=1
+ gpgcheck=0 
+

And once this is done, clean out the cache, and you should be good to go!

+
 sudo yum clean all 
+

Finally, if you want to begin developing application tests, you will need the following packages: libcvautomation, and libcvautomation-examples.

+

+Install Libcvautomation APT Repository

+

If you want to make sure that you're using the latest (stable) version of Libcvautomation, you can add the Libcvautomation repository to APT. First, open up your sources.list

+
 sudo vim /etc/apt/sources.list 
+

Add the following content at the end:

+
 #Libcvautomation Repository
+ deb http://djbushido.github.com/libcvautomation/apt libcvautomation/
+ deb-src http://djbushido.github.com/libcvautomation/apt libcvautomation-source/ 
+

Run an update to make sure your packages refresh, and then you should be good to go!

+
 sudo apt-get update 
+

Finally, if you want to begin developing application tests, you will need the following packages: libcvautomation-dev, and libcvautomation-examples.

+

+Manual Download Packages

+

If you want to manually download the packages, see the Github downloads page for libcvautomation: https://github.com/DjBushido/libcvautomation/downloads

+

+Manual Tarball Installation

+

If you want to install Libcvautomation via tarball, you can do that too. Download a release tarball from the Downloads page on Github: https://github.com/DjBushido/libcvautomation/downloads The source itself uses autotools, so it's incredibly easy to work with:

+
 cd <location_of_tarball>
+ tar xf <tarball_file>
+ cd libcvautomation-<release_number>
+ ./configure
+ make
+ sudo make install 
+

Using Libcvautomation And Writing Application Tests

So how does one go about using libcvautomation?
I'm so glad you asked! I've provided a few reference programs - cva-match and cva-input - that can be used to demonstrate most of libcvautomation's capabilities. I've even provided a BASH wrapper to make it incredibly easy to use BASH with libcvautomation as well (requires that cva-match and cva-input are installed). Python bindings are on their way too.
@@ -115,7 +153,7 @@ Questions? Comments? Concerns?

diff --git a/libcvautomation-opencv_8h.html b/libcvautomation-opencv_8h.html index 7de82f1..85b3cfa 100644 --- a/libcvautomation-opencv_8h.html +++ b/libcvautomation-opencv_8h.html @@ -118,7 +118,6 @@ Functions

The source code to access libcv from inside libcvautomation.

This source file builds in the necessary functionality to use libcv functions inside libcvautomation.

Author:
Bradlee Speice
-
Date:
7/18/2012

Definition in file libcvautomation-opencv.h.


Function Documentation

@@ -533,7 +532,7 @@ Functions diff --git a/libcvautomation-opencv_8h_source.html b/libcvautomation-opencv_8h_source.html index 7d58d86..420fd8a 100644 --- a/libcvautomation-opencv_8h_source.html +++ b/libcvautomation-opencv_8h_source.html @@ -161,7 +161,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search'); diff --git a/libcvautomation-xlib_8h.html b/libcvautomation-xlib_8h.html index 1efeb00..ff99ec9 100644 --- a/libcvautomation-xlib_8h.html +++ b/libcvautomation-xlib_8h.html @@ -114,7 +114,6 @@ Functions

The source code to access Xlib from inside libcvautomation.

This source file builds in the necessary functionality to use xlib functions inside libcvautomation.

Author:
Bradlee Speice
-
Date:
7/18/2012

Definition in file libcvautomation-xlib.h.


Function Documentation

@@ -405,7 +404,7 @@ The program using this library is responsible to close the display as well. diff --git a/libcvautomation-xlib_8h_source.html b/libcvautomation-xlib_8h_source.html index 5872e14..ecec9b2 100644 --- a/libcvautomation-xlib_8h_source.html +++ b/libcvautomation-xlib_8h_source.html @@ -147,7 +147,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search'); diff --git a/libcvautomation-xtest_8h.html b/libcvautomation-xtest_8h.html index 38bd971..cddac74 100644 --- a/libcvautomation-xtest_8h.html +++ b/libcvautomation-xtest_8h.html @@ -164,7 +164,6 @@ Functions

The source code to access the XTest extension inside libcvautomation.

This source file builds in the necessary functionality to drive the X11 server in libcvautomation

Author:
Bradlee Speice
-
Date:
7/18/2012

Definition in file libcvautomation-xtest.h.


Define Documentation

@@ -1434,7 +1433,7 @@ Functions diff --git a/libcvautomation-xtest_8h_source.html b/libcvautomation-xtest_8h_source.html index ff3c470..dfda24b 100644 --- a/libcvautomation-xtest_8h_source.html +++ b/libcvautomation-xtest_8h_source.html @@ -221,7 +221,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search'); diff --git a/libcvautomation.html b/libcvautomation.html index f262d0a..55b40f5 100644 --- a/libcvautomation.html +++ b/libcvautomation.html @@ -77,7 +77,6 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
Author:
Bradlee Speice <bspeice@uncc.edu>
-
Date:
7/18/2012

Introduction

Welcome to Libcvautomation! Libcvautomation is a GUI automation and testing tool based on image recognition and response. This program was designed as a direct replacement for Sikuli and Xpresser. I was having incredible difficulty getting either of these solutions to work - Sikuli would crash whenever I tried to take a screenshot, and Xpresser was both too new for our Prominent North American Enterprise Linux systems, but also didn't work or import correctly. I really liked the way each of these programs approached GUI automation, but they simply didn't work. Additionally, I wanted to create a simple solution - it does what you want it to, and that's it.

@@ -111,7 +110,7 @@ Questions? Comments? Concerns? diff --git a/libcvautomation_8h.html b/libcvautomation_8h.html index db606af..7c7d516 100644 --- a/libcvautomation_8h.html +++ b/libcvautomation_8h.html @@ -125,7 +125,6 @@ Defines

The top-level include for all projects involving libcvautomation.

This source file includes all other files needed for libcvautomation projects, and also defines the cvautomationList and cvaPoint structs to be used among libcvautomation functions.

Author:
Bradlee Speice
-
Date:
7/18/2012

Definition in file libcvautomation.h.


Define Documentation

@@ -179,7 +178,7 @@ Defines diff --git a/libcvautomation_8h_source.html b/libcvautomation_8h_source.html index 79b88ac..99920f1 100644 --- a/libcvautomation_8h_source.html +++ b/libcvautomation_8h_source.html @@ -171,7 +171,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search'); diff --git a/libcvautomation_search_methods.html b/libcvautomation_search_methods.html index 60c8ca1..a2138bd 100644 --- a/libcvautomation_search_methods.html +++ b/libcvautomation_search_methods.html @@ -141,7 +141,7 @@ Correlation Coefficient (Normalized) diff --git a/pages.html b/pages.html index 662d50d..9116415 100644 --- a/pages.html +++ b/pages.html @@ -112,7 +112,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search'); diff --git a/structcvaPoint-members.html b/structcvaPoint-members.html index 54c2383..e5bafaa 100644 --- a/structcvaPoint-members.html +++ b/structcvaPoint-members.html @@ -106,7 +106,7 @@ This is the complete list of members for diff --git a/structcvaPoint.html b/structcvaPoint.html index 044a31a..d60d705 100644 --- a/structcvaPoint.html +++ b/structcvaPoint.html @@ -134,7 +134,7 @@ int y diff --git a/structcvautomationList-members.html b/structcvautomationList-members.html index 604e53e..c0fcdc0 100644 --- a/structcvautomationList-members.html +++ b/structcvautomationList-members.html @@ -109,7 +109,7 @@ This is the complete list of members for diff --git a/structcvautomationList.html b/structcvautomationList.html index 213f7e7..4301171 100644 --- a/structcvautomationList.html +++ b/structcvautomationList.html @@ -145,7 +145,7 @@ int tolerance diff --git a/wrapper_functions.html b/wrapper_functions.html index af39faf..78901c6 100644 --- a/wrapper_functions.html +++ b/wrapper_functions.html @@ -219,7 +219,7 @@ Useful extras diff --git a/writing_app_tests.html b/writing_app_tests.html index 585f481..4fbef14 100644 --- a/writing_app_tests.html +++ b/writing_app_tests.html @@ -81,7 +81,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
Author:
Bradlee Speice <bspeice@uncc.edu>
-
Date:
7/18/2012
+
Date:
7/23/2012

Audience