SimulatedCamera.java

/*
 * This file is part of CBCJVM.
 * CBCJVM is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 * 
 * CBCJVM is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 * 
 * You should have received a copy of the GNU General Public License
 * along with CBCJVM.  If not, see <http://www.gnu.org/licenses/>.
 */

package cbccore.low.simulator;

import cbccore.NotImplemented;
import cbccore.low.CBCSimulator;
import cbccore.low.Camera;

/**
 * 
 * @author Braden McDorman / Benjamin Woodruff
 *
 */

//Stub-ified
//Possible use of webcam with a java port of the opensource CBC code?
public class SimulatedCamera extends Camera {
	
	protected CBCSimulator cbc;
	
	public SimulatedCamera(CBCSimulator c) {
		cbc = c;
	}
	
	@NotImplemented public void track_init() {
		System.out.println("WARNING: Camera is not yet supported on simulator.");
	}
	// Use            
	@NotImplemented public int track_is_new_data_available() {
		return 0;
	}
	// to determine if tracking data is available which is newer than the data processed by the last call to track_update().                                                                                                                      
	// Use 
	@NotImplemented public void track_update() { }
	// to process tracking data for a new frame and make it available for retrieval by the following calls.

	// Use 
	@NotImplemented public int track_get_frame() {
		return 0;
	}
	// to return value is the frame number used to generate the tracking data.

	// Use 
	@NotImplemented public int track_count(int ch) {
		return 0;
	}
	// to return the number of blobs available for the channel ch, which is a color channel numbered 0 through 3.

	// Use the following functions of the form 
	// int track_property(int ch, int i)       
	//to return the value of a given property for the blob from channel ch (range 0-2), index i (range 0 to track_count(ch)-1). Fill in track_property from one of the following:                                                                 

	// Gets the number of pixels in the blob.
	@NotImplemented public int track_size(int ch, int i) {
		return 0;
	}

	//  (note: 0,0 is the upper left { 159x119 is the lower right)
	// Gets the pixel x coordinate of the centroid of the blob
	@NotImplemented public int track_x(int ch, int i) {
		return 0;
	}

	// Gets the pixel y coordinate of the centroid of the blob
	@NotImplemented public int track_y(int ch, int i) {
		return 0;
	}
	                                                          
	// Gets the confidence for seeing the blob as a percentage of the blob pixel area/bounding box area (range 0-100, low numbers bad, high numbers good)                                                                                         
	@NotImplemented public int track_confidence(int ch, int i) {
		return 0;
	}

	// Gets the pixel x coordinate of the leftmost pixel in the blob
	@NotImplemented public int track_bbox_left(int ch, int i) {
		return 0;
	}

	// Gets the pixel x coordinate of the rightmost pixel in the blob
	@NotImplemented public int track_bbox_right(int ch, int i) {
		return 0;
	}

	// Gets the pixel y coordinate of the topmost pixel in the blob
	@NotImplemented public int track_bbox_top(int ch, int i) {
		return 0;
	}

	// Gets the pixel y coordinate of the bottommost pixel in the blob
	@NotImplemented public int track_bbox_bottom(int ch, int i) {
		return 0;
	}

	// Gets the pixel x width of the bounding box of the blob. This is equivalent to track_bbox_right - track_bbox_left + 1
	@NotImplemented public int track_bbox_width(int ch, int i) {
		return 0;
	}

	// Gets the pixel y height of the bounding box of the blob. This is equivalent to track_bbox_bottom - track_bbox_top + 1                                                                                                                      
	@NotImplemented public int track_bbox_height(int ch, int i) {
		return 0;
	}

	// Gets the angle in radians of the major axis of the blob.
	// Zero is horizontal and when the left end is higher than the right end the angle will be positive.
	// The range is -PI/2 to +PI/2.
	@NotImplemented public float track_angle(int ch, int i) {
		return 0.f;
	}
	
	// Gets the length in pixels of the major and minor axes of the bounding ellipse
	@NotImplemented public int track_major_axis(int ch, int i) {
		return 0;
	}
	
	@NotImplemented public int track_minor_axis(int ch, int i) {
		return 0;
	}

	// Return the timestamp (in milliseconds) of the current frame
	@NotImplemented public int track_capture_time() {
		return 0;
	}

	// Return the timestamp (in milliseconds) of the previous frame, as captured by
	// vision hardware.  This is not necessarily the same as track_capture_time
	// from the prevous track_update in the case where track_update was called less
	// quickly than frames were captured and thus skipped one or more frame captures
	@NotImplemented public int track_previous_capture_time() {
		return 0;
	}
	
}