PyMuPDF关键词高亮颜色异常：浮点RGB值致颜色不一致

使用PyMuPDF进行关键词高亮时，设置stroke颜色为浮点RGB值(1, 0.5, 0)，期望实现橙色高亮，但部分文字显示橙色、部分偏红，颜色不统一；改为整数RGB值后，高亮颜色完全一致。

代码示例：

annot = page.add_highlight_annot(word)
annot.set_colors(stroke=(1, 0.5, 0))
annot.update()

浮点RGB效果：

整数RGB效果：

这个问题的核心是PyMuPDF对浮点RGB值的处理与PDF阅读器渲染逻辑的兼容性问题：

• PDF规范虽同时支持0-1的浮点RGB和0-255的整数RGB，但部分阅读器在解析浮点值时，会因精度截断、上下文渲染逻辑差异，出现颜色偏差。
• PyMuPDF处理浮点RGB时，内部未做统一的精度对齐（比如0.5可能被转换为127或128），不同文本区域触发的转换逻辑不一致，最终导致高亮颜色不均。
• 改用整数RGB值时，PyMuPDF直接按标准整数格式写入PDF，阅读器无需额外浮点转换，因此颜色渲染完全统一。

• 优先使用0-255范围的整数RGB值设置高亮颜色，彻底避免浮点精度带来的渲染差异。
• 若必须使用浮点值，可手动将浮点值统一转换为整数（如(int(1*255), int(0.5*255), int(0*255))），确保转换逻辑一致。

内容的提问来源于stack exchange，提问作者almosthavoc