经常用到的一些小代码，原本它们是我的各个repo里的重复代码，想了想就整理出来单独做一个repo用来import好了。

• 常用功能

  • rimo_utils.good_open(path, mode='r', encoding=None)
  • 包装原本的open，可以自动识别文本编码。

• cv0

  • OpenCV的包装，解决一些OpenCV里让人不舒服的地方。
  • 包含了cv2原本的所有属性
  • cv0.show(img)
    • cv2.imshow的包装。
    • 不需要设置名字，自带waitKey。
  • cv0.read(img_path)
    • 替代cv2.imread。
    • 解决中文路径读取失败的问题。
    • 在读取失败时不返回None，而是raise
  • cv0.write(img, img_path, param=None)
    • 替代cv2.imwrite
    • 解决中文路径写入失败的问题。
    • 为非np.uint8的图片转换格式。
  • cv0.VideoCapGen(source, size: tuple = None)
    • cv2.VideoCapture的包装
    • 一个生成器
    • 在读取失败时不返回None，而是raise
  • 绘图函数，包括:
    • cv0.circle(img, center, radius, color, thickness=1, lineType=16)
    • cv0.putText(img, text, org, fontFace, fontScale, color, thickness=1, lineType=16, bottomLeftOrigin=False)
    • 替代原本的同名函数。
    • 位置参数(如center)不再受限于tuple类型，内部元素也可以是float。
    • 默认使用带抗锯齿的lineType。

• matrix

  • 齐次座标系的常用变换矩阵
  • matrix.scale(x, y, z)
    • 缩放矩阵
  • matrix.rotate_ax(r, axis: tuple)
    • 绕座标轴旋转矩阵
  • matrix.rotate(angle, v)
    • 旋转矩阵
  • matrix.translate(x, y, z)
    • 平移矩阵
  • matrix.perspective(view_distance)
    • 透视矩阵

• 计时

  • 使用上下文管理器的计时器
  • with 计时.计时(名字=''):
    • 计算with块中的代码执行用时并print
  • with 计时.帧率计(名字=''):
    • 计算with块中的代码帧率
    • 在累积时长每到达3秒时会print一次

• cache

  • 缓存装饰器工具
  • @disk_cache(path)
    • 为函数添加本地硬盘缓存

莉沫工具箱可以直接通过pip安装，只要——

pip install rimo-utils

然后from rimo_utils import 什么就行了。

有一些注意事项:

• 如果你想升级莉沫工具箱，在pip -U的时候遇到了错误，这可能是因为你的pip版本太旧了。

• pip只会帮你装上常用功能的requirements。因为这个仓库安装所有依赖会非常慢，所以你应该在遇到缺依赖的时候再用pip手动安装。

话说真的有人用吗……