detectCheckerboardPoints

Обнаружьте шаблон шахматной доски в изображении

Синтаксис

[imagePoints,boardSize]
= detectCheckerboardPoints(I)

[imagePoints,boardSize,imagesUsed]
= detectCheckerboardPoints(imageFileNames)

[imagePoints,boardSize,imagesUsed]
= detectCheckerboardPoints(images)

[imagePoints,boardSize,pairsUsed]
= detectCheckerboardPoints(imageFileNames1,imageFileNames2)

[imagePoints,boardSize,pairsUsed]
= detectCheckerboardPoints(images1,images2)

[imagePoints,boardSize,pairsUsed]
= detectCheckerboardPoints(___,'MinCornerMetric',0.15)

Описание

пример

[imagePoints,boardSize] = detectCheckerboardPoints(I) обнаруживает черно-белую шахматную доску размера, больше, чем квадраты 4 на 4 в 2D истинном цвете или полутоновом изображении. Функция возвращает обнаруженные точки и размерности шахматной доски.

[imagePoints,boardSize,imagesUsed] = detectCheckerboardPoints(imageFileNames) обнаруживает шаблон шахматной доски в наборе входных изображений, обеспеченных как массив имен файлов.

[imagePoints,boardSize,imagesUsed] = detectCheckerboardPoints(images) обнаруживает шаблон шахматной доски в наборе входных изображений, обеспеченных как массив изображений полутонового или истинного цвета.

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

[imagePoints,boardSize,pairsUsed] = detectCheckerboardPoints(images1,images2) обнаруживает шаблон шахматной доски в стереопарах изображений, обеспеченных как массивы изображений полутонового или истинного цвета.

[imagePoints,boardSize,pairsUsed] = detectCheckerboardPoints(___,'MinCornerMetric',0.15) устанавливает угловой метрический порог, заданный как неотрицательный скаляр. Когда изображение будет шумным или очень текстурированным, увеличьте это значение, чтобы сократить количество ложных углов.

Примеры

свернуть все

Обнаружьте шахматную доску в наборе файлов изображений

Скрипт Open Live Script

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

for i = 1:5
  imageFileName = sprintf('image%d.tif', i);
  imageFileNames{i} = fullfile(matlabroot,'toolbox','vision',...
       'visiondata','calibration','webcam',imageFileName);
end

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

[imagePoints,boardSize,imagesUsed] = detectCheckerboardPoints(imageFileNames);

Отобразите обнаруженные точки.

imageFileNames = imageFileNames(imagesUsed);
for i = 1:numel(imageFileNames)
  I = imread(imageFileNames{i});
  subplot(2, 2, i);
  imshow(I);
  hold on;
  plot(imagePoints(:,1,i),imagePoints(:,2,i),'ro');
end

Обнаружьте шахматную доску в стереоизображениях

Скрипт Open Live Script

Читайте в стереоизображениях.

numImages = 4;
images1 = cell(1, numImages);
images2 = cell(1, numImages);
for i = 1:numImages
    images1{i} = fullfile(matlabroot,'toolbox','vision',...
        'visiondata','calibration','stereo','left',sprintf('left%02d.png',i));
    images2{i} = fullfile(matlabroot,'toolbox','vision',...
        'visiondata','calibration','stereo','right',sprintf('right%02d.png',i));
end

Обнаружьте шахматные доски в изображениях.

[imagePoints,boardSize,pairsUsed] = ...
    detectCheckerboardPoints(images1,images2);

Отобразите точки от images1.

images1 = images1(pairsUsed);
figure;
for i = 1:numel(images1)
      I = imread(images1{i});
      subplot(2,2,i);
      imshow(I); 
      hold on; 
      plot(imagePoints(:,1,i,1),imagePoints(:,2,i,1),'ro');
end 
annotation('textbox',[0 0.9 1 0.1],'String','Camera 1',...
    'EdgeColor','none','HorizontalAlignment','center')

Отобразите точки от images2.

images2 = images2(pairsUsed);
figure;
for i = 1:numel(images2)
      I = imread(images2{i});
      subplot(2, 2, i);
      imshow(I);
      hold on; 
      plot(imagePoints(:,1,i,2),imagePoints(:,2,i,2),'ro');
end 
annotation('textbox',[0 0.9 1 0.1],'String','Camera 2',...
    'EdgeColor','none','HorizontalAlignment','center')

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

свернуть все

`I` Введите изображение
M-by-N-by-3 изображение истинного цвета | M-by-N 2D полутоновое изображение

Введите изображение, заданное или в M-by-N-by-3 истинный цвет или в M-by-N 2D шкала полутонов. Входное изображение должно быть действительным и неразреженным. Функция может обнаружить шахматные доски с минимальным размером квадратов 4 на 4.

