background image

AW00011916000

Standard Features  

Basler scout GigE

237

12.3.4 Enabling and Setting Digital Shift

You can enable or disable the digital shift feature by setting the value of the Digital Shift parameter. 
When the parameter is set to zero, digital shift will be disabled. When the parameter is set to 1, 2, 
3, or 4, digital shift will be set to shift 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 illustrates using the API to set the parameter values:

// Disable digital shift

Camera.DigitalShift.SetValue( 0 );

// Enable digital shift by 2

Camera.DigitalShift.SetValue( 2 );

For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide 
and API Reference.

You can also use the Basler pylon Viewer application to easily set the parameters.

For more information about the pylon Viewer, see Section 3.1 on 

page 43

.

Summary of Contents for scout GigE

Page 1: ...Basler scout USER S MANUAL FOR GigE VISION CAMERAS Document Number AW000119 Version 16 Language 000 English Release Date 14 December 2012...

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 bc support europe baslerweb com Americas Basler Inc 855 Springdale Drive Suite 203 Exton PA 19341 U S A Tel 1 610 280 0171 Fax 1 610 280 7608 bc support usa baslerweb com Asia Basler Asia Pte Lt...

Page 4: ......

Page 5: ...tware Licensing Information 34 1 7 Avoiding EMI and ESD Problems 35 1 8 Environmental Requirements 36 1 8 1 Temperature and Humidity 36 1 8 2 Ventilation 36 1 9 Precautions 37 2 Installation 41 3 Tool...

Page 6: ...7 7 3 Output Line Response Time 89 8 I O Control 91 8 1 Configuring Input Lines 91 8 1 1 Assigning an Input Line to Receive a Hardware Trigger Signal 91 8 1 2 Using an Unassigned Input Line to Receive...

Page 7: ...etting the Frame Start Trigger Mode and Related Parameters 121 9 5 2 Using a Software Frame Start Trigger Standard Mode 122 9 5 2 1 Introduction 122 9 5 2 2 Setting the Parameters Related to Software...

Page 8: ...ancement 175 10 1 Color Creation 175 10 1 1 Bayer Color Filter Alignment 177 10 1 2 Pixel Data Formats Available on Cameras with a Bayer Filter 178 10 2 Integrated IR Cut Filter All Color Models 180 1...

Page 9: ...1 Operation with the Always Active Sequence Control Source 252 12 5 2 2 Operation with an Input Line as Sequence Control Source 256 12 5 2 3 Operation with the Disabled Sequence Control Source 262 12...

Page 10: ...ctive Set 323 12 18 4 Selecting the Startup Set 324 12 19 Camera Feature Set 325 13 Chunk Features 327 13 1 What are Chunk Features 327 13 2 Making the Chunk Mode Active and Enabling the Extended Data...

Page 11: ...top row of the specification tables on the next pages of this manual The camera models are differentiated by their sensor size their maximum frame rate at full resolution and whether the camera s sen...

Page 12: ...able in mono or color Data Output Type Fast Ethernet 100 Mbit s or Gigabit Ethernet 1000 Mbit s Pixel Data Formats Mono Models Mono 8 DCAM Mono 8 Mono 16 DCAM Mono 16 Mono 12 Packed YUV 4 2 2 Packed D...

Page 13: ...4 mm x 29 mm without lens adapter or connectors 85 5 mm x 44 mm x 29 mm with lens adapter and connectors 90 head housing 91 65 mm x 44 mm x 29 mm without connectors and front module 97 mm x 44 mm x 41...

Page 14: ...els Mono 8 DCAM Mono 8 YUV 4 2 2 Packed DCAM YUV 4 2 2 YUV 4 2 2 YUYV Packed Mono 8 DCAM Mono 8 Mono 16 DCAM Mono 16 Mono 12 Packed YUV 4 2 2 Packed DCAM YUV 4 2 2 YUV 4 2 2 YUYV Packed Color Models M...

Page 15: ...9 mm without lens adapter or connectors 85 5 mm x 44 mm x 29 mm with lens adapter and connectors 90 head housing 91 65 mm x 44 mm x 29 mm without front module and connectors 97 mm x 44 mm x 41 8 mm wi...

Page 16: ...or color Data Output Type Fast Ethernet 100 Mbits s or Gigabit Ethernet 1000 Mbits s Pixel Data Formats Mono Models Mono 8 DCAM Mono 8 Mono 16 DCAM Mono 16 Mono 12 Packed YUV 4 2 2 Packed DCAM YUV 4 2...

Page 17: ...connectors 90 head housing 91 65 mm x 44 mm x 29 mm without connectors and front module 97 mm x 44 mm x 41 8 mm with connectors and front module Not applicable 91 65 mm x 44 mm x 29 mm without connect...

Page 18: ...or color Data Output Type Fast Ethernet 100 Mbits s or Gigabit Ethernet 1000 Mbits s Pixel Data Formats Mono Models Mono 8 DCAM Mono 8 Mono 16 DCAM Mono 16 Mono 12 Packed YUV 4 2 2 Packed DCAM YUV 4...

Page 19: ...dapter or connectors 85 5 mm x 44 mm x 29 mm with lens adapter and connectors 90 head housing 91 65 mm x 44 mm x 29 mm without connectors and front module 97 mm x 44 mm x 41 8 mm with connectors and f...

Page 20: ...bits s Pixel Data Formats Mono Models Mono 8 DCAM Mono 8 Mono 16 DCAM Mono 16 Mono 12 Packed YUV 4 2 2 Packed DCAM YUV 4 2 2 YUV 4 2 2 YUYV Packed Color Models Mono 8 DCAM Mono 8 Bayer BG 8 DCAM Raw 8...

Page 21: ...ithout lens adapter or connectors 85 5 mm x 44 mm x 29 mm with lens adapter and connectors 90 head housing 91 65 mm x 44 mm x 29 mm without connectors and front module 97 mm x 44 mm x 41 8 mm with con...

Page 22: ...sponse for Mono Cameras The following graphs show the spectral response for each available monochrome camera model Fig 1 scA640 70gm Spectral Response Spectral Response The spectral response curves ex...

Page 23: ...6000 Specifications Requirements and Precautions Basler scout GigE 13 Fig 2 scA640 74gm Spectral Response Fig 3 scA640 120gm Spectral Response Wave Length nm Relative Response Wave Length nm Relative...

Page 24: ...tions Requirements and Precautions AW00011916000 14 Basler scout GigE Fig 4 scA750 60gm Spectral Response Fig 5 scA780 54gm Spectral Response Wave Length nm Quantum Efficiency Wave Length nm Relative...

Page 25: ...Precautions Basler scout GigE 15 Fig 6 scA1000 30gm Spectral Response Fig 7 scA1300 32 gm Spectral Response Wave Length nm Relative Response 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...

Page 26: ...uirements and Precautions AW00011916000 16 Basler scout GigE Fig 8 scA1390 17gm Spectral Response Fig 9 scA1400 17gm and scA1400 30gm Spectral Response Wave Length nm Relative Response Wave Length nm...

Page 27: ...AW00011916000 Specifications Requirements and Precautions Basler scout GigE 17 Fig 10 scA1600 14gm and scA1600 28 gm Spectral Response Wave Length nm Relative Response...

Page 28: ...ight source characteristics 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...

Page 29: ...ons Requirements and Precautions Basler scout GigE 19 Fig 12 scA640 74gc Spectral Response Fig 13 scA640 120gc Spectral Response Wave Length nm Relative Response Blue Green Red Wave Length nm Relative...

Page 30: ...d Precautions AW00011916000 20 Basler scout GigE Fig 14 scA750 60gc Spectral Response Fig 15 scA780 54gc Spectral Response Wave Length nm Quantum Efficiency Blue Green B Green R Red Wave Length nm Rel...

Page 31: ...ler scout GigE 21 Fig 16 scA1000 30gc Spectral Response Fig 17 scA1300 32gc Spectral Response Wave Length nm Relative Response Blue Green Red 1 0 0 9 0 8 0 7 0 6 0 5 0 4 0 3 0 2 0 1 0 0 400 450 500 55...

Page 32: ...ecautions AW00011916000 22 Basler scout GigE Fig 18 scA1390 17gc Spectral Response Fig 19 scA1400 17gc and scA1400 30gc Spectral Response Wave Length nm Relative Response Blue Green Red Wave Length nm...

Page 33: ...AW00011916000 Specifications Requirements and Precautions Basler scout GigE 23 Fig 20 scA1600 14gc and scA1600 28gc Spectral Response Wave Length nm Relative Response Blue Green Red...

Page 34: ...by the cap that is shipped with the camera 1 5 1 1 Camera Dimensions and Mounting Points The cameras are manufactured with high precision Planar parallel and angular sides guarantee precise mounting w...

Page 35: ...the top and four mounting holes on the bottom as shown in the drawings Fig 21 Mechanical Dimensions in mm for Cameras with the Standard C mount Lens Adapter Bottom 67 2 2x M3 4 deep 9 7 2x M3 4 5 dee...

Page 36: ...out GigE Fig 22 Mechanical Dimensions in mm for Cameras with an Optional CS mount Lens Adapter Top Photosensitive surface of the sensor 12 5 67 2 2x M3 3 5 deep 2x M3 4 5 deep 4 7 Bottom 67 2 2x M3 4...

Page 37: ...ery point on the photosensitive surface and is relative to the center of the die 17 5 0 0 06 This tolerance is for the distance between the front of the lens mount and the sensor s photosensitive surf...

Page 38: ...for the distance between the front of the lens mount and the sensor s photosensitive surface Note that this tolerance and the sensor tilt tolerance see above must be combined to obtain the total tole...

Page 39: ...ras are manufactured with high precision Planar parallel and angular sides guarantee precise mounting with high repeatability The dimensions in millimeters for cameras equipped with a standard C mount...

Page 40: ...in mm for Cameras 90 Head with the Standard C mount Lens Adapter 32 1 2 x M3 4 5 deep 2 x M3 4 deep 3 25 51 15 3 75 2 x M3 4 8 deep 32 1 15 6 3 1 ca 15 4 2 x M3 4 5 deep 97 91 65 Photosensitive surfa...

Page 41: ...ter of the die 2 1 0 02 17 5 0 0 06 tolerance to the center of the lens mount optical axis tolerance to the reference planes reference plane front module reference plane This tolerance is for the dist...

Page 42: ...ger thread length is used the IR cut filter will be damaged or destroyed and the camera will no longer operate Fig 27 Maximum Lens Thread Length on Color Cameras An internal IR cut filter is not inclu...

Page 43: ...anical stress tests were performed with a dummy lens connected to a C mount The dummy lens was 35 mm long and had a mass of 66 g Using a heavier or longer lens requires an additional support for the l...

Page 44: ...g disclaimer in the documentation and or other materials provided with the distribution 3 The name of the author may not be used to endorse or promote products derived from this software without speci...

Page 45: ...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 cabl...

Page 46: ...peration 20 80 relative non condensing Storage temperature 20 C 80 C 4 F 176 F Storage humidity 20 80 relative non condensing 1 8 2 Ventilation Allow sufficient air circulation around the camera to pr...

Page 47: ...Color models of the camera with a C mount lens adapter are equipped with an IR cut filter mounted inside of the adapter The location of this filter limits the length of the threads on any lens you us...

Page 48: ...pets will work properly in your application you must adjust them to meet your specific needs and must test them thoroughly prior to use The code snippets in this manual are written in C Other programm...

Page 49: ...erate the camera in the vicinity of strong electromagnetic fields Avoid electrostatic charging Transport Properly Transport the camera in its original packaging only Do not discard the packaging Clean...

Page 50: ...Specifications Requirements and Precautions AW00011916000 40 Basler scout GigE...

Page 51: ...sses a camera description file included in the camera to make the camera features available for use The following camera description files are available and are used alternatively The Full camera desc...

Page 52: ...Installation AW00011916000 42 Basler scout GigE...

Page 53: ...on Viewer is included in Basler s pylon Driver Package You can obtain the pylon package from the Downloads section of our website www baslerweb com For more information about using the viewer see the...

Page 54: ...rence are included in the pylon SDK The Basler pylon Software Development Kit SDK includes a set of sample programs that illustrate how to use the pylon API to parameterize and operate the camera Thes...

Page 55: ...river is a hardware specific GigE Vision network driver The driver is only compatible with network adapters that use specific Intel chipsets The advantage of the performance driver is that it signific...

Page 56: ...t parameter defines how long in milliseconds the filter driver will wait for the next expected packet before it initiates a resend request Ensure the Packet Timeout parameter is set to a longer time i...

Page 57: ...r default values The performance driver s parameter values determine how the resend mechanisms act and how they relate to each other You can set the parameter values by using the pylon Viewer or from...

Page 58: ...e following assumptions are made Packets 997 998 and 999 are missing from the stream of packets Packet 1002 is missing from the stream of packets 1 Front end of the receive window Missing packets are...

Page 59: ...termines the location of the resend request batching threshold in the receive window Figure 28 The parameter value is in per cent of a span that starts with the resend request threshold and ends with...

Page 60: ...the camera The camera does not respond with a resend 6 Interval defined by the Resend Response Timeout parameter 7 The Resend Response Timeout interval expires and a second resend request for packet 1...

Page 61: ...request as lost If a resend request for a missing packet is considered lost and if the maximum number of resend requests as set by the Maximum Number Resend Requests parameter has not yet been reache...

Page 62: ...to the Resend Timeout parameter will not occur see Figure 30 In addition resend request batching will not occur 1 Stream of packets Gray indicates that the status was checked as the packet entered the...

Page 63: ...the PacketTimeout parameter StreamGrabber PacketTimeout SetValue 40 Write the ResendRequestThreshold parameter StreamGrabber ResendRequestThreshold SetValue 5 Write the ResendRequestBatching paramete...

Page 64: ...ill override the default address provided by the adapter Packet Buffer Size Sets the size in bytes of the buffers used by the receive descriptors and the transmit descriptors Receive Descriptors Sets...

Page 65: ...ication software by using the Basler pylon API The following code snippet illustrates using the API to read and write the parameter values Read Write Timeout Camera_t TlParams_t TlParams Camera GetTLN...

Page 66: ...Basler Network Drivers and Parameters AW00011916000 56 Basler scout GigE...

Page 67: ...are not included Stream Channel Selector read write The GigE Vision standard specifies a mechanism for establishing several separate stream channels between the camera and the PC This parameter select...

Page 68: ...them you may find that your network switch or network adapter is overwhelmed if all of the cameras simultaneously begin to transmit image data at once The frame transmission delay parameter can be use...

Page 69: ...d in the accumulator pool For example assume that the current bandwidth reserve setting for your camera is 5 and that this reserve is large enough to allow up to 5 packet resends during a frame period...

Page 70: ...ngs the pool to 14 4 You trigger image acquisition and during this time period the camera acquires and transmits a frame The bandwidth reserve setting would allow 5 resends during this time period but...

Page 71: ...ting would allow 5 resends during this time period and 1 resend is needed The 1 resend needed is taken from the resends available via the bandwidth reserve The other 4 resends available via the bandwi...

Page 72: ...d such as leaders and trailers Resulting Frame Rate read only Indicates the maximum allowed frame acquisition rate in frames per second given the current camera settings The parameter takes the curren...

Page 73: ...t jitterMax Camera GevSCFJM GetValue Device Max Throughput int64_t maxThroughput Camera GevSCDMT GetValue Device Current Throughput int64_t currentThroughput Camera GevSCDCT GetValue Resulting Framera...

Page 74: ...have no problem with bandwidth in this case If you want to acquire and transmit images from several cameras simultaneously however you must determine the total data output rate for all the cameras th...

Page 75: ...s the bandwidth needed To make sure that the total bandwidth assigned to all cameras does not exceed the network s bandwidth capacity To make adjustments if the bandwidth capacity is exceeded Step 1 I...

Page 76: ...he maximum packet size Next check the documentation for your network switch and determine the maximum packet size that it can handle If there are any settings available for the switch make sure that t...

Page 77: ...e camera is acquiring each second For each camera you can use the two formulas below to calculate the data bandwidth needed To use the formulas you will need to know the current value of the Payload S...

Page 78: ...e setting for the Inter packet delay parameter for the camera 2 Recalculate the data bandwidth assigned to the camera 3 Compare the new data bandwidth assigned to the data bandwidth needed 4 Repeat 1...

Page 79: ...he data bandwidth needed by a camera either by lowering its frame rate or by decreasing the size of the area of interest AOI Once you have adjusted the frame rates and or AOI settings on the cameras y...

Page 80: ...Network Related Camera Parameters and Managing Bandwidth AW00011916000 70 Basler scout GigE...

Page 81: ...ed period of time Accumulated charges are read out of the sensor when exposure ends At readout accumulated charges are transported from the sensor s light sensitive elements pixels to the vertical shi...

Page 82: ...transmission rate between the camera and the host computer This ensures that the data transmission rate has no influence on image quality Fig 32 CCD Sensor Architecture Fig 33 Camera Block Diagram CC...

Page 83: ...ion they are converted to voltages proportional to the size of each charge The voltages from the analog processing section are next passed to a bank of Analog to Digital converters ADCs Finally the vo...

Page 84: ...gram CMOS Sensor Pixel Array Digitized Pixel Data ADCs Analog Processing Digital Processing FPGA Ethernet Controller 24 MB Image Buffer Image Data Image Data I O ExTrig e g ExpActive TrigRdy Micro Con...

Page 85: ...s interfaced to external circuity via connectors located on the back of the housing An 8 pin RJ 45 jack used to provide a 100 1000 Mbit s Ethernet connection to the camera This jack includes a green L...

Page 86: ...5 I O Input Gnd 6 I O Output 1 7 I O Output 2 8 Camera Power VCC 9 Camera Power VCC 10 I O Output VCC 11 I O Output 3 12 I O Output 4 Table 7 Pin Assignments for the 12 pin Receptacle Pins 1 and 2 are...

Page 87: ...t GigE 77 7 2 2 RJ 45 Jack Pin Assignments The 8 pin RJ 45 jack provides Ethernet access to the camera Pin assignments adhere to the Ethernet standard 7 2 3 Pin Numbering Fig 37 Pin Numbering for the...

Page 88: ...e Intercon 1 division of Nortech Systems Inc To ensure that you order cables with the correct connectors note the vertical orientation of the screws before ordering Green and Yellow LEDs This RJ 45 ja...

Page 89: ...rd power and I O cable that connects to the camera must be terminated with a Hirose micro plug part number HR10A 10P 12S or the equivalent The cable must be wired to conform with the pin assignments s...

Page 90: ...a smaller plug such as one with 10 pins or 8 pins can damage the pins in the camera s 12 pin connector CAUTION To avoid a voltage drop with long power wires we recommend that you supply camera power V...

Page 91: ...d reverse polarity Close proximity to strong magnetic fields should be avoided Basler offers PLC power and I O cables with 3 m and 10 m lengths Each cable is terminated with a 12 pin Hirose plug HR10A...

Page 92: ...on page 79 Voltage Outside of Specified Range Can Cause Damage The recommended operating voltage of the power to the camera is 12 VDC 5 to 24 VDC 5 If the voltage is less than 11 3 VDC the camera may...

Page 93: ...AW00011916000 Physical Interface Basler scout GigE 83 7 6 Ethernet GigE Device Information The camera uses a standard Ethernet GigE transceiver The transceiver is fully 100 1000 Base T 802 3 compliant...

Page 94: ...tacle Different voltage levels apply depending on whether the standard power and I O cable or a PLC power and I O cable is used see below Voltage Significance 0 to 24 VDC Recommended operating voltage...

Page 95: ...djust the voltages to the levels required at the camera s I O input see Table 7 Voltage Significance 0 to 24 VDC Recommended operating voltage 0 to 8 4 VDC The voltage indicates a logical 0 8 4 to 10...

Page 96: ...o input a signal into the camera By default Input Line 1 is assigned to receive an external hardware trigger ExTrig signal that can be used to control the start of image acquisition Fig 39 Typical Vol...

Page 97: ...ugh an output circuit is 50 mA A conducting transistor means a logical one and a non conducting transistor means a logical zero Figure 40 shows a schematic circuit you can use to monitor an output lin...

Page 98: ...signals to physical output lines can be changed by the user For more information about output line pin assignments and pin numbering see Section 7 2 on page 76 For more information about the exposure...

Page 99: ...signal until the voltage has dropped to 10 of its original level As an example ton90 and toff10 were measured for a specific camera for load currents of 5 mA and 50 mA and voltages between 3 3 V and 2...

Page 100: ...e Some general tendencies can be seen from the figure toff10 increases as the voltage increases and as the load current decreases ton90 increases as the voltage and the load current increase The effec...

Page 101: ...Trig signals can then be used to control image acquisition Section 9 4 5 2 on page 117 Section 9 5 3 4 on page 127 and Section 9 6 3 4 on page 139 explain how to configure the camera to react to a har...

Page 102: ...r not to invert the incoming electrical signal To set the invert function on an input line Use the Line Selector to select an input line Set the value of the Line Inverter parameter to true to enable...

Page 103: ...ine 4 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 selected line You can set the Line Selector and the...

Page 104: ...to true high or false low This will set the state of the selected line You can set the Output Selector and the User Output Value parameter from within your application software by using the pylon API...

Page 105: ...parameter to true to enable inversion on the selected line and to false to disable inversion You can set the Line Selector and the Line Inverter parameter value from within your application software...

Page 106: ...only be assigned to output line 3 Timer 4 can only be assigned to output line 4 If you require the timer signal to be high when the timer is triggered and to go low when the delay expires simply set t...

Page 107: ...for a timer by setting raw values or by setting an absolute value You can use whichever method you prefer to set the delay time Setting the Delay with Raw Values When the delay time for a timer is set...

Page 108: ...er The units for setting this parameter are s and the value can be set in increments of 1 s To set the delay for a timer using an absolute value Use the Timer Selector to select a timer Set the value...

Page 109: ...ll be 100 x 1 s or 100 s To set the duration for a timer Use the Timer Selector to select a timer Set the value of the Timer Duration Raw parameter You can set the Timer Selector and the Timer Duratio...

Page 110: ...Camera TimerDurationAbs SetValue 100 When you use the Timer Duration Abs parameter to set the duration time the camera accomplishes the setting change by automatically changing the Timer Duration Raw...

Page 111: ...etValue LineSelector_Out2 bool outputLine2State Camera LineStatus GetValue For detailed information about using the pylon API refer to the Basler pylon Programmer s Guide and API Reference You can als...

Page 112: ...If a bit is 1 it indicates that the state of the associated line is currently high Indicates output line 1 state Indicates output line 2 state Indicates output line 3 state Indicates output line 4 sta...

Page 113: ...tion start trigger of the standard mode is not available in the legacy mode the frame start trigger of the standard mode is called acquisition start trigger in the legacy mode Recommendations for choo...

Page 114: ...ion TriggerControlImplementation_Standard Camera TriggerControlImplementation TriggerControlImplementation_Legacy For detailed information about using the pylon API refer to the Basler pylon Programme...

Page 115: ...ean a single acquired image When reading the material in this section it is helpful to refer to Figure 46 on page 107 and to the use case diagrams in Section 9 8 on page 144 These diagrams present the...

Page 116: ...ting for acquisition start trigger see Figure 46 on page 107 When the camera is in this acquisition status it cannot react to frame start trigger signals When an acquisition start trigger signal is ap...

Page 117: ...et to on you must trigger frame start by applying frame start trigger signals to the camera Each time a trigger signal is applied the camera will begin a frame exposure When frame start is being trigg...

Page 118: ...ameter that is used to set the mode for both of these triggers Also the Trigger Software command mentioned earlier can be executed for either the acquisition start trigger or the frame start trigger S...

Page 119: ...nother frame you must execute a new Acquisition Start command If the camera s Acquisition Mode parameter is set for continuous frame after an Acquisition Start command has been executed frame acquisit...

Page 120: ...le acquisition frame rate for a given AOI cannot be achieved This is true because the camera performs a complete internal setup cycle for each single frame and because it cannot be operated with overl...

Page 121: ...ion status the camera can react to frame start trigger signals and will begin to expose a frame each time a proper frame start trigger signal is applied A primary feature of the acquisition start trig...

Page 122: ...ion Frame Count parameter setting The camera will then return to the waiting for acquisition start trigger acquisition status In order to acquire more frames you must apply a new acquisition start tri...

Page 123: ...n react to frame start trigger signals When the camera has received a number of frame start trigger signals equal to the current Acquisition Frame Count parameter setting it will return to the waiting...

Page 124: ...r Camera TriggerSource SetValue TriggerSource_Software Set the acquisition frame count Camera AcquisitionFrameCount SetValue 5 The following code snippet illustrates using the API to set the Trigger M...

Page 125: ...hen a new software acquisition start trigger signal is applied to the camera it will again exit from the waiting for acquisition start trigger acquisition status and enter the waiting for frame start...

Page 126: ...gnal for the camera This type of trigger signal is generally referred to as a hardware trigger signal or as an external acquisition start trigger signal ExASTrig A rising edge or a falling edge of the...

Page 127: ...ition start triggering is on Camera AcquisitionMode SetValue AcquisitionMode_Continuous Select the acquisition start trigger Camera TriggerSelector SetValue TriggerSelector_AcquisitionStart Set the mo...

Page 128: ...the camera if the Trigger Mode parameter for the acquisition start trigger is set to on For more information about the Acquisition Mode parameter and about Acquisition Start and Acquisition Stop comm...

Page 129: ...it receives an Acquisition Start command The camera will continue to generate frame start trigger signals until it receives an Acquisition Stop command The rate at which the frame start trigger signal...

Page 130: ...ne 1 When the source signal is set to line 1 you apply a frame start trigger signal to the camera by injecting an externally generated electrical signal commonly referred to as a hardware trigger sign...

Page 131: ...n software by using the Basler 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 f...

Page 132: ...e start trigger signal As soon as the camera is capable of reacting to a new frame start trigger signal it will automatically return to the waiting for frame start trigger acquisition status When you...

Page 133: ...AcquisitionMode SetValue AcquisitionMode_Continuous Select the acquisition start trigger Camera TriggerSelector SetValue TriggerSelector_AcquisitionStart Set the mode for the selected trigger Camera...

Page 134: ...alling edge of the ExFSTrig signal can be used to trigger frame acquisition The Trigger Activation parameter is used to select rising edge or falling edge triggering Assuming that the camera is in a w...

Page 135: ...camera is set for falling edge triggering the exposure time starts when the ExFSTrig signal falls The following figure illustrates timed exposure with the camera set for rising edge triggering Fig 48...

Page 136: ...useful if you intend to vary the length of the exposure time for each captured frame Fig 50 Trigger Width Exposure with Rising Edge Triggering When you operate the camera in trigger width exposure mo...

Page 137: ...delay Set the acquisition mode to single frame Camera AcquisitionMode SetValue AcquisitionMode_SingleFrame Select the acquisition start trigger Camera TriggerSelector SetValue TriggerSelector_Acquisi...

Page 138: ...internal frame rate control and allow you to control the frame rate with external frame start trigger signals Camera AcquisitionFrameRateEnable SetValue false Select the frame start trigger Camera Tr...

Page 139: ...5 and Section 9 3 on page 109 Referring to the use case diagrams that appear in Section 9 8 on page 144 can help you understand the explanations of the acquistion start trigger Remember however that t...

Page 140: ...rate at which the acquisition start trigger signals are generated will be determined by the camera s Acquisition Frame Rate Abs parameter If the parameter is not enabled the camera will generate acqui...

Page 141: ...ct as the acquisition start trigger For more information about using a software trigger to control frame acquisition start see Section 9 4 4 on page 115 For more information about using a hardware tri...

Page 142: ...on Frame Rate to 60 Set the acquisition mode to continuous frame Camera AcquisitionMode SetValue AcquisitionMode_Continuous Select the frame start trigger Camera TriggerSelector SetValue TriggerSelect...

Page 143: ...ch 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 camera s exposure time parameters Fig 51 Frame Acquis...

Page 144: ...he frame start trigger Camera TriggerSelector SetValue TriggerSelector_AcquisitionStart Set the mode for the selected trigger Camera TriggerMode SetValue TriggerMode_On Set the source for the selected...

Page 145: ...t trigger signal As soon as the camera is capable of reacting to a new acquisition start trigger signal it will automatically return to the waiting for acquisition start trigger acquisition status Whe...

Page 146: ...ering the exposure time starts when the ExASTrig signal rises If the camera is set for falling edge triggering the exposure time starts when the ExASTrig signal falls The following figure illustrates...

Page 147: ...the exposure setting to represent the shortest exposure time you intend to use For example assume that you will be using trigger width exposure and that you intend to use the ExASTrig signal to vary t...

Page 148: ...eMode_TriggerWidth Camera ExposureTimeAbs SetValue 3000 For detailed information about using the pylon API refer to the Basler pylon Programmer s Guide and API Reference You can also use the Basler py...

Page 149: ...1000us 1ms 0 001s double TriggerDelay_us 1000 0 Camera TriggerDelayAbs SetValue TriggerDelay_us Set for the timed exposure mode Camera ExposureMode SetValue ExposureMode_Timed Set the exposure time C...

Page 150: ...TriggerWidth Prepare for frame acquisition here Camera AcquisitionStart Execute while finished Frame acquisition will start each time the externally generated acquisition start trigger signal ExASTrig...

Page 151: ...000000 s scA750 60gm gc 124 s 126976 s scA780 54gm gc 26 s 10000000 s scA1000 30gm gc 32 s 10000000 s scA1300 32gm gc 22 s 10000000 s scA1390 17gm gc 34 s 10000000 s scA1400 17gm gc 38 s 10000000 s sc...

Page 152: ...osure Time Base Abs value to 10000000 s On scA750 60 cameras you can obtain the maximum possible exposure time 126976 s by e g setting the exposure time raw parameter value to 2048 and the Exposure Ti...

Page 153: ...the Exposure Time Raw parameter with the current Exposure Time Base parameter For example if the time base was currently set to 62 s you could use the Exposure Time Base Abs parameter to set the expos...

Page 154: ...case diagram the black box in the upper left corner indicates how the parameters are set This section assumes that the standard mode is enabled for image acquisition control In principle this section...

Page 155: ...free run The rate at which the camera will acquire images will be determined by the camera s Acquisition Frame Rate Abs parameter unless the current camera settings result in a lower frame rate If th...

Page 156: ...rigger 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 acquisition start trigger Off Trigger...

Page 157: ...rigger signal source to input 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 Th...

Page 158: ...nput line 1 to start each frame exposure Settings Acquisition Mode Continuous Trigger Mode for the acquisition start trigger Off Trigger Mode for the frame start trigger On Trigger Source for the fram...

Page 159: ...ly determined by the camera s Acquisition Frame Rate Abs parameter If the Acquisition Frame Rate Abs parameter is disabled the camera will acquire frames at the maximum allowed frame rate This type of...

Page 160: ...e 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 acqu...

Page 161: ...ra 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 past...

Page 162: ...ut line 1 The user must apply a frame start trigger signal to input line 1 to start each frame exposure Settings Acquisition Mode Continuous Trigger Mode for the acquisition start trigger On Trigger S...

Page 163: ...n is illustrated in Figure 60 Fig 60 Non overlapped Exposure While operating in a non overlapped fashion is perfectly normal and is appropriate for many situations it is not the most efficient way to...

Page 164: ...not begin the exposure time for a new image acquisition while the exposure time of the previous acquisition is in progress You must not end the exposure time of the current image acquisition until rea...

Page 165: ...g 62 Non overlapped Readout and Exposure A result of this characteristic is that the exposure time setting on the camera will have a direct effect on the camera s maximum allowed frame rate At longer...

Page 166: ...hysical output line 1 on the camera However the assignment of the ExpAc signal to a physical output line can be changed Selecting the Exposure Active Signal as the Source Signal for an Output Line The...

Page 167: ...t is especially important that the exposure time of a new image acquisition not start until exposure of the previously acquired image is complete and the exposure time of a new image acquisition not e...

Page 168: ...the trigger ready will go high at the rate specified by the parameter value For example if the parameter is set to 10 the trigger ready signal will go high 10 times per second If the value of the para...

Page 169: ...ut the standard and legacy image acquisition control modes see Section 9 1 on page 103 9 11 4 Trigger Ready Signal scA750 60 Only As described in an earlier section on these cameras the exposure for a...

Page 170: ...cond If the value of the parameter is greater than the maximum allowed acquisition frame rate with the current camera settings the trigger ready signal will work as described above and will go high at...

Page 171: ...hin 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_O...

Page 172: ...the ExASTrig signal on the state of the acquisition trigger wait signal you can avoid acquisition start overtriggering i e applying an acquisition start trigger signal to the camera when it is not in...

Page 173: ...art triggering is enabled Time Camera is in a waiting for acquisition start trigger status Acq Trigger Wait Signal Frame Acquisition Exp Readout Frame Acquisition Exp Readout Frame Acquisition Exp Rea...

Page 174: ...ue 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 Lin...

Page 175: ...determined that it can safely do so without over running or under running the buffer This buffering technique is also an important element in achieving the highest possible frame rate with the best i...

Page 176: ...era models except the scA750 60 or from the table in Section 9 14 on page 171 for scA750 60 cameras For more information about the AOI height see Section 12 4 on page 238 You can calculate an approxim...

Page 177: ...mes If you use very long exposure times you can acquire fewer frames per second The amount of time that it takes to transmit an acquired frame from the camera to your host PC The amount of time needed...

Page 178: ...the most restrictive factor on the frame rate In this case you should lower your exposure time You may need to compensate for a lower exposure time by using a brighter light source or increasing the o...

Page 179: ...54 s scA640 74gm gc 22 66 s 1433 66 s scA1400 17gm gc 46 53 s 9357 50 s scA640 120gm gc 14 16 s 1128 80 s scA1400 30gm gc 25 80 s 6418 04 s scA780 54gm gc 26 94 s 2308 54 s scA1600 14gm gc 50 99 s 665...

Page 180: ...nd the Payload Size parameters and found them to be 110000000 and 240000 respectively Formula 1 Max Frames s 84 4 frames s Formula 2 Max Frames s 477 3 frames s Formula 3 Max Frames s 458 3 frames s F...

Page 181: ...e camera to your host PC The amount of time needed to transmit a frame depends on the bandwidth assigned to the camera To determine the maximum allowed acquisition frame rate with your current camera...

Page 182: ...ot normally be a restricting factor But if you are using multiple cameras and you have set a small packet size or a large inter packet delay you may find that the transmission time is restricting the...

Page 183: ...t parameter and the Payload Size parameters and found them to be 110000000 and 240000 respectively Formula 1 Max Frames s 68 4 frames s Formula 2 Max Frames s 458 3 frames s Formula one returns the lo...

Page 184: ...Image Acquisition Control AW00011916000 174 Basler scout GigE...

Page 185: ...eras are related to the Bayer pattern so you need a basic knowledge of the Bayer filter to understand the pixel formats With the Bayer filter each individual pixel is covered by a micro lens that allo...

Page 186: ...R G G B R G G B R G G B R G G B R G G B R G G B R G G B R G G B R G G B R G G B R G G B R G G B R G G B R G G B R G G B R G G B R G G B R G G B R G G B R G G B R G G B R G G B R G G B R G G B R G G B...

Page 187: ...he second line transmitted pixel one and pixel two will be green and blue respectively Since the pattern of the Bayer filter is fixed you can use this information to determine the color of all of the...

Page 188: ...to get RGB data for each pixel This is required because color cameras with a Bayer filter on the sensor gather only one color of light for each individual pixel Once the demosaicing is complete 8 bits...

Page 189: ...and converted to the YUV color model as described above The camera then transmits the 8 bit Y value for each pixel to the host PC In the YUV color model the Y component for each pixel represents a bri...

Page 190: ...equest Monochrome cameras do not include an IR cut filter in the lens adapter Monochrome cameras with a C mount lens adapter can be equipped with a filter on request For more information about the loc...

Page 191: ...e ratio for a color to a value lower than 1 this will not only decrease the intensity of that color relative to the other two colors but will also decrease the maximum intensity that the color can ach...

Page 192: ...formation about the pylon API and the pylon Viewer see Section 3 on page 43 White Balance Reset The camera includes a White Balance Reset command that can be used to reset the white balance adjustment...

Page 193: ...ing formula The formula uses uncorrected and corrected pixel brightnesses that are normalized by the maximum pixel brightness The maximum pixel brightness equals 255 for 8 bit output and 4095 for 12 b...

Page 194: ...GammaEnable SetValue true Set the gamma type to sRGB Camera GammaSelector SetValue GammaSelector_sRGB The following code snippet illustrates using the API to set the parameter values for user type co...

Page 195: ...e Bayer pixel data output formats and the Processed Raw Enable parameter is not set to enabled the matrix color transformation feature and the color adjustment feature will have no effect on camera op...

Page 196: ...ed by someone who is thoroughly familiar with matrix color transformations Instructions for using the custom setting appear in the next section The third parameter associated with matrix color transfo...

Page 197: ...t the matrix correction factor Camera ColorTransformationMatrixFactor SetValue 0 50 You can also use the Basler pylon Viewer application to easily set the parameters For more information about the pyl...

Page 198: ...stom Matrix Values You can set the Color Transformation Value Selector Color Transformation Value and Color Transformation Value Raw parameters from within your application software by using the Basle...

Page 199: ...en the three primary colors are mixed at maximum intensities white will result In the absence of light black will result The color space can be represented as a color cube see Figure 69 on page 190 wh...

Page 200: ...y color of the RGB color space will lie within the color hexagon The color will be characterized by its hue and saturation Hue specifies the kind of coloration for example whether the color is red yel...

Page 201: ...s For example when red is rotated in negative direction towards yellow then for example purple in the image can be changed to red and red in the image can be changed to orange Red can be rotated as fa...

Page 202: ...range from 4 0 to 3 96875 As an alternative you can use the Color Adjustment Hue Raw parameter to set the hue as an integer value on a scale ranging from 128 to 127 This integer range maps linearly to...

Page 203: ...r application to easily set the parameters For more information about the pylon API and the pylon Viewer see Section 3 on page 43 Color Adjustment Reset The camera includes a Color Adjustment Reset co...

Page 204: ...uto feature 6 Set the gamma value You should set the value to match the gamma on the monitor you are using to view acquired images When gamma is set correctly there should be a smooth transition from...

Page 205: ...a operation you must select the color factory setup as the default camera configuration set and then you must load the default configuration set into the camera s active configuration set When you do...

Page 206: ...Color Creation and Enhancement AW00011916000 196 Basler scout GigE...

Page 207: ...pixel data that will be output from the camera The available pixel formats depend on the camera model and whether the camera is monochrome or color Table 15 lists the pixel formats available on each m...

Page 208: ...rBG8 Camera PixelFormat SetValue PixelFormat_BayerBG16 Camera PixelFormat SetValue PixelFormat_RGB8Packed For detailed information about using the pylon API refer to the Basler pylon Programmer s Guid...

Page 209: ...last pixel transmitted by the camera B0 the first byte in the buffer Bm the last byte in the buffer With the camera set for Mono8 the pixel data output is 8 bit data of the unsigned char type The avai...

Page 210: ...ted by the camera Pn the last pixel transmitted by the camera B0 the first byte in the buffer Bm the last byte in the buffer Byte Data B0 Low byte of brightness value for P0 B1 High byte of brightness...

Page 211: ...16 bit data you might expect a value range from 0x0000 to 0xFFFF However with the camera set for Mono16 only 12 bits of the 16 bits transmitted are effective Therefore the highest data value you will...

Page 212: ...for Mono 12 Packed output The following standards are used in the table P0 the first pixel transmitted by the camera Pn the last pixel transmitted by the camera B0 the first byte in the buffer Bm the...

Page 213: ...Mono 12 Packed the pixel data output is 12 bit data of the unsigned type The available range of data values and the corresponding indicated signal levels are as shown in the table below This Data Valu...

Page 214: ...output from a color camera For more information about the YUV 4 2 2 Packed format on color cameras see Section 11 3 6 on page 214 11 2 5 YUV 4 2 2 YUYV Packed Format When a monochrome camera is set fo...

Page 215: ...ll be green etc For odd rows in the images pixel one will be green pixel two will be red pixel three will be green pixel four will be red etc For more information about the Bayer filter see Section 11...

Page 216: ...ta values and the corresponding indicated signal levels are as shown in the table below Bm 3 Blue value for Pn 3 Bm 3 Green value for Pn 3 Bm 2 Green value for Pn 2 Bm 2 Red value for Pn 2 Bm 1 Blue v...

Page 217: ...ur will be blue etc For more information about the Bayer filter see Section 11 3 1 on page 205 The tables below describe how the data for the even lines and for the odd lines of a received frame will...

Page 218: ...ayer RG8 the pixel data output is 8 bit data of the unsigned char type The available range of data values and the corresponding indicated signal levels are as shown in the table below This Data Value...

Page 219: ...ill be red etc For more information about the Bayer filter see Section 11 3 1 on page 205 The tables below describe how the data for the even lines and for the odd lines of a received frame will be or...

Page 220: ...ating a signal level of 4095 Bm 5 Low byte of green value for Pn 2 Bm 5 Low byte of red value for Pn 2 Bm 4 High byte of green value for Pn 2 Bm 4 High byte of red value for Pn 2 Bm 3 Low byte of blue...

Page 221: ...en rows and for the odd rows of a received frame will be ordered in the image buffer in your PC when the camera is set for Bayer BG12 Packed output The following standards are used in the tables P0 th...

Page 222: ...11 4 B3 Green value for P2 bits 11 4 B4 Red value for P3 bits 3 0 Green value for P2 bits 3 0 B5 Red value for P3 bits 11 4 B6 Green value for P4 bits 11 4 B7 Red value for P5 bits 3 0 Green value for...

Page 223: ...The table below describes how the pixel data for a received frame will be ordered in the image buffer in your PC when the camera is set for RGB 8 Packed output The following standards are used in the...

Page 224: ...model The conversion algorithm uses the following formulas Y 0 30 R 0 59 G 0 11 B U 0 17 R 0 33 G 0 50 B V 0 50 R 0 41 G 0 09 B Once the conversion to a YUV color model is complete the pixel data is...

Page 225: ...it data of the straight binary type The range of data values for a U or a V component and the corresponding indicated signal levels are shown below B4 U value for P2 B5 Y value for P2 B6 V Value for P...

Page 226: ...a U component or a V component can range from 128 to 127 decimal Notice that the data values have been arranged to represent the full signal level range This Data Value Hexadecimal Indicates This Sig...

Page 227: ...ame will be ordered in the image buffer in your PC when the camera is set for YUV 4 2 2 YUYV output With this format the Y component is transmitted for each pixel but the U and V components are only t...

Page 228: ...ponent is 8 bit data of the straight binary type The range of data values for a U or a V component and the corresponding indicated signal levels are shown below The signal level of a U component or a...

Page 229: ...in a monochrome camera So in essence when a color camera is set for Mono 8 it outputs an 8 bit monochrome image This type of output is sometimes referred to as Y Mono 8 The table below describes how...

Page 230: ...Mono 8 the pixel data output is 8 bit data of the unsigned char type The available range of data values and the corresponding indicated signal levels are as shown in the table below This Data Value H...

Page 231: ...to the bottom of the sensor The sequence assumes that the camera is set for full resolution Row 0 Col 0 Row 0 Col 1 Row 0 Col 2 Row 0 Col m 2 Row 0 Col m 1 Row 0 Col m Row 1 Col 0 Row 1 Col 1 Row 1 Co...

Page 232: ...Pixel Data Formats AW00011916000 222 Basler scout GigE...

Page 233: ...era for a given amount of output from the imaging sensor Decreasing the gain decreases the slope of the response curve and results in a lower gray value for a given amount of sensor output Increasing...

Page 234: ...A750 60 gm gc For information about scA750 60 gm gc cameras see the next section Gain can not only be manually set see below but can also be automatically adjusted The Gain Auto function is the automa...

Page 235: ...set the parameters For more information about the pylon Viewer see Section 3 1 on page 43 If you know the current decimal setting for the gain raw you can use the formulas below to calculate the dB of...

Page 236: ...ing with a monochrome scA1400 30 camera that has a gain raw setting of 500 Calculating the gain is a two step process Step 1 Step 2 Table 18 shows the minimum and maximum gain in dB for each camera mo...

Page 237: ...h dB Gain at Max Setting 16 bit depth scA640 70 0 27 8 8 scA640 74 0 28 3 10 1 scA640 120 0 23 34 8 98 scA780 54 0 25 9 7 7 scA1000 30 0 25 5 7 3 scA1300 32 0 19 75 3 59 scA1390 17 0 25 5 7 3 scA1400...

Page 238: ...aw SetValue 20 For detailed information about using the pylon API refer to the Basler pylon Programmer s Guide and API Reference You can also use the Basler pylon Viewer application to easily set the...

Page 239: ...at setting Example Assume that you are working with an scA750 60 camera that has a gain raw setting of 18 The gain is calculated as follows Table 19 shows the dB of gain that will be achieved at vario...

Page 240: ...tive offset of 1 in the digital values output for the pixels A decrease of 1 in the setting will result in a negative offset of 1 in the digital values output for the pixels Effect on scA750 60 Models...

Page 241: ...et the Black Level Raw parameter to your desired value You can set the Black Level Selector and the Black Level Raw parameter value from within your application software by using the pylon API The fol...

Page 242: ...ata at 12 bit effective depth by default the camera transmits the 12 bits that are output from the ADC Shift by 1 When the camera is set to shift by 1 the output from the camera will include bit 10 th...

Page 243: ...2 If 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 selecte...

Page 244: ...mats No Shift As mentioned in the Functional Description section of this manual the camera uses a 12 bit ADC to digitize the output from the imaging sensor When the camera is set for a pixel format th...

Page 245: ...camera will include bit 8 through bit 1 from the ADC The result of shifting three times is that the output of the camera is effectively multiplied by 8 If the pixel values being output by the camera...

Page 246: ...re above 2048 do not use digital shift If all of the readings are below 2048 you can safely use the shift by 1 setting If all of the readings are below 1024 you can safely use the shift by 1 or 2 sett...

Page 247: ...spectively You can set the Digital Shift parameter values from within your application software by using the Basler pylon API The following code snippet illustrates using the API to set the parameter...

Page 248: ...te and a height For example suppose that you specify the x offset as 10 the width as 16 the y offset as 6 and the height as 10 The area of the array that is bounded by these settings is shown in Figur...

Page 249: ...interest you must follow these guidelines The sum of the current X Offset setting plus the current Width setting must not exceed the width of the sensor in the camera model you are using For example o...

Page 250: ...64_t heightMax Camera Height GetMax int64_t heightInc Camera Height GetInc Camera Height SetValue 200 Camera OffsetY SetValue 100 For detailed information about using the pylon API refer to the Basler...

Page 251: ...et controls camera operation you will see a change in camera operation when you change a parameter in the active set For more information about the active set see the Configuration Sets section The pa...

Page 252: ...nce set currently defining the parameter values of the active set is also called the current set Active Set Non sequence Parameters Sequence Parameters Set by the Current Set Sequence Enable Sequence...

Page 253: ...nce For details about populating sequence sets and making related settings see the sections below explaining the sequence advance modes Exposure Time Digital Shift Enable Acquisition Frame Rate LUT En...

Page 254: ...l cycle through the available sequence sets in ascending sequence set index number as frames are triggered After one sequence set cycle is complete another one will start automatically Free selection...

Page 255: ...estart are not suitable for standard operation because of the associated delays The delay between sending a software command and it becoming effective will depend on the specific installation and the...

Page 256: ...e Advance Mode When the auto sequence advance mode is selected the advance from one sequence set to the next occurs automatically as frame triggers are received The advance proceeds in ascending seque...

Page 257: ...e set is used a third time The parameter values of sequence set 1 are used for the image acquisition When the next frame start trigger was received the camera checks the current Sequence Set Execution...

Page 258: ...cling through sequence sets is terminated The sequencer parameter values in the active set return to the values that existed before the sequencer feature was enabled Fig 74 Sequencer in Auto Sequence...

Page 259: ...sequence set index number by setting the Sequence Set Index parameter The available numbers range from 0 to 63 When configuring sequence sets make sure to always use a continuous series of index num...

Page 260: ...of sequence sets Camera SequenceSetTotalNumber SetValue 2 Select sequence set with index number 0 Camera SequenceSetIndex SetValue 0 Set up the first acquisition scenario lighting object position etc...

Page 261: ...ance from one sequence set to the next proceeds automatically as frame triggers are received Input Line 1 or Input Line 2 The advance from one sequence set to the next proceeds according to the states...

Page 262: ...f the sequence set with sequence set index number 0 are loaded into the active set modifying the active set When a frame start trigger is received the camera automatically advances to the next sequenc...

Page 263: ...follows When the sequencer feature becomes enabled the sequence set cycle starts The parameter values of the sequence set with sequence set index number 0 are loaded into the active set modifying the...

Page 264: ...advances to the next sequence set The parameter values of sequence set 1 are used for the image acquisition When the next frame start trigger was received input line 1 is found to be high Accordingly...

Page 265: ...es with two synchronous restarts controlled by input line 1 Setting Sequence Set Total Number 6 Line 1 not set for invert is selected as the source for controlling restart Signal Applied to Input Line...

Page 266: ...hen the sequencer feature becomes enabled the sequence set cycle starts The parameter values of the sequence set with sequence set index number 0 are loaded into the active set modifying the active se...

Page 267: ...ame start trigger was received the camera checks the state of input line 1 Input line 1 is found to be high and therefore the parameter values of the next sequence set are loaded into the active set T...

Page 268: ...in the previous use case The Sequence Set Total Number parameter was set to six Accordingly the sequence set index numbers range from 0 through 5 The frame start trigger is set for rising edge trigge...

Page 269: ...set 1 are used for the image acquisition When the next frame start trigger was received the camera checks the states of input lines 2 and 1 Input line 2 is found to be low and therefore the sequence c...

Page 270: ...is found to be high and therefore the sequence cycle is restarted Input line 1 is found to be high but this has no significance Synchronous restart has priority over the secquence set advance control...

Page 271: ...with two synchronous restarts controlled by input line 2 Setting Sequence Set Total Number 6 Line 2 not set for invert is selected as the source for controlling restart Signal Applied to Input Line 1...

Page 272: ...e parameter values of the sequence set with sequence set index number 0 are loaded into the active set modifying the active set When a frame start trigger is received the camera checks the active set...

Page 273: ...tive set It is assumed here that the delay between sending the AsyncRestart command and it becoming effective will allow the acquisition of two more images When the next frame start trigger is receive...

Page 274: ...ed The complete frame is transmitted and the cycling through sequence sets is terminated The sequencer parameter values in the active set return to the values that existed before the sequencer feature...

Page 275: ...x number is indicated Sequencer Disabled Use Case Operation in controlled sequence advance mode with Disabled sequence control source Cycling through the sequence set cycles only due to one asynchrono...

Page 276: ...g the sources for sequence set advance and sequence cycle restart Make sure that the sequencer feature is disabled Set the Sequence Advance mode to Controlled Set the Sequence Set Total Number paramet...

Page 277: ...vert see Section 8 1 3 on page 92 Configuring Sequence Sets and Advance Control Using Basler pylon You can use the pylon API to set the parameters for configuring sequence sets from within your applic...

Page 278: ...SetValue 1 Set up the second acquisition scenario lighting object position etc and adjust the camera parameters for the best image quality Store the sequence parameter values from the active set in th...

Page 279: ...e sequence set index numbers range from 0 through 3 Input line 1 sets bit 0 of the sequence set address Input line 2 sets bit 1 of the sequence set address Both input lines are not set for invert The...

Page 280: ...2 Accordingly sequence set 2 is selected The parameter values of sequence set 0 are used for the image acquisition The sequence sets for the next five frame start triggers are selected and used accor...

Page 281: ...e true 1 1 0 2 0 3 3 2 2 0 Time Signal Applied to Input Line 1 Frame Start Trigger Signal frame exposure and readout frame transmission Sequencer Enabled Sequencer Disabled Signal Applied to Input Lin...

Page 282: ...of either input line 1 or input line 2 to set bit 0 If the input line is not set for invert the high state of the input line will set bit 0 to 1 and the low state will set bit 0 to 0 If the input line...

Page 283: ...ndex number for the sequence set currently being populated The available numbers are 0 through 3 6 Set up your first acquisition scenario i e lighting object positioning etc 7 Adjust the camera parame...

Page 284: ...t up the first acquisition scenario lighting object position etc and adjust the camera parameters for the best image quality Store the sequence parameter values from the active set in the selected seq...

Page 285: ...and are reported out of the camera as a single pixel Figure 81 illustrates vertical binning Fig 81 Vertical Binning With horizontal binning adjacent pixels from 2 columns 3 columns or a maximum of 4...

Page 286: ...the Basler pylon API The following code snippet illustrates using the API to set the parameter values Enable vertical binning by 2 Camera BinningVertical SetValue 2 Enable horizontal binning by 4 Came...

Page 287: ...of interest AOI will refer to the binned lines and columns in the sensor and not to the physical lines in the sensor as they normally would Another way to think of this is by using the concept of a v...

Page 288: ...f the second pixel in the line will be swapped with the value of the next to last pixel and so on Figure 83 shows a normal image on the left and an image captured with reverse X enabled on the right U...

Page 289: ...t for both normal and mirror images AOIs used for the function feature will behave analogously to standard AOIs Depending on whether or not the reverse X feature is enabled an Image AOI will display d...

Page 290: ...are by using the Basler pylon API The following code snippet illustrates using the API to set the parameter value Enable reverse X Camera ReverseX SetValue true For detailed information about using th...

Page 291: ...through 15 are not used The number at location 16 in the table represents the effective 12 bits that will be transmitted out of the camera when the sensor reports that a pixel has a value of 16 The nu...

Page 292: ...the output of the camera increases linearly as the sensor output increases The second graph is for a lookup table where the values are arranged so that the camera output increases quickly as the sens...

Page 293: ...ailable i e the luminance lookup table described above Use the LUT Index parameter to select a value in the lookup table The LUT Index parameter selects the value in the table to change The index numb...

Page 294: ...sensor reports that a pixel has a value of 4 The number at location 5 is not used The number at location 6 in the table represents the mapped 10 bit value that will be used when the sensor reports tha...

Page 295: ...anged so that the camera output increases quickly as the sensor output moves from 0 through 512 and increases gradually as the sensor output moves from 513 through 1023 Fig 87 Lookup Table with Values...

Page 296: ...meter and LUT value parameters to set other table values as desired Use the LUT Enable parameter to enable the table You can set the LUT Selector the LUT Index parameter and the LUT Value parameter fr...

Page 297: ...parameter value is not preserved For example when the Gain Auto function adjusts the gain parameter value the manually set gain parameter value is not preserved For some auto functions the target val...

Page 298: ...current frame rate the automatic adjustments will 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 unti...

Page 299: ...ample suppose that you specify the X offset as 14 the width as 5 the Y offset as 7 and the height as 6 The area of the array that is bounded by these settings is shown in Figure 89 Only the pixel data...

Page 300: ...property If the Image AOI is completely included in the Auto Function AOI see b in Figure 90 only the pixel data from the Image AOI will be used to control the image property If the Image AOI only pa...

Page 301: ...1 12 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 90 Various Degrees of Overlap Between...

Page 302: ...640 70 the sum of the Y Offset setting plus the Height setting must not exceed 494 The X Offset Y Offset Width and Height parameters can be set in increments of 1 For more information about the concep...

Page 303: ...to the Basler pylon Programmer s Guide and API Reference You can also use the Basler pylon Viewer application to easily set the parameters 12 9 1 3 Using an Auto Function To use an auto function carr...

Page 304: ...Set the postion and size of Auto Function AOI1 3 Set the lower and upper limits for the Gain Raw All parameter value 4 Set the target average gray value 5 If necessary set the auto function profile 6...

Page 305: ...luminance control Camera GainSelector SetValue GainSelector_All Camera AutoGainRawLowerLimit SetValue Camera GainRaw GetMin Camera AutoGainRawUpperLimit SetValue Camera GainRaw GetMax Set target valu...

Page 306: ...auto function is used the gain auto function can be used at the same time In this case however you must also set the auto function profile feature For more information about absolute exposure time se...

Page 307: ...function AOI Camera AutoFunctionAOISelector SetValue AutoFunctionAOISelector_AOI1 Camera AutoFunctionAOIOffsetX SetValue 0 Camera AutoFunctionAOIOffsetY SetValue 0 Camera AutoFunctionAOIWidth SetValue...

Page 308: ...ng adjustments 2 Set the gain auto function to the continuous mode of operation 3 Set the exposure auto function to the continuous mode of operation You can set the auto function profile from within y...

Page 309: ...rol the white balance of the image For information on the white balance feature see Section 10 3 1 on page 181 To use the balance white auto function carry out the following steps 1 Select Auto Functi...

Page 310: ...r to the Basler pylon Programmer s Guide and API Reference You can also use the Basler pylon Viewer application to easily set the parameters For general information about auto functions see Section 12...

Page 311: ...via the pylon API Disabling Parameter Limits To disable the limits for a parameter Use the Parameter Selector to select the parameter whose limits you wish to disable Set the value of the Remove Limi...

Page 312: ...debouncer value Figure 91 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 delays a...

Page 313: ...set the Line Selector and the value of the Line Debouncer Abs parameter from within your application software by using the pylon API The following code snippet illustrates using the API to set the se...

Page 314: ...ith unmodified signal width Fig 92 Increasing the Signal Width of an Output Signal Setting the Minimum Output Pulse Width The minimum output pulse width is determined by the value of the MinOutPulseWi...

Page 315: ...er value to 10 0 microseconds Camera MinOutPulseWidthAbs SetValue 10 0 For detailed information about using the pylon API refer to the Basler pylon Programmer s Guide and API Reference You can also us...

Page 316: ...e pylon API The following code snippets illustrate using the API to set the parameter values Standard mode Select the acquisition start trigger Camera TriggerSelector SetValue TriggerSelector_Acquisit...

Page 317: ...elector_AcquisitionStart Trigger delay double TriggerDelay_us 1000 0 1000us 1ms 0 001s Camera TriggerDelayAbs SetValue TriggerDelay_us For detailed information about using the pylon API refer to the B...

Page 318: ...the value of the AcquisitionStatus parameter Standard mode If the value is set to false the camera is not ready to receive a frame start trigger if the value is set to true the camera is ready to rec...

Page 319: ...dard Features Basler scout GigE 309 For more information about the pylon Viewer see Section 3 1 on page 43 For more information about the standard and legacy image acquisition control modes see Sectio...

Page 320: ...ow that an exposure end type event has occurred A Frame ID This number indicates the frame count at the time that the event occurred A Stream Channel Identifier Currently this identifier is always 0 A...

Page 321: ...within a single event message as soon as transmission time is available However if you are operating the camera at high frame rates with a small AOI the camera may be able to generate and queue events...

Page 322: ...rmation about using the pylon API refer to the Basler pylon Programmer s Guide and API Reference Event Event Parameter Name Supplementary Information Parameter Name AcquisitionStart AcquisitionStartEv...

Page 323: ...for test images 4 and 5 the cameras digital features will affect the images transmitted by the camera This makes test images 4 and 5 a good way to check the effect of using a digital feature such as...

Page 324: ...ge one will look similar to Figure 93 The mathematical expression for this test image Gray Value column number row number MOD 256 Fig 93 Test Image One Test Image 2 Moving Diagonal Gray Gradient 8 bit...

Page 325: ...s test image 4 useful for checking the effects of digital features such as the luminance lookup table Test Image 5 Moving Diagonal Gray Gradient Feature Test 12 bit The basic appearance of test image...

Page 326: ...as only and is designed for use when the camera is set for YUV output As shown in Figure 94 test image six consists of diagonal color gradients The image moves by one pixel from right to left whenever...

Page 327: ...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 328: ...Max Height parameter int64_t maxHeight Camera HeightMax GetValue Read the Temperature Abs parameter camera TemperatureSelector SetValue TemperatureSelector_Sensorboard double temperature camera Temper...

Page 329: ...p is similar to the standard factory setup but the Gain Auto and the Exposure Auto auto functions are both enabled and are set to the continuous mode of operation During automatic parameter adjustment...

Page 330: ...d for designating which set will be the startup set appear later in the Configuration Sets section Designating a Startup Set You can designate the default set or one of the user sets as the startup se...

Page 331: ...owever select any one of the four factory setups to serve as the default set To select which factory setup that will serve as the default set Set the Default Set Selector to the Standard Factory Setup...

Page 332: ...does not have a single image acquisition pending Selecting the standard factory setup as the default set and then loading the default set into the active set is a good course of action if you have gr...

Page 333: ...er Set 3 or Default Execute a User Set Load command to load the selected set into the active set You can set the User Set Selector and execute the User Set Load command from within your application so...

Page 334: ...ry to be the startup set The configuration set that you designate as the startup set will be loaded into the active set whenever the camera starts up at power on or after a reset The User Set Default...

Page 335: ...escription file provides all features except the following ones Matrix color correction see Section 10 3 3 on page 185 Color adjustment see Section 10 3 4 on page 189 Sequencer see Section 12 5 on pag...

Page 336: ...cation software by using the pylon API The following code snippet illustrates using the API to set the parameter value in the example the camera description file providing the complete feature set is...

Page 337: ...added to each image as a trailing data chunk when the image is transferred to the host PC Examples of this type of camera feature are the Frame Counter feature and the Time Stamp feature When the Fra...

Page 338: ...inactive switches all chunk features off Also note that when you enable ChunkModeActive the PayloadType for the camera changes from Pylon PayloadType_Image to Pylon PayloadType_ChunkData For detailed...

Page 339: ...parser and retrieve the extended image data retrieve date from the extended image data chunk IChunkParser ChunkParser Camera CreateChunkParser GrabResult Result StreamGrabber RetrieveResult Result Chu...

Page 340: ...chunk appended to an image that has been received by your PC you must first run the image and its appended chunks through the chunk parser included in the pylon API Once the chunk parser has been use...

Page 341: ...nd if the trigger input counter is ahead of the matching frame counter by more than one the camera was overtriggered and not all external triggers resulted in frame acquisitions Frame Counter Reset Wh...

Page 342: ...a CounterResetSource SetValue CounterResetSource_Software execute reset by software Camera CounterReset Execute disable reset Camera CounterResetSource SetValue CounterResetSource_Off For detailed inf...

Page 343: ...in the pylon API Once the chunk parser has been used you can retrieve the time stamp information by doing the following Read the value of the Chunk Time Stamp parameter You can set the Chunk Selector...

Page 344: ...iled information about using the pylon API refer to the Basler pylon Programmer s Guide and API Reference You can also use the Basler pylon Viewer application to easily set the parameters For more inf...

Page 345: ...retrieve data from a chunk appended to an image that has been received by your PC you must first run the image and its appended chunks through the chunk parser included in the pylon API Once the chunk...

Page 346: ...the same time and not reset since and if the trigger input counter is ahead of the matching frame counter by more than one the camera was overtriggered and not all external triggers resulted in frame...

Page 347: ...a CounterResetSource SetValue CounterResetSource_Software execute reset by software Camera CounterReset Execute disable reset Camera CounterResetSource SetValue CounterResetSource_Off For detailed inf...

Page 348: ...n received by your PC you must first run the image and its appended chunks through the chunk parser included in the pylon API Once the chunk parser has been used you can retrieve the line status all i...

Page 349: ...rser AttachBuffer unsigned char Result Buffer Result GetPayloadSize int64_t lineStatusAll Camera ChunkLineStatusAll GetValue For detailed information about using the pylon API refer to the Basler pylo...

Page 350: ...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 the received image and chunk information It then compares the...

Page 351: ...lt Result ChunkParser AttachBuffer unsigned char Result Buffer Result GetPayloadSize if ChunkParser HasCRC ChunkParser CheckCRC cerr Image corrupted endl For detailed information about using the pylon...

Page 352: ...u can set the Chunk Selector and Chunk Enable parameter value from within your application software by using the Basler pylon API You can also run the parser and retrieve the chunk data The following...

Page 353: ...11916000 Chunk Features Basler scout GigE 343 Result GetPayloadSize int64_t timeStamp Camera ChunkSequenceSetIndex GetValue You can also use the Basler pylon Viewer application to easily set the param...

Page 354: ...Chunk Features AW00011916000 344 Basler scout GigE...

Page 355: ...ions of our website www baslerweb com If you do decide to contact Basler technical support please take a look at the form that appears on the last two pages of this section before you call Filling out...

Page 356: ...cal dealer or to your nearest Basler support center Or you can send an e mail listing the requested pieces of information and with the requested files attached Basler technical support contact informa...

Page 357: ...or Basler technical support to get a copy of the exact camera parameters that you were using when the problem occurred To make note of the parameters use Basler s pylon Viewer tool If you cannot acces...

Page 358: ...Troubleshooting and Support AW00011916000 348 Basler scout GigE...

Page 359: ...dimensions for cameras equipped with CS mount lens adapters to Section 1 5 on page 24 Updated the description of the camera s network related parameters in Section 5 1 on page 57 Added Section 12 15 o...

Page 360: ...ctions throughout the manual AW00011907000 21 Dec 2007 Added guidelines for avoiding EMI and ESD problems in Section 2 3 1 on page 55 Replaced recommendations of individual adapters by a reference to...

Page 361: ...p Guide for Cameras Used with Basler s pylon API in Section 2 on page 41 Added the Improve the Network Performance step in Section 5 2 1 on page 63 Corrected the minimum value for the Timer Delay Raw...

Page 362: ...to the debouncer in Section 9 12 on page 165 Updated the black level feature description and the Black Level Raw parameter range for the scA1400 30 in Section 12 2 on page 230 Corrected the minimum v...

Page 363: ...12 9 1 2 on page 289 Replaced Auto Gain Raw by the correct Gain Raw All parameter name in Section 12 9 2 on page 294 Replaced Auto Exposure Time Abs by the correct Exposure Time Abs parameter name in...

Page 364: ...ntrol Indicated that the maximum possible frame rate can not be achieved with the acquisition mode parameter set to single frame in Section 9 3 on page 109 Section 9 13 on page 167 and Section 9 14 on...

Page 365: ...39 and Figure 40 in Section 7 7 on page 84 Removed the Typical LED Output Signal figure from Section 7 7 2 2 on page 87 Simplified the definition of response times removed ranges of response time val...

Page 366: ...wing sections to Section 10 on page 175 The Bayer Color Filter White Balance Integrated IR Cut Filter Gamma Included white balance reset in Section 10 3 1 on page 181 Included sRGB gamma correction in...

Page 367: ...AW00011916000 Revision History Basler scout GigE 357...

Page 368: ...Revision History AW00011916000 358 Basler scout GigE...

Page 369: ...nchronous advance 244 asynchronous restart 244 auto function 287 mode of operation 288 using with binning 288 auto function AOI explained 287 setting 292 auto function profile 298 auto functions modes...

Page 370: ...hunk 340 current set 242 D debouncer and exposure start delay 166 explained 302 setting 303 304 default configuration set 319 device current throughput parameter 62 device firmware version parameter 3...

Page 371: ...ger acquisition start 116 135 frame start 124 heartbeat timeout parameter 55 heartbeat timer 55 high gain factory setup 319 321 horizontal binning 275 horizontal mirror image 278 housing 90 head 1 29...

Page 372: ...r 95 response time 89 voltage requirements 87 over triggering 125 135 overlapped exposure 153 155 P packet size camera 66 network adapter 66 network switch 66 packet size parameter 57 packet timeout p...

Page 373: ...response 12 23 speed and duplex mode parameter 66 squence set address 269 sRGB gamma 183 standard factory setup 319 321 323 standard power and I O cable 79 voltage requirements 82 84 startup parameter...

Page 374: ...36 vertical binning 275 viewer 43 W weight 3 5 7 9 11 white balance 181 setting 181 white balance auto see balance white auto write timeout parameter 55 Y YUV 422 YUYV packed pixel format 204 217 YUV...

Reviews: