 
M_DEFAULT_EXTENDED_DEPTH_OF_FIELD_CONTEXT |
|
MIL correlation-stitching
registration
context identifier |
Specifies a valid correlation-stitching registration context
identifier, previously allocated using MregAlloc() with M_STITCHING.
When this context is passed, a correlation-stitching
registration operation is performed. The function calculates the
optimal match in the overlapping region between each image and its
reference image and then calculates the transformation needed to
achieve this match. Once the transformation that maps each image
into its reference image's pixel coordinate system is calculated,
it is converted so that it maps the image into the global pixel
coordinate system.
The correlation-stitching registration context requires that for
every input image, there is a registration element in the context
that provides the rough location of the image in another input
image (reference image) or in the global pixel coordinate
system.
(summarize)
Specifies a valid correlation-stitching registration
context identifier, previously allocated using MregAlloc() with M_STITCHING.
(more details...)
|
|
|
M_DEFAULT |
Specifies the default correlation-stitching registration
operation mode.
(summarize)
Specifies the default correlation-stitching
registration operation mode.
(more details...)
|
|
|
|
ImageArrayPtr |
Specifies an array containing the buffer identifiers of the
input images to use when performing the registration operation.
Every image in the specified image array is associated with the
registration element and registration result element of the same
index. For example, the first image is associated with the first
registration element and the first registration result element.
Therefore, it is important that the number of images supplied in
the array be less than or equal to the number of registration
elements.
You might not want to perform the optimization step of the
correlation-stitching registration calculation when the precise
location of one or more images is known. In this case, you have two
options. You can replace the image for which you want to skip the
optimization step with M_NULL in the image array or you can
disable M_OPTIMIZE_LOCATION in the image's registration
element using MregControl(). For more information, see the
Skipping the optimization step
subsection of the Customizing your registration
settings section of Chapter 10: Registration.
(summarize)
Specifies an array containing the buffer identifiers
of the input images to use when performing the registration
operation.
(more
details...)
|
|
|
|
RegResultOrImageId |
Specifies a valid correlation-stitching result buffer
identifier, previously allocated using MregAllocResult() with M_STITCHING_RESULT.
The results of the registration calculation can be retrieved
using MregGetResult(). These results can be used
to perform other operations supported by the registration module.
For example, the results can be used to create a mosaic of the
input images using MregTransformImage(); you can also use
them with MregTransformCoordinate() or
MregTransformCoordinateList()
to transform positions between two of the following coordinate
systems: the global pixel coordinate system, any registered image's
pixel coordinate system, or the mosaic's coordinate system.
(summarize)
|
|
|
|
NumImages |
Specifies the size of the image array. If the array contains
fewer image buffer identifiers than the specified size, the
outstanding elements of the array should be set to
M_NULL.
(summarize)
Specifies the size of the image array.
(more
details...)
|
MIL depth-from-focus
registration context
identifier |
Specifies a valid depth-from-focus registration context
identifier, previously allocated using MregAlloc() with M_DEPTH_FROM_FOCUS. When this context is passed, a
depth-from-focus registration operation is performed. This
operation generates an image that conveys depth information, from a
set of two-dimensional images of the same scene taken at different
focus distances. The operation calculates, for each pixel, in which
image that pixel is found most in focus. It replaces the
corresponding pixel entry with the index of the image. This output
image is referred to as the index map.
The depth-from-focus operation requires that every input image
is of the same scene, at different focus levels.
(summarize)
Specifies a valid depth-from-focus registration
context identifier, previously allocated using MregAlloc() with M_DEPTH_FROM_FOCUS.
(more details...)
|
|
|
M_DEFAULT |
|
|
|
M_ACCUMULATE_AND_COMPUTE |
Specifies to process additional input images, and then calculate
the index map using this new information and all of the information
previously processed and stored in the result buffer. Each call to
MregCalculate() with this constant will accumulate new
results and a new index map in the depth-from-focus result buffer.
This operation will not empty the result buffer of previous
entries. If an index map is already in the result buffer prior to
MregCalculate(), it will be discarded and replaced with the
new index map.
Note that when using this value with a non-empty result buffer,
the settings of the specified context must match the settings of
the context used to add the previous image information to the
result buffer, otherwise an error occurs.
You can retrieve preprocessing results from a depth-from-focus
result buffer using MregGetResult(), and access the
depth-from-focus index map by drawing it using MregDraw() with M_DRAW_DEPTH_INDEX_MAP.
(summarize)
Specifies to process additional input images, and
then calculate the index map using this new information and all of
the information previously processed and stored in the result
buffer.
(more details...)
|
|
|
|
ImageArrayPtr |
Specifies an array containing the buffer identifiers of the
input images to use when performing the registration operation.
These images must not have a region of interest (ROI) associated
with them. Using images with an ROI will cause an error.
The image buffers must be 1-band, and must all have the same
size and type.
(summarize)
Specifies an array containing the buffer identifiers
of the input images to use when performing the registration
operation.
(more
details...)
|
|
|
|
RegResultOrImageId |
Specifies the identifier of the result buffer in which to save
results; if the result buffer contains results from a previous
depth-from-focus operation, they will be considered for the current
operation.
(summarize)
Specifies the identifier of the result buffer in
which to save results; if the result buffer contains results from a
previous depth-from-focus operation, they will be considered for
the current operation.
(more
details...)
|
|
|
|
NumImages |
Specifies the size of the image array. If the array contains
fewer image buffer identifiers than the specified size, the
outstanding elements of the array should be set to
M_NULL.
(summarize)
Specifies the size of the image array.
(more
details...)
|
|
|
M_COMPUTE |
Specifies to calculate the index map from the specified input
images.
If passing a result buffer to RegResultOrImageId,
MregCalculate() will clear the result buffer of previous
results, and then fill the buffer with the index map and new
results.
You can retrieve preprocessing results from a depth-from-focus
result buffer using MregGetResult(), and access the
depth-from-focus index map by drawing it using MregDraw() with M_DRAW_DEPTH_INDEX_MAP.
If passing an image buffer to RegResultOrImageId, the function clears
the image buffer, and writes the resulting index map in the image
buffer; no other results are accessible.
(summarize)
Specifies to calculate the index map from the
specified input images.
(more details...)
|
|
|
|
ImageArrayPtr |
Specifies an array containing the buffer identifiers of the
input images to use when performing the registration operation.
These images must not have a region of interest (ROI) associated
with them. Using images with an ROI will cause an error.
The image buffers must be 1-band, and must all have the same
size and type.
(summarize)
Specifies an array containing the buffer identifiers
of the input images to use when performing the registration
operation.
(more
details...)
|
|
|
|
RegResultOrImageId |
Specifies the identifier of the result buffer or image buffer in
which to save results.
(summarize)
Specifies the identifier of the result buffer or
image buffer in which to save results.
(more
details...)
|
|
|
|
|
MIL depth-from-focus registration
result
buffer identifier |
Specifies a valid depth-from-focus registration result buffer
identifier, previously allocated using MregAllocResult() with M_DEPTH_FROM_FOCUS_RESULT.
|
|
|
|
|
MIL image buffer
identifier |
Specifies the identifier of a valid image buffer, previously
allocated on the required system using MbufAlloc...().
The image buffer must have a type large enough to contain the
maximum number of indices (NumImages).
(summarize)
Specifies the identifier of a valid image buffer,
previously allocated on the required system using MbufAlloc...().
(more
details...)
|
|
|
|
NumImages |
Specifies the size of the image array. If the array contains
fewer image buffer identifiers than the specified size, the
outstanding elements of the array should be set to
M_NULL.
(summarize)
Specifies the size of the image array.
(more
details...)
|
|
|
M_RESET |
Specifies to clear the specified result buffer.
(summarize)
Specifies to clear the specified result buffer.
(more details...)
|
|
|
|
RegResultOrImageId |
|
MIL extended depth of
field registration
context identifier |
Specifies a valid extended depth of field registration context
identifier, previously allocated using MregAlloc() with M_EXTENDED_DEPTH_OF_FIELD.
When using an M_EXTENDED_DEPTH_OF_FIELD registration
context, this function performs an extended depth of field
registration operation. It will preprocess the specified input
images and then fuse the images to create an extended depth of
field (EDoF) image. The results can be stored in a previously
allocated result buffer or an image buffer.
In the M_ACCUMULATE and M_ACCUMULATE_AND_COMPUTE modes, images must
be preprocessed using the same registration context and settings
(for example, same maximum radius of the circle of confusion).
You can retrieve results from an extended depth of field result
buffer using MregGetResult(), and access the EDoF image
by drawing it using MregDraw().
(summarize)
|
|
|
M_DEFAULT |
|
|
|
M_ACCUMULATE |
Specifies to preprocess images and add the information to the
result buffer. This will not empty the result buffer prior to
writing to it, nor calculate the extended depth of field (EDoF)
image. To create the EDoF image after accumulating, you must call
MregCalculate() with M_ACCUMULATE_AND_COMPUTE.
Note that when using this value with a non-empty result buffer,
the settings of the specified context must match the settings of
the context used to add the previous image information to the
result buffer.
(summarize)
Specifies to preprocess images and add the
information to the result buffer.
(more details...)
|
|
|
|
ImageArrayPtr |
Specifies an array containing the buffer identifiers of the
input images to use when performing the registration operation.
The input images must have the same size, type, and number of
bands.
You can replace images in the array that you do not want to use
in the calculations with M_NULL. This allows you to
establish the minimum number of focus distances at which to grab
the input images and still obtain a good EDoF image. The fewer the
number of input images, the faster the operation. For example, you
can perform the operation with 10 different focus distances, and
then try performing the same operation with every second image set
to M_NULL to see if the EDoF image is still acceptable.
(summarize)
Specifies an array containing the buffer identifiers
of the input images to use when performing the registration
operation.
(more
details...)
|
|
|
|
RegResultOrImageId |
Specifies the extended depth of field result buffer to fill with
the information extracted when preprocessing the input images.
(summarize)
Specifies the extended depth of field result buffer
to fill with the information extracted when preprocessing the input
images.
(more
details...)
|
|
|
|
NumImages |
Specifies the size of the image array. If the array contains
fewer image buffer identifiers than the specified size, the
outstanding elements of the array should be set to
M_NULL.
(summarize)
Specifies the size of the image array.
(more
details...)
|
|
|
M_ACCUMULATE_AND_COMPUTE |
Specifies to preprocess additional input images, and then
compute the EDoF image using this new information and all of the
information previously processed and stored in the result buffer.
The EDoF image will only be calculated after the last image has
been processed. This will not empty the result buffer of previous
entries. If an EDoF image is already in the result buffer prior to
MregCalculate(), it will be discarded and replaced with the
new EDoF image.
Note that you don't have to pass additional input images. If no
input images are specified, the operation calculates the EDoF image
using only the preprocessed information in the result buffer.
Note that when using this value with a non-empty result buffer,
the settings of the specified context must match the settings of
the context used to add the previous image information to the
result buffer.
(summarize)
Specifies to preprocess additional input images, and
then compute the EDoF image using this new information and all of
the information previously processed and stored in the result
buffer.
(more details...)
|
|
|
|
ImageArrayPtr |
Specifies the input images to use when performing the
registration operation.
(summarize)
Specifies the input images to use when performing
the registration operation.
(more
details...)
|
|
|
|
|
M_NULL |
Specifies to calculate the EDoF image using only the
preprocessed information available in the result buffer.
|
|
|
|
|
Array of image buffer
IDs |
Specifies the address of an array of MIL image buffer
identifiers to use, beside also using the preprocessed information
available in the result buffer. The input images must have the same
size, type, and number of bands.
You can replace images in the array that you do not want to use
in the calculations with M_NULL. This allows you to
establish the minimum number of focus distances at which to grab
the input images and still obtain a good EDoF image. The fewer the
number of input images, the faster the operation. For example, you
can perform the operation with 10 different focus distances, and
then try performing the same operation with every second image set
to M_NULL to see if the EDoF image is still acceptable.
(summarize)
Specifies the address of an array of MIL image
buffer identifiers to use, beside also using the preprocessed
information available in the result buffer.
(more
details...)
|
|
|
|
RegResultOrImageId |
Specifies the result buffer to fill.
You can retrieve preprocessing results from an extended depth of
field result buffer using MregGetResult(), and access the EDoF image
by drawing it using MregDraw().
(summarize)
Specifies the result buffer to fill.
(more
details...)
|
|
|
|
NumImages |
Specifies the size of the image array. If the array contains
fewer image buffer identifiers than the specified size, the
outstanding elements of the array should be set to
M_NULL.
If you passed M_NULL to ImageArrayPtr, set this parameter to 0.
(summarize)
Specifies the size of the image array.
(more
details...)
|
|
|
M_COMPUTE |
Specifies to calculate the EDoF image immediately.
If passing a result buffer to RegResultOrImageId,
MregCalculate() will clear the result buffer of previous
results, and then fill the result with the preprocessing
information and the EDoF image.
If passing an image buffer to RegResultOrImageId, the function clears
the image buffer of any previous image, and writes the resulting
EDoF image in the image buffer; no other results are
accessible.
(summarize)
Specifies to calculate the EDoF image
immediately.
(more details...)
|
|
|
|
ImageArrayPtr |
Specifies an array containing the buffer identifiers of the
input images to use when performing the registration operation.
The input images must have the same size, type, and number of
bands.
You can replace images in the array that you do not want to use
in the calculations with M_NULL. This allows you to
establish the minimum number of focus distances at which to grab
the input images and still obtain a good EDoF image. The fewer the
number of input images, the faster the operation. For example, you
can perform the operation with 10 different focus distances, and
then try performing the same operation with every second image set
to M_NULL to see if the EDoF image is still acceptable.
(summarize)
Specifies an array containing the buffer identifiers
of the input images to use when performing the registration
operation.
(more
details...)
|
|
|
|
RegResultOrImageId |
Specifies the result buffer or image buffer to fill.
(summarize)
Specifies the result buffer or image buffer to
fill.
(more
details...)
|
|
|
|
|
MIL extended depth of field
registration
result buffer identifier |
|
|
|
|
|
MIL image buffer
identifier |
Specifies a valid image buffer, previously allocated on the
required system using MbufAlloc...().
|
|
|
|
NumImages |
Specifies the size of the image array. If the array contains
fewer image buffer identifiers than the specified size, the
outstanding elements of the array should be set to
M_NULL.
(summarize)
Specifies the size of the image array.
(more
details...)
|
|
|
M_RESET |
Specifies to clear the result buffer of all preprocessing
information and the EDoF image, if applicable.
(summarize)
Specifies to clear the result buffer of all
preprocessing information and the EDoF image, if applicable.
(more details...)
|
|
|
|
RegResultOrImageId |
|
Availability
For specifying the
operation mode