actfw-jetson 0.1.0a1

actfw's additional components for Jetson series

actfw-jetson

actfw's components for Jetson series. actfw is a framework for Actcast Application written in Python.

Installation

sudo apt-get update
sudo apt-get install -y python3-pip python3-pil 

# Install GStreamer dependencies (some components in actfw-jetson uses GStreamer in implementation)
sudo apt-get install libgstreamer1.0-dev libgirepository1.0-dev ibgstreamer-plugins-base1.0-dev libglib2.0-dev

pip3 install actfw-jetson

Document

• API References

Usage

See actfw-core for basic usage.

Note that an application using actfw-jetson may call actfw_gstreamer.init() at first if it uses at least 1 component depending on GStreamer.

actfw-jetson provides:

• actfw_jetson.Display : Display using nvoverlaysink element in NVIDIA's Accelerated GStreamer.

Example

• example/hello_jetson : The simplest application example for Jetson
  • Use HDMI display as 1280x720 area
  • Generate 1280x720 single-colored image
  • Draw "Hello, Actcast!" text
  • Display it as 1280x720 image
  • Notice message for each frame
  • Support application heartbeat
  • Support "Take Photo" command
  • Depends: fonts-dejavu-core

Development Guide

Installation of dev requirements

pip3 install pipenv
pipenv install --ignore-pipfile --dev -e .

Running tests

pipenv run nose2 -v

Running examples

On a Jetson Nano connected to HDMI display:

apt-get install fonts-dejavu-core
pipenv run python example/hello_jetson

Releasing package & API doc

CI will automatically do. Follow the following branch/tag rules.

1. Make changes for next version in master branch (via pull-requests).
2. Update actfw_jetson/_version.py with new version in master branch.
3. Create Git tag from master branch's HEAD named release-<New version>. E.g. release-1.4.0.
4. Then CI will build/upload package to PyPI & API doc to GitHub Pages.