https://github.com/axiscommunications/acap3-examples
Example code for APIs and features in AXIS Camera Application Platform (ACAP) version 3
https://github.com/axiscommunications/acap3-examples
acap analytics axis camera edge video
Last synced: 1 day ago
JSON representation
Example code for APIs and features in AXIS Camera Application Platform (ACAP) version 3
- Host: GitHub
- URL: https://github.com/axiscommunications/acap3-examples
- Owner: AxisCommunications
- License: apache-2.0
- Created: 2020-06-03T07:47:21.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2024-05-01T01:21:45.000Z (about 1 year ago)
- Last Synced: 2024-05-01T02:35:09.648Z (about 1 year ago)
- Topics: acap, analytics, axis, camera, edge, video
- Language: C
- Homepage:
- Size: 6.37 MB
- Stars: 54
- Watchers: 17
- Forks: 20
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS
Awesome Lists containing this project
README
> [!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:
>
> - [ACAP Native SDK example](https://github.com/AxisCommunications/acap-native-sdk-examples)
> - [ACAP Documentation](https://axiscommunications.github.io/acap-documentation)
# What is AXIS Camera Application Platform?
[AXIS Camera Application Platform (ACAP)](https://www.axis.com/support/developer-support/axis-camera-application-platform) is an open application platform that enables members of [Axis Application Development Partner](https://www.axis.com/partners/adp-partner-program) (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:
- [AXIS ACAP 3 SDK Documentation](https://axiscommunications.github.io/acap-documentation/docs/acap-sdk-version-3)
- [Introduction](https://axiscommunications.github.io/acap-documentation/docs/acap-sdk-version-3/introduction)
- [Getting Started](https://axiscommunications.github.io/acap-documentation/docs/acap-sdk-version-3/get-started)
## 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](./axevent/)
- The example code is written in C which illustrates both how to subscribe to different events and how to send an event.
- [axoverlay](./axoverlay/)
- The example code is written in C which illustrates how to draw plain boxes and text as overlays in a stream.
- [hello-world](./hello-world/)
- The example code is written in C and shows how to build a simple hello world application.
- [licensekey](./licensekey/)
- The example code is written in C which illustrates how to check the licensekey status.
- [object-detection](./object-detection/)
- The example code focus on object detection, cropping and saving detected objects into jpeg files.
- [object-detection-cv25](./object-detection-cv25/)
- This example is very similar to object-detection, but is designed for AXIS CV25 devices.
- [reproducible-package](./reproducible-package/)
- An example of how to create a reproducible application package.
- [tensorflow-to-larod](./tensorflow-to-larod/)
- This example covers model conversion, model quantization, image formats and custom models.
- [tensorflow-to-larod-artpec8](./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](./tensorflow-to-larod-cv25/)
- This example is very similar to tensorflow-to-larod, but is designed for AXIS CV25 devices.
- [using-opencv](./using-opencv/)
- This example covers how to build, bundle and use OpenCV with ACAP.
- [utility-libraries](./utility-libraries/)
- These examples covers how to build, bundle and use external libraries with ACAP.
- [vdo-larod](./vdo-larod/)
- The example code is written in C and loads a pretrained person-car classification model to the [Machine learning API (Larod)](https://axiscommunications.github.io/acap-documentation/docs/acap-sdk-version-3/api#machine-learning-api) and then uses the [Video capture API (VDO)](https://axiscommunications.github.io/acap-documentation/docs/acap-sdk-version-3/api#video-capture-api) to fetch video frames in YUV format and finally run inference.
- [vdo-opencl-filtering](./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](./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](https://hub.docker.com/r/axisecp/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:
- [Examples for ACAP SDK v3.1](https://github.com/AxisCommunications/acap3-examples/tree/3.1)
# License
[Apache 2.0](LICENSE)