
20
PICam™ 5.x Programmer’s Manual
Issue 11
2.6.1
Handles
Most PICam APIs require handles to identify the specific hardware with which they are
currently interacting. When hardware is brought online, it is assigned a specific handle
that is then used to identify it throughout the active session.
The following handle(s) may be passed as an API parameter:
•
accessory
Identifies a specific non-camera accessory within the system.
•
camera
Identifies a specific camera within the system.
When
camera
is passed to an API, PICam determines the appropriate actions
depending on the API that has been called.
This handle is passed as a Basic API parameter.
•
camera_or_accessory
Identifies hardware within the system that can be either a camera or an
accessory.
•
device
Identifies a specific PHYSICAL camera within the system.
When
device
is passed to an API, any resulting interaction or configuration
performed by the API is done on a physical camera that is attached to the
system.
This handle is passed as an Advanced API parameter, and must be used in
conjunction with
model
.
•
model
Identifies a specific VIRTUAL camera within application memory.
When
model
is passed to an API, any parameter configuration changes are
temporarily stored in system memory (i.e., within the host computer.) The
actual camera configuration remains unchanged until an API is called that
commits values to the
device
(i.e., the physical camera.)
This handle is passed as an Advanced API parameter, and must be used in
conjunction with
device
.
illustrates the hierarchical relationship between PICam camera-specific
handles and with which set of APIs they are valid.
Figure 2-2: Block Diagram of Camera-Specific Handle Hierarchy
Basic APIs
Advanced APIs
Virtual Camera
model
Hardware
device
commit paramet
ers
camera
/
accessory
/
cameraOrAccessory
44
11
-0
161
_
0
0
0
5
Содержание Princeton Instruments PICam 5.x
Страница 1: ...www princetoninstruments com PICam 5 x Programmer s Manual 4411 0161 Issue 11 June 28 2021...
Страница 4: ...4 PICam 5 x Programmer s Manual Issue 11 This page is intentionally blank...
Страница 14: ...14 PICam 5 x Programmer s Manual Issue 11 This page is intentionally blank...
Страница 180: ...180 PICam 5 x Programmer s Manual Issue 11 This page is intentionally blank...
Страница 192: ...192 PICam 5 x Programmer s Manual Issue 11 This page is intentionally blank...
Страница 290: ...290 PICam 5 x Programmer s Manual Issue 11 This page is intentionally blank...
Страница 302: ...302 PICam 5 x Programmer s Manual Issue 11 This page is intentionally blank...
Страница 326: ...324 PICam 5 x Programmer s Manual Issue 11 This page is intentionally blank...
Страница 351: ...This page is intentionally blank...
Страница 354: ......