This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
wiki:v2:arduino_api [2018/04/09 21:52] jfrench - Imported by DokuWiki Advanced Plugin |
wiki:v2:arduino_api [2020/01/28 03:56] (current) jfrench [Instantiation] |
||
---|---|---|---|
Line 8: | Line 8: | ||
===== Installing the Arduino Library ===== | ===== Installing the Arduino Library ===== | ||
- | Download the latest Arduino library "arduino%%_%%pixy-x.y.z.zip" [[wiki:v2:Latest_release|here]]. Bring up the Arduino IDE and import the Pixy library by selecting **Sketch➜Import Library** in the Arduino IDE, and then browse to the Arduino zip file that you just downloaded. | + | Download the latest Arduino library "arduino%%_%%pixy2-x.y.z.zip" [[https://pixycam.com/downloads-pixy2/|here]]. Bring up the Arduino IDE and import the Pixy library by selecting **Sketch➜Import Library** in the Arduino IDE, and then browse to the Arduino zip file that you just downloaded. |
Line 25: | Line 25: | ||
<code> | <code> | ||
#include <SPI.h> | #include <SPI.h> | ||
- | #include <Pixy.h> | + | #include <Pixy2.h> |
</code> | </code> | ||
Line 33: | Line 33: | ||
<code> | <code> | ||
- | Pixy pixy; | + | Pixy2 pixy; |
</code> | </code> | ||
==== uint16_t getBlocks(uint16_t maxBlocks=1000) ==== | ==== uint16_t getBlocks(uint16_t maxBlocks=1000) ==== | ||
- | The most important method in the Arduino library is ''%%getBlocks()%%'', which returns the number of objects Pixy has detected. You can then look in the ''%%pixy.blocks[]%%'' array for information about each detected object (one array member for each detected object.) Each array member (''%%i%%'') contains the following fields: | + | The most important method in the Arduino library is ''%%getBlocks()%%'', which returns the number of objects Pixy has detected. You can then look in the ''%%pixy.ccc.blocks[]%%'' array for information about each detected object (one array member for each detected object.) Each array member (''%%i%%'') contains the following fields: |
- | * ''%%pixy.blocks[i].signature%%'' The signature number of the detected object (1-7 for normal signatures) | + | * ''%%pixy.ccc.blocks[i].m_signature%%'' The signature number of the detected object (1-7 for normal signatures) |
- | * ''%%pixy.blocks[i].x%%'' The x location of the center of the detected object (0 to 319) | + | * ''%%pixy.ccc.blocks[i].m_x%%'' The x location of the center of the detected object (0 to 316) |
- | * ''%%pixy.blocks[i].y%%'' The y location of the center of the detected object (0 to 199) | + | * ''%%pixy.ccc.blocks[i].m_y%%'' The y location of the center of the detected object (0 to 208) |
- | * ''%%pixy.blocks[i].width%%'' The width of the detected object (1 to 320) | + | * ''%%pixy.ccc.blocks[i].m_width%%'' The width of the detected object (1 to 316) |
- | * ''%%pixy.blocks[i].height%%'' The height of the detected object (1 to 200) | + | * ''%%pixy.ccc.blocks[i].m_height%%'' The height of the detected object (1 to 208) |
- | * ''%%pixy.blocks[i].angle%%'' The angle of the object detected object if the detected object is a [[wiki:v2:Using_Color_Codes|color code]]. | + | * ''%%pixy.ccc.blocks[i].m_angle%%'' The angle of the object detected object if the detected object is a [[wiki:v2:Using_Color_Codes|color code]] (-180 to 180). |
- | * ''%%pixy.blocks[i].print()%%'' A member function that prints the detected object information to the serial port | + | * ''%%pixy.ccc.blocks[i].m_index%%'' The [[wiki:v2:color_connected_components#Pixy2 "tracks" each object it detects|tracking index]] of the block |
+ | * ''%%pixy.ccc.blocks[i].m_age%%'' The number of frames the block has been tracked. | ||
+ | * ''%%pixy.ccc.blocks[i].print()%%'' A member function that prints the detected object information to the serial port | ||
''%%getBlocks()%%'' accepts an optional number argument (''%%uint16_t%%'') that indicates the maximum number of blocks you want ''%%getBlocks()%%'' to return. | ''%%getBlocks()%%'' accepts an optional number argument (''%%uint16_t%%'') that indicates the maximum number of blocks you want ''%%getBlocks()%%'' to return. |