`imageFileNames` — Имена файла образа
N- массив ячеек элемента

Имена файла образа, заданные как N - массив ячеек элемента имен файлов N.

`imageFileNames1` — Имена файлов для камеры 1 изображение
N- массив ячеек элемента

Имена файлов для камеры 1 изображение, заданное как N - массив ячеек элемента имен файлов N. Изображения, содержавшиеся в этом массиве, должны быть в том же порядке как изображения, содержавшиеся в imageFileNames2, формируя стереопары.

`imageFileNames2` — Имена файлов для камеры 2 изображения
N- массив ячеек элемента

Имена файлов для камеры 2 изображения, заданные как N - массив ячеек элемента имен файлов N. Изображения, содержавшиеся в этом массиве, должны быть в том же порядке как изображения, содержавшиеся в imageFileNames1, формируя стереопары.

`изображения` Изображения
height-by-width-by-color channel-by-number of frames массив

Изображения, заданные как H-by-W-by-B-by-F массив, содержащий набор изображений полутонового или истинного цвета. Входные размерности:

H представляет высоту изображения.

W представляет ширину изображения.

B представляет цветовой канал. Значение 1 указывает на полутоновое изображение, и значение 3 указывает на изображение истинного цвета.

F представляет количество фреймов изображения.

`images1` — Стереопара отображает 1
height-by-width-by-color channel-by-number of frames массив

H представляет высоту изображения.

W представляет ширину изображения.

F представляет количество фреймов изображения.

`images2` — Стереопара отображает 2
height-by-width-by-color channel-by-number of frames массив

H представляет высоту изображения.

W представляет ширину изображения.

F представляет количество фреймов изображения.

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

свернуть все

`imagePoints` — Обнаруженные угловые координаты шахматной доски
M-by-2 матрица | M-by-2-by-массив number of images | M-by-2-by-number of pairs of images-by-number of cameras массив

Обнаруженные угловые координаты шахматной доски, возвращенные как M-by-2 матрица для одного изображения. Для повторных изображений точки возвращены как M-by-2-by-number of images массив, и для стереопар изображений, функция возвращает точки как M-by-2-by-number of pairs-by-number of cameras массив.

Для стереопар, imagePoints (::: 1) точки от первого набора изображений и imagePoints (::: 2) точки от второго набора изображений. Вывод содержит количество M [x y] координаты. Каждая координата представляет точку, где прямые углы обнаруживаются на шахматной доске. Число точек, которое возвращает функция, зависит от значения boardSize, который указывает на количество обнаруженных квадратов. Функция обнаруживает точки с субпиксельной точностью.

Функция вычисляет число точек, M, можно следующим образом:

M = prod (boardSize-1).

Если шахматная доска не может быть обнаружена:

imagePoints = []

boardSize = [0,0]

Когда вы задаете вход imageFileNames, функция может возвратить imagePoints как M-by-2-by-N массив. В этом массиве N представляет количество изображений, в которых обнаруживается шахматная доска.

`boardSize` — Размерности шахматной доски
С 2 элементами [height, width] вектор

Размерности шахматной доски, возвращенные как с 2 элементами [height, width] вектор. Размерности шахматной доски выражаются с точки зрения количества квадратов.

`imagesUsed` — Флаг обнаружения шаблона
N-by-1 логический вектор

Флаг обнаружения шаблона, возвращенный как N-by-1 логический вектор N logicals. Функциональные выходные параметры то же количество logicals как там вводятся изображения. Значение true указывает, что шаблон был обнаружен в соответствующем изображении. Значение false указывает, что функция не обнаружила шаблон.

`pairsUsed` — Флаг обнаружения шаблона стереопары
N-by-1 логический вектор

Флаг обнаружения шаблона стереопары, возвращенный как N-by-1 логический вектор N logicals. Функциональные выходные параметры то же количество logicals как там вводятся изображения. Значение true указывает, что шаблон обнаруживается в соответствующей паре стереоизображения. Значение false указывает, что функция не обнаруживает шаблон.

Ссылки

[1] Гайгер, A., Ф. Моосманн, O. Автомобиль и Б. Шустер. "Автоматическая Калибровка Датчика Камеры и Области значений с помощью Одного Выстрела", Международная конференция по вопросам Робототехники и Автоматизации (ICRA), Св. Павла, США, май 2012.

Расширенные возможности

Генерация кода C/C++
Генерация кода C и C++ с помощью MATLAB® Coder™.

Указания и ограничения по применению:

Генерация кода не поддержит изображения определения как имена файлов или массивы ячеек имен файлов. Это поддерживает только обнаружение шахматной доски в одном изображении или стереопаре изображений. Например, эти синтаксисы поддерживаются:
- detectCheckerboardPoints(I1)
- detectCheckerobarPoints(I1,I2)
I1 и I2 являются одной шкалой полутонов или изображениями RGB.

Документация

detectCheckerboardPoints

Синтаксис

Описание

Примеры

Обнаружьте шахматную доску в наборе файлов изображений

Обнаружьте шахматную доску в стереоизображениях

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

`I` Введите изображение
M-by-N-by-3 изображение истинного цвета | M-by-N 2D полутоновое изображение

`imageFileNames` — Имена файла образа
N- массив ячеек элемента

`imageFileNames1` — Имена файлов для камеры 1 изображение
N- массив ячеек элемента

`imageFileNames2` — Имена файлов для камеры 2 изображения
N- массив ячеек элемента

`изображения` Изображения
height-by-width-by-color channel-by-number of frames массив

`images1` — Стереопара отображает 1
height-by-width-by-color channel-by-number of frames массив

`images2` — Стереопара отображает 2
height-by-width-by-color channel-by-number of frames массив

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

`imagePoints` — Обнаруженные угловые координаты шахматной доски
M-by-2 матрица | M-by-2-by-массив number of images | M-by-2-by-number of pairs of images-by-number of cameras массив

`boardSize` — Размерности шахматной доски
С 2 элементами [height, width] вектор

`imagesUsed` — Флаг обнаружения шаблона
N-by-1 логический вектор

`pairsUsed` — Флаг обнаружения шаблона стереопары
N-by-1 логический вектор

Ссылки

Расширенные возможности

Генерация кода C/C++
Генерация кода C и C++ с помощью MATLAB® Coder™.

Смотрите также

Темы

Введенный в R2014a

Документация Computer Vision Toolbox

Поддержка

Документация

detectCheckerboardPoints

Синтаксис

Описание

Примеры

Обнаружьте шахматную доску в наборе файлов изображений

Обнаружьте шахматную доску в стереоизображениях

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

I Введите изображение M-by-N-by-3 изображение истинного цвета | M-by-N 2D полутоновое изображение

imageFileNames — Имена файла образа N- массив ячеек элемента

imageFileNames1 — Имена файлов для камеры 1 изображение N- массив ячеек элемента

imageFileNames2 — Имена файлов для камеры 2 изображения N- массив ячеек элемента

изображения Изображения height-by-width-by-color channel-by-number of frames массив

images1 — Стереопара отображает 1 height-by-width-by-color channel-by-number of frames массив

images2 — Стереопара отображает 2 height-by-width-by-color channel-by-number of frames массив

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

imagePoints — Обнаруженные угловые координаты шахматной доски M-by-2 матрица | M-by-2-by-массив number of images | M-by-2-by-number of pairs of images-by-number of cameras массив

boardSize — Размерности шахматной доски С 2 элементами [height, width] вектор

imagesUsed — Флаг обнаружения шаблона N-by-1 логический вектор

pairsUsed — Флаг обнаружения шаблона стереопары N-by-1 логический вектор

Ссылки

Расширенные возможности

Генерация кода C/C++ Генерация кода C и C++ с помощью MATLAB® Coder™.

Смотрите также

Темы

Введенный в R2014a

Документация Computer Vision Toolbox

Поддержка

`I` Введите изображение
M-by-N-by-3 изображение истинного цвета | M-by-N 2D полутоновое изображение

`imageFileNames` — Имена файла образа
N- массив ячеек элемента

`imageFileNames1` — Имена файлов для камеры 1 изображение
N- массив ячеек элемента

`imageFileNames2` — Имена файлов для камеры 2 изображения
N- массив ячеек элемента

`изображения` Изображения
height-by-width-by-color channel-by-number of frames массив

`images1` — Стереопара отображает 1
height-by-width-by-color channel-by-number of frames массив

`images2` — Стереопара отображает 2
height-by-width-by-color channel-by-number of frames массив

`imagePoints` — Обнаруженные угловые координаты шахматной доски
M-by-2 матрица | M-by-2-by-массив number of images | M-by-2-by-number of pairs of images-by-number of cameras массив

`boardSize` — Размерности шахматной доски
С 2 элементами [height, width] вектор

`imagesUsed` — Флаг обнаружения шаблона
N-by-1 логический вектор

`pairsUsed` — Флаг обнаружения шаблона стереопары
N-by-1 логический вектор

Генерация кода C/C++
Генерация кода C и C++ с помощью MATLAB® Coder™.