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...
The pylon API ............44 4 Basler Network Drivers and Parameters ......45 The Basler Filter Driver .
Page 6
Image Acquisition Control Modes: Legacy and Standard..... . 103 Means for Controlling Image Acquisition in Standard Mode....105 Basler scout GigE...
Page 7
Acquisition Start Trigger Delay ......138 9.6.3.4 Setting the Parameters Related to Hardware Acquisition Start Triggering and Applying a Hardware Trigger Signal ... 139 Basler scout GigE...
We strongly recommend that you read and follow the precautions. Models The current Basler scout GigE Vision camera models are listed in the top row of the specification tables on the next pages of this manual. The camera models are differentiated by their sensor size, their maximum frame rate at full resolution, and whether the camera’s sensor is mono or color.
+12 VDC (-5 %) to +24 VDC (+5 %), < 1% ripple Requirements 3.0 W @ 12 V 3.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 GigE...
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, GigE Vision, IP30 Table 1: General Specifications Basler scout GigE...
Page 14
+12 VDC (-5 %) to +24 VDC (+5 %), < 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 GigE...
Page 15
91.65 mm x 44 mm x 29 mm (without front module and connectors) 97 mm x 44 mm x 41.8 mm (with front module and connectors) Weight (standard housing) 160 g (typical) (90° head housing) 180 g (typical) Conformity CE, FCC, GenICam, GigE Vision, IP30 Table 2: General Specifications Basler scout GigE...
Page 16
+12 VDC (-5 %) to +24 VDC (+5 %), < 1% ripple Requirements 3.0 W @ 12 V 3.5 W @ 12 V 3.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 GigE...
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, GigE Vision, IP30 Table 3: General Specifications Basler scout GigE...
Page 18
+12 VDC (-5 %) to +24 VDC (+5 %), < 1% ripple Requirements 3.5 W @ 12 V 4.2 W @ 12 V 3.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 GigE...
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, GigE Vision, IP30 Table 4: General Specifications Basler scout GigE...
Page 20
Programmable via the camera API Camera Power +12 VDC (-5 %) to +24 VDC (+5 %), < 1% ripple Requirements 4.3 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 GigE...
Page 21
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) 170 g (typical) (90° head housing) 190 g (typical) Conformity CE, FCC, GenICam, GigE Vision, IP30 Table 5: General Specifications Basler scout GigE...
Spectral Response for Mono Cameras The following graphs show the spectral response for each available monochrome camera model. The spectral response curves excludes lens characteristics and light source characteristics. Wave Length (nm) Fig. 1: scA640-70gm Spectral Response Spectral Response Basler scout GigE...
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-70gc Spectral Response Basler scout GigE...
Page 29
AW00011916000 Specifications, Requirements, and Precautions Blue Green Wave Length (nm) Fig. 12: scA640-74gc Spectral Response Blue Green Wave Length (nm) Fig. 13: scA640-120gc Spectral Response Basler scout GigE...
Page 30
Specifications, Requirements, and Precautions AW00011916000 Blue Green (B) Green (R) Wave Length (nm) Fig. 14: scA750-60gc Spectral Response Blue Green Wave Length (nm) Fig. 15: scA780-54gc Spectral Response Basler scout GigE...
Page 31
AW00011916000 Specifications, Requirements, and Precautions Blue Green Wave Length (nm) Fig. 16: scA1000-30gc Spectral Response Blue Green 4 00 5 00 60 0 Wave Length (nm) Fig. 17: scA1300-32gc Spectral Response Basler scout GigE...
Page 32
Specifications, Requirements, and Precautions AW00011916000 Blue Green Wave Length (nm) Fig. 18: scA1390-17gc Spectral Response Blue Green Wave Length (nm) Fig. 19: scA1400-17gc and scA1400-30gc Spectral Response Basler scout GigE...
Page 33
AW00011916000 Specifications, Requirements, and Precautions Blue Green Wave Length (nm) Fig. 20: scA1600-14gc and scA1600-28gc Spectral Response Basler scout GigE...
The dimensions in millimeters for cameras equipped with a standard C-mount lens adapter are as shown in Figure 21. The dimensions for cameras equipped with an optional CS-mount lens adapter are as shown in Figure 22. Basler scout GigE...
Page 35
2x M2; 4.5 deep 6.45 72.3 13.5 73.7 85.5 17.5 2x M3; 3.5 deep Photosensitive surface of the sensor 2x M3; 4.5 deep 67.2 Fig. 21: Mechanical Dimensions (in mm) for Cameras with the Standard C-mount Lens Adapter Basler scout GigE...
Page 36
2x M2; 4.5 deep 1.45 72.3 13.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 Optional CS-mount Lens Adapter Basler scout GigE...
In addition, there are four mounting holes in the front module (4x M3; 4.5 mm deep). For optimum accuracy in the positioning of the camera's optical axis, we recommend using the front module reference plane (see the figure in the Sensor Positioning Accuracy section) as mounting surface. Basler scout GigE...
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 GigE...
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 GigE...
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 GigE...
The mechanical stress tests were performed with a dummy lens connected to a C-mount. The dummy lens was 35 mm long and had a mass of 66 g. Using a heavier or longer lens requires an additional support for the lens. Basler scout GigE...
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 GigE...
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. This application note can be obtained from the Downloads section of our website: www.baslerweb.com...
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 GigE...
The plug on the cable that you attach to the camera’s 12-pin connector must have 12 pins. Use of a smaller plug, such as one with 10 pins or 8 pins, can damage the pins in the camera’s 12-pin connector. CAUTION Basler scout GigE...
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 GigE...
Page 50
Specifications, Requirements, and Precautions AW00011916000 Basler scout GigE...
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 Installation and Setup Guide for Cameras Used with Basler’s pylon API from the Basler website: www.baslerweb.com...
The Basler IP Configuration Tool is a standalone application that lets you change the IP configuration of the camera via a GUI. The tool will detect all Basler GigE cameras attached to your network and let you make changes to a selected camera.
API. The programmer’s guide and API reference 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. These samples include ®...
Two network drivers are available for the network adapter used with your GigE cameras: The Basler filter driver is a basic GigE Vision network driver that is compatible with all network adapters. The advantage of this driver is its extensive compatibility.
AW00011916000 The Basler Filter Driver The Basler filter driver is a basic driver GigE Vision network driver. It is designed to be compatible with most network adapter cards. The functionality of the filter driver is relatively simple. For each frame, the driver checks the order of the incoming packets.
The Basler performance driver uses a "receive window" to check the status of packets. The check for missing packets is made as packets enter the receive window. If a packet arrives from higher in the sequence of packets than expected, the preceding skipped packet or packets are detected as missing.
Page 58
Basler Network Drivers and Parameters AW00011916000 General Parameters Enable Resend - Enables the packet resend mechanisms. If the Enable Resend parameter is set to false, the resend mechanisms are disabled. The performance driver will not check for missing packets and will not send resend requests to the camera.
Page 59
AW00011916000 Basler Network Drivers and Parameters Resend Request Threshold - This parameter determines the location of the resend request threshold within the receive window as shown in Figure 28. The parameter value is in per cent of the width of the receive window. In Figure 28 the resend request threshold is set at 33.33% of the width of the receive window.
Page 60
Basler Network Drivers and Parameters AW00011916000 Timeout Resend Mechanism Parameters The timeout resend mechanism is illustrated in Figure 29 where the following assumptions are made: The frame includes 3000 packets. Packet 1002 is missing within the stream of packets and has not been recovered.
Page 61
AW00011916000 Basler Network Drivers and Parameters Maximum Number Resend Requests - The Maximum Number Resend Requests parameter sets the maximum number of resend requests the performance driver will send to the camera for each missing packet. Resend Timeout - The Resend Timeout parameter defines how long (in milliseconds) the performance driver will wait after detecting that a packet is missing before sending a resend request to the camera.
Page 62
Basler Network Drivers and Parameters AW00011916000 Threshold and Timeout Resend Mechanisms Combined Figure 30 illustrates the combined action of the threshold and the timeout resend mechanisms where the following assumptions are made: All parameters set to default. The frame includes 3000 packets.
Page 63
(12) Interval defined by the Packet Timeout parameter. You can set the performance driver parameter values from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to read and write the parameter values: // Get the Stream Parameters object Camera_t::StreamGrabber_t StreamGrabber( Camera.GetStreamGrabber(0) );...
Page 64
AW00011916000 Adapter Properties When the Basler Performance driver is installed, it adds a set of "advanced" properties to the network adapter. These properties include: Max Packet Latency - A value in microseconds that defines how long the adapter will wait after it receives a packet before it generates a packet received interrupt.
You can set the driver related transport layer parameter values from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to read and write the parameter values: // Read/Write Timeout Camera_t::TlParams_t TlParams( Camera.GetTLNodeMap() );...
The value is in bytes. The value does not affect the leader and trailer size, which use a total of 36 bytes, and the last data packet may be a smaller size. The payload size will be packet size minus 36 bytes. Basler scout GigE...
Page 68
Used to reserve a portion of the assigned bandwidth for packet resends and for the transmission of control data between the camera and the host PC. The setting is expressed as a percentage of the Bandwidth Assigned parameter. For example, if the Bandwidth Assigned parameter indicates that Basler scout GigE...
Page 69
The example also assumes that the camera is operating in a poor environment, so many packets are lost and many resends are required. The numbered text is keyed to the time periods in the chart. Basler scout GigE...
Page 70
15 resends would be required from the accumulator pool, but the pool only has 9 resends. So the 9 resends in the pool are used and 6 resend requests are answered with a "packet unavailable" error code. The accumulator pool is reduced to 0. Basler scout GigE...
Page 71
If software or hardware triggering is being used to control the camera’s frame rate, the maximum frame rate allowed with the current camera settings will be used to calculate the device max throughput. Basler scout GigE...
Page 72
You can read or set the camera’s network related parameter values from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter values: // Payload Size int64_t payloadSize = Camera.PayloadSize.GetValue();...
Page 73
= Camera.GevSCDMT.GetValue(); // Device Current Throughput int64_t currentThroughput = Camera.GevSCDCT.GetValue(); // 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. Basler scout GigE...
If the sum of the bandwidth assigned values is less than 125 MByte/s, the cameras should be able to operate simultaneously without problems. If it is greater, you must lower the data output rate of one or more of the cameras. Basler scout GigE...
If you use the Basler filter driver and have already set network parameters for your network adapter during the installation of the Basler pylon software, continue with step two. Otherwise, open the...
Page 76
Unless you have already set the packet size for your network adapter during the installation of the Basler pylon software, check the documentation for your adapter to determine the maximum packet size (sometimes called “frame” size) that the adapter can handle. Many adapters can handle what is known as “jumbo packets”...
Page 77
To determine the “data bandwidth assigned,” you must subtract out the reserve. Basler scout GigE...
Page 78
If the sum of the Bandwidth Assigned values is greater than 125 MByte/s for a GigE network or 12.5 M/Byte/s for a 100 Bit/s network, the cameras need more bandwidth than is available and you must make adjustments. In essence, you must lower the data bandwidth needed by one or more of the Basler scout GigE...
Page 79
AOI settings on the cameras, you should repeat steps 2 through 6. For more information about the camera’s maximum allowed frame transmission rate, see Section 9.13 on page 167. For more information about the AOI, see Section 12.4 on page 238. Basler scout GigE...
Page 80
Network Related Camera Parameters and Managing Bandwidth AW00011916000 Basler scout GigE...
Exposure start and exposure time can be controlled by parameters transmitted to the camera via the Basler pylon API and the GigE interface. There are also parameters available to set the camera for single frame acquisition or continuous frame acquisition.
Page 82
ExTrig Image Buffer e.g. ExpActive, TrigRdy Image Image Data Data Ethernet Ethernet FPGA Sensor Network Controller Image Image Data Data Control Data Control Micro- Controller Control Control: Data AOI, Gain, Black Level Fig. 33: Camera Block Diagram Basler scout GigE...
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 84
24 MB ExTrig Image Buffer e.g. ExpActive, TrigRdy Image Image Data Data Ethernet Ethernet FPGA Sensor Network Controller Image Image Data Data Control Data Control: Control Gain Black Level Micro- Controller Control Data Fig. 35: Camera Block Diagram Basler scout GigE...
A 12-pin receptacle used to provide access to the camera’s I/O lines and to provide power to the camera. The drawing below shows the location of the two connectors and the LEDs. 12-pin Receptacle 8-pin RJ-45 Jack Green LED Yellow LED Fig. 36: Camera Connectors and LED Basler scout GigE...
8 and 9 on the camera. We also recommend that you provide camera power ground through separate wires between your power supply and pins 1 and 2 on the camera. Basler scout GigE...
AW00011916000 Physical Interface 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 12-pin Receptacle Basler scout GigE...
The 8-pin jack for the camera’s Ethernet connection is a standard RJ-45 connector. The recommended mating connector is any standard 8-pin RJ-45 plug. Cables terminated with screw-lock connectors are available from Basler. Contact your Basler sales representative to order cable assemblies.
The maximum length of the standard power and I/O cable is at least 10 meters. The cable must be shielded and must be constructed with twisted pair wire. Use of twisted pair wire is essential to ensure that input signals are correctly received. Close proximity to strong magnetic fields should be avoided. Basler scout GigE...
Page 90
Physical Interface AW00011916000 The required 12-pin Hirose plug is available from Basler. Basler also offers a cable assembly that is terminated with a 12-pin Hirose plug on one end and unterminated on the other. Contact your Basler sales representative to order connectors or cables.
PLC device, if power for the I/O input is supplied with 24 VDC. 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-10P-12S) on the end that connects to the camera. The other end is unterminated.
Table 8: Voltage Requirements for the Camera Power VCC For more information about the 12-pin connector and the power and I/O cables see Section 7.2 on page 76, Section 7.3 on page 78, and Section 7.4 on page Basler scout GigE...
AW00011916000 Physical Interface Ethernet GigE Device Information The camera uses a standard Ethernet GigE transceiver. The transceiver is fully 100/1000 Base-T 802.3 compliant. Basler scout GigE...
Region where the transition threshold occurs; the logical state is not defined in this region. > +2.2 VDC The voltage indicates a logical 1. Table 9: Voltage Requirements for the I/O Input When Using the Standard Power and I/O Cable Basler scout GigE...
Page 95
> +8.4 to +10.4 VDC Region where the transition threshold occurs; the logical state is not defined in this region. > +10.4 VDC The voltage indicates a logical 1. Table 10: Voltage Requirements for the I/O Input When Using a PLC Power and I/O Cable Basler scout GigE...
For more information about how to use an ExTrig signal to control image acquisition, see Section 9.4.5 on page 116, Section 9.5.3 on page 124 and Section 9.6.3 on page 135. For more information about configuring the input lines, see Section 8.1 on page Basler scout GigE...
Resistance I/O_Out_VCC Camera Your Gnd 12-Pin Receptacle Fig. 40: Typical Voltage Output Circuit By default, the camera’s exposure active (ExpAc) signal is assigned to Output Line 1. The exposure active signal indicates when exposure is taking place. Basler scout GigE...
Page 98
For more information about the trigger ready signal, see Section Section 9.11.3 on page 157 Section 9.11.4 on page 159. For more information about assigning camera output signals to physical output lines, see Section 8.2.1 on page Basler scout GigE...
As an example, t and t were measured for a specific camera, for load currents of 5 mA and on90 off10 50 mA, and voltages between 3.3 V and 24 V. The results are shown on the figure below. Basler scout GigE...
Page 100
off10 increases as the voltage and the load current increase on90 The effects due to different voltages and load currents are more pronounced on t than on off1 on90 Basler scout GigE...
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 GigE...
// Enable the inverter on line 1 Camera.LineSelector.SetValue( LineSelector_Line1 ); 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.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.
If the set minimum output signal width is smaller than the timer duration setting the Minimum Output Pulse Width feature will have no effect. For more information about the Minimum Output Pulse Width feature, see Section 12.12 on page 304. Basler scout GigE...
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.
Page 108
I/O Control AW00011916000 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. Changing the Delay Time Base By default, the Timer Delay Time Base is fixed at 1 µs (minimum value), and the timer delay is...
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 110
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 GigE...
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 112
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. 45: Line Status All Parameter Bits Basler scout GigE...
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 114
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 9.8 on page 144. 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 GigE...
Page 116
"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 GigE...
Page 117
"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. 46: Acquisition Start and Frame Start Triggering Basler scout GigE...
Page 118
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 120
Image Acquisition Control AW00011916000 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 GigE...
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 GigE...
"waiting for acquisition start trigger" acquisition status. At that point, you must apply a new acquisition start trigger signal to exit the camera from the "waiting for acquisition start trigger" acquisition status. For more information about the pylon Viewer, see Section 3.1 on page Basler scout GigE...
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 GigE...
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. 9.4.5 Using a Hardware Acquisition Start Trigger (Standard Mode) 9.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 9.2 on page 105 and Section 9.4 on page 111. Referring to the use case diagrams that appear in Section 9.8 on page 144 can help you understand the explanations of the frame start trigger. Basler scout GigE...
Keep in mind that the camera will only react to frame start triggers when it is in a "waiting for frame start trigger" acquisition status. For more information about the acquisition status, see Section 9.2 on page 105 and Section 9.4 on page 111. Basler scout GigE...
Keep in mind that the camera will only react to frame start triggers when it is in a "waiting for frame start trigger" acquisition status. For more information about the acquisition status, see Section 9.2 on page 105 and Section 9.4 on page 111. Basler scout GigE...
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.
Image Acquisition Control AW00011916000 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 9.5.2 Using a Software Frame Start Trigger (Standard Mode) 9.5.2.1...
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.
// a Trigger Software command will apply a software frame start trigger // signal to the camera You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon Viewer, see Section 3.1 on page 9.5.3...
Fig. 48: Timed Exposure with Rising Edge Triggering Note that if you attempt to trigger a new exposure start while the previous exposure is still in progress, the trigger signal will be ignored, and a Frame Start Overtrigger event will be generated. Basler scout GigE...
Page 136
3000 µs. For more information about the Trigger Ready signal, see Section 9.11.3 on page 157 Section 9.11.4 on page 159. For more information about the camera’s exposure time parameters, see Section 9.7 on page 141. Basler scout GigE...
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 138
// 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 GigE...
When the Trigger Mode parameter for the acquisition start trigger is set to off, the exposure time for each frame acquisition is determined by the camera’s exposure time parameters. For more information about the camera’s exposure time parameters, see Section 9.7 on page 141. Basler scout GigE...
For more information about controlling exposure time when using a software trigger, see Section 9.4.4 on page 115. For more information about controlling exposure time when using a hardware trigger, see Section 9.4.5 on page 116. For more information about exposure time parameters, see Section 9.7 on page 141. Basler scout GigE...
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 9.5.2.2 on page 123 includes more detailed information about applying a software acquisition start trigger to the camera using Basler pylon. For more information about determining the maximum allowed frame rate, see Section 9.13 on page 167 and Section 9.14 on page 171.
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...
For more information about setting the camera for hardware acquisition start triggering and selecting the input line to receive the ExASTrig signal, see Section 9.6.3.4 on page 139. Basler scout GigE...
This situation is illustrated below for rising edge triggering. This rise in the trigger signal will be ignored, and an Acquisition Start Overtrigger event will be generated ExASTrig Signal Exposure (duration determined by the exposure time parameters) Fig. 53: Overtriggering with Timed Exposure Basler scout GigE...
Page 147
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 GigE...
// 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 150
// 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.
For more information about auto functions, see Section 12.9.1 on page 287. For more information about the Exposure Auto function, see Section 12.9.3 on page 296. For information about parameter settings for obtaining the maximum possible exposure time, see Section 9.7.1 on page 142. Basler scout GigE...
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: Camera.ExposureMode.SetValue( ExposureMode_Timed ); Camera.ExposureTimeRaw.SetValue( 100 ); Camera.ExposureTimeBaseAbs.SetValue( 186 ); Basler scout GigE...
AW00011916000 Image Acquisition Control 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 9.7.2...
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 GigE...
Page 155
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 9.5.1.1 on page 119 and for information about setting the parameter, see Section 9.5.1.3 on page 121. Basler scout GigE...
Page 156
= frame exposure and readout = frame transmission Acquisition Acquisition Start Stop Command Command Executed Executed Acquisition Start Trigger Signal Frame Start Trigger Signal Time Fig. 56: Use Case 1 - Acquisition Start Trigger Off and Frame Start Trigger Off Basler scout GigE...
Page 157
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 GigE...
Page 158
= frame transmission Acquisition Acquisition Start Stop Command Command Executed Executed Acquisition Start Trigger Signal Frame Start Trigger Signal (applied to line 1) Time Fig. 57: Use Case 2 - Acquisition Start Trigger Off and Frame Start Trigger On Basler scout GigE...
Page 159
(this avoids the need to store images of an empty toll booth area.) For more information about the Acquisition Frame Rate Abs parameter, see Section 9.5.1.1 on page 119 and for information about setting the parameter, see Section 9.5.1.3 on page 121. Basler scout GigE...
Page 160
= frame transmission Acquisition Acquisition Start Stop Command Command Executed Executed Acquisition Start Trigger Signal (applied to line 1) Frame Start Trigger Signal Time Fig. 58: Use Case 3 - Acquisition Start Trigger On and Frame Start Trigger Off Basler scout GigE...
Page 161
(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 GigE...
Page 162
Acquisition Start Stop Command Command Executed Executed Acquisition Start Trigger Software Command Executed Frame Start Trigger Signal (applied to line 1) Time Fig. 59: Use Case 4 - Acquisition Start Trigger On and Frame Start Trigger On Basler scout GigE...
This situation is illustrated in Figure 61 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 GigE...
For more information about using the Trigger Ready signal with all camera models except the scA750-60 gm/gc, see Section 9.11.3 on page 157. Basler scout GigE...
"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. 9.10 Exposure Must Not Overlap Sensor...
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:...
Image Acquisition Control Camera.LineSelector.SetValue( LineSelector_Out1 ); Camera.LineSource.SetValue( LineSource_ExposureActive ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about changing the assignment of camera output signals to physical output lines, see Section 8.2.1 on page For more information about the electrical characteristics of the camera’s output lines, see...
Page 168
The trigger ready signal will only be available when hardware triggering is enabled. By default, the trigger ready signal is assigned to physical output line 2 on the camera. However, the assignment of the trigger signal to a physical output line can be changed. Basler scout GigE...
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 170
For more information about changing the assignment of camera output signals to physical output lines, see Section 8.2.1 on page For more information about the electrical characteristics of the camera’s output lines, see Section 7.7.2 on page Basler scout GigE...
Page 171
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 66 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 GigE...
Page 173
Frame Acquisition Exp. Readout Time = Camera is in a "waiting for acquisition start trigger" status Fig. 66: Acquisition Trigger Wait Signal The acquisition trigger wait signal will only be available when hardware acquisition start triggering is enabled. Basler scout GigE...
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 176
Also note that the frame transmission cannot be less than the frame readout time. So if the frame transmission time formula returns a value that is less than the readout time, the approximate frame transmission time will be equal to the readout time. Basler scout GigE...
Resulting Frame Rate parameter. This parameter indicates the camera’s current maximum allowed frame rate taking the AOI, exposure time, and bandwidth settings into account. For more information about the acquisition mode, see Section 9.2 on page 105 and Section 9.3 on page 109. Basler scout GigE...
Page 178
(AOI Height + 1) C Where: AOI Height = the height of the acquired frames as determined by the AOI Height settings. The constants C and C depend on the camera model as shown in the table below: Basler scout GigE...
Page 179
For more information about setting the exposure time, see Section 9.7 on page 141. Formula 3: Calculates the maximum frame rate based on the frame transmission time: Device Current Throughput Parameter Value Max. Frames/s ------------------------------------------------------------------------------------------------------------------------ Payload Size Parameter Value Basler scout GigE...
Page 180
240000 Max Frames/s = 458.3 frames/s Formula one returns the lowest value. So in this case, the limiting factor is the sensor readout time, and the maximum allowed acquisition frame rate would be 84.4 frames per second. Basler scout GigE...
AOI, exposure time, and bandwidth settings into account. For more information about AOI settings, see Section 12.4 on page 238. For more information about the Resulting Frame Rate parameter, see Section 5.1 on page Basler scout GigE...
Page 182
AOI Height = the height of the acquired frames as determined by the AOI Height settings. The constants C and C depend on the camera model as shown in the table below: scA750-60 gm/gc 30.99 µs 185.93 µs For more information about setting the exposure time, see Section 9.7 on page 141. Basler scout GigE...
Page 183
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.4 frames per second. Basler scout GigE...
Page 184
Image Acquisition Control AW00011916000 Basler scout GigE...
"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.) Basler scout GigE...
Page 186
Color Creation and Enhancement AW00011916000 Sensor Pixels Fig. 68: Bayer Filter Pattern Basler scout GigE...
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 12.4 on page 238. Basler scout GigE...
U = - 0.17 R - 0.33 G + 0.50 B 0.50 R - 0.41 G - 0.09 B Once the conversion to a YUV color model is complete, the pixel data is transmitted to the host PC. Basler scout GigE...
Page 189
Mono 8, it outputs an 8 bit monochrome image. (This type of output is sometimes referred to as "Y Mono 8".) For complete details of the Mono 8 format, see Section 11.3 on page 205. Basler scout GigE...
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 GigE...
For this reason, we don’t normally recommend setting a balance ratio less than 1 unless you want to correct for the strong predominance of one color. Basler scout GigE...
Page 192
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 );...
You can enable or disable the gamma correction feature by setting the value of the Gamma Enable parameter. You can use the Gamma Selector to select either sRGB or user gamma correction. If you select user gamma correction, you can use the Gamma parameter to set the gamma correction value. Basler scout GigE...
Page 194
You can set the Gamma Enable parameter, use the Gamma Selector, and set Gamma parameter values from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter values for sRGB type correction: // Enable the Gamma feature Camera.GammaEnable.SetValue( true );...
Tungsten - This setting will automatically populate the matrix with a pre-selected set of values that will make appropriate corrections for images captured with tungsten lighting that has a color temperature of about 2500K to 3000K. When you select this setting, the camera will also Basler scout GigE...
Page 196
You can set the Processed Raw Enable, Color Transformation Selector and Light Source Selector parameter values from within your application software by using the Basler pylon API. In this example, we assume that you want to set your camera for Bayer BG 8 output, and therefore you must set the Processed Raw Enable parameter value to enabled.
( LightSourceSelector_Daylight6500K ); // Set the matrix correction factor Camera.ColorTransformationMatrixFactor.SetValue( 0.50 ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on page 10.3.3.1 The Custom Light Source Setting...
Page 198
// Select a position in the matrix Camera.ColorTransformationValueSelector.SetValue ( ColorTransformationValueSelector_Gain12 ); // Set the value for the selected position as an integer value Camera.ColorTransformationValueRaw.SetValue( 135 ); You can also use the Basler pylon Viewer application to easily set the parameters. Basler scout GigE...
For ease of imagination, the color cube can be projected onto a plane (as shown in Figure 69) such that a color hexagon is formed. The primary and secondary colors define the corners of the color Basler scout GigE...
Page 200
present. At minimum saturation, no "color" but only some shade of gray (including black and white) is present. White Black Fig. 69: RGB Color Cube With YCM Secondary Colors, Black, and White, Projected On a Plane Basler scout GigE...
Page 201
For example, if saturation for red is increased, the colorfulness of red colors in the image will increase. If red is set to minimum saturation, red will be replaced by gray for "red" colors in the image. Basler scout GigE...
Page 202
Adjustment Saturation Raw parameter values from within your application software by using the Basler pylon API. In this example, we assume that you want to set your camera for Bayer BG 8 output, and therefore you must set the Processed Raw Enable parameter value to enabled.
Page 203
// Set the cyan saturation as an integer value Camera.ColorAdjustmentSaturationRaw.SetValue( 176 ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on...
Since it makes changing camera parameters quick and easy, we also recommend using the Basler pylon Viewer software when you are making adjustments. 1. Arrange your camera so that it is viewing a scene similar to what it will view during actual oper- ation.
Page 208
Camera.PixelFormat.SetValue( PixelFormat_BayerBG8 ); 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 Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
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 GigE...
Page 211
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 GigE...
Page 213
“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 GigE...
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 11.3.7 on page 217. Basler scout GigE...
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 GigE...
Page 216
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 GigE...
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 GigE...
Page 218
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 GigE...
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 GigE...
Page 220
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 GigE...
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 GigE...
Page 222
“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 GigE...
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 GigE...
= the last pixel transmitted by the camera = the first byte in the buffer = the last byte in the buffer Byte Data U value for P Y value for P V Value for P Y value for P Basler scout GigE...
Page 225
The pixel data output for the U component or the V component 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. Basler scout GigE...
Page 226
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 GigE...
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 GigE...
Page 228
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 GigE...
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 GigE...
Page 232
Pixel Data Formats AW00011916000 Basler scout GigE...
Fig. 71: 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 GigE...
Page 234
Max Setting with Vertical (8 bit depth) (16 bit depth) Binning scA640-70 1023 scA640-74 1023 scA640-120 scA780-54 1023 scA1000-30 1023 scA1300-32 scA1390-17 1023 scA1400-17 1023 scA1400-30 scA1600-14 1023 scA1600-28 Table 17: Minimum and Maximum Allowed Gain Raw Settings Basler scout GigE...
Page 235
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 236
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 18 shows the minimum and maximum gain in dB for each camera model. Basler scout GigE...
Page 237
(16 bit depth) scA640-70 scA640-74 28.3 10.1 scA640-120 23.34 8.98 scA780-54 25.9 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 18: Minimum and Maximum dB of Gain Basler scout GigE...
Page 238
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 239
------- - Gain 12.0 dB Table 19 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 19: dB of Gain at Various Settings Basler scout GigE...
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 GigE...
Page 241
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.
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 GigE...
Page 243
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 GigE...
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 GigE...
Page 245
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 GigE...
If all of the readings are below 32, you can safely use the shift by 1, 2, or 3 settings. If all of the readings are below 16, you can safely use the shift by 1, 2, 3, or 4 settings. Basler scout GigE...
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 );...
One of the main advantages of the AOI feature is that decreasing the height of the AOI can increase the camera’s maximum allowed acquisition frame rate. For more information about how changing the AOI height effects the maximum allowed frame rate, see Section 9.13 on page 167. Basler scout GigE...
Page 249
Normally, the X Offset, Y Offset, Width, and Height parameter settings refer to the physical columns and rows in the sensor. But if binning is enabled, these parameters are set in terms of "virtual" columns and rows. For more information, see Section 12.6 on page 275. Basler scout GigE...
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( );...
The values of the sequence parameters, however, can be set very quickly by using sequence sets: Because the sequence sets reside in the camera, you can replace the values in the active set with values from one of the sequence sets almost Basler scout GigE...
Page 252
Sequence Parameters, Set by the Current Set Sequence Enable Load / Store Sequence Set 0 Sequence Set 1 Sequence Set 2 Sequence Set N Sequence Sequence Set Advance Mode Index Number Fig. 73: Sequence Feature Block Diagram Basler scout GigE...
Page 253
Viewer. Only those sequence parameter values will be displayed that were active before the sequencer was enabled. You will not be able to "see" the parameter values set by the current set. Make sure the sequencer feature is disabled when configuring sequence sets. Basler scout GigE...
Page 254
"sychronous restart" because the checking of the states of an input line is always linked to a frame trigger signal. Advance or restart controlled by a software command are also called "asychronous advance" and "asychronous restart" because they are not linked to a frame start trigger signal. Basler scout GigE...
Page 255
Accordingly, the number of image acquisitions that may occur between sending the command and it becoming effective can not be predicted. The Sequence Set Load command is therefore not suitable for real-time applications, it may, however, be useful for testing purposes. Basler scout GigE...
// Load the sequence parameter values from the sequence set into the active set Camera.SequenceSetLoad.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameters. Use Case Diagrams Illustrating Sequencer Operation The sections below explain the sequence advance modes in detail. Use case descriptions and diagrams are designed to illustrate how the sequence advance modes work in some common situations and with some common combinations of parameter settings.
Page 257
Executions parameter value. Because the Sequence Set Executions parameter was set to 2 for sequence set 5, this sequence set is used a second time: The parameter values of sequence set 5 are used for the image acquisition. Basler scout GigE...
Page 258
(the sequence set index number is indicated) = frame exposure and readout = frame transmission Sequencer Sequence Set Cycle Sequencer Enabled Starts Again Disabled Frame Start Trigger Signal Time Fig. 74: Sequencer in Auto Sequence Advance Mode Basler scout GigE...
Page 259
Camera.SequenceEnable.SetValue( true ); // Disable the sequencer feature Camera.SequenceEnable.SetValue( false ); You can also use the Basler pylon Viewer application to easily set the parameters. Configuring Sequence Sets Use the following procedure for populating sequence sets and making the related settings: 1.
Page 260
// Set the number of sequence set uses Camera.SequenceSetExecutions.SetValue( 4 ); // Store the sequence parameter values from the active set in the selected sequence // set Camera.SequenceSetStore.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameters. Basler scout GigE...
Disabled: The advance from one sequence set to the next is only controlled by AsyncAdvance software commands. The Sequence Set Total Number parameter specifies the total number of different sequence sets that are available and included within a sequence set cycle. The maximum number is 64. Basler scout GigE...
0 is used. After the sequencer feature is disabled, the cycling through sequence sets is terminated. The sequencer parameter values in the active set return to the values that existed before the sequencer feature was enabled. Basler scout GigE...
Page 263
When a frame start trigger is received, the camera automatically advances to the next sequence set: The parameter values of sequence set 1 are loaded into the active set and are used for the Basler scout GigE...
Page 264
When the next frame start triggers were received, the camera advances to the next sequence sets and uses them for image acquisition in accord with the Always Active sequence control source and as described in the previous use case. Basler scout GigE...
Page 265
Sequence Set Cycle Sequence Set Cycle (Restart) Starts Again Starts Again Frame Start Trigger Signal Time Fig. 76: Sequencer in Controlled Sequence Advance Mode with Always Active as the Sequence Control Source and Synchronous Restart Controlled by Line 1 Basler scout GigE...
Also, maintain the states of the input lines at least for one microsecond after the frame start trigger signal has risen. Basler scout GigE...
Page 267
Input line 1 is found to be high and therefore the parameter values of the next sequence set are loaded into the active set. The parameter values of sequence set 0 are used for the image acquisition. Basler scout GigE...
Page 268
In the following use case (see also Figure 78), the same settings were made as 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 triggering. Basler scout GigE...
Page 269
Note also that the camera briefly exits the "waiting for frame start trigger" status while an input line changes its state. This happened, for example, when input line 2 changed its state before the fourth frame start trigger was received (see also Figure 78). Basler scout GigE...
Page 270
1. Input line 2 is found to be low and therefore the sequence cycle is not restarted. Input line 1 is found to be low and therefore no new sequence parameter values are loaded into the active set. The parameter values of sequence set 1 are used for the image acquisition. Basler scout GigE...
Page 271
Sequence Set Cycle (Advance) Starts Again Starts Again Frame Start Trigger Signal Time Fig. 78: Sequencer in Controlled Sequence Advance Mode with Line 1 as the Sequence Control Source and Syn- chronous Restart Controlled by Line 2 Basler scout GigE...
When the next frame start trigger is received, the camera checks the active set and uses it for the image acquisition. The parameter values of sequence set 0 are used. The AsyncAdvance command has not yet become effective because of the assumed associ- Basler scout GigE...
Page 273
The parameter values of sequence set 0 are loaded into the active set. Note that the camera briefly exits the "waiting for frame start trigger" status while the parameter values of sequence set 1 are loaded into the active set (see also Figure 79). Basler scout GigE...
Page 274
While frame exposure and readout are in progress, the sequencer feature is disabled. The complete frame is transmitted and the cycling through sequence sets is terminated. The sequencer parameter values in the active set return to the values that existed before the sequencer feature was enabled. Basler scout GigE...
Page 275
= frame exposure and readout = frame transmission Sequencer Sequencer Enabled Disabled Sequence Set Cycle Starts Again Time Fig. 79: Sequencer in Controlled Sequence Advance Mode with Disabled as the Sequence Control Source and Asynchronous Advance and Restart Basler scout GigE...
Camera.SequenceEnable.SetValue( true ); // Disable the sequencer feature Camera.SequenceEnable.SetValue( false ); You can also use the Basler pylon Viewer application to easily set the parameters. 12.5.2.4 Configuration Configuring Sequence Sets and Advance Control Use the following procedure for populating sequence sets and setting the sources for sequence set advance and sequence cycle restart: Make sure that the sequencer feature is disabled.
Page 277
For information about setting the input line for invert, see Section 8.1.3 on page Configuring Sequence Sets and Advance Control Using Basler pylon You can use the pylon API to set the parameters for configuring sequence sets from within your application software.
Page 278
// Select sequence set with index number 0 Camera.SequenceSetIndex.SetValue( 0 ); // Load the sequence parameter values from the sequence set into the active set Camera.SequenceSetLoad.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameters. Basler scout GigE...
Note also that the camera briefly exits the "waiting for frame start trigger" status while an input line changes its state. This happened, for example, when input line 1 changed its state before the first frame start trigger was received (see also Figure 80). Basler scout GigE...
Page 280
While frame exposure and readout for the fifth frame start trigger are in progress, the sequencer feature is disabled. The complete frame is transmitted. The sequencer parameter values in the active set return to the values that existed before the sequencer feature was enabled. Basler scout GigE...
Page 281
Trigger Signal Time Fig. 80: Sequencer in Free Selection Mode Operating the Sequencer Using Basler pylon You can use the pylon API to set the parameters for operating the sequencer in Free Selection sequence advance mode from within your application software.
Page 282
// Disable the sequencer feature Camera.SequenceEnable.SetValue( false ); You can also use the Basler pylon Viewer application to easily set the parameters. Selecting Sequence Sets Each sequence set is identified by a sequence set index number, starting from zero. The states of the input lines select between the sequence sets by setting the (big endian) sequence set addresses.
9. Repeat the above steps for the other sequence sets, starting from step 5. Configuring Sequence Sets and Sequence Set Advance Using Basler pylon You can use the pylon API to set the parameters for configuring sequence sets from within your application software and make settings for their selection when images are acquired.
Page 284
// adjust the camera parameters for the best image quality. // Store the sequence parameter values from the active set in the selected // sequence set Camera.SequenceSetStore.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameters. Basler scout GigE...
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 82 illustrates horizontal bin- ning. Horizontal Binning by 2 Horizontal Binning by 3 Horizontal Binning by 4 Fig. 82: Horizontal Binning Basler scout GigE...
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 287
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 appear on page 166, page 168 and. Basler scout GigE...
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 GigE...
Page 289
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 12.9 on page 287. Basler scout GigE...
Page 290
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 GigE...
Page 292
Fig. 85: 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. 86: Lookup Table with Values Mapped for Higher Camera Output at Low Sensor Readings Basler scout GigE...
Page 293
// 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.
1022 in the table. The advantage of the luminance lookup table feature is that it allows a user to customize the response curve of the camera. The graphs on the next page show the effect of two typical lookup Basler scout GigE...
Page 295
10 Bit Sensor Reading Fig. 87: Lookup Table with Values Mapped in a Linear Fashion 1023 10 Bit Mapped Value 1023 10 Bit Sensor Reading Fig. 88: Lookup Table with Values Mapped for Higher Camera Output at Low Sensor Readings Basler scout GigE...
Page 296
// 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.
For example, with a short exposure time, insufficient illumination, and a low setting for the upper limit of the gain parameter value, the Gain Auto function may not be able to achieve the current target average gray value setting for the image. Basler scout GigE...
When an auto function is set to "off", the parameter value resulting from the latest automatic adjustment will operate, unless the parameter is manually adjusted. You can enable auto functions and change their settings while the camera is capturing images ("on the fly"). Basler scout GigE...
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. 89: Auto Function Area of Interest and Image Area of Interest Basler scout GigE...
Page 300
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 GigE...
Page 301
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. 90: Various Degrees of Overlap Between the Auto Function AOI and the Image AOI Basler scout GigE...
Page 302
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 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 GigE...
Page 305
// 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 GigE...
Page 307
// 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 310
Standard Features AW00011916000 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 12.9 on page 287.
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. 91: Filtering of Input Signals by the Debouncer Basler scout GigE...
Page 313
// 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.
You can set the Line Selector and the value of the MinOutPulseWidthAbs parameter from within your application software by using the pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Basler scout GigE...
Page 315
// Set the parameter value to 10.0 microseconds Camera.MinOutPulseWidthAbs.SetValue(10.0); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
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 GigE...
Page 317
// 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 GigE...
Page 319
AW00011916000 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 9.1 on page 103. Basler scout GigE...
During the time that the camera is waiting for an acknowledgement, no new event messages can be transmitted. 4. Event Reporting involves some further software-related steps and settings to be made. For more information, see the "Camera Events" code sample included with the pylon software development kit. Basler scout GigE...
Page 321
4. As soon as transmission time is available, an event message containing the event overrun event will be transmitted to the PC. The event overrun event is simply a warning that events are being dropped. The notification contains no specific information about how many or which events have been dropped. Basler scout GigE...
Page 322
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 324
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 GigE...
Page 325
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 GigE...
Page 326
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. 94: Test Image Six Basler scout GigE...
Device User ID (read / write) - is used to assign a user defined name to a device. This name will be displayed in the Basler pylon Viewer and the Basler pylon IP Configuration Tool. The name will also be visible in the "friendly name" field of the device information objects returned by pylon’s device enumeration procedure.
Page 328
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 User ID.
"startup" set, i.e., the set that will be loaded into the active set whenever the camera is powered on or reset. Instructions for loading the default set into the active set and for designating which set will be the startup set appear later in the Configuration Sets section. Basler scout GigE...
Execute a User Set Save command to save the active set to the selected user set. Saving an active set to a user set in the camera’s non-volatile memory will overwrite any parameters that were previously saved in that user set. Basler scout GigE...
Functions Factory Setup or Color 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);...
Page 332
The standard factory setup is optimized for use in typical situations and will provide good camera performance in most cases. Basler scout GigE...
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 GigE...
The camera description file is included in the camera and describes the camera features in accord with the GenICam specification. scout GigE cameras include two camera description files that are used alternatively. The camera description files represent partially different combinations of features (feature sets).
Page 336
CEnumerationPtr ptrFeatureSet( Camera.GetNodeMap().GetNode("FeatureSet")); ptrFeatureSet->FromString("Full"); 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. For more information about the pylon Viewer, see Section 3.1 on...
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 GigE...
Set the Chunk Mode Active parameter to true. You can set the Chunk Mode Active parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter value: Camera.ChunkModeActive.SetValue( true );...
Page 339
= Camera.ChunkHeight.GetValue(); int64_t dynamicRangeMin = Camera.ChunkDynamicRangeMin.GetValue(); int64_t dynamicRangeMax = Camera.ChunkDynamicRangeMax.GetValue(); ChunkPixelFormatEnums pixelFormat = Camera.ChunkPixelFormat.GetValue(); For more information about using the chunk parser, see the sample code that is included with the Basler pylon Software Development Kit (SDK). Basler scout GigE...
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 341
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 342
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 GigE...
// 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 IChunkParser &ChunkParser = *Camera.CreateChunkParser(); GrabResult Result; StreamGrabber.RetrieveResult( Result ); ChunkParser.AttachBuffer( (unsigned char*) Result.Buffer(), Result.GetPayloadSize() ); int64_t timeStamp = Camera.ChunkTimestamp.GetValue(); Basler scout GigE...
Page 344
Chunk Features AW00011916000 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...
// 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 GigE...
Page 346
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 347
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 GigE...
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 GigE...
Page 349
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 351
( 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.
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 353
AW00011916000 Chunk Features Result.GetPayloadSize() ); int64_t timeStamp = Camera.ChunkSequenceSetIndex.GetValue(); You can also use the Basler pylon Viewer application to easily set the parameters. Basler scout GigE...
Page 354
Chunk Features AW00011916000 Basler scout GigE...
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.
14.3 Before Contacting Basler Technical Support To help you as quickly and efficiently as possible when you have a problem with a Basler camera, it is important that you collect several pieces of information before you contact Basler technical support.
Page 357
Parameter set It is very important for Basler technical support to get a copy of the exact camera parameters that you were using when the problem occurred. To make note of the parameters, use Basler’s pylon Viewer tool.
Page 358
Troubleshooting and Support AW00011916000 Basler scout GigE...
Added Section 1.5 on page 24 with information on mechanical stress test results. Modified Section for the installation of the Basler pylon software, version 1.0. Added information on the 8 bits effective pixel data: Section 11.2.1 on page 199, Section 11.2.4 on page 204, Section 11.2.5 on...
Page 360
Added guidelines for avoiding EMI and ESD problems in Section 2.3.1 on page Replaced recommendations of individual adapters by a reference to Basler technical support in Section 4.1 on page 67.. Removed web link for further information on APIPA in Section 5.3 on page Corrected the voltage ranges relating to logic 0 and logic 1 in Section 7.7.1...
Page 361
Included the warning related to code snippets in Section 1.9 on page Transferred the following sections to the "Installation and Setup Guide for Cameras Used with Basler’s pylon API" (AW000611xx000): "Software and Hardware Installation", "Network Recommendations", and "Camera and Network Adapter IP Configuration".
Page 362
Section 2 on page 41 and Section 3 on page 43 has been revised to reflect that the pylon driver package is now downloadable from the website. Added Section 13.2 on page 245 describing how to obtain an RMA number. Basler scout GigE...
Page 363
Section 13.3 on page 330. Corrected the maximum value for the frame counter in Section 13.3 on page 330. Added the trigger input counter feature in Section 13.5 on page 335. Basler scout GigE...
Page 364
Added events and parameter names in Section 12.15 on page 310, and removed some descriptions for transfer to the "Camera Events" code sample. Rearranged sequence of sections 8 through 11. Removed the feedback page. Basler scout GigE...
Page 365
Removed the "Typical LED Output Signal..." figure from Section 7.7.2.2 on page Simplified the definition of response times, removed ranges of response time values, included a measured example, indicated general dependences of response times, and removed the "I/O Line Schematic" figure in Section 7.7.3 on page Basler scout GigE...
Page 366
Date Changes AW00011916000 14 Dec 2012 Indicated Basler AG as bearer of the copyright on the second page. Added information about the 90° head housing model for the scA1600- 28gm/gc in Section 1.2 on page 2 and Section 1.5.2.2 on page Removed abs.
Page 367
AW00011916000 Revision History Basler scout GigE...
Page 368
Revision History AW00011916000 Basler scout GigE...
......288 camera power requirements ....... auto function AOI ...........2 explained .........287 chunk dynamic range max parameter .. 329 setting ..........292 chunk dynamic range min parameter ... 329 auto function profile .......298 chunk enable parameter ............330 Basler scout GigE...
Page 370
....142 default configuration set ......319 extended image data chunk ....328 device current throughput parameter ..62 device firmware version parameter ..317 device ID parameter ......317 device manufacturer info parameter ..317 Basler scout GigE...
Page 371
..........256 heartbeat timer ........55 line status all chunk ......338 high gain factory setup ....319 line status parameter ......101 horizontal binning ........275 lookup table ........281 horizontal mirror image ......278 luminance lookup table ....281 housing Basler scout GigE...
Page 373
.......122 use case diagrams ......144 – spectral response ......12 user configuration set ......320 speed and duplex mode parameter ..66 user output selector ........ 94 squence set user output value parameter ....94 address ...........269 Basler scout GigE...
Page 374
........3 white balance ........181 setting ..........181 white balance auto see balance white auto write timeout parameter ......55 YUV 422 (YUYV) packed pixel format ...............204 YUV 422 data range ......215 YUV 422 packed pixel format ..204 Basler scout GigE...
Need help?
Do you have a question about the scout GigE and is the answer not in the manual?
Questions and answers