org.cripac.isee.alg.pedestrian.tracking

Class BasicTracker

java.lang.Object

org.cripac.isee.alg.pedestrian.tracking.BasicTracker

All Implemented Interfaces:

Tracker

public class BasicTracker
extends Object
implements Tracker

The BasicTracker class is a JNI class of a pedestrian tracking algorithm used within the Center for Research on Intelligent Perception and Computing(CRIPAC), Institute of Automation, Chinese Academy of Science.

Author:

Ken Yu, CRIPAC, 2016

Field Summary

Fields

Modifier and Type	Field and Description
private byte[]	conf
private Logger	logger

Constructor Summary

Constructors

Constructor and Description
BasicTracker(byte[] conf)
BasicTracker(byte[] conf, Logger logger) Construct a tracker with a configuration.

Method Summary

Modifier and Type	Method and Description
private int	feedFrame(long p, byte[] frame) Feed a frame into the tracker.
private void	free(long p) Free the native tracker.
private Tracklet[]	getTargets(long p) Get tracked targets in currently input frames.
private long	initialize(int width, int height, int channels, byte[] conf) Initialize a native tracker.
Tracklet[]	track(InputStream videoStream) Read a video from a URL, and perform pedestrian tracking on it.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

conf

private byte[] conf

logger

private Logger logger

Constructor Detail

BasicTracker

public BasicTracker(@Nonnull
                    byte[] conf)

BasicTracker

public BasicTracker(@Nonnull
                    byte[] conf,
                    @Nullable
                    Logger logger)

Construct a tracker with a configuration. The configuration should be provided in a form of byte array.

Parameters:

conf - The byte data of the configuration file.

Method Detail

track

@Nonnull
public Tracklet[] track(@Nonnull
                                 InputStream videoStream)
                          throws org.bytedeco.javacv.FrameGrabber.Exception

Read a video from a URL, and perform pedestrian tracking on it.

Specified by:

track in interface Tracker

Parameters:

videoStream - the video stream to conduct tracking on.

Returns:

a set of tracklets of pedestrians.

Throws:

org.bytedeco.javacv.FrameGrabber.Exception

initialize

private long initialize(int width,
                        int height,
                        int channels,
                        @Nonnull
                        byte[] conf)

Initialize a native tracker.

Parameters:

width - The width of frames of the video to process.

height - The height of frames of the video to process.

channels - The channels of frames of the video to process.

conf - Bytes of a configuration the tracker uses.

Returns:

The pointer of the initialized tracker.

feedFrame

private int feedFrame(long p,
                      @Nonnull
                      byte[] frame)

Feed a frame into the tracker. The tracker is expected to process the video frame by frame.

Parameters:

p - The pointer of an initialized tracker.

frame - BGR bytes of a decoded frame.

Returns:

0 on success and -1 on failure.

getTargets

private Tracklet[] getTargets(long p)

Get tracked targets in currently input frames.

Parameters:

p - the pointer of an initialized tracker the user has fed frames to.

Returns:

an array of tracklets, each representing a target.

free

private void free(long p)

Free the native tracker.

Parameters:

p - the pointer to the native tracker.