Table of Contents

Advertisement

Basler ace
USER'S MANUAL FOR GigE CAMERAS
Document Number: AW000893
Version: 17 Language: 000 (English)
Release Date: 15 August 2014

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the GigE SERIES and is the answer not in the manual?

Questions and answers

Summary of Contents for Basler GigE SERIES

  • Page 1 Basler ace USER’S MANUAL FOR GigE CAMERAS Document Number: AW000893 Version: 17 Language: 000 (English) Release Date: 15 August 2014...
  • Page 2 Basler customers using or selling these products for use in such applications do so at their own risk and agree to fully indemnify Basler for any damages resulting from such improper use or sale. Warranty Note Do not open the housing of the camera.
  • Page 3 Contacting Basler Support Worldwide Europe: Basler AG An der Strusbek 60 - 62 22926 Ahrensburg Germany Tel.: +49 4102 463 515 Fax.: +49 4102 463 599 support.europe@baslerweb.com Americas: Basler, Inc. 855 Springdale Drive, Suite 203 Exton, PA 19341 U.S.A. Tel.: +1 610 280 0171 Fax.: +1 610 280 7608...
  • Page 5: Table Of Contents

    The Basler pylon Camera Software Suite........
  • Page 6 Triggering and Applying a Software Trigger Signal... . . 92 7.3.5 Using a Hardware Acquisition Start Trigger......94 Basler ace GigE...
  • Page 7 7.12 Maximum Allowed Frame Rate......... . 152 7.12.1 Using Basler pylon to Check the Maximum Allowed Frame Rate ..154 7.12.2 Increasing the Maximum Allowed Frame Rate .
  • Page 8 10.8.2.1 Operation with the "Always Active" Sequence Control Source . . . 236 10.8.2.2 Operation with the Input Line as Sequence Control Source ..241 10.8.2.3 Operation with the "Disabled" Sequence Control Source ..244 Basler ace GigE...
  • Page 9 11.1 What are Chunk Features?..........311 11.2 Making the "Chunk Mode" Active and Enabling the Extended Data Stamp ..312 Basler ace GigE...
  • Page 10 12.2 Obtaining an RMA Number ..........327 12.3 Before Contacting Basler Technical Support ....... 328...
  • Page 11: Specifications, Requirements, And Precautions

    We strongly recommend that you read and follow the precautions. Models The current Basler ace GigE Vision camera models are listed in the top row of the specification tables on the next pages of this manual. The camera models are differentiated by their sensor size, their maximum frame rate at full resolution, and whether the camera’s sensor is mono or color.
  • Page 12: General Specifications

    ~ 2.7 W @ 12 VDC when supplied via ~ 2.0 W @ 12 VDC when supplied via the camera’s 6-pin connector the camera’s 6-pin connector Note: When using extremely small AOIs, power consumption may increase to 2.4 W. Table 1: General Specifications (acA640-90gm/gc, acA640-120gm/gc) Basler ace GigE...
  • Page 13 60.3 mm x 29 mm x 29 mm (with lens adapter and connectors) Weight < 90 g Conformity CE (*), UL, FCC, GenICam, GigE Vision, IP30, RoHS, IEEE 802.3af (PoE) * The CE Conformity Declaration is available on the Basler website: www.baslerweb.com Software Basler pylon 4 Camera Software Suite: ...
  • Page 14 Size (L x W x H) 42.0 mm x 29 mm x 29 mm (without lens adapter or connectors) 60.3 mm x 29 mm x 29 mm (with lens adapter and connectors) Weight < 90 g Table 2: General Specifications (acA645-100gm/gc, acA750-30gm/gc) Basler ace GigE...
  • Page 15 Specification acA645-100gm/gc acA750-30gm/gc Conformity CE (*), UL, FCC, GenICam, GigE Vision, IP30, RoHS, IEEE 802.3af (PoE) * The CE Conformity Declaration is available on the Basler website: www.baslerweb.com Software Basler pylon 4 Camera Software Suite:  Available for Windows in 32- and 64-bit versions.
  • Page 16 Via external trigger signal, via the Ethernet connection, or free run Exposure Control Via external trigger signal Programmable via the Via external trigger signal or or programmable via the camera API programmable via the camera API camera API Table 3: General Specifications (acA780-75gm/gc, acA1280-60gm/gc, acA1300-22gm/gc) Basler ace GigE...
  • Page 17 60.3 mm x 29 mm x 29 mm (with lens adapter and connectors) Weight < 90 g Conformity CE (*), UL, FCC, GenICam, GigE Vision, IP30, RoHS, IEEE 802.3af (PoE) * The CE Conformity Declaration is available on the Basler website: www.baslerweb.com Software Basler pylon 4 Camera Software Suite: ...
  • Page 18 [(*) When using one of the 12 bit modes the two least significant bits are set to 0.] ADC Bit Depth 12 bits 10 bits, see (*) above Synchronization Via external trigger signal, via the Ethernet connection, or free run Table 4: General Specifications (acA1300-30gm/gc, acA1300-60gm/gc, acA1300-60gmNIR) Basler ace GigE...
  • Page 19 60.3 mm x 29 mm x 29 mm (with lens adapter and connectors) Weight < 90 g Conformity CE (*), UL, FCC, GenICam, GigE Vision, IP30, RoHS, IEEE 802.3af (PoE) * The CE Conformity Declaration is available on the Basler website: www.baslerweb.com Software Basler pylon 4 Camera Software Suite: ...
  • Page 20 12 bits Synchronization Via external trigger signal, Via Ethernet connection, or Via external trigger signal, via the Ethernet connection, free run via the Ethernet connection, or free run or free run Table 5: General Specifications (acA1600-20gm/gc, acA1600-60gm/gc, acA1920-25gm/gc) Basler ace GigE...
  • Page 21 60.3 mm x 29 mm x 29 mm (with lens adapter and connectors) Weight < 90 g Conformity CE (*), UL, FCC, GenICam, GigE Vision, IP30, RoHS, IEEE 802.3af (PoE) * The CE Conformity Declaration is available on the Basler website: www.baslerweb.com Software Basler pylon 4 Camera Software Suite: ...
  • Page 22 ~ 2.9 W when using Power over Ethernet ~ 2.5 W @ 12 VDC when supplied via the camera’s 6-pin connector ~ 2.6 W @ 12 VDC when supplied via the camera’s 6- pin connector Table 6: General Specifications (acA2000-50gm/gc, acA2000-50gmNIR, acA2040-25gm/gc) Basler ace GigE...
  • Page 23 60.3 mm x 29 mm x 29 mm (with lens adapter and connectors) Weight < 90 g Conformity CE (*), UL, FCC, GenICam, GigE Vision, IP30, RoHS, IEEE 802.3af (PoE) * The CE Conformity Declaration is available on the Basler website: www.baslerweb.com Software Basler pylon 4 Camera Software Suite: ...
  • Page 24 Via external trigger signal, via the Ethernet connection, or free run Exposure Control Via external trigger signal or programmable via the camera API Table 7: General Specifications (acA2000-50gm/gc - CMV2000-V3, acA2000-50gmNIR - CMV2000-V3, acA2040- 25gm/gc - CMV4000-V3) Basler ace GigE...
  • Page 25 60.3 mm x 29 mm x 29 mm (with lens adapter and connectors) Weight < 90 g Conformity CE (*), UL, FCC, GenICam, GigE Vision, IP30, RoHS, IEEE 802.3af (PoE) * The CE Conformity Declaration is available on the Basler website: www.baslerweb.com Software Basler pylon 4 Camera Software Suite: ...
  • Page 26 ~ 2.2 W @ 12 VDC when supplied via the camera’s 6- pin connector I/O Ports 1 opto-isolated input line and 1 opto-isolated output line Lens Adapter C-mount C-mount; CS-mount Table 8: General Specifications (acA2040-25gmNIR, acA2040-25gmNIR - CMV40000-V3, acA2500-14gm/gc) Basler ace GigE...
  • Page 27 60.3 mm x 29 mm x 29 mm (with lens adapter and connectors) Weight < 90 g Conformity CE (*), UL, FCC, GenICam, GigE Vision, IP30, RoHS, IEEE 802.3af (PoE) * The CE Conformity Declaration is available on the Basler website: www.baslerweb.com Software Basler pylon 4 Camera Software Suite: ...
  • Page 28: Spectral Response

    Mono Camera Spectral Response The following graphs show the spectral response for each available monochrome camera model. The spectral response curves exclude lens characteristics and light source characteristics. Wavelength (nm) Fig. 1: acA640-90gm Spectral Response (From Sensor Data Sheet) Basler ace GigE...
  • Page 29 AW00089317000 Specifications, Requirements, and Precautions Wavelength (nm) Fig. 2: acA640-120gm Spectral Response (From Sensor Data Sheet) Wavelength (nm) Fig. 3: acA645-100gm Spectral Response (From Sensor Data Sheet) Basler ace GigE...
  • Page 30 Specifications, Requirements, and Precautions AW00089317000 Wavelength (nm) Fig. 4: acA750-30gm Spectral Response (From Sensor Data Sheet) Wavelength (nm) Fig. 5: acA780-75gm Spectral Response (From Sensor Data Sheet) Basler ace GigE...
  • Page 31 AW00089317000 Specifications, Requirements, and Precautions 1000 Wavelength (nm) Fig. 6: acA1280-60gm, acA1300-60gm Spectral Response (From Sensor Data Sheet) 1000 Wavelength (nm) Fig. 7: acA1300-22gm, acA1300-30gm Spectral Response (From Sensor Data Sheet) Basler ace GigE...
  • Page 32 Specifications, Requirements, and Precautions AW00089317000 1000 Wavelength (nm) Fig. 8: acA1300-60gmNIR Spectral Response (From Sensor Data Sheet) Wavelength (nm) Fig. 9: acA1600-20gm Spectral Response (From Sensor Data Sheet) Basler ace GigE...
  • Page 33 AW00089317000 Specifications, Requirements, and Precautions 1000 1050 1100 Wavelength (nm) Fig. 10: acA1600-60gm Spectral Response (From Sensor Data Sheet) 1000 Wavelength (nm) Fig. 11: acA2000-50gm, acA2000-50gm- CMV2000-V3, acA2040-25gm, acA2040-25gm- CMV4000-V3, Spectral Response (From Sensor Data Sheet) Basler ace GigE...
  • Page 34 Specifications, Requirements, and Precautions AW00089317000 1000 Wavelength (nm) Fig. 12: acA2000-50gmNIR, acA2000-50gmNIR- CMV2000-V3,acA2040-25gmNIR, acA2040-25gmNIR- CMV4000-V3, Spectral Response (From Sensor Data Sheet) (*) 1050 1150 Wavelength (nm) Fig. 13: acA2500-14gm, acA1920-25gm Spectral Response (From Sensor Data Sheet) Basler ace GigE...
  • Page 35: Color Camera Spectral Response

    700 ... 720 nm, and it should cut off from 700 ... 720 nm to 1100 nm. A suitable IR cut filter is built into the lens adapter on color models of the camera. Blue Green Wavelength (nm) Fig. 14: acA640-90gc Spectral Response (From Sensor Data Sheet) Basler ace GigE...
  • Page 36 Specifications, Requirements, and Precautions AW00089317000 Blue Green Wavelength (nm) Fig. 15: acA640-120gc Spectral Response (From Sensor Data Sheet) Blue Green Wavelength (nm) Fig. 16: acA645-100gc Spectral Response (From Sensor Data Sheet) Basler ace GigE...
  • Page 37 AW00089317000 Specifications, Requirements, and Precautions Cyan Magenta Yellow Green Wavelength (nm) Fig. 17: acA750-30gc Spectral Response (From Sensor Data Sheet) Blue Green Wavelength (nm) Fig. 18: acA780-75gc Spectral Response (From Sensor Data Sheet) Basler ace GigE...
  • Page 38 AW00089317000 Blue Green 1100 1000 Wavelength (nm) Fig. 19: acA1280-60gc, acA1300-60gc Spectral Response (From Sensor Data Sheet) Blue Green 4 00 5 00 60 0 Wavelength (nm) Fig. 20: acA1300-22gc, acA1300-30gc Spectral Response (From Sensor Data Sheet) Basler ace GigE...
  • Page 39 AW00089317000 Specifications, Requirements, and Precautions Blue Green Wavelength (nm) Fig. 21: acA1600-20gc Spectral Response (From Sensor Data Sheet) Blue Green 1000 1050 1100 Wavelength (nm) Fig. 22: acA1600-60gc Spectral Response (From Sensor Data Sheet) Basler ace GigE...
  • Page 40 Specifications, Requirements, and Precautions AW00089317000 Blue Green Wavelength (nm) Fig. 23: acA2000-50gc, acA2000-50gc- CMV2000-V3, acA2040-25gc, acA2040-25gc- CMV4000-V3, Spectral Response (From Sensor Data Sheet) Blue Green 35 0 Wavelength (nm) Fig. 24: acA1920-25gc, acA2500-14gc, Spectral Response (From Sensor Data Sheet) Basler ace GigE...
  • Page 41: Mechanical Specifications

    2x M3; 3 deep 16.5 22 (dimension for M2) All models except acA2000-50, acA2040-25 17.526 Photosensitive surface of the sensor acA2000-50, acA2040-25 models Not to Scale Fig. 25: Mechanical Dimensions (in mm) for Cameras with the C-mount Lens Adapter Basler ace GigE...
  • Page 42 2x M2; 3 deep 2x M2; 3 deep 2x M3; 3 deep 11.5 22 (dimension for M2) 12.526 Photosensitive surface of the sensor Not to Scale Fig. 26: Mechanical Dimensions (in mm) for Cameras with the CS-mount Lens Adapter Basler ace GigE...
  • Page 43: Maximum Allowed Lens Thread Length

    (11) Filter Holder (9.6) C-mount Lens Not to Scale IR Cut Filter (color cameras only) Unthreaded Thread: 9.6 Max 10.8 Max Fig. 27: Maximum Lens Thread Length (Dimensions in mm) for Cameras with the C-mount Lens Adapter Basler ace GigE...
  • Page 44 AW00089317000 Filter Holder (4.6) CS-mount Lens Not to Scale IR Cut Filter (color cameras only) Unthreaded Thread: 4.6 Max 5.8 Max Fig. 28: Maximum Lens Thread Length (Dimensions in mm) for Cameras with the CS-mount Lens Adapter Basler ace GigE...
  • Page 45: Mechanical Stress Test Results

    The mechanical stress tests were performed with a dummy lens connected to a C-mount. The dummy lens was 35 mm long and had a mass of 66 g. Using a heavier or longer lens requires an additional support for the lens. Basler ace GigE...
  • Page 46: Software Licensing Information

    PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Basler ace GigE...
  • Page 47: Lz4 Licensing

    PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Basler ace GigE...
  • Page 48: Avoiding Emi And Esd Problems

     The Basler application note called Avoiding EMI and ESD in Basler Camera Installations provides much more detail about avoiding EMI and ESD. This application note can be obtained from the Downloads section of the Basler website: www.baslerweb.com Basler ace GigE...
  • Page 49: Environmental Requirements

    You must provide sufficient heat dissipation to maintain the temperature of the camera housing at 50 °C or less. Since each installation is unique, Basler does not supply a strictly required technique for proper heat dissipation. Instead, we provide the following general guidelines: In all cases, you should monitor the temperature of the camera housing and make sure that the ...
  • Page 50: Precautions

    An incorrect plug can damage the 6-pin connector. The plug on the cable that you attach to the camera’s 6-pin connector must have 6 female pins. Using a plug designed for a smaller or a larger number of pins can damage the connector. Basler ace GigE...
  • Page 51 3. The code snippets in this manual are written in C++. Other programming languages can also be used to write code for use with Basler pylon. When writing code, you should use a programming language that is both compatible with pylon and appropriate for your application.
  • Page 52 Do not use solvents or thinners to clean the housing; they can damage the surface finish. Read the manual Read the manual carefully before using the camera! Basler ace GigE...
  • Page 53: Installation

    More extensive information about how to perform complicated installations is included in the Installation and Setup Guide for Cameras Used with Basler’s pylon API (AW000611xx000). You can download the Installation and Setup Guide for Cameras Used with Basler’s pylon API from the Downloads section of the Basler website: www.baslerweb.com...
  • Page 54 Installation AW00089317000 Basler ace GigE...
  • Page 55: Tools For Changing Camera Parameters

    The Basler pylon Camera Software Suite The Basler pylon Camera Software Suite is designed for use with all Basler cameras with the following interface types: IEEE 1394a interface, IEEE 1394b, GigE, or USB 3.0. It can also be used with newer Camera Link cameras. The pylon Camera Software Suite offers reliable, real-time image data transport into the memory of your PC at a very low CPU load.
  • Page 56: The Basler Pylon Ip Configurator

    The pylon IP Configurator is included in the Basler pylon Camera Software Suite. The pylon IP Configurator is a standalone application that lets you change the IP configuration of the camera via a GUI. The tool will detect all Basler GigE cameras attached to your network and let you make changes to a selected camera.
  • Page 57: Camera Functional Description

    Exposure start and exposure time can be controlled by parameters transmitted to the camera via the Basler pylon API and the GigE interface.  There are also parameters available to set the camera for single frame acquisition or continuous frame acquisition.
  • Page 58 This ensures that the data transmission rate has no influence on image quality. Progressive Scan CCD Sensor Vert. Vert. Vert. Vert. Shift Shift Shift Shift Pixels Pixels Pixels Pixels Reg. Reg. Reg. Reg. Horizontal Shift Register Fig. 29: CCD Sensor Architecture - Progressive Scan Sensors Basler ace GigE...
  • Page 59 Exposure Active Signal or Buffer Timer 1 Signal Image Image Data Data Ethernet Ethernet FPGA Sensor Network Controller Image Image Data Data Control Data Control Micro- Controller Control Control: Data AOI, Gain, Black Level Fig. 31: Camera Block Diagram Basler ace GigE...
  • Page 60: Overview Global Shutter With Cmos Sensor

    The camera provides features such as a global shutter and electronic exposure time control. Exposure start and exposure time can be controlled by parameters transmitted to the camera via the Basler pylon API and the GigE interface.  There are also parameters available to set the camera for single frame acquisition or continuous frame acquisition.
  • Page 61 Flash Window Signal or Timer 1 Signal Image Image Data Data Ethernet Ethernet Sensor FPGA Network Controller Image Data Image Data Control Data Control Control: AOI, Gain, Black Level Control Data Micro- Controller Fig. 33: Camera Block Diagram Basler ace GigE...
  • Page 62: Overview Rolling Shutter With Cmos Sensor

    The camera provides features such as an electronic rolling shutter and electronic exposure time control. Exposure start and exposure time can be controlled by parameters transmitted to the camera via the Basler pylon API and the GigE interface.  There are also parameters available to set the camera for single frame acquisition or continuous frame acquisition.
  • Page 63 Flash Window Signal or Timer 1 Signal Image Image Data Data Ethernet Ethernet Sensor FPGA Network Controller Image Data Image Data Control Data Control Control: AOI, Gain, Black Level Control Data Micro- Controller Fig. 35: Camera Block Diagram Basler ace GigE...
  • Page 64: Cameras With Switchable Shutter Mode

    50  the sensor architecture and rolling shutter mode, see Section 4.3 on page 52  electronic shutter operation in detail, see Section 7.7 on page 118  setting the shutter mode, see page 124  Basler ace GigE...
  • Page 65: Physical Interface

    Power supply (if PoE is not used) 100/1000 Mbit/s Ethernet connection to the camera   Access to I/O lines Power over Ethernet (PoE),   (if power is not supplied via 6-pin connector 8-pin RJ-45 Jack 6-pin Receptacle Fig. 36: Camera Connectors Basler ace GigE...
  • Page 66: Camera Connector Pin Assignments And Numbering

    Table 10: Pin Assignments for the 6-pin Connector Fig. 37: Pin Numbering for the 6-pin Connector 5.2.2 8-pin RJ-45 Jack Pin Assignments and Numbering Pin assignments and pin numbering adhere to the Ethernet standard and IEEE 802.3af. Basler ace GigE...
  • Page 67: Camera Connector Types

    The 8-pin jack for the camera’s Ethernet connection is a standard RJ-45 connector. The recommended mating connector is any standard 8-pin RJ-45 plug. Cables terminated with screw-lock connectors are available from Basler. Contact your Basler sales representative to order cable assemblies.
  • Page 68: Camera Cabling Requirements

     If you are supplying power to the camera via Power over Ethernet, the cable will not be used to supply power to the camera, but still can be used to connect to the I/O lines. Basler ace GigE...
  • Page 69 Close proximity to strong magnetic fields should be avoided. The required 6-pin Hirose plug is available from Basler. Basler also offers a cable assembly that is terminated with a 6-pin Hirose plug on one end and unterminated on the other. Contact your Basler sales representative to order connectors or cables.
  • Page 70: Plc Power And I/O Cable

    Close proximity to strong magnetic fields should be avoided. Basler offers a PLC power and I/O cable that is terminated with a 6-pin Hirose plug (HR10A-7P-6S) on the end that connects to the camera. The other end is unterminated. Contact your Basler sales representative to order the cable.
  • Page 71: Camera Power

    (see above) differs from the recommended voltage ranges for the input and output lines (see  Section 5.7.1 on page 63 and Section 5.8.1 on page 67). for Basler ace GigE cameras can differ from the recommended voltage range for camera  power for other Basler cameras. Basler ace GigE...
  • Page 72: Ethernet Gige Device Information

    For more information about the 6-pin connector and the power and I/O cables see Section 5.2 on page 56, Section 5.3 on page 57, and Section 5.4 on page Ethernet GigE Device Information The camera uses a standard Ethernet GigE transceiver. The transceiver is fully 100/1000 Base-T 802.3 compliant. Basler ace GigE...
  • Page 73: Input Line Description

    61) and for the output line (see Section 5.8.1 on page 67). for the I/O input line of Basler ace GigE cameras can differ from the recommended voltage  ranges for the I/O input lines of other Basler cameras. You must supply power within the specified voltage range.
  • Page 74: Characteristics

    Figure 40 shows an example of a typical circuit you can use to input a signal into the camera. Your 6-Pin Receptacle Input Voltage +30 VDC 10  I/O_In_1 Camera Absolute Max. I/O_Gnd Your In_1_Ctrl Fig. 40: Typical Input Circuit (Simplified) Basler ace GigE...
  • Page 75: Input Line Response Time

    (8.4 V with PLC cable) Time Level of Camera’s Internal Input Circuit Fig. 41: Input Line Response Times Time Delay Rise (TDR) = 1.3 µs to 1.6 µs Time Delay Fall (TDF) = 40 µs to 60 µs Basler ace GigE...
  • Page 76: Selecting The Input Line As The Source Signal For A Camera Function

    For more information about selecting input line 1 as the source signal for a camera function, see Section 6.1 on page Basler ace GigE...
  • Page 77: Output Line Description

    63). You must supply power within the specific voltage range. of Basler ace GigE cameras can differ from the recommended voltage ranges for the I/O  output lines of other Basler cameras. You must supply power within the specified voltage range.
  • Page 78 Figure 43 shows a typical circuit you can use to monitor the output line with a voltage signal. Your 6-Pin Receptacle +3.3 to +24 Camera Voltage I/O_Out_1 Out_1_Ctrl Output Signal I/O_Gnd to You Your Fig. 43: Typical Voltage Output Circuit (Simplified Example) Basler ace GigE...
  • Page 79 Output Line 1, see Section 6.2.1 on page For more information about output line pin assignments and pin numbering, see Section 5.2 on page  the Exposure Active signal, see Section 7.10 on page 135.  Basler ace GigE...
  • Page 80: Output Line Response Time

    For more information about selecting a source signal for the output line, see Section 6.2 on page Basler ace GigE...
  • Page 81: O Control

    Section 11.3 on page 314. For more information about the electrical characteristics of the input line, see Section 5.7 on page By default, input line 1 is selected as the source signal for the frame start trigger. Basler ace GigE...
  • Page 82: Input Line Debouncer

    The diagram also illustrates how the debouncer delays a valid signal. Unfiltered arriving signals Debouncer debouncer value Transferred valid signal delay TIMING CHARTS ARE NOT DRAWN TO SCALE Fig. 46: Filtering of Input Signals by the Debouncer Basler ace GigE...
  • Page 83: Setting The Input Line For Invert

    You can set the Line Selector and the value of the Line Debouncer Abs parameter from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: // Select the input line Camera.LineSelector.SetValue( LineSelector_Line1 );...
  • Page 84: Configuring The Output Line

    1. You can set the Line Selector and the Line Source parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.LineSelector.SetValue( LineSelector_Out1 );...
  • Page 85: Setting The State Of A User Settable Output Line

    You can set the Output Selector and the User Output Value parameters from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to designate the output line as user settable and to set the state of the output line: // Set output line 1 to user settable Camera.LineSelector.SetValue( LineSelector_Out1 );...
  • Page 86: Setting The Output Line For Invert

    You can set the Line Selector and the Line Inverter parameter values from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: // Enable the inverter on output line 1 Camera.LineSelector.SetValue( LineSelector_Out1 );...
  • Page 87: Working With The Timer Output Signal

    You can set the Trigger Selector and the Timer Trigger Source parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.TimerSelector.SetValue( TimerSelector_Timer1 );...
  • Page 88: Setting The Timer Delay Time

    1 µs increments. You can set the Timer Delay Time Base Abs parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter value: Camera.TimerDelayTimebaseAbs.SetValue( 5 );...
  • Page 89 You can set the Timer Selector and the Timer Delay Abs parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.TimerSelector.SetValue( TimerSelector_Timer1 );...
  • Page 90: Setting The Timer Duration Time

    1 µs and it can be changed in 1 µs increments. You can set the Timer Duration Time Base Abs parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter value: Camera.TimerDurationTimebaseAbs.SetValue( 5.0 );...
  • Page 91 You can set the Timer Selector and the Timer Duration Abs parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.TimerSelector.SetValue( TimerSelector_Timer1 );...
  • Page 92: Checking The State Of The I/O Lines

    You can set the Line Selector and read the Line Status parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and read the parameter value: // Select output line 1 and read the state Camera.LineSelector.SetValue( LineSelector_Out1 );...
  • Page 93: Image Acquisition Control

    A parameter called the Acquisition Mode has a direct bearing on how the Acquisition Start command operates. If the Acquisition Mode parameter is set to "single frame", you can only acquire one frame after executing an Acquisition Start command. When one frame has been acquired, the Acquisition Start Basler ace GigE...
  • Page 94 "waiting for frame start trigger" acquisition status. A new frame start trigger signal can then be applied to the camera to begin another frame exposure. The frame start trigger has two modes: off and on. Basler ace GigE...
  • Page 95 "waiting for frame start trigger" status Acquisition Frame Count parameter setting = 3 Acquisition Acquisition Start Stop Command Command Executed Executed Acquisition Start Trigger Signal Frame Start Trigger Signal Time Fig. 50: Acquisition Start and Frame Start Triggering Basler ace GigE...
  • Page 96 But in Basler pylon there is a single parameter, the Trigger Mode parameter, that is used to set the mode for both of these triggers. Also, the Trigger Software command can be executed for either the acquisition start trigger or the frame start trigger.
  • Page 97: Acquisition Start And Stop Commands And The Acquisition Mode

    "overlapped" exposure. To achieve the maximum possible acquisition frame rate, set the camera for the continuous acquisition mode and use "overlapped" exposure. For more information about overlapped exposure, see Section 7.11 on page 148. Basler ace GigE...
  • Page 98 You can set the Acquisition Mode parameter value and you can execute Acquisition Start or Acquisition Stop commands from within your application software by using the Basler pylon API. The code snippet below illustrates using the API to set the Acquisition Mode parameter value and to execute an Acquisition Start command.
  • Page 99: The Acquisition Start Trigger

    "waiting for acquisition start trigger" acquisition status and enter the "waiting for frame start trigger" acquisition status. The camera can then react to frame start trigger signals and will continue to do so until the number of frame start trigger signals it has received is equal to the current Acquisition Basler ace GigE...
  • Page 100: Acquisition Frame Count

    "waiting for acquisition start trigger" acquisition status. At that point, you must apply a new acquisition start trigger signal to exit the camera from the "waiting for acquisition start trigger" acquisition status. Basler ace GigE...
  • Page 101: Setting The Acquisition Start Trigger Mode And Related Parameters

    Camera.TriggerActivation.SetValue( TriggerActivation_RisingEdge ); // Set the acquisition frame count Camera.AcquisitionFrameCount.SetValue( 5 ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on page...
  • Page 102: Using A Software Acquisition Start Trigger

    You can set all of the parameters needed to perform software acquisition start triggering from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter values and to execute the commands related to software acquisition...
  • Page 103 // a Trigger Software command will apply a software acquisition start trigger // signal to the camera You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on page...
  • Page 104: Using A Hardware Acquisition Start Trigger

    You can set all of the parameters needed to perform hardware acquisition start triggering from within your application by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter values required to enable rising edge hardware acquisition start triggering with...
  • Page 105 // trigger, to trigger 5 frame starts, and to retrieve 5 frames here Camera.AcquisitionStop.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on...
  • Page 106: The Frame Start Trigger

    Section 7.1 on page 83  Section 7.3 on page Referring to the use case diagrams that appear in Section 7.11 on page 148 can help you understand the explanations of the frame start trigger. Basler ace GigE...
  • Page 107: Frame Start Trigger Mode

    When the Trigger Mode parameter for the frame start trigger is set to off, the exposure time for each frame acquisition is determined by the value of the camera’s Exposure Time Abs parameter. For more information about the camera’s Exposure Time Abs parameter, see Section 7.5 on page 109. Basler ace GigE...
  • Page 108: Frame Start Trigger Mode = On

    Exposure Time Abs parameter or it can be controlled by manipulating the hardware trigger signal. For more information about controlling exposure time when using a software trigger, see Section 7.4.2 on page 100.  when using a hardware trigger, see Section 7.4.3 on page 103.  Basler ace GigE...
  • Page 109: Setting The Frame Start Trigger Mode And Related Parameters

    You can set the Trigger Mode and related parameter values for the frame start trigger from within your application software by using the Basler pylon API. If your settings make it necessary, you can also set the Trigger Source parameter.
  • Page 110: Using A Software Frame Start Trigger

    Section 7.4.2.2 on page 101 includes more detailed information about applying a software frame start trigger signal to the camera using Basler pylon. For more information about determining the maximum allowed frame rate, see Section 7.12 on page 152.
  • Page 111: Setting The Parameters Related To Software Frame Start Triggering And Applying A Software Trigger Signal

    You can set all of the parameters needed to perform software frame start triggering from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter values and to execute the commands related to software frame start triggering with the camera set for continuous frame acquisition mode.
  • Page 112 // a Trigger Software command will apply a software frame start trigger // signal to the camera You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on...
  • Page 113: Using A Hardware Frame Start Trigger

     the ExFSTrig signal, see Section 7.4.3.4 on page 106. the electrical requirements for line 1, see Section 5.7 on page  determining the maximum allowed frame rate, see Section 7.12 on page 152.  Basler ace GigE...
  • Page 114: Exposure Modes

    Exposure Time Abs parameter) Fig. 53: Overtriggering with Timed Exposure For more information about the Frame Start Overtrigger event, see Section 10.15 on page 295.  the camera’s Exposure Time Abs parameter, see Section 7.5 on page 109.  Basler ace GigE...
  • Page 115 3000 µs to 5500 µs. In this case you would set the camera’s Exposure Overlap Time Max Abs parameter to 3000 µs. For more information about the Frame Trigger Wait signal and the Exposure Overlap Time Max Abs parameter, see Section 7.10.4 on page 140. Basler ace GigE...
  • Page 116: Frame Start Trigger Delay

    You can set all of the parameters needed to perform hardware frame start triggering from within your application by using the Basler pylon API. The following code snippet illustrates using the API to set the camera for single frame acquisition mode with the trigger mode for the acquisition start trigger set to off.
  • Page 117 // Set for the trigger width exposure mode Camera.ExposureMode.SetValue( ExposureMode_TriggerWidth ); // Set the exposure overlap time max abs - the shortest exposure time // we plan to use is 1500 us Camera.ExposureOverlapTimeMaxAbs.SetValue( 1500 ); // Prepare for frame acquisition here Camera.AcquisitionStart.Execute( ); Basler ace GigE...
  • Page 118 // frame start trigger signal (ExFSTrig signal)goes high // Retrieve the captured frames Camera.AcquisitionStop.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and pylon Viewer, see Section 3 on page...
  • Page 119: Aca750 - Acquisition Control Differences

    Note: The colors used in this drawing are designed to illustrate how the camera’s output modes work. They Horizontal Shift Registers do not represent the actual colors used in the color filter on acA750-30gc cameras. Fig. 55: Field 0 Readout Basler ace GigE...
  • Page 120 Note: The colors used in this drawing are designed to illustrate how the camera’s output modes work. They do not represent the actual colors used in the color Horizontal Shift Registers filter on acA750-30gc cameras. Fig. 56: Field 1 Readout Basler ace GigE...
  • Page 121: Field Output Modes

    1 and will transmit the field 1 pixel data as a frame. Frame Row 1 + Row 2 Row 3 + Row 4 Row 5 + Row 6 Row 7 + Row 8 Row 9 + Row 10 Fig. 58: Field 1 Output Mode Basler ace GigE...
  • Page 122 Row 8 + Row 9 Row 1 + Row 2 Row 3 + Row 4 Row 5 + Row 6 Field 1 Pixel Data Row 7 + Row 8 Row 9 + Row 10 Fig. 59: Concatenated New Fields Output Mode Basler ace GigE...
  • Page 123 Row 5 + Row 6 Row 6 + Row 7 Row 7 + Row 8 Row 8 + Row 9 Row 9 + Row 10 Field 1 Field 0 Pixel Data Pixel Data Fig. 60: Deinterlaced New Fields Output Mode Basler ace GigE...
  • Page 124: Setting The Field Output Mode

    Setting the Field Output Mode You can set the Field Output Mode parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the Field Output Mode: // Set the field output mode to Field 0 Camera.FieldOutputMode.SetValue( Field0 );...
  • Page 125: Setting The Exposure Time

    As some cameras can be operated either with global shutter or with rolling shutter the possible exposure time parameters depend on the selected shutter mode. Table 13 shows the values for cameras operated with global shutter. Table 14 shows the values for cameras operated with rolling shutter. Basler ace GigE...
  • Page 126 840000 µs acA1920-25gm/gc 35 µs 9999990 µs 35 µs acA2500-14gm/gc (*) 35 µs 9999990 µs * Switchable shutter mode. See Table 16 on page 118. Table 14: Minimum and Maximum Allowed Exposure Time Setting for Rolling Shutter Operation Basler ace GigE...
  • Page 127 AW00089317000 Image Acquisition Control You can use the Basler pylon API to set the Exposure Time Abs parameter value from within your application software. The following code snippet illustrates using the API to set the parameter value in different increments: Parameter set in increments of 1 µs:...
  • Page 128: Electronic Shutter Operation

    If used for moving objects:  Use of flash lighting and flash window recommended Table 16: Overview of Shutter Modes The following sections describe the differences between a global shutter and a rolling shutter. Basler ace GigE...
  • Page 129: Global Shutter

    Line 3 Line 4 Line 5 Line 6 Line 7 Line 8 Line 9 Line 10 Line 11 Line N-2 Line N-1 Line N Exposure Time Readout Time = line exposure = line readout Fig. 61: Global Shutter Basler ace GigE...
  • Page 130: Rolling Shutter

    The camera resets line two tRow later and begins exposing the line. And so on until the bottom line of pixels is reached (see Figure 62). The exposure time is the same for all lines and is determined by the Exposure Time Abs parameter setting. Basler ace GigE...
  • Page 131 [ tRow x (AOI Height) ] + C µs = Constant for evaluating total readout time. See Table 18. Total runtime Exposure Time Abs Parameter Setting + Total Readout Time Table 17: Formulas for Calculating the Runtime and Readout Time (ERS Mode) Basler ace GigE...
  • Page 132 And so on until the bottom line of pixels is reached (see Figure 63). The pixel values for each line are read out at the end of exposure time for the line. The readout time for each line is also equal to tRow (see Table 18). Basler ace GigE...
  • Page 133 When the camera is operating with the rolling shutter in the global reset release mode, the use of flash lighting is most strongly recommended. The camera supplies a flash window output signal to facilitate the use of flash lighting. Basler ace GigE...
  • Page 134 You can enable and disable the global reset release mode for the rolling shutter from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to enable and disable the global reset release mode: // Enable the global reset release mode Camera.GlobalResetReleaseModeEnable.SetValue( true );...
  • Page 135: The Flash Window

    Flash Window Width = line exposure time = line readout time Fig. 64: Flash Window for Rolling Shutter in the ERS Mode For more information about the Exposure Time Abs parameter, see Section 7.6 on page 115. Basler ace GigE...
  • Page 136 Flash Window Width = line exposure time = line readout time Fig. 65: Flash Window for Rolling Shutter in the Global Reset Release Mode For more information about the Exposure Time Abs parameter, see Section 7.6 on page 115. Basler ace GigE...
  • Page 137 The flash window signal is also available on cameras with a global shutter imaging sensor. On global shutter cameras, the flash window signal is simply the equivalent of the exposure active signal. For more information about the flash window signal, see Section 7.10.2 on page 137. Basler ace GigE...
  • Page 138: Overlapping Image Acquisitions - (Global Shutter Models)

    Figure 67 with the camera set for the trigger width exposure mode. ExFSTrig Signal Frame Acquisition N Frame Acquisition N+1 Frame Acquisition N+2 Exposure Readout Exposure Readout Exposure Readout Time Fig. 67: Non-overlapped Exposure and Readout Basler ace GigE...
  • Page 139 You can read the Readout Time Abs parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to get the parameter value: double ReadoutTime = Camera.ReadoutTimeAbs.GetValue( );...
  • Page 140 Exposure Overlap Time Max Abs parameter. For more information about the Frame Trigger Wait signal and the Exposure Overlap Time Max Abs parameter, see  Section 7.10.4 on page 140. trigger width exposure, see Section 7.4.3.2 on page 104.  Basler ace GigE...
  • Page 141: Overlapping Image Acquisitions - (Rolling Shutter Models)

    Figure 70 with the camera using an external frame start trigger. ExFSTrig Signal Frame Acquisition N Frame Acquisition N+1 Frame Acquisition N+2 Time = Line Exposure = Line Readout Fig. 70: Non-overlapped Acquisition Basler ace GigE...
  • Page 142 Exposure Time Abs Parameter Setting + Total Readout Time Overlapped frame acquisition can only be performed when the camera is in the electronic rolling shutter  mode (ERS). cannot be performed when the camera is set for global reset release rolling  shutter mode. Basler ace GigE...
  • Page 143 N (the last line). You can read the Readout Time Abs parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to get the parameter value: double ReadoutTime = Camera.ReadoutTimeAbs.GetValue( );...
  • Page 144 Overlapped frame acquisition can only be performed when the camera is in the electronic rolling shutter  mode (ERS). can not be performed when the camera is set for global reset release rolling  shutter mode. Basler ace GigE...
  • Page 145: Acquisition Monitoring Tools

    When you use the exposure active signal, be aware that there is a delay in the rise and the fall of the signal in relation to the start and the end of exposure. See Figure 73 for details. Basler ace GigE...
  • Page 146 2. Set the value of the Line Source Parameter to the exposure active output signal. You can set the Line Selector and the Line Source parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.LineSelector.SetValue( LineSelector_Out1 );...
  • Page 147: Flash Window Signal

    The flash window signal is also available on cameras with a global shutter imaging sensor. On global shutter cameras, the flash window signal is simply the equivalent of the exposure active signal. For more information about the rolling shutter and the flash window, see Section 7.7.2 on page 120. Basler ace GigE...
  • Page 148 2. Set the value of the Line Source Parameter to the flash window signal. You can set the Line Selector and the Line Source parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.LineSelector.SetValue( LineSelector_Out1 );...
  • Page 149: Acquisition Status Indicator

    If the value is set to "true", the camera is waiting for the trigger signal.  You can check the acquisition status from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to check the acquisition status:...
  • Page 150: Trigger Wait Signals

    3 and with exposure and readout overlapped on a camera with a global shutter. The figure assumes that the trigger mode for the frame start trigger is set to off, so the camera is internally generating frame start trigger signals. Basler ace GigE...
  • Page 151 Fig. 76: Acquisition Trigger Wait Signal The acquisition trigger wait signal will only be available when hardware acquisition start triggering is enabled. For more information about event reporting, see Section 10.15 on page 295. Basler ace GigE...
  • Page 152: The Frame Trigger Wait Signal

    2. Set the value of the Line Source Parameter to the acquisition trigger wait signal. You can set the Line Selector and the Line Source parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.LineSelector.SetValue( LineSelector_Out1 );...
  • Page 153 The frame trigger wait signal will only be available when hardware frame start triggering is enabled. For more information about event reporting, see Section 10.15 on page 295.  hardware triggering, see Section 7.4.3 on page 103.  Basler ace GigE...
  • Page 154 Abs parameter setting Frame Acquisition N+1 Exposure Readout Exp. Time Setting Frame Acquisition N+2 Exposure Readout Time = Camera is in a "waiting for frame start trigger" status Fig. 78: Frame Trigger Wait Signal with the Timed Exposure Mode Basler ace GigE...
  • Page 155 ExFSTrig signal to vary the exposure time in a range from 3000 µs to 5500 µs. In this case you would set the camera’s Exposure Overlap Time Max Abs parameter to 3000 µs. Basler ace GigE...
  • Page 156 Image Acquisition Control AW00089317000 You can use the Basler pylon API to set the Exposure Overlap Time Max Abs parameter value from within your application software. The following code snippet illustrates using the API to set the parameter value: Camera.ExposureOverlapTimeMaxAbs.SetValue( 3000 );...
  • Page 157: Camera Events

    2. Set the value of the Line Source Parameter to the frame trigger wait signal. You can set the Line Selector and the Line Source parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.LineSelector.SetValue( LineSelector_Out1 );...
  • Page 158: Acquisition Timing Chart

    Global Shutter ERS Mode GRR Mode (Default) acA640-90gm/gc 21.48 µs acA640-120gm/gc 17.62 µs acA645-100gm/gc 21.84 µs acA750-30gm/gc 48.97 µs acA780-75gm/gc 24.50 µs acA1280-60gm/gc 190 to 200 µs (*) acA1300-22gm/gc 34.50 µs acA1300-30gm/gc Table 20: Exposure Start Delays Basler ace GigE...
  • Page 159 848 to 883 µs (***) 848 µs acA2500-14gm/gc Depends on the exposure time Depends on the exposure time and the pixel format. *** Depends on whether the frame acquisitions are overlapped or not overlapped. Table 20: Exposure Start Delays Basler ace GigE...
  • Page 160 Readout Transmission Start Delay Transmission Start Delay Frame Frame N Transmission to Host PC Frame N+1 Transmission to Host PC Transmission Timing charts are not drawn to scale Fig. 81: Exposure Start Controlled with an ExFSTrig Signal Basler ace GigE...
  • Page 161 You can read the Readout Time Abs parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to get the parameter value: double ReadoutTime = Camera.ReadoutTimeAbs.GetValue( );...
  • Page 162: Maximum Allowed Frame Rate

    Support section of the Basler website:  www.baslerweb.com You can use the Basler pylon API to read the value of the camera’s Resulting Frame Rate Abs  parameter (see the next page).
  • Page 163 "overlapped" exposure. To achieve the maximum possible acquisition frame rate, set the camera for the continuous acquisition mode and use "overlapped" exposure. For more information about overlapped exposure, see Section 7.11 on page 148. Basler ace GigE...
  • Page 164: Using Basler Pylon To Check The Maximum Allowed Frame Rate

    7.12.1 Using Basler pylon to Check the Maximum Allowed Frame Rate You can use the Basler pylon API to read the current value of the Resulting Frame Rate Abs parameter from within your application software using the Basler pylon API. The following code...
  • Page 165 219. If you are working with an acA1600-60 camera: On the initial wake-up after delivery the Basler acA1600-60gm/gc cameras have default transport layer settings that do not allow to reach the specified maximum possible frame rate. If you want to obtain the maximum possible frame rate, change the values of the default...
  • Page 166: Removing The Frame Rate Limit (Aca640-120 Only)

    3. Read the value of the Resulting Frame rate parameter with the limit removed. For more information about using the remove parameter limits feature, see Section 10.15 on page 295.  the resulting Frame Rate parameter, see page 152.  Basler ace GigE...
  • Page 167: Use Case Descriptions And Diagrams

    The images can then be used for a variety of purposes including vegetation coverage estimates, archaeological site identification, etc. For more information about the Acquisition Frame Rate Abs parameter, see Section 7.3.1.1 on page Basler ace GigE...
  • Page 168 = frame exposure and readout = frame transmission Acquisition Acquisition Start Stop Command Command Executed Executed Acquisition Start Trigger Signal Frame Start Trigger Signal Time Fig. 82: Use Case 1 - Acquisition Start Trigger Off and Frame Start Trigger Off Basler ace GigE...
  • Page 169 When the electrical signal is received on line 1, it serves as a frame start trigger signal and initiates a frame acquisition. The frame acquired by the camera is forwarded to an image processing system, which will inspect the image and determine, if there are any defects in the plywood’s surface. Basler ace GigE...
  • Page 170 = frame transmission Acquisition Acquisition Start Stop Command Command Executed Executed Acquisition Start Trigger Signal Frame Start Trigger Signal (applied to line 1) Time Fig. 83: Use Case 2 - Acquisition Start Trigger Off and Frame Start Trigger On Basler ace GigE...
  • Page 171 (this avoids the need to store images of an empty toll booth area.) For more information about the Acquisition Frame Rate Abs parameter, see Section 7.3.1.1 on page Basler ace GigE...
  • Page 172 = frame transmission Acquisition Acquisition Start Stop Command Command Executed Executed Acquisition Start Trigger Signal (applied to line 1) Frame Start Trigger Signal Time Fig. 84: Use Case 3 - Acquisition Start Trigger On and Frame Start Trigger Off Basler ace GigE...
  • Page 173 (Transmitting images of the "space" between the objects would be a waste of bandwidth and processing them would be a waste of processor resources.) Basler ace GigE...
  • Page 174 Acquisition Start Stop Command Command Executed Executed Acquisition Start Trigger Software Command Executed Frame Start Trigger Signal (applied to line 1) Time Fig. 85: Use Case 4 - Acquisition Start Trigger On and Frame Start Trigger On Basler ace GigE...
  • Page 175: Color Creation And Enhancement

    "BG" filter alignment). As the figure illustrates, within each square of four pixels, one pixel sees only red light, one sees only blue light, and two pixels see only green light. (This combination mimics the human eye’s sensitivity to color.) Sensor Pixels Fig. 86: Bayer Filter Pattern Basler ace GigE...
  • Page 176: Bayer Color Filter Alignment

    For more information about the camera’s AOI feature, see Section 10.5 on page 216.  the reverse X and reverse Y features, see Section 10.11 on page 268.  Basler ace GigE...
  • Page 177: Pixel Data Formats Available On Cameras With A Bayer Filter

    So in essence, when a color camera is set for Mono 8, it outputs an 8 bit monochrome image. (This type of output is sometimes referred to as "Y Mono 8".) Basler ace GigE...
  • Page 178: Color Creation On The Aca750-30Gc

    "binned" pixel. As shown in Figure 88, when the camera acquires field 0, it will obtain the following color combinations for any group of four "binned" pixels: Green + Cyan Magenta + Cyan Magenta + Yellow Green + Yellow Basler ace GigE...
  • Page 179 = a cyan pixel in the sensor Ye+G Ye+G = a magenta pixel in the sensor Ye+M Ye+M = a yellow pixel in the sensor = a "binned" pixel in a vertical shift register Fig. 89: Color Combinations for Field 1 Basler ace GigE...
  • Page 180 A final transformation is performed on the RGB color information to convert it to YUV  information for each binned pixel. The binned pixel values are transmitted from the camera in a YUV format.  Basler ace GigE...
  • Page 181: Pixel Data Formats Available On Cameras With A Cmyeg Filter

    So in essence, when a color camera is set for Mono 8, it outputs an 8 bit monochrome image. (This type of output is sometimes referred to as "Y Mono 8".) Basler ace GigE...
  • Page 182: Integrated Ir Cut Filter

    If a lens with a very long thread length is used, the filter holder or the lens mount will be damaged or destroyed and the camera will no longer operate. For more information about the location of the IR cut filter, see Section 1.4.2 on page Basler ace GigE...
  • Page 183: Color Enhancement Features

    Section 8.4.4 on page 182. With the white balancing scheme used on these cameras, the red intensity, green intensity, and blue intensity can be individually adjusted. For each color, a Balance Ratio Abs parameter is used to set Basler ace GigE...
  • Page 184 You can set the Balance Ratio Selector and the Balance Ratio Abs parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.BalanceRatioSelector.SetValue( BalanceRatioSelector_Green );...
  • Page 185: Gamma Correction

    8 bit output and 4095 at 12 bit output) will not be corrected. Enabling and Setting Gamma Correction You can enable or disable the gamma correction feature by setting the value of the Gamma Enable parameter. Basler ace GigE...
  • Page 186 You can set the Gamma Enable parameter, use the Gamma Selector, and set Gamma parameter values from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter values for sRGB type correction: // Enable the Gamma feature Camera.GammaEnable.SetValue( true );...
  • Page 187: Matrix Color Transformation On All Color Models Except The Aca750-30Gc

    Tungsten - This setting will automatically populate the matrix with a pre-selected set of values  that will make appropriate corrections for images captured with tungsten lighting that has a color temperature of about 2500K to 3000K. When you select this setting, the camera will also Basler ace GigE...
  • Page 188 You can set the Processed Raw Enable, Color Transformation Selector and Light Source Selector parameter values from within your application software by using the Basler pylon API. In this example, we assume that you want to set your camera for Bayer BG 8 output, and therefore you must set the Processed Raw Enable parameter value to enabled.
  • Page 189 ( LightSourceSelector_Daylight6500K ); // Set the matrix correction factor Camera.ColorTransformationMatrixFactor.SetValue( 0.50 ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on page...
  • Page 190: The Custom Light Source Setting

    You can set the Color Transformation Value Selector, Color Transformation Value, and Color Transformation Value Raw parameters from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the values in the matrix. Note that the values in this example are just randomly selected numbers and do not represent values that you should actually use.
  • Page 191 // Select a position in the matrix Camera.ColorTransformationValueSelector.SetValue ( ColorTransformationValueSelector_Gain12 ); // Set the value for the selected position as an integer value Camera.ColorTransformationValueRaw.SetValue( 135 ); You can also use the Basler pylon Viewer application to easily set the parameters. Basler ace GigE...
  • Page 192: Matrix Color Transformation On Aca750-30Gc Cameras

    The custom setting should only be used by someone who is thoroughly familiar with matrix color transformations. Instructions for using the custom setting appear in the next section. Basler ace GigE...
  • Page 193 Setting Matrix Transformation You can set the Color Transformation Selector and Light Source Selector parameters from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter values: // Select the color transformation type Camera.ColorTransformationSelector.SetValue...
  • Page 194: The Custom Light Source Setting

    -8.0, 32 being equivalent to 1.0, and +255 being equivalent to +7.96875. The integer values can be entered using the Color transformation Value Raw parameter. A reference article that explains the basics of color matrix transformation for video data can be found at: http://www.its.bldrdoc.gov/publications/2437.aspx Basler ace GigE...
  • Page 195 // Set the value for the selected position as an integer value Camera.ColorTransformationValueRaw.SetValue( 135 ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on...
  • Page 196: Color Adjustment

    (Y), the mixing of green and blue light produces cyan light (C), and the mixing of blue and red light produces magenta light (M). When the three primary colors are mixed at maximum intensities, white will result. In the absence of light, black will result. Basler ace GigE...
  • Page 197  present. At minimum saturation, no "color" but only some shade of gray (including black and white) is present. White Black Fig. 90: RGB Color Cube With YCM Secondary Colors, Black, and White, Projected On a Plane Basler ace GigE...
  • Page 198 For example, if saturation for red is increased, the colorfulness of red colors in the image will increase. If red is set to minimum saturation, red will be replaced by gray for "red" colors in the image. Basler ace GigE...
  • Page 199 Adjustment Saturation Raw parameter values from within your application software by using the Basler pylon API. In this example, we assume that you want to set your camera for Bayer BG8 output, and therefore you must set the Processed Raw Enable parameter value to enabled.
  • Page 200 // Set the cyan saturation as an integer value Camera.ColorAdjustmentSaturationRaw.SetValue( 176 ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on...
  • Page 201: A Procedure For Setting The Color Enhancements

    Since it makes changing camera parameters quick and easy, we also recommend using the Basler pylon Viewer software when you are making adjustments. 1. Arrange your camera so that it is viewing a scene similar to what it will view during actual oper- ation.
  • Page 202: The "Color" Factory Setup

    For more information about the factory setups and about selecting and loading configuration sets, see Section 10.19 on page 305. Basler ace GigE...
  • Page 203: Pixel Data Formats

       acA640-120gc acA645-100gc    acA750-30gc acA780-75gc acA1300-22gc       acA1300-30gc acA1600-20gc acA1920-25gc acA2500-14gc • Table 23: Pixel Formats Available on Color Cameras ( = format available) - BG Models Basler ace GigE...
  • Page 204 196. You can set the Pixel Format parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter value: Camera.PixelFormat.SetValue( PixelFormat_Mono8 ); Camera.PixelFormat.SetValue( PixelFormat_Mono12Packed );...
  • Page 205 Camera.PixelFormat.SetValue( PixelFormat_BayerGR8 ); Camera.PixelFormat.SetValue( PixelFormat_BayerGR12 ); Camera.PixelFormat.SetValue( PixelFormat_BayerGR12Packed ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on page Basler ace GigE...
  • Page 206: Pixel Data Output Formats: Some Details For Color Cameras

    So in essence, when a color camera is set for Mono 8, it outputs an 8 bit monochrome image. (This type of output is sometimes referred to as "Y Mono 8".) Basler ace GigE...
  • Page 207: Standard Features

    Fig. 92: Gain in dB output by the camera were no higher than 127 (in an 8 bit mode), you could increase the gain to 6 dB (an amplification factor of 2) and thus reach gray values of 254. Basler ace GigE...
  • Page 208: Setting The Gain

    Min Setting with Max Setting Max Setting Vertical Binning (8 bit depth) (12 bit depth) (mono cameras) acA640-90gm/gc 1023 acA640-120gm/gc 1023 acA645-100gm/gc 1023 acA750-30gm/gc 1023 acA780-75gm/gc 1023 acA1300-22gm/gc acA1300-30gm/gc acA1600-20gm/gc Table 27: Minimum and Maximum Allowed Gain Raw Settings Basler ace GigE...
  • Page 209 The following code snippet illustrates using the API to set the selector and the parameter value: Camera.GainSelector.SetValue( GainSelector_All ); Camera.GainRaw.SetValue( 400 ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on page...
  • Page 210 2. Set the Gain Raw parameter to your desired value. You can set the Gain Selector and the Gain Raw parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.GainSelector.SetValue( GainSelector_All );...
  • Page 211 Max Setting Max Setting (8 bit depth) (12 bit depth) acA2000-50gm/gc acA2000-50gm/gc - CMV2000-V3 acA2000-50gmNIR acA2000-50gmNIR - CMV2000-V3 1.02 acA2040-25gm/gc acA2040-25gm/gc - CMV4000-V3 acA2040-25gmNIR acA2040-25gmNIR - CMV4000-V3 Table 30: Minimum and Maximum dB of Gain (acA2000-50, acA2040-25 Only) Basler ace GigE...
  • Page 212 2. Set the Gain Raw parameter to your desired value. You can set the Gain Selector and the Gain Raw parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.GainSelector.SetValue( GainSelector_All );...
  • Page 213: Analog Gain

    (2 * (1 + ((Digital Gain Raw Setting - 32) /64))) At a digital gain setting of 0, the camera’s digital gain will be 0 dB. At a setting of 95, the gain is approximately 12 dB. Basler ace GigE...
  • Page 214 If required, you can use the remove parameter limits feature for the gain to enlarge the gain range. For information on the remove parameter limits feature, see Section 10.3 on page 208 Basler ace GigE...
  • Page 215: Black Level

    For 8 bit: Mono 8, Bayer xx 8, YUV 4:2:2 Packed, YUV 4:2:2 (YUYV) Packed For 12 bit: Mono 12, Mono 12 Packed, Bayer xx 12, Bayer xx 12 Packed) Table 34: Effect of Increasing or Decreasing the Black Level Parameter II Basler ace GigE...
  • Page 216 12 bit: Mono 8, Bayer RG 8, YUV 4:2:2 Packed, YUV 4:2:2 (YUYV) Packed [When using one of the 12 bit modes the two least significant bits are set to 0.] Table 35: Effect of Increasing or Decreasing the Black Level Parameter III Basler ace GigE...
  • Page 217: Setting The Black Level

    You can set the Black Level Selector and the Black Level Raw parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.BlackLevelSelector.SetValue ( BlackLevelSelector_All );...
  • Page 218: Remove Parameter Limits

    The values for any extended limits can be determined by using the Basler pylon Viewer or from within your application via the pylon API.
  • Page 219 // Remove the limits for the selected feature. Camera.RemoveLimits.SetValue( true ); You can also use the Basler pylon Viewer application to easily set the parameters. Note that the remove parameter limits feature will only be available at the "guru" viewing level.
  • Page 220: Digital Shift

    1. If you do nonetheless, all bits output from the camera will automatically be set to 1. Therefore, you should only use the shift by 1 setting when your pixel readings with a 12 bit pixel format selected and with digital shift disabled are all less than 2048. Basler ace GigE...
  • Page 221 0 from the ADC along with 4 "0" "0" "0" "0" zeros as LSBs. The result of shifting 4 times is that the output of the camera is effectively multiplied by 16. Shifted Four Times Basler ace GigE...
  • Page 222: Digital Shift With 8 Bit Pixel Formats

    1. Therefore, you should only use the shift by 1 setting when your pixel readings with an 8 bit pixel format selected and with digital shift disabled are all less than 128. Shift by 2 Basler ace GigE...
  • Page 223 1. Therefore, you should only use the multiply by 4 setting when your pixel readings with an 8 bit pixel format selected and with digital shift disabled are all less than 16. Basler ace GigE...
  • Page 224: Precautions When Using Digital Shift

    64, you can safely use the shift by 1 or 2 settings.  32, you can safely use the shift by 1, 2, or 3 settings.  16, you can safely use the shift by 1, 2, 3, or 4 settings.  Basler ace GigE...
  • Page 225: Enabling And Setting Digital Shift

    You can set the Digital Shift parameter values from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter values: // Disable digital shift Camera.DigitalShift.SetValue( 0 );...
  • Page 226: Image Area Of Interest (Aoi)

    One of the main advantages of the AOI feature is that decreasing the height of the AOI can increase the camera’s maximum allowed acquisition frame rate. For more information about how changing the AOI height effects the maximum allowed frame rate, see Section 7.12 on page 152. Basler ace GigE...
  • Page 227: Setting The Aoi

    Normally, the X Offset, Y Offset, Width, and Height parameter settings refer to the physical columns and rows of pixels in the sensor. But if binning or decimation is enabled, these parameters are set in terms of "virtual" columns and rows. For more information, see Section 10.9.3 on page 261. Basler ace GigE...
  • Page 228: Changing Aoi Parameters "On-The-Fly

    You can set the Offset X, Offset Y, Width, and Height parameter values from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to get the maximum allowed settings and the increments for the Width and Height parameters. They also illustrate setting the Offset X, Offset Y, Width, and Height parameter values int64_t widthMax = Camera.Width.GetMax( );...
  • Page 229: Stacked Zone Imaging (Aca2000-50, Aca2040-25 Only)

    The Stacked Zone Imaging Zone Height parameter is set to 8.  With these settings, the camera would output an image that is 16 pixels wide and 24 lines (the total height of the three zones) high. Basler ace GigE...
  • Page 230 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 Zone 1 Offset Y Zone 0 Zone 1 Height Zone 2 Offset Y Zone 2 Zone 1 Height Zone 3 Offset Y Zone 2 Zone 3 Height Width Offset X Fig. 95: Stacked Zone Imaging Basler ace GigE...
  • Page 231 Offset Y: parameter indicates the Y offset for the zone nearest to the top of the sensor.  Height: parameter indicates the total height of the image that will be transmitted from the  camera (i.e., the sum of the heights of all zones). Basler ace GigE...
  • Page 232: Setting Stacked Zone Imaging

    Setting Stacked Zone Imaging Using Basler pylon You can set the parameter values associated with stacked zone imaging from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to set up two zones.
  • Page 233: Error Codes

    // Set the height for the selected zone Camera.StackedZoneImagingZoneHeight.SetValue( 200 ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on page 10.7 Error Codes...
  • Page 234 // Clear the value of the last error code in the memory Camera.ClearLastError.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameter and execute the command. For more information about the pylon API and the pylon Viewer, see Section 3 on...
  • Page 235: Sequencer

    "sequence" parameters:  Because the sequence sets reside in the camera’s FPGA, you can replace the values in the active set with values from one of the sequence sets almost instantaneously as images are acquired. Basler ace GigE...
  • Page 236 In this case the initial overlapped operation turns out to work as non-overlapped operation. As a consequence the frame rate can be significantly reduced. The sequence set currently setting the parameter values of the sequence parameters in the active set is also called the "current set". Basler ace GigE...
  • Page 237 For details about populating sequence sets and making related settings, see the sections below explaining the sequence advance modes. Basler ace GigE...
  • Page 238 (controlled sequence advance only) or by a software command. a non-cyclical advance allows to skip a sequence set and will advance to the sequence set  after the next. The non-cyclical advance can be controlled by a software command. Basler ace GigE...
  • Page 239 If you use the Sequence Set Selector parameter to select a sequence set and then you execute the Sequence Set Load command, the sequence parameter values in the active set will be replaced by the values stored in the selected sequence set. Basler ace GigE...
  • Page 240 // Load the sequence parameter values from the sequence set into the active set Camera.SequenceSetLoad.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameters. Use Case Diagrams Illustrating Sequencer Operation The sections below explain the sequence advance modes in detail. Use case descriptions and diagrams are designed to illustrate how the sequence advance modes work in some common situations and with some common combinations of parameter settings.
  • Page 241: Auto Sequence Advance Mode

    1 are used for the image acquisition. When the next frame start trigger was received, the camera checks the current Sequence Set  Executions parameter value. Because the Sequence Set Executions parameter was set to 3 Basler ace GigE...
  • Page 242 The sequencer feature is disabled while frame exposure and readout are in progress. The  complete frame is transmitted and the cycling through sequence sets is terminated. The sequencer parameter values in the active set return to the values that existed before the sequencer feature was enabled. Basler ace GigE...
  • Page 243 // Enable the sequencer feature Camera.SequenceEnable.SetValue( true ); // Disable the sequencer feature Camera.SequenceEnable.SetValue( false ); You can also use the Basler pylon Viewer application to easily set the parameters. Basler ace GigE...
  • Page 244: Configuration

    9. Repeat the above steps starting from step 4 for the other sequence sets. Configuring Sequence Sets and Advance Control Using Basler pylon You can use the pylon API to set the parameters for configuring sequence sets from within your application software.
  • Page 245 // Set the number of sequence set uses Camera.SequenceSetExecutions.SetValue( 4 ); // Store the sequence parameter values from the active set in the selected sequence // set Camera.SequenceSetStore.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameters. Basler ace GigE...
  • Page 246: Controlled Sequence Advance Mode

    When the sequencer feature becomes enabled, the sequence set cycle starts: The parameter  values of the sequence set with sequence set index number 0 are loaded into the active set modifying the active set. Basler ace GigE...
  • Page 247 = frame exposure and readout = frame transmission Sequencer Sequence Set Cycle Sequencer Enabled Starts Again Disabled Frame Start Trigger Signal Time Fig. 98: Sequencer in Controlled Sequence Advance Mode with Always Active as the Sequence Control Source Basler ace GigE...
  • Page 248 Note also that the camera briefly exits the "waiting for frame start trigger" status while the input line changes its state. This happened when input line 1 changed its state before the fourth frame start trigger was received (see also Figure 99). Basler ace GigE...
  • Page 249 When the next frame start triggers are received, the camera advances to the next sequence  sets and uses them for image acquisition in accord with the Always Active sequence control source and as described in the previous use case. Basler ace GigE...
  • Page 250 Sequence Set Cycle Sequence Set Cycle Starts Again Starts Again Frame Start Trigger Signal Time Fig. 99: Sequencer in Controlled Sequence Advance Mode with Always Active as the Sequence Control Source and Synchronous Restart Controlled by Line 1 Basler ace GigE...
  • Page 251: Operation With The Input Line As Sequence Control Source

    Also, maintain the state of the input line at least for one microsecond after the frame start trigger signal has risen. Basler ace GigE...
  • Page 252  line 1 is found to be high and therefore the parameter values of the next sequence set are loaded into the active set. The parameter values of sequence set 0 are used for the image acquisition. Basler ace GigE...
  • Page 253 Sequencer Sequencer Enabled Disabled Signal Applied to Input Line 1 Sequence Set Cycle (Advance) Starts Again Frame Start Trigger Signal Time Fig. 100: Sequencer in Controlled Sequence Advance Mode with Line 1 as the Sequence Control Source Basler ace GigE...
  • Page 254: Operation With The "Disabled" Sequence Control Source

    The AsyncAdvance command has not yet become effective because of the assumed associated delay. When the next frame start trigger is received, the camera checks the active set and uses it for  the image acquisition. The parameter values of sequence set 0 are used. Basler ace GigE...
  • Page 255 The parameter values of sequence set 0 are loaded into the active set. Note that the camera briefly exits the "waiting for frame start trigger" status while the parameter values of sequence set 1 are loaded into the active set (see also Figure 101). Basler ace GigE...
  • Page 256 While frame exposure and readout are in progress, the sequencer feature is disabled. The  complete frame is transmitted and the cycling through sequence sets is terminated. The sequencer parameter values in the active set return to the values that existed before the sequencer feature was enabled. Basler ace GigE...
  • Page 257 = frame exposure and readout = frame transmission Sequencer Sequencer Enabled Disabled Sequence Set Cycle Starts Again Time Fig. 101: Sequencer in Controlled Sequence Advance Mode with Disabled as the Sequence Control Source and Asynchronous Advance and Restart Basler ace GigE...
  • Page 258: Configuration

    // Enable the sequencer feature Camera.SequenceEnable.SetValue( true ); // Disable the sequencer feature Camera.SequenceEnable.SetValue( false ); You can also use the Basler pylon Viewer application to easily set the parameters. 10.8.2.4 Configuration Configuring Sequence Sets and Advance Control To populate sequence sets and to set the sources: 1.
  • Page 259 For information about setting the input line for invert, see Section 6.1.3 on page Configuring Sequence Sets and Advance Control Using Basler pylon You can use the pylon API to set the parameters for configuring sequence sets from within your application software.
  • Page 260 // Set up the second acquisition scenario (lighting, object position, etc.) and // adjust the camera parameters for the best image quality. // Store the sequence parameter values from the active set in the selected // sequence set Camera.SequenceSetStore.Execute( ); Basler ace GigE...
  • Page 261: Free Selection Sequence Advance Mode

    // Load the sequence parameter values from the sequence set into the active set Camera.SequenceSetLoad.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameters. 10.8.3 Free Selection Sequence Advance Mode When the free selection sequence advance mode is selected the advance form one sequence set...
  • Page 262 When the remaining frame start triggers were received, the camera checks the state of input  line 1. Because the state has not changed and will not for the remaining frame start triggers the parameter values of sequence set 1 are used for the image acquisitions. Basler ace GigE...
  • Page 263 (the sequence set index number is indicated) = frame exposure and readout = frame transmission Sequencer Sequencer Enabled Disabled Signal Applied to Input Line 1 Frame Start Trigger Signal Time Fig. 102: Sequencer in Free Selection Mode Basler ace GigE...
  • Page 264 // Disable the sequencer feature Camera.SequenceEnable.SetValue( false ); You can also use the Basler pylon Viewer application to easily set the parameters. Selecting Sequence Sets Each sequence set is identified by a sequence set index number, starting from zero. The states of the input line selects between the sequence sets by setting bit 0 of the sequence set address.
  • Page 265: Configuration

    9. Repeat the above steps for the other sequence set, starting from step 5. Configuring Sequence Sets and Advance Control Using Basler pylon You can use the pylon API to set the parameters for populating sequence sets from within your application software and make settings for their selection when images are acquired.
  • Page 266 // adjust the camera parameters for the best image quality. // Store the sequence parameter values from the active set in the selected // sequence set Camera.SequenceSetStore.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameters. Basler ace GigE...
  • Page 267: Binning

    The gray values of adjacent pixels from 3 rows are combined. As a consequence, the signal to noise ratio will be decreased while the camera’s response to light will be slightly increased. We recommend using vertical binning by 2 or by 4. Basler ace GigE...
  • Page 268 Section 10.9.3 on page 261. acA1280-60gm, acA1300-60gm, and acA1600-60gm For each binning method (horizontal and vertical binning) you can determine whether you want to use the summing method or the averaging method to be applied. Basler ace GigE...
  • Page 269: Binning On Color Cameras (Aca1920-25Gc And Aca2500-14Gc Only)

    The number of binned pixels depends on the horizontal color binning setting (see example in Figure 106). Example: Horizontal Color Binning by 2 (Shown for 2 Rows) Fig. 106: Horizontal Color Binning by 2 Basler ace GigE...
  • Page 270 You can set the Binning Vertical or the Binning Horizontal parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter values: // Enable vertical binning by 2 Camera.BinningVertical.SetValue( 2 );...
  • Page 271: Considerations When Using Binning

    3. Check whether the desired scene appears completely in the image. 4. If necessary, adjust the settings for the virtual rows or columns to fully capture the desired scene. When you disable binning, the resolution will revert back to its original values. Basler ace GigE...
  • Page 272 AOI is increased again. Therefore, Basler recommends to always check the AOI and offset settings after disabling binning and, if necessary, to manually set the AOI to the desired values.
  • Page 273 219. Binning’s Effect on Decimation If vertical binning is used, vertical decimation is automatically disabled, and vice versa, i.e. if vertical decimation is used, vertical binning is disabled. Horizontal binning works independently of the decimation feature. Basler ace GigE...
  • Page 274: Decimation

    (Figure 109). 2 for color cameras: only every second pair of rows  Fig. 108: Decimation Disabled of the acquired frame will be transmitted out of the camera (Figure 110). Basler ace GigE...
  • Page 275 1 disables vertical decimation. You can set the Vertical Decimation parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter values: // Enable Vertical Decimation by 8 Camera.DecimationVertical.SetValue( 8);...
  • Page 276: Considerations When Using Decimation

    1, i.e. the vertical decimation feature is deactivated, the AOI height can be smaller than the maximum possible height (determined by the pixel resolution in vertical direction). In this case you can manually set the AOI height back to the maximum possible height. Basler ace GigE...
  • Page 277: Horizontal Decimation

    1, i.e. the horizontal decimation feature is deactivated, the AOI width can be smaller than the maximum possible width (determined by the pixel resolution in horizontal direction). In this case you can manually set the AOI width back to the maximum possible height. Basler ace GigE...
  • Page 278: Mirror Imaging

    Figure 111 shows a normal image on the left and an image captured with reverse X enabled on the right. Normal Image Mirror Image Fig. 111: Reverse X Mirror Imaging Basler ace GigE...
  • Page 279 As a consequence, each auto function AOI will include a different portion of the captured image depending on whether or not the reverse X feature is enabled. For more information about auto functions, see Section 10.13 on page 276. Basler ace GigE...
  • Page 280: Reverse Y

    Y feature or both are used, the alignment of the color filter to the image remains Bayer GB. The camera includes a mechanism that keeps the filter alignment constant when these features are used. For more information about the color filter, see Section 8.1 on page 165. Basler ace GigE...
  • Page 281 Auto Auto AOI 1 AOI 2 AOI 1 AOI 2 Fig. 114: Using Reverse Y Mirror Imaging with Auto Functions Enabled For more information about auto functions and auto function AOIs, see Section 10.13 on page 276. Basler ace GigE...
  • Page 282: Enabling Reverse X And Reverse Y

    // Enable reverse X Camera.ReverseX.SetValue(true); // Enable reverse Y Camera.ReverseY.SetValue(true); You can also use the Basler pylon Viewer application to easily set the parameter. For more information about the pylon API and the pylon Viewer, see Section 3 on page Basler ace GigE...
  • Page 283: Luminance Lookup Table

    The second graph is for a lookup table where the values are arranged so that the camera output increases quickly as the digitized sensor output moves from 0 through 2048 and increases gradually as the digitized sensor output moves from 2049 through 4096. Basler ace GigE...
  • Page 284 Fig. 115: Lookup Table with Values Mapped in a Linear Fashion 4095 3072 12 Bit Camera Output 2048 1024 1024 2048 3072 4095 12 Bit Digitized Sensor Reading Fig. 116: Lookup Table with Values Mapped for Higher Camera Output at Low Sensor Readings Basler ace GigE...
  • Page 285 You can set the LUT Selector, the LUT Index parameter and the LUT Value parameter from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter values: // Select the lookup table Camera.LUTSelector.SetValue( LUTSelector_Luminance );...
  • Page 286: Auto Functions

    For example, with a short exposure time, insufficient illumination, and a low setting for the upper limit of the gain parameter value, the Gain Auto function may not be able to achieve the current target average gray value setting for the image. Basler ace GigE...
  • Page 287: Auto Function Operating Modes

    When an auto function is set to "off", the parameter value resulting from the latest automatic  adjustment will operate, unless the parameter is manually adjusted. You can enable auto functions and change their settings while the camera is capturing images ("on the fly"). Basler ace GigE...
  • Page 288: Auto Function Aois

    Y offset (coordinate), and a height. For example, suppose that you specify the X offset as 14, the width as 5, the Y offset as 7, and the height as 6. The area of the array that is bounded by these settings is shown in Figure 117. Basler ace GigE...
  • Page 289: Assignment Of An Auto Function To An Auto Function Aoi

    One limitation must be borne in mind: For the purpose of making assignments, the Gain Auto and the Exposure Auto auto functions are always considered as a single "Intensity" auto function and therefore the assignment is always identical for both auto functions. For example, if you assign the Basler ace GigE...
  • Page 290: Positioning Of An Auto Function Aoi Relative To The Image Aoi

    Camera.AutoFunctionAOIUsageIntensity.SetValue( false ); Camera.AutoFunctionAOIUsageWhiteBalance.SetValue( false ); You can also use the Basler pylon Viewer application to easily set the parameters. 10.13.3.2 Positioning of an Auto Function AOI Relative to the Image AOI The size and position of an Auto Function AOI can be, but need not be, identical to the size and position of the Image AOI.
  • Page 291 You can use auto functions when also using the reverse X and reverse Y mirroring features. For information about the behavior and roles of Auto Function AOI and Image AOI when also using the reverse X or reverse Y mirroring feature, see the "Mirror Image" (Section 10.11 on page 268). Basler ace GigE...
  • Page 292 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 Auto Function AOI Image AOI Fig. 118: Various Degrees of Overlap Between the Auto Function AOI and the Image AOI Basler ace GigE...
  • Page 293: Setting An Auto Function Aoi

    You can select an Auto Function AOI and set the X Offset, Y Offset, Width, and Height parameter values for the Auto Function AOI from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to select an Auto Function AOI and to get the maximum allowed settings for the Width and Height parameters.
  • Page 294: Gain Auto

    Camera.AutoFunctionAOIWidth.SetValue( Camera.AutoFunctionAOIWidth.GetMax() ); Camera.AutoFunctionAOIHeight.SetValue( Camera.AutoFunctionAOIHeight.GetMax() ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on page 10.13.4 Gain Auto Gain Auto is the "automatic" counterpart to manually setting the Gain Raw parameter. When the...
  • Page 295 0 (black) to 255 (white) when the camera is set for an 8 bit pixel format or from 0 (black) to 4095 (white) when the camera is set for a 12 bit pixel format. Setting the gain auto functionality using Basler pylon is a several step process: Select the Auto Function AOI 1.
  • Page 296: Exposure Auto

    AW00089317000 // Set the mode of operation for the gain auto function Camera.GainAuto.SetValue( GainAuto_Once ); You can also use the Basler pylon Viewer application to easily set the parameters. For general information about auto functions, see Section 10.13 on page 276.
  • Page 297 If the Auto Exposure Time Abs Upper Limit parameter is set to a sufficiently high value the camera’s frame rate may be decreased. To set the exposure auto functionality using Basler pylon: 1. Select the Auto Function AOI 1. 2. Set the value of the Offset X, Offset Y, Width, and Height parameters for the AOI.
  • Page 298 // Set the mode of operation for the exposure auto function Camera.ExposureAuto.SetValue( ExposureAuto_Continuous ); You can also use the Basler pylon Viewer application to easily set the parameters. For information about the pylon API and the pylon Viewer, see Section 3 on page 45 ...
  • Page 299: Gray Value Adjustment Damping

    You can set the gray value adjustment damping from within your application software by using the pylon API. The following code snippets illustrate using the API to set the gray value adjustment damping: Camera.GrayValueAdjustmentDampingRaw.SetValue(600); Camera.GrayValueAdjustmentDampingAbs.SetValue(0.5859); You can also use the Basler pylon Viewer application to easily set the parameters. Basler ace GigE...
  • Page 300: Auto Function Profile

    Camera.AutoFunctionProfile.SetValue( AutoFunctionProfile_GainMinimum Camera.GainAuto.SetValue( GainAuto_Continuous ); Camera.ExposureAuto.SetValue( ExposureAuto_Continuous ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on page 10.13.8 Balance White Auto Balance White Auto is the "automatic"...
  • Page 301 // Set mode of operation for balance white auto function Camera.BalanceWhiteAuto.SetValue( BalanceWhiteAuto_Once ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on page ...
  • Page 302: Using An Auto Function

    8. If necessary, set the auto function profile to define priorities between auto functions. 9. Enable the auto function by setting it to "once" or "continuous". For more information about the individual settings, see the previous sections that describe the individual auto functions. Basler ace GigE...
  • Page 303: Minimum Output Pulse Width

    You can set the Line Selector and the value of the MinOutPulseWidthAbs parameter from within your application software by using the pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Basler ace GigE...
  • Page 304 // Set the parameter value to 10.0 microseconds Camera.MinOutPulseWidthAbs.SetValue(10.0); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
  • Page 305: Event Reporting

    If an acknowledgement is still not received, the timeout and resend mechanism will repeat until a specified maximum number of retries is reached. If the maximum number of retries is reached and no acknowledge has been received, the message will be dropped. Basler ace GigE...
  • Page 306 4. As soon as transmission time is available, an event message containing the event overrun event will be transmitted to the PC. The event overrun event is simply a warning that events are being dropped. The notification contains no specific information about how many or which events have been dropped. Basler ace GigE...
  • Page 307 API. The pylon software development kit includes a "Grab_CameraEvents" code sample that illustrates the entire process. For more detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference.
  • Page 308: Test Images

    Test Image Selector to one of the test images or to "test image off". You can set the Test Image Selector from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to set the selector: // set for no test image Camera.TestImageSelector.SetValue( TestImageSelector_Off );...
  • Page 309: Test Image Descriptions

    The image moves by one pixel from right to left whenever a new image acquisition is initiated. The test pattern uses a counter that increments by one for each new image acquisition. The mathematical expression for this test image is: Gray Value = [column number + row number + counter] MOD 256 Basler ace GigE...
  • Page 310 5 will show the effects of the feature while test image 3 will not. This makes test image 5 useful for checking the effects of digital features such as the luminance lookup table. Basler ace GigE...
  • Page 311 The image moves by one pixel from right to left whenever you signal the camera to capture a new image. To display this test pattern on a monitor, you must convert the YUV output from the camera to 8 bit RGB. Fig. 121: Test Image Six Basler ace GigE...
  • Page 312: Device Information Parameters

    Device User ID (read / write) - is used to assign a user defined name to a device. This name  will be displayed in the Basler pylon Viewer and the Basler pylon IP Configurator. The name will also be visible in the "friendly name" field of the device information objects returned by pylon’s device enumeration procedure.
  • Page 313 // Read the Max Height parameter int64_t maxHeight = Camera.HeightMax.GetValue(); You can also use the Basler pylon Viewer application to easily read the parameters and to read or write the Device User ID. You can use the Basler pylon IP Configurator to read or write the Device User ID.
  • Page 314: User Defined Values

    UserDefinedValueSelector_Value1 ); int64_t UserValue1 = Camera.UserDefinedValue.GetValue(); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the Basler pylon API and the pylon Viewer, see Section 3 on page Basler ace GigE...
  • Page 315: Configuration Sets

    "startup" set, i.e., the set that will be loaded into the active set whenever the camera is powered on or reset. Instructions for loading the default set into the active set and for designating which set will be the startup set appear later in this section. Basler ace GigE...
  • Page 316: Selecting A Factory Setup As The Default Set

    To select which factory setup will be the default set: 1. Set the Default Set Selector to the Standard Factory Setup, High Gain Factory Setup, Auto Functions Factory Setup or Color Factory Setup. Basler ace GigE...
  • Page 317: Saving A User Set

    AW00089317000 Standard Features You can set the Default Set Selector from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector: If you want to select the Standard Factory Setup: Camera.DefaultSetSelector.SetValue(DefaultSetSelector_Standard);...
  • Page 318: Loading The User Set Or The Default Set Into The Active Set

    The standard factory setup is optimized for use in typical situations and will provide good camera performance in most cases. For more information about the Basler pylon API and the pylon Viewer, see Section 3 on page Basler ace GigE...
  • Page 319: Selecting The Startup Set

    You can set the User Set Default Selector from within your application software by using the pylon API. The following code snippet illustrates using the API to set the selector: Camera.UserSetDefaultSelector.SetValue( UserSetDefaultSelector_Default ); For more information about the Basler pylon API and the pylon Viewer, see Section 3 on page Basler ace GigE...
  • Page 320 Standard Features AW00089317000 Basler ace GigE...
  • Page 321: Chunk Features

    The features that add chunks to the acquired images are referred to as “chunk” features. Before you can use any of the features that add chunks to the image, you must make the chunk mode active. Making the chunk mode active is described in the next section. Basler ace GigE...
  • Page 322: Making The "Chunk Mode" Active And Enabling The Extended Data Stamp

    1. Set the Chunk Mode Active parameter to true. You can set the Chunk Mode Active parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter value: Camera.ChunkModeActive.SetValue( true );...
  • Page 323 = Camera.ChunkHeight.GetValue(); int64_t dynamicRangeMin = Camera.ChunkDynamicRangeMin.GetValue(); int64_t dynamicRangeMax = Camera.ChunkDynamicRangeMax.GetValue(); ChunkPixelFormatEnums pixelFormat = Camera.ChunkPixelFormat.GetValue(); For more information about using the chunk parser, see the sample code that is included with the Basler pylon Software Development Kit (SDK). Basler ace GigE...
  • Page 324: Frame Counter

    You can set the Chunk Selector and Chunk Enable parameter value from within your application software by using the Basler pylon API. You can also run the parser and retrieve the chunk data. The following code snippets illustrate using the API to activate the chunk mode, enable the frame...
  • Page 325 You can set the frame counter reset parameter values from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to configure and set the frame counter reset and to execute a reset via software.
  • Page 326 // execute reset by software Camera.CounterReset.Execute(); // Disable reset Camera.CounterResetSource.SetValue( CounterResetSource_Off ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on page ...
  • Page 327: Time Stamp

    You can set the Chunk Selector and Chunk Enable parameter value from within your application software by using the Basler pylon API. You can also run the parser and retrieve the chunk data. The following code snippets illustrate using the API to activate the chunk mode, enable the time...
  • Page 328: Trigger Input Counter

    You can set the Chunk Selector and Chunk Enable parameter value from within your application software by using the Basler pylon API. You can also run the parser and retrieve the chunk data. The following code snippets illustrate using the API to activate the chunk mode, enable the trigger...
  • Page 329 You can set the trigger input counter reset parameter values from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to configure and set the trigger input counter reset and to execute a reset via software.
  • Page 330 // execute reset by software Camera.CounterReset.Execute(); // Disable reset Camera.CounterResetSource.SetValue( CounterResetSource_Off ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on page ...
  • Page 331: Line Status All

    You can set the Chunk Selector and Chunk Enable parameter value from within your application software by using the Basler pylon API. You can also run the parser and retrieve the chunk data. The following code snippets illustrate using the API to activate the chunk mode, enable the line...
  • Page 332 ChunkParser.AttachBuffer( (unsigned char*) Result.Buffer(), Result.GetPayloadSize() ); int64_t lineStatusAll = Camera.ChunkLineStatusAll.GetValue(); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on page...
  • Page 333: Crc Checksum

    You can set the Chunk Selector and Chunk Enable parameter value from within your application software by using the Basler pylon API. You can also run the parser and retrieve the chunk data. The following code snippets illustrate using the API to activate the chunk mode, enable the time...
  • Page 334 ( ChunkParser.HasCRC() && ! ChunkParser.CheckCRC() ) cerr << "Image corrupted!" << endl; You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on...
  • Page 335: Sequence Set Index

    You can set the Chunk Selector and Chunk Enable parameter value from within your application software by using the Basler pylon API. You can also run the parser and retrieve the chunk data. The following code snippets illustrate using the API to activate the chunk mode, enable the time...
  • Page 336 Chunk Features AW00089317000 StreamGrabber.RetrieveResult( Result ); ChunkParser.AttachBuffer( (unsigned char*) Result.Buffer(), Result.GetPayloadSize() ); int64_t timeStamp = Camera.ChunkSequenceSetIndex.GetValue(); You can also use the Basler pylon Viewer application to easily set the parameters. Basler ace GigE...
  • Page 337: Troubleshooting And Support

    If you do decide to contact Basler technical support, please take a look at the form that appears on the last two pages of this section before you call. Filling out this form will help make sure that you have all of the information the Basler technical support team needs to help you with your problem.
  • Page 338: Before Contacting Basler Technical Support

    12.3 Before Contacting Basler Technical Support To help you as quickly and efficiently as possible when you have a problem with a Basler camera, it is important that you collect several pieces of information before you contact Basler technical support.
  • Page 339 Did your application ever run without problems? Parameter set It is very important for Basler technical support to get a copy of the exact camera parameters that you were using when the problem occurred. To make note of the parameters, use Basler’s pylon Viewer.
  • Page 340 Troubleshooting and Support AW00089317000 Basler ace GigE...
  • Page 341: Basler Network Drivers And Parameters

    Two network drivers are available for the network adapter used with your GigE cameras: The Basler filter driver is a basic GigE Vision network driver that is compatible with all  network adapters. The advantage of this driver is its extensive compatibility.
  • Page 342: The Basler Filter Driver

    AW00089317000 The Basler Filter Driver The Basler filter driver is a basic driver GigE Vision network driver. It is designed to be compatible with most network adapter cards. The functionality of the filter driver is relatively simple. For each frame, the driver checks the order of the incoming packets.
  • Page 343: The Basler Performance Driver

    The Basler performance driver uses a "receive window" to check the status of packets. The check for missing packets is made as packets enter the receive window. If a packet arrives from higher in the sequence of packets than expected, the preceding skipped packet or packets are detected as missing.
  • Page 344: General Parameters

    Basler Network Drivers and Parameters AW00089317000 A.2.1 General Parameters Enable Resend - Enables the packet resend mechanisms. If the Enable Resend parameter is set to false, the resend mechanisms are disabled. The performance driver will not check for missing packets and will not send resend requests to the camera.
  • Page 345 AW00089317000 Basler Network Drivers and Parameters Resend Request Threshold - This parameter determines the location of the resend request threshold within the receive window as shown in Figure 125. The parameter value is in per cent of the width of the receive window. In Figure 125 the resend request threshold is set at 33.33% of the width of the receive window.
  • Page 346: Timeout Resend Mechanism Parameters

    Basler Network Drivers and Parameters AW00089317000 A.2.3 Timeout Resend Mechanism Parameters The timeout resend mechanism is illustrated in Figure 126 where the following assumptions are made: The frame includes 3000 packets.  Packet 1002 is missing within the stream of packets and has not been recovered.
  • Page 347 AW00089317000 Basler Network Drivers and Parameters Maximum Number Resend Requests - The Maximum Number Resend Requests parameter sets the maximum number of resend requests the performance driver will send to the camera for each missing packet. Resend Timeout - The Resend Timeout parameter defines how long (in milliseconds) the performance driver will wait after detecting that a packet is missing before sending a resend request to the camera.
  • Page 348: Threshold And Timeout Resend Mechanisms Combined

    Basler Network Drivers and Parameters AW00089317000 A.2.4 Threshold and Timeout Resend Mechanisms Combined Figure 127 illustrates the combined action of the threshold and the timeout resend mechanisms where the following assumptions are made: All parameters set to default.  The frame includes 3000 packets.
  • Page 349 (12) Interval defined by the Packet Timeout parameter. You can set the performance driver parameter values from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to read and write the parameter values: // Get the Stream Parameters object Camera_t::StreamGrabber_t StreamGrabber( Camera.GetStreamGrabber(0) );...
  • Page 350: Adapter Properties

    AW00089317000 A.2.5 Adapter Properties When the Basler Performance driver is installed, it adds a set of "advanced" properties to the network adapter. These properties include: Max Packet Latency - A value in microseconds that defines how long the adapter will wait after it receives a packet before it generates a packet received interrupt.
  • Page 351: Transport Layer Parameters

    You can set the driver related transport layer parameter values from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to read and write the parameter values: // Read/Write Timeout Camera_t::TlParams_t TlParams( Camera.GetTLNodeMap() );...
  • Page 352 Basler Network Drivers and Parameters AW00089317000 Basler ace GigE...
  • Page 353: Appendix B Network Related Camera Parameters And Managing Bandwidth

    The packet size parameter sets the size of the packets that the camera will use when it sends the data payload via the selected stream channel. The value is in bytes. The value does not affect the Basler ace GigE...
  • Page 354 IPD = Inter-packet Delay setting in ticks (with a tick set to the 8 ns standard) When considering this formula, you should know that on a Gigabit network it takes one tick to transmit one byte. Also, be aware that the formula has been simplified for easier understanding. Basler ace GigE...
  • Page 355 The example also assumes that the camera is operating in a poor environment, so many packets are lost and many resends are required. The numbered text is keyed to the time periods in the chart. Basler ace GigE...
  • Page 356 15 resends would be required from the accumulator pool, but the pool only has 9 resends. So the 9 resends in the pool are used and 6 resend requests are answered with a "packet unavailable" error code. The accumulator pool is reduced to 0. Basler ace GigE...
  • Page 357 If software or hardware triggering is being used to control the camera’s frame rate, the maximum frame rate allowed with the current camera settings will be used to calculate the device max throughput. Basler ace GigE...
  • Page 358 You can read or set the camera’s network related parameter values from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter values: // Payload Size int64_t payloadSize = Camera.PayloadSize.GetValue();...
  • Page 359 // Resulting Framerate double resultingFps = Camera.ResultingFrameRateAbs.GetValue(); You can also use the Basler pylon Viewer application to easily set or view the parameter values. For more information about the pylon API and the pylon Viewer, see Section 3 on page...
  • Page 360: Managing Bandwidth When Multiple Cameras Share A Single Network Path

    If the sum of the bandwidth assigned values is less than 125 MByte/s, the cameras should be able to operate simultaneously without problems. If it is greater, you must lower the data output rate of one or more of the cameras. Basler ace GigE...
  • Page 361 After you have adjusted the Inter-packet Delay parameter on each camera, you can check the sum of the Bandwidth Assigned parameter values and see, if the sum is now less than 125 MByte/s. Basler ace GigE...
  • Page 362: A Procedure For Managing Bandwidth

    If you use the Basler filter driver and have already set network parameters for your network adapter during the installation of the Basler pylon software, continue with step two. Otherwise, open the...
  • Page 363 Unless you have already set the packet size for your network adapter during the installation of the Basler pylon software, check the documentation for your adapter to determine the maximum packet size (sometimes called “frame” size) that the adapter can handle. Many adapters can handle what is known as “jumbo packets”...
  • Page 364 To use the formula, you will need to know the current value of the Bandwidth Assigned parameter and the Bandwidth reserve parameter for each camera. 100 Bandwidth Reserved –  Data Bandwidth Assigned Bandwidth Assigned ---------------------------------------------------------------------- - Basler ace GigE...
  • Page 365 You can lower the data bandwidth needed by a camera either by lowering its frame rate or by decreasing the size of the area of interest (AOI). Once you have adjusted the frame rates and/or AOI settings on the cameras, you should repeat steps 2 through 6. Basler ace GigE...
  • Page 366 Network Related Camera Parameters and Managing Bandwidth AW00089317000 For more information about the camera’s maximum allowed frame transmission rate, see Section 7.12 on page 152.  the AOI, see Section 10.5 on page 216.  Basler ace GigE...
  • Page 367: Revision History

    AW00089309000 5 Apr 2011 Corrected an omission in the sensor size listings for the camera specifications. AW00089310000 6 Jun 2011 Made the appropriate changes throughout the manual to add the new acA1600-20gm/gc camera models. Basler ace GigE...
  • Page 368 310 accordingly. AW000893 12 000 16 Dec 2011 Indicated Basler AG as bearer of the copyright on the back of the front page. Corrected the pixel size for the acA640-90gm/gc camera in Section 1.2 on page Modified and extended the description of the sequencer feature in Section 10.8 on...
  • Page 369 Integrated minimum output pulse width feature, see Section 10.14 on  page 293. Integrated note on the slowdown of the sequencer feature for the  acA2500-14 in Section 10.8. Section 11 Replaced Z-modem by X-modem in Section 11.7 on page 321. Basler ace GigE...
  • Page 370  the voltage ranges for the input and output lines and that the recommended voltage range for camera power for Basler ace  GigE cameras differ from the recommended voltage range for camera...
  • Page 371 Changed the name of the acA640-100gm/gc camera model to acA640- 120gm/gc. Renaming throughout the manual: Changed pylon driver package to Basler pylon Camera Software Suite  IP Configuration Tool to IP Configurator  pylon Viewer Tool to pylon Viewer ...
  • Page 372 280, on page 227. Changed IR-cut filter to IR cut filter. Updated Section 10.18 on page 304: now 5 user defined values. Added note on page 349 on how to obtain the maximum frame rate for the acA1600-60. Basler ace GigE...
  • Page 373: Index

    ....302 device scan type parameter....302 device user ID parameter ...... 302 device vendor name parameter ..... 302 device version parameter ...... 302 cables digital shift..........210 Ethernet..........58 power and I/O (PLC) ......60 Basler ace GigE...
  • Page 374 ......208 input line removing parameter limits ..... 208 electrical characteristics.....64 restart propagation delay ......65 asynchronous ........229 voltage requirements ......63 synchronous ........229 reverse X ..........268 reverse Y ..........270 Basler ace GigE...
  • Page 375 305 standard power and I/O cable voltage requirements......63 startup parameter set .....306 startup set..........309 synchronous advance ......229 synchronous restart........229 test images ..........298 time stamp chunk feature ........317 timer ~ 1 ............77 ~ output signal........77 Basler ace GigE...
  • Page 376 Index AW00089317000 Basler ace GigE...

Table of Contents