drawlib.images & drawlib.math（画像処理と幾何計算）

drawlib.images は image() によるラスター画像配置、不変ラッパー Dimage による非破壊フィルタ変換、get_dimage_from_code() による分離プロセスでのサブ図生成を提供します。drawlib.math は 2D ベクトル・外接矩形・楕円・回転・経路補間・直交ルーティング計算を提供します（from drawlib.images import Dimage, get_dimage_from_code, image / from drawlib.math import ...）。

from drawlib.canvas import save, setup
from drawlib.images import Dimage, image
from drawlib.lines import line, lines
from drawlib.math import compute_orthogonal_path, get_intermediate_path_point
from drawlib.shapes import circle, rectangle
from drawlib.styles import Colors, Styles
from drawlib.text import text

setup(width=120, height=58, dpi=150)

# Left panel: drawlib.images (Dimage pipeline)
rectangle((32, 29), width=52, height=48, style=Styles.Neutral.patch(shape_r=2.0))
text((32, 47.5), "drawlib.images (Dimage)", style=Styles.DarkBold.patch(text_size=11.0))

src_img = Dimage("_assets/python.png")
fx_img = src_img.grayscale()

rectangle((19.5, 28), width=19, height=22, style=Styles.SecondaryNeutral.patch(shape_r=1.5))
image((19.5, 30.5), width=11.5, image=src_img)
text((19.5, 19.8), "Original", style=Styles.Dark.patch(text_size=10.0))

line((29.5, 28), (34.5, 28), arrow_head="->", style=Styles.DarkBold)

rectangle((44.5, 28), width=19, height=22, style=Styles.SecondaryNeutral.patch(shape_r=1.5))
image((44.5, 30.5), width=11.5, image=fx_img)
text((44.5, 19.8), "grayscale()", style=Styles.Dark.patch(text_size=10.0))

text((32, 10.5), "Immutable PIL transforms", style=Styles.Dark.patch(text_size=10.0))

# Right panel: drawlib.math (Orthogonal routing + arc-length midpoint)
rectangle((89, 29), width=50, height=48, style=Styles.SecondaryNeutral.patch(shape_r=2.0))
text((89, 47.5), "drawlib.math (Geometry)", style=Styles.DarkBold.patch(text_size=11.0))

circle(
    (73, 36),
    radius=5.5,
    style=Styles.PrimaryFlat,
    text="A",
    text_style=Styles.WhiteBold.patch(text_size=11.0, text_color=Colors.White),
)
circle(
    (105, 21),
    radius=5.5,
    style=Styles.PrimaryNeutral,
    text="B",
    text_style=Styles.DarkBold.patch(text_size=11.0),
)

waypoints = compute_orthogonal_path((78.5, 36), (99.5, 21), start_side="right", end_side="left")
lines(waypoints, arrow_head="->", style=Styles.DarkBold)

mid_pt = get_intermediate_path_point(waypoints)
circle(mid_pt, radius=2.0, style=Styles.PrimaryFlat)
text((mid_pt[0] + 6.5, mid_pt[1]), "50%", style=Styles.DarkBold.patch(text_size=10.0))
text((89, 10.5), "compute_orthogonal_path()", style=Styles.Dark.patch(text_size=10.0))

save()

classDimage#

PIL.Image.Image をラップし、画像の読み込み・サイズ取得・保存・非破壊エフェクト処理をメソッドチェーンで提供する不変（イミュータブル）クラスです（drawlib.images）。すべての変換メソッドは元の Dimage を変更せず、新しい Dimage インスタンスを返します。

class Dimage:
    def __init__(
        self,
        image: ExistingFilePath | Dimage | Image.Image,
        copy: bool = False,
    ) -> None: ...

コンストラクタ引数#

公開メソッド一覧（全 21 メソッド）#

defget_dimage_from_code(code, timeout=None)#

分離された子プロセス内で Drawlib の Python 描画コード文字列を実行し（コード内の save() は自動的に無視されます）、親プロセスのキャンバス状態やスタイル設定に一切影響を与えずにレンダリング結果を Dimage として取得します（drawlib.images）。

def get_dimage_from_code(
    code: str,
    timeout: float | None = None,
) -> Dimage

defimage(xy, width, image, *, style=None)#

画像ファイルパス・PIL.Image.Image・Dimage を縦横比を維持したままキャンバス上に配置します（drawlib.images）。デフォルト（halign="center", valign="center"）では xy = (cx, cy) が画像の中心アンカーとなります。

def image(
    xy: Coordinate,
    width: PosFloat,
    image: FilePath | Image.Image | Dimage,
    *,
    style: Style | None = None,
) -> None

typeRoutingType#

compute_orthogonal_path() における経路探索モードを表す drawlib.math のリテラル型エイリアスです。

RoutingType = Literal["direct", "orthogonal"]

typeSide#

ノード境界からの出発辺・到着辺を表す drawlib.math のリテラル型エイリアスです。

Side = Literal["left", "right", "top", "bottom"]

defcompute_orthogonal_path(start_pt, end_pt, ...)#

始点 start_pt と終点 end_pt の出入り方向に基づき、直角（マンハッタン）または直線の 2D ポリライン頂点リストを算出します（drawlib.math）。戻り値はそのまま lines() や lines_curved() に渡せます。

def compute_orthogonal_path(
    start_pt: tuple[float, float],
    end_pt: tuple[float, float],
    start_side: Side = "right",
    end_side: Side = "left",
    routing: RoutingType = "orthogonal",
    offset: float = 3.0,
) -> list[tuple[float, float]]

defget_angle(xy1, xy2)#

点 xy1 から点 xy2 へ向かうベクトルの角度を、X 軸正方向（右＝0°、上＝90°）基準の反時計回り度数法 [0.0, 360.0) で算出します（drawlib.math）。

def get_angle(
    xy1: Coordinate,
    xy2: Coordinate,
) -> Angle

defget_center_and_size(xys)#

複数の 2D 座標群 xys を囲む外接矩形（バウンディングボックス）の中心座標 (cx, cy) とサイズ (width, height) を算出します（drawlib.math）。複数ノードを囲むグループ枠の自動計算に便利です。

def get_center_and_size(
    xys: Coordinates,
) -> tuple[Coordinate, Coordinate]

defget_distance(xy1, xy2)#

2 点 xy1・xy2 間のユークリッド距離 $\sqrt{(x_2 - x_1)^2 + (y_2 - y_1)^2}$ を算出します（drawlib.math）。

def get_distance(
    xy1: Coordinate,
    xy2: Coordinate,
) -> float

defget_intermediate_path_point(xys)#

複数セグメントからなる折れ線経路 xys の総経路長（弧長）におけるちょうど 50% の中間点座標 (mx, my) を算出します（drawlib.math）。get_intermediate_path_points(xys, num=1)[0] の簡易ラッパーです。

def get_intermediate_path_point(
    xys: Coordinates,
) -> Coordinate

defget_intermediate_path_points(xys, num=1, *, include_ends=False)#

折れ線経路 xys の総経路長を num + 1 等分し、経路上に等間隔で並ぶ num 個の中間座標を返します（drawlib.math）。L 字・U 字経路上のラベル配置やパケット移動アニメーションに最適です。

def get_intermediate_path_points(
    xys: Coordinates,
    num: int = 1,
    *,
    include_ends: bool = False,
) -> Coordinates

defget_intermediate_paths(xys, num=1, *, include_ends=False)#

折れ線経路 xys の総経路長を num + 1 等分し、始点 xys[0] から各ステップの先端まで途中角を保持しながら段階的に伸びる部分ポリラインのリストを返します（drawlib.math）。各要素は必ず 2 点以上を含むため、lines()・lines_curved()・arrow_polyline() にそのまま渡せます。

def get_intermediate_paths(
    xys: Coordinates,
    num: int = 1,
    *,
    include_ends: bool = False,
) -> list[Coordinates]

defget_intermediate_point(xy1, xy2)#

2 点 xy1・xy2 を結ぶ線分の 50% 中点座標 ((x1 + x2) / 2, (y1 + y2) / 2) を算出します（drawlib.math）。

def get_intermediate_point(
    xy1: Coordinate,
    xy2: Coordinate,
) -> Coordinate

defget_intermediate_points(xy1, xy2, num=1, *, include_ends=False)#

2 点 xy1・xy2 間の線分を num + 1 等分する num 個の内部補間座標リストを算出します（drawlib.math）。

def get_intermediate_points(
    xy1: Coordinate,
    xy2: Coordinate,
    num: int = 1,
    *,
    include_ends: bool = False,
) -> Coordinates

defget_point_on_ellipse(center, width, height, angle)#

中心 center = (cx, cy)、水平幅 width、垂直高さ height の楕円周上における角度 angle（度）の境界座標 (x, y) を算出します（drawlib.math）。

def get_point_on_ellipse(
    center: Coordinate,
    width: float,
    height: float,
    angle: Angle,
) -> Coordinate

defget_rotated_path_points(path_points, center, angle)#

直線頂点および 2 次／3 次ベジェ制御点タプルを含む PathPoints 列全体を、center を中心に反時計回りで angle 度回転させます（drawlib.math）。

def get_rotated_path_points(
    path_points: PathPoints,
    center: Coordinate,
    angle: Angle,
) -> PathPoints

defget_rotated_points(xys, center, angle)#

2D 座標リスト xys の各点を、center を中心として反時計回りに angle 度回転させた新しい座標リストを返します（drawlib.math）。

def get_rotated_points(
    xys: Coordinates,
    center: Coordinate,
    angle: Angle,
) -> Coordinates

defminus_2points(xy1, xy2)#

2 つの 2D 座標の要素ごとの差ベクトル (x1 - x2, y1 - y2) を返します（drawlib.math）。

def minus_2points(
    xy1: Coordinate,
    xy2: Coordinate,
) -> Coordinate

defplus_2points(xy1, xy2)#

2 つの 2D 座標の要素ごとの和ベクトル (x1 + x2, y1 + y2) を返します（drawlib.math）。

def plus_2points(
    xy1: Coordinate,
    xy2: Coordinate,
) -> Coordinate

defrotate_point(xy, angle, center=(0.0, 0.0))#

単一の 2D 座標 xy を center を中心として反時計回りに angle 度回転させた座標を返します（drawlib.math）。

def rotate_point(
    xy: Coordinate,
    angle: Angle,
    center: Coordinate = (0.0, 0.0),
) -> Coordinate