Basler ace acA1920-155 User Manual Download Page 171

AW00123404000

Image Acquisition Control  

Basler ace USB 3.0

161

Selecting the Frame Trigger Wait Signal as the Source Signal for an Output Line

The frame trigger wait signal can be selected to act as the source signal for a camera output line, 
e.g. Line 2. Selecting a source signal for an output line is a two step process:

Use the Line Selector to select the output line, e.g. Line 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_Line2);

camera.LineSource.SetValue(LineSource_FrameTriggerWait);

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.1 on 

page 43

.

For more information about changing the selection of an output signal as the source signal for the 
output line, see Section 5.12.1 on 

page 80

.

For more information about the electrical characteristics of camera output lines, see Section 5.8.1 
on 

page 60

 and Section 5.9.3.1 on 

page 67

.

6.8.5

Camera Events

Certain camera events allow you to get informed about the current camera acquisition status:

FrameBurstStartEvent event: A frame burst start trigger has occurred. 

FrameStartEvent event: A frame start trigger has occurred. 

ExposureEndEvent event: The end of an exposure has occurred. 

For more information about the camera events and event notification, see Section 8.13 on 

page 277

.

Summary of Contents for ace acA1920-155

Page 1: ...USER S MANUAL FOR USB 3 0 CAMERAS Document Number AW001234 Version 04 Language 000 English Release Date 17 June 2015 The manual includes information about the following prototype cameras acA645 100 a...

Page 2: ...ded in this manual must be used with this equipment in order to comply with the limits for a computing device pursuant to Subpart J of Part 15 of FCC Rules For customers in Canada This apparatus compl...

Page 3: ...3 599 support europe baslerweb com The Americas Basler Inc 855 Springdale Drive Suite 203 Exton PA 19341 USA Tel 1 610 280 0171 Fax 1 610 280 7608 support usa baslerweb com Asia Pacific Region Basler...

Page 4: ......

Page 5: ...equirements 36 1 9 1 Temperature and Humidity 36 1 9 2 Heat Dissipation 36 1 10 Precautions 37 2 Installation 41 3 Camera Drivers and Tools for Changing Camera Parameters 43 3 1 The Basler pylon 4 Cam...

Page 6: ...s 75 5 11 Configuring Input Lines and Signals 76 5 11 1 Selecting an Input Line as the Source Signal for a Camera Function 76 5 11 2 Input Line Debouncers 77 5 11 3 Input Line Inverter 79 5 12 Configu...

Page 7: ...113 6 4 1 3 Setting The Frame Start Trigger Mode and Related Parameters 114 6 4 2 Using a Software Frame Start Trigger 116 6 4 2 1 Introduction 116 6 4 2 2 Setting the Parameters Related to Software...

Page 8: ...er Color Filter Alignment 178 7 1 2 Pixel Formats Available on Color Cameras 179 7 2 Integrated IR Cut Filter 181 7 3 Color Enhancement Features 182 7 3 1 Balance White 182 7 3 2 Light Source Presets...

Page 9: ...ion 250 8 9 Mirror Image 252 8 9 1 Reverse X 252 8 9 2 Reverse Y acA2000 165 and acA2040 90 Only 254 8 10 Luminance Lookup Table 256 8 11 Gamma Correction 259 8 12 Auto Functions 261 8 12 1 Common Cha...

Page 10: ...nk 297 8 18 3 2 Line Status All Chunk 297 8 18 3 3 Exposure Time Chunk 298 8 18 3 4 Timestamp Chunk 299 8 18 3 5 Counter Value Chunk 300 8 18 3 6 CRC Checksum Chunk 302 8 18 4 Retrieving Data Chunks 3...

Page 11: ...gly recommend that you read and follow the precautions 1 1 Models The current Basler ace USB 3 0 camera models are listed in the top row of the specification tables on the next pages of this manual Th...

Page 12: ...Mono 12p Mono 12 Color Models Mono 8 RGB 8 Bayer BG 8 BGR 8 Bayer BG 12 YCbCr422_8 Bayer BG 12p ADC Bit Depth 12 bits Synchronization Via external trigger signal via the USB 3 0 port or free run Expo...

Page 13: ...Vision USB IF in preparation The CE Conformity Declaration is available on the Basler website www baslerweb com Software Basler pylon 4 Camera Software Suite version 4 0 or higher Available for Windo...

Page 14: ...rigger signal or programmable via the camera API Camera Power Requirements Nominal 5 VDC SELV and LPS compliant and in accord with the Universal Serial Bus 3 0 specification supplied via the camera s...

Page 15: ...h 12 bits Synchronization Via external trigger signal via the USB 3 0 port or free run Exposure Control Via external trigger signal or programmable via the camera API Camera Power Requirements Nominal...

Page 16: ...ace USB 3 0 Software Basler pylon 4 Camera Software Suite version 4 0 or higher Available for Windows in 32 and 64 bit versions and Linux x86 32 bit x86 64 bit ARM softfloat ARM hardfloat Specificati...

Page 17: ...l via the USB 3 0 port or free run Exposure Control Via external trigger signal or programmable via the camera API Camera Power Requirements Nominal 5 VDC SELV and LPS compliant and in accord with the...

Page 18: ...8 Basler ace USB 3 0 Software Basler pylon 4 Camera Software Suite version 4 0 or higher Available for Windows in 32 and 64 bit versions and Linux x86 32 bit x86 64 bit ARM softfloat ARM hardfloat Spe...

Page 19: ...o 12 Bayer RG 8 Bayer RG 12 Bayer RG 12p ADC Bit Depth 12 bits Synchronization Via external trigger signal via the USB 3 0 port or free run Exposure Control Via external trigger signal or programmable...

Page 20: ...a external trigger signal via the USB 3 0 port or free run Exposure Control Via external trigger signal or programmable via the camera API Camera Power Requirements Nominal 5 VDC SELV and LPS complian...

Page 21: ...Via external trigger signal or programmable via the camera API Camera Power Requirements Nominal 5 VDC SELV and LPS compliant and in accord with the Universal Serial Bus 3 0 specification supplied via...

Page 22: ...Bayer BG 8 Bayer BG 12 Bayer BG 12p YCbCr422_8 ADC Bit Depth 12 bits Synchronization Via external trigger signal via the USB 3 0 port or free run Exposure Control Via external trigger signal or progra...

Page 23: ...ace USB 3 0 13 Software Basler pylon 4 Camera Software Suite version 4 0 or higher Available for Windows in 32 and 64 bit versions and Linux x86 32 bit x86 64 bit ARM softfloat ARM hardfloat Specifica...

Page 24: ...1 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 c...

Page 25: ...uirements and Precautions Basler ace USB 3 0 15 Wavelength nm Relative Response Fig 2 acA640 120um Spectral Response From Sensor Data Sheet Wavelength nm Relative Response Fig 3 acA645 100um Spectral...

Page 26: ...ace USB 3 0 1 0 0 9 0 8 0 7 0 6 0 5 0 4 0 3 0 2 0 1 0 0 400 500 600 700 800 900 1000 Wavelength nm Relative Response Fig 4 acA1300 30um Spectral Response From Sensor Data Sheet Wavelength nm Relative...

Page 27: ...0 650 750 850 950 1050 1150 0 10 20 30 40 50 60 70 Wavelength nm Quantum Efficiency Fig 6 acA1920 25um Spectral Response From Sensor Data Sheet Wavelength nm Relative Response Fig 7 acA1920 155um Spec...

Page 28: ...900 1000 10 20 30 40 50 60 70 Wavelength nm Quantum Efficiency Fig 8 acA2000 165um acA2040 90um Spectral Response From Sensor Data Sheet 0 400 500 600 700 800 900 1000 10 20 30 40 50 60 70 Wavelength...

Page 29: ...650 750 850 950 1050 1150 0 10 20 30 40 50 60 70 Wavelength nm Quantum Efficiency Fig 10 acA2500 14um Spectral Response From Sensor Data Sheet 400 500 600 700 0 1 0 2 0 3 0 4 0 0 0 5 800 900 1000 Wav...

Page 30: ...aracteristics and IR cut filter characteristics To obtain best performance from color models of the camera use of a dielectric IR cut filter is recommended The filter should transmit in a range from 4...

Page 31: ...ecautions Basler ace USB 3 0 21 Wavelength nm Relative Response Blue Green Red Fig 13 acA640 120uc Spectral Response From Sensor Data Sheet Wavelength nm Relative Response Blue Green Red Fig 14 acA645...

Page 32: ...0 9 0 8 0 7 0 6 0 5 0 4 0 3 0 2 0 1 0 0 400 450 500 550 600 650 700 Wavelength nm Relative Response Blue Green Red Fig 15 acA1300 30uc Spectral Response From Sensor Data Sheet Wavelength nm Relative R...

Page 33: ...600 650 700 750 0 5 10 15 20 25 30 35 40 45 50 Wavelength nm Quantum Efficiency Blue Green Red Fig 17 acA1920 25uc Spectral Response From Sensor Data Sheet Wavelength nm Relative Response Fig 18 acA19...

Page 34: ...avelength nm Quantum Efficiency Blue Green Red Fig 19 acA2000 165uc acA2040 90uc Spectral Response From Sensor Data Sheet 350 400 450 500 550 600 650 700 750 0 5 10 15 20 25 30 35 40 45 50 Wavelength...

Page 35: ...00 700 0 1 0 2 0 3 0 4 0 0 Wavelength nm Quantum Efficiency Blue Green Red Fig 21 acA3800 14uc Spectral Response From Sensor Data Sheet 0 5 400 500 600 700 0 6 0 1 0 2 0 3 0 4 0 0 Wavelength nm Quantu...

Page 36: ...e plastic cap that is shipped with the camera 1 4 1 Camera Dimensions and Mounting Points The dimensions in millimeters for cameras equipped with a C mount are as shown in Figure 23 The dimensions in...

Page 37: ...mensions in mm for Cameras with the C mount 16 5 23 7 dimension for M3 29 12 22 dimension for M2 20 7 Bottom 27 87 12 29 3 17 526 29 6 9 15 Top Photosensitive surface of the sensor 14 5 20 5 5 29 3 x...

Page 38: ...h the CS mount Note acA1920 20gm gc cameras are not available with CS mount 11 5 23 7 dimension for M3 29 12 22 dimension for M2 20 7 Bottom 28 15 7 29 3 12 526 29 6 9 10 Top Photosensitive surface of...

Page 39: ...to the camera body a maximum of 10 8 mm Camera with CS mount see Figure 26 The thread length can be a maximum of 4 6 mm and the lens can intrude into the camera body a maximum of 5 8 mm You can obtain...

Page 40: ...read 9 6 Max 10 8 Max Filter Holder mono and color cameras Fig 25 Maximum Lens Thread Length Dimensions in mm for Cameras with the C mount 6 Not to Scale CS mount Thread Unthreaded CS mount Lens 4 6 2...

Page 41: ...ews a different tightening sequence applies 1 5 1 Tightening Sequence When Using the M2 Screws 1 Tighten the screws for the mounting screw holes a in Figure 27 2 Tighten the screws for the mounting sc...

Page 42: ...1 5 2 Tightening Sequence When Using the M3 Screws 1 Tighten the screws for the mounting screw holes a in Figure 28 2 Tighten the screw for mounting screw hole b in Figure 28 Fig 28 Designations of t...

Page 43: ...ests 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 Test Standa...

Page 44: ...ce the above copyright notice this list of conditions and the following disclaimer in the documentation and or other materials provided with the distribution THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT...

Page 45: ...les Avoid placing camera cables parallel to wires carrying high current switching voltages such as wires supplying stepper motors or electrical devices that employ switching technology Placing camera...

Page 46: ...es In all cases you should monitor the temperature of the camera housing and make sure that the temperature does not exceed the maximum specified value for the housing temperature during operation Kee...

Page 47: ...ion the powered hub must meet the SELV and LPS requirements WARNING Fire Hazard Risk of Burn The power supplies used for supplying power to the I O lines and camera power must meet the Limited Power S...

Page 48: ...s particularly the sensor NOTICE On all cameras the lens thread length is limited All cameras mono and color are equipped with a plastic filter holder located in the cylindric housing extension The lo...

Page 49: ...nsport properly Transport the camera in its original packaging only Do not discard the packaging Clean properly Note Before starting the cleaning procedure cut off all power to the camera by unpluggin...

Page 50: ...Specifications Requirements and Precautions AW00123404000 40 Basler ace USB 3 0...

Page 51: ...r Death The power supplies used for supplying power to the I O lines and camera power must meet the Safety Extra Low Voltage SELV and Limited Power Source LPS requirements If you use a powered hub as...

Page 52: ...le from Basler and about purchasing go to the Basler website www baslerweb com Restricting factory parameter settings for acA2000 165u and acA2040 90u cameras will initially prevent them from operatin...

Page 53: ...rator allows you to obtain information about the architecture of the device tree to which your camera is connected and about the devices including your camera You can obtain the Basler pylon 4 Camera...

Page 54: ...of the camera s parameter settings via a GUI based interface All parameters and parameter values displayed by the pylon Viewer are loaded from the camera into the pylon Viewer The parameters and valu...

Page 55: ...ctionality from within your application software by using the pylon API The pylon Programmer s Guide and the pylon API Reference contain an introduction to the API and include information about all of...

Page 56: ...Camera Drivers and Tools for Changing Camera Parameters AW00123404000 46 Basler ace USB 3 0...

Page 57: ...ansported from the sensor s light sensitive elements pixels to the vertical shift registers see Figure 29 on page 48 The charges from the bottom row of pixels in the array are then moved into a horizo...

Page 58: ...gressive Scan Sensors Sensor ADC FPGA Controller Image Buffer Image Data Image Data I O Frame Burst Start Trigger Signal or Frame Start Trigger Signal or Frame Counter Reset Signal or Trigger InputCou...

Page 59: ...ed charges are read out of the sensor At readout the charges are transported from the row s light sensitive elements pixels to the analog processing controls see Figure 31 on page 49 As the charges mo...

Page 60: ...er Signal or Frame Start Trigger Signal or Frame Counter Reset Signal or Trigger Input Counter Reset Signal Frame Burst Trigger Wait Signal or Frame Trigger Wait Signal or Exposure Active Signal or Fl...

Page 61: ...s I O lines A USB 3 0 Micro B port used to provide a nominal 5 Gbit s SuperSpeed data transfer connection There is also a LED indicator located on the back of the camera Figure 33 shows the location...

Page 62: ...is as shown in Figure 34 The pin assignments and designations for the 6 pin connector are shown in Table 10 Pin Designation Function 1 Line 3 Direct coupled General Purpose I O GPIO 2 Line 1 Opto iso...

Page 63: ...recommended mating connector is the Hirose micro plug part number HR10A 7P 6S or the equivalent Contact your Basler sales representative to order cable assemblies 5 3 2 USB 3 0 Micro B Port The USB 3...

Page 64: ...assignments shown in the pin assignment table The maximum length of the I O cable is at least 10 m The cable must be shielded and have twisted pair wire to ensure that input signals are correctly rec...

Page 65: ...evated risk of EMI calls for taking additional measures like e g using shorter cables DANGER Electric Shock Hazard Risk of Burn or Death The power supply used for supplying camera power must meet the...

Page 66: ...E Voltage outside of the specified range can cause damage The camera s nominal operating voltage is 5 VDC effective at the camera s USB 3 0 port You must supply camera power in accord with the Univers...

Page 67: ...ne has the advantage of being distinctly more robust against EMI than a GPIO line used as an input However when using the opto isolated input line the delays involved are longer than for a GPIO line D...

Page 68: ...to isolated output line see Section 5 8 1 on page 60 and direct coupled GPIO lines Section 5 9 on page 63 for the I O input lines of Basler ace USB 3 0 cameras can differ from the safe operating volta...

Page 69: ...to use an externally generated frame start trigger ExFSTrig signal to control acquisition start see Section 6 4 on page 111 For more information about configuring the input line see Section 5 11 on p...

Page 70: ...line has the advantage of being distinctly more robust against EMI than a GPIO line used as an output However when using the opto isolated output line the delays involved are longer than for a GPIO li...

Page 71: ...igher impedance circuits tend to be more susceptible to EMI higher currents yield higher voltage drop on long cables NOTICE Voltage outside of the safe operating voltage range can cause damage The saf...

Page 72: ...numbering see Section 5 2 on page 52 For more information about the Exposure Active signal see Figure 6 8 1 on page 148 Q1 6 pin Receptacle 3 3 to 24 VDC Voltage Output Signal to You 1 6 3 4 2 5 Came...

Page 73: ...are compatible with TTL signals The next sections describe the differences in the GPIO electrical functionality when the lines are set to operate as inputs and when they are set to operate as outputs...

Page 74: ...g to your needs 2 Once a line is properly set make sure that you only apply electrical signals to the line that are appropriate for the line s current setting Direct coupled GPIO lines have the advant...

Page 75: ...to pin 3 Line 4 The figure shows as an example the use of a TTL or CMOS logic gate in the external circuit A different example for an external circuit is shown in Figure 39 NOTICE Voltage outside of...

Page 76: ...ra Logic Gate Input Bu ffer FPGA Input Ground for Direct coupled GPIO Fig 38 Direct coupled GPIO Line Schematic with the GPIO Line Set as an Input and with a Typical External Circuit Using a Logic Gat...

Page 77: ...tely 0 4 V at 50 mA and 25 C housing temperature The actual residual voltage however depends on camera operating temperature load current and production spread NOTICE Voltage outside of the safe opera...

Page 78: ...to be more susceptible to EMI higher currents yield higher voltage drop on long cables As shown in Figure 40 shows the applicable electrical circuit when a GPIO line is set to operate as an output The...

Page 79: ...5 7 through Section 5 9 With regard to use the two kinds of I O lines differ mainly in these respects The opto isolated I O lines have the advantage of being distinctly more robust against EMI than t...

Page 80: ...time for the camera s input circuit to react The minimum required pulse width will be longer for the opto isolated input line compared to a GPIO line and for a trigger signal using the active low sta...

Page 81: ...ernal Line Status Internal Line Status Propagation delay for the low high line status change Voltage region considered to indicate a high internal logical level Voltage region considered to indicate a...

Page 82: ...GPIO Outputs Line Inverters Disabled Voltage VDC 0 5 Voltage VDC 0 5 tPLH tPHL tPLH tPHL Direct coupled GPIO OUT 1 0 Time Internal Line Status Propagation delay for the low high line status change Tra...

Page 83: ...ation Delays Input Output Opto isolated IN Direct coupled GPIOs Opto isolated OUT Direct coupled GPIOs Operating temperature Unknown but temperature must be within specified range see Section 1 9 1 on...

Page 84: ...cific operating conditions Housing temperature 25 C Load resistance RL 170 I O supply voltage US 5 VDC For the graphical illustration of propagation delays see Figure 41 and Figure 42 Propagation Dela...

Page 85: ...elated to a fast edge increase the load resistance To minimize propagation delays related to a slow edge use an I O supply voltage between 3 3 VDC and 5 VDC and decrease the load resistance such that...

Page 86: ...ce signal for the frame burst start trigger camera will recognize an electrical signal applied to Line 1 as a frame burst start trigger Note When you apply an electrical signal to the input line the e...

Page 87: ...by the debouncer value Figure 43 illustrates how the debouncer filters out invalid input signals i e signals that are shorter than the debouncer value The diagram also illustrates how the debouncer d...

Page 88: ...value of the Line Debouncer Time parameter You can set the Line Selector and the value of the Line Debouncer Time parameter from within your application software by using the Basler pylon API The foll...

Page 89: ...the selected line or to false to disable inversion You can set the Line Selector and the Line Inverter parameter value from within your application software by using the pylon API The following code...

Page 90: ...ne Selector to select for example output line Line 2 2 Set the value of the Line Source Parameter to one of the available output signals or to user settable This will set the source signal for the out...

Page 91: ...see Section 6 8 4 on page 153 the exposure active signal see Section 6 8 1 on page 148 the flash window signal see Section 6 6 2 1 on page 138 and Section 6 8 2 on page 150 working with the timer out...

Page 92: ...the signal width of the original output signal is narrower than the set minimum the Line Minimum Output Pulse Width feature will increase the signal width to the set minimum before the signal is sent...

Page 93: ...ylon API The following code snippet illustrates using the API to set the selector and the parameter value As an example the opto isolated output line Line 2 is selected and the minimum output pulse wi...

Page 94: ...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 an output lin...

Page 95: ...of the UserOutputValueAll Parameter Bit Numbers and Assignment of Output Lines See Section 5 13 1 on page 90 for details about the relation between line status and its determining factors e g electri...

Page 96: ...alues with a single operation camera UserOutputValueAll SetValue 0 Reading all user output values with a single operation int64_t i camera UserOutputValueAll GetValue Set the value of the User Output...

Page 97: ...lector and the Line Inverter parameter value 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 val...

Page 98: ...ure Start is currently the only trigger source event available to start Timer 1 acA3800 14 and acA4600 10 cameras only Flash Window Start is currently the only trigger source event available to start...

Page 99: ...ect Timer 1 2 Set the value of the Timer Delay parameter You can set the Timer Selector and the Timer Delay parameter value from within your application software by using the Basler pylon API The foll...

Page 100: ...TimerDuration SetValue 10 0 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 1 on page 43 5...

Page 101: ...d Input Open or Connection at z Status True 1 Voltage Level Low True 1 Voltage Level High False 0 Table 18 Line Status for Different External Conditions Line 1 Opto isolated Input External Conditions...

Page 102: ...isolated output line The output line is connected to the external power supply via an external pull up resistor B external pull up resistor connected Fig 47 Use of an External Pull up Resistor With an...

Page 103: ...Disabled True 1 Not defined Enabled False 0 Low Enabled Disabled False 0 Low Enabled True 1 Not defined Table 20 Line Status for Different External Conditions Line 2 Opto isolated Output External Con...

Page 104: ...ord that you can read using the Basler pylon API As shown in Figure 48 each bit from bit 0 through 3 is associated with a different I O line The status of each I O line is expressed by its related bin...

Page 105: ...see Section 3 1 on page 43 5 14 2 Checking the Status of an Individual I O Line The following example illustrates checking the line status of output line Line 2 1 Use the Line Selector parameter to se...

Page 106: ...Physical Interface AW00123404000 96 Basler ace USB 3 0...

Page 107: ...is typically used to mean a single acquired image When reading the material in this chapter also refer to Figure 49 on page 99 and to the use case diagrams in Section 6 9 on page 162 These diagrams i...

Page 108: ...me burst start trigger acquisition status and will remain in that status until a new frame burst start trigger signal is applied As an example assume that the Trigger Mode parameter is set to on the A...

Page 109: ...imum allowed frame rate in Section 6 10 on page 165 Frame start trigger signals applied to the camera when it is not in a waiting for frame start trigger acquisition status will be ignored a frame sta...

Page 110: ...igger Software command mentioned earlier can be executed for either the frame burst start trigger or the frame start trigger So if you want to set the Trigger Mode or execute a Trigger Software comman...

Page 111: ...ame can be acquired When acquisition of one frame is complete the camera will execute an Acquisition Stop command internally and will no longer be able to acquire frames To acquire another frame you m...

Page 112: ...snippet also illustrates setting several parameters regarding frame triggering These parameters are discussed later in this chapter camera AcquisitionMode SetValue AcquisitionMode_SingleFrame camera...

Page 113: ...tart trigger acquisition status once a specified number of frame start triggers has been received Before more frames can be acquired a new frame burst start trigger signal must be applied to the camer...

Page 114: ...3 the latter not available on acA1920 155 cameras Specific software commands analogous to the Software command Line 1 When the source signal is set to Line 1 you apply a frame burst start trigger sign...

Page 115: ...camera cannot react to frame start trigger signals If a frame burst start trigger signal is applied to the camera the camera will exit the waiting for frame burst start trigger acquisition status and...

Page 116: ...etValue TriggerSource_Software Set the acquisition burst frame count camera AcquisitionBurstFrameCount SetValue 5 The following code snippet illustrates using the API to set the Trigger Mode to on the...

Page 117: ...oftware frame burst start trigger signal is received by the camera it will exit the waiting for frame burst start trigger acquisition status and will enter the waiting for frame start trigger acquisit...

Page 118: ...r_FrameBurstStart Set the mode for the selected trigger camera TriggerMode SetValue TriggerMode_On Set the source for the selected trigger camera TriggerSource SetValue TriggerSource_Software Set the...

Page 119: ...r signals when in this acquisition status When the appropriate ExFBTrig signal is applied to Line 1 e g a rising edge of the signal for rising edge triggering the camera will exit the waiting for fram...

Page 120: ...ue TriggerSelector_FrameBurstStart Set the mode for the selected trigger camera TriggerMode SetValue TriggerMode_On Set the source for the selected trigger camera TriggerSource SetValue TriggerSource_...

Page 121: ...proper Acquisition Start command must be applied to the camera A proper frame burst start trigger signal must be applied to the camera if the Trigger Mode parameter for the frame burst start trigger i...

Page 122: ...ives an Acquisition Stop command The rate at which the frame start trigger signals are generated can be determined by the camera s Acquisition Frame Rate parameter If the parameter is not enabled the...

Page 123: ...hardware trigger signal into physical input line Line 1 on the camera Line 3 Analogous to the Line 1 source signal However the GPIO line Line 3 must be configured for input Line 4 Analogous to the Li...

Page 124: ...pylon API If your settings make it necessary you can also set the Trigger Source parameter The following code snippet illustrates using the API to set the Trigger Mode for the frame start trigger to o...

Page 125: ...ler ace USB 3 0 115 Start frame capture Camera AcquisitionStart Execute You can also use the Basler pylon Viewer application to easily set the parameters For more information about the pylon API and t...

Page 126: ...igger signal to start each frame acquisition the camera s Exposure Mode parameter must be set to timed The exposure time for each acquired frame will be determined by the value of the camera s Exposur...

Page 127: ...internal frame rate control and allow you to control the frame rate with software frame start trigger signals camera AcquisitionFrameRateEnable SetValue false Select the frame start trigger camera Tr...

Page 128: ...will automatically return to the waiting for frame start trigger acquisition status When the camera is operating under control of an ExFSTrig signal the period of the ExFSTrig signal will determine t...

Page 129: ...ure Time parameter If the camera is set for rising edge triggering the exposure time starts when the ExFSTrig signal rises If the camera is set for falling edge triggering the exposure time starts whe...

Page 130: ...sure time begins when the ExFSTrig signal rises and continues until the ExFSTrig signal falls If the camera is set for falling edge triggering the exposure time begins when the ExFSTrig signal falls a...

Page 131: ...xample assume that you will be using trigger width exposure mode and that you intend to use the ExFSTrig signal to vary the exposure time in a range from 3000 s to 5500 s In this case you would set th...

Page 132: ...Trig signal falls The first time period ends when the ExFSTrig signal rises The second time period is the exposure time offset C4 It is automatically added to the first time period by the camera s sen...

Page 133: ...0 000 32 140 000 to 160 020 28 160 020 to 180 000 25 180 000 to 192 112 24 192 112 to 216 000 42 216 000 to 280 000 32 280 000 to 320 040 28 320 040 to 360 000 25 360 000 to 384 224 24 12 bit All allo...

Page 134: ...sure time in a range from 3000 s to 5500 s In this case you would set the camera s Exposure Overlap Time Max parameter to 3000 s For more information about the Frame Trigger Wait signal and the Exposu...

Page 135: ...t to off We will use the timed exposure mode with input line Line 1 as the trigger source and with rising edge triggering In this example we will use a trigger delay Set the acquisition mode to single...

Page 136: ...will disable the camera s internal frame rate control and allow you to control the frame rate with external frame start trigger signals camera AcquisitionFrameRateEnable SetValue false Select the fram...

Page 137: ...n automatically adjust the exposure time Manual adjustment of the exposure time parameter will only work correctly if the Exposure Auto function is disabled For more information about auto functions i...

Page 138: ...e current pixel format and on the currently available USB 3 0 bandwidth see Table 24 and Figure 56 Camera Model Pixel Format Bit Depth bit Device Link Throughput MByte s Exposure Time s Minimum Allowe...

Page 139: ...ion software The following code snippet illustrates using the API to set the parameter value Set the exposure time to 3500 s camera ExposureTime SetValue 3500 0 You can also use the Basler pylon Viewe...

Page 140: ...shutter when frame acquisition is triggered exposure begins for all lines in the sensor as shown in Figure 57 Exposure continues for all lines in the sensor until the programmed exposure time ends or...

Page 141: ...e Section 6 8 1 on page 148 For more information about the Sensor Readout Time parameter see Section 6 9 on page 162 Line 1 Line 2 Line 4 Line 3 Line 5 Line 6 Line 8 Line 7 Line 9 Line 10 Line 11 Line...

Page 142: ...the line The camera resets line three tRow later and begins exposing the line And so on until the bottom line of pixels is reached see Figure 58 The exposure time is the same for all lines and is dete...

Page 143: ...acA2500 14um 490 s 490 s 490 s acA3800 14um 3536 s 4430 s 4072 s Table 26 Exposure Overhead Time for Mono Cameras Camera Model Exposure Overhead C1 8 bit Pixel Format 12 bit Pixel Format 12 bit p Pixe...

Page 144: ...ive output signal that will go high when the exposure time for line one begins and will go low when the exposure time for line one ends If the camera is operating with the rolling shutter in ERS mode...

Page 145: ...re the same as in electronic rolling shutter mode see Table 25 on page 132 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 e...

Page 146: ...reset release mode gives you advantages over using the electronic rolling shutter mode In global reset release mode the flash window width extends over the entire exposure time of a line in the senso...

Page 147: ...ng shutter in the global 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 For more informati...

Page 148: ...Window Flash Window in Electronic Rolling Shutter Mode If you are using the electronic rolling shutter mode capturing images of moving objects requires the use of flash exposure If you don t use flas...

Page 149: ...dependent of bit depth acA3800 14um uc 24 725 s 28 475 s 31 412 s acA4600 10uc 30 775 s 33 500 s 37 025 s Table 30 Temporal Shift for Start of Exposure Between Two Consecutive Lines by Pixel Format Bi...

Page 150: ...d of exposure for each line You can avoid these problems by using flash lighting and by applying the flash during the flash window for each frame The flash window is the period of time during a frame...

Page 151: ...25 acA2500 14 acA3800 14 acA4600 10 models can provide a flash window output signal to aid you in the use of flash lighting The flash window signal will go high when the flash window for each image ac...

Page 152: ...erlapped mode of operation each time a frame is acquired the camera completes the entire exposure sensor readout process before acquisition of the next frame is started The exposure for a new frame do...

Page 153: ...n determine the sensor readout time by reading the value of the Sensor Readout Time parameter The parameter indicates what the readout time will be in microseconds given the camera s current settings...

Page 154: ...d in Figure 64 with the camera set for the trigger width exposure mode with rising edge triggering You can avoid violating this guideline by using the camera s Frame Trigger Wait signal to determine w...

Page 155: ...ted in Figure 65 with the camera using an external frame start trigger In the overlapped mode of operation the acquisition for a new frame begins while the camera is still completing the acquisition p...

Page 156: ...Parameter Setting Total Sensor Readout Time You can determine the total sensor readout time for a frame by reading the value of the Sensor Readout Time parameter This parameter indicates the time in m...

Page 157: ...me N before you can trigger acquisition of frame N 1 This requirement is illustrated in Figure 67 If this guideline is violated the camera will ignore the frame start trigger signal and will declare a...

Page 158: ...ect being imaged is movable For example assume that the camera is mounted on an arm mechanism and that the mechanism can move the camera to view different portions of a product assembly Typically you...

Page 159: ...output line is a two step process Use the Line Selector to select the output line e g Line 2 Set the value of the Line Source Parameter to the exposure active output signal You can set the Line Selec...

Page 160: ...acA4600 10 models can provide a flash window output signal to aid you in the use of flash lighting The flash window signal will go high when the flash window for each image acquisition opens and will...

Page 161: ...om 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 LineSele...

Page 162: ...using software frame burst start trigger and frame start trigger signals To determine the acquisition status of the camera via the Basler pylon API Use the Acquisition Status Selector to select the F...

Page 163: ...start or frame start via a hardware trigger signal 6 8 4 1 Frame Burst Trigger Wait Signal As you are acquiring frames the camera automatically monitors the frame burst start trigger status and suppl...

Page 164: ...burst start triggering is enabled Time Camera is in a waiting for frame burst start trigger status Frame Burst Trigger Wait Signal Frame Acquisition Exp Sensor Readout Frame Acquisition Exp Frame Acq...

Page 165: ...e source signal for an output line see Section 5 12 1 on page 80 For more information about the electrical characteristics of camera output lines see Section 5 8 1 on page 60 and Section 5 9 3 1 on pa...

Page 166: ...ation see Section 8 13 on page 277 For more information about hardware triggering see Section 6 3 5 on page 109 and Section 6 4 3 on page 118 The frame trigger wait signal will only be available when...

Page 167: ...ng the camera in the timed exposure mode you can avoid overtriggering by always making sure that the Frame Trigger Wait signal is high before you trigger the start of frame capture Frame Acquisition N...

Page 168: ...y using the ExFSTrig signal to start exposure when the Frame Trigger Wait signal is high You should set the Exposure Overlap Time Max parameter value to represent the shortest exposure time you intend...

Page 169: ...1 on page 67 Frame Trigger Wait Signal Details acA1920 25um uc acA2500 14um uc acA3800 14um uc acA4600 10uc Only For cameras with a rolling shutter the rise of the Frame Trigger Wait signal is based o...

Page 170: ...e ExFSTrig Signal Frame Trigger Wait Signal Camera in a waiting for frame start trigger status The rise of the Frame Trigger Wait signal is based on the minimum time 400 s required between the end of...

Page 171: ...neSelector_Line2 camera LineSource SetValue LineSource_FrameTriggerWait You can also use the Basler pylon Viewer application to easily set the parameters For more information about the pylon API and t...

Page 172: ...el to camera model The table below shows the exposure start delay for each camera model see Table 31 on page 163 The sensor readout time is the amount of time it takes to read out the data for an acqu...

Page 173: ...m uc 848 to 883 s with frame acquisitions overlapped 848 s with frame acquisitions not overlapped or in global reset release mode acA3800 14um uc 2970 s for mono cameras 2620 s for color cameras with...

Page 174: ...riggering Also assume that you have selected input line Line 1 to accept the hardware trigger signal that the input line response time is 1 5 s that the delay due to the debouncer setting for input li...

Page 175: ...decreases the camera s maximum allowed frame rate For more information about the global reset release shutter mode see the Global Reset Release Mode Section on page 135 There are two ways for determi...

Page 176: ...d indicates the maximum allowed frame rate given the current settings You can also use the Basler pylon Viewer application to easily read the parameter For more information about the pylon API and pyl...

Page 177: ...the frame rate But if you are using multiple cameras connected to one hub you may find that the transmission time is restricting the maximum allowed rate In this case you could use a multiport host a...

Page 178: ...er Mode parameter for the frame start trigger are both set to off The camera will generate all required frame burst start and frame start trigger signals internally When the camera is set this way it...

Page 179: ...trigger is off The camera will generate frame start trigger signals internally with no action by the user Settings Acquisition Mode Continuous Trigger Mode for the frame burst start trigger Off Trigge...

Page 180: ...gger signal source to input line Line 1 and the activation to rising edge so the rising edge of an externally generated electrical signal applied to Line 1 will serve as the frame start trigger signal...

Page 181: ...al to Line 1 to start each frame exposure Settings Acquisition Mode Continuous Trigger Mode for the frame burst start trigger Off Trigger Mode for the frame start trigger On Trigger Source for the fra...

Page 182: ...rt trigger signals will be generated is normally determined by the camera s Acquisition Frame Rate parameter If the Acquisition Frame Rate parameter is disabled the camera will acquire frames at the m...

Page 183: ...been acquired The frame start trigger is off The camera will generate frame start trigger signals internally with no action by the user Settings Acquisition Mode Continuous Trigger Mode for the frame...

Page 184: ...mera will only react to a frame start trigger signal when it is in a waiting for frame start trigger acquisition status A possible use for this type of setup is a conveyor system that moves objects pa...

Page 185: ...line Line 1 The user must apply a frame start trigger signal to input line Line 1 to start each frame exposure Settings Acquisition Mode Continuous Trigger Mode for the frame burst start trigger On T...

Page 186: ...Image Acquisition Control AW00123404000 176 Basler ace USB 3 0...

Page 187: ...refore need a basic knowledge of the Bayer filter to understand the pixel formats With the Bayer filter each individual pixel is covered by a part of the filter that allows light of only one color to...

Page 188: ...respectively Since the pattern of the Bayer filter is fixed you can use this information to determine the color of all of the other pixels in the image The Pixel Color Filter parameter indicates the a...

Page 189: ...a green portion of the filter you get 8 or 12 bits of green data And for each pixel covered with a blue portion of the filter you get 8 or 12 bits of blue data This type of pixel data is sometimes ref...

Page 190: ...onversion algorithm uses the following formulas Y 0 299 R 0 587 G 0 114 B Cb 0 16874 R 0 33126 G 0 5000 B 128 Cr 0 5000 R 0 41869 G 0 08131 B 128 After conversion to the YCbCr color model is complete...

Page 191: ...r is not populated with an IR cut filter For more information about the location of the IR cut filter in the camera see Section 1 4 2 on page 29 NOTICE On all cameras the lens thread length is limited...

Page 192: ...automatic process is also called a color transformation from RGB color space to RGB color space Note All color enhancements described in this section are performed on pixel data in RGB color space reg...

Page 193: ...minance of one color 1 Set the Balance Ratio Selector to red green or blue 2 Set the Balance Ratio parameter to the desired value for the selected color You can set the Balance Ratio Selector and the...

Page 194: ...as a color temperature of about 5000K When you select this setting the camera will also adjust the white balance settings and the color adjustment settings so that they are appropriate for a daylight...

Page 195: ...rameter value to Off no correction camera LightSourcePreset SetValue LightSourcePreset_Off Set the LightSourcePreset parameter value to Daylight5000K camera LightSourcePreset SetValue LightSourcePrese...

Page 196: ...t the white balance and see Section 7 3 5 on page 193 for an overall procedure for setting the color enhancement features Although color adjustment can be used without also using a light source preset...

Page 197: ...see Figure 82 on page 188 where the primary colors R G B the secondary colors C M Y and black and white define the corners All shades of gray are represented by the line connecting the black and the...

Page 198: ...R C M B G Y M B G Y Fig 82 RGB Color Cube With YCM Secondary Colors Black and White Projected On a Plane R C Saturation Adjustment Hue Adjustment Decrease Increase B G Y M Gray Fig 83 Hue and Saturat...

Page 199: ...is rotated in a positive direction towards magenta then for example orange in the image can be changed to red and red in the image can be changed to purple Red can be rotated as far as magenta where...

Page 200: ...AdjustmentSelector_Red Set the red hue parameter value camera ColorAdjustmentHue SetValue 1 125 Set the red saturation parameter value camera ColorAdjustmentSaturation SetValue 1 375 Select cyan as th...

Page 201: ...error For color transformation to work properly the white balance must be correct See Section 7 3 1 on page 182 for more information about the white balance and see Section 7 3 5 on page 193 for an o...

Page 202: ...Transformation Value Selector and Color Transformation Values from within your application software by using the Basler pylon API The following code snippet illustrates using the API to set the value...

Page 203: ...preset 4 Begin capturing images and check the basic image appearance Set the exposure time black level and gain so that you are acquiring good quality images It is important to make sure that the imag...

Page 204: ...ea to start by concentrating on one line in the color chart Once you have the colors in a line properly adjusted you can move on to each of the other lines in turn When you first start working with th...

Page 205: ...and results in a lower gray value for a given amount of sensor output Increasing the gain is useful when at your brightest exposure a gray value lower than 255 in modes that output 8 bits per pixel o...

Page 206: ...the gain Manual adjustment of the gain All parameter will only work if the Gain Auto function is disabled If the Gain Auto function is enabled the gain All parameter will merely be in a read only stat...

Page 207: ...0359 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 1 on page 43 To set the Gain paramet...

Page 208: ...1 Setting the Black Level The black level can be adjusted by changing the value of the Black Level parameter The range of the allowed settings for the Black Level parameter value in DN varies by came...

Page 209: ...e 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 camera BlackL...

Page 210: ...s on the gain feature will only remove the lower regular limit When the lower regular limit is removed the gain All parameter value can be decreased to a negative value For more information about the...

Page 211: ...the ADC Shift by 1 When the camera is set to shift by 1 the output from the camera will include bit 10 through bit 0 from the ADC along with a zero as an LSB The result of shifting once is that the ou...

Page 212: ...f you do nonetheless all bits output from the camera will automatically be set to 1 Therefore you should only use the shift by 2 setting when your pixel readings with a 12 bit pixel format selected an...

Page 213: ...12 bit ADC to digitize the output from the imaging sensor When the camera is set for a pixel format that outputs pixel data at 8 bit effective depth by default the camera drops the 4 least significan...

Page 214: ...amera s sensor are high enough to set bit 9 bit 10 or bit 11 to 1 we recommend not using shift by 3 If you do nonetheless all bits output from the camera will automatically be set to 1 Therefore that...

Page 215: ...ft by 1 setting If all of the readings are below 1024 you can safely use the shift by 1 or 2 settings If all of the readings are below 512 you can safely use the shift by 1 2 or 3 settings If all of t...

Page 216: ...by 1 shift by 2 shift by 3 or shift by 4 respectively You can set the Digital Shift parameter values from within your application software by using the Basler pylon API The following code snippet illu...

Page 217: ...te and a height For example suppose that you specify the offset X as 10 the width as 16 the offset Y as 6 and the height as 10 The region of the array that is bounded by these settings is shown in Fig...

Page 218: ...etY setting When you are setting the camera s region of interest you must follow these guidelines On all camera models The sum of the Offset X setting plus the Width setting must not exceed the width...

Page 219: ...1 acA640 120um 0 1 0 1 1 1 1 1 acA645 100um 0 1 0 1 1 1 1 1 acA1300 30um 0 1 0 1 1 1 1 1 acA1600 20um 0 1 0 1 1 1 1 1 acA1920 25um 0 1 0 1 64 1 64 1 acA1920 155um 0 4 0 2 4 4 1 1 acA2000 165um 0 1 0 1...

Page 220: ...uc 0 2 0 2 2 2 2 2 acA640 120uc 0 2 0 2 2 2 2 2 acA645 100uc 0 2 0 2 2 2 2 2 acA1300 30uc 0 2 0 2 2 2 2 2 acA1600 20uc 0 2 0 2 2 2 2 2 acA1920 25uc 0 2 0 2 64 2 64 2 acA1920 155uc 0 4 0 2 4 4 2 2 acA2...

Page 221: ...tion 8 7 4 on page 247 Camera Model Minimum ROI Height Mono Cameras No Vertical Binning Vertical Binning by 2 Enabled Vertical Binning by 3 Enabled Vertical Binning by 4 Enabled acA640 90um 1 1 1 1 ac...

Page 222: ...amera Width SetValue 1294 camera OffsetX SetValue 0 int64_t i camera HeightMax GetValue camera Height SetValue 964 Camera Model Minimum ROI Height Color Cameras No Horizontal Binning Horizontal Binnin...

Page 223: ...e following code snippet illustrates using the API to enable automatic ROI centering camera CenterX SetValue true camera CenterY SetValue true 8 5 2 Changing ROI Parameters On the Fly Making ROI param...

Page 224: ...ts This will include changing parameter values to make them appropriate for your requirements see Section 8 6 3 on page 222 To change the parameter values of a sequencer set you must first load the se...

Page 225: ...with the latest sequencer set advance The parameter values remain in the active set until they are replaced by the parameter values of the next sequencer set The sequencer parameters can be divided in...

Page 226: ...Height ExposureTime CenterX AcquisitionFrameRate CenterY AcquisitionFrameRateEnable ReverseX TimerDelay for Timer 1 ReverseY 1 TimerDuration for Timer 1 BinningHorizontal CounterEventSource BinningVer...

Page 227: ...see Section 8 6 3 on page 222 or when loading a sequencer set into the active set see Section 8 6 3 3 on page 225 The Sequencer Set Path parameter selects a path by its index number Two different pat...

Page 228: ...PIO set for input Software Signal 1 Software command Software Signal 2 Software command Software Signal 3 Software command not available on acA1920 155 cameras Counter 2 End Frame Start For each selec...

Page 229: ...trigger source for a so called asynchronous trigger is selected the advance to the next sequencer set will immediately be initialized by the trigger but will happen with some unspecified delay The se...

Page 230: ...ter 2 End refers to Counter 2 that counts consecutive frame start triggers When Counter 2 End is the trigger source advance to the next sequencer set will only be possible after Counter 2 has reached...

Page 231: ...cer set loading Accordingly the number of image acquisitions that may occur between sending the software command and it becoming effective can t be predicted We therefore strongly discourage using an...

Page 232: ...itional rules for configuring sequencer set 0 For Sequencer Set 0 the Sequencer Set Next value must be set to path 0 In addition the Sequencer Set Next value must be set to Sequencer Set 1 for path 1...

Page 233: ...tart and for sequencer set 0 and storing sequencer set 0 using the API to set the parameter values The example assumes that you have already set the current camera parameter values as desired for sequ...

Page 234: ...he sequencer set advance trigger source for path 0 always LevelHigh camera SequencerTriggerActivation SetValue SequencerTriggerActivation_LevelHigh Select path 1 for the selected sequencer set camera...

Page 235: ...he active set and then save the active set as a new sequencer set Make sure the sequencer mode is set to Off before issuing the Sequence Set Load command The following code snippet illustrates using t...

Page 236: ...entioned in Section 8 6 2 2 paths 0 and path 1 play different roles The cycling through the available sequencer sets can be accomplished using the path 1 sequencer trigger source Using the path 0 sequ...

Page 237: ...ath 0 you can return at any time to sequencer set 0 and therewith reset the cycling Setting the sequencer mode to Off will disable the sequencer feature for use with frame acquisitions The parameter v...

Page 238: ...t acquiring im ages i e idle sequencer not operating T r i g g e r f o r p a t h 0 Trigger for path 0 Sequencer set 1 in the active set Sequencer set 3 in the active set Sequencer set 2 in the active...

Page 239: ...alling edge triggering see Section 5 10 on page 69 The use cases assume that a total of four sequencer sets is available Use Case 1 Cycling Through Sequencer Sets According to Path 1 Use case one is i...

Page 240: ...path 1 and path 0 that occur between frame start triggers have no effect on sequencer set advance Use Case One in Detail Assuming that the sequencer sets are configured according to Table 41 on page...

Page 241: ...0 into the active set The parameter values for sequencer set 0 overwrite the parameter values for sequencer set 3in the active set A new cycle of sequencer sets starts A frame acquisition is carried o...

Page 242: ...3 The image data are processed and transmitted out of the camera The trigger signal assigned to path 1 goes low The trigger signal assigned to path 1 goes high When the next frame start trigger signal...

Page 243: ...t into the active set and thus makes it the current sequencer set current sequencer set that is used for image acquisition sequencer set was just loaded current sequencer set that is used for image ac...

Page 244: ...to the frame acquisitions The same sequencer set will be applied to the following frame acquisitions until the set end of Counter 2 counting is reached The end of counting is set by the Counter Durat...

Page 245: ...m Counter 2 count is also found to be 1 Accordingly the Counter 2 count related to sequencer set 1 has already reached its maximum and must start again with the next frame acquisition When the next fr...

Page 246: ...setting applicable to sequencer set 1 and defining the maximum Counter 2 count is also found to be 1 Accordingly the Counter 2 count related to sequencer set 1 has already reached its maximum and mus...

Page 247: ...ted to sequencer set 1 has already reached its maximum and must start again with the next frame acquisition When the Sequencer Mode parameter value is set to Off the sequencer feature becomes disabled...

Page 248: ...e set making it the current set current sequencer set that is used for image acquisition sequencer set was just loaded current sequencer set that is used for image acquisition already present in the a...

Page 249: ...ved between issuing a trigger and it becoming effective Accordingly the resulting sequencer operation is characterized by some degree of chance Sequencer Set related Settings Sequencer Set 0 Sequencer...

Page 250: ...l was received sequencer set 1 is present in the active set and is used for the image acquisition The image data are processed and transmitted out of the camera The second Software Signal 3 trigger is...

Page 251: ...rigger signal was received sequencer set 0 is present in the active set and is used for the image acquisition The image data are processed and transmitted out of the camera When the next frame start t...

Page 252: ...e trigger signal generated externally Software Signal trigger source Software Signal 1 for asynchronous reset of sequencer set advance Sequencer Mode Set to On Software Signal 3 Trigger Source Path 1...

Page 253: ...500 14 where also the color camera allows binning For more information about color binning see Section 8 7 2 on page 245 For the acA1920 25um and acA2500 14 vertical binning works in a different way V...

Page 254: ...combine vertical and horizontal binning This however can cause objects to appear distorted in the image For more information about possible image distortion due to combined vertical and horizontal bi...

Page 255: ...al color binning setting see the example in Figure 93 As the gray values are averaged during vertical color binning and not summed the signal to noise ratio will be increased while the camera s respon...

Page 256: ...ing Horizontal parameter Setting the parameter s value to 2 3 or 4 enables horizontal binning by 2 by 3 or by 4 respectively Setting the parameter s value to 1 disables horizontal binning You can set...

Page 257: ...he sensor and not to the physical rows and columns in the sensor as they normally would Another way to think of this is by using the concept of a virtual sensor For example assume that you are using a...

Page 258: ...ined with horizontal binning by 3 Binning s Effect on ROI Settings When you have the camera set to use binning keep in mind that the settings for your region of interest ROI will refer to the binned l...

Page 259: ...ure 96 This is valid for mono and color cameras 2 for mono cameras only every second row of the acquired frame will be transmitted out of the camera Figure 97 2 for color cameras only every second pai...

Page 260: ...e acA2000 165um camera has a maximum resolution of 2048 H x 1088 V If you set this camera to use vertical decimation by 5 the effective resolution of the sensor is reduced to 2048 H by 217 V If you re...

Page 261: ...red lines C For mono cameras C H_old x D_old D_old 1 For color cameras C H_old x D_old 2 x D_old 2 As soon as the covered lines are determined the camera calculates the new ROI height For mono cameras...

Page 262: ...wapped with the value of the next to last pixel and so on Figure 100 shows a normal image on the left and an image captured with reverse X enabled on the right Using ROIs with Reverse X You can use th...

Page 263: ...et the parameter For more information about the pylon API and the pylon Viewer see Section 3 1 on page 43 For color cameras provisions are made ensuring that the effective color filter alignment will...

Page 264: ...e next to bottom line and so on Figure 102 shows a normal image on the left and and an image captured with reverse Y enabled on the right Using ROIs with Reverse Y You can use the ROI feature when usi...

Page 265: ...et the parameter For more information about the pylon API and the pylon Viewer see Section 3 1 on page 43 For color cameras provisions are made ensuring that the effective color filter alignment will...

Page 266: ...that a pixel has a value of 24 And so on As you can see the table does not include a user defined 12 bit value for every pixel value that the sensor can report So what does the camera do when the ADC...

Page 267: ...ading 0 1024 2048 3072 4095 12 Bit Camera Output Fig 104 Lookup Table with Values Mapped in a Linear Fashion 0 1024 2048 3072 4095 12 Bit Digitized Sensor Reading 0 1024 2048 3072 4095 12 Bit Camera O...

Page 268: ...a lookup table Currently there is only one lookup table available i e the luminance lookup table described above Use the LUT Index parameter to select a value in the lookup table The LUT Index parame...

Page 269: ...The gamma correction value of 1 is the default value after camera reset or power up A gamma correction value between 0 and 1 will result in increased overall brightness and a gamma correction value g...

Page 270: ...our application software by using the Basler pylon API The following code snippet illustrates using the API to set the parameter value to 1 2 as an example Set the Gamma value to 1 2 camera Gamma SetV...

Page 271: ...Gain Auto function adjusts the gain parameter value the manually set gain parameter value is not preserved For some auto functions the target value is fixed For other auto functions the target value...

Page 272: ...usually be carried out for every or every other image The repeated automatic adjustment will proceed until the once mode of operation is used or until the auto function is set to off in which case the...

Page 273: ...l Note that an Auto Function ROI can be positioned anywhere on the sensor array An Auto Function ROI is referenced to the top left corner of the sensor array The top left corner of the sensor array is...

Page 274: ...ed at the same time You can assign auto functions to Auto Function ROIs from within your application software by using the pylon API As an example the following code snippet illustrates using the API...

Page 275: ...he image property If the Image ROI is completely included in the Auto Function ROI see b in Figure 107 only the pixel data from the Image ROI will be used to control the image property If the Image RO...

Page 276: ...13 14 15 16 17 18 19 0 1 0 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 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 Fig 107 Various Degrees of Overlap Between th...

Page 277: ...tting must not exceed the height of the camera s sensor For example on the acA1920 25um the sum of the Offset Y setting plus the Height setting must not exceed 1080 The X Offset Y Offset Width and Hei...

Page 278: ...e of the auto function ROI Note The code uses AOI instead of ROI For example ROI1 is named AOI1 in the code 1 camera AutoFunctionAOISelector SetValue AutoFunctionAOISelector_AOI1 camera AutoFunctionAO...

Page 279: ...to Gain Lower Limit parameters The minimum and maximum allowed settings for the Auto Gain Upper Limit and Auto Gain Lower Limit parameters depend on the current pixel data format on the current settin...

Page 280: ...lector_All camera AutoGainLowerLimit SetValue 0 0 camera AutoGainUpperLimit SetValue 19 745 Set the lowest possible lower limit and the highest possible upper limit for the gain auto function camera A...

Page 281: ...igger width exposure mode is selected the exposure auto function is not available For more information about setting the exposure time manually see Section 6 9 on page 162 For more information about t...

Page 282: ...mera AutoFunctionAOISelector SetValue AutoFunctionAOISelector_AOI1 camera AutoFunctionAOIUseBrightness SetValue true Set the position and size of the auto function ROI camera AutoFunctionAOIOffsetX Se...

Page 283: ...ra AutoTargetBrightness SetValue 0 50196 Set the mode of operation for the exposure auto function camera ExposureAuto SetValue ExposureAuto_Continuous You can also use the Basler pylon Viewer applicat...

