University of Illinois at Urbana-Champaign

emcCameraOpen

NAME

emcCameraOpen - Begin communication with camera

SYNOPSIS

#include "emc.h"
int emcCameraOpen(EM *em, int *id, char *devname);

DESCRIPTION

emcCameraOpen() sets up and initializes communication with a camera attached to the electron microscope. A camera identification number is returned in id; this id is used to identify which camera the remaining camera functions should act upon.

*em
points to an EM control and communications structure that was returned by the emcOpen() call.
*id
is a pointer to memory location that the camera identification number will be returned in.
*device
is a pointer to a NULL terminated array of characters (string) which indicate the device name of the camera to communicate with. The valid contents of this string are defined by the implementation of the EMC library. Some examples are:
machine.name.domain:1970 Camera is connected through an instrument control server specified using communications port 1970.

RESTRICTIONS

The caller is responsible for calling emcCameraClose() for each camera opened by emcCameraOpen() to release any resources that may have been allocated and for terminating the connection with the camera.

DIAGNOSTICS

EMC_OK (0) Success
EMC_ERROR (-1) Error

PREVIOUS Page 19 of 54 NEXT