Python WebAcademy

Python WebAcademy Blog

画像処理のOpenCV 5.1がリリース。Python向けのopencv-pythonも公開され、透過画像の合成やOklabへの色の変換が加わったニュースを初心者向けに解説

|

2026年11月6日、画像処理のライブラリOpenCVの5.1.0が公開され、11月17日にはPython向けのopencv-pythonの5.1.0.95もPyPIに並びました。5.x系で初めての機能の更新です。透過画像を重ねるalphaCompositeや、Oklabへの色の変換が加わり、大きな整数の扱いも変わっています。5.0.0と5.1.0で動かした結果とともに整理します。

2026年11月6日、画像処理のライブラリOpenCVの5.1.0が公開されました。公式の変更履歴では、5.x系で初めての機能の更新と紹介されています。

続く11月17日には、Pythonからpipで入れるためのopencv-pythonの5.1.0.95も、PyPIに公開されました。Pythonで使っている方にとっては、ここからが本番ですね。

今回は、透過画像を重ねる関数や、新しい色の表し方への変換が加わりました。一方で、大きな整数の計算など、結果が変わる点もあります。

5.0.0と5.1.0で同じコードを動かしながら、何が変わったのかを見ていきます。

まずはOpenCVとはどんなものか

最初に、OpenCVを知らない方のために、どんなライブラリなのかを簡単に紹介します。OpenCVは、画像や動画を読み込んで、加工したり、写っているものを見つけたりするためのライブラリです。

中身はC++で書かれていて、Pythonからはcv2という名前で読み込んで使います。画像は、NumPyの配列として扱われるのが特徴です。

画像を読み込んで白黒にしてみた

実際に、基本の使い方を見てみましょう。画像を読み込み、白黒に変えて保存するだけなら、次の数行で書けます。

import cv2

img = cv2.imread("photo.jpg")
gray = cv2.cvtColor(img, cv2.COLOR_BGR2GRAY)
cv2.imwrite("photo_gray.jpg", gray)

OpenCVでは、色の並びが青、緑、赤の順になっている点に注意しましょう。cvtColorは、この色の並びや色の表し方を変えるための関数です。

NumPyの配列の基本は、こちらで紹介しています。【関連記事】PythonのNumPyとは?

Pillowとの違い

Pythonで画像を扱うライブラリとしては、Pillowもよく使われます。大まかに比べると、次のような違いがあります。

項目 Pillow OpenCV
得意なこと リサイズや形式の変換など、手軽な加工 動画、物の検出、AIのモデルを使った処理
画像の持ち方 Imageという専用のオブジェクト NumPyの配列
色の並び 赤、緑、青 青、緑、赤

Pillowの使い方は、こちらで紹介しています。【関連記事】PythonのPillowとは?

5.1で何が変わったのかを整理しよう

続いて、5.1.0の主な変更を表にまとめます。内容は、OpenCVの公式のWikiにある変更履歴OpenCV Change Logsにもとづいています。

分類 主な変更
画像の加工 透過画像を重ねるalphaCompositeを追加
色の変換 新しい色の表し方Oklabとの変換を追加
Python 大きな値を持つint64の配列を、切り捨てずにそのまま扱う
Python 長さ0の画像を、Noneではなく空の配列で返す
計算 32ビットの整数の足し算と引き算が、飽和するように
AIのモデル 古いDNNのエンジンと、TensorFlowのモデルの読み込みを削除
動画 つながっているカメラの一覧を取れるenumerateDevices

ここからは、それぞれの変更を、5.0.0と5.1.0の両方で動かして確かめていきます。手元のPython 3.11で、opencv-python-headlessの5.0.0.93と5.1.0.95を、それぞれ新しい仮想環境に入れました。

透過画像をきれいに重ねられるように

まずは、初心者にも嬉しい新機能から見ていきましょう。5.1.0では、透明な部分を持つ画像を、別の画像の上に重ねるcv2.alphaCompositeが加わりました。

これまでは、透明さを表すアルファの値を自分で取り出し、掛け算と足し算で合成する必要がありました。1行で、透過画像を重ねられるようになったわけです。

試してみた

実際に、不透明な青の画像の上に、半透明の赤の画像を重ねてみました。色は、青、緑、赤、アルファの順に並べています。

import cv2
import numpy as np

bg = np.zeros((2, 2, 4), np.uint8)
bg[:] = (255, 0, 0, 255)  # 不透明な青
fg = np.zeros((2, 2, 4), np.uint8)
fg[:] = (0, 0, 255, 128)  # 半透明の赤

out = cv2.alphaComposite(fg, bg)
print(out[0, 0])

5.1.0で実行すると、[127 0 128 255]と表示されました。青と赤がおよそ半分ずつ混ざり、紫に近い色になっています。

5.0.0では、cv2.alphaCompositeという関数そのものがありませんでした。インストールされた5.1.0の説明文によると、既定の重ね方のほかに、ALPHA_COMPOSITE_INなど、合わせて13種類の重ね方が用意されています。

ロゴをスタンプのように写真に重ねたいときなどに、便利に使えそうです。

Oklabへの色の変換が加わった

2つ目は、色の変換です。cvtColorに、Oklabという色の表し方との変換が加わりました。

Oklabは、人の目で見た明るさや色合いの差を、数値の差に近づけた色の表し方です。明るさのL、緑から赤のa、青から黄のbの3つの値で色を表します。

試してみた

実際に、赤、白、黒の3つの点を、Oklabに変えてみました。小数の配列に直してから渡しています。

px = np.uint8([[[0, 0, 255], [255, 255, 255], [0, 0, 0]]])
lab = cv2.cvtColor(px.astype(np.float32) / 255, cv2.COLOR_BGR2OKLAB)
print(lab)

5.1.0では、赤の明るさが約0.628、白が1.0、黒が0.0になりました。5.0.0には、COLOR_BGR2OKLABという定数がありませんでした。

色を比べたり、自然なグラデーションを作ったりしたいときに使える変換です。

Pythonでの数の扱いが変わった

ここからは、気をつけたい変更です。変更履歴によると、Pythonから渡したデータの扱いに、いくつか見直しが入りました。

大きなint64の配列

1つ目は、64ビットの整数、つまりint64の配列です。これまでは、32ビットに収まらない値が、切り捨てられていました。

実際に、30億という値を持つint64の配列を、cv2.addで2倍にしてみました。

版 結果の型 30億と30億を足した結果
5.0.0 int32 1705032704
5.1.0 int64 6000000000

5.0.0では、32ビットに収まらずに、まったく違う数になっていました。5.1.0では、int64のまま正しく60億が返っています。

32ビットの足し算が飽和するように

2つ目は、int32の配列どうしの足し算です。変更履歴によると、32ビットの整数の足し算と引き算は、飽和するようになりました。

飽和とは、上限を超えたときに、上限の値で止めることです。実際に、20億と20億を足してみると、5.0.0では-294967296、5.1.0では上限の2147483647になりました。

どちらが正しいかは、使い方によって変わります。ただ、同じコードでも結果が変わるので、大きな整数を計算している方は上げる前に確かめておきましょう。

長さ0の画像は空の配列に

3つ目は、行の数が0の画像です。手元で、形が0行3列の配列をcv2.flipに渡すと、5.0.0ではNone、5.1.0では空の配列が返りました。

Noneかどうかで処理を分けていたコードは、5.1.0では動きが変わる可能性があります。なお、cv2.transposeでは、どちらの版でもNoneが返りました。

AIのモデルまわりの削除

続いて、AIのモデルを動かすdnnという部分の変更です。変更履歴によると、古いDNNのエンジンが取り除かれました。

あわせて、TensorFlowのモデルを読み込むreadNetFromTensorflowも削除されています。手元で確かめると、5.0.0のcv2.dnnにはこの関数がありましたが、5.1.0ではなくなっていました。

確かめたこと 5.0.0 5.1.0
cv2.dnn.readNetFromTensorflow あった なくなった
cv2.dnn.readNetFromONNX あった あった
エンジンの定数 ENGINE_AUTO、ENGINE_CLASSIC、ENGINE_NEW、ENGINE_ORT ENGINE_AUTO、ENGINE_OPENCV、ENGINE_ORT

変更履歴では、TensorFlowのモデルは、ONNXという共通の形式に変えて使うよう案内されています。ENGINE_CLASSICやENGINE_NEWを指定していた方は、書き換えが必要です。

そのほかの変更

変更履歴には、ほかにもたくさんの変更が並んでいます。初心者にも関係しそうなものを、表にまとめます。

変更 中身
cv2.linearAssignment 行と列の組み合わせを、合計のコストが最も小さくなるように決める
enumerateDevices cv2.videoio_registryから、つながっているカメラの一覧を取れる
文字の描画 文字の形を整える仕組みを、HarfBuzzという道具に変更
画像の保存 16ビットのAVIFや、TIFFの圧縮の強さの指定に対応

1つ目のlinearAssignmentも試しました。たとえば、3人の担当者に3つの作業を割り振るとき、かかる時間の合計が最も短くなる組み合わせを探す、といった問題を解けます。

cost = np.array([[4, 1, 3], [2, 0, 5], [3, 2, 2]], np.float32)
total, assignment = cv2.linearAssignment(cost)
print(total, assignment)

5.1.0で実行すると、5.0 [1 0 2]と表示されました。1行目には2列目、2行目には1列目、3行目には3列目を割り当てると、合計が5になるという意味です。

変更履歴によると、imwriteは、TrueとFalseだけを持つbool型の画像も受け付けるようになりました。手元で、真ん中だけTrueにした配列をPNGに保存して読み直すと、Trueの部分の値は5.0.0では1、5.1.0では白の255になっていました。

5.0.0の1は、ほとんど黒にしか見えません。白黒のマスクの画像を保存するときに、見た目どおりの結果になるのは嬉しいですね。

画像の保存は、Pillow 13.0でも変更が入っていました。【関連記事】Pillow 13.0がリリース

上げる前にやっておきたいこと

最後に、OpenCVを5.1へ上げる前に確かめておきたいことを整理します。

順番 確認すること
1 int32やint64の大きな値を、OpenCVで計算していないか
2 結果がNoneかどうかで、処理を分けていないか
3 readNetFromTensorflowや、ENGINE_CLASSICを使っていないか
4 自分で書いていた透過画像の合成を、alphaCompositeに置き換えられないか

私は10年ほどエンジニアとして開発に関わってきましたが、商品の写真にロゴを重ねるツールを作ったとき、アルファの値の計算を自分で書いて、縁がギザギザになって苦労したことがあります。関数1つで重ねられるのは、とてもありがたい変更です。

まとめ

2026年11月6日、OpenCV 5.1.0が公開され、11月17日にはPython向けのopencv-pythonの5.1.0.95も出ました。透過画像を重ねるalphaCompositeや、Oklabへの色の変換が加わっています。

一方で、大きな整数の計算の結果や、AIのモデルの読み込み方が変わりました。上げる前に、上の確認ポイントを一度見直してみてください。

ここまでお読みいただきありがとうございました。

参考情報

次のアクション

記事で学んだ内容を実際に動かしてみよう

Python WebAcademyでは、ブラウザ上でコードを書きながら基礎から実践まで体系的に学べます。

Python WebAcademyの学習画面

あわせて読む

関連記事

ブログ一覧へ

Python学習ロードマップ

まずはこの3講座から

記事で気になったテーマを、順番に手を動かしながら学べます。

ロードマップを見る