INTERNAL USE ONLY (Set it to white if you do not need it)

Transcription

1 APPLICATION NOTE Uncompressed YUV Images Applicable to BIP2 cameras with real-time trigger support Document Number: AW Version: 03 Language: 000 (English) Release Date: 13 January 2016 INTERNAL USE ONLY (Set it to white if you do not need it)

2 Contacting Basler Support Worldwide Europe, Middle East, Africa Basler AG An der Strusbek Ahrensburg Germany Tel Fax The Americas Basler, Inc. 855 Springdale Drive, Suite 203 Exton, PA USA Tel Fax Asia-Pacific Basler Asia Pte. Ltd. 35 Marsiling Industrial Estate Road 3 #05 06 Singapore Tel Fax support.asia@baslerweb.com All material in this publication is subject to change without notice and is copyright Basler AG.

3 Table of Contents 1 Introduction Prerequisites Enabling the Uncompressed YUV Image Format Enabling the Uncompressed YUV Image Format Using the Web Client Enabling the Uncompressed YUV Image Format Using the Camera API Accessing the Uncompresed YUV Images... 5 Revision History... 6 Uncompressed YUV Images 1

4 1 Introduction This document explains how to use the camera to acquire uncompressed YUV images from a stream. In order to acquire YUV images, the real-time trigger feature has to be enabled. This means that the images won t be in the form of a continuous stream but are acquired when triggered. Camera-controlled Image Capture Camera-controlled Image Capture Real-time Trigger Applied Real-time Triggered Image Capture Camera-controlled Image Capture Abort Time Uncompressed YUV Image Fig. 1: Real-time Triggered Image For detailed information about the real-time trigger feature, see the IP Camera Real-Time Trigger application note (AW000991). 2 Prerequisites In order to set the camera to the uncompressed YUV image format, you need the following: BIP2 camera Firmware version FW-BIP or later The basic camera parameters have been set. Uncompressed YUV Images 2

5 2.1 Enabling the Uncompressed YUV Image Format Enabling the Uncompressed YUV Image Format Using the Web Client To enable the uncompressed YUV image format via the web app: 1. Enable real-time triggering: Configure one of the I/O ports in the Input/Output parameters group > Digital I/O tab: Set the Direction parameter to Input and the Function parameter to Real-time Trigger. See Note below. Fig. 2: Enabling the Real-time Trigger 2. In the Streaming parameters group: On the corresponding Stream tab set the Encoder Type to YUV (RT triggered). Fig. 3: YUV (RT triggered) Encoder Type NOTE One real-time trigger per second is acceptable. You can set a maximum of up to 3 to 4 real-time triggers per second. Using this setting for an extended period of time, however, is discouraged if you are acquiring images in uncompressed YUV format. Applying 3 to 4 real-time triggers/second for an extended period would generate a significant overload due to the large size of YUV images and as a result the performance of the camera might suffer. Uncompressed YUV Images 3

6 NOTE You can configure more than one port to act as an input with the function set to realtime trigger. In this situation, an image capture will be triggered every time the proper electrical signal is applied to one of the ports. For information about wiring the ports and about the electrical requirements for the ports, see the "Terminal Connector" section of the camera user s manual Enabling the Uncompressed YUV Image Format Using the Camera API To enable the uncompressed YUV image format via the camera API: 1. Enable real-time triggering: a. Use IO.IOSelector to select a port. b. Use IO.Direction to set the selected port s direction to "Input". c. Use IO.Function to set the selected port s function to "RealtimeTrigger". With these settings, an image capture will be triggered every time the electrical signal applied to the port causes the port to transition from the inactive to the active condition. If desired, use IO.Invert to set the selected port to invert: When the invert function for the port is enabled, an image capture will be triggered every time the electrical signal applied to the port causes the port to transition from the active to the inactive condition. If desired, use IO.State to check the current state of the selected port. 2. Enable the uncompressed YUV image format: d. Use Stream.StreamSelector to select the stream. e. Use Stream.EncoderType to set the format to YUV_TRIGGERED. NOTE Depending on the AOI size, the size of the uncompressed YUV images and therefore the influence on the camera performance can vary. You can calculate the size of the image using the following formula: AOI width x AOI height x 1.5 = Uncompressed image size in bytes [Example: 1600 x 1200 x 1.5 = 2,880,000 bytes --> ~ 2.8 MB] Uncompressed YUV Images 4

7 2.1.3 Accessing the Uncompresed YUV Images Use the following HTTP request in order to receive the images: The HTTP streaming format is as follows: HTTP response header with Content-Type like MJPEG:... Content-Type: multipart/x-mixed-replace;boundary=myboundary'0xd''0xa'... '0xd''0xa' --myboundary'0xd''0xa' <YUV Image Part> // body-part '0xd''0xa' --myboundary'0xd''0xa'... <YUV Image Part>= Content-Type: image/x-raw'0xd''0xa' Content-Length: <nnn>'0xd''0xa' // <nnn>=length of <YUV Image Header> // + <YUV Image Data> '0xd''0xa' <YUV Image Header> <YUV Image Data> <YUV Image Header>= // User defined format Image-Width: <xxx>'0xd''0xa' // <xxx>=image width in pixels Image-Height: <yyy>'0xd''0xa' // <xxx>=image height in pixels Image-Format: I420'0xd''0xa' // YUV format FOURCC string DateTime: YYYY:MM:DD hh:mm:ss'0xd''0xa' // Image time stamp // (since FW ) SubsecTime: '0xd''0xa' // Subseconds in microseconds // (since FW ) '0xd''0xa' The live recording file format (file extension =.yuv ) is as follows: <YUV Image Part> <YUV Image Part>... Uncompressed YUV Images 5

8 Revision History Document Number Date Changes AW Feb 2014 Initial release version of this document. AW Mar 2014 Changing the title to Uncompressed YUV Images and minor corrections. AW Jan 2016 Minor layout changes. Added support contact details on page 2. Added information that YUV image header now contains timestamp in section Uncompressed YUV Images 6