■ "QRコード"機能が追加になったよ!

2021/12/25に、OpenCV 4.5.5がリリースされる、はず。（順調にいけば）

さて、OpenCV 4.5.5の新機能の１つが "QRCode" ですね!!

あれ？ QR Detectorなら昔からある？ Contribにwechat_qrcode？いやいや!! 今年のOpenCV 4.5.5には QR Code "生成機能" が搭載されました！

■ OpenCV 4.5.5 から、QR Encoderが搭載されます！(でも、そこ？)

さて、OpenCV 4.5.5のリリースを待っていると多分、クリスマス当日になってしまう。
そこで、4.x branchをベースに機能を確認してみる。

……なのですが、え？ objdetectにQR Encoderが生えているの？

とりあえず、動かしてみる。

▢ OpenCV 4.5.5のコンパイル(いつもの)

このあたりはもう手慣れたものなので、これくらいでいいよね？

sudo apt install git cmake ninja-build ccache build-essential 
git clone --depth=1 https://github.com/opencv/opencv.git
cmake -S opencv -B opencv_build -GNinja
cd opencv_build 
ninja
sudo ninja install

-- General configuration for OpenCV 4.5.5-pre =====================================
--   Version control:               80492d6
--
--   Platform:
--     Timestamp:                   2021-12-20T12:17:41Z
--     Host:                        Linux 5.13.0-22-generic x86_64
--     CMake:                       3.18.4
--     CMake generator:             Ninja
--     CMake build tool:            /usr/bin/ninja
--     Configuration:               Release

■ もっともsimpleなテスト(たった7行!実質3行)

パラメータチューニングも無ければ、なんとたった3行でQR code画像を生成できる!
includeとかも加えても、7行!!

#include <opencv2/opencv.hpp>
int main(){
  auto encoder = cv::QRCodeEncoder::create();
  cv::Mat qrcode;
  encoder->encode("Hello,world!", qrcode);
  cv::imwrite("qr.pbm", qrcode);
}

使うAPIこれしかないです。 createして、encodeする！以上!簡単!

    /** @brief Constructor
    @param parameters QR code encoder parameters QRCodeEncoder::Params
    */
    static CV_WRAP
    Ptr<QRCodeEncoder> create(const QRCodeEncoder::Params& parameters = QRCodeEncoder::Params());

    /** @brief Generates QR code from input string.
     @param encoded_info Input string to encode.
     @param qrcode Generated QR code.
    */
    CV_WRAP virtual void encode(const String& encoded_info, OutputArray qrcode) = 0;

■ 設定可能なパラメータ

    /** @brief QR code encoder parameters.
     @param version The optional version of QR code (by default - maximum possible depending on
                    the length of the string).
     @param correction_level The optional level of error correction (by default - the lowest).
     @param mode The optional encoding mode - Numeric, Alphanumeric, Byte, Kanji, ECI or Structured Append.
     @param structure_number The optional number of QR codes to generate in Structured Append mode.
    */
    struct CV_EXPORTS_W_SIMPLE Params
    {
        CV_WRAP Params();
        CV_PROP_RW int version;
        CV_PROP_RW CorrectionLevel correction_level;
        CV_PROP_RW EncodeMode mode;
        CV_PROP_RW int structure_number;
    };

▢ int version

画素数・情報量。 1(21x21)～40(177x177)の中で選択する。

▢ CorrectionLevel correction_level

誤り訂正能力。L～Hで選択。誤り訂正能力を高めればその分、記憶できる情報量も減る。

    enum CorrectionLevel {
        CORRECT_LEVEL_L = 0,
        CORRECT_LEVEL_M = 1,
        CORRECT_LEVEL_Q = 2,
        CORRECT_LEVEL_H = 3
    };

▢ EncodeMode mode

エンコード方法の指定。例えば数字しか入っていないデータならば、MODE_NUMERICを選ぶと情報を効率的に保存できる、など等。

    enum EncodeMode {
        MODE_AUTO              = -1,
        MODE_NUMERIC           = 1, // 0b0001
        MODE_ALPHANUMERIC      = 2, // 0b0010
        MODE_BYTE              = 4, // 0b0100
        MODE_ECI               = 7, // 0b0111
        MODE_KANJI             = 8, // 0b1000
        MODE_STRUCTURED_APPEND = 3  // 0b0011
    };

▢ int structure_number

連結機能。複数のQRコードによって１つのデータを表現する機能。使うのはなかなか難しそうですが…。

    /** @brief Generates QR code from input string in Structured Append mode. The encoded message is splitting over a number of QR codes.
     @param encoded_info Input string to encode.
     @param qrcodes Vector of generated QR codes.
    */
    CV_WRAP virtual void encodeStructuredAppend(const String& encoded_info, OutputArrayOfArrays qrcodes) = 0;

■ 一応…

画像データは、pixel by pixelな画像データなので、必要なサイズに引き延ばしてください。

■ まとめ

OpenCV 4.5.5 は、クリスマスにリリースだよ！
なぜかObject Detect機能の中に、QR Code生成機能が生えたよ！
使い方は簡単。これでどんどんQRコード生成できるね！やったー！

それでは皆様、良い年をお過ごしくださいませ！！来年もまた元気に会いましょう！！

ただし、私は普通に来週もお仕事である。

QRコードの生成のAPIを振り返る(1回目)(そして最終回)