Download
Share
Print this page
  1. Manuals
  2. Brands
  3. Basler Manuals
  4. Digital Camera
  5. ace acA640-90gm
  6. User manual

Basler ace acA2040-35 User Manual

Gige cameras
Hide thumbs
1
2
3
4
Table Of Contents
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
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488

Advertisement

Quick Links

Download this manual
Basler ace
USER'S MANUAL FOR GigE CAMERAS
Document Number: AW000893
Version: 25 Language: 000 (English)
Release Date: 31 October 2016
The manual includes information about the
following prototype cameras: acA2040-35 and
acA2440-20.

Advertisement

loading
Need help?

Need help?

Do you have a question about the ace acA2040-35 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Basler ace acA2040-35

Summary of Contents for Basler ace acA2040-35

  • Page 1 Basler ace USER’S MANUAL FOR GigE CAMERAS Document Number: AW000893 Version: 25 Language: 000 (English) Release Date: 31 October 2016 The manual includes information about the following prototype cameras: acA2040-35 and acA2440-20.
  • 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.

  • Page 3: Warranty Information

    Make sure the cameras are constantly powered up, and the ambient temperature is constant. See specific notice on page Read the manual Read the manual carefully before using the camera. All material in this publication is subject to change without notice and is copyright Basler AG.

  • Page 4: Contacting Basler Support Worldwide

    Contacting Basler Support Worldwide Europe, Middle East, Africa Basler AG An der Strusbek 60–62 22926 Ahrensburg Germany Tel. +49 4102 463 515 Fax +49 4102 463 599 support.europe@baslerweb.com The Americas Basler, Inc. 855 Springdale Drive, Suite 203 Exton, PA 19341 Tel.

  • Page 5: Table Of Contents

    Basler pylon IP Configurator ........
  • Page 6 5.11.8.2 Setting the Timer Delay Time ......130 5.11.8.3 Setting the Timer Duration Time ......132 Basler ace GigE...
  • Page 7 Setting the Shutter Mode ........184 † in Table 37) . . . 184 6.7.3.1 Setting the Shutter Mode (Camera Models See 6.7.3.2 Setting the Shutter Mode (acA1920-25, acA2500-14)..185 Basler ace GigE...
  • Page 8 6.13 Maximum Allowed Frame Rate ......... 218 6.13.1 Using Basler pylon to Check the Maximum Allowed Frame Rate ..219 6.13.2 Increasing the Maximum Allowed Frame Rate .
  • Page 9 8.18.2.1 Bayer Color Filter Alignment ......351 8.18.2.2 Pixel Formats Available on Cameras with a Bayer Filter..352 Basler ace GigE...
  • Page 10 What are Chunk Features? ..........419 Chunk Mode Active and Enabling the Extended Data Chunk ....420 Basler ace GigE...
  • Page 11 10.2 Obtaining an RMA Number..........432 10.3 Before Contacting Basler Technical Support ....... 433...

  • Page 12: Specifications, Requirements, And Precautions

    We strongly recommend that you read and follow the precautions. Camera 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 resolution, their maximum frame rate at full resolution, and whether the camera’s sensor is mono or color.

  • Page 13: Specification Notes

    ReverseX nor ReverseY are enabled. Different effective alignments apply when ReverseX and/or ReverseY are enabled. For more information about the Reverse X and Reverse Y features and related effective Bayer filter alignments, see Section 8.16 on page 341. Basler ace GigE...

  • Page 14: General Specifications Of Camera Models

    YUV 4:2:2 (YUYV) Packed ADC Bit Depth 12 bits Synchronization Via hardware trigger, via software trigger, or free run Exposure Time Via hardware trigger or programmable via the camera API Control Table 1: General Specifications (acA640-90gm/gc, acA640-120gm/gc) Basler ace GigE...
  • Page 15 <90 g Conformity CE (includes RoHS), UL Listed, FCC, GenICam, GigE Vision, IP30, IEEE 802.3af (PoE), REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86, x64, ARM).
  • Page 16 ≈ 2.4 W, when supplied via the camera’s 6- pin connector pin connector I/O Ports 1 opto-isolated input line and 1 opto-isolated output line Power supplies must meet the SELV and LPS requirements (see page 71). Table 2: General Specifications (acA645-100gm/gc, acA750-30gm/gc) Basler ace GigE...
  • Page 17 <90 g Conformity CE (includes RoHS), UL Listed, FCC, GenICam, GigE Vision, IP30, IEEE 802.3af (PoE), REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86, x64, ARM).
  • Page 18 Note: When using extremely small AOIs, power consumption may increase to 2.9 W. I/O Ports 1 opto-isolated input line and 1 opto-isolated output line. Power supplies must meet the SELV and LPS requirements (see page 71). Table 3: General Specifications (acA780-75gm/gc, acA1300-22gm/gc) Basler ace GigE...
  • Page 19 <90 g Conformity CE (includes RoHS), UL Listed, FCC, GenICam, GigE Vision, IP30, IEEE 802.3af (PoE), REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86, x64, ARM).
  • Page 20 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 4: General Specifications (acA1300-30gm/gc, acA1600-20gm/gc) Basler ace GigE...
  • Page 21 <90 g Conformity CE (includes RoHS), UL Listed, FCC, GenICam, GigE Vision, IP30, IEEE 802.3af (PoE), REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86, x64, ARM).

  • Page 22: Cameras With Cmos Sensors

    1 opto-isolated input line, 1 opto-isolated output line. 1 GPIO (can be set to operate as an input or an output). Power supplies must meet the SELV and LPS requirements (see page 71). Table 5: General Specifications (acA640-300gm/gc, acA800-200gm/gc) Basler ace GigE...
  • Page 23 <90 g Conformity CE (includes RoHS), UL in preparation, FCC, GenICam, GigE Vision, IP30, IEEE 802.3af (PoE), REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86, x64, ARM).
  • Page 24 ≈ 2.0 W, when supplied via the camera’s 6-pin connector I/O Ports 1 opto-isolated input line and 1 opto-isolated output line. Power supplies must meet the SELV and LPS requirements (see page 71). Lens Adapter C-mount Table 6: General Specifications (acA1280-60gm/gc) Basler ace GigE...
  • Page 25 <90 g Conformity CE (includes RoHS), UL Listed, FCC, GenICam, GigE Vision, IP30, IEEE 802.3af (PoE), REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86, x64, ARM).
  • Page 26 Cable must be at least a 26 AWG cable. Max. cable length: 10 m ≈ 2.6 W when using Power over Ethernet ≈ 2.0 W, when supplied via the camera’s 6-pin connector Table 7: General Specifications (acA1300-60gm/gc, acA1300-60gmNIR) Basler ace GigE...
  • Page 27 <90 g Conformity CE (includes RoHS), UL Listed, FCC, GenICam, GigE Vision, IP30, IEEE 802.3af (PoE), REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86, x64, ARM).
  • Page 28 1 opto-isolated input line, 1 opto-isolated output line. 1 GPIO (can be set to operate as an input or an output). Power supplies must meet the SELV and LPS requirements (see page 71). Table 8: General Specifications (acA1300-75gm/gc) Basler ace GigE...
  • Page 29 <90 g Conformity CE (includes RoHS), UL in preparation, FCC, GenICam, GigE Vision, IP30, IEEE 802.3af (PoE), REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86, x64, ARM).
  • Page 30 ≈ 2.7 W when using Power over Ethernet ≈ 2.7 W when using Power over Ethernet ≈ 2.2 W, when supplied via the camera’s 6- ≈ 2.1 W, when supplied via the camera’s 6- pin connector pin connector Table 9: General Specifications (acA1600-60gm/gc, acA1920-25gm/gc) Basler ace GigE...
  • Page 31 <90 g Conformity CE (includes RoHS), UL Listed, FCC, GenICam, GigE Vision, IP30, IEEE 802.3af (PoE), REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86, x64, ARM).
  • Page 32 1 opto-isolated input line, 1 opto-isolated output line. 1 GPIO (can be set to operate as an input or an output). Power supplies must meet the SELV and LPS requirements (see page 71). Lens Adapter C-mount Table 10: General Specifications (acA1920-40gm/gc) Basler ace GigE...
  • Page 33 CE (includes RoHS), UL in preparation, FCC, GenICam, GigE Vision, IP30, IEEE 802.3af (PoE), REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86, x64, ARM).
  • Page 34 1 opto-isolated input line, 1 opto-isolated output line. 1 GPIO (can be set to operate as an input or an output). Power supplies must meet the SELV and LPS requirements (see page 71). Table 11: General Specifications (acA1920-48gm/gc) Basler ace GigE...
  • Page 35 <90 g Conformity CE (includes RoHS), UL in preparation, FCC, GenICam, GigE Vision, IP30, IEEE 802.3af (PoE), REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86, x64, ARM).
  • Page 36 1 opto-isolated input line, 1 opto-isolated output line. 1 GPIO (can be set to operate as an input or an output). Power supplies must meet the SELV and LPS requirements (see page 71). Lens Adapter C-mount Table 12: General Specifications (acA1920-50gm/gc) Basler ace GigE...
  • Page 37 <90 g Conformity CE (includes RoHS), UL in preparation, FCC, GenICam, GigE Vision, IP30, IEEE 802.3af (PoE), REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86, x64, ARM).
  • Page 38 ≈ 3.0 W when using Power over Ethernet ≈ 3.1 W when using Power over Ethernet ≈ 2.5 W, when supplied via the camera’s 6-pin connector ≈ 2.6 W, when supplied via the camera’s 6-pin connector Table 13: General Specifications (acA2000-50gm/gc, acA2000-50gmNIR, acA2040-25gm/gc) Basler ace GigE...
  • Page 39 <90 g Conformity CE (includes RoHS), UL Listed, FCC, GenICam, GigE Vision, IP30, IEEE 802.3af (PoE), REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86, x64, ARM).
  • Page 40 <90 g Conformity CE (includes RoHS), UL Listed, FCC, GenICam, GigE Vision, IP30, IEEE 802.3af (PoE), REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86, x64, ARM).
  • Page 41 1 opto-isolated input line, 1 opto-isolated output line. 1 GPIO (can be set to operate as an input or an output). Power supplies must meet the SELV and LPS requirements (see page 71). Lens Adapter C-mount Table 15: General Specifications (acA2040-35gm/gc) Basler ace GigE...
  • Page 42 <90 g Conformity CE (includes RoHS), UL in preparation, FCC, GenICam, GigE Vision, IP30, IEEE 802.3af (PoE), REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86, x64, ARM).
  • Page 43 1 opto-isolated input line, 1 opto-isolated output line. 1 GPIO (can be set to operate as an input or an output). Power supplies must meet the SELV and LPS requirements (see page 71). Lens Adapter C-mount Table 16: General Specifications (acA2440-20gm/gc) Basler ace GigE...
  • Page 44 <90 g Conformity CE (includes RoHS), UL in preparation, FCC, GenICam, GigE Vision, IP30, IEEE 802.3af (PoE), REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86, x64, ARM).
  • Page 45 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) Weight <90 g Table 17: General Specifications (acA2500-14gm/gc) Basler ace GigE...
  • Page 46 Conformity CE (includes RoHS), UL Listed, FCC, GenICam, GigE Vision, IP30, IEEE 802.3af (PoE), REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86, x64, ARM).
  • Page 47 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 18: General Specifications (acA2500-20gm/gc) Basler ace GigE...
  • Page 48 <90 g Conformity CE (includes RoHS), UL in preparation, FCC, GenICam, GigE Vision, IP30, IEEE 802.3af (PoE), REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86, x64, ARM).
  • Page 49 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 19: General Specifications (acA3800-10gm/gc, acA4600-7gc) Basler ace GigE...
  • Page 50 <90 g Conformity CE (includes RoHS), UL Listed, FCC, GenICam, GigE Vision, IP30, IEEE 802.3af (PoE), REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86, x64, ARM).

  • Page 51: Spectral Response

    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 (From Sensor Data Sheet) Basler ace GigE...
  • Page 52 Specifications, Requirements, and Precautions AW00089325000 Wavelength (nm) Fig. 2: acA640-120gm Spectral Response (From Sensor Data Sheet) 1000 1100 Wavelength (nm) Fig. 3: acA640-300gm, acA800-200gm, acA1300-75gm, acA1920-48gm, acA2500-20gm Spectral Response (From Sensor Data Sheet) Basler ace GigE...
  • Page 53 AW00089325000 Specifications, Requirements, and Precautions Wavelength (nm) Fig. 4: acA645-100gm Spectral Response (From Sensor Data Sheet) Wavelength (nm) Fig. 5: acA750-30gm Spectral Response (From Sensor Data Sheet) Basler ace GigE...
  • Page 54 Specifications, Requirements, and Precautions AW00089325000 Wavelength (nm) Fig. 6: acA780-75gm Spectral Response (From Sensor Data Sheet) 1000 Wavelength (nm) Fig. 7: acA1280-60gm, acA1300-60gm Spectral Response (From Sensor Data Sheet) Basler ace GigE...
  • Page 55 AW00089325000 Specifications, Requirements, and Precautions 70 0 8 00 100 0 Wavelength (nm) Fig. 8: acA1300-22gm, acA1300-30gm Spectral Response (From Sensor Data Sheet) 1000 Wavelength (nm) Fig. 9: acA1300-60gmNIR Spectral Response (From Sensor Data Sheet) Basler ace GigE...
  • Page 56 Specifications, Requirements, and Precautions AW00089325000 Wavelength (nm) Fig. 10: acA1600-20gm Spectral Response (From Sensor Data Sheet) 1000 1050 1100 Wavelength (nm) Fig. 11: acA1600-60gm Spectral Response (From Sensor Data Sheet) Basler ace GigE...
  • Page 57 AW00089325000 Specifications, Requirements, and Precautions 1000 Wavelength (nm) Fig. 12: acA1920-40gm, acA1920-50gm Spectral Response (From Sensor Data Sheet) 1000 Wavelength (nm) Fig. 13: acA2000-50gm, acA2040-25gm Spectral Response (From Sensor Data Sheet) Basler ace GigE...
  • Page 58 Specifications, Requirements, and Precautions AW00089325000 1000 Wavelength (nm) Fig. 14: acA2000-50gmNIR, acA2040-25gmNIR Spectral Response (From Sensor Data Sheet) Wavelength (nm) Fig. 15: acA2040-35gm and acA2440-20gm (From Sensor Data Sheet) Basler ace GigE...
  • Page 59 AW00089325000 Specifications, Requirements, and Precautions 1050 1150 Wavelength (nm) Fig. 16: acA2500-14gm, acA1920-25gm Spectral Response (From Sensor Data Sheet) 1000 Wavelength (nm) Fig. 17: acA3800-10gm Spectral Response (From Sensor Data Sheet) Basler ace GigE...

  • Page 60: Color Camera Spectral Response

    A suitable IR cut filter is built into the lens adapter on color models of the camera. For information about how to remove the IR cut filter holder, see the ace IR Cut Filter Holder Removal Procedure application note (AW000906). Blue Green Wavelength (nm) Fig. 18: acA640-90gc Spectral Response (From Sensor Data Sheet) Basler ace GigE...
  • Page 61 AW00089325000 Specifications, Requirements, and Precautions Blue Green Wavelength (nm) Fig. 19: acA640-120gc Spectral Response (From Sensor Data Sheet) Blue Green Wavelength (nm) Fig. 20: acA645-100gc Spectral Response (From Sensor Data Sheet) Basler ace GigE...
  • Page 62 Specifications, Requirements, and Precautions AW00089325000 Blue Green 1000 1100 Wavelength (nm) Fig. 21: acA640-300gc, acA800-200gc, acA1300-75gc, acA1920-48gc, acA2500-20gc Spectral Response (From Sensor Data Sheet) Cyan Magenta Yellow Green Wavelength (nm) Fig. 22: acA750-30gc Spectral Response (From Sensor Data Sheet) Basler ace GigE...
  • Page 63 AW00089325000 Specifications, Requirements, and Precautions Blue Green Wavelength (nm) Fig. 23: acA780-75gc Spectral Response (From Sensor Data Sheet) Blue Green 1100 1000 Wavelength (nm) Fig. 24: acA1280-60gc, acA1300-60gc Spectral Response (From Sensor Data Sheet) Basler ace GigE...
  • Page 64 Specifications, Requirements, and Precautions AW00089325000 Blue Green 4 00 5 00 60 0 Wavelength (nm) Fig. 25: acA1300-22gc, acA1300-30gc Spectral Response (From Sensor Data Sheet) Blue Green Wavelength (nm) Fig. 26: acA1600-20gc Spectral Response (From Sensor Data Sheet) Basler ace GigE...
  • Page 65 AW00089325000 Specifications, Requirements, and Precautions Blue Green 1000 1050 1100 Wavelength (nm) Fig. 27: acA1600-60gc Spectral Response (From Sensor Data Sheet) Blue Green 1000 Wavelength (nm) Fig. 28: acA1920-40gc, acA1920-50gc Spectral Response (From Sensor Data Sheet) Basler ace GigE...
  • Page 66 Specifications, Requirements, and Precautions AW00089325000 Blue Green Wavelength (nm) Fig. 29: acA2000-50gc, acA2040-25gc Spectral Response (From Sensor Data Sheet) Blue Green Wavelength (nm) Fig. 30: acA2040-35gc, acA2440-20gc (From Sensor Data Sheet) Basler ace GigE...
  • Page 67 AW00089325000 Specifications, Requirements, and Precautions Blue Green 35 0 Wavelength (nm) Fig. 31: acA1920-25gc, acA2500-14gc, Spectral Response (From Sensor Data Sheet) Blue Green Wavelength (nm) Fig. 32: acA3800-10gc Spectral Response (From Sensor Data Sheet) Basler ace GigE...
  • Page 68 Specifications, Requirements, and Precautions AW00089325000 Blue Green Wavelength (nm) Fig. 33: acA4600-7gc Spectral Response (From Sensor Data Sheet) Basler ace GigE...

  • Page 69: Mechanical Specifications

    GPIO* 17.526 Photosensitive surface of the sensor acA2000-50, acA2040-25, and GPIO* models [*See Table 21 on page Not to scale Fig. 34: Mechanical Dimensions (in mm) for Cameras with the C-mount Lens Adapter Basler ace GigE...
  • Page 70 22 (dimension for M2) All CS-mount models except: camera models with GPIO (See Table 21 on page 12.526 Photosensitive surface of the sensor Not to scale Fig. 35: Mechanical Dimensions (in mm) for Cameras with the CS-mount Lens Adapter Basler ace GigE...

  • Page 71: Maximum Allowed Lens Thread Length

    (11) Filter Holder (9.6) C-mount Lens Not to scale IR Cut Filter (color cameras only) Unthreaded Thread: 9.6 Max 10.8 Max Fig. 36: Maximum Lens Thread Length (Dimensions in mm) for Cameras with the C-mount Lens Adapter Basler ace GigE...
  • Page 72 AW00089325000 Filter Holder (4.6) CS-mount Lens Not to scale IR Cut Filter (color cameras only) Unthreaded Thread: 4.6 Max 5.8 Max Fig. 37: Maximum Lens Thread Length (Dimensions in mm) for Cameras with the CS-mount Lens Adapter Basler ace GigE...

  • Page 73: Mechanical Stress Test Results

    The mechanical stress tests were performed with a dummy lens connected to a C-mount. The dummy lens was 35 mm long and had a mass of 66 g. Using a heavier or longer lens requires an additional support for the lens. Basler ace GigE...

  • Page 74: Software Licensing Information

    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...

  • Page 75: Lz4 Licensing

    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...

  • Page 76: Avoiding Emi And Esd Problems

     The Basler application note called Avoiding EMI and ESD in Basler Camera Installations provides much more detail about avoiding EMI and ESD. This application note can be obtained from the Downloads section of the Basler website: www.baslerweb.com Basler ace GigE...

  • Page 77: Environmental Requirements

    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: If your camera is mounted on a substantial metal component in your system, this may provide ...

  • Page 78: Over Temperature Behavior

    To be able to receive events, make sure event notification is enabled and some additional software-related settings are made (see Section 8.22 on page 402). Note that the device temperature is reported in steps of 1 °C.  Basler ace GigE...

  • Page 79: Operation In Over Temperature Mode

    Note that another Critical Temperature event can only be sent after the device temperature has fallen to at least 68 °C and the device temperature subsequently rises above 71 °C again. When the device temperature rises to 78 °C, the camera enters the over temperature mode.  Basler ace GigE...

  • Page 80: Cooling Path

    When a Critical Temperature event has been sent, another Critical  Temperature event can only be sent after the device temperature has fallen to at least 68 °C and when the device temperature rises to 78 °C (above 77 °C) again. Basler ace GigE...

  • Page 81: Monitoring The Internal Temperature

    // Determine the current temperature state TemperatureStateEnums e = camera.TemperatureState.GetValue(); You can also use the Basler pylon Viewer application to easily read the parameter. For more information about the pylon API and the pylon Viewer, see Section 3.1 on page...

  • Page 82: Precautions

    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 properly. For more specific information about the lens thread length, see Section 1.5.2 on page Basler ace GigE...
  • Page 83 To ensure that the snippets will work properly in your application, you must adjust them to  meet your specific needs and must test them thoroughly prior to use. Basler ace GigE...
  • Page 84 Make sure that the camera is pointing down every time you remove or replace the plastic  cap, a lens or a lens adapter. Never apply compressed air to the camera. This can easily contaminate optical components,  particularly the sensor. Basler ace GigE...
  • Page 85 Use a soft, dry cloth that won’t generate static during cleaning (cotton is a good choice).  To remove tough stains, use a soft cloth dampened with a small amount of neutral detergent;  then wipe dry. Make sure the detergent has evaporated after cleaning, before reconnecting the camera to  power. Basler ace GigE...

  • Page 86: Installation

    You can download the document from the Downloads section of the Basler website: www.baslerweb.com After completing your camera installation, refer to the "Basler Network Drivers and Parameters" and "Network Related Camera Parameters and Managing Bandwidth" sections of this camera User’s Manual for information about improving your camera’s performance in a network and about using...

  • Page 87: Software And Accessories

    API. The Basler pylon Camera Software Suite is designed for use with all Basler cameras with the following interface types: IEEE 1394a interface, IEEE 1394b, GigE, or USB 3.0. It can also be used with newer Camera Link cameras.

  • Page 88: Basler Pylon Ip Configurator

    The pylon IP Configurator is included in the Basler pylon Camera Software Suite. The pylon IP Configurator 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.

  • Page 89: Accessories

    Software and Accessories Accessories Fig. 39: Basler Accessories Basler’s cooperation with carefully selected suppliers means you get accessories you can trust which makes building a high-performance image processing system hassle-free. Key Reasons for Choosing Lenses, Cables, and Other Accessories from Basler Perfect match for Basler cameras ...

  • Page 90: Camera Functional Description

    Exposure start and exposure time can be controlled as follows: 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 91 This ensures that the data transmission rate has no influence on image quality. Progressive Scan CCD Sensor Vert. Vert. Vert. Vert. Shift Shift Shift Shift Pixels Pixels Pixels Pixels Reg. Reg. Reg. Reg. Horizontal Shift Register Fig. 40: CCD Sensor Architecture - Progressive Scan Sensors Basler ace GigE...
  • Page 92 Exposure Active Signal or Buffer Timer 1 Signal Image Image Data Data Ethernet Ethernet FPGA Sensor Network Controller Image Image Data Data Control Data Control Micro- Controller Control Control: Data AOI, Gain, Black Level Fig. 42: Camera Block Diagram Basler ace GigE...

  • Page 93: Overview Global Shutter With Cmos Sensor

    Exposure start and exposure time can be controlled as follows: 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 94 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. 44: Camera Block Diagram Basler ace GigE...

  • Page 95: Overview Rolling Shutter With Cmos Sensor

    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 96 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. 46: Camera Block Diagram Basler ace GigE...

  • Page 97: Cameras With Switchable Shutter Mode

    By default, the shutter mode is set to global shutter mode. Depending on your requirements you can set the camera to the desired shutter mode. For detailed information about the shutter modes, see Section 6.7 on page 176. Basler ace GigE...

  • Page 98: Cameras That Can Switch Between Rolling Shutter And Global Reset Release Shutter Mode

    82  the sensor architecture and rolling shutter mode, see Section 4.3 on page 84  electronic shutter operation in detail, see Section 6.7 on page 176  setting the shutter mode, see page 184  Basler ace GigE...

  • Page 99: Physical Interface And I/O Control

    (part number HR10A-7P-6S) or equivalent. connectors, note the horizontal orientation of the screws before ordering. For more information, see Section 5.4.2 on page 8-pin RJ-45 Jack (Ethernet connector) 6-pin connector (I/O connector) Fig. 47: Camera Connectors Basler ace GigE...

  • Page 100: Which Camera Model Has Gpio

    Camera Models with GPIO Line Camera Models without GPIO Line [Pin 3 used as GPIO line] [Pin 3 not used] acA640-300, acA800-200, acA1300-75, acA1920-40, acA1920-48, acA1920-50, acA2040-35, All other models acA2440-20, acA2500-20 Table 21: Camera Models with or without GPIO Line Basler ace GigE...

  • Page 101: Camera Connector Pin Numbering And Assignments

    GPIO (direct-coupled General Purpose I/O) Line2 Opto-isolated OUT Opto-isolated I/O Ground DC Camera Power Ground and GPIO Ground Table 23: Pin Assignments for the I/O Connector (Cameras with GPIO) Fig. 48: Pin Numbering for the I/O Connector Basler ace GigE...

  • Page 102: Ethernet Connector Pin Numbering And Assignments

    If you are supplying power to the camera via Power over Ethernet, the power and I/O cable will not be used to supply power to the camera, but still can be used to connect to the I/O lines. Basler ace GigE...
  • Page 103 The plug on the cable that you attach to the camera’s I/O connector must have 6 female pins. Using a plug designed for a smaller or a larger number of pins can damage the connector. Basler offers suitable plugs and cables. Contact your Basler sales representative to order connectors or cables. Basler ace GigE...

  • Page 104: Camera Power

    You must use camera power supplies which meet the Safety Extra Low  Voltage (SELV) and Limited Power Source (LPS) requirements. If you use a powered hub or powered switch, they must meet the SELV and  LPS requirements. Basler ace GigE...
  • Page 105 (see above) differs from the recommended voltage ranges for the input and output lines (see  Section 5.6.1 on page 95 and Section 5.7.1 on page 98). for Basler ace GigE cameras can differ from the recommended voltage range for camera  power for other Basler cameras. Basler ace GigE...

  • Page 106: Opto-Isolated Input (Pin 2)

    You must use camera power supplies which meet the Limited Power Source  (LPS) requirements. If you use a powered hub or powered switch, they must meet the LPS  requirements. Basler offers suitable and tested power supplies for PoE as well as power over the I/O connector. Basler ace GigE...
  • Page 107 PLC to the camera. 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.As shown in Figure 49, the input line is opto-isolated.
  • Page 108 Section 5.3 on page  how to use an externally generated frame start trigger (HWFSTrig) signal to control acquisition  start, see Section 6.4.3 on page 159. configuring the input line, see Section 5.10 on page 113.  Basler ace GigE...

  • Page 109: Opto-Isolated Output (Pin 4)

    Unapproved power supplies may cause fire and burns. You must use camera power supplies which meet the Limited Power Source  (LPS) requirements. If you use a powered hub or powered switch, they must meet the LPS  requirements. Basler ace GigE...
  • Page 110 95). You must supply power within the specific voltage range. of Basler ace GigE cameras can differ from the recommended voltage ranges for the I/O  output lines of other Basler cameras. You must supply power within the specified voltage range.
  • Page 111 Figure 52 shows a typical circuit you can use to monitor the output line with a voltage signal. Your 6-Pin Receptacle +3.3 to +24 Camera Voltage I/O_Out_1 Out_1_Ctrl Output Signal I/O_Gnd to You Your Fig. 52: Typical Voltage Output Circuit (Simplified Example) Basler ace GigE...
  • Page 112 For more information about assigning camera output signals to an output line, see Section 5.11.1 on page 117. For more information about output line pin assignments and pin numbering, see Section 5.3 on page  the Exposure Active signal, see Section 6.11 on page 198.  Basler ace GigE...

  • Page 113: General Purpose I/O (Only Available For Certain Cameras)

    By default, the GPIO line is set to operate as input to the camera. 5.8.1 Introduction Certain Basler ace GigE cameras have one direct-coupled GPIO line that is accessed via pin 3 of the 6-pin connector on the back of the camera (see Figure 48 on page 90).
  • Page 114 Table 21 on page For more information about GPIO pin assignments and pin numbering, see Section 5.3.1 on page  Setting the GPIO line operation, see Section 5.8.2 on page 104 and Section 5.8.3 on  page 106. Basler ace GigE...

  • Page 115: Operation As An Input

    Figure 54 shows the applicable electrical circuit when a GPIO line is set to operate as an input. The figure shows, as an example, the use of a TTL or CMOS logic gate in the external circuit. A different example for an external circuit is shown in Figure 55. Basler ace GigE...
  • Page 116 Fig. 55: Direct-coupled GPIO Line Schematic with the GPIO Line Set as an Input and with a Typical External Circuit (Simplified) For more information about GPIO pin assignments and pin numbering, see Section 5.3.1 on page  Setting the GPIO line operation, see Section 5.8.2 on page 104 and Section 5.8.3 on  page 106. Basler ace GigE...

  • Page 117: Operation As An Output

    The residual voltage will typically be approximately 0.4 V at 50 mA and 25 °C housing temperature. The actual residual voltage, however, depends on camera operating temperature, load current, and production spread. Note: The maximum current allowed through the output circuit is 50 mA. Basler ace GigE...
  • Page 118 Output Circuit (Simplified) For more information about GPIO pin assignments and pin numbering, see Section 5.3.1 on page  setting the GPIO line operation, see Section 5.10 on page 113 and Section 5.11 on page 117.  Basler ace GigE...

  • Page 119: Temporal Performance Of I/O Lines

     signal using the active high state. As a general rule of thumb, an external trigger pulse width of 100 µs should be long enough for most cases. Basler ace GigE...
  • Page 120 #: 3.3 - 24 VDC for opto-isolated input, >2.0 - 5.0 VDC for direct-coupled GPIO IN Fig. 57: Analog External Signal and Associated Internal Line Status with Propagation Delays for Opto-isolated Input and Direct-coupled GPIO Inputs (Line Inverters Disabled) Basler ace GigE...
  • Page 121 = Propagation delay for the high-low line status change Drawing not to scale Opto-isolated OUT Direct-coupled GPIO OUT Time Fig. 58: Internal Line Status and Associated Output Signals with Propagation Delays for Opto-isolated Output and Direct-coupled GPIO Output (Line Inverters Disabled) Basler ace GigE...

  • Page 122: Factors Determining I/O Temporal Performance

    Depends on application • Load current: º Depends on application but must be within specified ranges; see Section 5.6 through Section 5.8. • Table 28: Factors Influencing Camera I/O Propagation Delays ( = major influence, = minor influence) º Basler ace GigE...

  • Page 123: Recommendations For Using Camera I/Os

    Signal edge-to-edge variation (jitter) resulting from I/O operation itself is negligible but can be introduced by your trigger signal. To avoid jitter, make sure the slopes of your trigger signals are short, preferably <500 ns. The camera’s inherent jitter is less than 100 ns, peak to peak. Basler ace GigE...

  • Page 124: Configuring The Input Line

    Note that when the input line has been selected as the source signal for a camera function, you must apply an electrical signal to the input line that is appropriately timed for the function. For more information about the electrical characteristics of the input line, see Section 5.6 on page Basler ace GigE...

  • Page 125: Input Line Debouncer

    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. 59: Filtering of Input Signals by the Debouncer Basler ace GigE...
  • Page 126 // Select the input line For Models with GPIO Camera.LineSelector.SetValue(LineSelector_Line3); // Set the line mode Camera.LineMode.SetValue(LineMode_Input); // Set the parameter value to 10 microseconds Camera.LineDebouncerTimeAbs.SetValue(10.0); You can also use the Basler pylon Viewer application to easily set the parameters. Basler ace GigE...

  • Page 127: Setting The Input Line For Invert

    Camera.LineMode.SetValue(LineMode_Input); // Enable the inverter on line 1 Camera.LineInverter.SetValue(true); 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...

  • Page 128: Configuring The Output Line

    You can also designate the output line as "user settable". If the output line is designated as user settable, you can use the camera’s API to set the state of the line as desired. To set a camera output signal as the source signal/ to set a line as user settable: Basler ace GigE...
  • Page 129 For Models with GPIO Camera.LineMode.SetValue(LineMode_Output); Camera.LineSource.SetValue(LineSource_ExposureActive); You can also use the Basler pylon Viewer application to easily set the parameters. By default, the camera’s Exposure Active signal is assigned to the opto-isolated output line: For cameras without GPIO --> Out1 ...

  • Page 130: Minimum Output Pulse Width

    The signal will be sent out of the camera with unmodified signal width. Without signal With signal width increase width increase Output signal Minimum output pulse width (max. 100 µs) Not to Scale Fig. 60: Increasing the Signal Width of an Output Signal Basler ace GigE...
  • Page 131 Camera.LineSelector.SetValue(LineSelector_Line3); Camera.LineMode.SetValue(LineMode_Output); // Set the parameter value to 10.0 microseconds Camera.MinOutPulseWidthAbs.SetValue(10.0); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon Viewer, see Section 3.1.1 on page Basler ace GigE...

  • Page 132: Setting The State Of A User Settable Output Line

    Camera.UserOutputValue.SetValue(true); bool currentUserOutput1State = Camera.UserOutputValue.GetValue( ); You can also use the Basler pylon Viewer application to easily set the parameters. If you have the invert function enabled on the output line and the line is designated as user settable, the user setting sets the state of the line before the inverter.

  • Page 133: Setting And Checking The State Of All User Settable Output Lines

    You can set and check the current status of all output lines with a single operation by using the UserOutputValueAll parameter value. The UserOutputValueAll parameter value is expressed as a hexadecimal number in the Basler pylon Viewer and as a 32-bit word in the Basler pylon API (with 0 as a constant value on bit 0).
  • Page 134 You can set and read the UserOutputValueAll parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set and read the parameter value. In this example, the UserOutputValueAll parameter value is set to 0.

  • Page 135: Setting The State Of A User Settable Synchronous Output Signal

    For more information about the sequencer feature, see Section 8.12 on page 293. Setting the State Using Basler pylon To set the state of a synchronous output signal using pylon Viewer: For Models Without GPIO 1. Use the SyncUserOutputSelector parameter to select output line 1.
  • Page 136 SyncUserOutputSelector_SyncUserOutput1); camera.SyncUserOutputValue.SetValue(true); You can also use the Basler pylon Viewer application to easily set the parameters. If you have the invert function enabled on the output line and the line is designated as user settable, the user setting sets the state of the line before the inverter.

  • Page 137: Setting And Checking The State Of All User Settable Synchronous

    SyncUserOutputValueAll parameter. The parameter value is expressed as a hexadecimal number in the Basler pylon Viewer and as a 32-bit word in the Basler pylon API. As shown in Figure 62, certain bits are associated with certain lines. The states of those lines are expressed by the related binary SyncUserOutputValue parameter values.
  • Page 138 You can set and read the SyncUserOutputValueAll parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set and read the parameter value. In this example, the SyncUserOutputValueAll parameter value is set to 0.

  • Page 139: Setting The Output Line For Invert

    Camera.LineSelector.SetValue(LineSelector_Line2); For Models with GPIO Camera.LineMode.SetValue(LineMode_Output); Camera.LineInverter.SetValue(true); 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.1.1 on page Basler ace GigE...

  • Page 140: Working With The Timer Output Signal

    The timer signal can serve as the source signal for output line 1 on the camera. For information about selecting the timer 1 output signal as the source signal for output line 1, see Section 5.11.1 page 117. Basler ace GigE...

  • Page 141: Setting The Trigger Source For The Timer

    186). You can set the TriggerSelector and the TimerTriggerSource 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: The following code snippet illustrates using the API to set the parameters: Camera.LineSource.SetValue (LineSource_TimerActive);...
  • Page 142 1 µs increments. You can set the TimerDelayTimebaseAbs 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 143: Setting The Timer Duration Time

    2. Set the value of the TimerDelayAbs parameter. You can set the TimerSelector and the TimerDelayAbs 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);...
  • Page 144 1 µs and it can be changed in 1 µs increments. You can set the TimerDurationTimebaseAbs 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.TimerDurationTimebaseAbs.SetValue(5.0);...
  • Page 145 2. Set the value of the TimerDurationAbs parameter. You can set the TimerSelector and the TimerDurationAbs 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);...

  • Page 146: Checking The State Of The I/O Lines

    Camera.LineSelector.SetValue(LineSelector_Line2); Camera.LineMode.SetValue(LineMode_Output); bool Line2State = Camera.LineStatus.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.1.1 on page Basler ace GigE...

  • Page 147: Checking The State Of All Lines

    You can read the LineStatusAll parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to read the parameter value: // Read the line status of all I/O lines. Because the GenICam interface does not // support 32-bit words, the line status is reported as a 64-bit value.

  • Page 148: Image Acquisition Control

    Many tasks, however, can be programmed more conveniently with fewer lines of code when employing the Instant Camera classes, provided by the Basler pylon C++ API. For information about the Instant Camera classes, see the C++ Programmer's Guide and Reference Documentation delivered with the Basler pylon Camera Software Suite.

  • Page 149: Overview

    The AcquisitionStart command will remain in effect until you execute an AcquisitionStop command. Once an AcquisitionStop command has been executed, the camera will not be able to acquire frames until a new AcquisitionStart command is executed. Basler ace GigE...
  • Page 150 But in Basler pylon there is a single parameter, the TriggerMode parameter, that is used to set the mode for both of these triggers. Also, the TriggerSoftware command can be executed for either the acquisition start trigger or the frame start trigger.
  • Page 151 "waiting for frame start trigger" status AcquisitionFrameCount parameter setting = 3 AcquisitionStart AcquisitionStop Command Command Executed Executed Acquisition Start Trigger Signal Frame Start Trigger Signal Time Fig. 67: Acquisition Start and Frame Start Triggering Basler ace GigE...
  • Page 152 The "TriggerWidth" mode is especially useful, if you want to change the exposure time from frame to frame. Trigger width exposure mode is not available on acA1280-60, acA1300-60, acA1600-60, acA1920-25, acA2500-14, acA3800-10, and acA4600-7 cameras. Basler ace GigE...

  • Page 153: Acquisitionstart And Acquisitionstop Commands And The Acquisitionmode

    "overlapped" exposure. To achieve the maximum possible acquisition frame rate, set the camera for the continuous acquisition mode and use "overlapped" exposure. For more information about overlapped exposure, see Section 6.12 on page 214. Basler ace GigE...
  • Page 154 You can set the AcquisitionMode parameter value and you can execute AcquisitionStart or AcquisitionStop commands from within your application software by using the Basler pylon API. The code snippet below illustrates using the API to set the AcquisitionMode parameter value and to execute an AcquisitionStart command.

  • Page 155: The Acquisition Start Trigger

    Avoid switching the acquisition start trigger mode during image capture. Make sure that these camera models are not capturing images while you switch the acquisition start trigger mode. If you switch the acquisition start trigger mode while the camera is capturing images, the camera may crash. Basler ace GigE...

  • Page 156: Acquisition Start Trigger Mode = Off

    FallingEdge - specifies that a falling edge of the electrical signal will act as the acquisition start  trigger. When the TriggerMode parameter for the acquisition start trigger is set to On, the camera’s AcquisitionMode parameter must be set to Continuous. Basler ace GigE...

  • Page 157: Acquisition Frame Count

    "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...

  • Page 158: Setting The Acquisition Start Trigger Mode And Related Parameters

    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 Basler ace GigE...

  • Page 159: Using A Software Acquisition Start Trigger

    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 160 // 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...

  • Page 161: Using A Hardware Acquisition Start Trigger

    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 162 // 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...

  • Page 163: The Frame Start Trigger

    Section 6.1 on page 138  Section 6.3 on page 144. Referring to the use case diagrams that appear in Section 6.12 on page 214 can help you understand the explanations of the frame start trigger. Basler ace GigE...

  • Page 164: Trigger Mode

    The camera will only react to frame start triggers when it is in a "waiting for frame start trigger" acquisition status. For more information about the acquisition status, see Section 6.1 on page 138 and Section 6.3 on page 144. Basler ace GigE...

  • Page 165: Triggermode = On (Software Or Hardware Triggering)

    For more information about bandwidth optimization, see the Installation and Setup Guide for Cameras Used with Basler pylon for Windows (AW000611). The TriggerSource parameter specifies the source signal that will act as the frame start trigger signal.

  • Page 166: Setting The Frame Start Trigger Mode And Related Parameters

    Setting The Frame Start Trigger Mode and Related Parameters You can set the TriggerMode 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 167: Using A Software Frame Start Trigger

    In general, when you are using a software trigger signal to start each frame acquisition, the exposure time for each acquired frame will be determined by the value of the camera’s Exposure Time parameter. The exposure time for each acquired frame will be determined by the value of the camera’s ExposureTimeAbs parameter. Basler ace GigE...

  • Page 168: Setting The Parameters Related To Software Frame Start Triggering And Applying A Software Trigger Signal

    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.
  • Page 169 // a Trigger Software command will apply a software frame start trigger // signal to the camera You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on...

  • Page 170: Using A Hardware Frame Start Trigger

     the HWFSTrig signal, see Section 6.4.3.4 on page 165. the electrical requirements for line 1, see Section 5.6 on page  determining the maximum allowed frame rate, see Section 6.13 on page 218.  Basler ace GigE...

  • Page 171: Exposure Modes

    FallingEdge, the exposure time starts when the HWFSTrig signal falls.  Figure 69 illustrates timed exposure with the camera set for rising edge triggering. HWFSTrig Signal Period HWFSTrig Signal Exposure (duration determined by the ExposureTimeAbs parameter) Fig. 69: Timed Exposure with Rising Edge Triggering Basler ace GigE...

  • Page 172: Trigger Width Exposure Mode

    † following section. For information, see page 162. *Trigger Width Exposure Mode (without Exposure Time Offset) For the camera models marked with an asterisk * in the table above the trigger width exposure is realized as follows: Basler ace GigE...
  • Page 173 The first time period ends when the HWFSTrig signal rises. The second time period is the exposure time offset, C . It is automatically added to the first  time period by the camera’s sensor. See Table 29 on page 163. Basler ace GigE...
  • Page 174 32 µs acA1920-40*, acA1920-50*, acA2040-35*, 14 µs acA2440-20* acA1920-48*, acA2500-20* 45 µs *These models have an additional ExposureOverlapTimeMode parameter that can be set to Automatic or Manual; see below. Table 29: Exposure Time Offset Values Basler ace GigE...
  • Page 175 Setting the Parameters Related to the Trigger Width Exposure Mode You can set the ExposureModeTriggerWidth parameter from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameters: If the camera is a camera with GPIO line it is important to set the exposure mode after the trigger mode and the trigger source have been set.

  • Page 176: Frame Start Trigger Delay

    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 TriggerMode for the acquisition start trigger set to Off.
  • Page 177 // frame start trigger signal (HWFSTrig 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...

  • Page 178: Aca750 - Acquisition Control Differences

    Note: The colors used in this drawing are designed to illustrate how the camera’s output modes work. They Horizontal Shift Registers do not represent the actual colors used in the color filter on acA750-30gc cameras. Fig. 73: Field 0 Readout Basler ace GigE...
  • Page 179 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-30gc cameras. Fig. 74: Field 1 Readout Basler ace GigE...

  • Page 180: Field Output Modes

    1 and will transmit the field 1 pixel data as a frame. Frame Row 1 + Row 2 Row 3 + Row 4 Row 5 + Row 6 Row 7 + Row 8 Row 9 + Row 10 Fig. 76: Field 1 Output Mode Basler ace GigE...
  • Page 181 Row 8 + Row 9 Row 1 + Row 2 Row 3 + Row 4 Row 5 + Row 6 Field 1 Pixel Data Row 7 + Row 8 Row 9 + Row 10 Fig. 77: Concatenated New Fields Output Mode Basler ace GigE...
  • Page 182 Row 5 + Row 6 Row 6 + Row 7 Row 7 + Row 8 Row 8 + Row 9 Row 9 + Row 10 Field 1 Field 0 Pixel Data Pixel Data Fig. 78: Deinterlaced New Fields Output Mode Basler ace GigE...

  • Page 183: Setting The Field Output Mode

    Setting the Field Output Mode You can set the FieldOutputMode parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the FieldOutputMode: // Set the field output mode to Field 0 Camera.FieldOutputMode.SetValue(Field0);...

  • Page 184: Setting The Exposure Time

    As some cameras can be operated either with global shutter or with rolling shutter the possible ExposureTime parameters depend on the selected shutter mode. Table 30 on page 174 shows the values for cameras operated with global shutter. Table 31 on page 175 shows the values for cameras operated with rolling shutter. Basler ace GigE...
  • Page 185 The minimum allowed exposure time values indicated above already include the exposure time offset. For information about the exposure time offset on these camera models, see page 162. Table 30: Minimum and Maximum Allowed Exposure Time Setting (µs) for Global Shutter Operation Basler ace GigE...
  • Page 186 Table 31: Minimum and Maximum Allowed Exposure Time Setting (µs) for Rolling Shutter Operation You can use the Basler pylon API to set the ExposureTimeAbs 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 187: Electronic Shutter Operation

    If used for moving objects:  Use of flash lighting and flash window recommended Table 33: Overview of Shutter Modes The following sections describe the differences between a global shutter and a rolling shutter. Basler ace GigE...

  • Page 188: Global Shutter

    The sensor readout time (see Figure 79 on page 178) is the sum of the line readout times and therefore also depends on the AOI height. You can determine the readout time for a frame by checking the value of the camera’s ReadoutTimeAbs parameter. Basler ace GigE...
  • Page 189 For more information about the exposure active output signal, see Section 6.11.1 on page 198.  the ReadoutTimeAbs parameter, see Section 6.12 on page 214.  setting the shutter mode, see Section 6.7.3 on page 184  Basler ace GigE...

  • Page 190: Rolling Shutter Mode

    And so on until the bottom line of pixels is reached (see Figure 80). The exposure time is the same for all lines and is determined by the ExposureTimeAbs or ExposureTimeRaw parameter setting. Basler ace GigE...
  • Page 191 In rolling shutter mode, the flash window signal will not be available when the exposure time for the first row elapses before exposure for the last row of the current AOI has started, i.e. when Exposure Time ≤ Reset Runtime. Basler ace GigE...
  • Page 192 Section 6.11.1 on page 198.  the ExposureTimeAbs parameter, see Section 6.6 on page 173.  the flash window, see Section 6.7.3.3 on page 186.  setting the shutter mode, see Section 6.7.3 on page 184  Basler ace GigE...

  • Page 193: Global Reset Release Mode

    Line 5 Line 6 tRow Line 7 Line 8 Line 9 Line 10 Line 11 Line N-2 Line N-1 Line N Total runtime = Line exposure time = Line readout time Fig. 81: Global Reset Release Shutter Mode Basler ace GigE...
  • Page 194 For more information about the exposure active output signal, see Section 6.11.1 on page 198.  the ExposureTimeAbs parameter, see Section 6.6 on page 173.  the flash window, see Section 6.7.3.3 on page 186.  Basler ace GigE...

  • Page 195: Setting The Shutter Mode

    ) in Table 37 you can set the shutter mode (global mode, rolling mode or global reset release mode) from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to set the shutter modes: // Set the shutter mode to global camera.SensorShutterMode.SetValue(SensorShutterMode_Global);...

  • Page 196: Setting The Shutter Mode (Aca1920-25, Aca2500-14)

     You can enable and disable the global reset release mode 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 197: The Flash Window

    Line 8 Line 9 Line 10 Line 11 tRow Line N-2 Line N-1 Line N Time to flash window open Flash window width = Line exposure time = Line readout time Fig. 82: Flash Window for Rolling Mode Basler ace GigE...
  • Page 198 Exposure Time Abs= 9975 µs and full AOI Flash window width = 9975 µs - [35 µs x (1944 - 1)] = - 58030 µs If the resulting flash window is a negative number, no flash window signal is transmitted. Basler ace GigE...
  • Page 199 Line N-1 Line N Flash window width = Line exposure time = Line readout time Fig. 83: Flash Window in the Global Reset Release Mode For more information about the ExposureTimeAbs parameter, see Section 6.6 on page 173. Basler ace GigE...
  • Page 200 If set to global shutter mode, the flash window signal is the equivalent of the exposure active signal. For more information about the flash window signal, see Section 6.11.2 on page 201. Basler ace GigE...

  • Page 201: Sensor Readout Mode

    // Set and read the sensor readout mode parameter value camera.SensorReadoutMode.SetValue(SensorReadoutMode_SensorReadoutMode_Normal); camera.SensorReadoutMode.SetValue(SensorReadoutMode_SensorReadoutMode_Fast); SensorReadoutModeEnums e = camera.SensorReadoutMode.GetValue(); You can also use the Basler pylon Viewer application to easily set the parameter. For more information about the pylon API and pylon Viewer, see Section 3.1.1 on page Basler ace GigE...

  • Page 202: Overlapping Image Acquisitions - (Models With Global Shutter)

    Figure 85 with the camera set for the trigger width exposure mode. HWFSTrig Signal Frame acquisition N Frame acquisition N+1 Frame acquisition N+2 Exposure Readout Exposure Readout Exposure Readout Time Fig. 85: Non-overlapped Exposure and Readout Basler ace GigE...
  • Page 203 You can read the ReadoutTimeAbs 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 204 ExposureOverlapTimeMaxAbs parameter. For more information about the FrameTriggerWait signal and the ExposureOverlapTimeMaxAbs parameter, see  Section 6.11.4 on page 204. trigger width exposure, see Section 6.4.3.2 on page 160.  Basler ace GigE...

  • Page 205: Overlapping Image Acquisitions - (Models With Rolling Shutter)

    Figure 88 with the camera using an external frame start trigger. HWFSTrig signal Frame acquisition N Frame acquisition N+1 Frame acquisition N+2 Time = Line exposure = Line readout Fig. 88: Non-overlapped Acquisition Basler ace GigE...
  • Page 206 ExposureTimeAbs parameter + Total readout time Overlapped frame acquisition can only be performed when the camera’s shutter is set for rolling mode.  cannot be performed when the camera’s shutter is set for global reset  release mode. Basler ace GigE...
  • Page 207 N (the last line). You can read the ReadoutTimeAbs 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 208 You can avoid violating this guideline by using the camera’s FrameTriggerWait signal to determine when exposure can safely begin. HWFSTrig signal 400 µs Min. Frame acquisition N Frame acquisition N+1 Frame acquisition N+2 Time = Line exposure = Line readout Fig. 90: Acquisition Overlap Guideline (acA1920-25, acA2500-14) Basler ace GigE...

  • Page 209: Acquisition Monitoring Tools

    10 µs to 40 µs 10 µs to 40 µs signal Timing charts are not drawn to scale. Times stated are only given as an examples. Fig. 91: Exposure Active Signal on Cameras with a Global shutter See note next page. Basler ace GigE...
  • Page 210 Figure 92.  Exposure Active signal Frame acquisition N Frame acquisition N+1 Frame acquisition N+2 Time = Line exposure = Line readout Fig. 92: Exposure Active Signal on Cameras with a Rolling Shutter Basler ace GigE...
  • Page 211 Camera.LineSelector.SetValue(LineSelector_Line2); For Models with GPIO Camera.LineMode.SetValue(LineMode_Output); Camera.LineSource.SetValue(LineSource_ExposureActive); 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  changing which camera output signal is selected as the source signal for the output line, see ...

  • Page 212: Flash Window Signal

    Frame acquisition N+2 Time = Line exposure = Line readout Fig. 93: Flash Window Signal on Cameras with a Rolling Shutter For more information about the rolling shutter and the flash window, see Section 6.7.2 on page 179. Basler ace GigE...
  • Page 213 Camera.LineSelector.SetValue(LineSelector_Line2); For Models with GPIO Camera.LineMode.SetValue(LineMode_Output); 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  changing which camera output signal is selected as the source signal for the output line, see ...

  • Page 214: Acquisition Status Indicator

    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:...

  • Page 215: Trigger Wait Signals

    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 216 Fig. 94: 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 8.22 on page 402. Basler ace GigE...
  • Page 217 Camera.LineSelector.SetValue(LineSelector_Line3); For Models with GPIO Camera.LineMode.SetValue(LineMode_Output); Camera.LineSource.SetValue(LineSource_AcquisitionTriggerWait); 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  changing which camera output signal is selected as the source signal for the output line, see ...

  • Page 218: The Frame Trigger Wait Signal

    FrameTrigger Wait signal HWFST- Frame acquisition N Exposure Readout Frame acquisition N+1 Exposure Readout Frame acquisition N+2 Exposure Readout Time = Camera is in a "waiting for frame start trigger" status Fig. 95: Frame Trigger Wait Signal Basler ace GigE...
  • Page 219 When the camera is set for the timed exposure mode, the rise of the FrameTriggerWait signal is based on the current ExposureTimeAbs parameter setting and on when readout of the current frame will end. This functionality is illustrated in Figure 96. Basler ace GigE...
  • Page 220 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. 96: Frame Trigger Wait Signal with the Timed Exposure Mode Basler ace GigE...
  • Page 221 HWFSTrig signal to vary the exposure time in a range from 3000 µs to 5500 µs. In this case you would set the camera’s ExposureOverlapTimeMaxAbs parameter to 3000 µs. Basler ace GigE...
  • Page 222 Image Acquisition Control AW00089325000 You can use the Basler pylon API to set the ExposureOverlapTimeMaxAbs parameter value from within your application software. The following code snippet illustrates using the API to set the parameter value: // If the camera model is a camera with GPIO line, you first have to set the...
  • Page 223 HWFSTrig signal Frame acquisition N Frame acquisition N+1 Frame acquisition N+2 Time = Line exposure = Line readout = Camera in a "waiting for frame start trigger" status Fig. 98: FrameTriggerWait Signal on a Rolling Shutter Camera Basler ace GigE...

  • Page 224: Camera Events

    Camera.LineSelector.SetValue(LineSelector_Line2); For Models with GPIO Camera.LineMode.SetValue(LineMode_Output); Camera.LineSource.SetValue(LineSource_FrameTriggerWait); 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  changing which camera output signal is selected as the source signal for the output line, see ...

  • Page 225: Acquisition Timing Chart

    Frame Acquisitions ERS Mode GRR Mode Not Overlapped Overlapped (Default) acA640-90gm/gc 21.48 acA640-120gm/gc 17.62 acA640-300gm/gc 3 - 9 acA645-100gm/gc 24.0 acA750-30gm/gc 48.97 acA780-75gm/gc 24.50 acA800-200gm/gc 3 - 10 acA1280-60gm/gc 190 to 200* Table 38: Exposure Start Delays [µs] Basler ace GigE...

  • Page 226: Frame Acquisitions Frame Acquisitions Not Overlapped Overlapped

    2620 acA4600-7gc 7700 7800 *Depends on the exposure time † Depends on the exposure time and the pixel format. ‡ Depends on whether the frame acquisitions are overlapped or not overlapped. Table 38: Exposure Start Delays [µs] Basler ace GigE...
  • Page 227 You can read the ReadoutTime 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 228 Image Acquisition Control AW00089325000 You can also use the Basler pylon Viewer application to easily get the parameter value. For more information about the pylon API and the pylon Viewer, see Section 3 on page You can calculate an approximate frame transmission time by using this formula:...

  • Page 229: Maximum Allowed Frame Rate

    258. There are two ways that you can determine the maximum allowed acquisition frame rate with your current camera settings: you can use the online frame rate calculator found in the Support section of the Basler website:  www.baslerweb.com You can use the Basler pylon API to read the value of the camera’s ResultingFrameRateAbs ...

  • Page 230: Using Basler Pylon To Check The Maximum Allowed Frame Rate

    6.13.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 231 You can increase the maximum allowed frame rate by reducing the AOI width, provided the  AOI width is above 256 pixels. For small AOIs less than 256 pixels wide, the maximum allowed frame rate can not be increased by reducing the AOI width. Basler ace GigE...

  • Page 232: Sensor Readout Modes On Certain Cameras

    If you want to run the cameras at higher frame rates and if the image quality is important to you, keep the AOI sizes to the wake-up values. The cameras wake up in the normal readout mode. Basler ace GigE...
  • Page 233 To check what readout mode is currently set: SensorReadoutModeEnums e = camera.SensorReadoutMode.GetValue(); You can also use the Basler pylon Viewer application to easily set the parameter and to get the parameter value. Basler ace GigE...

  • Page 234: Removing The Frame Rate Limit (Aca640-120 Only)

    2. Use the Remove Parameter Limits feature to remove the limit. 3. Read the value of the ResultingFrameRateAbs parameter with the limit removed. For more information about using the Remove Parameter Limits feature, see Section 8.3 on page 247.  the ResultingFrameRateAbs parameter, see page 218.  Basler ace GigE...

  • Page 235: Use Case Descriptions And Diagrams

    The images can then be used for a variety of purposes including vegetation coverage estimates, archaeological site identification, etc. For more information about the AcquisitionFrameRateAbs parameter, see Section 6.3.1.1 on page 145. Basler ace GigE...
  • Page 236 = frame exposure and readout = frame transmission AcquisitionStart AcquisitionStop command command executed executed Acquisition start trigger signal Frame start trigger signal Time Fig. 100: Use Case 1 - TriggerMode for Acquisition Start Trigger and Frame Start Trigger Set to Off Basler ace GigE...
  • Page 237 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 238 Acquisition start trigger signal Frame start trigger signal (applied to line 1) Time Fig. 101: Use Case 2 - TriggerMode for Acquisition Start Trigger Set to On and for Frame Start Trigger Set to Off Basler ace GigE...
  • Page 239 (this avoids the need to store images of an empty toll booth area.) For more information about the AcquisitionFrameRateAbs parameter, see Section 6.3.1.1 on page 145. Basler ace GigE...
  • Page 240 = frame transmission AcquisitionStart AcquisitioStop command command executed executed Acquisition start trigger signal (applied to line 1) Frame start trigger signal Time Fig. 102: Use Case 3 - Acquisition Start Trigger On and Frame Start Trigger Off Basler ace GigE...
  • Page 241 (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 242 "waiting for frame start trigger" status AcquisitionStart AcquisitionStop command command executed executed Acquisition start trigger software command executed Frame start trigger signal (applied to line 1) Time Fig. 103: Use Case 4 - Acquisition Start Trigger On and Frame Start Trigger On Basler ace GigE...

  • Page 243: Pixel Formats

    Setting Pixel Format Parameter Values You can set the PixelFormat parameter value from within your application software by using 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);...

  • Page 244: Pixel Data Output Formats: Some Details For Color Cameras

    U values and V values with unsigned integers, 128 is added to each U value and to each V value before the values are transferred from the camera. This process allows the values to be transferred on a scale that ranges from 0 to 255. Basler ace GigE...
  • Page 245 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". Basler ace GigE...

  • Page 246: Features

    For example, if you found that at your brightest exposure the gray values 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...

  • Page 247: Analog And Digital Control

    Digital Gain Control acA640-90gm/gc acA640-120gm/gc acA645-100gm/gc acA780-75gm/gc analog/digital acA1300-22gm/gc acA1300-30gm/gc acA1600-20gm/gc acA750-30gm/gc acA1280-60gm/gc* analog/digital* acA1300-60gm/gc* acA1600-60gm/gc* † acA1920-40gm/gc analog/digital † acA1920-50gm/gc † acA2040-35gm/gc † acA2440-20gm/gc acA1920-25gm/gc analog/digital acA2500-14gm/gc Table 39: Mechanism of Gain Control and Boundary Values (If Applicable) Basler ace GigE...

  • Page 248: Setting The Gain

    The minimum setting varies depending on the camera model and on whether vertical binning is enabled (see Table 40). The maximum setting depends on the bit depth of the set pixel data format. Note that the effective pixel bit depth for YUV pixel data formats is 8 bit. Basler ace GigE...
  • Page 249 If the parameter limit for the Gain feature is removed for these camera models, digital gain will be added to the analog gain (GainRaw parameter). For more information about the Remove Parameter Limits feature, see Section 8.3 on page 247. NA = Not available Table 40: Minimum and Maximum Allowed Gain Raw Settings Basler ace GigE...

  • Page 250: Aca645-100Gm/Gc

    The following code snippet illustrates using the API to set the selector and the parameter value: Camera.GainSelector.SetValue(GainSelector_AnalogAll); Camera.GainRaw.SetValue(400); 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...
  • Page 251 Min Setting Max Setting Max Setting Max Setting (8-bit Depth) (10-bit Depth) (12-bit Depth) acA640-90gm/gc* 36.7 14.4 acA640-120gm/gc* 36.7 21.5 acA645-100gm/gc* 36.7 14.4 acA750-30gm/gc 36.7 21.5 acA780-75gm/gc* 36.7 14.4 Table 42: Minimum and Maximum dB of Gain Basler ace GigE...
  • Page 252 The camera’s gain is determined by the value of the GainRaw parameter. GainRaw is adjusted on an integer scale. The minimum setting is 0 and the maximum setting is 3 (for the analog gain) and  95 (for the digital gain).  Basler ace GigE...

  • Page 253: Analog Gain

    At a digital gain setting of 0, the camera’s digital gain will be 0 dB. At a setting of 95, the gain is approximately 12 dB. Camera Model Min Setting Min Setting with Max Setting Vertical Binning (12-bit depth) (mono cameras) acA1280-60gm/gc acA1300-60gm/gc acA1300-60gmNIR acA1600-60gm/gc Table 45: Minimum and Maximum Allowed GainRaw Settings (Digital Gain) Basler ace GigE...
  • Page 254 If required, you can use the Remove Parameter Limits feature for the gain to enlarge the gain range. For information on the Remove Parameter Limits feature, see Section 8.3 on page 247. Basler ace GigE...

  • Page 255: Black Level

    Change in BlackLevel Value Resulting Offset Bit Depth (Range: 0 - 511) (Corresponding Change of Pixel Gray Value) 8 bit +/- 16 +/- 1 12 bit +/- 1 +/- 1 Table 47: Effect of Increasing or Decreasing the BlackLevel Parameter Basler ace GigE...

  • Page 256: Setting The Black Level

    Table 49. Camera Model Min Allowed Max Allowed Black Level Raw Setting Black Level Raw Setting acA640-90gm/gc, acA640-120gm/gc acA645-100gm/gc acA750-30gm/gc, acA780-75gm/gc acA1300-22gm/gc; acA1300-30gm/gc 1023 acA1600-20gm/gc acA3800-10gm/gc acA4600-7gc acA1280-60gm/gc, acA1300-60gm/gc/gmNIR, acA1600-60gm/gc Table 49: BlackLevelRaw Parameter Range Basler ace GigE...
  • Page 257 2. Set the BlackLevelRaw parameter to your desired value. You can set the BlackLevelSelector and the BlackLevelRaw 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);...

  • Page 258: Remove Parameter Limits

    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 259 // Remove the limits for the selected feature. 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...

  • Page 260: Digital Shift

    2, 4, 6, 8, 10, and so on. Depending on the camera model, the cameras have either a 12-bit or a 10-bit ADC to digitize the output. In the following, some examples are shown to explain the functional principle. Basler ace GigE...
  • Page 261 Bit 11 Bit 10 Bit 9 Bit 8 Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 Binary Decimal Sum: MSB = most significant bit LSB = least significant bit Basler ace GigE...
  • Page 262 If digital shift was applied, the resulting sum would be 1582. Therefore, all bits set to 1. Shift by 1 Bit 11 Bit 10 Bit 9 Bit 8 Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 Binary Decimal 2048 1024 Sum: 4095 Basler ace GigE...

  • Page 263: Enabling And Setting Digital Shift

     respectively. You can set the DigitalShift parameter values from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter values: // Disable digital shift Camera.DigitalShift.SetValue(0); // Enable digital shift by 2 Camera.DigitalShift.SetValue(2);...

  • Page 264: Image Area Of Interest (Aoi)

    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 6.13 on page 218. Basler ace GigE...

  • Page 265: Setting The Aoi

    Can be set in increments of 1. 1, 2, 3, 4, 5, etc. Height Color cameras: Can be set in increments of 2. 2, 4, 6, 8, etc.  Must be set to an even number.  Table 50: Guidelines for AOI Settings Basler ace GigE...
  • Page 266 Can be set in increments of 32. acA1920-48, OffsetY Mono cameras: 1, 2, 3, 4, etc. acA2500-20 Can be set in increments of 1. Color cameras: 2, 4, 6, etc. Can be set in increments of 2. Table 50: Guidelines for AOI Settings Basler ace GigE...
  • Page 267 You can set the OffsetX, OffsetY, 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 OffsetX, OffsetY, Width, and Height parameter values int64_t widthMax = Camera.Width.GetMax( );...

  • Page 268: Center X And Center Y

    The OffsetY setting behaves analogously when CenterY is enabled and disabled. Enabling AOI Centering You can enable AOI centering from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to enable automatic AOI centering: camera.CenterX.SetValue(true);...

  • Page 269: Stacked Zone Imaging

    The StackedZoneImagingZoneOffsetY parameter is set to 38.  The StackedZoneImagingZoneHeight parameter is set to 8.  With these settings, the camera would output an image that is 16 pixels wide and 24 lines (the total height of the three zones) high. Basler ace GigE...
  • Page 270 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 Zone 1 Offset Y Zone 1 Zone 1 Height Zone 2 Offset Y Zone 2 Zone 2 Height Zone 3 Offset Y Zone 3 Zone 3 Height Width Offset X Fig. 107: Stacked Zone Imaging Basler ace GigE...
  • Page 271 OffsetY: parameter indicates the Y offset for the zone nearest to the top of the sensor.  Height: parameter indicates the total height of the image that will be transmitted from the  camera (i.e., the sum of the heights of all zones). Basler ace GigE...

  • Page 272: Setting Stacked Zone Imaging

    Setting Stacked Zone Imaging Using Basler pylon You can set the parameter values associated with stacked zone imaging from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to set up two zones.
  • Page 273 Camera.StackedZoneImagingZoneOffsetY.SetValue(250); // Set the height for the selected zone Camera.StackedZoneImagingZoneHeight.SetValue(200); 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...

  • Page 274: Error Codes

    If two or three different detectable errors have occurred, the camera will store the code for each type of error that it has detected (it will store one occurrence of each code no matter how many times it has detected the corresponding error). Basler ace GigE...
  • Page 275 // Clear the value of the last error code in the memory Camera.ClearLastError.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameter and execute the command. For more information about the pylon API and the pylon Viewer, see Section 3 on...

  • Page 276: Precision Time Protocol (Ieee 1588)

    It achieves clock accuracy in the sub-microsecond range. The protocol is defined in the IEEE 1588 standard. The Basler ace GigE cameras support the revised version of the standard (IEEE 1588-2008, also known as PTP Version 2).
  • Page 277 This timescale is relative, i.e. it is only valid in the network. The best master clock algorithm will select the clock which has the highest stability and precision as the master clock of the network. Basler ace GigE...
  • Page 278 Details about PTP Messages In standard Ethernet frames, four IEEE 1588 messages are included (see Figure 109): Sync, Follow_up, Delay_Req, Delay_Resp The Basler ace GigE cameras are configured to use the end-to-end delay measurement mechanism, i.e. that the request-response delay mechanism is used.

  • Page 279: Enabling Ptp Clock Synchronization

    This priority setting ensures that a PTP port is able to be in the slave state and a connected camera is able to become a master. 5. For all cameras that you want to synchronize, enable the PTP clock synchronization: camera.GevIEEE1588.SetValue(true); Basler ace GigE...
  • Page 280 GevTimestampTickFrequency parameter value is fixed to 125000000 Hz (125 MHz), i.e. 8 ns inter-tick duration). If you enable or disable PTP, the GevTimestampTickFrequency, the InterpacketDelay and the FrameTransmissionDelay values are automatically converted with respect to the underlying inter-tick duration. Basler ace GigE...

  • Page 281: Checking The Status Of The Ptp Clock Synchronization

    IEEE 1588 device status, but does not require executing the GevIEEE1588DataSetLatch command beforehand. Note, however, that if you read multiple IEEE 1588-related values from a device, the GevIEEE1588Status parameter value will not relate to the same point in time as the other values. Basler ace GigE...

  • Page 282: Code Example

    = camera.GevIEEE1588ClockId.GetValue(); int64_t offset = camera.GevIEEE1588OffsetFromMaster.GetValue(); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 283: How To Check When A Camera Is Synchronized To A Master

    The algorithm can be called repeatedly until the returned maximum absolute offset from master is below the desired threshold. \param nodemap nodemap of camera which is in “Slave” state \param timeToMeasureSec amount of time in seconds for computing the maximum absolute offset from master Basler ace GigE...
  • Page 284 // latch IEEE1588 data set to get offset from master GevIEEE1588DataSetLatch->Execute(); // maximum of offsets from master maxOffset = std::max(maxOffset, std::abs( GevIEEE1588OffsetFromMaster->GetValue())); // increase number of samples n++; Sleep(1); while (currTime <= timeToMeasureSec); // return maximum of offsets from master for given time interval return maxOffset; Basler ace GigE...

  • Page 285: Action Commands

    The following example setup will give you an idea of the basic concept of action commands. To analyze the movement of a horse, multiple cameras are installed parallel to a race track. They form a group of cameras (G1, see Figure 111 on page 275). Basler ace GigE...
  • Page 286 SG1, SG2, SG3, and so on. To define the device key, the group of cameras, and their sub-groups, the parameters action device key, action group key, and action group mask are used. For more information about these parameters, see Section 8.9.2. Basler ace GigE...

  • Page 287: Action Command Parameters

    000111 must be sent (hexadecimal representation: 0x7). To execute an action on cameras 3, 4, and 6 of these cameras, an action command with an action group mask of 101100 must be sent (hexadecimal representation: 0x2C). Basler ace GigE...

  • Page 288: Using Action Commands

    At the moment, the number of action signals is limited to 1 for all Basler cameras that support action commands. This means that if you previously set up a camera for an action command and you want to define a new action command, you have to replace the existing camera configuration.
  • Page 289 AW00089325000 Features The action commands feature is supported by the camera and the Basler pylon API you are  using to configure and send action command(s). If necessary, basic camera parameters are set (gain etc.).  For all cameras that you want to send an action command to, make the following settings: 2.
  • Page 290 Code Example You can set the action command parameters from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set up four cameras for synchronous image acquisition with a frame start trigger. For the ActionDeviceKey, the ActionGroupKey, and the ActionGroupMask parameters, sample values are used.

  • Page 291: Synchronous Frame Counter Reset

    All cameras you want to set up action commands for must be installed and configured in the  same network segment. The action commands feature is supported by the camera and the Basler pylon API you are  using to configure and send action command(s).

  • Page 292: Synchronous Sequence Set Advance

    All cameras you want to set up action commands for must be installed and configured in the  same network segment. The action commands feature is supported by the camera and the Basler pylon API you are  using to configure and send action command(s).
  • Page 293 Code Example You can set the action command parameters from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set up a specific camera to synchronously advance sequence sets. For the Action Device Key, the Action Group Key, and the Action Group Mask, sample values are used.
  • Page 294 AW00089325000 //Set the action group mask //In this sample, all cameras will respond to any mask //other than 0 Cameras[i].ActionGroupMask.SetValue(0xffffffff); //--- End of camera setup --- //Send an action command to the cameras GigeTL->IssueActionCommand(4711, 1, 0xffffffff, "255.255.255.255"); Basler ace GigE...

  • Page 295: Scheduled Action Commands

    To check the current timestamp of the camera, execute the GevTimestampControlLatch command to take a "snapshot" of the camera’s current time settings. After that, you can read the GevTimestampValue parameter to determine the timestamp value of the snapshot. Basler ace GigE...

  • Page 296: Using Scheduled Action Commands

    All cameras you want to set up action commands for must be installed and configured in the  same network segment. The action commands feature is supported by the camera and the Basler pylon API you are  using to configure and send action command(s).
  • Page 297 These code examples can also be used to set up a scheduled action command. To do so, simply replace the IssueActionCommand call in the code examples by "IssueScheduledActionCommand" and add the Action Time parameter as described above. Basler ace GigE...

  • Page 298: Synchronous Free Run

    It is also possible to start the image captures of multiple cameras at a precise start time. For more information about the PTP feature, see Section 8.8 on page 265. Start Time Image Captures Image Capture Time Example B With PTP: Same SyncFreeRunTriggerRateAbs Parameters Fig. 113: Image Captures With PTP (Precision Time Protocol) Basler ace GigE...
  • Page 299 20 milliseconds after the start time, the third camera 30 milliseconds after the start time of the first camera and so on. Start Time Image Captures Image Captures Image Captures Time Fig. 114: Example C: Same SyncFreeRunTriggerRateAbs but in Chronological Sequence Basler ace GigE...
  • Page 300 The cameras have the same start time (start time = 0)  but they have different exposure times for their image capture  Start Time Image Captures Image Captures Image Captures Time Fig. 115: Example D: Same Start Time and Same SyncFreeRunTriggerRateAbs but Different Exposure Times Basler ace GigE...

  • Page 301: Synchronous Free Run Parameters

    Each time you change one or more of the SyncFreeRunTimerStartTimeLow, SyncFreeRunTimerStartTimeHigh, or SyncFreeRunTimerTriggerRateAbs parameters, you must execute the SyncFreeRunTimerUpdate command to apply the changes. The update command ensures that all settings are applied at the same time. Basler ace GigE...

  • Page 302: Using Synchronous Free Run

    AW00089325000 8.11.2 Using Synchronous Free Run To configure the synchronous free run for multiple Basler ace cameras: 1. Before configuring the synchronous free run of multiple cameras, make sure that the following requirements are met: All cameras you want to trigger synchronously via the synchronous free run feature must be ...
  • Page 303 You can set the parameter values associated with synchronous free run feature from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to set the synchronous free run for a number of cameras so that they capture synchronously images, without a specific point of time in the future.

  • Page 304: Sequencer

    Three sequence advance modes provide different schemes for advancing from one sequence set to the next (see below for details). Basler ace GigE...
  • Page 305 Every time the camera is restarted, all sequencer parameters are reset to the default values, e.g. if you enable and use the Sequencer feature with specially set values, and you turn off and on the camera, the Sequencer feature is disabled after restart, and the user-defined parameters are reset to default values. Basler ace GigE...
  • Page 306 In this case the initial overlapped operation turns out to work as non-overlapped operation. As a consequence the frame rate can be significantly reduced. The sequence set currently setting the parameter values of the sequence parameters in the active set is also called the "current set". Basler ace GigE...
  • Page 307 For details about populating sequence sets and making related settings, see the sections below explaining the sequence advance modes. Basler ace GigE...
  • Page 308 (controlled sequence advance only) or by a software command. a non-cyclical advance allows to skip a sequence set and will advance to the sequence set  after the next. The non-cyclical advance can be controlled by a software command. Basler ace GigE...
  • Page 309 The Sequence Set Index Chunk feature adds a chunk to each acquired frame containing the index number of the sequence set that was used for frame acquisition. For more information about the Sequence Set Index chunk, see Section 9.3.8 on page 428. Basler ace GigE...
  • Page 310 // Load the sequence parameter values from the sequence set into the active set Camera.SequenceSetLoad.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameters. Use Case Diagrams Illustrating Sequencer Operation The sections below explain the sequence advance modes in detail. Use case descriptions and diagrams are designed to illustrate how the sequence advance modes work in some common situations and with some common combinations of parameter settings.

  • Page 311: Auto Sequence Advance Mode

    3 for sequence set 1, this sequence set is used a second time: The parameter values of sequence set 1 are used for the image acquisition. When the next frame start trigger is received, the camera checks the current  SequenceSetExecutions parameter value. Because the SequenceSetExecutions parameter is Basler ace GigE...
  • Page 312 The Sequencer feature is disabled while frame exposure and readout are in progress. The  complete frame is transmitted and the cycling through sequence sets is terminated. The sequencer parameter values in the active set return to the values that existed before the Sequencer feature was enabled. Basler ace GigE...
  • Page 313 // Enable the sequencer feature Camera.SequenceEnable.SetValue(true); // Disable the sequencer feature Camera.SequenceEnable.SetValue(false); You can also use the Basler pylon Viewer application to easily set the parameters. Basler ace GigE...

  • Page 314: Configuration

    9. Repeat the above steps starting from step 4 for the other sequence sets. Configuring Sequence Sets and Advance Control Using Basler pylon You can use the pylon API to set the parameters for configuring sequence sets from within your application software.

  • Page 315: Controlled Sequence Advance Mode

    // Store the sequence parameter values from the active set in the selected sequence // set Camera.SequenceSetStore.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameters. 8.12.2 Controlled Sequence Advance Mode When the controlled sequence advance mode is selected the advance from one sequence set to...

  • Page 316: Operation With The "Always Active" Sequence Control Source

    0 is used. After the Sequencer feature is disabled, the cycling through sequence sets is terminated. The  sequencer parameter values in the active set return to the values that existed before the Sequencer feature was enabled. Basler ace GigE...
  • Page 317 = frame exposure and readout = frame transmission Sequencer Sequence set cycle Sequencer enabled starts again disabled Frame start trigger signal Time Fig. 118: Sequencer in Controlled Sequence Advance Mode with AlwaysActive as the Sequence Control Source Basler ace GigE...
  • Page 318 Note also that the camera briefly exits the "waiting for frame start trigger" status while the input line changes its state. This happened when input line 1 changed its state before the fourth frame start trigger was received (see also Figure 119). Basler ace GigE...
  • Page 319 When the next frame start triggers are received, the camera advances to the next sequence  sets and uses them for image acquisition in accord with the Always Active sequence control source and as described in the previous use case. Basler ace GigE...
  • Page 320 1 (Restart) Sequence set cycle Sequence set cycle starts again starts again Frame start trigger signal Time Fig. 119: Sequencer in Controlled Sequence Advance Mode with SequenceControlSource set to AlwaysActive and Synchronous Restart Controlled by Line 1 Basler ace GigE...

  • Page 321: Operation With The Input Line As Sequence Control Source

    Also, maintain the state of the input line at least for one microsecond after the frame start trigger signal has risen. Basler ace GigE...
  • Page 322  line 1 is found to be high and therefore the parameter values of the next sequence set are loaded into the active set. The parameter values of sequence set 0 are used for the image acquisition. Basler ace GigE...
  • Page 323 = frame transmission Sequencer Sequencer enabled disabled Signal spplied to input line 1 Sequence set cycle (Advance) starts again Frame start trigger signal Time Fig. 120: Sequencer in Controlled Sequence Advance Mode with SequenceControlSource Set to Line1 Basler ace GigE...

  • Page 324: Operation With The Sequencecontrolsource Set To Disabled

    The AsyncAdvance command has not yet become effective because of the assumed associated delay. When the next frame start trigger is received, the camera checks the active set and uses it for  the image acquisition. The parameter values of sequence set 0 are used. Basler ace GigE...
  • Page 325 The parameter values of sequence set 0 are loaded into the active set. Note that the camera briefly exits the "waiting for frame start trigger" status while the parameter values of sequence set 1 are loaded into the active set (see also Figure 121). Basler ace GigE...
  • Page 326 While frame exposure and readout are in progress, the Sequencer feature is disabled. The  complete frame is transmitted and the cycling through sequence sets is terminated. The sequencer parameter values in the active set return to the values that existed before the Sequencer feature was enabled. Basler ace GigE...
  • Page 327 = frame exposure and readout = frame transmission Sequencer Sequencer enabled disabled Sequence set cycle starts again Time Fig. 121: Sequencer in Controlled Sequence Advance Mode with the SequenceControlSource Set to Disabled and Asynchronous Advance and Restart Basler ace GigE...

  • Page 328: Configuration

    // Enable the sequencer feature Camera.SequenceEnable.SetValue(true); // Disable the sequencer feature Camera.SequenceEnable.SetValue(false); You can also use the Basler pylon Viewer application to easily set the parameters. 8.12.2.4 Configuration Configuring Sequence Sets and Advance Control To populate sequence sets and to set the sources: 1.
  • Page 329 (Any existing parameter values in the sequence set will be overwritten.) 12. Repeat the above steps for the other sequence sets. For information about setting the input line for invert, see Section 5.10.3 on page 116. Basler ace GigE...
  • Page 330 Features AW00089325000 Configuring Sequence Sets and Advance Control Using Basler pylon You can use the pylon API to set the parameters for configuring sequence sets from within your application software. The following code snippet gives example settings. It illustrates using the API to set the controlled sequence advance mode.
  • Page 331 // Select sequence set with index number 0 Camera.SequenceSetIndex.SetValue(0); // Load the sequence parameter values from the sequence set into the active set Camera.SequenceSetLoad.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameters. Basler ace GigE...

  • Page 332: Free Selection Sequence Advance Mode

    1 is selected. Its parameter values are loaded into the active set and are used for the image acquisition. Note that the state of input line 1 went high well ahead of the frame start trigger. Basler ace GigE...
  • Page 333 While frame exposure and readout for the ninth frame start trigger are in progress, the  Sequencer feature is disabled. The complete frame is transmitted. The sequencer parameter values in the active set return to the values that existed before the Sequencer feature was enabled. Basler ace GigE...
  • Page 334 (the sequence set index number is indicated) = frame exposure and readout = frame transmission Sequencer Sequencer enabled disabled Signal applied to input line 1 Frame start trigger signal Time Fig. 122: Sequencer in Free Selection Mode Basler ace GigE...
  • Page 335 // Disable the sequencer feature Camera.SequenceEnable.SetValue(false); You can also use the Basler pylon Viewer application to easily set the parameters. Selecting Sequence Sets Each sequence set is identified by a sequence set index number, starting from zero. The states of the input line selects between the sequence sets by setting bit 0 of the sequence set address.

  • Page 336: Configuration

    9. Repeat the above steps for the other sequence set, starting from step 5. Configuring Sequence Sets and Advance Control Using Basler pylon You can use the pylon API to set the parameters for populating sequence sets from within your application software and make settings for their selection when images are acquired.
  • Page 337 // adjust the camera parameters for the best image quality. // Store the sequence parameter values from the active set in the selected // sequence set Camera.SequenceSetStore.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameters. Basler ace GigE...

  • Page 338: Binning

    For more information about possible image distortion, see Section 8.13.3 on page 331. The number of binned pixels depends on the vertical binning and the horizontal binning settings. For more information about the binning settings, see Section 8.13.1 on page 329. Basler ace GigE...

  • Page 339: Binning Modes

    35gm, acA2440-20gm acA3800-10gm, acA4600-7gc Averaging or Summing Summing (settable) acA1920-25gm/gc, acA2500-14gm/gc Set to 2 or 4: Averaging Summing  Set to 3: A combination of  Averaging and Summing Table 54: Camera Models and Supported Binning Modes Basler ace GigE...

  • Page 340: Setting Binning Parameters

    2 or 4 rows are † averaged. † The gray values of adjacent pixels from 3 rows are combined (mixture of summing and averaging). Recommended: 2 or 4 Table 55: Binning Vertical and Binning Horizontal Settings Basler ace GigE...
  • Page 341 Table 55: Binning Vertical and Binning Horizontal Settings You can set the BinningVertical or the BinningHorizontal 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 342: Setting The Binning Mode

    327. You can set the BinningVerticalMode and the BinningHorizontalMode 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: // Set the horizontal binning mode to "Average"...
  • Page 343 AOI is increased again. Therefore, Basler recommends to always check the AOI and offset settings after disabling binning and, if necessary, to manually set the AOI to the desired values.
  • Page 344 258. Binning’s Effect on Decimation If vertical binning is used, vertical decimation is automatically disabled, and vice versa, i.e. if vertical decimation is used, vertical binning is disabled. Horizontal binning works independently of the Decimation feature. Basler ace GigE...

  • Page 345: Decimation

    32 for mono cameras: only every thirty-second row of the acquired frame will be transmitted  out of the camera. 32 for color cameras: only every thirty-second pair of rows of the acquired frame will be  transmitted out of the camera. Basler ace GigE...
  • Page 346 1 disables vertical decimation. You can set the DecimationVertical 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 Decimation by 8 Camera.DecimationVertical.SetValue(8);...

  • Page 347: Horizontal Decimation

    1 disables horizontal decimation. You can set the DecimationHorizontal 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 Horizontal Decimation by 8 Camera.DecimationHorizontal.SetValue(8);...

  • Page 348: Considerations When Using Decimation

    1, i.e. the Vertical Decimation feature is deactivated, the AOI height can be smaller than the maximum possible height (determined by the pixel resolution in vertical direction). In this case you can manually set the AOI height back to the maximum possible height. Basler ace GigE...

  • Page 349: Scaling

    16 / 128 0.125 The image size is reduced by factor 8. The Scaling feature can be used if the Sequencer feature is enabled, i.e. the sequencer sets used within a sequence can contain special scaling parameters. Basler ace GigE...

  • Page 350: Setting Scaling

    // Enable horizontal scaling by half Camera.ScalingHorizontal.SetValue(0.5); // Disable scaling Camera.ScalingHorizontal.SetValue(1); You can also use the Basler pylon Viewer application to easily set the parameter. 8.15.1 Considerations when Using Scaling Binning and Decimation If scaling is used, binning and decimation are automatically disabled, and vice versa, i.e. if binning or decimation is used, scaling is disabled.
  • Page 351 AOI is increased again. Therefore, Basler recommends to always check the AOI and offset settings after disabling scaling and, if necessary, to manually set the AOI to the desired values.

  • Page 352: Mirror Imaging

    Camera Model Mirror Imaging Reverse X Reverse Y Reverse X Feature/s Enabled Enabled and Reverse Y Disabled Enabled acA640-300gc, acA800-200gc, acA1300-75gc, acA1920-48gc, acA2500-20gc acA1920-40gc, acA1920-50gc, acA2040-35gc, acA2440-20gc Table 59: Bayer Filter Alignment for the Mirror Imaging Feature Basler ace GigE...

  • Page 353: Reverse X

    Note, however, that the position of an 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 354 As a consequence, each auto function AOI will include a different portion of the captured image depending on whether or not the Reverse X feature is enabled. For more information about auto functions, see Section 8.20 on page 381. Basler ace GigE...

  • Page 355: Reverse Y

    AOI will include a different portion of the captured image depending on whether or not the Reverse Y feature is enabled. Figure 130 shows the effect the reverse Y mirroring will have on the auto function AOIs. Basler ace GigE...

  • Page 356: Enabling Reverse X And Reverse Y

    // Enable reverse X Camera.ReverseX.SetValue(true); // Enable reverse Y Camera.ReverseY.SetValue(true); You can also use the Basler pylon Viewer application to easily set the parameter. For more information about the pylon API and the pylon Viewer, see Section 3 on page Basler ace GigE...

  • Page 357: Gamma Correction

    When the gamma correction value is set to 1, the output pixel brightness will not be corrected. A gamma correction value between 0 and 1 will result in increased overall brightness, and a gamma correction value greater than 1 will result in decreased overall brightness. Basler ace GigE...
  • Page 358 You can set the GammaEnable parameter, use the GammaSelector, 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);...

  • Page 359: Color Creation And Enhancement

    How to Obtain Good Color Settings in Your Camera If you want to obtain good color settings in your Basler ace GigE cameras, basically there are two ways of achieving good settings: Best color settings. How to set them, see below.

  • Page 360: How To Obtain Raw Settings And Low Noise In Your Camera

    3. If required, do a manual or automatic white balance. For information about the color wake-up values in your camera, see Section 8.18.5.1 on page 357.  factory sets and user sets, see Section 8.26 on page 412.  Basler ace GigE...

  • Page 361: Color Creation (All Color Models Except The Aca750-30Gc)

    Color Creation (All Color Models Except the acA750-30gc) The sensors in the color versions of the Basler ace GigE cameras are equipped with an additive color separation filter known as a Bayer filter. The pixel data output formats available on color cameras are related to the Bayer pattern, so you need a basic knowledge of the Bayer filter to understand the pixel formats.

  • Page 362: Bayer Color Filter Alignment

    When you configure the cameras mentioned above (see *), take into account that if you enable the Reverse X and/or the Reverse Y feature, the effective Bayer color filter alignment will change. For more information, see Section 8.16.1 on page 342. Basler ace GigE...

  • Page 363: Pixel Formats Available On Cameras With A Bayer Filter

    When a color camera is set for Mono 8, the pixel values in each captured image are first demosaiced and converted to the YUV color model as described above. The camera then transmits the 8-bit Y value for each pixel to the host computer. In the YUV color model, the Y component for Basler ace GigE...

  • Page 364: Color Creation On The Aca750-30Gc

    "binned" pixel. As shown in Figure 133, 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 365 = 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. 134: Color Combinations for Field 1 Basler ace GigE...

  • Page 366: Pixel Formats Available On Cameras With A Cmyeg Filter

    This brightness value can be considered as equivalent to the value that would be sent from a pixel in a monochrome camera. So in essence, when a color camera is set for Mono 8, it outputs an 8- bit monochrome image. (This type of output is sometimes referred to as "Y Mono 8".) Basler ace GigE...

  • Page 367: Integrated Ir Cut Filter

    For more information about the location of the IR cut filter and about the maximum lens thread length, see Section 1.5.2 on page For information about how to remove the IR cut filter holder, see the ace IR Cut Filter Holder Removal Procedure application note (AW000906). Basler ace GigE...

  • Page 368: Color Enhancement Features

    8.18.5 Color Enhancement Features 8.18.5.1 Color Enhancement-related Wake-Up Values of the Cameras On the initial wake-up after delivery the Basler ace GigE cameras have initial wake-up values concerning color features. These wake-up settings are displayed in Table 61. acA640-90, acA640-120,...
  • Page 369 Gamma correction feature, see Section 8.17 on page 346.  the different color enhancement features, see the following pages.  factory sets, see Section 8.26 on page 412.  Table 62: Color Enhancement Wake-up Values and Additional Settings (Part 2) Basler ace GigE...

  • Page 370: Balance White

    Section 8.18.5.7 on page 376. With the white balancing scheme used on these cameras, the red, green, and blue intensity can be individually adjusted. For each color, a BalanceRatioAbs parameter is used to set the intensity of the color. Basler ace GigE...
  • Page 371 Setting the Balance White Feature To set the BalanceRatioAbs parameter for a color using Basler pylon: 1. Set the BalanceRatioSelector to red, green, or blue. 2. Set the BalanceRatioAbs parameter to the desired value for the selected color.
  • Page 372 Features AW00089325000 You can set the BalanceRatioSelector and the BalanceRatioAbs 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 373: Pgi Feature Set

    Baser PGI demosaicing involves regions of 5×5 pixels on the sensor for color interpolation and is therefore more elaborate than the "simple" 2×2 demosaicing used otherwise by the camera. The Basler PGI 5×5 demosaicing can only operate in the context of the Basler PGI feature set. When Basler PGI demosaicing is enabled, the following happens: The 5×5 color interpolation becomes effective.

  • Page 374: Noise Reduction

    4. If desired, set the Sharpness Enhancement feature to the visual optimum. You can set the Basler PGI Feature Set from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to set the parameter values: // Select 5x5 demosaicing and start Basler PGI image quality optimization camera.DemosaicingMode.SetValue(DemosaicingMode_BaslerPGI);...
  • Page 375 // Set Raw value; range of value: 64 - 255 camera.SharpnessEnhancementRaw.SetValue(64); int64_t i = camera.SharpnessEnhancementRaw.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...

  • Page 376: Light Source Presets

    Also, the ColorTransformationMatrixFactor parameter is not available. For information about what are the color enhancement-related wake-up values of a camera model, see Table 61 on  page 357. factory sets, see "Factory Sets" on page 412.  Basler ace GigE...
  • Page 377 You can use the LightSourceSelector parameter value to set the correction for a specific light source or chose no correction. 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 selector and the parameter value: // Set the light source selector so that no correction will be done Camera.LightSourceSelector.SetValue (LightSourceSelector_Off);...

  • Page 378: Color Adjustment

    Section 8.18.5.7 on page 376. If color binning is enabled for the acA1920-25gc and acA2500-14gc, color adjustment will be applied after color binning has been performed. For more information about color binning, see Section 8.13.1 on page 329. Basler ace GigE...
  • Page 379 Fig. 135: RGB Color Cube With YCM Secondary Colors, of a color. At maximum saturation, no Black, and White, Projected On a Plane shade of gray is present. At minimum saturation, no "color" but only some shade of gray (including black and white) is present. Basler ace GigE...
  • Page 380 For example, if saturation for red is increased, the colorfulness of red colors in the image will increase. If red is set to minimum saturation, red will be replaced by gray for "red" colors in the image. Basler ace GigE...
  • Page 381 ColorAdjustmentSelector, ColorAdjustmentHue, ColorAdjustmentHueRaw, ColorAdjustmentSaturation, and ColorAdjustmentSaturationRaw parameter values from within your application software by using the Basler pylon API. In this example, we assume that you want to set your camera for Bayer BG8 output, and therefore you must set the ProcessedRawEnable parameter value to enabled.
  • Page 382 // Set the cyan saturation as an integer value Camera.ColorAdjustmentSaturationRaw.SetValue(176); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on page...

  • Page 383: Color Transformation

    For more information about color binning, see Section 8.13.1 on page 329. For information about how to obtain good color images with the Basler ace camera models, see Section 8.18.1.1 on  page 348. what are the color enhancement-related wake-up values of a camera model, see Table 61 on ...
  • Page 384 Bayer pixel data. Your final Bayer data output is no longer "raw" output, but rather "processed raw" output. *For acA640-300, acA800-200, acA1300-75, acA1920-40, acA1920-48, acA1920-50, acA2040-35, acA2440-20, and acA2500-20 camera models you don’t need the ProcessedRawEnable parameter. As a consequence, this parameter isn’t available for these cameras. Basler ace GigE...

  • Page 385: The Custom Light Source Setting

    Color transformation Value parameter to enter a value for that position. As an alternative the Gain XY values can each be entered as an integer value on a scale ranging from -256 to +255. This integer range maps linearly to the floating point range with -256 being Basler ace GigE...
  • Page 386 ColorTransformationValueRaw parameters from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the values in the matrix. Note that the values in this example are just randomly selected numbers and do not represent values that you should actually use.

  • Page 387: Color Transformation On Aca750-30Gc Cameras

    The second parameter associated with matrix color transformation is the LightSourceSelector parameter. The following settings are available for this parameter: Daylight 6500K  Custom  For information about the LightSourceSelector parameters, see Section 8.18.5.4 on page 365. Basler ace GigE...

  • Page 388: Luminance Lookup Table

    As you can see, the table does not include a user defined 12-bit value for every pixel value that the sensor can report. What does the camera do when the ADC reports a pixel value that is between two values that have a defined 12-bit output? In this case, the camera performs a straight line Basler ace GigE...
  • Page 389 0 through 2048 and increases gradually as the digitized sensor output moves from 2049 through 4096. 4095 3072 12bit camera output 2048 1024 1024 2048 3072 4095 12-Bit Digitized Sensor Reading Fig. 137: Lookup Table with Values Mapped in a Linear Fashion Basler ace GigE...
  • Page 390 3. Use the LUT Value parameter to set the selected value in the lookup table. 4. Use the LUT Index parameter and LUT value parameters to set other table values as desired. 5. Use the LUT Enable parameter to enable the table. Basler ace GigE...
  • Page 391 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);...

  • Page 392: Auto Functions

    You can use an auto function when binning is enabled (monochrome cameras and the acA1920-25gc, and acA2500-14gc 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 8.13 on page 327. Basler ace GigE...

  • Page 393: Auto Function Operating Modes

    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...

  • Page 394: Auto Function Aois

    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. 139: Auto Function Area of Interest and Image Area of Interest Basler ace GigE...

  • Page 395: Assignment Of An Auto Function To An Auto Function Aoi

    // Assign auto functions to the selected Auto Function AOI Camera.AutoFunctionAOISelector.SetValue(AutoFunctionAOISelector_AOI1); Camera.AutoFunctionAOIUsageIntensity.SetValue(true); Camera.AutoFunctionAOIUsageWhiteBalance.SetValue(true); // Select the unused Auto Function AOI 2 // Disable the unused Auto Function AOI Camera.AutoFunctionAOISelector.SetValue(AutoFunctionAOISelector_AOI2); Camera.AutoFunctionAOIUsageIntensity.SetValue(false); Camera.AutoFunctionAOIUsageWhiteBalance.SetValue(false); You can also use the Basler pylon Viewer application to easily set the parameters. Basler ace GigE...

  • Page 396: Positioning Of An Auto Function Aoi Relative To The Image Aoi

    You can use auto functions when also using the Reverse X and Reverse Y mirroring features. For information about the behavior and roles of Auto Function AOI and Image AOI when also using the Reverse X or Reverse Y mirroring feature, see the "Mirror Image" (Section 8.16 on page 341). Basler ace GigE...
  • Page 397 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. 140: Various Degrees of Overlap Between the Auto Function AOI and the Image AOI Basler ace GigE...

  • Page 398: Setting An Auto Function Aoi

    For more information about the concept of a "virtual sensor", see Section 8.13.3 on page 331. 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 Basler ace GigE...

  • Page 399: Gain Auto

    Camera.AutoFunctionAOISelector.SetValue(AutoFunctionAOISelector_AOI1); Camera.AutoFunctionAOIOffsetX.SetValue(0); 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 8.20.4 Gain Auto Gain Auto is the "automatic" counterpart to manually setting the GainRaw parameter. When the...
  • Page 400 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: To set the gain auto functionality: 1.

  • Page 401: Exposure Auto

    AW00089325000 Features // 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 general information about auto functions, see Section 8.20 on page 381.
  • Page 402 // (If gain auto is enabled, this target is also used for gain auto control.) Camera.AutoTargetValue.SetValue(128); // 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. Basler ace GigE...
  • Page 403 Auto Function AOIs and how to set them, see Section 8.20.3 on page 383.  minimum allowed and maximum possible exposure time, see Section 6.12 on page 214.  For general information about auto functions, see Section 8.20 on page 381. Basler ace GigE...

  • Page 404: Gray Value Adjustment Damping

    You can set the gray value adjustment damping from within your application software by using the pylon API. The following code snippets illustrate using the API to set the gray value adjustment damping: Camera.GrayValueAdjustmentDampingRaw.SetValue(600); Camera.GrayValueAdjustmentDampingAbs.SetValue(0.5859); You can also use the Basler pylon Viewer application to easily set the parameters. Basler ace GigE...

  • Page 405: Auto Function Profile

    // Use GainAuto and ExposureAuto simultaneously Camera.AutoFunctionProfile.SetValue(AutoFunctionProfile_GainMinimum); Camera.GainAuto.SetValue(GainAuto_Continuous); 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 Basler ace GigE...

  • Page 406: Balance White Auto

    API. The following code snippets illustrate using the API to set the balance auto functionality: // Select auto function AOI 2 Camera.AutoFunctionAOISelector.SetValue(AutoFunctionAOISelector_AOI2); // Set mode of operation for balance white auto function Camera.BalanceWhiteAuto.SetValue( BalanceWhiteAuto_Once ); You can also use the Basler pylon Viewer application to easily set the parameters. Basler ace GigE...

  • Page 407: Balance White Adjustment Damping

    You can set the balance white adjustment damping from within your application software by using the pylon API. The following code snippets illustrate using the API to set the balance white adjustment damping: Camera.BalanceWhiteAdjustmentDampingRaw.SetValue(600); Camera.GrayValueAdjustmentDampingAbs.SetValue(0.5859); You can also use the Basler pylon Viewer application to easily set the parameters. Basler ace GigE...

  • Page 408: Pattern Removal

    Correction coefficient values are only valid for the specific imaging conditions (see below) that were present when the correction coefficients were configured. When Basler acA3800-10gm cameras are switched on for the first time, they wake up with default pattern removal correction values.
  • Page 409 If you don’t observe this point, the image quality will decrease significantly. 2. If possible, establish homogeneous illumination for the scene to be imaged. 3. Deactivate all camera settings and features (e.g. auto functions, sequencer) that would interfere with the generation of correction coefficient values. Basler ace GigE...
  • Page 410 Enabling the Pattern Removal Function Using the pylon API You can enable the PatternRemovalAuto function from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to enable the pattern removal functionality: Camera.PatternRemovalAuto.SetValue(PatternRemovalAuto_Once);...

  • Page 411: Color Cameras

    9. If necessary, set the auto function profile to define priorities between auto functions. 10. Enable the auto function by setting it to "once" or "continuous". For more information about the individual settings, see the previous sections that describe the individual auto functions. Basler ace GigE...

  • Page 412: Median Filter

    The median filter is a multi-directional 3x3 weighted median filter. The filter is compatible with mono and color cameras. Setting the Median Filter You can set the MedianFilter parameter from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to enable the median filter: // Enable the median filter camera.MedianFilter.SetValue(true);...

  • Page 413: Event Notification

    1. A FrameStartOvertrigger event is created. The event contains the event in the strict sense plus supplementary information: An Event Type Identifier. In this case, the identifier would show that a frame start overtrigger type event has occurred. A Stream Channel Identifier. Currently this identifier is always 0. Basler ace GigE...
  • Page 414 4. As soon as transmission time is available, an event message containing the event overrun event will be transmitted to the computer. The event overrun event is a warning that events are being dropped. The notification contains no specific information about how many or which events have been dropped. Basler ace GigE...
  • Page 415 API. The pylon software development kit includes a "Grab_CameraEvents" 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.

  • Page 416: Test Images

    TestImageSelector to one of the test images or to "test image off". You can set the Test Image Selector from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to set the selector: // Set for no test image Camera.TestImageSelector.SetValue(TestImageSelector_Off);...
  • Page 417 // Set test image reset and hold and read the current setting camera.TestImageResetAndHold.SetValue(true); bool b = camera.TestImageResetAndHold.GetValue(); You can also use the Basler pylon Viewer application to easily set the parameter. For more information about the pylon API, the pylon Viewer, and the pylon IP Configurator, see Section 3 on...

  • Page 418: Test Image Descriptions

    81 °C (177.8 °F), it will automatically enter the over temperature mode. In this mode, the camera no longer acquires images but delivers the internally generated test image 2. For more information about the over temperature mode and how to leave it, see Section 1.8.3 on page Basler ace GigE...
  • Page 419 Figure 142, test image six consists of diagonal color gradients (when a Mono pixel format is selected, gray gradients will appear). The image moves by one pixel from right to left whenever you signal the camera to capture a new image. Fig. 142: Test Image Six Basler ace GigE...

  • Page 420: Device Information Parameters

    You can read the values for all of the device information parameters or set the value of the DeviceUserID parameter from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to read the parameters or write the DeviceUserID: // Read the Vendor Name parameter Pylon::String_t vendorName = Camera.DeviceVendorName.GetValue();...
  • Page 421 // 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 DeviceUserID. You can use the Basler pylon IP Configurator to read or write the DeviceUserID.

  • Page 422: User-Defined Values

    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...

  • Page 423: Configuration Sets

    Similar to default factory set, but gain auto and factory set exposure auto auto functions are both enabled and are set to the continuous mode of operation. During automatic parameter adjustment, gain will be kept to a minimum. Basler ace GigE...
  • Page 424 The camera can save most of the settings from the current active set to a reserved area in the camera’s non-volatile memory. A configuration set that has been saved in the non-volatile memory is not lost when the camera is Basler ace GigE...

  • Page 425: The Color Factory Set

    357. One of the factory sets is known as the "color factory set", and the parameter settings contained in the color factory set are optimized to produce good color images under the most common lighting conditions. Basler ace GigE...

  • Page 426: The "Raw Color" Factory Set

    Section 8.20 on page 381.  loading a factory set into the active set, see Section 8.26.4 on page 417.  designating which set will be the startup set, see Section 8.26.5 on page 418.  Basler ace GigE...

  • Page 427: Saving A User Set

    API to set the selector and execute the command: Camera.UserSetSelector.SetValue(UserSetSelector_UserSet1); Camera.UserSetSave.Execute( ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 428: Loading A User Set Or A Factory Set Into The Active Set

    The standard factory set 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...

  • Page 429: Designating The Startup Set

    You can set the UserSetDefaultSelector parameter 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...

  • Page 430: Chunk Features

    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 (see Section 9.2 on page 420). Basler ace GigE...

  • Page 431: Chunk Mode Active And Enabling The Extended Data Chunk

    To make the chunk mode active: 1. Set the ChunkModeActive parameter to True. You can set the ChunkModeActive 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 432: Data Chunks

    For information about retrieving data chunks, see Section 9.3.10 on page 431, the Programmer’s Guide and Reference Documentation, and the sample code that is included with the Basler pylon Software Development Kit (SDK). You can set the ChunkSelector and ChunkEnable parameter value from within your application software by using the Basler pylon Camera Software Suite.

  • Page 433: Exposure Time Chunk

    For information about retrieving data chunks, see Section 9.3.10 on page 431, the Programmer’s Guide and Reference Documentation, and the sample code that is included with the Basler pylon Software Development Kit (SDK). For more information about the pylon API and the pylon Viewer, see Section 3 on page 9.3.3...

  • Page 434: Timestamp Chunk

    For information about retrieving data chunks, see Section 9.3.10 on page 431, the Programmer’s Guide and Reference Documentation, and the sample code that is included with the Basler pylon Software Development Kit (SDK). 9.3.5 Frame Counter Chunk The frame counter feature numbers frames sequentially as they are acquired. When the Frame Counter Chunk feature is enabled, a chunk is added to each frame containing the value of the counter.
  • Page 435 You can set the frame CounterReset 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 436: Trigger Input Counter Chunk

    // execute reset by software 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 ...
  • Page 437 You can set the TriggerInputCounterReset 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 438: Crc Checksum Chunk

    // execute reset by software 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 ...

  • Page 439: Sequence Set Index Chunk

    You can set the Chunk Selector and Chunk Enable parameter value from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to activate the chunk mode and enable the time stamp chunk: // Make chunk mode active and enable CRC chunk Camera.ChunkModeActive.SetValue( true );...
  • Page 440 For information about retrieving data chunks, see Section 9.3.10 on page 431, the Programmer’s Guide and Reference Documentation, and the sample code that is included with the Basler pylon Software Development Kit (SDK). You can set the ChunkSelector and ChunkEnable parameter values from within your application software by using the Basler pylon API.

  • Page 441: Extended Image Chunks

    True. You can set the ChunkModeActive parameter from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to activate the chunk mode: // Make chunk mode active Camera.ChunkModeActive.SetValue( true );...

  • Page 442: Retrieving Data Chunks

    GenICam node map. For information about retrieving data chunks, see the Programmer’s Guide and Reference Documentation and the sample code that is included with the Basler pylon Software Development Kit (SDK).

  • Page 443: Troubleshooting And Support

    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.

  • Page 444: Before Contacting Basler Technical Support

    10.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 445 Did your application ever run without problems? Parameter set It is very important for Basler technical support to get a copy of the exact camera parameters that you were using when the problem occurred. To make note of the parameters, use Basler’s pylon Viewer.

  • Page 446: Appendix A Basler Network Drivers And Parameters

    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.

  • Page 447: The Basler Filter Driver

    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.

  • Page 448: The Basler Performance Driver

    The Basler performance driver uses a "receive window" to check the status of packets. The check for missing packets is made as packets enter the receive window. If a packet arrives from higher in the sequence of packets than expected, the preceding skipped packet or packets are detected as missing.

  • Page 449: General Parameters

    AW00089325000 Basler Network Drivers and Parameters A.2.1 General Parameters EnableResend - Enables the packet resend mechanisms. If the EnableResend 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 450 Basler Network Drivers and Parameters AW00089325000 ResendRequestThreshold - This parameter determines the location of the resend request threshold within the receive window as shown in Figure 146. The parameter value is in per cent of the width of the receive window. In Figure 146 the resend request threshold is set at 33.33% of the width of the receive window.

  • Page 451: Timeout Resend Mechanism Parameters

    AW00089325000 Basler Network Drivers and Parameters A.2.3 Timeout Resend Mechanism Parameters The timeout resend mechanism is illustrated in Figure 147 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 452 Basler Network Drivers and Parameters AW00089325000 MaximumNumberResendRequests - The MaximumNumberResendRequests parameter sets the maximum number of resend requests the performance driver will send to the camera for each missing packet. ResendTimeout - The ResendTimeout parameter defines how long (in milliseconds) the performance driver will wait after detecting that a packet is missing before sending a resend request to the camera.

  • Page 453: Threshold And Timeout Resend Mechanisms Combined

    AW00089325000 Basler Network Drivers and Parameters A.2.4 Threshold and Timeout Resend Mechanisms Combined Figure 148 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 454 (12) Interval defined by the PacketTimeout parameter. You can set the performance driver parameter values from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to read and write the parameter values: // Get the Stream Parameters object Camera_t::StreamGrabber_t StreamGrabber(Camera.GetStreamGrabber(0));...

  • Page 455: Adapter Properties

    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.

  • Page 456: Transport Layer Parameters

    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 457: Appendix B Network Related Camera Parameters And Managing Bandwidth

    The PacketSize 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 458 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 459 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 460 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 461 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 462 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 463 // 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...

  • Page 464: Managing Bandwidth When Multiple Cameras Share A Single Network Path

    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 465 After you have adjusted the Inter-PacketDelay parameter on each camera, you can check the sum of the BandwidthAssigned parameter values and see, if the sum is now less than 125 MByte/s. Basler ace GigE...

  • Page 466: A Procedure For Managing Bandwidth

    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 467 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 468 To determine the “data bandwidth assigned,” you must subtract out the reserve. Basler ace GigE...
  • Page 469 M/Byte/s for a 100 Bit/s network, the cameras need more bandwidth than is available and you must make adjustments. In essence, you must lower the data bandwidth needed by one or more of the cameras and then adjust the data bandwidths assigned so that they reflect the lower bandwidth needs. Basler ace GigE...
  • Page 470 AOI settings on the cameras, you should repeat steps 2 through 6. For more information about the camera’s maximum allowed frame transmission rate, see Section 6.13 on page 218.  the AOI, see Section 8.5 on page 253.  Basler ace GigE...

  • Page 471: Revision History

    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 472 Section 11.2 on page 310 accordingly. AW00089312000 16 Dec 2011 Indicated Basler AG as bearer of the copyright on the back of the front page. Corrected the pixel size for the acA640-90gm/gc camera in Section 1.2 on page 2.
  • Page 473 Integrated minimum output pulse width feature, see Section 5.11.2 on  page 110. Integrated note on the slowdown of the sequencer feature for the  acA2500-14 in Section 9.12. Section 11 Replaced Z-modem by X-modem in Section 11.7 on page 321. Basler ace GigE...
  • Page 474  the voltage ranges for the input and output lines and that the recommended voltage range for camera power for Basler ace  GigE cameras differ from the recommended voltage range for camera...
  • Page 475 Added warnings on avoiding dust on the sensor in Section 1.9 on page 65. Changed the name of the acA640-100gm/gc camera model to acA640- 120gm/gc. Renaming throughout the manual: Changed pylon driver package to Basler pylon Camera Software Suite  IP Configuration Tool to IP Configurator ...
  • Page 476 Added note in Section 6.4.1.2 on page 144. Added the median filter feature for the acA1280-60, acA1300-60, and the acA1600-60 cameras in Section 9.20 on page 391. Restructured the reverse Y feature section (Section 9.16.2 on page 361). Basler ace GigE...
  • Page 477 Section 9.2.1 on page 267. It’s the same as for the acA2500-14. Image Area of Interest (AOI) section: Corrected the increment examples for width and height (all camera models) on page 275. Rearranged the binning section (Section 9.13 on page 346). Basler ace GigE...
  • Page 478 Corrected Exposure Active description, inlcuding Figure 90 on page 188: The Exposure Active signal goes high when the exposure for the first line in a frame begins and goes low when the exposure for the last line ends. To be continued. Basler ace GigE...
  • Page 479 (Section 9.22). Updated Section 9.25: Modifications throughout the whole section: replaced Default Set Selector with Configuration Set Selector. Added Raw Color factory set for camera models with GPIO. Deleted section "Selecting a Factory Setup as the Default Set". Basler ace GigE...
  • Page 480 Added information about removing artificial color shift in the "Balance White" section on page 229 (acA3800-10gc and 4600-7gc). Adapted the processed raw enabled description on page 237 page 244. Added the new "A Procedure for Setting the Color Enhancements" feature page 246. To be continued. Basler ace GigE...
  • Page 481 "Scheduled Action Commands" on page 284  "Synchronous Free Run" on page 287  "Test Image Reset and Hold" on page 406  Updated the "Test Image 6 - Moving Diagonal Color Gradient" section on page 408. To be continued. Basler ace GigE...
  • Page 482 Inserted Color Creation and Enhancement section in Section 8.18 on page 348. No separate chapter any more. Added section "How to Obtain Good Color Settings in Your Camera" on page 348 and deleted "A Procedure for Setting the Color Enhancements" section. Basler ace GigE...
  • Page 483 Added information that the full AOI size must be set when generating values for the pattern removal function (see page 398). Added extended image chunks in Section 9.3.9 on page 430. Basler ace GigE...
  • Page 484 Doc. ID Number Date Changes AW00089325000 31 Oct 2016 Correction: Now the power consumption values in the tables of chapter 1 are modified for the following camera models: acA640-120, acA750-30, acA1280-60, acA1300-22, acA1300-30, acA1300-60, acA1600-60, acA1920-25, acA2000-50, acA2040-25, acA2500-14. Basler ace GigE...

  • Page 485: Index

    ..300 controlled sequence set advance averaging mode............304 binning mode........328 current set..........295 balance white auto .........395 damping binning gray value adjustment ~ ..393 AOI settings........332 debouncer image distortion......327 setting ..........120 reduced resolution......332 Basler ace GigE...
  • Page 486 (direct coupled) median ~ ..........401 voltage requirements....104 frame counter reset, synchronous ..280 internal temperature (core board).... 67 frame start overtrigger event ....402 Issue Action Command ......278 frame start trigger........297 free run, synchronous ......287 Basler ace GigE...
  • Page 487 I/O cable rolling ~ ..........179 voltage requirements....104 shutter mode precision time protocol ......265 rolling mode ........179 propagation delay........108 slave clock ..........266 PTP ............265 stacked zone imaging ......258 PTP clock synchronization .....268 Basler ace GigE...
  • Page 488 162 use case diagrams ......... 299 user configuration set......413 user defined values ........ 411 user set ..........413 vertical ~ decimation ........334 white balance auto see balance white auto zone imaging..........258 Basler ace GigE...

This manual is also suitable for:

Ace aca2440-20Ace aca640-90gmAce aca640-90gcAce aca640-120gmAce aca640-120gcAce aca645-100gm ... Show all