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...
Ethernet GigE Device Information ........42 Basler ace GigE...
Page 6
Introduction ......... . . 74 7.3.5.2 Setting the Parameters Related to Hardware Acquisition Start Triggering and Applying a Hardware Trigger Signal..74 Basler ace GigE...
Page 7
7.12 Maximum Allowed Frame Rate......... . 126 7.12.1 Using Basler pylon to Check the Maximum Allowed Frame Rate ..127 7.12.2 Increasing the Maximum Allowed Frame Rate .
We strongly recommend that you read and follow the precautions. Models The current Basler ace 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.
~ 2.7 W @ 12 VDC when supplied via ~ 2.0 W @ 12 VDC when supplied via the camera’s 6-pin connector the camera’s 6-pin connector Note: When using extremely small AOIs, power consumption may increase to 2.4 W. Table 1: General Specifications Basler ace GigE...
Page 13
CE, UL (in preparation), FCC, GenICam, GigE Vision, IP30, RoHS, PoE 802.3 af Software Driver Basler’s GigEVision compliant pylon SDK including filter and performance drivers. Available for windows or Linux in 32 and 64 bit versions. Table 1: General Specifications...
Page 14
YUV 4:2:2 (YUYV) Packed ADC Bit Depth 12 bits Synchronization Via external trigger signal, via the Ethernet connection, or free run Exposure Control Via external trigger signal or programmable via the camera API Table 2: General Specifications Basler ace GigE...
Page 15
CE, UL (in preparation), FCC, GenICam, GigE Vision, IP30, RoHS, PoE 802.3 af Software Driver Basler’s GigEVision compliant pylon SDK including filter and performance drivers. Available for windows or Linux in 32 and 64 bit versions. Table 2: General Specifications...
Page 16
C-mount Size (L x W x H) 42.0 mm x 29 mm x 29 mm (without lens adapter or connectors) 60.3 mm x 29 mm x 29 mm (with lens adapter and connectors) Table 3: General Specifications Basler ace GigE...
Page 17
Conformity CE, UL (in preparation), FCC, GenICam, GigE Vision, IP30, RoHS Software Driver Basler’s GigEVision compliant pylon SDK including filter and performance drivers. Available for windows or Linux in 32 and 64 bit versions. Table 3: General Specifications Basler ace GigE...
Spectral Response 1.3.1 Mono Camera Spectral Response The following graphs show the spectral response for each available monochrome camera model. The spectral response curves exclude lens characteristics and light source characteristics. Wavelength (nm) Fig. 1: acA640-90gm Spectral Response Basler ace GigE...
700 ... 720 nm, and it should cut off from 700 ... 720 nm to 1100 nm. A suitable IR cut filter is built into the standard C-mount lens adapter on color models of the camera. Blue Green Wavelength (nm) Fig. 7: acA640-90gc Spectral Response Basler ace GigE...
Page 23
Specifications, Requirements, and Precautions Blue Green Wavelength (nm) Fig. 8: acA640-100gc Spectral Response Cyan Magenta Yellow Green Wavelength (nm) Fig. 9: acA750-30gc Spectral Response Basler ace GigE...
Page 24
Specifications, Requirements, and Precautions Blue Green 4 00 5 00 60 0 Wavelength (nm) Fig. 10: acA1300-30gc Spectral Response Blue Green Wavelength (nm) Fig. 11: acA1600-20gc Spectral Response Basler ace GigE...
Page 25
Specifications, Requirements, and Precautions Blue Green 35 0 Wavelength (nm) Fig. 12: acA2500-14gc Spectral Response Basler ace GigE...
2x M2; 4 deep Bottom M3; 3 deep 2x M2; 3 deep 2x M2; 3 deep 2x M3; 3 deep 16.5 22 (dimension for M2) 17.526 Photosensitive surface of the sensor Fig. 13: Mechanical Dimensions (in mm) Basler ace 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 ace GigE...
Use suitable clothing (cotton) and shoes. Control the humidity in your environment. Low humidity can cause ESD problems. The Basler application note called Avoiding EMI and ESD in Basler Camera Installations provides much more detail about avoiding EMI and ESD.
You must provide sufficient heat dissipation to maintain the temperature of the camera housing at 50 °C or less. Since each installation is unique, Basler does not supply a strictly required technique for proper heat dissipation. Instead, we provide the following general guidelines: In all cases, you should monitor the temperature of the camera housing and make sure that the temperature does not exceed 50 °C.
An incorrect plug can damage the 6-pin connector. The plug on the cable that you attach to the camera’s 6-pin connector must have 6 female pins. Using a plug designed for a smaller or a larger number of pins can damage the connector. Basler ace GigE...
Page 32
3. 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 33
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 ace GigE...
Page 34
Specifications, Requirements, and Precautions Basler ace GigE...
More extensive information about how to perform complicated installations 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 Downloads section of our website: www.baslerweb.com...
API. The Pylon Driver Package The Basler pylon Driver Package is designed to operate all Basler cameras that have an IEEE 1394a interface, an IEEE 1394b interface, or a GigE interface. It will also operate some newer Basler camera models with a Camera Link interface.
The pylon IP Configuration Tool is included in Basler’s pylon Driver Package. The 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.
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 41
Exposure Active Signal or Buffer Timer 1 Signal Image Image Data Data Ethernet Ethernet Sensor FPGA Network Controller Image Image Data Data Control Data Control Micro- Controller Control Control: Data AOI, Gain, Black Level Fig. 17: Camera Block Diagram Basler ace 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 43
Flash Window Signal or Timer 1 Signal Image Image Data Data Ethernet Ethernet Sensor FPGA Network Controller Image Data Image Data Control Data Control Control: AOI, Gain, Black Level Control Data Micro- Controller Fig. 19: Camera Block Diagram Basler ace GigE...
Page 44
Camera Functional Description Basler ace GigE...
A 6-pin receptacle used to provide access to the camera’s I/O lines and to provide power to the camera (if PoE is not used). Figure 20 shows the location of the two connectors. 8-pin RJ-45 Jack 6-pin Receptacle Fig. 20: Camera Connectors Basler ace GigE...
I/O Out 1 I/O Ground DC Camera Power Ground Table 4: Pin Assignments for the 6-pin Receptacle The pin numbering for the 6-pin receptacle is as shown in Figure 21. Fig. 21: Pin Numbering for the 6-pin Receptacle Basler ace 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 ace GigE...
Page 49
Physical Interface The required 6-pin Hirose plug is available from Basler. Basler also offers a cable assembly that is terminated with a 6-pin Hirose plug on one end and unterminated on the other. Contact your Basler sales representative to order connectors or cables.
Close proximity to strong magnetic fields should be avoided. Basler offers a PLC power and I/O cable that is terminated with a 6-pin Hirose plug (HR10A-7P-6S) on the end that connects to the camera. The other end is unterminated. Contact your Basler sales representative to order the cable.
Using a plug designed for a smaller or a larger number of pins can damage the connector. For more information about the 6-pin connector and the power and I/O cables see Section 5.2 on page 36, Section 5.3 on page 37, and Section 5.4 on page Basler ace GigE...
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 ace GigE...
> +10.4 VDC The voltage indicates a logical 1. +30.0 VDC Absolute maximum; the camera may be damaged when the absolute maximum is exceeded. Table 6: Voltage Requirements When Using a PLC Power and I/O Cable Basler ace GigE...
5 mA and 15 mA. Fig. 23: Input Line Schematic Figure 24 shows an example of a typical circuit you can use to input a signal into the camera. Fig. 24: Typical Input Circuit Basler ace GigE...
(8.4 V with PLC cable) Time Level of Camera’s Internal Input Circuit Fig. 25: Input Line Response Times Time Delay Rise (TDR) = 1.3 µs to 1.6 µs Time Delay Fall (TDF) = 40 µs to 60 µs Basler ace GigE...
A low output signal from the camera results in a non-conducting Q1 transistor in the output circuit. A high output signal from the camera results in a conducting Q1 transistor in the output circuit. Fig. 26: Output Line Schematic Basler ace GigE...
Page 58
For more information about the invert function on the output, see Section 6.2.3 on page Figure 27 shows a typical circuit you can use to monitor the output line with a voltage signal. Fig. 27: Typical Voltage Output Circuit Basler ace GigE...
Page 59
Output Line 1, see Section 6.2.1 on page For more information about output line pin assignments and pin numbering, see Section 5.2 on page For more information about the Exposure Active signal, see Section 7.10 on page 110. Basler ace GigE...
Section 11.3 on page 244. For more information about the electrical characteristics of the input line, see Section 5.7 on page By default, input line 1 is selected as the source signal for the frame start trigger. Basler ace GigE...
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. 30: Filtering of Input Signals by the Debouncer Basler ace GigE...
You can set the Line Selector and the value of the Line Debouncer Abs parameter 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: // Select the input line Camera.LineSelector.SetValue( LineSelector_Line1 );...
1. 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 );...
You can set the Output Selector and the User Output Value parameters from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to designate the output line as user settable and to set the state of the output line: // Set output line 1 to user settable Camera.LineSelector.SetValue( LineSelector_Out1 );...
You can set the Line Selector and the Line Inverter 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 value: // Enable the inverter on output line 1 Camera.LineSelector.SetValue( LineSelector_Out1 );...
You can set the Trigger Selector and the Timer Trigger 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.TimerSelector.SetValue( TimerSelector_Timer1 );...
1 µs increments. You can set the Timer Delay Time Base 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 parameter value: Camera.TimerDelayTimebaseAbs.SetValue( 5 );...
Page 69
You can set the Timer Selector and the Timer Delay 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.TimerSelector.SetValue( TimerSelector_Timer1 );...
1 µs increments. You can set the Timer Delay Time Base 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 parameter value: Camera.TimerDelayTimebaseAbs.SetValue( 5 );...
Page 71
You can set the Timer Selector and the Timer Duration 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.TimerSelector.SetValue( TimerSelector_Timer1 );...
You can set the Line Selector and read the Line Status 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 read the parameter value: // Select output line 1 and read the state Camera.LineSelector.SetValue( LineSelector_Out1 );...
If the Acquisition Mode parameter is set to "continuous frame", an Acquisition Start command does not expire after a single frame is captured. Once an Acquisition Start command has been executed, you can acquire as many frames as you like. The Acquisition Start command will remain in effect Basler ace GigE...
Page 74
If the Trigger Mode parameter for the frame start trigger is set to on, you must trigger frame start by applying frame start trigger signals to the camera. Each time a trigger signal is applied, the camera will begin a frame exposure. When frame start is being triggered in this manner, it is important that Basler ace GigE...
Page 75
1 will be used as the source for the selected trigger signal. At that point, each time a proper electrical signal is applied to input line 1, an occurance of the selected trigger signal will be recognized by the camera. Basler ace GigE...
Page 76
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.
"overlapped" exposure. To achieve the maximum possible possible acquisition frame rate, set the camera for the continuous acquisition mode and use "overlapped" exposure. For more information about overlapped exposure, see Section 7.11 on page 123. Basler ace GigE...
Page 78
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.
"waiting for acquisition start trigger" acquisition status and enter the "waiting for frame start trigger" acquisition status. The camera can then react to frame start trigger signals and will continue to do so until the number of frame start trigger signals it has received is equal to the current Acquisition Basler ace 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. Basler ace 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 API and the pylon Viewer, see Section 3 on page...
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...
Page 83
// 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. For more information about the pylon API and the pylon Viewer, see Section 3 on...
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...
Page 85
// trigger, to trigger 5 frame starts, and to retrieve 5 frames here Camera.AcquisitionStop.Execute( ); 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...
If the parameter is enabled and is set to a value less than the maximum allowed frame rate with the current camera settings, the camera will generate frame start trigger signals at the rate specified by the parameter setting. Basler ace GigE...
For more information about using a software trigger to control frame acquisition start, see Section 7.4.2 on page For more information about using a hardware trigger to control frame acquisition start, see Section 7.4.3 on page Basler ace 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.
Page 89
Camera.AcquisitionFrameRateAbs.SetValue( 60.0 ); // Start frame capture Camera.AcquisitionStart.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on page Basler ace GigE...
Section 7.4.2.2 on page 81 includes more detailed information about applying a software frame start trigger signal to the camera using Basler pylon. For more information about determining the maximum allowed frame rate, see Section 7.12 on page 126.
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.
ExFSTrig signal, see Section 7.4.3.4 on page For more information about the electrical requirements for line 1, see Section 5.7 on page For more information about determining the maximum allowed frame rate, see Section 7.12 on page 126. Basler ace GigE...
Exposure Time Abs parameter) Fig. 37: Overtriggering with Timed Exposure For more information about the Frame Start Overtrigger event, see Section 10.10 on page 224. For more information about the camera’s Exposure Time Abs parameter, see Section 7.5 on page Basler ace GigE...
Page 94
µs to 5500 µs. In this case you would set the camera’s Exposure Overlap Time Max Abs parameter to 3000 µs. For more information about the Frame Trigger Wait signal and the Exposure Overlap Time Max Abs parameter, see Section 7.10.4 on page 115. Basler ace 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 96
// 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 API and pylon Viewer, see Section 3 on page...
Note: The colors used in this drawing are designed to illustrate how the camera’s output modes work. They do not represent the actual colors used in the color Horizontal Shift Registers filter on acA750-30 gc cameras. Fig. 39: Field 0 Readout Basler ace GigE...
Page 98
Note: The colors used in this drawing are designed to illustrate how the camera’s output modes work. They do not represent the actual colors used in the color Horizontal Shift Registers filter on acA750-30 gc cameras. Fig. 40: Field 1 Readout Basler ace GigE...
Setting the Field Output Mode You can set the Field Output Mode parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the Field Output Mode: // Set the field output mode to Field 0 Camera.FieldOutputMode.SetValue( Field0 );...
The Exposure Time Abs parameter sets the exposure time in µs. The parameter can be set in increments of 1 µs. You can use the Basler pylon API to set the Exposure Time Abs parameter value from within your application software. The following code snippet illustrates using the API to set the parameter value: // Set the exposure time to 3000 µs...
Page 104
Exposure Time Abs parameter can be set in a range from 35 µs to 999985 µs and can be set in increments of 35 µs. You can use the Basler pylon API to set the Exposure Time Abs parameter value from within your application software. The following code snippet illustrates using the API to set the parameter value: // Set the exposure time to 3500 µs...
The cameras can provide an exposure active output signal that will go high when the exposure time for a frame acquisition begins and will go low when the exposure time ends. You can determine the readout time for a frame by checking the value of the camera’s Readout Time Abs parameter. Basler ace GigE...
Page 106
= line readout Fig. 45: Global Shutter For more information about the exposure active output signal, see Section 7.10.1 on page 110. For more information about the Readout Time Abs parameter, see Section 7.11 on page 123. Basler ace GigE...
Line 6 tRow Line 7 Line 8 Line 9 Line 10 Line 11 tRow Line N-2 Line N-1 Line N Reset Runtime Total Runtime = line exposure = line readout Fig. 46: Rolling Shutter in the ERS Mode Basler ace GigE...
Page 108
And so on until the bottom line of pixels is reached (see Figure 47). The pixel values for each line are read out at the end of exposure time for the line. The readout time for each line is also equal to tRow. For the acA2500-14gm/gc, tRow = 35 µs. Basler ace GigE...
Page 109
For more information about the exposure active output signal, see Section 7.10.1 on page 110. For more information about the Exposure Time Abs parameter, see Section 7.6 on page For more information about the flash window, see Section 7.7.2.1 on page 100. Basler ace GigE...
You can enable and disable the global reset release mode for the rolling shutter from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to enable and disable the global reset release mode: // Enable the global reset release mode Camera.GlobalResetReleaseModeEnable.SetValue( true );...
Page 111
The flash window is the period of time during a frame acquisition when all of the lines in the sensor are open for exposure. Figure 49 illustrates the flash window for the global reset release mode. Basler ace GigE...
Page 112
Flash Window Width = line exposure time = line readout time Fig. 49: Flash Window for Rolling Shutter in the Global Reset Release Mode For more information about the Exposure Time Abs parameter, see Section 7.6 on page Basler ace GigE...
Page 113
The flash window signal is also available on cameras with a global shutter imaging sensor. On global shutter cameras, the flash window signal is simply the equivalent of the exposure active signal. For more information about the flash window signal, see Section 7.10.2 on page 112. Basler ace GigE...
In the overlapped mode of operation, the exposure of a new frame begins while the camera is still reading out the sensor data for the previously acquire frame. This situation is illustrated in Figure 52 with the camera set for the trigger width exposure mode. Basler ace GigE...
Page 115
You can read the Readout Time Abs parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to get the parameter value: double ReadoutTime = Camera.ReadoutTimeAbs.GetValue( );...
Page 116
Abs parameter. For more information about the Frame Trigger Wait signal and the Exposure Overlap Time Max Abs parameter, see Section 7.10.4 on page 115. For more information about trigger width exposure, see Section 7.4.3.2 on page Basler ace GigE...
Fig. 54: Non-overlapped Acquisition In the overlapped mode of operation, the acquisition for a new frame begins while the camera is still completing the acquisition process for the previous frame. This situation is illustrated in Figure 55. Basler ace GigE...
Page 118
N (the last line). You can read the Readout Time Abs parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to get the parameter value: double ReadoutTime = Camera.ReadoutTimeAbs.GetValue( );...
Page 119
Frame Acquisition N+1 Frame Acquisition N+2 Time = Line Exposure = Line Readout Fig. 56: Acquisition Overlap Guideline You can avoid violating this guideline by using the camera’s Frame Trigger Wait signal to determine when exposure can safely begin. Basler ace GigE...
When you use the exposure active signal, be aware that there is a delay in the rise and the fall of the signal in relation to the start and the end of exposure. See Figure 57 for details. Basler ace GigE...
Page 121
Set the value of the Line Source Parameter to the exposure active output signal. You can set the Line Selector and the Line Source parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.LineSelector.SetValue( LineSelector_Out1 );...
Set the value of the Line Source Parameter to the flash window signal. You can set the Line Selector and the Line Source parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.LineSelector.SetValue( LineSelector_Out1 );...
Page 123
Image Acquisition Control Camera.LineSource.SetValue( LineSource_FlashWindow ); 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 For more information about changing which camera output signal is selected as the source signal for the output line, see Section 6.2.1 on...
If the value is set to "true", the camera is waiting for the trigger signal. You can check the acquisition status from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to check the acquisition status:...
3 and with exposure and readout overlapped on a camera with a global shutter. 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 ace GigE...
Page 126
Fig. 60: Acquisition Trigger Wait Signal The acquisition trigger wait signal will only be available when hardware acquisition start triggering is enabled. For more information about event reporting, see Section 10.10 on page 224. Basler ace GigE...
Set the value of the Line Source Parameter to the acquisition trigger wait signal. You can set the Line Selector and the Line Source parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.LineSelector.SetValue( LineSelector_Out1 );...
Page 128
The frame trigger wait signal will only be available when hardware frame start triggering is enabled. For more information about event reporting, see Section 10.10 on page 224. For more information about hardware triggering, see Section 7.4.3 on page Basler ace GigE...
Page 129
Abs parameter setting Frame Acquisition N+1 Exposure Readout Exp. Time Setting Frame Acquisition N+2 Exposure Readout Time = Camera is in a "waiting for frame start trigger" status Fig. 62: Frame Trigger Wait Signal with the Timed Exposure Mode Basler ace GigE...
Page 130
ExFSTrig signal to vary the exposure time in a range from 3000 µs to 5500 µs. In this case you would set the camera’s Exposure Overlap Time Max Abs parameter to 3000 µs. Basler ace GigE...
Page 131
Image Acquisition Control You can use the Basler pylon API to set the Exposure Overlap Time Max Abs parameter value from within your application software. The following code snippet illustrates using the API to set the parameter value: Camera.ExposureOverlapTimeMaxAbs.SetValue( 3000 );...
Page 132
Set the value of the Line Source Parameter to the frame trigger wait signal. You can set the Line Selector and the Line Source parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.LineSelector.SetValue( LineSelector_Out1 );...
Also assume that you have selected input line 1 to accept the hardware trigger signal and that you have set the Line Debouncer Time Abs parameter for input line 1 to 5 µs. Basler ace GigE...
Page 134
You can read the Readout Time Abs parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to get the parameter value: double ReadoutTime = Camera.ReadoutTimeAbs.GetValue( );...
Page 135
Due to the nature of the Ethernet network, the transmission start delay can vary from frame to frame. The transmission start delay, however, is of very low significance when compared to the transmission time. For more information about the Payload Size and Device Current Throughput parameters, see Section B.1 on page 271. Basler ace GigE...
You can use the online frame rate calculator found in the Support section of our website: www.baslerweb.com You can use the Basler pylon API to read the value of the camera’s Resulting Frame Rate Abs parameter (see the next page).
7.12.1 Using Basler pylon to Check the Maximum Allowed Frame Rate You can use the Basler pylon API to read the current value of the Resulting Frame Rate Abs parameter from within your application software using the Basler pylon API. The following code...
Page 138
For more information about AOI settings, see Section 10.5 on page 199. For more information about the packet size and inter-packet delay settings and about the settings that determine the bandwidth assigned to the camera, see Section B.2 on page 278. Basler ace GigE...
Read the value of the Resulting Frame rate parameter with the limit removed. For more information about using the Remove Parameter Limits feature, see Section 10.10 on page 224. For more information about the Resulting Frame Rate parameter, see page 126. Basler ace GigE...
The images can then be used for a variety of purposes including vegetation coverage estimates, archaeological site identification, etc. For more information about the Acquisition Frame Rate Abs parameter, see Section 7.3.1.1 on page Basler ace GigE...
Page 141
= frame exposure and readout = frame transmission Acquisition Acquisition Stop Start Command Command Executed Executed Acquisition Start Trigger Signal Frame Start Trigger Signal Time Fig. 66: Use Case 1 - Acquisition Start Trigger Off and Frame Start Trigger Off Basler ace GigE...
Page 142
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 ace GigE...
Page 143
= frame transmission Acquisition Acquisition Stop Start Command Command Executed Executed Acquisition Start Trigger Signal Frame Start Trigger Signal (applied to line 1) Time Fig. 67: Use Case 2 - Acquisition Start Trigger Off and Frame Start Trigger On Basler ace GigE...
Page 144
(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 7.3.1.1 on page Basler ace GigE...
Page 145
= frame transmission Acquisition Acquisition Start Stop Command Command Executed Executed Acquisition Start Trigger Signal (applied to line 1) Frame Start Trigger Signal Time Fig. 68: Use Case 3 - Acquisition Start Trigger On and Frame Start Trigger Off Basler ace GigE...
Page 146
(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 ace GigE...
Page 147
Acquisition Start Stop Command Command Executed Executed Acquisition Start Trigger Software Command Executed Frame Start Trigger Signal (applied to line 1) Time Fig. 69: Use Case 4 - Acquisition Start Trigger On and Frame Start Trigger On Basler ace GigE...
Page 148
Image Acquisition Control Basler ace 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.) Sensor Pixels Fig. 70: Bayer Filter Pattern Basler ace GigE...
In the first step of the process, a demosaicing algorithm is performed to get RGB data for each pixel. This is required because color cameras with a Bayer filter on the sensor gather only one color of light for each individual pixel. Basler ace GigE...
Page 151
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 9.3 on page 171. Basler ace GigE...
"binned" pixel. As shown in Figure 72, when the camera acquires field 0, it will obtain the following color combinations for any group of four "binned" pixels: Green + Cyan Magenta + Cyan Magenta + Yellow Green + Yellow Basler ace GigE...
Page 153
= a cyan pixel in the sensor Ye+G Ye+G = a magenta pixel in the sensor Ye+M Ye+M = a yellow pixel in the sensor = a "binned" pixel in a vertical shift register Fig. 73: Color Combinations for Field 1 Basler ace GigE...
Page 154
If the camera’s gamma correction feature is used, it will act on the RGB information for each binned pixel. A final transformation is performed on the RGB color information to convert it to YUV information for each binned pixel. The binned pixel values are transmitted from the camera in a YUV format. Basler ace GigE...
So in essence, when a color camera is set for Mono 8, it outputs an 8 bit monochrome image. (This type of output is sometimes referred to as "Y Mono 8".) For complete details of the Mono 8 format, see Section 9.3 on page 171. Basler ace GigE...
If a lens with a very long thread length is used, the filter holder or the lens mount will be damaged or destroyed and the camera will no longer operate. For more information about the location of the IR cut filter, see Section 1.4.2 on page Basler ace 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 ace GigE...
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 );...
Page 159
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 );...
The increase or decrease in intensity is proportional. For example, if the balance ratio for a color is set to 1.2, the intensity of that color will be increased by 20%. Basler ace GigE...
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 );...
Page 162
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 );...
In the first step, the values are demosaiced to obtain RGB values for each pixel. In the second step, an RGB to RGB color matrix conversion technique is performed on the pixels. Finally, the pixel values are converted to the YUV color space and transmitted from the camera. Basler ace GigE...
Page 164
Setting Matrix Transformation You can set the Color Transformation Selector and Color Transformation Mode parameters from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter values: // Select the color transformation type (on an scA750-30gc) Camera.ColorTransformationSelector.SetValue...
R, G, and B color values for a pixel with a 3 x 3 matrix containing correction values. Each column in the 3 x 3 matrix can be populated with values of your choice. In other words: Gain00 Gain01 Gain02 Gain10 Gain11 Gain12 Gain20 Gain21 Gain22 Where Gain00, Gain01, etc. are settable values. Basler ace GigE...
Page 166
// 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. For more information about the pylon API and the pylon Viewer, see Section 3 on...
Hue specifies the kind of coloration, for example, whether the color is red, yellow, orange etc. Saturation expresses the colorfulness of a color. At maximum saturation, no shade of grey is present. At minimum saturation, no "color" but only some shade of grey (including black and white) is present. Basler ace GigE...
Page 168
Fig. 74: RGB Color Cube With YCM Secondary Colors, Black, and White, Projected On a Plane Grey Decrease Saturation Adjustment Increase Adjustment Fig. 75: Hue and Saturation Adjustment In the Color Hexagon. Adjustments Are Indicated for Red as an Example Basler ace GigE...
Page 169
0 to 255. This integer range maps linearly to the floating point range with 0 being equivalent to 0.0, 64 being equivalent to 1.0, and +255 being equivalent to +3.98438. Basler ace GigE...
Page 170
You can set the Color Adustment Enable, Color Adjustment Selector, Color Adjustment Hue, Color Adjustment Hue Raw, Color Adjustment Saturation, and Color Adjustment Saturation Raw parameter values from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter values: // Enable the Color Adjustment feature Camera.ColorAdjustmentEnable.SetValue( true );...
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 172
Color Creation and Enhancement Basler ace GigE...
Table 11: Pixel Formats Available on Color Cameras ( = format available) Details of the monochrome formats are described in Section 9.2 on page 165 and details of the color formats are described in Section 9.3 on page 171. Basler ace GigE...
Page 174
Pixel Data Formats You can set the Pixel Format 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.PixelFormat.SetValue( PixelFormat_Mono8 ); Camera.PixelFormat.SetValue( PixelFormat_Mono12Packed );...
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 ace GigE...
Page 177
Therefore, the highest data value you will see is 0x0FFF indicating a signal level of 4095. This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0x0FFF 4095 0x0FFE 4094 • • • • • • 0x0001 0x0000 Basler ace GigE...
Page 179
“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 ace 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 9.3.5 on page 179. Basler ace 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 ace GigE...
Page 182
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 ace 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 ace GigE...
Page 184
A camera that is set for Bayer BG 12 has only 12 effective bits out of the 16 bits transmitted for each pixel. The leader of each transmitted frame will indicate Bayer BG12 as the pixel format. Basler ace 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 ace GigE...
Page 186
“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 ace 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 ace GigE...
Page 188
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 ace 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 ace GigE...
Page 190
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 ace GigE...
The sequence assumes that the camera is set for full resolution. The pixel transmission sequence described above does not adequately describe the behavior of acA750-30 cameras. For more information about how the acA750- 30 differs, see Section 7.5 on page Basler ace GigE...
Fig. 76: 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 ace GigE...
Set the Gain Raw parameter to your desired value. You can set the Gain Selector and the Gain Raw 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.GainSelector.SetValue( GainSelector_All );...
Page 197
Standard Features 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 On acA640-90gm/gc, acA640-100gm/gc, acA1300-30gm/gc, and acA1600- 20gm/gc cameras, the minimum setting for the Gain Raw parameter can be reduced to 0 by using the Disable Parameter Limits feature.
Page 198
Set the Gain Raw parameter to your desired value. You can set the Gain Selector and the Gain Raw 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.GainSelector.SetValue( GainSelector_All );...
1 in the digital values output for the pixels. A decrease of 1 in the setting will result in a negative offset of 1 in the digital values output for the pixels. Basler ace GigE...
You can set the Black Level Selector and the Black Level Raw 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.BlackLevelSelector.SetValue ( BlackLevelSelector_All );...
The values for any extended limits can be determined by using the Basler pylon Viewer or from within your application via the pylon API.
Page 202
Standard Features Camera.RemoveLimits.SetValue( true ); You can also use the Basler pylon Viewer application to easily set the parameters. Note that the remove parameter limits feature will only be available at the "guru" viewing level. For more information about the pylon API and the pylon Viewer, see Section 3 on...
1. If you do nonetheless, all bits output from the camera will automatically be set to 1. Therefore, you should only use the shift by 1 setting when your pixel readings with a 12 bit pixel format selected and with digital shift disabled are all less than 2048. Basler ace GigE...
Page 204
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 ace 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 ace GigE...
Page 206
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 ace 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 ace 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 7.12 on page 126. Basler ace GigE...
Page 210
Normally, the X Offset, Y Offset, Width, and Height parameter settings refer to the physical columns and rows of pixels in the sensor. But if binning is enabled, these parameters are set in terms of "virtual" columns and rows. For more information, see Section 10.6.1 on page 203. Basler ace GigE...
You can set the Offset X, Offset Y, 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 Offset X, Offset Y, Width, and Height parameter values int64_t widthMax = Camera.Width.GetMax( );...
With horizontal binning, adjacent pixels from 2 columns, 3 columns, or a maximum of 4 columns are summed and are reported out of the camera as a single pixel. Figure 80 illustrates horizontal bin- ning. Horizontal Binning by 2 Horizontal Binning by 3 Horizontal Binning by 4 Fig. 80: Horizontal Binning Basler ace 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 214
And when you set the Y Offset and the Height for the AOI, you will be setting these values in terms of virtual sensor lines. For more information about the area of interest (AOI) feature, see Section 10.5 on page 199. Basler ace 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 ace GigE...
Page 216
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 10.9 on page 211. Basler ace GigE...
Page 217
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);...
The second graph is for a lookup table where the values are arranged so that the camera output increases quickly as the digitized sensor output moves from 0 through 2048 and increases gradually as the digitized sensor output moves from 2049 through 4096. Basler ace GigE...
Page 219
Fig. 83: Lookup Table with Values Mapped in a Linear Fashion 4095 3072 12 Bit Camera Output 2048 1024 1024 2048 3072 4095 12 Bit Digitized Sensor Reading Fig. 84: Lookup Table with Values Mapped for Higher Camera Output at Low Sensor Readings Basler ace GigE...
Page 220
You can set the LUT Selector, the LUT Index parameter and the LUT Value parameter 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: // Select the lookup table Camera.LUTSelector.SetValue( LUTSelector_Luminance );...
You can use an auto function when binning is enabled (monochrome cameras only). An auto function uses the binned pixel data and controls the image property of the binned image. For more information about binning, see Section 10.6 on page 202. Basler ace GigE...
If you have set an auto function to "once" or "continuous" operation mode while the camera was continuously capturing images, the auto function will become effective with a short delay and the first few images may not be affected by the auto function. Basler ace 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. 85: Auto Function Area of Interest and Image Area of Interest Basler ace GigE...
Page 224
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 ace GigE...
Page 225
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. 86: Various Degrees of Overlap Between the Auto Function AOI and the Image AOI Basler ace GigE...
Page 226
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() ); 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.9.1.3...
0 (black) to 255 (white) when the camera is set for an 8 bit pixel format or from 0 (black) to 4095 (white) when the camera is set for a 12 bit pixel format. Setting the gain auto functionality using Basler pylon is a several step process: Select the Auto Function AOI 1.
Page 229
// Set the mode of operation for the gain auto function Camera.GainAuto.SetValue( GainAuto_Once ); 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 For general information about auto functions, see Section 10.9 on...
0 (black) to 4095 (white) when the camera is set for a 12 bit pixel format. If the Auto Exposure Time Abs Upper Limit parameter is set to a sufficiently high value the camera’s frame rate may be decreased. Basler ace GigE...
Page 231
// Set the mode of operation for the exposure auto function Camera.ExposureAuto.SetValue( ExposureAuto_Continuous ); 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 For general information about auto functions, see Section 10.9 on...
If you want to use the gain auto and the exposure auto functions at the same time, you should set both functions for the continuous mode of operation. Setting the camera with Basler pylon to use the gain auto function and the exposure auto function at the same time is a several step process: Set the value of the Auto Function Profile parameter to specify whether gain or exposure time will be minimized during automatic adjustments.
For more information about setting the white balance "manually", see Section 8.4 on page 147. Setting the balance white auto functionality using Basler pylon is a several step process: Select the Auto Function AOI 2. Set the value of the Offset X, Offset Y, Width, and Height parameters for the AOI.
If the maximum number of retries is reached and no acknowledge has been received, the message will be dropped. During the time that the camera is waiting for an acknowledgement, no new event messages can be transmitted. Basler ace GigE...
Page 235
This is described in the "Camera Events" code sample included with the pylon software development kit. Event reporting must be specifically set up for each type of event using the parameter name of the event and of the supplementary information. The following table lists the relevant parameter names: Basler ace GigE...
Page 236
API. The pylon software development kit includes a "Camera Events" code sample that illustrates the entire process. 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 );...
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 ace GigE...
Page 239
5 will show the effects of the feature while test image 3 will not. This makes test image 5 useful for checking the effects of digital features such as the luminance lookup table. Basler ace GigE...
Page 240
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. 88: Test Image Six Basler ace 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 242
// Read the Max Height parameter int64_t maxHeight = Camera.HeightMax.GetValue(); You can also use the Basler pylon Viewer application to easily read the parameters and to read or write the Device User ID. You can use the Basler pylon IP Configuration tool to read or write the Device User ID.
Camera.UserDefinedValueSelector.SetValue( UserDefinedValueSelector_Value1 ); int64_t UserValue1 = Camera.UserDefinedValue.GetValue(); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the Basler pylon API and the pylon Viewer, see Section 3 on page Basler ace GigE...
"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 factory set into the active set and for designating which set will be the startup set appear below. Basler ace GigE...
Page 245
Instructions for designating the startup set appear below. For more information about auto functions, see Section 10.9 on page 211. Basler ace GigE...
Set the Default Set Selector to the Standard Factory Setup, High Gain Factory Setup or Auto Functions Factory Setup. You can set the Default Set Selector from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector: If you want to select the Standard Factory Setup: Camera.DefaultSetSelector.SetValue(DefaultSetSelector_Standard);...
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 Basler pylon API and the pylon Viewer, see Section 3 on page Basler ace GigE...
The standard factory setup is optimized for use in typical situations and will provide good camera performance in most cases. For more information about the Basler pylon API and the pylon Viewer, see Section 3 on page Basler ace GigE...
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 ); For more information about the Basler pylon API and the pylon Viewer, see Section 3 on page Basler ace GigE...
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 ace 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 253
= 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 ace 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 255
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 256
Camera.CounterReset.Execute(); // Disable reset Camera.CounterResetSource.SetValue( CounterResetSource_Off ); 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 For more information about using line 1 as the source signal for a frame counter reset, see Section 6.1.1 on...
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...
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 trigger...
Page 259
You can set the trigger input 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 trigger input counter reset and to execute a reset via software.
Page 260
Camera.CounterReset.Execute(); // Disable reset Camera.CounterResetSource.SetValue( CounterResetSource_Off ); 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 For more information about using line 1 as the source signal for a trigger input counter reset, see Section 6.1.1 on...
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 line...
Page 262
ChunkParser.AttachBuffer( (unsigned char*) Result.Buffer(), Result.GetPayloadSize() ); int64_t lineStatusAll = Camera.ChunkLineStatusAll.GetValue(); 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...
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 264
( ChunkParser.HasCRC() && ! ChunkParser.CheckCRC() ) cerr << "Image corrupted!" << endl; 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...
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.
12.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 267
How often did/does the problem Once. Every time. occur? Regularly when: Occasionally when: How severe is the problem? Camera can still be used. Camera can be used after I take this action: Camera can no longer be used. Basler ace GigE...
Page 268
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.
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.
Basler Network Drivers and Parameters 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.
Basler Network Drivers and Parameters A.2.1 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 273
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 92. The parameter value is in per cent of the width of the receive window. In Figure 92 the resend request threshold is set at 33.33% of the width of the receive window.
Basler Network Drivers and Parameters A.2.3 Timeout Resend Mechanism Parameters The timeout resend mechanism is illustrated in Figure 93 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 275
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.
Basler Network Drivers and Parameters A.2.4 Threshold and Timeout Resend Mechanisms Combined Figure 94 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 277
(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) );...
Basler Network Drivers and Parameters A.2.5 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() );...
Page 280
Basler Network Drivers and Parameters Basler ace GigE...
The packet size parameter sets the size of the packets that the camera will use when it sends the data payload via the selected stream channel. The value is in bytes. The value does not affect the Basler ace GigE...
Page 282
IPD = Inter-packet Delay setting in ticks (with a tick set to the 8 ns standard) When considering this formula, you should know that on a Gigabit network it takes one tick to transmit one byte. Also, be aware that the formula has been simplified for easier understanding. Basler ace GigE...
Page 283
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 ace GigE...
Page 284
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 ace GigE...
Page 285
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 ace GigE...
Page 286
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 287
// Resulting Framerate double resultingFps = Camera.ResultingFrameRateAbs.GetValue(); You can also use the Basler pylon Viewer application to easily set or view the parameter values. For more information about the pylon API and the pylon Viewer, see Section 3 on page...
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 ace GigE...
Page 289
After you have adjusted the Inter-packet Delay parameter on each camera, you can check the sum of the Bandwidth Assigned parameter values and see if the sum is now less than 125 MByte/s. Basler ace 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 291
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 292
To use the formula, you will need to know the current value of the Bandwidth Assigned parameter and the Bandwidth reserve parameter for each camera. 100 Bandwidth Reserved – × ---------------------------------------------------------------------- - Data Bandwidth Assigned Bandwidth Assigned Basler ace GigE...
Page 293
You can lower the data bandwidth needed by a camera either by lowering its frame rate or by decreasing the size of the area of interest (AOI). Once you have adjusted the frame rates and/or AOI settings on the cameras, you should repeat steps 2 through 6. Basler ace GigE...
Page 294
Network Related Camera Parameters and Managing Bandwidth For more information about the camera’s maximum allowed frame transmission rate, see Section 7.12 on page 126. For more information about the AOI, see Section 10.5 on page 199. Basler ace GigE...
AW00089309000 5 Apr 2011 Corrected an omission in the sensor size listings for the camera specifications. AW00089310000 6 Jun 2011 Made the appropriate changes throughout the manual to add the new acA1600-20gm/gc camera models. Basler ace GigE...
Page 299
12 packed pixel format....168 software..........25 mono 12 pixel format ......166 integrate enabled signal ......110 mono 8 pixel format ....... 165 interlaced sensor ........87 multiple cameras on a network ....278 inter-packet delay ....260 invert input line..........53 output line...........56 Basler ace GigE...
Page 300
12 packed ......168 serial number........... 22 mono 8 ........165 sets of parameters, saving ....237 YUV 422 (YUYV) packed..170 single frame acquisition mode ....67 YUV 422 packed ......170 software development kit......28 pixel size ..........2 Basler ace GigE...
Page 301
..........249 trigger wait signals........115 trigger width exposure mode ....84 use case diagrams .........130 user configuration set ......235 user defined values ........233 user output selector........55 user output value parameter ....55 ventilation ..........20 vertical binning ........202 viewer ............28 Basler ace GigE...
Need help?
Do you have a question about the ace acA640-90gm and is the answer not in the manual?
Questions and answers