diff --git a/Using-an-External-Webcam.md b/Using-an-External-Webcam.md index 92c51c7..f3445af 100644 --- a/Using-an-External-Webcam.md +++ b/Using-an-External-Webcam.md @@ -44,16 +44,15 @@ The FTC software offers "webcam" versions of its sample Blocks and Java Op Modes Before editing an Op Mode, verify that the intended configuration (with camera) is active. Also verify that the name referenced in the Op Mode matches the name specified in the configuration file. - ## Image Preview The FTC apps provide camera preview for ‘stream-enabled’ Op Modes using Vuforia or TensorFlow Object Detection (TFOD). -On a paired DS phone, with the camera connected and configured, select a stream-enabled Op Mode. Press the INIT button, and wait briefly for streaming initialization; do not press the START button. Instead open the main menu (the 3 dots in upper right hand corner of the screen) and select Camera Stream. This option appears only at this time, during which the game pads and START button are disabled for safety. +On a paired Driver Station phone, with the camera connected and configured, select a stream-enabled Op Mode. Press the INIT button, and wait briefly for streaming software to initialize; do not press the START button. Instead open the main menu (the 3 dots in upper right hand corner of the screen) and select Camera Stream. This option appears only at this time, during which the game pads and START button are disabled for safety.

[[/images/Using-an-External-Webcam/DS-webcam-preview-CH-1.jpg]]

-The camera image will appear on the DS screen. Manually touch the image to refresh it. To preserve bandwidth, only one frame is sent at a time. +The camera image will appear on the Driver Station screen. Manually touch the image to refresh it. To preserve bandwidth, only one frame is sent at a time.

[[/images/Using-an-External-Webcam/DS-webcam-preview-CH-2.jpg]]

@@ -61,6 +60,11 @@ This option may be used to adjust the camera, with frequent manual image refresh

[[/images/Using-an-External-Webcam/DS-webcam-preview-CH-3.jpg]]

+**Important Note:** Because the camera stream feature is only available during the INIT phase of an op mode, you must ensure that the Vuforia library is activated in your Op Mode _**before**_ the waitForStartCommand: + +

[[/images/Using-an-External-Webcam/activateBeforeWaitForStart.jpg]]

+ +In order for the Camera Stream function to be available, the Robot Controller must detect that there is an active Vuforia video stream available. Because this feature is only available during the INIT phase of an op mode Because this image displays during INIT, Vuforia or TensorFlow augmented data appears only if activated before the waitForStart command. This is demonstrated in the Sample Op Modes. Alternatively, camera output can be viewed on a display monitor or other device plugged into the HDMI port on the REV Control Hub.