XiAPI.NET Offline Processing¶

xiAPI.NET allows to process already captured images from camera those are stored in memory or loaded from disk.

Architecture¶

Application creates xiProc class and uses processing functions which are implemented in API .NET library.
All processing functions can be called independently to currently opened camera.

Workflow¶

• Get images from camera while storing them to some media
• Get and store API_context for later processing
  • GetParamString API_CONTEXT_LIST
• Create instance of xiProc object
• Set the camera context list to processing
  • ProcSetParam API_CONTEXT_LIST
• Eventually modify some parameters to tune up processing
• For each captured image:
  • Push image
  • Pull image

Sample¶

Source code for capturing 10 frames then processing 10 captured frames is available for download - Program.cs

Interface¶

These are the functions, which allow to control Offline Processing.

// Open processing instance
void ProcOpen();

// Set the parameter to processing
// Same parameters can be set like in SetParam xiCam class.
void ProcSetParam(string prm, string val);
void ProcSetParamInt(string prm, int val);
void ProcSetParamFloat(string prm, float val);

// Get the parameter from processing
// Same parameters can be get like in GetParam xiCam class.
string ProcGetParam(string prm);
int ProcGetParamInt(string prm);
float ProcGetParamFloat(string prm);

// Set unprocessed image to processing chain
void ProcPushXiImg(XI_IMG image);
void ProcPushImage(XI_IMG image);

// Gets next processed image from processing chain
void ProcPullImageInternal(out XI_IMG img, int timeout)
void ProcPullImage(out Bitmap image, int timeout)
void ProcPullImage(out BitmapSource image, int timeout)
void ProcPullImage(out WriteableBitmap image, int timeout)
void ProcPullImage(out byte[] img_arr, int timeout)

// Closes instance for Image Processing entity
void ProcClose();

Result codes¶

Functions can throw instances of xiExc class that contains error code
and message. Error codes are combined from xiAPI.NET (0..999) and
xiProc (1000-1999). List of specific offline processing codes:

Availability¶

Offline processing is available since release V4_13_10.