img_tools

图片工具模块。

该模块提供将图片转换为Pymunk物理形状的工具函数，支持透明背景图和实色背景图的智能处理。

Functions

get_normalized_convex_polygons(pixel_array, base_px_width=512.0, target_cell_size=4, img_manim_w=8, img_manim_h=14.22)

从像素数组中提取规范化的凸多边形集合。

该函数通过marchingSquares算法和凸分解，从图片中智能提取 碰撞用的凸多边形。支持透明背景和实色背景的自动识别。

Args:

pixel_array (np.ndarray): 输入图片的像素数组[H, W, C]。 base_width (float, optional): 采样基准宽度，默认为512.0。

用于控制采样精度。

target_cell_size (float, optional): 目标单元格大小，默认为4。

控制marchingSquares的网格密度。

frame_w (float, optional): Manim框架宽度，默认为8。

用于坐标映射。

frame_h (float, optional): Manim框架高度，默认为14.22。

用于坐标映射。

Returns:

list: Manim坐标系中的凸多边形列表，每个多边形为顶点坐标列表。

map_polygons_to_manim(polygons, img_px_w, img_px_h, img_manim_w, img_manim_h)

将像素坐标系中的多边形映射到Manim坐标系。

执行坐标系转换：从图片像素坐标转换为Manim的笛卡尔坐标系。

Args:

polygons (list): 像素坐标系中的多边形列表。 img_w (float): 图片宽度（像素）。 img_h (float): 图片高度（像素）。 frame_w (float): Manim框架宽度。 frame_h (float): Manim框架高度。

Returns:

list: Manim坐标系中的多边形列表。

get_normalized_convex_polygons(pixel_array, base_px_width=512.0, target_cell_size=4, img_manim_w=8, img_manim_h=14.22)

从像素数组中提取规范化的凸多边形集合。

该函数通过marchingSquares算法和凸分解，从图片中智能提取 碰撞用的凸多边形。支持透明背景和实色背景的自动识别。

Args:

pixel_array (np.ndarray): 输入图片的像素数组[H, W, C]。 base_width (float, optional): 采样基准宽度，默认为512.0。

用于控制采样精度。

target_cell_size (float, optional): 目标单元格大小，默认为4。

控制marchingSquares的网格密度。

frame_w (float, optional): Manim框架宽度，默认为8。

用于坐标映射。

frame_h (float, optional): Manim框架高度，默认为14.22。

用于坐标映射。

Returns:

list: Manim坐标系中的凸多边形列表，每个多边形为顶点坐标列表。

map_polygons_to_manim(polygons, img_px_w, img_px_h, img_manim_w, img_manim_h)

将像素坐标系中的多边形映射到Manim坐标系。

执行坐标系转换：从图片像素坐标转换为Manim的笛卡尔坐标系。

Args:

polygons (list): 像素坐标系中的多边形列表。 img_w (float): 图片宽度（像素）。 img_h (float): 图片高度（像素）。 frame_w (float): Manim框架宽度。 frame_h (float): Manim框架高度。

Returns:

list: Manim坐标系中的多边形列表。