AXIS Camera Application Platform (ACAP) is an open application platform from Axis. It provides a development platform for software-based solutions and systems built around Axis devices. ACAP is available for various types of Axis products such as cameras, speakers and intercoms.

The ACAP Native SDK is targeted towards users that want to develop plug-in style, event generating applications that fit well into a VMS centric system. This SDK offers high performance by integrating closely with AXIS OS and hardware. Already existing ACAP users should feel at home using this SDK and migrating from previous version ACAP 3 to this SDK should be straightforward.

Please check the following guidelines for ACAP 4:

• AXIS ACAP 4 SDK Documentation
• Introduction
• Getting Started

This repository contains a set of application examples which aims to enrich the developers analytics experience. All examples are using Docker framework and has a README file in its directory which shows overview, example directory structure and step-by-step instructions on how to run applications on the camera.

Below is the list of examples available in the repository.

• axevent
  • The example code is written in C which illustrates both how to subscribe to different events and how to send an event.
• axoverlay
  • The example code is written in C which illustrates how to draw plain boxes and text as overlays in a stream.
• container-example
  • This example demonstrates a way of using containers in a native ACAP application.
• hello-world
  • The example code is written in C and shows how to build a simple hello world application.
• larod
  • The example code is written in C which connects to larod and loads a model, runs inference on it and then finally deletes the loaded model from larod.
• licensekey
  • The example code is written in C which illustrates how to check the licensekey status.
• object-detection
  • The example code focus on object detection, cropping and saving detected objects into jpeg files.
• reproducible-package
  • An example of how to create a reproducible application package.
• shell-script-example
  • A simple hello world application written in shell script.
• tensorflow-to-larod
  • This example covers model conversion, model quantization, image formats and custom models in greater depth than the larod and vdo-larod examples.
• tensorflow-to-larod-artpec8
  • This example is very similar to tensorflow-to-larod, but is designed for AXIS ARTPEC-8 devices.
• using-opencv
  • This example covers how to build, bundle and use OpenCV in an application.
• utility-libraries
  • These examples covers how to build, bundle and use external libraries.
• vdo-larod
  • The example code is written in C and loads an image classification model to larod and then uses vdo to fetch frames of size WIDTH x HEIGHT in yuv format which are converted to interleaved rgb format and then sent to larod for inference on MODEL.
• vdo-larod-preprocessing
  • The example code is written in C and loads an image classification model to larod and then uses vdo to fetch frames of size WIDTH x HEIGHT in yuv format which are sent to larod for preprocessing and inference on MODEL.
• vdo-opencl-filtering
  • This example illustrates how to capture frames from the vdo service, access the received buffer, and finally perform a GPU accelerated Sobel filtering with OpenCL.
• vdostream
  • The example code is written in C which starts a vdo stream and then illustrates how to continuously capture frames from the vdo service, access the received buffer contents as well as the frame metadata.
• web-server
  • The example code is written in C which runs a Monkey web server on the camera and exposes an external API with Reverse Proxy configuration in Apache Server.

The ACAP Native SDK image can be used as a basis for custom built images to run your application or as a developer environment inside the container.

• ACAP Native SDK This image is based on Ubuntu and contains the environment needed for building an AXIS Camera Application Platform (ACAP) Native application. This includes all tools for building and packaging an ACAP Native application as well as API components (header and library files) needed for accessing different parts of the camera firmware.

If you encounter issues with the examples, make sure your product is running the latest firmware version or one that is compatible with the ACAP SDK used. The examples use the ACAP SDK during the build process, of which each version is compatible with a set of firmware versions. The specific SDK version that each example is based on is specified in the Dockerfile used to build the application, through the VERSION variable. The full compatibility schema for ACAP SDK version and firmware version is available at Compatibility for Native SDK.

If the issue persists with a compatible firmware, please create an issue containing the information specified in the template below.

Axis product/device (e.g. Q1615 Mk III):

Device firmware version:

Issue description:

Please visit FAQs page for frequently asked questions.

Apache 2.0