【OpenCV】4.6.0から4.7.0でのArUcoモジュールの更新箇所抜粋

# はじめに
OpenCVを使用してArUcoマーカの認識をしようとしたらバージョンの更新によって関数名の更新があったのでまとめます。
Web上に公開されているサンプルプログラムでも同じバージョンでないと基本的に動かないので辞書的な使い方で参考になれば幸いです。

:::note
ここでは、ArUcoマーカの生成、認識、描画等**最低限**の関数のみ記載することとします。
:::

より詳細な情報は公式ページを参照してください。

https://docs.opencv.org/4.7.0/index.html

# バージョン
サンプルプログラムは、`**4.7.0**`で動作確認したものです。

# サンプルプログラム
## マーカ画像の作成
マーカ画像の周りに余白を設けるために少し工夫しています。
(白い画像のimgを用意してそれに重ね合わせている。[参考](https://rtc-fukushima.jp/technical/5892/))

```Python
#!/usr/bin/env python3
# coding: utf-8

import cv2
import numpy as np
from cv2 import aruco

# Size and offset value
size = 150
offset = 10
x_offset = y_offset = int(offset) // 2

# get dictionary and generate image
dictionary = aruco.getPredefinedDictionary(aruco.DICT_4X4_50)
ar_img = aruco.generateImageMarker(dictionary, 0, size)

# make white image
img = np.zeros((size + offset, size + offset), dtype=np.uint8)
img += 255

# overlap image
img[y_offset:y_offset + ar_img.shape[0], x_offset:x_offset + ar_img.shape[1]] = ar_img

cv2.imwrite("marker_0.png", img)
```

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/426354/487820b0-c0dc-b436-f148-423e5d55884d.png)

## マーカの読み込み＆描画

```Python
#!/usr/bin/env python3
# coding: utf-8

import cv2
from cv2 import aruco

# get dicionary and get parameters
dictionary = aruco.getPredefinedDictionary(aruco.DICT_4X4_50)
parameters = aruco.DetectorParameters()

# read from image
input_file = "marker_0.png"
output_file = "detected_marker_0.png"
input_img = cv2.imread(input_file)

# detect and draw marker's information
corners, ids, rejectedCandidates = aruco.detectMarkers(input_img, dictionary, parameters=parameters)
print(ids)
ar_image = aruco.drawDetectedMarkers(input_img, corners, ids)

cv2.imwrite(output_file, ar_image)
```

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/426354/6f761af4-9974-2866-131b-a0d9309a0840.png)

# 更新箇所
## 辞書の読み込み
### Dictionary_get()の廃止
辞書を取得する関数のうちの一つがなくなりました。
`getPredefinedDictionary()`は4.6.0と4.7.0で変わっていないのでそれを使うのがベターだと思います。

```Python
# ver 4.6.0
Dictionary_get(dictionary_name)
getPredefinedDictionary(dictionary_name)
# ver 4.7.0
getPredefinedDictionary(dictionary_name)
```

ver4.7.0で`Dictionary_get()`を使用すると下記のエラーが発生しました。
```
AttributeError: module 'cv2.aruco' has no attribute 'Dictionary_get'. Did you mean: 'Dictionary'?
```


### Dictionary_get (ver4.6.0)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/426354/47ebc438-5bd6-63fd-b802-7772ce5e8a2f.png)

https://docs.opencv.org/4.6.0/d5/d0b/classcv_1_1aruco_1_1Dictionary.html#a1b0c74e3b15073ff11cbe10e99c6d654

### getPredefinedDictionary (ver4.6.0)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/426354/15389bdb-b7fa-18f5-e63d-7351de2a60bc.png)

https://docs.opencv.org/4.6.0/d9/d6a/group__aruco.html#gaf5d7e909fe8ff2ad2108e354669ecd17

### getPredefinedDictionary (ver4.7.0)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/426354/c50913b4-75e6-f49b-2e03-6a94912b64f7.png)

https://docs.opencv.org/4.7.0/de/d67/group__objdetect__aruco.html#ga68e0379bcf3799b1ff7145769f8a09c8

## マーカの生成
### drawMarker => generateImageMarker
マーカを生成する関数名が変わっていました。

```Python
# Ver 4.6.0
cv.aruco.drawMarker(dictionary, id, sidePixels)
# Ver 4.7.0
cv.aruco.generateImageMarker(dictionary, id, sidePixels)
```

ver4.7.0で`drawMarker()`を使用すると下記のエラーが発生しました。
```
AttributeError: module 'cv2.aruco' has no attribute 'drawMarker'
```

### drawMarker (ver4.6.0)  
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/426354/01950640-dff2-e70e-6d40-473a5670f73c.png)

https://docs.opencv.org/4.6.0/d9/d6a/group__aruco.html#ga254ed245e10c5b3e2259d5d9b8ea8e2f

### generateImageMarker (ver4.7.0)
C++の場合は、include対象も変更されているので注意してください。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/426354/99c761bb-04a3-3631-cd5d-91abc9f51a57.png)

https://docs.opencv.org/4.7.0/de/d67/group__objdetect__aruco.html#ga631cb40c63945cc5b9ef6b064a5f4fc2

## マーカの認識
### パラメータの取得
マーカを認識する際に使用するパラメータ変数を取得する関数の関数名が変更になっていました。

```Python
# ver 4.6.0
parameters = cv.aruco.DetectorParameters_create()
# ver4.7.0
parameters = cv.aruco.DetectorParameters()
```

ver4.7.0で`DetectorParameters_create()`を使用すると下記のエラーが発生しました。
```
AttributeError: module 'cv2.aruco' has no attribute 'DetectorParameters_create'. Did you mean: 'DetectorParameters'?
```

### DetectorParameters::create (ver 4.6.0)
Pythonだと`DetectorParameters_create()`
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/426354/4e35f16a-3842-8021-d7d2-7efa80998cec.png)

### DetectorParameters (ver 4.7.0)
コンストラクタだけでよくなったようです。
(少なくともメンバ変数から`create`は消えました)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/426354/54084748-71b4-4b2a-435a-b7bd4949642d.png)

### マーカの認識＆描画
マーカの認識には、ver4.6.0、ver4.7.0どちらでも`detectMarkers`、認識結果の描画には`drawDetectedMarkers`を使用できます。
ただ、ver4.7.0では `cv.aruco.ArucoDetector.detectMarkers`が追加されています。

### detectMarkers (ver4.6.0)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/426354/9dcedb71-e4a3-9e9a-8a28-67b57f0c3ae6.png)

https://docs.opencv.org/4.6.0/d9/d6a/group__aruco.html#ga061ee5b694d30fa2258dd4f13dc98129

### detectMarkers (ver4.7.0)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/426354/5ce5283a-341a-dca6-2f3f-484a4968c60e.png)

https://docs.opencv.org/4.7.0/d9/d6a/group__aruco.html#ga3bc50d61fe4db7bce8d26d56b5a6428a

###	ArucoDetector.detectMarkers (ver4.7.0)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/426354/7bc335e7-a86c-5114-0a51-2f77d8913f0d.png)

### drawDetectedMarkers (ver4.6.0)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/426354/7e93c33e-d53a-28b3-ce37-197ca380ba99.png)

https://docs.opencv.org/4.6.0/d9/d6a/group__aruco.html#ga2ad34b0f277edebb6a132d3069ed2909

### drawDetectedMarkers (ver4.7.0)
C++の場合は、include対象も変更されているので注意してください。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/426354/42b5dcbb-013b-79b5-e210-0bdbebf71d7c.png)

https://docs.opencv.org/4.7.0/de/d67/group__objdetect__aruco.html#ga2ad34b0f277edebb6a132d3069ed2909

# おわりに
バージョン情報の記載は大事ということに気付きました！！
必要があればほかの関数についても追記します。