background image

AW00136902000

Features

Basler dart BCON

85

11.4 Gamma

The Gamma feature lets you modify the brightness of acquired images to account for a non-linearity 
in the human perception of brightness.

The gamma correction can be set manually as desired using the Gamma parameter:

Gamma = 1: The overall brightness is 

not corrected

 (unless the pixel format is set to 

YCbCr422 or RGB8, see section below).

Gamma < 1: The overall brightness is 

increased

.

Gamma > 1: The overall brightness is 

decreased

.

In all cases, black pixels (brightness = 0) and white pixels (brightness = maximum) will not be 
adjusted. The maximum pixel brightness equals 255 for 8-bit output and 4095 for 12-bit output.

To accomplish gamma correction, a gamma correction value (

) is applied to the pixel value of each 

pixel according to the following formula:

sRGB Gamma Correction and Color Space Mode

If the pixel format is set to YCbCr422 or RGB 8, you can use the BslColorSpaceMode parameter to 
change the color space for image acquisition. This will enable or disable the application of an 
additional sRGB gamma correction value.

You can set the BslColorSpaceMode parameter to the following values:

sRGB:

 The image brightness is optimized for display on an sRGB monitor. An additional 

gamma correction value of approximately 0.4 is applied. This is the default setting.

Note that the sRGB gamma correction is independent from the Gamma parameter and will not 
be reflected in the Gamma parameter value.

Example:

 You set the BslColorSpaceMode parameter to sRGB and the Gamma parameter 

value to 1.2. First, an sRGB gamma correction value of approximately 0.4 is applied to the pixel 
values. Then, a gamma correction value of 1.2 is applied to the resulting pixel values.

RGB:

 No additional sRGB gamma correction value is applied.

If the pixel format is set to Bayer 8 or Bayer 12, the BslColorSpaceMode parameter is not available, 
and gamma correction is always performed in RGB color space.

You can set the parameter values from within your application software by using the Basler pylon 
API. The following code snippet illustrates using the API to set the color space to sRGB and the 
gamma correction 1.2 as an example:

// Set the color space to sRGB

camera.BslColorSpaceMode.SetValue(BslColorSpaceMode_sRGB);

// Set the Gamma value to 1.2

camera.Gamma.SetValue(1.2);

Y

corrected

Y

uncorrected

Y

max

---------------------------

Y

max

=

Содержание daA1280-54bc

Страница 1: ...USER S MANUAL FOR BCON CAMERAS Document Number AW001369 Version 02 Language 000 English Release Date 01 November 2016 Basler dart ...

Страница 2: ...les Life support applications These products are not designed for use in life support appliances devices or systems where malfunction of these products can reasonably be expected to result in personal injury 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 sa...

Страница 3: ...ove the camera front Prevent contact with foreign substances Do not allow e g liquid flammable or metallic material to get in contact with the board Otherwise the camera may fail or cause a fire Avoid electromagnetic fields Do not operate the camera in the vicinity of strong electromagnetic fields Avoid electrostatic charging Transport in original packaging Transport and store the camera in its or...

Страница 4: ...02 463 599 support europe baslerweb com The Americas Basler Inc 855 Springdale Drive Suite 203 Exton PA 19341 USA Tel 1 610 280 0171 Fax 1 610 280 7608 support usa baslerweb com Asia Pacific Basler Asia Pte Ltd 35 Marsiling Industrial Estate Road 3 05 06 Singapore 739257 Tel 65 6367 1355 Fax 65 6367 1255 support asia baslerweb com www baslerweb com ...

Страница 5: ... 4 3 Mechanical Stress Test Results 19 3 5 Avoiding EMI and ESD Problems 20 3 6 Environmental Requirements 21 3 6 1 Temperature and Humidity 21 3 6 2 Heat Dissipation 22 4 Physical Interface 23 4 1 General Description of the Camera Connections 23 4 2 FFC Connector 24 4 2 1 Connector Pin Assignments 24 4 3 Voltage Requirements 27 4 3 1 Absolute Maximum Ratings 27 4 3 2 Input Voltages 27 4 3 3 Outpu...

Страница 6: ...nput Lines and Signals 50 8 1 1 Using the Input Line for Frame Start Triggering 50 8 1 2 Input Line Debouncers 50 8 1 3 Input Line Inverter 52 8 2 Configuring Output Lines and Signals 53 8 2 1 Selecting a Source Signal for an Output Line 53 8 2 2 Setting the Status of a User Settable Output Line 53 8 2 3 Output Line Inverter 54 8 3 Checking the Status of the I O Lines 55 8 3 1 Checking the Status ...

Страница 7: ... on Pixel Formats for Color Cameras 81 11 Features 82 11 1 Feature Sequence 82 11 2 Gain 83 11 3 Black Level 84 11 4 Gamma 85 11 5 Brightness Contrast 86 11 5 1 Brightness 86 11 5 2 Contrast 87 11 5 3 Setting Brightness and Contrast 88 11 6 Color Enhancement Features 89 11 6 1 General Considerations 89 11 6 2 Light Source Preset 90 11 6 3 Balance White 92 11 6 4 Hue Saturation 93 11 6 5 PGI Featur...

Страница 8: ... 11 12 Backlight Compensation 121 11 13 Test Patterns 122 11 14 Device Information Parameters 124 11 15 Configuration Sets and User Sets 126 11 15 1 Saving a User Set 127 11 15 2 Loading a User Set or the Factory Set into the Active Set 128 11 15 3 Designating the Startup Set 129 12 Troubleshooting and Support 130 12 1 Tech Support Resources 130 12 2 Obtaining an RMA Number 130 12 3 Before Contact...

Страница 9: ...arget Audience The Basler dart BCON User s Manual is aimed at experienced hardware and software engineers proficient in electronics software development and embedded system design The document is written for a target audience that has intermediate to advanced technical skills in the areas mentioned above The document assumes that users have experience in the following areas System on a Chip SoC or...

Страница 10: ...el Link Design Guide http www ti com lit ml snla167 snla167 pdf GenICam Pixel Format Names and Values http www emva org wp content uploads GenICamPixelFormatValues pdf The documents are provided by the respective owners and the links might be changed by them Font Element or Symbol Example Arial bold Program interface such as menu commands windows dialog boxes field and button names Press the OK bu...

Страница 11: ...ich meet the Limited Power Source LPS requirements NOTICE Dust on the sensor can impair the camera s performance Every time you handle the camera without a lens attached make sure that the camera is pointing down so that no dust can reach the sensor If the camera is not installed store it in its original packaging NOTICE Heat can damage the camera Make sure that you provide sufficient heat dissipa...

Страница 12: ...ouch and possibly scratch or break the sensor glass Do not screw in the lens deeper than 11 7 mm especially during focusing For more information see Section 3 4 2 on page 16 NOTICE Voltage outside of the specified range can cause damage You must supply camera power that complies with the individual voltage requirements of the BCON interface lines The nominal voltage for the power supply line VCC i...

