reference
API Reference › DIC Preprocess
dic_preprocess.analysisRun.cropImage
Crop an image using base-MATLAB indexing.
Syntax
cropped = dic_preprocess.analysisRun.cropImage(imageData, rect)Inputs
imageData- Numeric two-dimensional or multichannel image.
rect- Four finite values [x y width height] in image-pixel coordinates. Values are rounded to pixel indices and limited to image bounds.
Outputs
cropped- Inclusive pixel crop preserving input class and channels.
Description
Width and height follow MATLAB imcrop's inclusive-endpoint convention: [x y 10 10] selects 11-by-11 pixels when fully inside the image. A partially overlapping rectangle is clipped; a rectangle with no overlap errors.
Errors
labkit_DICPreprocess_app:InvalidCropRectangle- rect does not contain four finite numeric values.
labkit_DICPreprocess_app:EmptyCropRectangle- The rounded rectangle does not overlap imageData.
Example
imageData = reshape(1:100, 10, 10);
cropped = dic_preprocess.analysisRun.cropImage(imageData, [2 3 4 2]);
assert(isequal(size(cropped), [3 5]))Related APIs
dic_preprocess.analysisRun.applyRigidTransform— Resample a moving image onto a reference-sized canvas.dic_preprocess.analysisRun.alignMovingToReference— Fit and apply a rigid transform from matched points.dic_preprocess.analysisRun.autoAlignMovingToReference— Estimate and apply an integer translation.dic_preprocess.analysisRun.makeFalseColorOverlay— Build a red/green registration preview.
Source
This page is generated from the MATLAB help text in apps/dic/dic_preprocess/+dic_preprocess/+analysisRun/cropImage.m.