<< return to Pixycam.com

User Tools

Site Tools


wiki:v2:video_api

**This is an old revision of the document!**

Video API

This API can be called through the video member of the Pixy2 object, for example:

Pixy2 pixy;
uint8_t r, g, b; 

pixy.video.getRGB(50, 75, &r, &g, &b);  // get red, green, blue values at location x=50, y=75

Firmware versions 3.0.11 and greater will automatically switch to the video program when making requests through the video API.

Member functions

int8_t getRGB(uint16_t x, uint16_t y, uint8_t *r, uint8_t *g, uint8_t *b, bool saturate [optional])

This is currently the only function supported by the video program. It takes an x and y location in the image, and pointers to red, green and blue variables that get written into by the getRGB() function with the red, green and blue values of the pixel at that location in the image. getRGB() actually takes a 5×5 section of pixels centered at the x, y location and performs an average of all 25 pixels to obtain a representative result.
The image coordinates are shown below.

Video image coordinates from Pixy2's perspective

The width and height values are both available through pixy.frameWidth and pixy.frameHeight, if you don't want to remember their specific values.

.

wiki/v2/video_api.1537546715.txt.gz · Last modified: 2018/09/21 16:18 by pixycam