Страница 13: ...tatic charge during cleaning cotton is a good choice Electrostatic discharge might damage the sensor Cleaning the IR cut filter of dart CS mount color variants the sensor cannot be cleaned Try not to touch the IR cut filter and do not clean the IR cut filter mechanically The glass of the IR cut filter can break if you apply too much pressure Use clean oil free compressed air to clean the IR cut fi...

Страница 14: ...uit board only S mount This variant consists of a circuit board with a camera front attached S mount lenses can be attached to the lens mount on the camera front CS mount This variant consists of a circuit board with a camera front attached CS mount lenses can be attached to the lens mount on the camera front Unless otherwise noted the material in this manual applies to all of the camera models li...

Страница 15: ...ime Control Programmable via the camera API Camera Power Requirements Nominal 5 VDC supplied via the camera s 28 pin FFC connector 1 3 W typical 5 VDC I O Lines 1 input line CC0 and 2 output lines two bits on data lane X0 Lens Mount S mount CS mount without mount bare board Size L x W x H Bare board model 4 8 mm x 27 mm x 27 mm S mount model 17 5 mm x 29 mm x 29 mm CS mount model 16 9 mm x 29 mm x...

Страница 16: ...r or free run Exposure Time Control Programmable via the camera API Camera Power Requirements Nominal 5 VDC supplied via the camera s 28 pin FFC connector 1 3 W typical 5 VDC I O Lines 1 input line CC0 and 2 output lines two bits on data lane X0 Lens Mount S mount CS mount without mount bare board Size L x W x H Bare board model 5 9 mm x 27 mm x 27 mm S mount model 17 5 mm x 29 mm x 29 mm CS mount...

Страница 17: ...e trigger or programmable via the camera API Camera Power Requirements Nominal 5 VDC supplied via the camera s 28 pin FFC connector 1 4 W typical 5 VDC I O Lines 1 input line CC0 and 2 output lines two bits on data lane X0 Lens Mount S mount CS mount without mount bare board Size L x W x H Bare board model 4 8 mm x 27 mm x 27 mm S mount model 17 5 mm x 29 mm x 29 mm CS mount model 16 9 mm x 29 mm ...

Страница 18: ... 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 Quantum Efficiency Fig 2 daA1280 54bm Spectral Response From Sensor Data Sheet ...

Страница 19: ...ents Basler dart BCON 11 30 25 20 15 10 5 0 400 500 600 700 800 900 1000 Wavelength nm LSB 10 nJ cm Fig 3 daA1600 60bm Spectral Response From Sensor Data Sheet Wavelength nm Quantum Efficiency Fig 4 daA2500 14bm Spectral Response From Sensor Data Sheet ...

Страница 20: ...lter should transmit in a range from 400 nm to 700 720 nm and it should cut off from 700 720 nm to 1100 nm If you are using a dart bare board color camera we recommend installing an IR cut filter or a lens with an integrated IR cut filter when integrating the camera into the system dart S mount color camera we recommend attaching a lens with an integrated IR cut filter to the camera dart CS mount ...

Страница 21: ...500 600 700 800 900 1000 Wavelength nm LSB 10 nJ cm Blue Green Red Fig 6 daA1600 60bc Spectral Response From Sensor Data Sheet 350 400 450 500 550 600 650 700 750 0 5 10 15 20 25 30 35 40 45 50 Wavelength nm Quantum Efficiency Blue Green Red Fig 7 daA2500 14bc Spectral Response From Sensor Data Sheet ...

Страница 22: ... 10 dart cameras equipped with a CS mount lens adapter are as shown in Figure 11 All dart BCON cameras are equipped with mounting and heat dissipation holes on the bottom as shown in the drawings Bare Board Cameras daA1600 60bm bc Fig 8 Mechanical Dimensions in mm for Bare Board Cameras daA1600 60bm bc Bare Board Cameras Other Models Fig 9 Mechanical Dimensions in mm for Bare Board Cameras Not to ...

Страница 23: ... mm for Cameras with CS mount Lens Adapter 29 14 9 Ø 16 6 4 x Ø2 2 max 3 2 deep 22 4 29 22 4 4 x Ø2 08 Recommended screw size Max M2 Bigger screws can damage the camera Not to scale Parts on the board are representational only 29 14 3 Ø 28 3 5 4 4 x Ø2 2 max 3 2 deep 22 4 29 22 4 4 x Ø2 08 Recommended screw size Max M2 Bigger screws can damage the camera Not to scale Parts on the board are represe...

Страница 24: ...cer ring The spacer ring optimizes the flange focal distance of these cameras When mounting a lens on the camera attach the spacer ring to the lens The maximum lens dimensions are also shown in Figure 12 on page 17 and Figure 13 on page 18 Camera Model Lens Adapter Type Maximum Allowed Lens Intrusion in mm daA1280 54bm daA2500 14bm S mount 11 7 CS mount 11 daA1280 54bc daA2500 14bc S mount 11 7 CS...

Страница 25: ...as make sure that you attach a CS mount adapter ring to the C mount lens before mounting it on a dart CS mount camera Otherwise the lens may reach too far into the camera and damage the IR cut filter color cameras or the sensor mono cameras Not to scale S mount lens M12 x 0 5 Fig 12 Maximum Lens Dimensions in mm for Cameras with S mount Lens Adapter Thread 7 5 daA1600 60bm bc cameras 10 7 mm 11 7 ...

Страница 26: ...W00136902000 18 Basler dart BCON Fig 13 Maximum Lens Dimensions in mm for Cameras with CS mount Lens Adapter 7 Not to scale CS mount thread Thread 5 6 21 85 max CS mount lens Filter holder color cameras only 11 daA1600 60bm cameras 10 mm Sensor ...

Страница 27: ...uring standard operational testing The mechanical stress tests for S mount cameras were performed with a dummy lens attached The dummy lens had a mass of 30 g The mechanical stress tests for CS mount cameras were performed with a dummy lens attached The dummy lens had a mass of 66 g Using a heavier lens requires an additional support for the lens Test Standard Conditions Vibration sinusoidal each ...

Страница 28: ...discharge ESD EMI and ESD can cause problems with your camera such as false triggering or can cause the camera to suddenly stop capturing images EMI and ESD can also have a negative impact on the quality of the image data transmitted by the camera To avoid problems with EMI and ESD you should follow these general guidelines Install the camera as far as possible from devices generating sparks or st...

Страница 29: ...C 122 F UL 60950 1 test conditions no lens attached to the camera and without efficient heat dissipation ambient temperature kept at 50 C 122 F Temperature measured at the hottest point on the board This point is significantly hotter than the other parts on the board See Figure 14 Temperature measured at the outside of the camera See Figure 15 Table 6 Temperature and Humidity Requirements Temperat...

