Basler ace acA1920-155 Скачать руководство пользователя страница 53

AW00123404000

Camera Drivers and Tools for Changing Camera Parameters  

Basler ace USB 3.0

43

3 Camera Drivers and Tools for 

Changing Camera Parameters

This chapter provides an overview of the camera drivers and the options available for changing the 
camera’s parameters. The camera requires the Basler pylon 4 Camera Software Suite or a higher 
version.

The options available with the Basler pylon 4 Camera Software Suite let you change parameters 
and control the camera by using a stand-alone GUI (known as the Basler pylon Viewer) or by 
accessing the camera from within your software application using the Basler pylon API. In addition, 
the pylon USB Configurator 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 Software Suite from our website by using this link: 

www.baslerweb.com

To help you install the software, you can also download the 

Quick Installation Guide for USB 3.0 

Cameras

 (AW001235) from the website.

3.1

The Basler pylon 4 Camera Software 
Suite

The Basler pylon 4 Camera Software Suite is available for Windows and Linux operating systems 
and is designed to operate all Basler cameras that have an IEEE 1394 interface, a GigE interface 
or a USB 3.0 interface. It will also operate some newer Basler camera models with a Camera Link 
interface. The pylon drivers offer reliable, real-time image data transport into the memory of your 
PC at a very low CPU load. 

Содержание ace acA1920-155

Страница 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...

Страница 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...

Страница 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...

Страница 4: ......

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 50: ...Specifications Requirements and Precautions AW00123404000 40 Basler ace USB 3 0...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 56: ...Camera Drivers and Tools for Changing Camera Parameters AW00123404000 46 Basler ace USB 3 0...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 106: ...Physical Interface AW00123404000 96 Basler ace USB 3 0...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 112: ...snippet also illustrates setting several parameters regarding frame triggering These parameters are discussed later in this chapter camera AcquisitionMode SetValue AcquisitionMode_SingleFrame camera...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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_...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 186: ...Image Acquisition Control AW00123404000 176 Basler ace USB 3 0...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 195: ...rameter value to Off no correction camera LightSourcePreset SetValue LightSourcePreset_Off Set the LightSourcePreset parameter value to Daylight5000K camera LightSourcePreset SetValue LightSourcePrese...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 226: ...Height ExposureTime CenterX AcquisitionFrameRate CenterY AcquisitionFrameRateEnable ReverseX TimerDelay for Timer 1 ReverseY 1 TimerDuration for Timer 1 BinningHorizontal CounterEventSource BinningVer...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 282: ...mera AutoFunctionAOISelector SetValue AutoFunctionAOISelector_AOI1 camera AutoFunctionAOIUseBrightness SetValue true Set the position and size of the auto function ROI camera AutoFunctionAOIOffsetX Se...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 289: ...mer s Guide and API Reference Event Event Parameter Name Supplementary Information Parameter Name Frame Start FrameStartEventData FrameStartEventTimestamp Frame Start Overtrigger FrameStartOvertrigger...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 326: ...Index AW00123404000 316 Basler ace USB 3 0...

Отзывы: