Skip to content

AxisCommunications/acap3-examples

Important

This repository has examples for ACAP version 3 SDK, which is not the latest version and might therefore not get updates, bug fixes or answers on tickets as frequently.

It's recommended to move to ACAP version 4 SDK which is the active track:

What is AXIS Camera Application Platform?

AXIS Camera Application Platform (ACAP) is an open application platform that enables members of Axis Application Development Partner (ADP) Program to develop applications that can be downloaded and installed on Axis network cameras and video encoders. ACAP makes it possible to develop applications for a wide range of use cases:

  • Security applications that improve surveillance systems and facilitate investigation.
  • Business intelligence applications that improve business efficiency.
  • Camera feature plug-ins that add value beyond the Axis product's core functionality

ACAP SDK version 3

ACAP is Axis own open platform for applications that run on-board an Axis product. If you are new to ACAP, start with learning more about the platform:

Getting started with the repository

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.

Example applications

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.
  • hello-world
    • The example code is written in C and shows how to build a simple hello world application.
  • 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.
  • object-detection-cv25
    • This example is very similar to object-detection, but is designed for AXIS CV25 devices.
  • reproducible-package
    • An example of how to create a reproducible application package.
  • tensorflow-to-larod
    • This example covers model conversion, model quantization, image formats and custom models.
  • tensorflow-to-larod-artpec8
    • This example is very similar to tensorflow-to-larod, but is designed for AXIS ARTPEC-8 devices.
  • tensorflow-to-larod-cv25
    • This example is very similar to tensorflow-to-larod, but is designed for AXIS CV25 devices.
  • using-opencv
    • This example covers how to build, bundle and use OpenCV with ACAP.
  • utility-libraries
    • These examples covers how to build, bundle and use external libraries with ACAP.
  • vdo-larod
  • 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.

Docker Hub image

The ACAP SDK image can be used as a basis for custom built images to run your application or as a developer environment inside the container. The image is public and free to use for anyone.

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

Long term support (LTS)

Examples for older versions of the ACAP SDK can been found here:

License

Apache 2.0