Страница 30: ...mponents Basler dart S mount and CS mount variants Rivets are placed in the four holes see Figure 16 These rivets can be used to dissipate heat towards connected metallic components Usage of the holes or rivets depends on your system design In all cases make sure that the holes or rivets have contact to metallic components in your system This way the heat can dissipate towards the metallic compone...

Страница 31: ...ith both FPGAs and SoCs Systems on a Chip The connector provides connections for LVDS image transfer input and output signals and power supply Furthermore standardized I C lines are integrated which are used for camera configuration via the Basler pylon Camera Software Suite There is also an LED indicator located on the back of the camera Figure 18 shows the location of the connector and the LED i...

Страница 32: ... cables However standard flexible flat cables without a ground layer can also be inserted They will make good electrical contact but under certain circumstances you will notice a high rate of bit errors The connector order code is Hirose FH41 28S 0 5SH 05 4 2 1 Connector Pin Assignments Pin 1 Position As shown in Figure 19 pin 1 of the FFC connector is indicated by an arrow and pin 28 is indicated...

Страница 33: ...istor to 3 3 VDC is required Refer to the I C standard for the appropriate resistor value Note that FFCs can have a significant line capacitance 8 GND 21 Power Supply See note for pin 1 9 I2C_SCL 20 Configuration Interface I C interface clock line A pull up resistor to 3 3 VDC is required Refer to the I C standard for the appropriate resistor value Note that FFCs can have a significant line capaci...

Страница 34: ...ential pair 21 X2 8 Serial Data Output 22 GND 7 Power Supply See note for pin 1 23 X1 6 Serial Data Output LVDS output data lane 1 Use differential routing A 100 ohm termination resistor is required across the differential pair 24 X1 5 Serial Data Output 25 GND 4 Power Supply See note for pin 1 26 X0 3 Serial Data Output LVDS output data lane 0 Use differential routing A 100 ohm termination resist...

Страница 35: ... 0 3 V 6 5 V CC0 CC0 4 2 V I2C_SCL I2C_SDA I2C_ID 3 6 V Pin Name Minimum Nominal recommended Maximum Notes VCC 4 5 5 0 V 5 5 V CC0 CC0 0 2 V 1 8 V Common mode voltage 0 1 V Differential voltage I2C_SCL I2C_SDA I2C_ID 0 0 V 0 0 V 1 0 V Input Low Voltage 2 4 V 3 3 V 3 5 V Input High Voltage Table 8 Recommended Input Voltages Camera Supply LVDS Inputs I2C ID Data and Clock Lines ...

Страница 36: ...e Table 9 Output Voltages LVDS Outputs Data Lanes and Clock Lines Pin Min Max Notes XCLK 20 MHz 84 MHz Selectable via control interface Settable in steps of 8 i e 20 MHz 28 MHz 36 MHz etc X0 X3 140 Mb s 588 Mb s Selectable via control interface I2C_SCL 0 kHz 400 kHz In the I C Bus Specification and User Manual this mode is called fast mode with 400 kbit s Table 10 Timing Characteristics Green LED ...

Страница 37: ...ill light up for approximately 1 second For more information about the startup set see Section 11 15 on page 126 The following code snippet illustrates using the API to set the LED indicator mode Turn off the LED indicator LED is turned off permanently camera DeviceIndicatorMode SetValue DeviceIndicatorMode_Inactive Turn on the LED indicator LED is on during camera operation camera DeviceIndicator...

Страница 38: ...1 1000 1100 Tavg 5 Table 12 IR Cut Filter Spectral Characteristics If you want to operate a dart S mount color camera with an IR cut filter you must attach a lens with an integrated IR cut filter to the camera NOTICE Using a lens with a too long thread length can damage the IR cut filter or the filter holder Make sure that you do not damage the IR cut filter by using lenses with a too long lens th...

Страница 39: ...information about Channel Link see the Channel Link Design Guide The download link is provided in Section 1 3 on page 2 Specification Value Notes Data lanes 4 Clock lines 1 Used for the word clock Control lines 3 I C interface lines clock data ID Input lines 1 Output lines 2 Serialization factor 7 For more information see Section 5 2 2 on page 33 Data bus width 28 bit Bus width reserved for image ...

Страница 40: ... transmission BCON output bits Output 0 and Output 1 Two bits that can be used to transmit camera output signals e g Flash Window or Exposure Active Frame information pixel data and line checksums are transmitted on a common 24 bit image data channel Data 5 2 1 Data Flow The BCON interface does not provide data flow control Also in contrast to the CameraLink interface the BCON interface does not p...

Страница 41: ... X1 12 bit pixel data 12 bit checksum Bit 0 Bit 11 X0 X1 X2 16 bit pixel data 16 bit checksum Bit 0 Bit 15 X0 X1 X2 24 bit pixel data 24 bit checksum Bit 0 Bit 23 X0 X1 X2 X3 Table 14 Data Channel Usage Bit 2 Bit 1 Bit 0 FVal Output 1 Line 2 LVal Output 0 Line 1 X0 Bit 9 Bit 8 Bit 7 Bit 6 Bit 4 Bit 5 Bit 3 X1 Bit 16 Bit 15 Bit 14 Bit 13 Bit 11 Bit 12 Bit 10 X2 Bit 23 Bit 22 Bit 21 Bit 20 Bit 18 Bi...

Страница 42: ...ta Number of pixels per clock cycle Frame information is always transmitted on bits 0 through 7 of the 24 bit data channel If you are only using 8 bit pixel formats e g because you are using a monochrome camera the X2 and X3 data lanes are never active Accordingly if you are only using 8 bit or 12 bit pixel formats X3 is never active Basler recommends however to always connect all BCON data lanes ...

Страница 43: ...n Section 1 3 on page 2 32 Mono 8 0x01080001 Mono 12 0x01100005 Bayer GR 8 0x01080008 Bayer RG 8 0x01080009 Bayer GB 8 0x0108000A Bayer BG 8 0x0108000B Bayer GR 12 0x01100010 Bayer RG 12 0x01100011 Bayer GB 12 0x01100012 Bayer BG 12 0x01100013 YCbCr422 0x0210003B RGB 8 0x02180014 The standard Bayer filter alignment for Basler dart cameras is GB If supported other alignments can be set using the Re...

Страница 44: ... transmitted see also Figure 20 on page 32 Example Assume the camera is set for Mono 8 pixel data and one pixel per clock cycle To demonstrate the principle also assume that the image ROI width is set to 5 pixels only This means that each image line consists of 5 x 8 bit image data Table 18 shows sample data for one image line under these conditions In the example shown above the line checksum dat...

Страница 45: ... The BCON interface provides two bits that can be used to transmit two camera output signals Output 0 and Output 1 Output 0 and Output 1 are transmitted on data lane X0 at position 0 and 1 see Figure 21 on page 33 Depending on the camera model the following output signals can be available Flash Window Exposure Active User Output 1 User Output 2 For more information about configuring output signals...

