openpnp-capture-java

Java bindings for https://github.com/openpnp/openpnp-capture. Releases include all platform binaries and support auto extraction for a "plug and play" experience. Simply install the Maven dependency and start capturing!

Usage

Maven

<dependency>
	<groupId>org.openpnp</groupId>
	<artifactId>openpnp-capture-java</artifactId>
</dependency>

Example

public static void main(String[] args) {
    OpenPnpCapture capture = new OpenPnpCapture();
    CaptureDevice device = capture.getDevices().get(0);
    CaptureFormat format = device.getFormats().get(0);
    CaptureStream stream = device.openStream(format);
    BufferedImage image = stream.capture();
}

Build

See https://github.com/openpnp/openpnp-capture/releases to pick a release of the native library to build against and specify it's tag name in the next command.

./scripts/download-openpnp-capture.sh <RELEASE>
mvn clean package

Release

To release a new version to Github Releases and Maven central:

Note, on OS X it may be neccessary to run export GPG_TTY=$(tty) before running the below commands. See pstadler/keybase-gpg-github#11.

Choose an OpenPnP Capture release from https://github.com/openpnp/openpnp-capture/releases.
Update the before_install line in .travis.yml to include that release name.
Update the version in pom.xml. Should match release. Append -n for sub-releases.
Run ./scripts/download-openpnp-capture.sh <RELEASE>
mvn clean deploy
Tag the release with the new version number and push to master.
Travis will build the release and post it to Github.