We will not respond to PRs or issues that have not been discussed on Discord. Also, Discord is only available in Japanese.
Please read https://github.com/shiguredo/oss/blob/master/README.en.md before use.
利用前に https://github.com/shiguredo/oss をお読みください。
高性能 2D ベクターグラフィックエンジン Blend2D の Python バインディングです。
48d4c58625b50835cfac5d6e44b62037.mp4
blend2d-py と raw-player を組み合わせて 120 fps での映像なども描画可能です。
- macOS 26 arm64
- macOS 15 arm64
- Ubuntu 24.04 x86_64
- Ubuntu 24.04 arm64
- Ubuntu 22.04 x86_64
- Ubuntu 22.04 arm64
- Windows Server 2025 x86_64
- Windows 11 x86_64
- 3.14
- 3.14t
- 3.13
- 3.13t
- 3.12
uv add blend2d-py- 提供:
Image,Context,Path,CompOp,FontFace,Font - ピクセルアクセス:
Image.asarray()/Image.memoryview()（ゼロコピー）
from math import pi
from blend2d import Image, Context, CompOp
# 画像サイズを指定
w, h = 640, 360
img = Image(w, h)
with Context(img) as ctx:
# 合成モードを設定（SRC_COPY は不透明描画）
ctx.set_comp_op(CompOp.SRC_COPY)
# 背景を黒で塗りつぶし
ctx.set_fill_style_rgba(0, 0, 0, 255)
ctx.fill_all()
# 中心に移動
ctx.translate(w*0.5, h*0.5)
# 白い円を描画
ctx.set_fill_style_rgba(255, 255, 255, 255)
ctx.fill_pie(0, 0, min(w, h)*0.3, 0, 2*pi)
# NumPy 配列として取得（ゼロコピー）
rgba = img.asarray() # (H, W, 4) uint8 (BGRA)from blend2d import Image, Context, CompOp
w, h = 640, 480
img = Image(w, h)
with Context(img) as ctx:
# 背景を白で塗りつぶし
ctx.set_fill_style_rgba(255, 255, 255, 255)
ctx.fill_all()
# 半透明の赤い四角形を描画
ctx.set_comp_op(CompOp.SRC_OVER) # アルファブレンディングを有効化
ctx.set_fill_style_rgba(255, 0, 0, 128) # 赤、50% 透明
ctx.fill_rect(50, 50, 200, 150)
# 半透明の青い四角形を重ねて描画
ctx.set_fill_style_rgba(0, 0, 255, 128) # 青、50% 透明
ctx.fill_rect(150, 100, 200, 150)from blend2d import Image, Context, Path, CompOp
w, h = 640, 480
img = Image(w, h)
# パスで三角形を作成
path = Path()
path.move_to(w/2, h/4) # 頂点
path.line_to(w/4, 3*h/4) # 左下
path.line_to(3*w/4, 3*h/4) # 右下
path.close() # パスを閉じる
with Context(img) as ctx:
# 背景を暗い灰色に
ctx.set_fill_style_rgba(40, 40, 40, 255)
ctx.fill_all()
# グラデーション風に複数の色で描画
colors = [(255, 100, 100), (100, 255, 100), (100, 100, 255)]
for i, color in enumerate(colors):
ctx.save() # 現在の状態を保存
ctx.translate(i * 10, i * 10) # 少しずつずらす
ctx.set_fill_style_rgba(*color, 200 - i * 50) # 透明度を変える
ctx.fill_path(path)
ctx.restore() # 状態を復元import colorsys
from math import pi, sin, cos
from blend2d import Image, Context
w, h = 640, 480
img = Image(w, h)
with Context(img) as ctx:
# 背景を黒に
ctx.set_fill_style_rgba(0, 0, 0, 255)
ctx.fill_all()
# 円を円形に配置
ctx.translate(w/2, h/2) # 中心に移動
num_circles = 12
radius = 100
for i in range(num_circles):
angle = 2 * pi * i / num_circles
x = radius * cos(angle)
y = radius * sin(angle)
# 虹色のグラデーション
hue = i / num_circles
r, g, b = colorsys.hsv_to_rgb(hue, 1.0, 1.0)
ctx.set_fill_style_rgba(int(r * 255), int(g * 255), int(b * 255), 200)
ctx.fill_circle(x, y, 20) # 小さな円を描画from blend2d import Image, Context, Font, FontFace
w, h = 640, 480
img = Image(w, h)
# フォントをロード (macOS のシステムフォント)
face = FontFace()
face.create_from_file("/System/Library/Fonts/Helvetica.ttc")
# フォントインスタンスを作成
font = Font(face, 48.0)
with Context(img) as ctx:
# 背景を白で塗りつぶし
ctx.set_fill_style_rgba(255, 255, 255, 255)
ctx.fill_all()
# テキストを描画
ctx.set_fill_style_rgba(0, 0, 0, 255)
ctx.fill_utf8_text(50, 100, font, "Hello, Blend2D!")Note
- テキスト描画機能は macOS のシステムフォントを使用するため、macOS でのみ動作します
Warning
asarray()/memoryview()のビューはImageの寿命に依存します
uv build --wheeluv sync --group example
uv build --wheel
uv pip install -e . --force-reinstall
uv run python examples/realtime_demo.py- PRGB32（実質 BGRA）→
cv2.cvtColor(..., cv2.COLOR_BGRA2BGR)で表示 - 詳細手順と他のサンプルは
examples/README.mdを参照
Image.memoryview()でstride*heightバイトの 1D バッファを公開します- NumPy での多次元化や OpenCV 表示は
docs/buffer.mdを参照してください
zlib License
Copyright (c) 2017-2025 Petr Kobalicek, Fabian Yzerman
This software is provided 'as-is', without any express or implied
warranty. In no event will the authors be held liable for any damages
arising from the use of this software.
Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to alter it and redistribute it
freely, subject to the following restrictions:
1. The origin of this software must not be misrepresented; you must not
claim that you wrote the original software. If you use this software
in a product, an acknowledgment in the product documentation would be
appreciated but is not required.
2. Altered source versions must be plainly marked as such, and must not be
misrepresented as being the original software.
3. This notice may not be removed or altered from any source distribution.
Apache License 2.0
Copyright 2025-2025, Shiguredo Inc.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.