Страница 46: ...ormats Mono 12 Bayer 12 However information about the specific pixel format used for frame acquisition is included in the FrameInfo part of the data stream The FrameInfo part is sent before each frame transmission For more information see Section 5 2 3 on page 34 Pixel Format Available on Bit Depth Mono 8 Mono cameras only 8 Bayer 8 Color cameras only Mono 12 Mono cameras only 12 Bayer 12 Color ca...

Страница 47: ...ansmits the data for the second pixel in line one and so on until the line is complete When line one is complete the camera sends a checksum for the line After that transmission of line two begins and proceeds in a similar fashion Data transmission continues line by line until all frame data has been transmitted During pixel data transmission the 24 bits of the data channel will be used as shown i...

Страница 48: ...transmission of line two begins and proceeds in a similar fashion Data transmission continues line by line until all frame data has been transmitted During pixel data transmission the 24 bits of the data channel will be used as shown in Table 21 Setting the Number of Pixels per Clock Cycle You can use the pylon API to set the number of pixels per clock cycle from within your application software T...

Страница 49: ...uency fBitClk is not transmitted but can be calculated The bit clock frequency is 7 times faster than the word clock frequency fBitClk fWordClk 7 Setting the Clock Speed You can use the pylon API to set the BCON pixel clock speed from within your application software The following code snippet illustrates using the API to set the clock speed Set the BCON output clock speed to 84 MHz Camera BCONClo...

Страница 50: ...dle data transfers at up to 400 kbit s Fast Mode according to I C Fast Mode Fm devices are downward compatible and can communicate with Standard Mode Sm devices in a 0 to 100 kbit s I C bus system However as they are not upward compatible Fast Mode devices should not be integrated in an I C bus system that is configured for a faster mode i e Fast Mode Plus Fm or High Speed Mode Hs Fast Mode device...

Страница 51: ... the camera because it does not respond anymore you can activate a reset function via the I2C_ID line The I2C_ID line is set to a certain logical level i e either to 0 low or to 1 high 1 Set the I2C_ID line to the opposite logical level for at least 100 ms 2 Set the I2C_ID line back to its original logical level The switch back will trigger the reset of the microcontroller The FPGA will be loaded ...

Страница 52: ...e trace matches the impedance of the differential trace it consumes most of the energy of the wave Therefore both the differential traces and the termination resistors must have an impedance of 100 ohm If they do not match the target impedance the reflected wave can disturb the original signal and cause bit errors Design Recommendations for Data Transmission Printed Circuit Board PCB Design the PC...

Страница 53: ...facing down When ordering a custom flexible flat cable specify the FFC connector see next section to ensure that the ground tab is in the correct position and the retaining tabs have the correct shape When using a standard flexible flat cable without a ground layer and retaining tabs keep the cable short and avoid close proximity to other materials Note that the pull out force is reduced when usin...

Страница 54: ...face I2C_SDC I2C_SDA I2C_ID Basler dart BCON cameras use the I C interface to exchange configuration data with the controlling processor I C is an open collector bus interface with two signal lines SDA and SCL Connect these signal lines to the appropriate ports of an I C controller Typically an I C controller is part of the microcontroller or the System on a Chip SoC that you will be using to proc...

Страница 55: ... I C bus Specification and User Manual 6 4 Power Supply GND VCC The camera needs a single 5 V power supply Bad power quality can deteriorate the camera s image quality However a properly designed switched mode power supply as used to supply a USB port will yield a good result Design Recommendations for the Power Supply The power supply should be able to supply 1 5 W per camera Note that long cable...

Страница 56: ... as well as Channel Link deserializer devices For full speed operation the FPGA must support a bit rate of at least 560 Mb s The Channel Link deserializer device must support 28 bits and 84 MHz or more For a list of suitable Channel Link devices see the Channel Link Design Guide The download link is provided in Section 1 3 on page 2 ...

Страница 57: ...oating point unit download the hardfloat version file name pylon x x x xxxx armhf tar gz b If your ARM processor doesn t have a floating point unit or if you are unsure download the softfloat version file name pylon x x x xxxx armel tar gz 2 Use an unzip tool of your choice to unpack the TAR archive to your home directory 3 Change to the archive s main directory and open the INSTALL text file 4 Fo...

Страница 58: ...ers The Debouncer feature aids in discriminating between valid and invalid input signals and only lets valid signals pass to the camera The debouncer value specifies the minimum time that an input signal must remain high or remain low in order to be considered a valid input signal The debouncer delays a valid signal between its arrival at the camera and its transfer The duration of the delay will ...

Страница 59: ... debouncer time in µs You can set the LineSelector and the LineDebouncerTime 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_CC0 Set the parameter value e g to 10 microseconds camera LineDebouncerTime SetValue...

Страница 60: ...true to enable inversion on the selected line or to false to disable inversion You can set the LineSelector and the LineInverter parameter values 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 Select the input line camera LineSelector SetValue LineSelector_CC0 Enable the inverter on the i...

Страница 61: ...n 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 Flash Window signal as the source signal for the BCON output line 1 camera LineSelector SetValue LineSelector_Line1 camera LineSource SetValue LineSource_FlashWindow For more information about the flash window signal see Section 9 6 2...

Страница 62: ...table camera LineSelector SetValue LineSelector_Line1 camera LineSource SetValue LineSource_UserOutput1 Set the status of output line 2 camera UserOutputSelector SetValue UserOutputSelector_UserOutput2 camera UserOutputValue SetValue true Get informed about the current user output value setting for output line 2 bool b camera UserOutputValue GetValue 8 2 3 Output Line Inverter You can set the outp...

Страница 63: ...f false means the line s status is currently low You can set the LineSelector and read the LineStatus 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 input line CC0 and read the status camera LineSelector SetValue LineSelector_CC0 bool b camera LineStatus...

Страница 64: ...o read the parameter value Read the line status of both I O lines Because the GenICam interface does not support 32 bit words the line status is reported as a 64 bit value int64_t i camera LineStatusAll GetValue LineStatusAll Parameter Value Binary Expression of the LineStatusAll Parameter Value Hexadecimal Number Binary Number Line 1 Output Line Line 2 Output Line Line 3 Input Line 0x0 000 0 0 0 ...

Страница 65: ...d continuous The use of AcquisitionStart and AcquisitionStop commands and the camera s AcquisitionMode parameter setting are related If the camera s AcquisitionMode parameter is set for single frame after an AcquisitionStart command has been executed a single frame can be acquired When acquisition of one frame is complete the camera will execute an AcquisitionStop command internally and will no lo...

Страница 66: ...ing These parameters are discussed later in this chapter camera AcquisitionMode SetValue AcquisitionMode_SingleFrame camera TriggerMode SetValue TriggerMode_On camera TriggerSource SetValue TriggerSource_CC0 camera TriggerActivation SetValue TriggerActivation_RisingEdge camera ExposureMode SetValue ExposureMode_Timed camera ExposureTime SetValue 3000 0 camera AcquisitionStart Execute When the came...

Страница 67: ...ame acquisition For more information see Section 9 2 2 on page 62 Frame start trigger signals are applied via hardware Each time a proper electrical signal is applied to the input line the camera will begin a frame acquisition For more information see Section 9 2 3 on page 63 9 2 1 Trigger Mode The main parameter associated with the frame start trigger is the TriggerMode parameter The TriggerMode ...

Страница 68: ...lowing code snippet illustrates using the API to set the Acquisition Mode to Continuous the Trigger Mode to Off free run and the Acquisition Frame Rate to 60 Set the acquisition mode to Continuous camera AcquisitionMode SetValue AcquisitionMode_Continuous Set the timed exposure mode camera ExposureMode SetValue ExposureMode_Timed Set the exposure time camera ExposureTime SetValue 3000 0 Set the fr...

Страница 69: ... are RisingEdge specifies that the rising edge of the electrical signal will act as the frame start trigger FallingEdge specifies that the falling edge of the electrical signal will act as the frame start trigger For more information about using a software trigger see Section 9 2 2 on page 62 using a hardware trigger see Section 9 2 3 on page 63 Do not trigger frame acquisition at a rate that exce...

Страница 70: ... by setting the ImmediateTriggerMode parameter to one of the following values On Exposure starts immediately after triggering but changes to image parameters become effective with a short delay i e after one or more images have been acquired This is useful if you want to minimize the exposure start delay i e if you want to start image acquisition as soon as possible and if your imaging conditions ...

Страница 71: ...reTime SetValue 3000 0 Execute an AcquisitionStart command to prepare for frame acquisition camera AcquisitionStart Execute while finished Execute a TriggerSoftware command to apply a frame start trigger signal to the camera camera TriggerSoftware Execute Retrieve acquired frame here camera AcquisitionStop Execute 9 2 3 Using a Hardware Frame Start Trigger If the TriggerMode parameter is set to On...

Страница 72: ...s determined by the value of the camera s ExposureTime parameter If the camera is set for rising edge triggering the exposure time starts when the ExFSTrig signal rises falling edge triggering the exposure time starts when the ExFSTrig signal falls Figure 25 illustrates timed exposure with the camera set for rising edge triggering When adjusting the settings make sure not to exceed the maximum all...

Страница 73: ...e ExFSTrig signal Trigger width exposure is especially useful if you intend to vary the length of the exposure time for each captured frame If the camera is set for rising edge triggering the exposure time begins when the ExFSTrig signal rises and continues until the ExFSTrig signal falls falling edge triggering the exposure time begins when the ExFSTrig signal falls and continues until the ExFSTr...

Страница 74: ...frame camera AcquisitionMode SetValue AcquisitionMode_SingleFrame Set the trigger mode to On camera TriggerMode SetValue TriggerMode_On Set the immediate trigger mode to Off camera ImmediateTriggerMode SetValue ImmediateTriggerMode_Off Set the source for the selected trigger camera TriggerSource SetValue TriggerSource_CC0 Set the trigger activation mode to rising edge camera TriggerActivation SetV...

Страница 75: ...tValue 40 0 By default the exposure auto function is enabled Manual adjustment of the exposure time will not work Set the ExposureAuto parameter to Off before making any manual adjustments For more information about the exposure auto function see Section 11 11 4 on page 117 Camera Model Minimum Allowed Exposure Time Maximum Possible Exposure Time Increment daA1600 60bm bc 10 µs 850000 µs 1 µs All ...

Страница 76: ...ctronic Rolling Shutter ERS Global Reset Release Mode GRR For moving objects For stationary objects not moving objects Lower ambient noise If used for moving objects Use of flash lighting and flash window recommended For stationary objects not moving objects Use of flash lighting and flash window is a must Table 25 Overview of Shutter Modes Camera Model Shutter Type Supported Shutter Modes daA1280...

Страница 77: ...ach acquired image and it helps to minimize problems with acquiring images of objects in motion Immediately after the end of exposure pixel data readout begins and proceeds in a linewise fashion until all pixel data is read out of the sensor Camera Model Global Shutter Available daA1280 54bm bc daA1600 60bm bc Yes daA2500 14bm bc No Table 27 Global Shutter Availability Line 1 Line 2 Line 4 Line 3 ...

Страница 78: ...next When frame start is triggered the camera resets line one of the ROI and begins exposing line one resets line two a short time later temporal offset and begins exposing line two resets line three a short time later than line two additional temporal offset and begins exposing line three And so on until the bottom line of pixels is reached see Figure 30 Camera Model Rolling Shutter Available daA...

Страница 79: ...ure time for line one is determined by the ExposureTime parameter setting for line two will end a short time temporal offset after the exposure ends for line one for line three will end another short time temporal offset after the exposure ends for line two And so on until the bottom line of pixels is reached see Figure 31 The pixel values for each line are read out at the end of exposure time for...

Страница 80: ... will vary significantly from top to bottom due to the differences in the exposure times of the lines moving objects the brightness in each acquired image will vary significantly from top to bottom due to the differences in the exposure times of the lines and the images will be distorted due to the temporal shift between the end of exposure for each line You can avoid these problems by using flash...

Страница 81: ... with the camera set for the trigger width exposure mode In the overlap mode of operation the exposure of a new frame begins while the camera is still reading out the sensor data for the previously acquired frame This situation is illustrated in Figure 33 with the camera set for the trigger width exposure mode Frame Acquisition N Exposure Sensor Readout Frame Acquisition N 1 Exposure Sensor Readou...

Страница 82: ...e 59 To allow overlapping image acquisitions the camera must be in the continuous acquisition mode Overlapping image acquisition can t be performed if the camera s acquisition mode is set to single frame For more information about the acquisition mode see Section 9 1 on page 57 Camera Model Rolling Shutter Mode Trigger Mode Overlapping Image Acquisitions allowed daA1280 54bm bc daA1600 60bm bc Not...

Страница 83: ...on overlap mode of operation see Section 9 5 on page 73 The following code snippet illustrates using the pylon API to set the OverlapMode parameter value Set for the overlapping mode of operation camera OverlapMode SetValue OverlapMode_On Set for the non overlapping mode of operation camera OverlapMode SetValue OverlapMode_Off 9 6 Acquisition Monitoring Tools 9 6 1 Exposure Active Signal Cameras w...

Страница 84: ...selector and the parameter value camera LineSelector SetValue LineSelector_Line1 camera LineSource SetValue LineSource_ExposureActive For more information about changing the selection of an output signal as the source signal for the output line see Section 8 2 1 on page 53 9 6 2 Flash Window Signal Cameras with a rolling shutter imaging sensor provide a flash window output signal to aid you in the...

Страница 85: ...n 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_Line1 camera LineSource SetValue LineSource_FlashWindow For more information about changing the selection of an output signal as the source signal for the output line see Section 8 2 2 on page 53 The flash window signal ...

Страница 86: ... overlapping image acquisitions see Section 9 5 on page 73 To determine the maximum allowed acquisition frame rate with your current camera settings use the Basler pylon API to read the value of the camera s ResultingFrameRate parameter For more information see Section 9 7 1 on page 78 9 7 1 Using the Basler pylon API to Check the Maximum Allowed Frame Rate You can use the Basler pylon API to read...

Страница 87: ...allowed frame rate increases You may need to compensate for a lower exposure time by using a brighter light source or increasing the opening of your lens aperture If your camera is equipped with a rolling shutter use the electronic rolling shutter ERS mode rather than the global reset release shutter mode The ERS mode allows overlapping frame acquisition while the global reset release mode does no...

Страница 88: ...g the Basler pylon API The following code snippet illustrates using the API to set the pixel format to Bayer GB 12 Set the pixel format to Bayer GB 12 camera PixelFormat SetValue PixelFormat_BayerGB12 The standard alignment of the Bayer filter to the pixels in the images acquired by the dart BCON color cameras is GB If you are using dart model daA1600 60bc or daA2500 14bc the alignment will change...

Страница 89: ...olor model The conversion algorithm uses the following formulas Y 0 299 R 0 587 G 0 114 B Cb 0 16874 R 0 33126 G 0 5000 B 128 Cr 0 5000 R 0 41869 G 0 08131 B 128 After conversion to the YCbCr color model is complete the pixel data is transmitted out of the camera Bayer Formats All dart BCON color cameras can output color images based on the pixel formats Bayer 8 and Bayer 12 When a color camera is...

Страница 90: ...erse X Reverse Y Section 11 9 Binning Section 11 8 Image ROI Section 11 7 Black Level Section 11 3 Gain Section 11 2 On daA1280 54bm uc camera models black level settings are applied after the gain settings Color camera models only Can be used in any sequence Light Source Preset Section 11 6 2 Balance White Section 11 6 3 Gamma Section 11 4 Hue Saturation Section 11 6 4 Brightness Contrast Section...

Страница 91: ...he 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 This section describes how gain can be adjusted manually by setting the value of the Gain parameter The camera also has a gain auto function that can automatically adjust the gain The camera s gain is determined by the value of the Gain parameter The...

Страница 92: ...be adjusted by changing the value of the BlackLevel parameter The range of the allowed settings for the BlackLevel parameter value in DN varies by pixel format as shown in Table 33 You can set the BlackLevel 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 Set the black level to 1 0 c...

Страница 93: ...tion value You can set the BslColorSpaceMode parameter to the following values sRGB The image brightness is optimized for display on an sRGB monitor An additional gamma correction value of approximately 0 4 is applied This is the default setting Note that the sRGB gamma correction is independent from the Gamma parameter and will not be reflected in the Gamma parameter value Example You set the Bsl...

Страница 94: ... range from 1 to 1 By default the parameter is set to 0 and no brightness adjustment is performed Adjusting the brightness moves the pivot point of the Brightness Contrast function Figure 38 shows an example for the S curve contrast mode set For more information about contrast and contrast modes see Section 11 5 2 on page 87 If you increase the brightness the pivot point moves towards the upper le...

Страница 95: ...n in Figure 41 input values from 0 to approximately 50 are set to completely black and input values from approximately 205 to 255 are set to completely white This means that the overall range of tonal values i e the dynamic range of the image is decreased The darkest and lightest regions of the image will appear completely black or completely white but the other areas will appear more defined Decr...

Страница 96: ...ax Ymax the dynamic range of the image is always preserved Setting contrast below 0 in S curve mode results in an inverted S curve with opposite effects 11 5 3 Setting Brightness and Contrast You can set brightness and contrast within your application software by using the pylon API The following code snippet illustrates using the API to set the parameters Set the Brightness parameter value to 0 5...

Страница 97: ...r filter used on the camera is as shown in Figure 43 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 Bayer GB alignment for example means that pixel one and pixel two of the first line in each image transmitted will be green and blue re...

Страница 98: ... inaccuracies caused by the image sensor The standard alignment of the Bayer filter to the pixels in the images acquired by the dart BCON color cameras is GB If you are using dart model daA1280 54bc this alignment is fixed If you are using dart model daA1600 60bc or daA2500 14bc the alignment will change if you enable image mirroring If you use the Reverse X feature to mirror the image horizontall...

Страница 99: ...e balance white auto function is disabled white balance must be reset before changing the preset camera BalanceWhiteAuto SetValue BalanceWhiteAuto_Off camera BalanceRatioSelector SetValue BalanceRatioSelector_Red camera BalanceRatio SetValue 1 camera BalanceRatioSelector SetValue BalanceRatioSelector_Green camera BalanceRatio SetValue 1 camera BalanceRatioSelector SetValue BalanceRatioSelector_Blu...

Страница 100: ...anceRatio parameter value can range from 1 to 7 984375 BalanceRatio 1 The intensity of the color is unaffected by the white balance mechanism Balance ratio 1 The intensity of the color is increased relative to the other two colors Balance ratio 1 The intensity of the color is decreased relative to the other two colors The increase or decrease in intensity is proportional For example if the balance...

Страница 101: ...ration for example will make colors easier to distinguish You can adjust the saturation by setting the BslSaturation parameter By default the parameter is set to 1 normal saturation Lower parameter values result in more muted colors that are closer to gray Higher parameter values result in more vivid vibrant colors Setting Hue and Saturation You can set hue and saturation within your application s...

Страница 102: ...re done automatically and can t be controlled by the user The PGI image optimizations take effect whenever the pixel format is set to YCbCr422 or RGB 8 To disable PGI image optimizations set the pixel format to Bayer 8 or Bayer 12 For more information about pixel formats see Chapter 10 on page 80 the Sharpness Enhancement feature see Section 11 6 6 on page 95 the PGI image optimizations see the wh...

Страница 103: ...e pylon API The following code snippet illustrates using the API to set the SharpnessEnhancement parameter value Set the SharpnessEnhancement parameter value to 0 39 camera SharpnessEnhancement SetValue 0 39 The Sharpness Enhancement feature is only available if the pixel format is set to YCbCr422 or RGB 8 For more information about pixel formats see Chapter 10 on page 80 If you use the Gain and t...

Страница 104: ...black level and gain so that you are acquiring good quality images It is important to make sure that the images are not overexposed Overexposure can have a significant negative effect on the fidelity of the color in the acquired images Generally the settings for black level and gain should be as low as possible 8 Adjust the white balance Make sure a white or light gray object is imaged while white...

Страница 105: ...a height For example suppose that you specify the offset X as 10 the width as 16 the offset Y as 6 and the height as 10 The region of the array that is bounded by these settings is shown in Figure 44 The camera will only transmit pixel data from within the region defined by your settings Information from the pixels outside of the region of interest is discarded One of the main advantages of the Im...

Страница 106: ...t Y ROI height Height of camera sensor daA1600 60um Offset Y 351 ROI height 200 Height of camera sensor 1200 351 200 1200 Table 34 Guidelines for Setting the Camera s ROI ROI Parameters Camera Model Parameter Range Example OffsetX OffsetY daA1280 54bm bc daA1600 60bc daA2500 14bm bc Can be set in increments of 2 Must be set to an even number 0 2 4 6 8 etc OffsetX daA1600 60bm Can be set in increme...

Страница 107: ...ting the OffsetX OffsetY Width and Height parameter values int64_t i camera WidthMax GetValue int64_t i camera HeightMax GetValue camera Width SetValue 1294 camera Height SetValue 964 camera OffsetY SetValue 0 camera OffsetX SetValue 0 Changing ROI Parameters On the Fly Making ROI parameter changes on the fly means making the parameter changes while the camera is capturing images continuously On t...

Страница 108: ... distorted in the image For more information about possible image distortion see Section 11 8 3 on page 104 The number of binned pixels depends on the horizontal binning and the vertical binning settings For more information about the binning settings see Section 11 8 1 on page 101 Binning Modes Two modes can be used to perform binning Sum The values of the affected pixels are summed This increase...

Страница 109: ... enable horizontal binning by setting the BinningHorizontal parameter vertical binning by setting the BinningVertical parameter Setting the parameter s value to 2 3 or 4 enables horizontal or vertical binning by 2 by 3 or by 4 respectively Setting the parameter s value to 1 disables horizontal or vertical binning Vertical Binning by 2 Horizontal Binning by 4 Fig 45 Binning on Monochrome Cameras Ve...

Страница 110: ...meter first then set the BinningVertical parameter If the BinningHorizontal parameter is not set first some combinations of vertical binning and horizontal binning can t be achieved For a list of allowed combinations see Table 36 Example On daA1600 60bm bc cameras you can t set the BinningVertical parameter to 2 when the BinningHorizontal parameter is set to 1 Set the BinningHorizontal parameter t...

Страница 111: ...Sum Determine the vertical binning mode e camera BinningVerticalMode GetValue Always set the BinningHorizontalMode parameter first then set the BinningVerticalMode parameter If the BinningHorizontalMode parameter is not set first some combinations of the binning horizontal mode and the binning vertical mode can t be achieved For a list of allowed combinations see Table 37 Example On daA1600 60bm b...

Страница 112: ...n page 100 can greatly increase the camera s response to light When pixel values are summed the acquired images may look overexposed If this is the case you can reduce the lens aperture the intensity of your illumination the camera s exposure time setting or the camera s gain setting Reduced Resolution Using binning effectively reduces the resolution of the camera s imaging sensor For example the ...

Страница 113: ...ured image will be swapped end for end about the line s center This means that for each line the value of the first pixel in the line will be swapped with the value of the last pixel the value of the second pixel in the line will be swapped with the value of the next to last pixel and so on Figure 47 shows a normal image on the left and an image captured with reverse X enabled on the right If you ...

Страница 114: ...vertical mirror image feature When the Reverse Y feature is enabled the lines in a captured image will be swapped top to bottom This means that the top line in the im age will be swapped with the bottom line the next to top line will be swapped with the next to bot tom line and so on Figure 49 shows a normal image on the left and an image captured with reverse Y enabled on the right If you are usi...

Страница 115: ... remains the same regardless of whether or not the Reverse Y feature is enabled As a consequence different regions of the image will be controlled or displayed depending on whether or not the Reverse Y feature is enabled See example in Figure 50 Fig 49 Reverse Y Mirror Imaging Normal Image Reverse Y Mirror Image Fig 50 Using an ROI with Reverse Y Mirror Imaging Normal Image Reverse Y Mirror Image ...

Страница 116: ...atures by setting the ReverseX and the ReverseY parameter values You can use the pylon API to set the parameter values from within your application software The following code snippet illustrates using the API to set the parameter values Enable reverse X camera ReverseX SetValue true Enable reverse Y camera ReverseY SetValue true ...

Страница 117: ...nly corrects pixels that have a significantly greater intensity value than its neighboring pixels You can specify which corrections should be performed by setting the DefectPixelCorrectionMode parameter On default Static and dynamic pixel corrections are both enabled Off Static and dynamic pixel corrections are both disabled StaticOnly Only the static pixel correction is enabled You can set the De...

Страница 118: ...eration is selected the parameter values are automatically adjusted until the related image property reaches the target value After the automatic parameter value adjustment is complete the auto function will automatically be set to Off and the new parameter value will be applied to the following images By default all auto functions exposure auto balance white auto and gain auto are enabled They ar...

Страница 119: ...o Off 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 If an auto function is set to the Once operation mode and the circumstances prevent that a target value for an image property is reached the auto function will try to reach that target value for a maximum of 50 or 100 images depending o...

Страница 120: ...ttings are always identical for both auto functions This does not imply however that Gain Auto and Exposure Auto must always be used at the same time The pixel data from Auto Function ROI 2 serves as the base for Balance White Auto These presets are fixed and can t be changed The location and size of an Auto Function ROI is defined by declaring an X offset a Y offset a width and a height Auto Func...

Страница 121: ... pylon API The following code snippets illustrate using the API to select an Auto Function ROI and set its size and position Select Auto Function ROI 1 camera AutoFunctionROISelector SetValue AutoFunctionROISelector_ROI1 Set position and size for the selected Auto Function ROI camera AutoFunctionROIOffsetX SetValue 10 camera AutoFunctionROIOffsetY SetValue 10 camera AutoFunctionROIWidth SetValue 5...

Страница 122: ...e image property If the Image ROI is completely included in the Auto Function ROI see b in Figure 52 only the pixel data from the Image ROI will be used to control the image property If the Image ROI only partially overlaps the Auto Function ROI see c in Figure 52 only the pixel data from the area of partial overlap will be used to control the image property If the Auto Function ROI does not overl...

Страница 123: ... 13 14 15 16 17 18 19 0 1 0 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 Fig 52 Various Degrees of Overlap Between the Auto Function ROI and the Image ROI Image ROI Auto Function ROI a c d Image ROI Image ROI Auto Function ROI Auto Function ROI 0 1 0 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 ...

Страница 124: ...Gain parameter value will never be lower than 2 and never be higher than 6 Target Value When the gain auto function is enabled it adjusts the gain until a target brightness i e an average gray value is reached You can set the target value using the AutoTargetBrightness parameter The parameter value range refers to the theoretically maximum available range of gray values for the set pixel format Ex...

Страница 125: ...ontinuous camera GainAuto SetValue GainAuto_Continuous For more information about auto functions see Section 11 11 on page 110 11 11 4 Exposure Auto Exposure Auto is the automatic counterpart to manually setting the ExposureTime parameter The exposure auto function automatically adjusts the ExposureTime parameter value within set limits until a target brightness value for the pixel data is reached...

Страница 126: ...TimeUpperLimit parame ters 2 Set the value of the AutoTargetBrightness parameter 3 Set the value of the ExposureAuto parameter for the Once or the Continuous mode of operation You can set the exposure auto function from within your application software by using the pylon API The following code snippets illustrate using the API to set the exposure auto function Set the lowest possible lower limit a...

Страница 127: ...or the Continuous mode of operation You can set the white balance auto functionality from within your application software by using the pylon API The following code snippets illustrate using the API to set the balance auto functionality Set mode of operation for balance white auto function to Once camera BalanceWhiteAuto SetValue BalanceWhiteAuto_Once Set mode of operation for balance white auto f...

Страница 128: ... 50 Hz or a 60 Hz rate the flickering lights can cause significant changes in brightness from image to image Enabling the anti flicker profile may reduce the effect of the flickering in the captured images Depending on your local power line frequency e g North America 60 Hz Europe 50 Hz set the auto function profile to AntiFlicker50Hz or to AntiFlicker60Hz 1 Set the value of the AutoFunctionProfil...

Страница 129: ...formed by the gain auto function and the exposure auto function see Section 11 11 3 on page 116 and Section 11 11 4 on page 117 For example if you set the parameter value to 0 3 then 30 of the brightest pixels in the image will not be taken into account for the target value calculations This allows the camera to properly expose the darker regions of the image You can set the backlight compensation...

Страница 130: ... software by using the Basler pylon API The following code snippets illustrate using the API to set the parameter Set for no test pattern camera TestPattern SetValue TestPattern_Off Set for the first test pattern camera TestPattern SetValue TestPattern_GreyDiagonalSawtooth8 Set for the second test pattern camera TestPattern SetValue TestPattern_ColorDiagonalSawtooth8 Test Pattern 1 Gray Diagonal S...

Страница 131: ...er dart BCON 123 Test Pattern 2 Color Diagonal Sawtooth The test pattern Color Diagonal Sawtooth is available on color cameras only As shown in Figure 54 the test pattern consists of diagonal color gradients Fig 54 Test Pattern 2 ...

Страница 132: ...ample area scan SensorWidth read only contains the physical width of the sensor in pixels SensorHeight read only contains the physical height of the sensor in pixels MaxWidth read only Indicates the camera s maximum region of interest ROI width setting for the current OffsetX settings MaxHeight read only Indicates the camera s maximum region of interest ROI height setting for the current OffsetY s...

Страница 133: ...ue Read the DeviceScanType parameter DeviceScanTypeEnums e camera DeviceScanType GetValue Read the SensorWidth parameter int64_t i camera SensorWidth GetValue Read the SensorHeight parameter int64_t i camera SensorHeight GetValue Read the WidthMax parameter int64_t i camera WidthMax GetValue Read the HeightMax parameter int64_t i camera HeightMax GetValue ...

Страница 134: ...ra is reset or if power is switched off Factory Set Default When a camera is manufactured numerous tests are performed on the camera and a factory optimized setup is determined This factory setup is stored in the Default set It is optimized for average conditions and will provide good camera performance in many common applications In the Default set the gain auto exposure auto and white balance au...

Страница 135: ...see Section 11 15 3 on page 129 11 15 1 Saving a User Set After setting your camera parameter values you can save most of the settings for further use into User Set 1 User Set 2 or User Set 3 These user sets are not lost when the camera is reset or switched off 1 Make changes to the camera s settings until the camera is operating in a manner that you would like to save 2 Set the UserSetSelector pa...

Страница 136: ...ommand from within your application software by using the pylon API The following code snippets illustrate using the API select User Set 2 and execute the load command camera UserSetSelector SetValue UserSetSelector_UserSet2 camera UserSetLoad Execute To load a user set or the factory set into the active set Loading a user set or the factory set into the active set is only allowed when the camera ...

Страница 137: ...s not acquiring images continuously or does not have a single image acquisition pending Set the UserSetDefault parameter to UserSet1 UserSet2 UserSet3 or to Default You can set the UserSetDefault parameter from within your application software by using the pylon API The following code snippets illustrate using the API to set the selector camera UserSetDefault SetValue UserSetDefault_UserSet1 To de...

Страница 138: ...b com If you do decide to contact Basler technical support please take a look at Section 12 3 on page 131 before you call The section gives information about assembling relevant data that will help the Basler technical support team to help you with your problem 12 2 Obtaining an RMA Number Whenever you want to return material to Basler you must request a Return Material Authorization RMA number be...

Страница 139: ...rt use the form given below 1 Copy the form that appears below fill it out and send it with sample images if appropriate attached to your e mail to Basler technical support or fax the completed form with the requested files attached to your local dealer or to Basler technical support To use the form 1 The camera s product ID 2 The camera s serial number 3 Hardware that you use with the camera 4 De...

Страница 140: ...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 If you can t access the camera please try to state the following parameter settings Image Size ROI Pixel Format Exposure Time Frame Rate 11 Live image test pattern If you are having an image problem try to generate and save live images that show...

Страница 141: ...m 32 36 color anti aliasing 94 color creation 89 color enhancement procedure 96 color filter alignment 80 89 90 105 106 color space mode 81 85 contrast linear 87 S curve 87 D data lanes 33 44 debayering 94 defect pixel correction 109 denoising 94 device information parameters 124 device version parameter 124 dimensions 14 duty cycle 41 E electronic rolling shutter mode 68 70 ERS mode see electroni...

Страница 142: ...O offset X 97 offset Y 97 outlier pixels 109 output bits 32 37 output clock 41 overlap mode 73 75 overtriggering 61 66 P PGI feature set 94 physical sensor 104 pixel formats 38 pixels per clock cycle 39 power supply 4 47 LPS 4 SELV 4 precautions 3 R reduced resolution 104 region of interest see image region of interest reverse X 105 reverse Y 106 ROI see image region of interest S saving parameter...

Страница 143: ... temperature 21 temperature measurement point 21 test images 122 test patterns 122 typographic conventions 2 U underexposure 121 user ID parameter 124 user output 53 user set saving 127 V vendor name parameter 124 vertical mirror image 106 W white balance see balance white white balance auto see balance white auto word alignment 37 ...

Страница 144: ...art BCON Revision History Doc ID Number Date Changes AW00136901000 23 Jun 2016 Initial release of this document AW00136902000 01 Nov 2016 Modifications and corrections related to the development of the camera from prototype to serial production ...

Отзывы: