detectPatternPoints

Обнаружьте калибровочный шаблон keypoints в изображениях

Описание

пример

[imagePoints,imagesUsed] = detectPatternPoints(detectorObj,imageFileNames) обнаруживает калибровочный шаблон keypoints в файлах изображений, заданных imageFileNames. Функция также указывает, в каком из изображений она обнаруживает калибровочный шаблон.

[imagePoints,pairsUsed] = detectPatternPoints(detectorObj,imageFileNames1,imageFileNames2) обнаруживает калибровочный шаблон keypoints в стереопарах файлов изображений, заданных в imageFileNames1 и imageFileNames2. Функция также указывает, в каком из пар изображений она обнаруживает калибровочный шаблон.

[___] = detectPatternPoints(___,varargin) синтаксические анализы любые параметры или опции необходимы для обнаружения. Например, можно обеспечить параметры или опции, полученные из панели свойств приложения калибратора при использовании его из командной строки.

Примеры

свернуть все

Используйте этот шаблон функции, который включает использование detectPatternPoints возразите функции, чтобы обнаружить keypoints калибровочного шаблона. Функция включает и программируемые рабочие процессы и рабочие процессы приложения для обнаружения точек.

function [imagePoints,imagesUsed] = detectPatternPoints(this,imageFileNames,varargin) 
    parser = inputParser;
    parser.addParameter('HighDistortion',false,@checkHighDistortion);
    parser.parse(varargin{:});
    highDistortion = parser.Results.HighDistortion;
    
    % Use 'IsDistortionHigh' member value when the default value is
    % being used for HighDistortion
    if ismember('HighDistortion',parser.UsingDefaults)
       highDistortion = this.IsDistortionHigh;  
    end
    
    [imagePoints,boardSize,imagesUsed] = detectCheckerboardPoints( ...
        imageFileNames,HighDistortion=highDistortion);
    
    this.BoardSize = boardSize;
    
    %--------------------------------------------------------------
    function tf = checkHighDistortion(highDistortion)
        validateattributes(highDistortion,{'logical','numeric'}, ...
            {'scalar','binary'},mfilename,'HighDistortion');
        tf = true;
    end
end

Входные параметры

свернуть все

Объект Detector в виде одного или vision.calibration.PatternDetector стерео объект.

Имена файла образа в виде массива ячеек из символьных векторов или вектора из строк.

Имена файлов стереоизображения для камеры один в виде массива ячеек из символьных векторов или массива строк.

Имена файлов стереоизображения для камеры два в виде массива ячеек из символьных векторов или массива строк.

Переменное количество входных параметров в виде 1 N массивом ячеек, где N является количеством входных параметров к функции, получает после явным образом заявленных входных параметров. Для получения дополнительной информации об использовании этого входа, смотрите varargin.

Выходные аргументы

свернуть все

Отобразите x-y координаты обнаруженного шаблона keypoints, возвращенный как M-by-2-by-numImages массив для одной калибровки фотоаппарата или M-by-2-by-numPairs-by-2 массив для калибровки стереофотоаппарата. numImages является количеством изображений, в которых обнаруживается круговая сетка. numPairs является количеством пар изображений, в которых обнаруживается круговая сетка. Для стереоизображений, imagePoints(:,:,:,1) возвращает шаблон keypoints в первый набор изображений и imagePoints(:,:,:,2) возвращает шаблон keypoints во второй набор изображений. Если функция не может обнаружить полный шаблон, то это возвращает частично обнаруженный шаблон с [NaN,NaN] для тех x-y координаты, которые не могли быть обнаружены.

Флаг обнаружения шаблона, возвращенный как логический вектор. Значение true для элемента imagesUsed вектор указывает, что функция обнаружила шаблон в соответствующем изображении.

Флаг обнаружения шаблона стереопары, возвращенный как логический вектор. Значение true для элемента pairsUsed вектор указывает, что функция обнаружила шаблон в соответствующей паре изображений.

Введенный в R2021b