Matrox.MatroxImagingLibrary.v3.5

Extract laser line data from an image and store this data in a 3D reconstruction result buffer.

Specifies the identifier of the 3D reconstruction context. Specifies the identifier of the 3D reconstruction result buffer in which to store the laser line data. The 3D reconstruction result buffer must have been previously allocated using M3dmapAllocResult with M_LASER_CALIBRATION_DATA, M_POINT_CLOUD_CONTAINER, or M_DEPTH_CORRECTED_DATA. Specifies the identifier of the image buffer containing the grabbed image of the laser line. Specifies the identifier of the image buffer containing the intensity map, if using a 3D camera. Reserved for future expansion. This parameter must be set to M_NULL . Specifies the label of the point cloud in the result buffer in which to add the laser line data, if the result buffer has been allocated using M3dmapAllocResult with M_POINT_CLOUD_CONTAINER. Specifies the function's control flag. This parameter must be set to one of the following values:

Compute the transformation that aligns two point clouds.

Specifies the identifier of a pairwise 3D alignment context, allocated using M3dmapAlloc with M_PAIRWISE_ALIGNMENT_CONTEXT. Specifies the 3D reconstruction result buffer of type M_POINT_CLOUD_CONTAINER that contains the model point cloud(s). Specifies the point cloud(s) in the specified 3D reconstruction result buffer, or the entire result buffer itself, that represents the model. Specifies the 3D reconstruction result buffer of type M_POINT_CLOUD_CONTAINER that contains the scene point cloud(s). Specifies the point cloud(s) in the specified 3D reconstruction result buffer, or the entire result buffer itself, that represents the scene. Specifies a transformation matrix in a pairwise 3D alignment result buffer or 4x4 MIL array buffer, which is used to prealign the model before the pairwise 3D alignment process begins. Specifies a pairwise 3D alignment result buffer or 4x4 MIL array buffer used to store the results from the pairwise 3D alignment process. Reserved for future expansion and must be set to M_DEFAULT . Specifies the address of the variable in which to write the 3D alignment status of the alignment operation.

Allocate a 3D reconstruction context, a pairwise 3D alignment context, or a geometry object.

Specifies the identifier of the system on which to allocate the 3D reconstruction context or geometry object. Specifies to allocate a 3D reconstruction context or geometry object. This parameter must be set to one of the following: Specifies the 3D reconstruction mode of the context, which determines how data is represented. Specifies the address of the variable in which to write the 3D reconstruction context or geometry object identifier. The returned value is the 3D reconstruction context or geometry object identifier if allocation is successful. If allocation fails, M_NULL is returned.

Allocate a 3D reconstruction context, a pairwise 3D alignment context, or a geometry object.

Allocate a 3D reconstruction result buffer.

Specifies the identifier of the system on which to allocate the result buffer. Specifies the type of result buffer to allocate. This parameter must be set to the following value: Reserved for future expansion and must be set to M_DEFAULT . Specifies the address of the variable in which to write the 3D reconstruction result buffer identifier. The returned value is the 3D reconstruction result buffer identifier if the allocation is successful. If allocation fails, M_NULL is returned.

Allocate a 3D reconstruction result buffer.

Perform a point-to-point arithmetic operation on depth maps and geometry objects.

Specifies the data source of the first operand. Specifies the data source of the second operand. Specifies the identifier of the destination image buffer in which to put the result of the arithmetic operation. Specifies the identifier of the image buffer used as a mask. Specifies the operation to perform. Specifies how to handle the camera calibration information of the destination buffer.

Calibrate a 3D reconstruction setup.

Specifies the identifier of the 3D reconstruction context used to extract the laser line from grabbed images. Specifies the identifier of the 3D reconstruction result buffer that contains the laser line data required for calibration. The 3D reconstruction result buffer must have been previously allocated using M3dmapAllocResult and contain data for at least one laser line. Specifies the identifier of the camera calibration context that contains the 3D camera calibration data or M_NULL . Reserved for future expansion and must be set to M_DEFAULT .

Calibrate a 3D reconstruction setup that uses multiple camera-laser pairs.

Specifies the address of an array containing the identifiers of the 3D reconstruction context used to extract the laser line from grabbed images. Specifies the address of an array containing the identifiers of the 3D reconstruction result buffers that contains the laser line data required for calibration. Specifies the address of an array containing the identifiers of the camera calibration contexts of the cameras used to grab the laser lines. Specifies the number of camera-laser pairs. Specifies the function's control flag.

Clear a 3D reconstruction result buffer of some or all of its content.

Specifies the identifier of the 3D reconstruction result buffer to clear. Specifies the point cloud(s) in the specified 3D reconstruction result buffer. Specifies the operation to perform. Reserved for future expansion and must be set to M_DEFAULT .

Control a 3D reconstruction context, geometry object, or result buffer.

Specifies the identifier of the 3D reconstruction context, geometry object, or result buffer to control. Specifies the point cloud(s) in the specified 3D reconstruction result buffer, or the entire result buffer itself, to control. Specifies the type of setting to control. Specifies the required value for the setting.

Control a 3D reconstruction context, geometry object, or result buffer.

Copy one or more point clouds from one M_POINT_CLOUD_CONTAINER result buffer to another.

Specifies the identifier of the 3D reconstruction result buffer containing the source point clouds to copy/move. The 3D reconstruction result buffer must have been previously allocated using M3dmapAllocResult with M_POINT_CLOUD_CONTAINER. Specifies the point cloud(s) to copy/move from the source M_POINT_CLOUD_CONTAINER result buffer. Specifies the identifier of the 3D reconstruction result buffer in which to copy/move the source point cloud(s). The 3D reconstruction result buffer must have been previously allocated using M3dmapAllocResult with M_POINT_CLOUD_CONTAINER. You can specify the same identifier as the SrcResult3dmapId identifier, but the label to assign the copied/moved point cloud must be different. Specifies a new label in the destination M_POINT_CLOUD_CONTAINER result buffer in which to copy/move the source point cloud(s). Specifies the type of operation to perform. Reserved for future expansion and must be set to M_DEFAULT .

Copy a single point cloud from one M_POINT_CLOUD_CONTAINER result buffer to another, according to the specified condition.

Specifies the identifier of the 3D reconstruction result buffer containing the source point cloud to copy. The 3D reconstruction result buffer must have been previously allocated using M3dmapAllocResult with M_POINT_CLOUD_CONTAINER. Specifies the point cloud to copy from the source M_POINT_CLOUD_CONTAINER result buffer. Specifies the identifier of the 3D reconstruction result buffer in which to copy the source point cloud. The 3D reconstruction result buffer must have been previously allocated using M3dmapAllocResult with M_POINT_CLOUD_CONTAINER. You can specify the same identifier as the SrcResult3dmapId identifier, but the label to assign the copied point cloud must be different. Specifies a new label in the destination M_POINT_CLOUD_CONTAINER result buffer in which to copy the source point cloud. Specifies the attribute on which the condition is based. Specifies the identifier of the image buffer to use as an input condition. Specifies the condition under which pixel values are considered true for copying the corresponding point in a point cloud. Specifies the lower limit of the selected condition. Specifies the upper limit of the selected condition. Reserved for future expansion and must be set to M_DEFAULT .

Generate an image from a 3D reconstruction geometry object, context, or result buffer.

Specifies the identifier of the graphics context to use. This parameter must be set to one of the following values: Specifies the identifier of a 3D reconstruction geometry object, context, or result buffer. Specifies the identifier of the destination image buffer or graphics list in which to draw. Specifies what to draw in the destination image buffer or graphics list. Reserved for future expansion and must be set to M_DEFAULT . Reserved for future expansion and must be set to M_DEFAULT .

Exports one or more point clouds from an M_POINT_CLOUD_CONTAINER result buffer to a CAD file.

Specifies the name and path of the CAD file in which to save the data buffer. Specifies the file format of the CAD file. Specifies the identifier of the 3D reconstruction result buffer containing the point clouds to export. Specifies the label or index of a specific point cloud in the M_POINT_CLOUD_CONTAINER result buffer. Specifies which points of the point cloud(s) to export. Specifies to cast the position coordinates into the specified data type and depth. Specifies whether to export the intensity values and, if exporting, specifies the data type and depth to which to cast the intensity values. Reserved for future expansion and must be set to M_DEFAULT .

