简介：这是一套结合数据库与OpenCV的比赛对阵图自动生成方案，面向具备一定C++基础、希望实践数据可视化和图像处理的开发者。项目围绕比赛信息读取、数据预处理、对阵图绘制与自动化更新展开，覆盖参赛队伍存储、轮次划分、胜负颜色标识等常见场景，适合作为课程设计、毕设或工程化项目的参考。压缩包共28个文件，包含matchschedule.cpp、CvxText.cpp等源代码、头文件以及可直接运行的exe程序，并附带simkai.ttf、wqy-zenhei.ttf等字体资源，整体约14.96MB，可在VC6.0环境下打开工程并通过ADO数据库连接获取真实数据。已有1639人学习下载。通过该资源可以掌握OpenCV画线、文字绘制、矩形填充等图形接口，学习FreeType字体渲染中文标题、CvxText封装字体输出等实用技巧；同时可理解如何将数据库查询结果映射到图像坐标，并利用定时流程自动刷新对阵图，为二次开发提供完整代码基础。这套方案把数据库管理与图像输出串联起来，能帮助开发者快速搭建从数据到图形的自动化管线。 前段时间帮朋友做一场线下电竞比赛的赛程海报，需求本身很简单：把16支队伍按单败淘汰规则排成一张清晰的对阵图，打印出来贴在场地旁边。我一开始想用Excel画，结果边框对不齐、字体挤在一起，调了半小时还是歪的；又试过用网页HTML排，样式能看，但导出的图片总有Logo遮挡问题。后来干脆用OpenCV写了个脚本，把对阵图纯粹当成一张图像来绘制，反而一次跑通，效果还挺专业。这篇文章就把这套“OpenCV比赛对阵图自动生成”的思路、代码和踩坑记录完整分享出来，尤其是那些文档里不会告诉你的细节。
这个方案适合谁？如果你需要给电竞比赛、棋类比赛、运动会、甚至公司内部淘汰赛快速生成对阵图，又不想手动排版，那这套用OpenCV程序化绘制的方式值得参考。核心思路是把对阵图抽象成“节点坐标 + 连线 + 文字标注”，让程序自动计算每个选手的坐标位置，再调用OpenCV的绘图API输出高清图片。只要理解了坐标计算逻辑，不管8人、16人还是64人，改一个参数就能跑。
1. 项目整体设计与方案选型
1.1 对阵图到底在“画”什么
先别急着写代码，想清楚对阵图的结构。一个标准的单败淘汰对阵图，本质就是一棵二叉树：第一轮若干场比赛，胜者进入第二轮，第二轮胜者再晋级，直到决出冠军。画图时从左到右推进，每一轮占据一列空间，同一轮的所有比赛垂直均匀分布。
我见过不少人一上来就纠结“怎么连线”，其实连线的本质是坐标计算。每个选手的姓名是一个文本锚点，两条水平线代表一场比赛的对阵双方，竖线把两人连起来，右侧再引出一条线到下一轮。只要把节点坐标算准，OpenCV的cv2.line和cv2.putText足够完成所有绘制工作。
1.2 为什么选择OpenCV而不是HTML、Excel或Matplotlib
对比一圈画图方案后，我最终锁定OpenCV，原因是矩阵操作和绘图API结合得非常好。用HTML画，虽然CSS Flexbox能排布，但导出图片时需要额外工具，而且中文字体、Logo叠加、打印清晰度都不好控制；用Matplotlib画，字体问题少一些，但线条和文本的坐标控制远不如OpenCV直接，而且Matplotlib生成大量线段的性能明显偏慢，控制台还会刷一堆警告。
OpenCV的优势在于：第一，numpy数组本身就是画布，像素级操作自由度高；第二，内置的cv2.line、cv2.rectangle、cv2.circle绘制效率高，批量生成几百条连线毫无压力；第三，配合PIL解决中文字体渲染之后，输出到PNG、PDF都非常方便。对我来说，这是所有方案里代码量最少、可控性最高的。唯一要注意的是OpenCV原生cv2.putText不支持中文，这个问题后面会专门讲。
2. 赛程编排与节点坐标计算
2.1 参赛人数与轮次的数学关系
对阵图绘制前需要先确定比赛轮次。单败淘汰制下，如果有n名选手参赛，需要的轮次是ceil(log2(n))，总比赛场次是n - 1。比如8人参赛就是3轮，16人参赛就是4轮，32人就是5轮。这个公式是后续一切坐标计算的基础，必须先记牢。
但实际比赛中经常出现参赛人数不是2的整数次幂的情况，比如12人、20人。这时就要引入“轮空”（bye）机制：首轮让部分选手直接晋级，剩余选手正常比赛。常见的处理方式是先补充轮空位，让总参赛人数变为2^rounds。在代码里，我会用一个color列表先把选手填进去，不足部分补空字符串，绘制时跳过空字符串即可。
2.2 节点坐标计算的详细推导
当总槽位数（total_slots）确定后，每轮比赛数量也确定了：第r轮的比赛场次等于total_slots / (2^(r+1))。比如16人参赛，第一轮8场比赛，第二轮4场，第三轮2场，决赛1场。
画布布局上，我从左到右分配每轮区域，左侧留80像素边距放选手名字，右侧留200像素边距放冠军标注。round_width是单轮的横向宽度，match_height是当前轮次中每场比赛的垂直跨度。以第一轮为例：
- 第一轮有
total_slots / 2场比赛，每场比赛垂直占用的高度是画布高度 / 比赛场次； - 对于第
m场比赛，它所在的垂直中心线是(m + 0.5) * match_height； - 两名选手的水平线分别位于中心线上方和下方各
match_height / 4的位置。
这里有一个非常关键的细节：cv2.line接收的坐标必须是整数，而除法运算会产生浮点数。如果直接传入浮点数，OpenCV会报类型错误，或者静默截断导致线条错位。我的做法是所有坐标计算后统一套一层int()转换，不要省这一步。
2.3 种子选手与轮空位置的策略
对阵图不只是画线，合理的赛程编排同样重要。传统体育赛事中，种子选手的位置是固定的，目的是让强手尽可能晚地相遇。经典的种子排列方式是“蛇形分布”：比如16人参赛时，种子序号按[1, 16, 9, 8, 5, 12, 13, 4, 3, 14, 11, 6, 7, 10, 15, 2]排列。这样1号种子和2号种子分别位于对阵表两端，只有决赛才可能碰面。
如果你不想手动排列种子，也可以在代码里写一个seeding_position函数，根据选手序号自动计算位置。我这次只是朋友的小型比赛，所以直接用随机打乱加手动指定前几名种子的方式处理。
3. 完整实现：从8人到64人，一份代码跑通
3.1 环境准备与依赖安装
操作前先把环境搭好。我用的是Python 3.9 + OpenCV 4.8，需要额外安装opencv-python和pillow。如果你在安装时遇到ModuleNotFoundError: No module named 'cv2'，多半是没有正确安装opencv-python包，终端执行下面命令即可：
pip install opencv-python pillow如果你用的是Anaconda，也可以执行conda install -c conda-forge opencv，但要注意conda的OpenCV版本可能滞后，某些新API用不了。我个人推荐直接用pip装，干净省事。
中文字体是另一个关键依赖。Windows系统可以用C:/Windows/Fonts/simhei.ttf（黑体），Linux系统可以用/usr/share/fonts/truetype/wqy/wqy-microhei.ttc。如果你没有合适的.ttf字体文件，务必先准备好，否则后续中文文本渲染无法完成。
3.2 核心代码实现
直接上完整代码。我尽量把注释写清楚，方便你直接复制改造。
import cv2 import numpy as np import math from PIL import Image, ImageDraw, ImageFont # 中文字体路径，请根据实际系统修改 FONT_PATH = "C:/Windows/Fonts/simhei.ttf" def draw_text_cn(img, text, pos, font_size=24, color=(0, 0, 0)): """在OpenCV图像上绘制中文文本""" # 将OpenCV的BGR图像转为RGB，再转为PIL Image img_rgb = cv2.cvtColor(img, cv2.COLOR_BGR2RGB) pil_img = Image.fromarray(img_rgb) draw = ImageDraw.Draw(pil_img) font = ImageFont.truetype(FONT_PATH, font_size) draw.text(pos, text, font=font, fill=color) # 转回OpenCV格式 return cv2.cvtColor(np.array(pil_img), cv2.COLOR_RGB2BGR) def generate_bracket(players, img_width=1600, img_height=900): """ 生成单败淘汰对阵图 players: 选手名单列表，按顺序排列 """ n = len(players) rounds = math.ceil(math.log2(n)) total_slots = 2 ** rounds # 补充轮空位 players = players + [""] * (total_slots - n) # 创建白色画布 img = np.ones((img_height, img_width, 3), dtype=np.uint8) * 255 left_margin = 80 right_margin = 200 round_width = (img_width - left_margin - right_margin) / rounds # 逐轮绘制 for r in range(rounds): num_matches = total_slots // (2 ** (r + 1)) match_height = img_height / num_matches x_left = int(left_margin + r * round_width) x_right = int(left_margin + (r + 1) * round_width - 40) for m in range(num_matches): y_center = int((m + 0.5) * match_height) y_a = int(y_center - match_height / 4) y_b = int(y_center + match_height / 4) # 绘制对阵双方水平线 cv2.line(img, (x_left, y_a), (x_right, y_a), (0, 0, 0), 2) cv2.line(img, (x_left, y_b), (x_right, y_b), (0, 0, 0), 2) # 绘制连接两人的竖线 cv2.line(img, (x_right, y_a), (x_right, y_b), (0, 0, 0), 2) # 绘制到下一轮的引线 if r < rounds - 1: cv2.line(img, (x_right, y_center), (x_right + 40, y_center), (0, 0, 0), 2) # 绘制文本（第一轮才显示名字） if r == 0: player_a = players[2 * m] player_b = players[2 * m + 1] img = draw_text_cn(img, player_a, (x_left - 70, y_a - 15), font_size=22) img = draw_text_cn(img, player_b, (x_left - 70, y_b - 15), font_size=22) # 决赛右侧标注冠军 finale_y = img_height // 2 cv2.line(img, (int(left_margin + rounds * round_width - 40), finale_y), (int(left_margin + rounds * round_width + 30), finale_y), (0, 0, 0), 2) img = draw_text_cn(img, "冠军", (int(left_margin + rounds * round_width + 40), finale_y - 15), font_size=28, color=(0, 0, 255)) return img if __name__ == "__main__": # 示例：8名选手 players = ["张三", "李四", "王五", "赵六", "钱七", "孙八", "周九", "吴十"] bracket_img = generate_bracket(players, img_width=1400, img_height=800) cv2.imwrite("bracket.png", bracket_img) print("对阵图已保存为 bracket.png")这段代码跑完之后，会在当前目录生成一张白底黑线的bracket.png，选手姓名在左侧对齐，从第一轮开始向右逐级展开。8人赛3轮，16人赛4轮，逻辑完全一致。
3.3 图形美化和Logo叠加
如果只是画线条和文字，显得有点干巴巴。我的做法是在生成对阵图之后，额外在画布右上角叠加大赛Logo，在底部加主办方信息。叠加Logo用cv2.addWeighted做透明融合，或者直接用cv2.rectangle画一个色块，再把Logo贴上去。
def add_logo(img, logo_path, position=(100, 40), size=(100, 100)): logo = cv2.imread(logo_path) logo = cv2.resize(logo, size) x, y = position img[y:y+size[1], x:x+size[0]] = logo return img注意Logo图片如果是PNG透明背景，直接赋值会把透明通道丢掉。最简单的方式是先把Logo缩放到目标尺寸，再复制到画布对应区域，虽然边缘会有锯齿，但打印出来看不太出来。如果你追求更精细的融合效果，可以用掩膜处理。
4. 实战中的典型问题与排查经验
4.1 中文乱码问题
这是所有OpenCV新手一定绕不过去的坑。直接使用cv2.putText绘制中文，大概率得到一串“？？？”乱码，因为OpenCV内置的cv2.putText只支持Hershey字体，这种字体本身不包含中文字符集。
解决办法就是我在代码中写的：借助PIL库渲染中文，再转换回OpenCV图像。PIL的ImageFont.truetype指定系统中文字体文件，绘制完成后再用cv2.cvtColor把RGB转回BGR，完美显示中文。这个方案唯一的缺点是每次调用draw_text_cn要做一次完整转换，如果文本特别多，稍微有点性能损耗。对于比赛对阵图这种静态图来说，几十个名字毫无压力。
4.2 线条对不齐、出现台阶断层
我自己第一次跑代码时，发现某些竖线没有精确对齐到水平线的端点，看起来像台阶。排查后发现原因是浮点数转整数时的误差。比如x_left + r * round_width在r变化时，由于round_width本身是浮点数，多次累计后可能多出1像素偏差，导致线端点不齐。
解决方式有两个：一是所有坐标计算完成后统一四舍五入，二是把横向坐标全部改用整数计算。比如定义round_width_px = int((img_width - left_margin - right_margin) / rounds)，然后x_left = left_margin + r * round_width_px，这样每个横向坐标都是整数，完全避免浮动误差。
4.3 生成的图片不够清晰
如果你需要打印大幅面海报，默认的1600x900分辨率可能不够。我的建议是：输出分辨率不要低于1920x1080，如果条件允许直接生成3000x2000，打印A2尺寸都够用。OpenCV对分辨率的处理很灵活，单纯的线条和文字不会因为尺寸大而卡顿。
还有一个细节是线条宽度和字体大小要随画幅缩放。3000像素宽的画布如果还用2像素线宽的线条，打印出来会显得很细。我的经验是：画幅宽度每增加1000像素，线条宽度增加1到2像素，字号也同步放大。这个没有固定公式，你有空多试几个模板就知道手感了。
4.4 “比赛结束”高亮显示
如果是对阵图需要实时标记比赛结果，可以用cv2.rectangle在胜者名字后面画一个小色块，或者直接用红色线段覆盖掉败者的连线。我当时给朋友做的版本是：手动维护一个胜者名单，程序读取后自动把败者的后半段连线变成灰色。这个功能本质上还是坐标计算，胜者的晋级路径对应到下一轮的位置，把坐标算准复用前面的逻辑即可。
5. 方案扩展与个人经验
整套方案跑通之后，后面再做类似需求就非常轻松了。我拿到一份报名表就能在30秒内生成一张专业对阵图。后来我把代码稍微封装了一下，改成了从CSV文件读取选手名单，输出后又自动上传到云盘共享给赛事群，效率比人工排版高一个数量级。
给你几个扩展方向参考：如果要做瑞士轮或双败淘汰，需要额外增加一个“败者组”分支，核心思路仍然是坐标计算，只是把竖向空间分成上下两个区域，分别绘制胜者组和败者组的连线；如果要做动态直播用，可以考虑结合cv2.imshow实时展示对阵图，或者输出视频；如果是Web端项目，用cv2.imencode生成base64字符串直接嵌入网页，也是一个很实用的方案。
最后再分享一个小技巧：画布背景可以不是纯白色，把img = np.ones(...) * 255改成其他颜色值，比如浅蓝色(204, 229, 255)，比赛对阵图就变成了赛博风格。这种细节调整成本极低，但整体观感提升非常明显。希望这套OpenCV画对阵图的思路能帮你省下那些手动对齐边框的夜晚。
本文还有配套的精品资源，点击获取
