This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
wiki:v2:pixy_lego_block [2019/01/29 19:38] pixycam |
wiki:v2:pixy_lego_block [2020/04/30 22:25] (current) pixycam |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | |||
- | |||
- | |||
- | |||
====== Pixy2 LEGO Block ====== | ====== Pixy2 LEGO Block ====== | ||
Line 15: | Line 11: | ||
You can bring up the Pixy2 block from the **Sensor** palette in the EV3 Mindstorms environment: | You can bring up the Pixy2 block from the **Sensor** palette in the EV3 Mindstorms environment: | ||
- | TODO pic | + | |
+ | {{wiki:v1:image_727.png}} | ||
===== Color Connected Components Mode ===== | ===== Color Connected Components Mode ===== | ||
Line 23: | Line 21: | ||
Selecting color connected components mode is done by clicking on Pixy2's mode selector and then selecting **Measure➜Color connected components**. | Selecting color connected components mode is done by clicking on Pixy2's mode selector and then selecting **Measure➜Color connected components**. | ||
- | TODO pic | + | |
+ | {{wiki:v1:image_718.png}} | ||
Line 31: | Line 30: | ||
The Pixy2 CCC block is shown below, with labels showing the different inputs and outputs. | The Pixy2 CCC block is shown below, with labels showing the different inputs and outputs. | ||
- | {{wiki:img:2fc7b12b44404f368acc2fb54d38f4d54752b3eb.png}} | + | {{wiki:v1:image_724.png}} |
==== Parameters ==== | ==== Parameters ==== | ||
- | - **Port Selector**: use this to select the sensor port 1 through 4 that Pixy2 is plugged into on your controller brick. | + | 1. **Port Selector**: use this to select the sensor port 1 through 4 that Pixy2 is plugged into on your controller brick. |
- | - **Mode Selector**: selects between measure and compare modes. | + | 2. **Mode Selector**: selects between measure and compare modes. |
- | - **Lamp**: turns the lamp on or off. | + | 3. **Signature**: selects the signature or [[wiki:v2:Using_Color_Codes|color code]] you'd like Pixy2 to search for. |
- | - **Signature**: selects the signature or [[wiki:v2:Using_Color_Codes|color code]] you'd like Pixy2 to search for. | + | 4. **Lamp**: turns the lamp on or off. |
- | - **Signature Output**: outputs the number of blocks that match the signature or [[wiki:v2:Using_Color_Codes|color code]] you specified in the Signature input. Or it outputs the signature number of the detected object if in General Mode (see the description of modes below). | + | 5. **Signature Output**: outputs the number of blocks that match the signature or [[wiki:v2:Using_Color_Codes|color code]] you specified in the Signature input. Or it outputs the signature number of the detected object if in General Mode (see the description of modes below). |
- | - **X centroid**: outputs the X location of the center of the largest object that Pixy2 has found. The number returned ranges from 0 to 255, with 0 being the rightmost pixel if facing the camera lens. | + | 6. **X centroid**: outputs the X location of the center of the largest object that Pixy2 has found. The number returned ranges from 0 to 255, with 0 being the rightmost pixel if facing the camera lens. |
- | - **Y centroid**: outputs the Y location of the center of the largest object that Pixy2 found. The number returned is from 0 to 199, with 0 being the topmost pixel. | + | 7. **Y centroid**: outputs the Y location of the center of the largest object that Pixy2 found. The number returned is from 0 to 199, with 0 being the topmost pixel. |
- | - **Width**: outputs the width of the largest block that Pixy2 has found. The number returned is from 1 to 256. | + | 8. **Width**: outputs the width of the largest block that Pixy2 has found. The number returned is from 1 to 256. |
- | - **Height**: outputs the height of the largest block that Pixy2 has found. The number returned is from 1 to 256. | + | 9. **Height**: outputs the height of the largest block that Pixy2 has found. The number returned is from 1 to 256. |
- | - **Angle**: is the angle (in degrees) of the largest object that Pixy2 has found. Angle information is only available for [[wiki:v2:Using_Color_Codes|color codes]], otherwise the value is 0. | + | 10. **Angle**: is the angle (in degrees) of the largest object that Pixy2 has found. Angle information is only available for [[wiki:v2:Using_Color_Codes|color codes]], otherwise the value is 0. |
Line 78: | Line 77: | ||
Selecting Line Tracking mode is done by clicking on Pixy2's mode selector and then selecting **Measure➜Line Tracking**. | Selecting Line Tracking mode is done by clicking on Pixy2's mode selector and then selecting **Measure➜Line Tracking**. | ||
- | TODO pic | + | |
+ | {{wiki:v1:image_719.png}} | ||
Line 86: | Line 86: | ||
The Pixy2 Line Tracking block is shown below, with labels showing the different inputs and outputs. Please refer to the [[wiki:v2:line_tracking|Line Tracking Overview]] for a description of the terms used below like _Vector_, _barcode_ and _intersection_. | The Pixy2 Line Tracking block is shown below, with labels showing the different inputs and outputs. Please refer to the [[wiki:v2:line_tracking|Line Tracking Overview]] for a description of the terms used below like _Vector_, _barcode_ and _intersection_. | ||
- | TODO Pic | + | {{wiki:v1:image_711.png}} |
- | - **Port Selector**: use this to select the sensor port 1 through 4 that Pixy2 is plugged into on your controller brick. | + | |
- | - **Mode Selector**: selects between measure and compare modes. | + | ==== Parameters ==== |
- | - **Turn Angle**: sets the turn angle (in degrees) for when intersections are encountered. Turn angle values can range between -180 and 180. See the section on turn angles below. | + | |
- | - **Reverse**: setting this to false to true or true to false will cause Pixy2 to reverse the current Vector. | + | 1. **Port Selector**: use this to select the sensor port 1 through 4 that Pixy2 is plugged into on your controller brick. |
- | - **Lamp**: turns the lamp on or off. | + | 2. **Mode Selector**: selects between measure and compare modes. |
- | - **Vector**: outputs the X coordinate of the head of the Vector. The value ranges between 0 (far left of the image) to 128 (far right of the image). If no Vector is detected, the value will be -1. | + | 3. **Turn Angle**: sets the turn angle (in degrees) for when intersections are encountered. Turn angle values can range between -180 and 180. See the section on turn angles below. |
- | - **Vector Reversed**: outputs true if the Vector is pointing down instead of up. This usually indicates that your robot needs to reverse its direction in order to follow the Vector. | + | 4. **Reverse**: setting this to false to true or true to false will cause Pixy2 to reverse the current Vector. |
- | - **Barcode**: outputs the numerical value of a detected barcode (0 through 15). If no barcodes are detected, the value will be -1. If more than one barcode is detected in the image, the value of the barcode closest to the bottom of the image will be returned. | + | 5. **Lamp**: turns the lamp on or off. |
- | - **Intersection**: outputs the number branches in a detected intersection (3 through 6) -- note, a "T" intersection is the minimum number of branches an intersection can have (3). If no intersection is detected, the value will be -1. | + | 6. **Vector**: outputs the X coordinate of the head of the Vector. The value ranges between 0 (far left of the image) to 128 (far right of |
+ | the image). If no Vector is detected, the value will be -1. Refer [[wiki:v2:line_tracking#detecting-and-tracking-lines|here]] for a description of the Vector. | ||
+ | 7. **Vector Reversed**: outputs true if the Vector is pointing down instead of up. This usually indicates that your robot needs to reverse its direction in order to follow the Vector. | ||
+ | 8. **Barcode**: outputs the numerical value of a detected barcode (0 through 15). If no barcodes are detected, the value will be -1. If more than one barcode is detected in the image, the value of the barcode closest to the bottom of the image will be returned. Refer [[wiki:v2:line_tracking#barcodes|here]] for examples of barcodes, and [[https://pixycam.com/downloads-pixy2/|here]] to download barcode images. | ||
+ | 9. **Intersection**: outputs the number branches in a detected intersection (3 through 6) -- note, a "T" intersection is the minimum number of branches an intersection can have (3). If no intersection is detected, the value will be -1. Refer [[wiki:v2:line_tracking#detecting-intersections-and-branching|here]] for examples of barcodes. | ||
Line 117: | Line 121: | ||
Selecting RGB sensing mode is done by clicking on Pixy2's mode selector and then selecting **Measure➜RGB Sensing**. | Selecting RGB sensing mode is done by clicking on Pixy2's mode selector and then selecting **Measure➜RGB Sensing**. | ||
- | TODO pic | + | |
+ | {{wiki:v1:image_722.png}} | ||
Line 125: | Line 130: | ||
The Pixy2 RGB sensing is shown below, with labels showing the different inputs and outputs. | The Pixy2 RGB sensing is shown below, with labels showing the different inputs and outputs. | ||
- | - **Port Selector**: use this to select the sensor port 1 through 4 that Pixy2 is plugged into on your controller brick. | + | {{wiki:v2:image_894.png}} |
- | - **Mode Selector**: selects between measure and compare modes. | + | |
- | - **X**: X location input, can range between 0 and 255 (see coordinate diagram below). | + | |
- | - **Y**: Y location input, can range between 0 and 255 (see coordinate diagram below). | + | ==== Parameters ==== |
- | - **Lamp**: turns the lamp on or off. | + | |
- | - **Red**: outputs the red value of the pixel at the specified image location. Value can range between 0 to 255. | + | 1. **Port Selector**: use this to select the sensor port 1 through 4 that Pixy2 is plugged into on your controller brick. |
- | - **Green**: outputs the green value of the pixel at the specified image location. Value can range between 0 to 255. | + | 2. **Mode Selector**: selects between measure and compare modes. |
- | - **Blue**: outputs the blue value of the pixel at the specified image location. Value can range between 0 to 255. | + | 3. **X**: X location input, can range between 0 and 255 (see coordinate diagram below). |
+ | 4. **Y**: Y location input, can range between 0 and 255 (see coordinate diagram below). | ||
+ | 5. **Lamp**: turns the lamp on or off. | ||
+ | 6. **Saturation**: if true, Pixy will "saturate" the colors so they are easier to distinguish (reds are redder, blues are bluer, etc.) If false, the raw RGB values will returned. | ||
+ | 7. **Red**: outputs the red value of the pixel at the specified image location. Value can range between 0 to 255. | ||
+ | 8. **Green**: outputs the green value of the pixel at the specified image location. Value can range between 0 to 255. | ||
+ | 9. **Blue**: outputs the blue value of the pixel at the specified image location. Value can range between 0 to 255. | ||