Home | History | Annotate | only in /external/opencv
Up to higher level directory
NameDateSize
Android.mk24-Aug-20167.8K
Application.mk24-Aug-2016160
cv/24-Aug-2016
cvaux/24-Aug-2016
cvjni.cpp24-Aug-201624.1K
cvjni.h24-Aug-20169.8K
cxcore/24-Aug-2016
libopencv.mk24-Aug-2016208
LICENSE_Android_NDK24-Aug-2016903
LICENSE_OpenCV24-Aug-20161.8K
ml/24-Aug-2016
MODULE_LICENSE_BSD24-Aug-20160
NOTICE24-Aug-201645K
otherlibs/24-Aug-2016
README.rdoc24-Aug-20165K
VERSION.txt24-Aug-2016193
WLNonFileByteStream.cpp24-Aug-20163.2K
WLNonFileByteStream.h24-Aug-20161.7K

README.rdoc

      1 = OpenCV-Android
      2 
      3 Dedicated to providing an optimized port of OpenCV for the Google Android OS.
      4 
      5 == Requirements
      6 
      7 In order to use OpenCV-Android, you will need to download and install both the Android SDK and NDK version 1.6.  It may or may not work with a higher version. It has been confirmed that this doesn't work with older versions, so please use 1.6 or higher.
      8 
      9 In addition to having the SDK or NDK you will also need to have one of the following:
     10 * An Android Phone Dev Phone (Might work with other phones, has not been tested)
     11 * A newer version of the QuickTime Java Libraries
     12 
     13 For those of you running on the emulator, I built a very simple Socket-based Camera server that will send images over a socket connection.  This uses the QuickTime libraries which are present by default on Mac OS X, but I haven't tested on other OSes.  If it doesn't work for you, you can always try the original WebcamBroadcaster I derived mine from which uses the JMF (which doesn't work with Mac OS X, hence the QTWebcamBroadcaster):
     14 http://www.tomgibara.com/android/camera-source
     15 
     16 == Build
     17 
     18 Building is quite simple.  I'm going to assume that you are familiar with Android if you are reading this and keep it rather short.
     19 
     20 * Create a symbolic link from the directory where you pulled the OpenCV-Android repository to your [ANDROID_NDK_ROOT]/apps/ directory.  Examples:
     21   ln -s ~/Source/OpenCV-Android opencv
     22 
     23 * From the [ANDROID_NDK_ROOT] run:
     24   build/host-setup.sh
     25 
     26 * Now run:
     27   make APP=opencv
     28   
     29 By default, this will build the opencv library and push it into:
     30 [OPENCV_ANDROID_ROOT]/tests/VideoEmulation/libs
     31 
     32 You can change where the lib is delivered by modifying the APP_PROJECT_PATH in:
     33 [OPENCV_ANDROID_ROOT]/Application.mk
     34 
     35 Once you have built the OpenCV library, you can now build and [OPENCV_ANDROID_ROOT]/tests/VideoEmulation.
     36 
     37 <b>NOTE:</b> If you plan to use the Socket Camera, you will need to build and run the [OPENCV_ANDROID_ROOT]/tests/QTWebcamBroadcaster first.  Also, if you use Eclipse to develop Android, there are already projects defined for both of these applications.  You can simply import them into your workspace.
     38 
     39 == Setup
     40 
     41 If you want to test face tracking, then you need to have a Haar Classifier Cascade XML.  I have provided one for use and it is stored in:
     42 tests/haarcascade_frontalface_alt.xml
     43 
     44 Before attempting to run the VideoEmulator application, you must first copy this XML file into the emulator in the following location:
     45 /data/data/org.siprop.opencv/files/haarcascade_frontalface_alt.xml
     46 
     47 Currently, this is a hard-coded path that we look up.  Hopefully, this can be remedied in a future version.
     48 
     49 == Run
     50 
     51 In order to use the VideoEmulator, you have to use the emulator (hence the name.)  If you have a Dev Phone, you can play around with the old 'OpenCVSample' test or modify the VideoEmulator to support a real camera.  This is something we will work on resolving in the future.
     52 
     53 Using the emulator there are two slightly different 'flavors' of running.  Both are socket based cameras, but one is written in C++ and emulates a real OpenCV Capture while the other (loosely) emulates a camera implementation in Java.  The C++ version is the default as it is slightly faster and takes a little less memory.  Also, the ultimate goal is to hook up with a real camera in C++ so that we don't have to pass huge amounts of data (images) back and forth through the JNI interface.
     54 
     55 <b>NOTE:</b> For all of these examples you cannot use localhost or 127.0.0.1 as your address for the socket camera.  The reason is because when the client is running on the Android emulator, both of these map to Android's localhost, not the machine you are running the emulator on.  This means you have to be connected to a network in order to use the socket camera, a limitation.
     56 
     57 === C++
     58 
     59 Since this is the default, we have made it pretty easy...
     60 
     61 * Start the WebcamBroadcaster - this is a socket server that grabs images from your camera and serves them up
     62 * Start the VideoEmulator - this runs the Android application that allows you to try out the various pieces implemented thus far
     63 * Once the application comes up, you will have to configure for your machine address and port for the socket camera to work.
     64 * Leave Use C++ SocketCapture CHECKED!
     65 * Choose which test you want to run.
     66 
     67 === Java
     68 
     69 To use Java, you have to make a small code change.  Eventually we will make this a configurable option without having to make a code change.  The reason is because when we send data over a socket from Java to Java it is faster to send serialized buffered images.  However, when we send data to C++, we have to send a raw byte array.
     70 
     71 * Modify the WebcamBroadcaster by changing the default value assigned to RAW to false.
     72 * Start the WebcamBroadcaster - this is a socket server that grabs images from your camera and serves them up
     73 * Start the VideoEmulator - this runs the Android application that allows you to try out the various pieces implemented thus far
     74 * Once the application comes up, you will have to configure for your machine address and port for the socket camera to work.
     75 * UNCHECK Use C++ SocketCapture!
     76 * Choose which test you want to run.
     77