Page 284: ...at the same time is a several step process 1 Set the value of the Auto Function Profile parameter to specify whether gain or exposure time will be minimized during automatic adjustments 2 Set the val...

Page 285: ...te balance of the image For more information about setting the white balance manually see Section 7 2 on page 181 1 Select the Auto Function ROI for example ROI 2 2 Set the value of the Offset X Offse...

Page 286: ...to the selected Auto Function ROI 3 Unassign the auto function you want to use from the other Auto Function ROI 4 Set the position and size of the Auto Function ROI 5 If necessary set the lower and u...

Page 287: ...ccurred ExposureEndEvent An Example of Event Notification An example related to the Frame Start Overtrigger event illustrates how event notification works The example assumes that your system is set f...

Page 288: ...the queue is to handle short term delays in the camera s ability to access the network and send event messages When event notification is working smoothly a single event will be placed in the queue a...

Page 289: ...mer s Guide and API Reference Event Event Parameter Name Supplementary Information Parameter Name Frame Start FrameStartEventData FrameStartEventTimestamp Frame Start Overtrigger FrameStartOvertrigger...

Page 290: ...ave no effect on the transmitted images But for test images 4 and 5 the camera s digital features will affect the images transmitted by the camera This makes test images 4 and 5 a good way to check th...

Page 291: ...on test image one will look similar to Figure 108 The mathematical expression for this test image Gray Value column number row number MOD 256 Test Image 2 Moving Diagonal Gray Gradient 8 bit The 8 bit...

Page 292: ...iagonal gray gradient image The difference between test image 4 and test image 2 is this if a camera feature that involves digital processing is enabled test image 4 will show the effects of the featu...

Page 293: ...camera is set for Y CbCr output As shown in Figure 109 test image six consists of diagonal color gradients when a Mono pixel format is selected gray gradients will appear The image moves by one pixel...

Page 294: ...device enumeration procedure Device Scan Type read only contains the scan type of the camera for example area scan Sensor Width read only contains the physical width of the sensor in pixels Sensor Hei...

Page 295: ...etValue 0 Set the Device Link Throughput Limit Mode parameter camera DeviceLinkSelector SetValue 0 camera DeviceLinkThroughputLimitMode SetValue DeviceLinkThroughputLimitMode_On Set the Device Link Th...

Page 296: ...nt64_t i camera WidthMax GetValue Read the HeightMax parameter int64_t i camera HeightMax GetValue You can also use the Basler pylon Viewer application to easily read the parameters and to read or wri...

Page 297: ...se the pylon API to set the User Defined Value Selector and the User Defined Value parameter value from within your application software The following code snippet illustrates using the API to set the...

Page 298: ...ation set is stored in the camera s volatile memory and the settings are lost if the camera is reset or if power is switched off The camera can save most of the settings from the current active set to...

Page 299: ...with factory setups are saved in permanent files in the camera s non volatile memory They are not lost when the camera is reset or switched off and they can not be changed For more information about a...

Page 300: ...on 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 Default User Set camera UserSetSelector SetValue UserSetSel...

Page 301: ...following code snippet illustrates using the API to set the selector to e g User Set 1 and execute the command camera UserSetSelector SetValue UserSetSelector_UserSet1 camera UserSetSave Execute For d...

Page 302: ...d User Set e g User Set 2 2 Execute a User Set Load command to load the selected user set into the active user set You can set the User Set Selector and execute the User Set Load command from within y...

Page 303: ...ed when the camera is idle i e when it is not acquiring images continuously or does not have a single image acquisition pending Loading the Default User Set with the standard factory setup into the ac...

Page 304: ...Set Default camera UserSetDefault SetValue UserSetDefault_Default If you want to designate the High Gain User Setas User Set Default camera UserSetDefault SetValue UserSetDefault_HighGain If you want...

Page 305: ...gain All parameter value used for the image acquisition and develops a data chunk to be appended to the image data And if the time stamp chunk feature is enabled the camera develops a time stamp data...

Page 306: ...er pylon Programmer s Guide and API Reference You can also use the Basler pylon Viewer application to easily set the parameters The individual data chunks e g the Gain chunk can be selected to be appe...

Page 307: ...4 on page 303 You can set the Chunk Selector and Chunk Enable parameter value from within your application software by using the Basler pylon Camera Software Suite The following code snippet illustrat...

Page 308: ...chunk feature adds a chunk to each acquired image containing the exposure time parameter value in s used for the image acquisition 1 Use the Chunk Selector to select the Exposure Time chunk 2 Use the...

Page 309: ...and Chunk Mode Active is enabled the camera will append a timestamp chunk to each acquired image After an image with an appended chunk has been received by your PC the chunk must be retrieved For info...

Page 310: ...he chunk selector to select the counter value chunk 2 Use the Chunk Enable parameter to set the value of the chunk to true Once the counter value chunk is enabled and Chunk Mode Active is enabled the...

Page 311: ...e using the API to configure and set the frame counter reset and to execute a reset via software Select counter 1 and assign Frame Start as event source camera CounterSelector SetValue CounterSelector...

Page 312: ...provided by the chunk parser is not the CRC checksum itself Rather it is a true false result When the image and appended chunks pass through the parser the parser calculates a CRC checksum based on t...

Page 313: ...or a set of chunks The calculated maximum size is derived from the current camera parameter settings ROI size pixel format selected data chunks etc The actual size of a set of chunks as received by th...

Page 314: ...data chunk The chunk data can be accessed using the chunk data node map For more information about accessing chunk data see the documentation for the C API in the Basler pylon Programmer s Guide and...

Page 315: ...t and Downloads sections of our website www baslerweb com If you do decide to contact Basler technical support please take a look at Section 9 3 on page 306 before you call The section gives informati...

Page 316: ...low 1 Click the question mark in the menu bar of the Basler pylon USB Configurator 2 Click Generate Support Information in the dropdown menu The Support Information window opens displaying a report 3...

Page 317: ...amera Do you use a hub Yes No 4 Describe the problem in as much detail as possible If you need more space use an extra sheet of paper 5 If known what s the cause of the problem 6 When did the problem...

Page 318: ...copy of the exact camera parameters that you were using when the problem occurred To make note of the parameters use the Basler pylon Viewer If you cannot access the camera please try to state the fo...

Page 319: ...I problems Expanded the precautions about avoiding dust on the sensor about using the correct plug and about cleaning properly in Section 1 10 on page 37 Added a reference to the Recommended Component...

Page 320: ...1 on page 57 Section 5 8 1 on page 60 Section 5 9 2 on page 65 and Section 5 9 3 on page 67 Added a note about the occurrence of a frame acquisition when enabling or disabling the inverter in Section...

Page 321: ...white 182 automatic adjustment 275 balance ratio 183 manual adjustment 183 balance white auto 275 Bayer filter 177 Bayer pixel format 179 binning 243 color cameras 245 horizontal 243 245 image distor...

Page 322: ...vertrigger 277 frame start trigger 277 event notification 277 exposure ExFSTrig controlled 122 exposure time offset 122 exposure auto 271 exposure end event 277 exposure modes trigger width 122 exposu...

Page 323: ...K 184 Daylight 6500 K 184 Off 184 preset 184 Tungsten 2800 K 184 light source preset 191 line inverter output line 87 line logic 94 line minimum output pulse width 82 setting 83 line status all I O li...

Page 324: ...egion of interest remove limits parameter 200 223 removing parameter limits 200 response time see propagation delay reverse X 252 254 RGB 182 ROI see image region of interest ROI centering 213 center...

Page 325: ...rising edge 104 trigger source 218 asynchronous 221 line N 104 software 104 software signal 104 synchronous 220 trigger width exposure mode 122 U USB 3 0 powered hub LPS 37 41 55 SELV 37 41 55 USB3 Mi...

Page 326: ...Index AW00123404000 316 Basler ace USB 3 0...

Reviews: