Page 1
Basler scout USER’S MANUAL for Scout-f Cameras Used with Basler’s Pylon API Document Number: AW000125 Version: 12 Language: 000 (English) Release Date: 14 April 2011...
Page 2
Basler customers using or selling these products for use in such applications do so at their own risk and agree to fully indemnify Basler for any damages resulting from such improper use or sale. Warranty Note Do not open the housing of the camera.
Page 3
Contacting Basler Support Worldwide Europe: Basler AG An der Strusbek 60 - 62 22926 Ahrensburg Germany Tel.: +49-4102-463-515 Fax.: +49-4102-463-599 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. Ltd...
We strongly recommend that you read and follow the precautions. Models The current Basler IEEE 1394 camera models are listed in the top row of the specification tables on the next pages of this manual. The camera models are differentiated by their sensor size, their maximum frame rate at full resolution, and whether the camera’s sensor is mono or color.
+ 8 to + 36 VDC supplied via the IEEE 1394 cable < 1% ripple Requirements 2.5 W @ 12 V 3.0 W @ 12 V I/O Ports 2 opto-isolated input ports and 4 opto-isolated output ports Lens Adapter C-mount (CS-mount optional) Basler scout...
Page 13
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) Weight (standard housing) 160 g (typical) (90° head housing) 180 g (typical) Conformity CE, FCC, GenICam, IP30 Table 1: General Specifications Basler scout...
Page 14
+ 8 to + 36 VDC supplied via the IEEE 1394 cable < 1% ripple Requirements 1.7 W @ 12 V 2.5 W @ 12 V I/O Ports 2 opto-isolated input ports and 4 opto-isolated output ports Lens Adapter C-mount (CS-mount optional) Basler scout...
Page 15
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) Weight (standard housing) 160 g (typical) (90° head housing) 180 g (typical) Conformity CE, FCC, GenICam, IP30 Table 2: General Specifications Basler scout...
Page 16
+ 8 to + 36 VDC supplied via the IEEE 1394 cable < 1% ripple Requirements 2.5 W @ 12 V 3.0 W @ 12 V 2.75 W @ 12 V I/O Ports 2 opto-isolated input ports and 4 opto-isolated output ports Lens Adapter C-mount (CS-mount optional) Basler scout...
Page 17
(with connectors and front module) module) Weight (standard housing) 160 g (typical) 160 g (typical) 160 g (typical) (90° head housing) 180 g (typical) Not applicable 180 g (typical) Conformity CE, FCC, GenICam, IP30 Table 3: General Specifications Basler scout...
Page 18
+ 8 to + 36 VDC supplied via the IEEE 1394 cable < 1% ripple Requirements 3.0 W @ 12 V 3.7 W @ 12 V 2.75 W @ 12 V I/O Ports 2 opto-isolated input ports and 4 opto-isolated output ports Lens Adapter C-mount (CS-mount optional) Basler scout...
Page 19
97 mm x 44 mm x 41.8 mm (with connectors and front module) Weight (standard housing) 170 g (typical) 170 g (typical) 160 g (typical) (90° head housing) 190 g (typical) 190 g (typical) 180 g (typical) Conformity CE, FCC, GenICam, IP30 Table 4: General Specifications Basler scout...
Page 20
Camera Power + 8 to + 36 VDC supplied via the IEEE 1394 cable < 1% ripple Requirements 4.2 W @ 12 V I/O Ports 2 opto-isolated input ports and 4 opto-isolated output ports Lens Adapter C-mount (CS-mount optional) Basler scout...
Page 21
73.7 mm x 44 mm x 29 mm (without lens adapter or connectors) (standard housing) 85.5 mm x 44 mm x 29 mm (with lens adapter and connectors) (90° head housing) Weight (standard housing) 170 g (typical) (90° head housing) Conformity CE, FCC, GenICam, IP30 Table 5: General Specifications Basler scout...
Spectral Response for Mono Cameras The following graphs show the spectral response for each available monochrome camera model. Note The spectral response curves excludes lens characteristics and light source characteristics. Wave Length (nm) Fig. 1: scA640-70fm Spectral Response Basler scout...
A suitable IR cut filter is included in the standard C-mount lens adapter on color models of the camera. (An IR cut filter is not included in the optional CS- mount adapter.) Blue Green Wave Length (nm) Fig. 11: scA640-70fc Spectral Response Basler scout...
Page 29
Specifications, Requirements, and Precautions Blue Green Wave Length (nm) Fig. 12: scA640-74fc Spectral Response Blue Green Wave Length (nm) Fig. 13: scA640-120fc Spectral Response Basler scout...
Page 30
Specifications, Requirements, and Precautions Blue Green (B) Green (R) Wave Length (nm) Fig. 14: scA750-60fc Spectral Response Blue Green Wave Length (nm) Fig. 15: scA780-54fc Spectral Response Basler scout...
Page 31
Specifications, Requirements, and Precautions Blue Green Wave Length (nm) Fig. 16: scA1000-20fc and scA1000-30fc Spectral Response Blue Green 4 00 5 00 60 0 Wave Length (nm) Fig. 17: scA1300-32fc Spectral Response Basler scout...
Page 32
Specifications, Requirements, and Precautions Blue Green Wave Length (nm) Fig. 18: scA1390-17fc Spectral Response Blue Green Wave Length (nm) Fig. 19: scA1400-17fc and scA1400-30fc Spectral Response Basler scout...
Page 33
Specifications, Requirements, and Precautions Blue Green Wave Length (nm) Fig. 20: scA1600-14fc and scA1600-28fc Spectral Response Basler scout...
Figure 21. The dimensions for cameras equipped with an optional CS-mount lens adapter are shown in Figure 22 on page Camera housings are equipped with four mounting holes on the top and four mounting holes on the bottom as shown in the drawings. Basler scout...
Page 35
2x M3; 4.5 deep 6.45 72.3 12.5 73.7 85.5 17.5 2 x M3; 3.5 deep Photosensitive surface of the sensor 2 x M3; 4.5 deep 67.2 Fig. 21: Mechanical Dimensions (in mm) for Cameras with the Standard C-mount Lens Adapter Basler scout...
Page 36
2x M3; 4.5 deep 1.45 72.3 12.5 73.7 80.5 12.5 2x M3; 3.5 deep Photosensitive surface of the sensor 2x M3; 4.5 deep 67.2 Fig. 22: Mechanical Dimensions (in mm) for Cameras with an Option CS-mount Lens Adapter Basler scout...
1.5.2.1 Camera Dimensions and Mounting Points In scout cameras with the 90° head housing the camera’s direction of view is at right angle to the direction of view of standard scout cameras. The cameras are manufactured with high precision. Planar, parallel, and angular sides guarantee precise mounting with high repeatability.
Page 40
2 x M3; 4.5 Deep 72.65 Photosensitive 28.5 surface of the Ø sensor 3.25 86.3 2 x M3; 4.5 Deep 2 x M3; 3.5 Deep Fig. 25: Mechanical Dimensions (in mm) for Cameras (90° Head) with the Standard C-mount Lens Adapter Basler scout...
Note that this tolerance and the sensor tilt tolerance (see above) must be combined to obtain the total tolerance for every point on the photosensitive surface.) Fig. 26: Sensor Positioning Accuracy for Cameras (90° Head) with the Standard C-mount Lens Adapter (in mm unless otherwise noted) Basler scout...
C-mount color cameras that do not include an internal IR cut filter are available on request. Monochrome cameras are not normally equipped with an internal IR cut filter, however, they can be equipped with an internal filter on request. Basler scout...
1.5.4 Mechanical Stress Test Results Scout cameras were submitted to an independent mechanical testing laboratory and subjected to the stress tests listed below. The mechanical stress tests were performed on selected camera models with standard housings. After mechanical testing, the cameras exhibited no detectable physical damage and produced normal images during standard operational testing.
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Basler scout...
Use suitable clothing (cotton) and shoes. Control the humidity in your environment. Low humidity can cause ESD problems. The Basler application note called Avoiding EMI and ESD in Basler Camera Installations provides much more detail about avoiding EMI and ESD.
Allow sufficient air circulation around the camera to prevent internal heat build-up in your system and to keep the camera’s housing temperature below 50 °C. Additional cooling devices such as fans or heat sinks are not normally required, but should be provided if necessary. Basler scout...
Reversing the polarity will damage the camera. CAUTION If the voltage to the camera is greater than +36 VDC, damage to the camera can result. If the voltage is less than +8 VDC, the camera may operate erratically. Basler scout...
Page 48
The code snippets in this manual are written in C++. Other programming languages can also be used to write code for use with Basler pylon. When writing code, you should use a programming language that is both compatible with pylon and appropriate for your application.
Page 49
Do not use solvents or thinners to clean the housing; they can damage the surface finish. Read the manual Read the manual carefully before using the camera! Basler scout...
Page 50
Specifications, Requirements, and Precautions Basler scout...
2 Software and Hardware Installation The information you will need to install and operate the camera is included in the Installation and Setup Guide for Cameras Used with Basler’s pylon API, (AW000611xx000). You can download the guide from the Basler website: www.baslerweb.com The guide includes information about both hardware and software and describes how to begin capturing images.
Page 52
Software and Hardware Installation Basler scout...
GUI or by accessing the camera from within your software application. The pylon Viewer The Basler pylon Viewer is a standalone application that lets you view and change most of the camera’s parameter settings via a GUI based interface. The viewer also lets you acquire images, display them, and save them.
Page 54
Tools for Changing Camera Parameters For more information about installing pylon software, see the installation and Setup Guide for Cameras Used with Basler’s pylon API (AW000611xx000). You can download the guide from the Basler website: www.baslerweb.com Basler scout...
Exposure start, exposure time, and charge readout can be controlled by parameters transmitted to the camera via the Basler pylon API and the IEEE 1394b interface. There are also parameters available to set the camera for single frame acquisition or continuous frame acquisition.
Page 56
TrigRdy Image Image Data Data Link Physical IEEE Layer Sensor FPGA Layer 1394b Controller Image Isochronous Controller Isochronous Data Asynchronous Asynchronous Data Data Control Micro- Controller Control: Asynchronous AOI, Gain, Black Level Data Fig. 29: Camera Block Diagram Basler scout...
Exposure start, exposure time, and charge readout can be controlled by parameters transmitted to the camera via the Basler pylon API and the GigE interface. There are also parameters available to set the camera for single frame acquisition or continuous frame acquisition.
Page 58
ExpActive, TrigRdy Image Image Data Data Link Physical IEEE Sensor FPGA Layer Layer 1394b Image Controller Isochronous Controller Isochronous Data Asynchronous Asynchronous Data Data Control: Control Gain Black Level Micro- Controller Control Data Fig. 31: Camera Block Diagram Basler scout...
12-pin receptacle used to provide access to the camera’s I/O ports. There is also an LED indicator on the back. The drawing below shows the location of the two connectors and the LED. 12-pin Receptacle IEEE 1394b Socket Fig. 32: Camera Connectors and LED Basler scout...
(power ground) Not connected (+8 to +36 VDC power) TPB R (twisted pair B ground) Table 7: Pin Assignments for the IEEE 1394b Socket Pin numbering for the IEEE 1394b socket is as shown in Section 5.2.3 on page Basler scout...
Table 8: Pin Assignments for the 12-pin Receptacle Pin numbering for the 12-pin receptacle is as shown in Section 5.2.3 on page 5.2.3 Pin Numbering Fig. 33: Pin Numbering for the IEEE 1394b Socket and the 12-pin Receptacle Basler scout...
The recommended mating connector is any standard, 9-pin IEEE 1394b plug. 5.3.2 12-pin Connector The 12-pin connector on the camera is a Hirose micro receptacle (part number HR10A-10R-12P) or the equivalent. The recommended mating connector is the Hirose micro plug (part number HR10A-10P-12S) or the equivalent. Basler scout...
Close proximity to strong magnetic fields should be avoided. The required 12-pin Hirose plug is available from Basler. Basler also offers a standard I/O cable assembly that is terminated with a 12-pin Hirose plug on one end and unterminated on the other.
Page 64
Not Connected I/O In 1 I/O In 2 I/O In Gnd I/O Out 1 I/O Out 2 Not Connected Not Connected I/O Out VCC I/O Out 3 I/O Out 4 Standard I/O Cable Fig. 34: Standard I/O Cable Basler scout...
PLC device. Basler offers PLC I/O cables with 3 meter and 10 meter lengths. Each cable is terminated with a 12-pin Hirose plug (HR10A-10P-12S) on the end that connects to the camera. The other end is unterminated.
The camera may operate erratically. +12 VDC Recommended operating voltage; < 1 % ripple required. +36 VDC Absolute maximum; the camera may be damaged when the absolute maximum is exceeded. Table 9: Voltage Requirements for the Camera Power Basler scout...
> +2.2 VDC The voltage indicates a logical 1. +30.0 VDC Absolute maximum; the camera may be damaged if the absolute maximum is exceeded. Table 10: Voltage Requirements for the I/O Input When Using the Standard I/O Cable Basler scout...
Page 68
> +10.4 VDC The voltage indicates a logical 1. +30.0 VDC Absolute maximum; the camera may be damaged if the absolute maximum is exceeded. Table 11: Voltage Requirements for the I/O Input When Using a PLC I/O Cable Basler scout...
For more information about how to use an ExTrig signal to control image acquisition, see Section 7.4.5 on page 90, Section 7.5.3 on page 98, and Section 7.6.3 on page 109. For more information about configuring the input lines, see Section 6.1 on page Basler scout...
A conducting transistor means a logical one and a non-conducting transistor means a logical zero. Figure 36 shows a typical circuit you can use to monitor an output line with a voltage signal. The circuit in Figure 36 is monitoring output line 1. Basler scout...
Page 71
By default, the camera’s trigger ready (TrigRdy) is assigned to Output Line 2. The trigger ready signal goes high to indicate the earliest point at which exposure start for the next frame can be triggered. The assignment of camera output signals to physical output lines can be changed by the user. Basler scout...
Page 72
For more information about the exposure active signal, see Section 7.11.1 on page 131. For more information about the trigger ready signal, see Section 7.11.3 on page 132. For more information about assigning camera output signals to physical output ports, see Section 6.2 on page Basler scout...
The response times for the output lines on your camera will typically fall into the ranges specified above. The exact response time for your specific application will depend on the external resistor and the applied voltage you use. Basler scout...
Legacy mode: By default, physical input line 1 is assigned to receive the ExTrig signal to serve as the acquisition start trigger. You can assign only one line to receive the ExTrig input signal. Basler scout...
A line assigned to receive an ExTrig input signal can’t be used to receive a user- designed input signal. For more information about using the Line Status and Line Status All parameters, see Section 6.3.1 page 75 and Section 6.3.2 on page Basler scout...
Camera.LineSource.SetValue( LineSource_ExposureActive ); Camera.LineSelector.SetValue( LineSelector_Out2 ); Camera.LineSource.SetValue( LineSource_TriggerReady ); 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.
Camera.UserOutputValue.SetValue( true ); bool currentUserOutput3State = Camera.UserOutputValue.GetValue( ); 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.
// Enable the inverter on output line 1 Camera.LineSelector.SetValue( LineSelector_Out1 ); Camera.LineInverter.SetValue( true ); 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.
Camera.TimerSelector.SetValue( TimerSelector_Timer1 ); Camera.TimerTriggerSource.SetValue( TimerTriggerSource_ExposureStart ); 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.
Camera.TimerSelector.SetValue( TimerSelector_Timer1 ); Camera.TimerDelayRaw.SetValue( 100 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 82
Timer Delay Abs parameter to the nearest achieveable value. You should also be aware that if you change the delay time using the raw settings, the Timer Delay Abs parameter will automatically be updated to reflect the new delay time. Basler scout...
Camera.TimerSelector.SetValue( TimerSelector_Timer1 ); Camera.TimerDurationRaw.SetValue( 100 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 84
Duration Abs parameter will indicate the current duration time setting. You should also be aware that if you change the duration time using the raw settings, the Timer Duration Abs parameter will automatically be updated to reflect the new duration time. Basler scout...
Camera.LineSelector.SetValue( 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 also use the Basler pylon Viewer application to easily set the parameters.
Page 86
Indicates output line 4 state Indicates output line 3 state Indicates output line 2 state Indicates input line 2 state Indicates output line 1 state Indicates input line 1 state Fig. 42: Line Status All Parameter Bits Basler scout...
Legacy and Standard Two different image acquisition control modes are available: the legacy mode and the standard mode. Previous Basler scout cameras with firmware version 3.2 and below only operate according to the legacy mode. The legacy mode differs from the standard mode in only two respects: the acquisition start trigger of the standard mode is not available in the legacy mode.
Page 88
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 image acquisition control mode. For more information about the pylon Viewer, see Section 3.1 on...
Section 7.8 on page 119. These diagrams present the material related to the acquisition start and stop commands, the acquisition mode, the acquisition start trigger, and the frame start trigger in a graphical format. Basler scout...
Page 90
"waiting for acquisition start trigger" acquisition status and enter a "waiting for frame start trigger" acquisition status. Applying a frame start trigger signal to the camera at this point will exit the camera from the "waiting for frame start trigger" acquisition status and will begin the Basler scout...
Page 91
"waiting for frame start trigger" status Acquisition Frame Count parameter setting = 3 Acquisition Acquisition Start Stop Command Command Executed Executed Acquisition Start Trigger Signal Frame Start Trigger Signal Time Fig. 43: Acquisition Start and Frame Start Triggering Basler scout...
Page 92
But in Basler pylon there is a single parameter, the Trigger Mode parameter, that is used to set the mode for both of these triggers. Also, the Trigger Software command mentioned earlier can be executed for either the acquisition start trigger or the frame start trigger.
You can set the Acquisition Mode parameter value and you can execute Acquisition Start or Acquisition Stop commands from within your application software by using the Basler pylon API. The code snippet below illustrates using the API to set the Acquisition Mode parameter value and to execute an Acquisition Start command.
Page 94
Image Acquisition Control Camera.AcquisitionStart.Execute( ); 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 When the camera's acquisition mode is set to single frame, the maximum possible acquisition frame rate for a given AOI cannot be achieved.
"waiting for acquisition start trigger" status. Note that this feature only applies when the Trigger Mode parameter for the acquisition start trigger is set to on. This feature is explained in greater detail in the following sections. Basler scout...
Rising Edge - specifies that a rising edge of the electrical signal will act as the acquisition start trigger. Falling Edge - specifies that a falling edge of the electrical signal will act as the acquisition start trigger. Basler scout...
You can set the Trigger Mode and Trigger Source parameters for the acquisition start trigger and also set the Acquisition Frame Count parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the Trigger Mode to on, the Trigger...
Page 98
Camera.TriggerActivation.SetValue( TriggerActivation_RisingEdge ); // Set the acquisition frame count Camera.AcquisitionFrameCount.SetValue( 5 ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon Viewer, see Section 3.1 on page Basler scout...
You can set all of the parameters needed to perform software acquisition start triggering from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter values and to execute the commands related to software acquisition...
// Note: as long as the Trigger Selector is set to Acquisition Start, executing // a Trigger Software command will apply a software acquisition start trigger // signal to the camera You can also use the Basler pylon Viewer application to easily set the parameters. 7.4.5 Using a Hardware Acquisition Start Trigger (Standard Mode) 7.4.5.1...
You can set all of the parameters needed to perform hardware acquisition start triggering from within your application by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter values required to enable rising edge hardware acquisition start triggering with...
For more information about the acquisition start trigger, and about the acquisition status, see Section 7.2 on page 79 and Section 7.4 on page Referring to the use case diagrams that appear in Section 7.8 on page 119 can help you understand the explanations of the frame start trigger. Basler scout...
When the Trigger Mode parameter for the frame start trigger is set to off, the exposure time for each frame acquisition is determined by the value of the camera’s Exposure Time Abs parameter. For more information about the camera’s Exposure Time Abs parameter, see Section 7.7 on page 116. Basler scout...
You can set the Trigger Mode and related parameter values for the frame start trigger from within your application software by using the Basler pylon API. If your settings make it necessary, you can also set the Trigger Source parameter.
Section 7.5.2.2 on page 97 includes more detailed information about applying a software frame start trigger to the camera using Basler pylon. For more information about exposure time parameters, see Section 7.7 on page 116.
You can set all of the parameters needed to perform software frame start triggering from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter values and to execute the commands related to software frame start triggering with the camera set for continuous frame acquisition mode.
To avoid over triggering, you should not attempt to acquire frames at a rate that exceeds the maximum allowed with the current camera settings. For more information about setting the camera for hardware acquisition start triggering and selecting the input line to receive the ExFSTrig signal, see Section 7.4.5.2 on page Basler scout...
This situation is illustrated below for rising edge triggering. This rise in the trigger signal will be ignored, and a Frame Start Overtrigger event will be generated ExFSTrig Signal Exposure (duration determined by the exposure time parameters) Fig. 46: Overtriggering with Timed Exposure Basler scout...
Page 110
3000 µs. For more information about the Trigger Ready signal, see Section 7.11.3 on page 132 Section 7.11.4 on page 135. For more information about the camera’s exposure time parameters, see Section 7.7 on page 116. Basler scout...
You can set all of the parameters needed to perform hardware frame start triggering from within your application by using the Basler pylon API. The following code snippet illustrates using the API to set the camera for single frame acquisition mode with the trigger mode for the acquisition start trigger set to off.
Page 112
// frame start trigger signal (ExFSTrig signal)goes high // Retrieve the captured frames Camera.AcquisitionStop.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon Viewer, see Section 3.1 on page...
Remember, however, that the diagrams apply to the standard mode. Accordingly, the acquisition start trigger shown in the diagrams is not available in legacy mode and the frame start trigger shown is equivalent to the acquisition start trigger in legacy mode. Basler scout...
Keep in mind that the camera will only react to acquisition start triggers when it is in a "waiting for acquisition start trigger" acquisition status. For more information about the acquisition status, see Section 7.2 on page 79 and Section 7.4 on page Basler scout...
Keep in mind that the camera will only react to acquisition start triggers when it is in a "waiting for acquisition start trigger" acquisition status. For more information about the acquisition status, see Section 7.2 on page 79 and Section 7.4 on page Basler scout...
You can set the Trigger Mode and related parameter values for the frame start trigger from within your application software by using the Basler pylon API. If your settings make it necessary, you can also set the Trigger Source parameter.
Camera.AcquisitionFrameRateAbs.SetValue( 60.0 ); // Start frame capture Camera.AcquisitionStart.Execute( ); 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.
You can set all of the parameters needed to perform software acquisition start triggering from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter values and to execute the commands related to software acquisition...
// a Trigger Software command will apply a software acquisition start trigger // signal to the camera For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 120
For more information about the electrical requirements for input lines 1 and 2, see Section 5.7.1 on page For more information about determining the maximum allowed frame rate, see Section 7.13 on page 143 and Section 7.14 on page 148. Basler scout...
Fig. 50: Overtriggering with Timed Exposure For more information about the Acquisition Start Overtrigger event, see Section 9.16 on page 235. For more information about the camera’s exposure time parameters, see Section 7.7 on page 116. Basler scout...
Page 122
On the second cycle of the ExASTrig signal shown in the figure, the signal rises during previous frame readout, but falls after the readout is complete. This is a normal situation and exposure would be determined by the high time of the ExASTrig signal as you would expect. Basler scout...
// set for the width exposure mode, set minimum exposure time to 3000 µs Camera.ExposureMode.SetValue( ExposureMode_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 pylon Viewer application to easily set the parameters.
You can set all of the parameters needed to perform hardware acquisition start triggering from within your application by using the Basler pylon API. The following code snippet illustrates using the API to set the camera for single frame acquisition mode.
Page 125
// acquisition start trigger signal (ExASTrig signal)goes high // Retrieve the captured frames Camera.AcquisitionStop.Execute( ); 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.
The automatic adjustment is not available when trigger width exposure mode is selected. For more information about auto functions, see Section 9.11.1 on page 214. For more information about the Exposure Auto function, see Section 9.11.3 on page 223. Basler scout...
31 µs. You can set the Exposure Time Raw and Exposure Time Base Abs parameter values from within your application software by using the pylon API. The following code snippet illustrates using the API to set the parameter values: Basler scout...
Camera.ExposureMode.SetValue( ExposureMode_Timed ); Camera.ExposureTimeRaw.SetValue( 100 ); Camera.ExposureTimeBaseAbs.SetValue( 186 ); 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.
In each use case diagram, the black box in the upper left corner indicates how the parameters are set. The use case diagrams are representational. They are not drawn to scale and are not designed to accurately describe precise camera timings. Basler scout...
Page 130
The images can then be used for a variety of purposes including vegetation coverage estimates, archaeological site identification, etc. For more information about the Acquisition Frame Rate Abs parameter, see Section 7.5.1.1 on page 93 and for information about setting the parameter, see Section 7.5.1.3 on page Basler scout...
Page 131
= frame exposure and readout = frame transmission Acquisition Acquisition Start Stop Command Command Executed Executed Acquisition Start Trigger Signal Frame Start Trigger Signal Time Fig. 53: Use Case 1 - Acquisition Start Trigger Off and Frame Start Trigger Off Basler scout...
Page 132
When the electrical signal is received on line 1, it serves as a frame start trigger signal and initiates a frame acquisition. The frame acquired by the camera is forwarded to an image processing system, which will inspect the image and determine if there are any defects in the plywood’s surface. Basler scout...
Page 133
= frame transmission Acquisition Acquisition Start Stop Command Command Executed Executed Acquisition Start Trigger Signal Frame Start Trigger Signal (applied to line 1) Time Fig. 54: Use Case 2 - Acquisition Start Trigger Off and Frame Start Trigger On Basler scout...
Page 134
For more information about the Acquisition Frame Rate Abs parameter, see Section 7.5.1.1 on page 93 and for information about setting the parameter, see Section 7.5.1.3 on page Basler scout...
Page 135
= frame transmission Acquisition Acquisition Start Stop Command Command Executed Executed Acquisition Start Trigger Signal (applied to line 1) Frame Start Trigger Signal Time Fig. 55: Use Case 3 - Acquisition Start Trigger On and Frame Start Trigger Off Basler scout...
Page 136
(Transmitting images of the "space" between the objects would be a waste of bandwidth and processing them would be a waste of processor resources.) Basler scout...
Page 137
Acquisition Acquisition Start Stop Command Command Executed Executed Acquisition Start Trigger Software Command Executed Frame Start Trigger Signal (applied to line 1) Time Fig. 56: Use Case 4 - Acquisition Start Trigger On and Frame Start Trigger On Basler scout...
This situation is illustrated in Figure 58 and is known as operating the camera with “overlapped” exposure. As you can see, running the camera with readout and exposure overlapped can allow higher acquisition frame rates because the camera is performing two processes at once. Basler scout...
For more information about using the Trigger Ready signal with all camera models except the scA750-60 fm/fc, see Section 7.11.3 on page 132. Basler scout...
"Using a Specific External Trigger Signal with Overlapped Exposure" (AW000565xx000). The application notes are available in the downloads section of the Basler website: www.baslerweb.com 7.10 Exposure Must Not Overlap Sensor...
The exposure active output signal can be selected to act as the source signal for e.g.output line 1. Selecting a source signal for the output line is a two step process: Use the Line Selector to select output line 1. Set the value of the Line Source Parameter to the exposure active output signal. Basler scout...
Image Acquisition Control You can set the Line Selector and the Line Source parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.LineSelector.SetValue( LineSelector_Out1 );...
Page 143
If you attempt to start an image acquisition when the trigger ready signal is low, the camera will simply ignore the attempt. The trigger ready signal will only be available when hardware triggering is enabled. Basler scout...
Page 144
Set the value of the Line Source Parameter to the trigger ready output signal. You can set the Line Selector and the Line Source parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.LineSelector.SetValue( LineSelector_Out1 );...
N+1 N+1 begins acquisition N+2 N+2 begins TrigRdy Signal Image Acquisition N Image Acquisition N+2 Image Acquisition N+1 Exposure Exposure Readout Readout Readout Exposure Time Fig. 62: Trigger Ready Signal Basler scout...
Page 146
Set the value of the Line Source Parameter to the trigger ready output signal. You can set the Line Selector and the Line Source parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.LineSelector.SetValue( LineSelector_Out1 );...
Figure 63 illustrates the Acquisition Trigger Wait signal with the Acquisition Frame Count parameter set to 3 and with exposure and readout overlapped. The figure assumes that the trigger mode for the frame start trigger is set to off, so the camera is internally generating frame start trigger signals. Basler scout...
Page 148
Frame Acquisition Exp. Readout Time = Camera is in a "waiting for acquisition start trigger" status Fig. 63: Acquisition Trigger Wait Signal The acquisition trigger wait signal will only be available when hardware acquisition start triggering is enabled. Basler scout...
Page 149
Set the value of the Line Source Parameter to the acquisition trigger wait signal. You can set the Line Selector and the Line Source parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.LineSelector.SetValue( LineSelector_Out1 );...
Page 151
For more information about the frame height, see Section 9.6 on page 198. You can calculate the time to transmission end (T ) using these three steps: 1. Calculate the frame readout time (T ) using the formula above. Basler scout...
Page 152
= Camera.PayloadSize.GetValue(); // Set packet size Camera.PacketSizeSize.SetValue( 4096 ); 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.
// Resulting Framerate double resultingFps = Camera.ResultingFrameRateAbs.GetValue(); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 155
600 x 400 resolution. Also assume that you have checked the value of the Payload Size parameter and the Packet Size parameters and found them to be 327100 and 8192 respectively. Formula 1: Max Frames/s ---------------------------------------------------------------------------------------------- - × 25.21 µs 1595.12 µs Max Frames/s = 85.4 frames/s Basler scout...
Packet Size parameter setting. You can see the effect of changing the Packet Size parameter by looking at the read only parameter called Resulting Frame Rate Abs. The Resulting Frame Rate Abs parameter indicates the Basler scout...
Page 157
// Get resulting framerate double resultingFps = Camera.ResultingFrameRateAbs.GetValue(); 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.
// Resulting Framerate double resultingFps = Camera.ResultingFrameRateAbs.GetValue(); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 159
Where: AOI Height = the height of the acquired frames as determined by the AOI settings. The constants C and C depend on the camera model as shown in the table below: scA750-60 fm/fc 31.01 µs 186.08 µs Basler scout...
Page 160
Formula one returns the lowest value. So in this case, the limiting factor is the sum of the exposure time plus the sensor readout time and the maximum allowed acquisition frame rate would be 68.3 frames per second. Basler scout...
// Get resulting framerate double resultingFps = Camera.ResultingFrameRateAbs.GetValue(); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 162
Image Acquisition Control Basler scout...
Page 164
Camera.PixelFormat.SetValue( PixelFormat_YUV422_YUYV_Packed ); Camera.PixelFormat.SetValue( PixelFormat_BayerBG8 ); Camera.PixelFormat.SetValue( PixelFormat_BayerBG16 ); 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.
Brightness value for P Brightness value for P Brightness value for P Brightness value for P • • • • • • Brightness value for P Brightness value for P Brightness value for P Brightness value for P Basler scout...
Page 166
With the camera set for Mono8, 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 Indicates This Signal Level (Hexadecimal) (Decimal) 0xFF 0xFE • • • • • • 0x01 0x00 Basler scout...
Low byte of brightness value for P High byte of brightness value for P Low byte of brightness value for P High byte of brightness value for P Low byte of brightness value for P High byte of brightness value for P Basler scout...
Page 168
4095 0x0FFE 4094 • • • • • • 0x0001 0x0000 When a camera that is set for Mono 16 has only 12 bits effective, the leader of transmitted frames will indicate Mono 12 as the pixel format. Basler scout...
Page 170
“unsigned” type. The available range of data values and the corresponding indicated signal levels are as shown in the table below. This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0x0FFF 4095 0x0FFE 4094 • • • • • • 0x0001 0x0000 Basler scout...
The order of the pixel data for a received frame in the image buffer in your PC is similar to the order of YUV 4:2:2 (YUYV) Packed output from a color camera. For more information about the YUV 4:2:2 (YUYV) Packed format on color cameras, see Section 8.3.7 on page 175. Basler scout...
"BG" filter alignment). As the figure illustrates, within each square of four pixels, one pixel sees only red light, one sees only blue light, and two pixels see only green light. (This combination mimics the human eye’s sensitivity to color.) Sensor Pixels Fig. 65: Bayer Filter Pattern Basler scout...
You can tell how the current AOI is aligned to the Bayer filter by reading the value of the Pixel Color Filter parameter. For more information about the camera’s AOI feature, see Section 9.6 on page 198. Basler scout...
Green value for P Red value for P Blue value for P Green value for P Green value for P Red value for P Blue value for P Green value for P Green value for P Red value for P Basler scout...
Page 175
The available range of data values and the corresponding indicated signal levels are as shown in the table below. This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0xFF 0xFE • • • • • • 0x01 0x00 Basler scout...
Green value for P Blue value for P Red value for P Green value for P Green value for P Blue value for P Red value for P Green value for P Green value for P Blue value for P Basler scout...
Page 177
The available range of data values and the corresponding indicated signal levels are as shown in the table below. This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0xFF 0xFE • • • • • • 0x01 0x00 Basler scout...
• • • • • • • • • • Low byte of blue value for P Low byte of green value for P High byte of blue value for P High byte of green value for P Basler scout...
Page 179
4094 • • • • • • 0x0001 0x0000 When a camera that is set for Bayer BG 16 has only 12 bits effective, the leader of transmitted frames will indicate Bayer BG 12 as the pixel format. Basler scout...
Green value for P bits 11 ... 4 Blue value for P bits 11 ... 4 Green value for P bits 3 ... 0 Blue value for P bits 3 ... 0 Green value for P bits 11 ... 4 Basler scout...
Page 181
“unsigned” type. The available range of data values and the corresponding indicated signal levels are as shown in the table below. This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0x0FFF 4095 0x0FFE 4094 • • • • • • 0x0001 0x0000 Basler scout...
U values and V values with unsigned integers, 128 is added to each U value and to each V value before the values are transferred from the camera. This process allows the values to be transferred on a scale that ranges from 0 to 255. Basler scout...
Page 183
• • • • • • U value for P Y value for P V Value for P Y value for P U value for P Y value for P V Value for P Y value for P Basler scout...
Page 184
• 0x01 -127 0x00 -128 The signal level of 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. Basler scout...
• • • • • • Y value for P U value for P Y value for P V value for P Y value for P U value for P Y value for P V value for P Basler scout...
Page 186
• 0x01 -127 0x00 -128 The signal level of 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. Basler scout...
With the camera set for 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. Basler scout...
Page 188
Pixel Data Formats This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0xFF 0xFE • • • • • • 0x01 0x00 Basler scout...
The columns are numbered 0 through m from the left side to the right side of the sensor The rows are numbered 0 through n from the top to the bottom of the sensor The sequence assumes that the camera is set for full resolution. Basler scout...
Fig. 66: Gain in dB output by the camera were no higher than 127 (in an 8 bit mode), you could increase the gain to 6 dB (an amplification factor of 2) and thus reach gray values of 254. Basler scout...
Page 192
Vertical (8 bit depth) (16 bit depth) Binning scA640-70 1023 scA640-74 1023 scA640-120 scA780-54 1023 scA1000-20 1023 scA1000-30 1023 scA1300-32 scA1390-17 1023 scA1400-17 1023 scA1400-30 scA1600-14 1023 scA1600-28 Table 18: Minimum and Maximum Allowed Gain Raw Settings Basler scout...
Page 193
Camera.GainSelector.SetValue( GainSelector_All ); Camera.GainRaw.SetValue( 400 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 194
500. Calculating the gain is a two step process: Step 1: × 0.0359 5.385 dB Step 2: × – Gain 0.0359 5.385 dB Gain 12.57 dB Table 19 shows the minimum and maximum gain in dB for each camera model. Basler scout...
Page 195
(16 bit depth) scA640-70 scA640-74 28.3 10.1 scA640-120 23.34 8.98 scA780-54 25.9 scA1000-20 26.6 scA1000-30 25.5 scA1300-32 19.75 3.59 scA1390-17 25.5 scA1400-17 31.0 12.8 scA1400-30 25.13 scA1600-14 25.9 scA1600-28 20.29 4.13 Table 19: Minimum and Maximum dB of Gain Basler scout...
Page 196
Camera.GainSelector.SetValue( GainSelector_All ); Camera.GainRaw.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 parameters.
Page 197
------- - ⎝ ⎠ Gain 12.0 dB Table 20 shows the dB of gain that will be achieved at various Gain Raw settings. Gain Setting dB Gain 10.9 12.7 13.4 Table 20: dB of Gain at Various Settings Basler scout...
1 in the digital values output for the pixels. A decrease of 4 in the setting will result in a negative offset of 1 in the digital values output for the pixels. Basler scout...
Page 199
Camera.BlackLevelSelector.SetValue ( BlackLevelSelector_All ); Camera.BlackLevelRaw.SetValue( 32 ); 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.
You can set the Balance Ratio Selector and the Balance Ratio Abs parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.BalanceRatioSelector.SetValue( BalanceRatioSelector_Green );...
When the camera is set to shift by 1, the least significant bit output from the camera for each pixel value will be 0. This means that no odd gray values can be output and that the gray value scale will Basler scout...
Page 202
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, you should only use the shift by 3 setting when your pixel readings with a 12 bit pixel format selected and with digital shift disabled are all less than 512. Basler scout...
Shifted Once conditions the reading for the brightest pixel is 10. If you changed the digital shift setting to shift by 1, the reading would increase to 20. Basler scout...
Page 204
8, bit 9, bit 10, or bit Shifted Four Times 11 to 1, we recommend not using shift by 4. If you do nonetheless, all bits output from the camera will Basler scout...
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 );...
Page 206
// 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.
If a lens with a very long thread length is used, the IR cut filter will be damaged or destroyed and the camera will no longer operate. CAUTION For more information about the location of the IR cut filter, see Section 1.5.3 on page Basler scout...
One of the main advantages of the AOI feature is that decreasing the height of the AOI can increase the camera’s maximum allowed acquisition frame rate. For more information about how changing the AOI height affects the maximum allowed frame rate, see Section 7.13 on page 143. Basler scout...
Page 209
Normally, the X Offset, Y Offset, Width, and Height parameter settings refer to the physical columns and lines in the sensor. But if binning is enabled, these parameters are set in terms of "virtual" columns and lines. For more information, see Section 9.6 on page 198. Basler scout...
You can set the X Offset, Y Offset, Width, and Height parameter values from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to get the maximum allowed settings and the increments for the Width and Height parameters. They also illustrate setting the X Offset, Y Offset, Width, and Height parameter values int64_t widthMax = Camera.Width.GetMax( );...
With horizontal binning, adjacent pixels from 2 columns, 3 columns, or a maximum of 4 columns are summed and are reported out of the camera as a single pixel. Figure 69 illustrates horizontal bin- ning. Horizontal Binning by 2 Horizontal Binning by 3 Horizontal Binning by 4 Fig. 69: Horizontal Binning Basler scout...
4 respectively. Setting the parameter’s value to 1 disables horizontal binning. You can set the Binning Vertical or the Binning Horizontal parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter values: // Enable vertical binning by 2 Camera.BinningVertical.SetValue( 2 );...
Page 213
If binning is enabled, however, you must use the concept of a "virtual" sensor as described above and the height of the AOI that you use in the formulas would be in terms of virtual sensor lines. The affected formulas are on page 141, page 144. Basler scout...
AOI relative to the sensor remains the same regardless of whether or not the reverse X feature is enabled. As a consequence, an AOI will display different images depending on whether or not the reverse X feature is enabled. Basler scout...
Page 215
AOI will display different images and an Auto Function AOI will refer to different image contents. The positions of the AOIs relative to the sensor will not change. For more information about auto functions, see Section 9.11 on page 214. Basler scout...
Page 216
You can enable or disable the reverse X feature by setting the ReverseX parameter value. You can set the parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter value: // Enable reverse X Camera.ReverseX.SetValue(true);...
Another thing to keep in mind about the table is that location 4088 is the last location that will have a defined 12 bit value associated with it. (Locations 4089 through 4095 are not used.) If the sensor reports a value above 4088, the camera will not be able to perform an interpolation. In cases where Basler scout...
Page 218
Fig. 72: Lookup Table with Values Mapped in a Linear Fashion 4095 3072 12 Bit Camera Output 2048 1024 1024 2048 3072 4095 12 Bit Sensor Reading Fig. 73: Lookup Table with Values Mapped for Higher Camera Output at Low Sensor Readings Basler scout...
Page 219
// Enable the lookup table Camera.LUTEnable.SetValue( true ); 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.
The graphs on the next page show the effect of two typical lookup tables. The first graph is for a lookup table where the values are arranged so that the output of the camera increases linearly as the sensor output increases. The second graph is for a lookup table Basler scout...
Page 221
10 Bit Sensor Reading Fig. 74: Lookup Table with Values Mapped in a Linear Fashion 1023 10 Bit Mapped Value 1023 10 Bit Sensor Reading Fig. 75: Lookup Table with Values Mapped for Higher Camera Output at Low Sensor Readings Basler scout...
Page 222
// Enable the lookup table Camera.LUTEnable.SetValue( true ); 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.
1.2, for example, the gamma correction factor will be 1.2. You can set the Gamma Enable and Gamma parameter values from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter values: // Enable the Gamma feature Camera.GammaEnable.SetValue( true );...
You can use an auto function when binning is enabled (monochrome cameras only; not available on scA750-60 cameras). An auto function uses the binned pixel data and controls the image property of the binned image. For more information about binning, see Section 9.7 on page 201. Basler scout...
If an auto function is set to "once" operation mode and if the circumstances will not allow reaching a target value for an image property, the auto function will try to reach the target value for a maximum of 30 images and will then be set to "off". Basler scout...
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 Offset Auto Function Height Area of Interest Image Area of Interest X Offset Width Fig. 76: Auto Function Area of Interest and Image Area of Interest Basler scout...
Page 227
You can use auto functions when also using the reverse X feature. For information about the behavior and roles of Auto Function AOI and Image AOI when also using the reverse X feature, see the "Reverse X" section. Basler scout...
Page 228
2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 Auto Function AOI Image AOI Fig. 77: Various Degrees of Overlap Between the Auto Function AOI and the Image AOI Basler scout...
Page 229
You can select an Auto Function AOI and set the X Offset, Y Offset, Width, and Height parameter values for the Auto Function AOI from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to select an Auto Function AOI and to get the maximum allowed settings for the Width and Height parameters.
Camera.AutoFunctionAOIOffsetY.SetValue( 0 ); Camera.AutoFunctionAOIWidth.SetValue( Camera.AutoFunctionAOIWidth.GetMax() ); Camera.AutoFunctionAOIHeight.SetValue( Camera.AutoFunctionAOIHeight.GetMax() ); 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.
Setting the limits for the Auto Gain Raw parameter value. The currently accessible minimum and maximum parameter values are chosen as examples Setting the target average gray value. A medium gray value is chosen as an example Enabling the gain auto function and selecting, for example, the "once" mode of operation Basler scout...
Page 232
// Set mode of operation for gain auto function Camera.GainAuto.SetValue( GainAuto_Once ); 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.
7. Enable the exposure auto function by setting it to "once" or "continuous". You must choose the "continuous" setting when using the auto function profile. The settable limits for the Exposure Time Abs parameter value are limited by the minimum allowed and maximum possible exposure time of the camera model. Basler scout...
Page 234
// Set mode of operation for exposure auto function Camera.ExposureAuto.SetValue( ExposureAuto_Continuous ); 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.
3. Set the exposure auto function to the "continuous" mode of operation. You can set the auto function profile from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to set the auto function profile. As an...
3. Enable the balance white auto function by setting it to "once". You can carry out steps 1 to 3 from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to use the auto function: Selecting and setting Auto Function AOI2: See the "Auto Function AOI"...
Page 237
Standard Features 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 general information about auto functions, see Section 9.11.1 on page 214.
Typically, the range of the extended limits is dictated by the physical restrictions of the camera’s electronic devices, such as the absolute limits of the camera’s variable gain control. The values for the extended limits can be seen using the Basler pylon Viewer or from within your application via the pylon API.
The diagram also illustrates how the debouncer delays a valid signal. Unfiltered arriving signals Debouncer debouncer value Transferred valid signal delay TIMING CHARTS ARE NOT DRAWN TO SCALE Fig. 78: Filtering of Input Signals by the Debouncer Basler scout...
Page 240
// Set the parameter value to 100 microseconds Camera.LineDebouncerTimeAbs.SetValue( 100 ); 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.
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_Acquisition Start ); // Trigger delay double TriggerDelay_us = 1000.0 // 1000us == 1ms == 0.001s; Camera.TriggerDelayAbs.SetValue( TriggerDelay_us ); // Select the frame start trigger Basler scout...
Page 242
// 1000us == 1ms == 0.001s; Camera.TriggerDelayAbs.SetValue( TriggerDelay_us ); 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.
IsWaitingForFrameTrigger = Camera.AcquisitionStatus.GetValue(); 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 Acquisition Status Selector. Basler scout...
Page 244
Standard Features For more information about the pylon Viewer, see Section 3.1 on page For more information about the standard and legacy image acquisition control modes, see Section 7.1 on page Basler scout...
PC in an event message before the next event is placed in queue. If there is an occasional short term delay in event message transmission, the queue can buffer several events and can send them within a single event message as soon as transmission time is available. Basler scout...
Page 246
API. For more information, see the "Camera Events" code sample included with the pylon software development kit. For more detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference.
Test Image Selector to one of the test images or to "test image off". You can set the Test Image Selector from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to set the selector: // set for no test image Camera.TestImageSelector.SetValue( TestImageSelector_Off );...
Page 248
The image moves by one pixel from right to left whenever a new image acquisition is initiated. The test pattern uses a counter that increments by one for each new image acquisition. The mathematical expression for this test image is: Gray Value = [column number + row number + counter] MOD 256 Basler scout...
Page 249
10 bit output mode available, use of test image 5 on scA750-60 cameras is not normally recommended. However, one situation where test image 5 is useful on scA750-60 cameras is to check the effect of the luminance lookup table. Basler scout...
Page 250
The image moves by one pixel from right to left whenever you signal the camera to capture a new image. To display this test pattern on a monitor, you must convert the YUV output from the camera to 8 bit RGB. Fig. 80: Test Image Six Basler scout...
Each camera includes a set of "device information" parameters. These parameters provide some basic information about the camera. The device information parameters include: Device Vendor Name (read only) - contains the name of the camera’s vendor. For scout cameras, this string will always indicate Basler as the vendor.
Page 252
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 read the parameters and to read or write the Device ID.
The default configuration set can be loaded into the active set. The default configuration set can also be selected as the camera’s startup set. Instructions for loading the default set into the active set and for selecting the startup set appear below. Basler scout...
You can set the User Set Selector and execute the User Set Save command from within your application software by using the pylon API. The following code snippet illustrates using the API to set the selector and execute the command: Camera.UserSetSelector.SetValue( UserSetSelector_UserSet1 ); Camera.UserSetSave.Execute( ); Basler scout...
Set the Default Set Selector to the Standard Factory Setup, High Gain Factory Setup or Auto Functions Factory Setup. You can set the Default Set Selector from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector: If you want to select the Standard Factory Setup: Camera.DefaultSetSelector.SetValue(DefaultSetSelector_Standard);...
Set the User Set Default Selector to User Set 1, User Set 2, User Set 3 or Default. You can set the User Set Default Selector from within your application software by using the pylon API. The following code snippet illustrates using the API to set the selector: Camera.UserSetDefaultSelector.SetValue( UserSetDefaultSelector_Default ); Basler scout...
The features that add chunks to the acquired images are referred to as “chunk” features. Before you can use any of the features that add chunks to the image, you must make the chunk mode active. Making the chunk mode active is described in the next section. Basler scout...
Also note that when you enable ChunkModeActive, the PayloadType for the camera changes from "Pylon::PayloadType_Image" to "Pylon::PayloadType_ChunkData". 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.
You can set the Chunk Selector and Chunk Enable parameter value from within your application software by using the Basler pylon API. You can also run the parser and retrieve the chunk data. The following code snippets illustrate using the API to activate the chunk mode, enable the frame...
Page 262
You can set the frame counter reset parameter values from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to configure and set the frame counter reset and to execute a reset via software.
Page 263
Camera.CounterReset.Execute(); // disable reset Camera.CounterResetSource.SetValue( CounterResetSource_Off ); 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. Basler scout...
API to activate the chunk mode, enable the time stamp chunk, run the parser, and retrieve the frame counter chunk data: // make chunk mode active and enable Time Stamp chunk Camera.ChunkModeActive.SetValue( true ); Camera.ChunkSelector.SetValue( ChunkSelector_Timestamp ); Camera.ChunkEnable.SetValue( true ); // retrieve data from the chunk Basler scout...
Page 265
ChunkParser.AttachBuffer( (unsigned char*) Result.Buffer(), Result.GetPayloadSize() ); int64_t timeStamp = Camera.ChunkTimestamp.GetValue(); 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.
// make chunk mode active and enable Trigger Input Counter chunk Camera.ChunkModeActive.SetValue( true ); Camera.ChunkSelector.SetValue( ChunkSelector_Triggerinputcounter ); Camera.ChunkEnable.SetValue( true ); // retrieve data from the chunk IChunkParser &ChunkParser = *Camera.CreateChunkParser(); GrabResult Result; StreamGrabber.RetrieveResult( Result ); Basler scout...
Page 267
ChunkParser.AttachBuffer( (unsigned char*) Result.Buffer(), Result.GetPayloadSize() ); int64_t triggerinputCounter = Camera.ChunkTriggerinputcounter.GetValue(); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 268
Camera.CounterReset.Execute(); // disable reset Camera.CounterResetSource.SetValue( CounterResetSource_Off ); 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. Basler scout...
API to activate the chunk mode, enable the line status all chunk, run the parser, and retrieve the line status all chunk data: // make chunk mode active and enable Line Status All chunk Camera.ChunkModeActive.SetValue( true ); Camera.ChunkSelector.SetValue( ChunkSelector_LineStatusAll ); Camera.ChunkEnable.SetValue( true ); Basler scout...
Page 270
ChunkParser.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 pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
You can set the Chunk Selector and Chunk Enable parameter value from within your application software by using the Basler pylon API. You can also run the parser and retrieve the chunk data. The following code snippets illustrate using the API to activate the chunk mode, enable the time...
Page 272
( ChunkParser.HasCRC() && ! ChunkParser.CheckCRC() ) cerr << "Image corrupted!" << endl; 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.
And we would set camera C so that it would put 4096 bytes (50% of the 8192) into each packet it sends. As shown in the figure, the bus carries the packets sequentially on each cycle. The total byte load in all of the packets combined is 8192 and is equal to the maximum allowed per cycle. Note Basler scout...
Page 274
API. The following code snippet illustrates using the API to set the parameter value: // Set packet size Camera.PacketSize.SetValue( 4096 ); 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 parameter.
Camera 6 will transmit image data at S400 speed. This is simply because the camera itself is a 1394a device. Camera 7 will transmit image data at S800 speed. This is because the camera is a 1394b device and its path to the host PC passes through only 1394b devices. Basler scout...
Page 276
You may be asking why we multiply the percentage for camera 1 by 4096 and the percentage for camera 2 by 8192. The reason is: During the part of the bus cycle when the packet for camera 1 is transmitted, the bus will operate Basler scout...
Page 277
If you add these three results together, you find that 97.7% of the available bandwidth is being used. Keep in mind that if the sum was greater than 100%, you would need to lower the packet size setting for one or more of the cameras. Basler scout...
// RecommendedPacketSize int64_t recommendedPacketSize = Camera.RecommendedPacketSize.GetValue(); 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.
If you do decide to contact Basler technical support, please take a look at the form that appears on the last two pages of this section before you call. Filling out this form will help make sure that you have all of the information the Basler technical support team needs to help you with your problem.
If an error condition is detected, the LED will begin to flash. The number of flashes indicates the detected error as shown in Table 22. LED State Status Indication No power to the camera Continuous green The camera is OK. Continuous red Internal error. Contact Basler technical support. Table 22: LED Indications Basler scout...
The charts also assume that you have the pylon Viewer software installed on your host PC and that you are familiar with using the software. For more information about the pylon Viewer, see Section 3.1 on page Basler scout...
To do this, perform Open the Windows device manager. Do you see a the "Associating the Driver with Additional device listing for “Basler pylon 1394 Digital Cameras”? Cameras" portion of the installation procedure. Check the camera power source: If the camera is connected to an IEEE 1394 adapter in a desktop computer, consult the instructions for the adapter and make sure that the adapter is properly configured to supply power to the camera.
“Poor Image Quality” troubleshooting chart. The camera was badly misadjusted. Exit this chart. If the image quality is acceptable, troubleshooting is complete. Contact Basler technical support. The contact numbers appear on the title page of this manual. Basler scout...
When you are operating the camera with an external trigger signal, the frequency of the signal determines the frame rate. If the frequency is too low, you will not achieve the maximum allowed frame rate. Exit this chart. Basler scout...
Page 285
Try attaching each camera to a separate IEEE 1394 adapter card in the PC. Exit this chart. Contact Basler technical support. The contact numbers appear on the title page of this manual. Basler scout...
Exit this Exit this chart. chart. Contact Basler technical support. The contact numbers appear on the title page of this manual. Disable the test image. Take the following actions. After you complete each Place an object in the field of view of the action, capture several images to see if the problem has camera.
Page 287
Check the brightness setting. Try decreasing the brightness setting. Has the problem been corrected? Exit this Contact Basler technical chart. support. The contact numbers appear on the title page of this manual. Take the following actions. After you complete each action,...
12.5 Before Contacting Basler Technical Support To help you as quickly and efficiently as possible when you have a problem with a Basler camera, it is important that you collect several pieces of information before you contact Basler technical support.
Page 289
Did your application ever run without problems? Parameter set It is very important for Basler technical support to get a copy of the exact camera parameters that you were using when the problem occurred. To get the tool, go to: To make a copy of the parameters, use the dump register tool.
Page 290
Troubleshooting and Support Basler scout...
31 with information on mechanical stress test results. Modified Section 2 for the installation of the Basler pylon software, version 1.0. Added information on the 8 bits effective pixel data: Section 8.2.1 on page 155, Section 8.2.4 on page 161, Section 8.2.5 on...
Page 292
Included the warning related to code snippes in Section 1.9 on page Transferred the "Software and Hardware Installation" section to the "Installation and Setup Guide for Cameras Used with Basler’s pylon API", (AW000611xx000). Added the reference to the "Installation and Setup Guide for Cameras Used with Basler’s pylon API"...
Page 293
Extended the description of the debouncer in Section 9.13 on page 229. Minor modifications and corrections throughout the manual. AW00012509000 22 Aug 2008 Updated contact addresses and phone numbers. Official release of the auto functions. Basler scout...
Page 294
Added descriptions about resetting the frame counter and about relating frame and trigger input counter in Section 10.3 on page 249. Corrected the maximum value for the frame counter in Section 10.3 on page 249. Added the trigger input counter feature in Section 10.5 on page 254. Basler scout...
Page 295
Added events and parameter names in Section 9.16 on page 235, and removed some descriptions for transfer to the "Camera Events" code sample. Rearranged sequence of sections 6 throug 8. Removed the feedback page. Basler scout...
Page 298
........116 exposure time abs parameter ..............93 IEEE 1394b device information ....55 exposure time base abs parameter ..117 image acquisition control mode exposure time raw parameter ....117 legacy ..........77 standard ........... 77 image distortion ........203 Basler scout...
Page 299
Viewer ........... 43 models ............1 mono 12 packed pixel format ....159 mono 16 pixel format ......157 mono 8 pixel format .......155 recommended packet size parameter .. 268 mounting holes ........29 reduced resolution ........ 203 multiple cameras on a bus ....263 Basler scout...
Page 300
......72 YUV 422 data range ......174 timer delay raw parameter ......71 YUV 422 packed pixel data format ..161 timer delay time ........71 YUV 422 packed pixel format ....172 timer delay time base ......71 Basler scout...
Need help?
Do you have a question about the Scout and is the answer not in the manual?
Questions and answers