Generate a depth map image and, optionally, an intensity map image from data stored in a 3D reconstruction result buffer.

Specifies the identifier of the result buffer which contains the laser line data. Specifies the identifier of the image buffer in which to store the depth map. The image buffer must be a 1-band, 8-bit or 16-bit unsigned buffer. Specifies the identifier of the intensity image buffer. Specifies the type of operation to perform. Specifies the point cloud(s) in the specified 3D reconstruction result buffer from which to create a fully corrected depth map. Reserved for future expansion. This parameter must be set to M_DEFAULT .

Free a 3D reconstruction context, a 3D reconstruction result buffer, or a geometry object.

Specifies the identifier of the 3D reconstruction context, 3D reconstruction result buffer, or geometry object to free.

Retrieve the world coordinates and intensity of each of the points in one or more point clouds.

Specifies the identifier of the 3D reconstruction result buffer from which to retrieve the information about the points. The 3D reconstruction result buffer must have been previously allocated using M3dmapAllocResult with M_POINT_CLOUD_CONTAINER. Specifies the point cloud(s) in the specified 3D reconstruction result buffer. Specifies the feature to retrieve from the point cloud(s). Specifies which points to include in the array(s). Specifies to cast the point cloud data into one or more arrays of the specified data type and depth. Specifies the maximum number of elements that the arrays can hold. Specifies the address of the array in which to store the retrieved data. Specifies the address of the array in which to store the Y-coordinates. Specifies the address of the array in which to store the Z-coordinates. Specifies the address of the variable in which to write the number of array elements needed for this function, given the specified point cloud(s) and values for the PointsToInclude parameter. The returned value is the size that the arrays needed to store all the data. The PointsToInclude parameter can modify the total number of points returned, and so can modify the return value of this function.

Retrieve the world coordinates and intensity of each of the points in one or more point clouds.

Get the specified type of result(s) from a 3D reconstruction result buffer.

Specifies the identifier of the 3D reconstruction result buffer from which to retrieve results. Specifies the point cloud(s) in the specified 3D reconstruction result buffer, or the entire result buffer itself, from which to get results. Specifies the type of result to get. Specifies the address in which to write the results.

Get the specified type of result(s) from a 3D reconstruction result buffer.

Import a computer-aided design (CAD) file as a new point cloud.

Specifies the name and path of the file from which to import the point cloud. Specifies the file format of the file to import. Specifies the identifier of the 3D reconstruction result buffer, allocated using M3dmapAllocResult, into which to import the CAD file information. Specifies a label for the point cloud in the specified result buffer into which the CAD file information is imported. Specifies a calibrated MIL object whose relative coordinate system is used to interpret the given 3D points. Reserved for future expansion and must be set to M_DEFAULT .

Inquire about a 3D reconstruction context, a 3D reconstruction result buffer, or a geometry object setting.

Specifies the identifier of the 3D reconstruction context, result buffer, or geometry object about which to inquire information. Specifies the point cloud(s) in the specified 3D reconstruction result buffer, or the entire result buffer itself. Specifies the setting to inquire. Specifies the address in which to write the requested information. The returned value is the requested information, cast to a MIL_INT. If the requested information does not fit into a MIL_INT, this function will return M_NULL or truncate the information.

Inquire about a 3D reconstruction context, a 3D reconstruction result buffer, or a geometry object setting.

Specifies the identifier of the 3D reconstruction context, result buffer, or geometry object about which to inquire information. Specifies the point cloud(s) in the specified 3D reconstruction result buffer, or the entire result buffer itself. Specifies the setting to inquire. The returned value is the requested information, cast to a MIL_INT. If the requested information does not fit into a MIL_INT, this function will return M_NULL or truncate the information.

Inquire about a 3D reconstruction context, a 3D reconstruction result buffer, or a geometry object setting.

Calculates a distance between a source point cloud and a source geometry object.

Specifies the identifier of a 3D reconstruction result buffer containing the source point cloud. Specifies a point cloud in the source M_POINT_CLOUD_CONTAINER result buffer. Specifies the identifier of a geometry object or, if set to M_NULL , indicates the calculated metric applies to the source point cloud only. Reserved for future expansion and must be set to M_DEFAULT . Specifies the identifier of the destination image buffer in which to put the result of the calculate operation. Specifies the operation to perform. Reserved for future expansion and must be set to M_DEFAULT .

Store world points inside a new or existing unorganized point cloud.

Specifies the identifier of the 3D reconstruction result buffer in which to store the points. Specifies the label or index of the point cloud in which to add or replace point data. Specifies the type of data (position or intensity) to overwrite/add to the point cloud. Specifies a combination of two values: the data type and depth of the data in the arrays. Specifies the number of elements in each specified array. Specifies the address of an array containing the X-coordinates or the intensities of the points, or a packed array containing all the data of the points. Specifies the address of an array containing the Y-coordinates of the points. Specifies the address of an array containing the Z-coordinates of the points. Specifies a calibrated MIL object whose relative coordinate system is used to express the given 3D points. Specifies if points are added to the point cloud, or features are changed.

Store world points inside a new or existing unorganized point cloud.

Restore a 3D object from disk.

Specifies the name and directory of the file from which to restore the 3D object. Specifies the system on which to restore the 3D object. Reserved for future expansion and must be set to M_DEFAULT . Specifies the address of the variable in which to write the 3D object identifier. The returned value is the 3D object identifier. If allocation fails, M_NULL is returned.

Restore a 3D object from disk.

Save a 3D object to a file.

Specifies the name and directory of the file in which to save the 3D object. The recommended extension is M3D. Specifies the identifier of the 3D object to save. Reserved for future expansion and must be set to M_DEFAULT .

Save a 3D object to a file.

Set the extraction box used for depth map extraction.

Specifies the identifier of the 3D reconstruction result buffer for which to specify the extraction box. The 3D reconstruction result buffer must be a point cloud container, which means it must have been allocated on the required system using M3dmapAllocResult with M_POINT_CLOUD_CONTAINER. Specifies the type of box to set. Specifies how the extraction box is defined. Specifies the X-coordinate of the first point used to define the extraction box, or specifies a MIL identifier used to define the extraction box. Specifies the Y-coordinate of the first point used to define the extraction box. Specifies the Z-coordinate of the first point used to define the extraction box. Specifies the X-coordinate of the second point used to define the extraction box, or the length of the extraction box along the X-axis. Specifies the Y-coordinate of the second point used to define the extraction box, or the length of the extraction box along the Y-axis. Specifies the Z-coordinate of the second point used to define the extraction box, or the length of the extraction box along the Z-axis.

Define a geometry object, either parametrically or by fitting it to a depth map or point cloud.

Specifies the identifier of a geometry object. Specifies the type of geometry object to define. Specifies whether to define the geometry object by providing explicit values for the geometry's equation or by applying a best-fit geometry operation on the depth map or point cloud. Specifies information about the geometry object used for the operation. Specifies information about the geometry object used for the operation. Specifies information about the geometry object used for the operation. Specifies information about the geometry object used for the operation. Specifies information about the geometry object used for the operation.

Compute a variety of statistics on a depth map.

Specifies the image buffer identifier of the depth map on which to compute statistics. Specifies what will be used as reference level for statistics computation. Specifies the identifier of the image buffer to use as a mask, if needed. Specifies the result buffer identifier, if needed. Specifies what statistics to compute. Specifies the outlier distance to use to exclude pixels from the statistics. Reserved for future expansion and must be set to M_DEFAULT . Specifies where to write the results, if needed.

Compute a variety of statistics on a depth map.

Load, restore, or save a 3D object from/to a file or memory stream.

Specifies the file or memory stream. Specifies the system on which to restore the 3D object. Specifies the operation to perform on the 3D object. Specifies the type of stream in which to store/from which to restore the 3D object. Specifies the MIL version of the 3D object. Reserved for future expansion and must be set to M_DEFAULT . Specifies the address of the variable in which to write or from which to read the identifier of the 3D object. Specifies the address of the variable in which to write the size of the 3D object, in bytes.

Load, restore, or save a 3D object from/to a file or memory stream.

Triangulate the 3D world coordinates of points from their pixel location in the image plane of two or more cameras.

Specifies the address of an array containing the identifiers of the camera calibration contexts for each of the camera setups. Specifies the address of the array containing the X-pixel coordinates of the common points in the image plane of each camera. Specifies the address of the array containing the Y-pixel coordinates of the common points in the image plane of each camera. This array must have a size equal to ( NumCalibrations x NumPoints). Specifies the address of an array in which to write the calculated X-world coordinates. Specifies the address of the array in which to write the calculated Y-world coordinates. Specifies the address of the array in which to write the calculated Z-world coordinates. Specifies the address of the array in which to write the root mean square (RMS) error for the calculated world coordinates of each point. Specifies the number of camera calibration contexts. This should correspond to the number of cameras. This parameter must be greater or equal to 2. Specifies the number of points to compute using triangulation. This parameter must be greater or equal to 1. Specifies the world coordinate system that is common to all the specified camera calibration contexts. Reserved for future expansion and must be set to M_DEFAULT .

Triangulate the 3D world coordinates of points from their pixel location in the image plane of two or more cameras.

Allocate a MIL application context.

Specifies the computer name or IP address of the cluster manager. Specifies the type of initialization to perform on the MIL application context. Specifies the address of the variable in which to write the application context identifier. The returned value is the application context identifier. If allocation fails, M_NULL is returned.

Allocate a MIL application context.

Closes a connection to a remote MIL application.

Specifies the remote application to disconnect from.

Control an application environment setting.

Specifies the identifier of the application context to use. Specifies the type of application environment setting to control. Specifies the setting's new value.

Control a MIL multi-core processing application environment setting.

Reserved for future expansion. This parameter must be set to M_DEFAULT . Specifies the type of multi-core processing application environment setting to control. Reserved for future expansion. This parameter must be set to M_DEFAULT . Specifies the setting's new value. Specifies the address which contains more information about the setting's new value.

Control a MIL multi-core processing application environment setting.

Perform a file operation on a local or a remote computer.

Specifies the identifier of the application context to use. Specifies the file on the target or source computer to use for the operation. Specifies the destination application in which to copy the file specified using Comp1FileName during the M_FILE_COPY or M_FILE_COPY_MIL_DLL operation. Specifies the directory (and optionally a new file name) in computer 2 in which to copy the file specified using Comp1FileName. Specifies the operation to perform on the specified file. Reserved for future expansion. Specifies the address of the user data that used by some operations.

Perform a file operation on a local or a remote computer.

Free a MIL application.

Specifies the application to free.

Get error codes and related information.

Specifies the identifier of the application context to use. Specifies the type of error information to read. Specifies the address in which to write the requested information. The returned value is the requested error/function code. If the error code is read and it is equal to M_NULL_ERROR , no error has occurred.

Get error codes and related information.

Get information about a hooked event.

Specifies the identifier of the application context to use. Specifies the application event identifier received by the hook-handler function. Specifies the type of information to get. Specifies the address in which to write the requested information. The returned value is M_NULL if successful. If the operation fails, a non-null (!M_NULL) value is returned.

Get information about a hooked event.

Hook a function to an event.

Specifies the identifier of the application context to use. Specifies the event type. Specifies the address of the function that should be called when an event occurs. Specifies the address of the user data that you want to make available to the hook-handler function.

Hook a function to an event.

Inquire about an application setting.

Specifies the identifier of the application context to use. Specifies the type of application setting about which to inquire. Specifies the address in which to write the requested information. The returned value is the requested information, cast to a MIL_INT. If the requested information does not fit into a MIL_INT, this function will return M_NULL or truncate the information.

Inquire about an application setting.

Specifies the identifier of the application context to use. Specifies the type of application setting about which to inquire. The returned value is the requested information, cast to a MIL_INT. If the requested information does not fit into a MIL_INT, this function will return M_NULL or truncate the information.

Inquire about an application setting.

Inquire about published MIL objects on a Distributed MIL publishing application.

Specifies the identifier of the application context to use. Specifies the type of Distributed MIL connection setting about which to inquire. Specifies an attribute of the inquire operation to perform. Specifies an attribute of the inquire operation to perform. Specifies the address in which to write the requested information. The returned value is the requested information, cast to a MIL_INT. If the requested information does not fit into a MIL_INT, this function will return M_NULL or truncate the information.

Inquire about published MIL objects on a Distributed MIL publishing application.

Inquire about a MIL multi-core processing application environment setting.

Specifies the identifier of the application context to use. Specifies the type of multi-core processing application environment setting about which to inquire. Reserved for future expansion and must be set to M_DEFAULT . Specifies additional information regarding the inquired setting. This parameter must be set to M_DEFAULT if not used. Specifies the address in which to write the requested information. The returned value is the requested information, cast to a MIL_INT. If the requested information does not fit into a MIL_INT, this function will return M_NULL or truncate the information. The return value is undefined for M_CORE_AFFINITY_MASK, M_CORE_AFFINITY_MASK_PROCESS, M_MEMORY_BANK_AFFINITY_MASK, and M_MEMORY_BANK_CORE_AFFINITY_MASK.

Inquire about a MIL multi-core processing application environment setting.

Connect to a Distributed MIL publishing application.

Specifies the computer to which to connect, and if necessary the listening port of the publishing application. Reserved for future expansion. Reserved for future expansion. Specifies the address in which to write the remote application identifier returned by this function.

Control or inquire a MIL timer's setting or value.

Specifies the identifier of the application context to use. Specifies the control to exert on the MIL timer. Specifies the address of the variable in which to store the timer information produced by M_TIMER_READ or M_TIMER_RESOLUTION. The returned value, for M_TIMER_READ and M_TIMER_RESOLUTION, is the requested information cast to a MIL_DOUBLE. For M_TIMER_RESET and M_TIMER_WAIT, this function returns 0.0.

Control or inquire a MIL timer's setting or value.

Specifies the identifier of the application context to use. Specifies the control to exert on the MIL timer. The returned value, for M_TIMER_READ and M_TIMER_RESOLUTION, is the requested information cast to a MIL_DOUBLE. For M_TIMER_RESET and M_TIMER_WAIT, this function returns 0.0.

Control or inquire a MIL timer's setting or value.

Create a user MIL trace marker or section in a trace log.

Specifies the identifier of the application context to use. Specifies the type of trace marker to create. Specifies a value that identifies this trace marker or section. Specifies a value relevant to the trace marker or section, or relevant to the surrounding code. Specifies a string relevant to the trace marker or section, or relevant to the surrounding code.

Create a user MIL trace marker or section in a trace log.

Allocate a bead context.

Specifies the identifier of the system on which to allocate the bead context. Specifies the strategy with which to extract and analyze beads. Reserved for future expansion and must be set to M_DEFAULT . Specifies the address of the variable in which to write the bead context identifier. The returned value is the bead context's identifier if the allocation is successful. If allocation fails, M_NULL is returned.

Allocate a bead context.

Allocate a bead result buffer.

Specifies the identifier of the system on which to allocate the result buffer. Reserved for future expansion and must be set to M_DEFAULT . Specifies the address of the variable in which to write the bead result buffer identifier. The returned value is the bead result buffer's identifier if the allocation is successful. If allocation fails, M_NULL is returned.

Allocate a bead result buffer.

Control a bead context or template setting.

Specifies the identifier of the bead context to control. Specifies the bead template (one or all) to control, or specifies that you are controlling a global setting of the bead context. Specifies the type of control to set. Specifies the required value for the control.

Control a bead context or template setting.

Draw specific features of a bead context or of a bead result.

Specifies the identifier of the graphics context to use. This parameter must be set to one of the following values: Specifies the identifier of the bead context or bead result buffer that this function will use to perform the drawing operation. The context or result buffer must have been previously allocated on the system using MbeadAlloc or MbeadAllocResult, respectively. Specifies the identifier of the destination image buffer or graphics list in which to draw. Specifies the drawing operation to perform. Specifies the type of points that this function will use to perform the drawing operation. Specifies the templates (one or all) that this function will use to perform the drawing operation, or specifies that you are performing a general type of drawing operation. Specifies the set of template points (one or all) for which to perform the drawing operation, or specifies that you are performing a general type of drawing operation. Specifies whether MIL performs drawings with fail-type points differently than drawings with other types of points.

Free a bead context or a bead result buffer.

Specifies the identifier of the bead context or bead result buffer to free. These must have been successfully allocated (with MbeadAlloc or MbeadAllocResult) prior to calling this function.

Get the template and/or vertex closest to a source point.

Specifies the identifier of the bead context. Specifies the bead template in which the closest vertex is expected to be located. Specifies the source point's X-position. Specifies the source point's Y-position. Specifies the address of the variable in which to write the label of the closest template. Specifies the address of the variable in which to write the index of the closest vertex. Specifies whether to retrieve the closest template and/or the closest vertex.

Get the template and/or vertex closest to a source point.

Get results from a bead result buffer.

Specifies the identifier of the bead result buffer from which to get results. Specifies the label or index of the template for which to get results, or specifies that you are getting general results related to all templates. Specifies the trained points (one or all) for which to get results or specifies that you are getting general results. Specifies the result to get. Specifies the address in which to write the requested information.

Get results from a bead result buffer.

Inquire information about a bead context, template, or result.

Specifies the identifier of the bead context or the identifier of the bead result buffer about which to inquire. Specifies the bead template about which to inquire, or specifies that you are inquiring about a global setting of the bead context or result. Specifies the type of setting about which to inquire. Specifies the address in which to write the requested information. The returned value is the requested information, cast to a MIL_INT. If the requested information does not fit into a MIL_INT, this function will return M_NULL or truncate the information.

Inquire information about a bead context, template, or result.

Specifies the identifier of the bead context or the identifier of the bead result buffer about which to inquire. Specifies the bead template about which to inquire, or specifies that you are inquiring about a global setting of the bead context or result. Specifies the type of setting about which to inquire. The returned value is the requested information, cast to a MIL_INT. If the requested information does not fit into a MIL_INT, this function will return M_NULL or truncate the information.

Inquire information about a bead context, template, or result.

Restore a bead context from disk.

Specifies the name and path of the file from which to restore the bead context. Specifies the identifier of the system on which to restore the bead context. Specifies whether to restore the camera calibration context that was saved with the bead context. Specifies the address of the variable in which to write the bead context identifier. The returned value is the bead context identifier. If allocation fails, M_NULL is returned.

Save a bead context to a file.

Specifies the name and path of the file in which to save the bead context. Specifies the identifier of the bead context to save. Specifies whether to save the camera calibration context associated with the training image.

Load, restore, or save a MIL bead context from/to a file or memory stream.

Specifies the file or memory stream. Specifies the system on which to restore the bead context. Specifies the operation to perform. Specifies the type of stream in which to store/from which to restore the bead context. Specifies the MIL version of the bead context. Specifies whether to restore the camera calibration context from the bead context, or save the camera calibration context with the bead context. Specifies the address of the variable in which to write or from which to read the identifier of the bead context. Specifies the address of the variable in which to write the size of the bead context, in bytes.

Load, restore, or save a MIL bead context from/to a file or memory stream.

Add, delete, or modify a bead template.

Specifies the identifier of a bead context. Specifies to add a new bead template to a bead context, or specifies another operation to perform with a template that is already in a context. Specifies the type of the new bead template to add to a bead context, or specifies that the type information is not required. Specifies a unique label for a new bead template to add to a bead context, or specifies the index or label of a template in a context (or all templates in a context) with which to perform the operation. Specifies information required for the operation. Specifies an attribute of the operation. Specifies an attribute of the operation. Specifies an attribute of the operation. Reserved for future expansion and must be set to M_DEFAULT .

Add, delete, or modify a bead template.

Train the templates in a bead context.

Specifies the identifier of the bead context that contains the templates to train. Specifies the identifier of the image buffer containing the training image with which to train the templates, or specifies to train the templates without a training image (or with a previously saved training image). Specifies whether to save the training image ( TrainingImageBufId).

Verify beads in the target image according to their corresponding template.

Specifies the identifier of the bead context that contains the templates with which to validate the beads in the target image. Specifies the identifier of the target image buffer that contains the beads that must be verified, according the templates contained within the bead context. The image buffer must be a 1-band 8-bit unsigned buffer. Specifies the identifier of the bead result buffer in which to write the results of the verification. Reserved for future expansion and must be set to M_DEFAULT .

Allocate a Blob Analysis context.

Specifies the system on which to allocate the context. Reserved for future expansion. This parameter must be set to M_DEFAULT . Reserved for future expansion. This parameter must be set to M_DEFAULT . Specifies the address of the variable in which to write the identifier of the Blob Analysis context. The returned value is the Blob Analysis context's identifier if the allocation is successful. If allocation fails, M_NULL is returned.

Allocate a Blob Analysis result buffer.

Specifies the system on which to allocate the result buffer. Reserved for future expansion. This parameter must be set to M_DEFAULT . Reserved for future expansion. This parameter must be set to M_DEFAULT . Specifies the address of the variable in which to write the identifier of the Blob Analysis result buffer. The returned value is the result buffer's identifier if the allocation is successful. If allocation fails, M_NULL is returned.

Allocate a Blob Analysis result buffer.

Perform blob analysis calculations.

Specifies the identifier of the Blob Analysis context, that specifies the feature(s) to calculate, and other settings related to the blob analysis operation. Specifies the identifier of the image buffer to use as the blob identifier image. This image is used to distinguish blob pixels from background pixels and which pixels belong to which blob. Specifies the identifier of the image buffer to use as the grayscale image. This image is used to supply the intensity of blob pixels when calculating features with a grayscale definition. Specifies the identifier of a Blob Analysis result buffer, in which to store calculated results.

Control a blob analysis setting.

Specifies the identifier of the Blob Analysis context or result buffer. Specifies the setting to change. Specifies the setting's new value.

Control a blob analysis setting.

Specifies the identifier of the Blob Analysis context or result buffer. Specifies the setting to change. Specifies the setting's new value.

Draw specific blob features in the destination image buffer or graphics list.

Specifies the identifier of the graphics context to use when drawing. This parameter must be set to one of the following values: Specifies the identifier of the Blob Analysis result buffer from which to retrieve the features to draw. Specifies the identifier of the destination image buffer or graphics list in which to draw. Specifies the type of operation to perform. Specifies the label or index of the blob or blobs whose information to draw. Reserved for future expansion and must be set to M_DEFAULT .

Free the Blob Analysis context or result buffer.

Specifies the identifier of the Blob Analysis context or result buffer to free. The buffer must have been successfully allocated, using MblobAllocResult or MblobAlloc, prior to calling this function.

Get the label value of a blob at a specified position.

Specifies the identifier of the Blob Analysis result buffer where the labels are stored. Note, this function cannot obtain the label values of blobs that have been deleted from the result buffer with MblobSelect. Specifies the X-coordinate of the blob. Specifies the Y-coordinate of the blob. Specifies the address of the variable in which to write the label value. If there is no blob at the specified location, the blob has been deleted, or if the blob's XPos and YPos lie outside the original identifier image, M_NULL is returned instead of the label value. Also, since MblobGetLabel returns the label value, you can set this parameter to M_NULL . The returned value is the label value of the specified blob.

Get the label value of a blob at a specified position.

Get results for a feature of the included blobs, from a blob result buffer.

Specifies the identifier of the Blob Analysis result buffer from which to get results. Specifies the label or index of the blob for which to get results, or specifies that you are getting general results related to all blobs. This parameter must be set to one of the following values: Specifies the type of result to retrieve. Specifies the address of the array in which to write results.

Get results for a feature of the included blobs, from a blob result buffer.

Specifies the identifier of the Blob Analysis result buffer from which to get results. Specifies the type of result to retrieve. Specifies the address of the array in which to write results.