为您的图像添加边框

目录

• 目标
• 理论
• 代码
• 解释
  • 声明变量
  • 加载图像
  • 创建窗口
  • 初始化参数
  • 循环
  • 随机颜色
  • 为图像添加边框
  • 显示结果
• 结果

上一个教程： 制作自己的线性滤波器！
下一个教程： Sobel 导数

原始作者	Ana Huamán
兼容性	OpenCV >= 3.0

目标

在本教程中，您将学习如何

• 使用 OpenCV 函数 copyMakeBorder() 为图像设置边框（额外填充）。

理论

注意

以下解释摘自 Bradski 和 Kaehler 所著的 《学习 OpenCV》 一书。

1. 在我们之前的教程中，我们学习了如何使用卷积对图像进行操作。一个自然而然出现的问题是如何处理边界。如果评估点位于图像边缘，我们如何对它们进行卷积？
2. 大多数 OpenCV 函数的做法是将给定图像复制到另一个稍大的图像上，然后自动填充边界（通过下面示例代码中解释的任何方法）。这样，就可以在所需像素上执行卷积而不会出现问题（操作完成后会剪切掉额外填充）。

3. 在本教程中，我们将简要探讨两种为图像定义额外填充（边框）的方法

   1. BORDER_CONSTANT：用一个常数值（例如黑色或 \(0\)）填充图像。
   2. BORDER_REPLICATE：原始图像最边缘的行或列被复制到额外边框。

   这将在代码部分更清楚地看到。

• 此程序的作用是什么？
  • 加载图像

  • 让用户选择在输入图像中使用哪种填充。有两种选项：

    1. 常数值边框：对整个边框应用一个常数值填充。该值每0.5秒随机更新一次。
    2. 复制边框：边框将从原始图像边缘的像素值复制而来。

    用户可以通过按 'c'（常数）或 'r'（复制）选择其中一个选项

  • 用户按下 'ESC' 键时程序结束

代码

教程代码如下所示。

C++

您也可以从此处下载

 
#include "opencv2/imgproc.hpp"
#include "opencv2/imgcodecs.hpp"
#include "opencv2/highgui.hpp"
 
using namespace cv;
 
// 声明变量
Mat src, dst;
int top, bottom, left, right;
int borderType = BORDER_CONSTANT;
const char* window_name = "copyMakeBorder Demo";
RNG rng(12345);
 
int main( int argc, char** argv )
{
    const char* imageName = argc >=2 ? argv[1] : "lena.jpg";
 
    // 加载图像
src = imread( samples::findFile( imageName ), IMREAD_COLOR ); // 加载图像
 
    // 检查图像是否加载成功
    if( src.empty()) {
printf(" 图像打开错误\n");
printf(" 程序参数: [图像名 -- 默认 lena.jpg] \n");
        return -1;
    }
 
    // 本程序的简要说明
printf( "\n \t copyMakeBorder 演示: \n" );
printf( "\t -------------------- \n" );
printf( " ** 按 'c' 设置边框为随机常数值 \n");
printf( " ** 按 'r' 设置边框为复制类型 \n");
printf( " ** 按 'ESC' 退出程序 \n");
 
namedWindow( window_name, WINDOW_AUTOSIZE );
 
    // 初始化滤波器的参数
top = (int) (0.05*src.rows); bottom = top;
left = (int) (0.05*src.cols); right = left;
 
    for(;;)
    {
        Scalar value( rng.uniform(0, 255), rng.uniform(0, 255), rng.uniform(0, 255) );
 
copyMakeBorder( src, dst, top, bottom, left, right, borderType, value );
 
imshow( window_name, dst );
 
        char c = (char)waitKey(500);
        if( c == 27 )
{ break; }
        else if( c == 'c' )
{ borderType = BORDER_CONSTANT; }
        else if( c == 'r' )
{ borderType = BORDER_REPLICATE; }
    }
 
    return 0;
}

Java

您也可以从此处下载

 
import org.opencv.core.*;
import org.opencv.highgui.HighGui;
import org.opencv.imgcodecs.Imgcodecs;
 
import java.util.Random;
 
class CopyMakeBorderRun {
 
    public void run(String[] args) {
 
        // 声明变量
Mat src, dst = new Mat();
        int top, bottom, left, right;
        int borderType = Core.BORDER_CONSTANT;
String window_name = "copyMakeBorder Demo";
Random rng;
 
String imageName = ((args.length > 0) ? args[0] : "../data/lena.jpg");
 
        // 加载图像
src = Imgcodecs.imread(imageName, Imgcodecs.IMREAD_COLOR);
 
        // 检查图像是否加载成功
        if( src.empty() ) {
System.out.println("图像打开错误！");
System.out.println("程序参数: [图像名 -- 默认 ../data/lena.jpg] \n");
System.exit(-1);
        }
 
        // 本程序的简要说明
System.out.println("\n" +
                "\t copyMakeBorder 演示: \n" +
                "\t -------------------- \n" +
                " ** 按 'c' 设置边框为随机常数值 \n" +
                " ** 按 'r' 设置边框为复制类型 \n" +
                " ** 按 'ESC' 退出程序 \n");
 
HighGui.namedWindow( window_name, HighGui.WINDOW_AUTOSIZE );
 
        // 初始化滤波器的参数
top = (int) (0.05*src.rows()); bottom = top;
left = (int) (0.05*src.cols()); right = left;
 
        while( true ) {
rng = new Random();
Scalar value = new Scalar( rng.nextInt(256),
rng.nextInt(256), rng.nextInt(256) );
 
Core.copyMakeBorder( src, dst, top, bottom, left, right, borderType, value);
HighGui.imshow( window_name, dst );
 
            char c = (char) HighGui.waitKey(500);
c = Character.toLowerCase(c);
 
            if( c == 27 )
{ break; }
            else if( c == 'c' )
{ borderType = Core.BORDER_CONSTANT;}
            else if( c == 'r' )
{ borderType = Core.BORDER_REPLICATE;}
        }
 
System.exit(0);
    }
}
 
public class CopyMakeBorder {
    public static void main(String[] args) {
        // 加载本地库。
System.loadLibrary(Core.NATIVE_LIBRARY_NAME);
        new CopyMakeBorderRun().run(args);
    }
}

Python

您也可以从此处下载

"""
@file copy_make_border.py
@brief 演示 copyMakeBorder 功能的示例代码
"""
import sys
from random import randint
import cv2 as cv
 
 
def main(argv)
    
borderType = cv.BORDER_CONSTANT
window_name = "copyMakeBorder Demo"
    
imageName = argv[0] if len(argv) > 0 else 'lena.jpg'
 
    # 加载图像
src = cv.imread(cv.samples.findFile(imageName), cv.IMREAD_COLOR)
 
    # Check if image is loaded fine
    if src is None
        print ('图像打开错误！')
        print ('用法: copy_make_border.py [图像名 -- 默认 lena.jpg] \n')
        return -1
    
    print ('\n'
           '\t copyMakeBorder 演示: \n'
           ' -------------------- \n'
           ' ** 按 \'c\' 设置边框为随机常数值 \n'
           ' ** 按 \'r\' 设置边框为复制类型 \n'
           ' ** 按 \'ESC\' 退出程序 ')
    
    cv.namedWindow(window_name, cv.WINDOW_AUTOSIZE)
    
top = int(0.05 * src.shape[0]) # shape[0] = 行数
bottom = top
left = int(0.05 * src.shape[1]) # shape[1] = 列数
right = left;
    
    while 1:
        
value = [randint(0, 255), randint(0, 255), randint(0, 255)]
        
dst = cv.copyMakeBorder(src, top, bottom, left, right, borderType, None, value)
        
        cv.imshow(window_name, dst)
        
c = cv.waitKey(500)
 
        if c == 27
            break
        elif c == 99: # 99 = ord('c')
borderType = cv.BORDER_CONSTANT
        elif c == 114: # 114 = ord('r')
borderType = cv.BORDER_REPLICATE
        
    return 0
 
 
if __name__ == "__main__"
    main(sys.argv[1:])

解释

声明变量

首先我们声明要使用的变量

C++

// 声明变量
Mat src, dst;
int top, bottom, left, right;
int borderType = BORDER_CONSTANT;
const char* window_name = "copyMakeBorder Demo";
RNG rng(12345);

Java

        // 声明变量
Mat src, dst = new Mat();
        int top, bottom, left, right;
        int borderType = Core.BORDER_CONSTANT;
        String window_name = "copyMakeBorder Demo";
Random rng;

Python

borderType = cv.BORDER_CONSTANT
window_name = "copyMakeBorder Demo"

特别值得注意的是变量 rng，它是一个随机数生成器。我们用它来生成随机边框颜色，稍后将看到。

加载图像

像往常一样，我们加载源图像 src

C++

    const char* imageName = argc >=2 ? argv[1] : "lena.jpg";
 
    // 加载图像
src = imread( samples::findFile( imageName ), IMREAD_COLOR ); // 加载图像
 
    // 检查图像是否加载成功
    if( src.empty()) {
printf(" 图像打开错误\n");
printf(" 程序参数: [图像名 -- 默认 lena.jpg] \n");
        return -1;
    }

Java

        String imageName = ((args.length > 0) ? args[0] : "../data/lena.jpg");
 
        // 加载图像
src = Imgcodecs.imread(imageName, Imgcodecs.IMREAD_COLOR);
 
        // 检查图像是否加载成功
        if( src.empty() ) {
System.out.println("图像打开错误！");
System.out.println("程序参数: [图像名 -- 默认 ../data/lena.jpg] \n");
System.exit(-1);
        }

Python

imageName = argv[0] if len(argv) > 0 else 'lena.jpg'
 
    # 加载图像
src = cv.imread(cv.samples.findFile(imageName), cv.IMREAD_COLOR)
 
    # Check if image is loaded fine
    if src is None
        print ('图像打开错误！')
        print ('用法: copy_make_border.py [图像名 -- 默认 lena.jpg] \n')
        return -1

创建窗口

在简要介绍如何使用程序后，我们创建一个窗口

C++

    namedWindow( window_name, WINDOW_AUTOSIZE );

Java

HighGui.namedWindow( window_name, HighGui.WINDOW_AUTOSIZE );

Python

    cv.namedWindow(window_name, cv.WINDOW_AUTOSIZE)

初始化参数

现在我们初始化定义边框大小的参数（top、bottom、left 和 right）。我们将它们的值设置为 src 大小的 5%。

C++

    // 初始化滤波器的参数
top = (int) (0.05*src.rows); bottom = top;
left = (int) (0.05*src.cols); right = left;

Java

        // 初始化滤波器的参数
top = (int) (0.05*src.rows()); bottom = top;
left = (int) (0.05*src.cols()); right = left;

Python

top = int(0.05 * src.shape[0]) # shape[0] = 行数
bottom = top
left = int(0.05 * src.shape[1]) # shape[1] = 列数
right = left;

循环

除非按下 ESC 键，否则程序将无限循环运行。如果用户按下“c”或“r”，则 borderType 变量将分别取 BORDER_CONSTANT 或 BORDER_REPLICATE 的值

C++

        char c = (char)waitKey(500);
        if( c == 27 )
{ break; }
        else if( c == 'c' )
{ borderType = BORDER_CONSTANT; }
        else if( c == 'r' )
{ borderType = BORDER_REPLICATE; }

Java

            char c = (char) HighGui.waitKey(500);
c = Character.toLowerCase(c);
 
            if( c == 27 )
{ break; }
            else if( c == 'c' )
{ borderType = Core.BORDER_CONSTANT;}
            else if( c == 'r' )
{ borderType = Core.BORDER_REPLICATE;}

Python

c = cv.waitKey(500)
 
        if c == 27
            break
        elif c == 99: # 99 = ord('c')
borderType = cv.BORDER_CONSTANT
        elif c == 114: # 114 = ord('r')
borderType = cv.BORDER_REPLICATE

随机颜色

在每次迭代（0.5秒后）中，随机边框颜色（value）会被更新...

C++

        Scalar value( rng.uniform(0, 255), rng.uniform(0, 255), rng.uniform(0, 255) );

Java

rng = new Random();
            Scalar value = new Scalar( rng.nextInt(256),
rng.nextInt(256), rng.nextInt(256) );

Python

value = [randint(0, 255), randint(0, 255), randint(0, 255)]

该值是随机选取的三个数字的集合，范围在 \([0,255]\) 之间。

为图像添加边框

最后，我们调用函数 copyMakeBorder() 来应用相应的填充

C++

        copyMakeBorder( src, dst, top, bottom, left, right, borderType, value );

Java

Core.copyMakeBorder( src, dst, top, bottom, left, right, borderType, value);

Python

dst = cv.copyMakeBorder(src, top, bottom, left, right, borderType, None, value)

• 参数为
  1. src：源图像
  2. dst：目标图像
  3. top、bottom、left、right：图像各边框的像素长度。我们将其定义为图像原始大小的5%。
  4. borderType：定义应用的边框类型。在本示例中可以是常量或复制。
  5. value：如果 borderType 是 BORDER_CONSTANT，则这是用于填充边框像素的值。

显示结果

我们在之前创建的图像中显示输出图像

C++

        imshow( window_name, dst );

Java

HighGui.imshow( window_name, dst );

Python

        cv.imshow(window_name, dst)

结果

1. 编译上述代码后，您可以执行它，并将图像路径作为参数。结果应为：

   • 默认情况下，它以 BORDER_CONSTANT 边框开始。因此，将显示一系列随机颜色的边框。
   • 如果您按下 'r'，边框将成为边缘像素的复制。
   • 如果您按下 'c'，随机颜色的边框将再次出现
   • 如果您按下 'ESC'，程序将退出。

   下面是一些截图，展示了边框颜色如何变化以及 BORDER_REPLICATE 选项的效果