SIDX 7
|
File containing SIDX root usage for reference. More...
#include "SIDXConstants.h"
Go to the source code of this file.
Functions | |
SIDXRootOpen (integer SIDXroot, string license, integer status) | |
The function returns a handle used to control SIDX. More... | |
SIDXRootClose (integer SIDXroot, integer status) | |
Close SIDX. More... | |
SIDXRootGetLastError (integer SIDXroot, string message) | |
The function translates the last error into a text string. More... | |
SIDXRootEnableCapabilities (integer SIDXroot, integer capability, integer status) | |
Enable a special camera capability. More... | |
SIDXRootArchiveOpen (integer SIDXroot, string path, integer SIDXarchive, integer status) | |
Open a file as an image archive. More... | |
SIDXRootCameraScan (integer SIDXroot, integer status) | |
This operation scans the computer system to locate any available cameras. More... | |
SIDXRootCameraScanGetReport (integer SIDXroot, string report, integer status) | |
Obtain a detailed report of all available cameras on the system. More... | |
SIDXRootCameraScanGetCount (integer SIDXroot, integer count, integer status) | |
Return the number of connected camera count as the result of SIDXRootCameraScan. More... | |
SIDXRootCameraScanGetName (integer SIDXroot, integer index, string name, integer status) | |
Obtain the name of the camera corresponding to the index. More... | |
SIDXRootCameraScanGetLabel (integer SIDXroot, integer index, string label, integer status) | |
Obtain the label representing the camera. More... | |
SIDXRootCameraOpenName (integer SIDXroot, string name, integer SIDXcamera, integer status) | |
Connect to the specified camera by name. More... | |
SIDXRootSoftwareGetDescription (integer SIDXroot, string description, integer status) | |
Obtain the software description as a text string. More... | |
SIDXRootSoftwareGetLicense (integer SIDXroot, string license, integer status) | |
Obtain the software license string. More... | |
SIDXRootSoftwareGetSerial (integer SIDXroot, string serial, integer status) | |
Obtain the software serial number as a text string. More... | |
SIDXRootSoftwareIsLicensed (integer SIDXroot, integer licensed, integer status) | |
Verify if the SIDX software license is valid. More... | |
SIDXRootSoftwareSetLicense (integer SIDXroot, string license, integer status) | |
Sets an SIDX license. More... | |
SIDXRootStageOpen (integer SIDXroot, string name, string port, integer SIDXstage, integer status) | |
Open the stage controller, by name, on the specified port. More... | |
File containing SIDX root usage for reference.
SIDXRootArchiveOpen | ( | integer | SIDXroot, |
string | path, | ||
integer | SIDXarchive, | ||
integer | status | ||
) |
Open a file as an image archive.
SIDXroot | A handle value that references the SIDX root context. |
path | The path to the image file to open. |
SIDXarchive | A variable to receive a handle value used to control the image file. |
status | Non-zero if the function failed, zero if it succeeded. |
SIDXRootCameraOpenName | ( | integer | SIDXroot, |
string | name, | ||
integer | SIDXcamera, | ||
integer | status | ||
) |
Connect to the specified camera by name.
The camera name string can be only a driver name, for example, "PCO pixelfly" or "Andor Technology". In the case that a driver owns multiple cameras, the camera name string must include the the index value.
SIDXroot | A handle value that references the SIDX root context. |
name | A name string of the camera to open. |
SIDXcamera | A variable to receive a handle value that references the open camera. |
status | Non-zero if the function failed, zero if it succeeded. |
SIDXRootCameraScan | ( | integer | SIDXroot, |
integer | status | ||
) |
This operation scans the computer system to locate any available cameras.
The operation cannot be performed if SIDX has any cameras open. The number of available cameras may be zero or more. Use SIDXRootCameraScanGetCount to obtain the number of cameras found on the computer system. This value may be zero. The operation creates a text report that may be useful if unexpected results occur. Use SIDXRootCameraScanGetReport to obtain this report.
SIDXroot | A handle value that references the SIDX root context. |
status | Non-zero if the function failed, zero if it succeeded. |
SIDXRootCameraScanGetCount | ( | integer | SIDXroot, |
integer | count, | ||
integer | status | ||
) |
Return the number of connected camera count as the result of SIDXRootCameraScan.
SIDXroot | A handle value that references the SIDX root context. |
count | A variable to receive an integer count of connected cameras, including any simulated cameras |
status | Non-zero if the function failed, zero if it succeeded. |
SIDXRootCameraScanGetLabel | ( | integer | SIDXroot, |
integer | index, | ||
string | label, | ||
integer | status | ||
) |
Obtain the label representing the camera.
The label is intended to be human readable.
SIDXroot | A handle value that references the SIDX root context. |
index | The index of the camera in the connected camera list. |
label | A text string to receive the text label of camera given the index. |
status | Non-zero if the function failed, zero if it succeeded. |
SIDXRootCameraScanGetName | ( | integer | SIDXroot, |
integer | index, | ||
string | name, | ||
integer | status | ||
) |
Obtain the name of the camera corresponding to the index.
This name is used to open the camera.
SIDXroot | A handle value that references the SIDX root context. |
index | The index of the camera in the connected camera list. |
name | A text string to receive the text name of camera given the index. |
status | Non-zero if the function failed, zero if it succeeded. |
SIDXRootCameraScanGetReport | ( | integer | SIDXroot, |
string | report, | ||
integer | status | ||
) |
Obtain a detailed report of all available cameras on the system.
SIDXroot | A handle value that references the SIDX root context. |
report | A text string to receive the text report of camera scan result. |
status | Non-zero if the function failed, zero if it succeeded. |
SIDXRootClose | ( | integer | SIDXroot, |
integer | status | ||
) |
Close SIDX.
This should be the last call to SIDX before the object is discarded.
SIDXroot | A handle value that references the SIDX root context. |
status | Non-zero if the function failed, zero if it succeeded. |
SIDXRootEnableCapabilities | ( | integer | SIDXroot, |
integer | capability, | ||
integer | status | ||
) |
Enable a special camera capability.
The supported capabilities are: 1000: Enable Photometrics PVCAM support 1001: Enable Princeton Instruments PVCAM support By default, Photometrics PVCAM support is enabled.
SIDXroot | A handle value that references the SIDX root context. |
capability | The capability to enable. |
status | Non-zero if the function failed, zero if it succeeded. |
SIDXRootGetLastError | ( | integer | SIDXroot, |
string | message | ||
) |
The function translates the last error into a text string.
SIDXroot | A handle value that references the SIDX root context. |
message | A text string to receive the text associated with the last error. |
SIDXRootOpen | ( | integer | SIDXroot, |
string | license, | ||
integer | status | ||
) |
The function returns a handle used to control SIDX.
SIDXroot | A variable to receive a handle value that references the SIDX root context. |
license | A text string containing a valid SIDX license. If the string is null or invalid, SIDX will look for the license file. |
status | Non-zero if the function failed, zero if it succeeded. |
SIDXRootSoftwareGetDescription | ( | integer | SIDXroot, |
string | description, | ||
integer | status | ||
) |
Obtain the software description as a text string.
The software description includes the product and version, for example: 'SIDX 7.0.1'.
SIDXroot | A handle value that references the SIDX root context. |
description | A text string to receive the text description of the software. |
status | Non-zero if the function failed, zero if it succeeded. |
SIDXRootSoftwareGetLicense | ( | integer | SIDXroot, |
string | license, | ||
integer | status | ||
) |
Obtain the software license string.
SIDXroot | A handle value that references the SIDX root context. |
license | A text string to receive the text license of the software. |
status | Non-zero if the function failed, zero if it succeeded. |
SIDXRootSoftwareGetSerial | ( | integer | SIDXroot, |
string | serial, | ||
integer | status | ||
) |
Obtain the software serial number as a text string.
SIDXroot | A handle value that references the SIDX root context. |
serial | A text string to receive the text serial number of the software. |
status | Non-zero if the function failed, zero if it succeeded. |
SIDXRootSoftwareIsLicensed | ( | integer | SIDXroot, |
integer | licensed, | ||
integer | status | ||
) |
Verify if the SIDX software license is valid.
If the software is not licensed all SIDX calls will return an invalid operation status code.
SIDXroot | A handle value that references the SIDX root context. |
licensed | A value to receive a boolean value, true if the software is licensed, otherwise false. |
status | Non-zero if the function failed, zero if it succeeded. |
SIDXRootSoftwareSetLicense | ( | integer | SIDXroot, |
string | license, | ||
integer | status | ||
) |
Sets an SIDX license.
If there is an existing license it will be overwritten.
SIDXroot | A handle value that references the SIDX root context. |
license | A text string software license code. |
status | Non-zero if the function failed, zero if it succeeded. |
SIDXRootStageOpen | ( | integer | SIDXroot, |
string | name, | ||
string | port, | ||
integer | SIDXstage, | ||
integer | status | ||
) |
Open the stage controller, by name, on the specified port.
SIDXroot | A handle value that references the SIDX root context. |
name | A text string containing the name of the stage. An empty string will return an error. |
port | A string specifying the serial port to be used. An empty string will return an error. |
SIDXstage | A variable to receive a handle value that references the open stage. |
status | Non-zero if the function failed, zero if it succeeded. |