https://github.com/rimochan/rimo_utils

莉沫工具箱
https://github.com/rimochan/rimo_utils

Last synced: 7 days ago
JSON representation

莉沫工具箱

• Host: GitHub
• URL: https://github.com/rimochan/rimo_utils
• Owner: RimoChan
• Created: 2020-10-02T11:27:00.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2021-04-11T17:00:47.000Z (over 3 years ago)
• Last Synced: 2024-10-04T07:18:19.755Z (about 1 month ago)
• Language: Python
• Homepage:
• Size: 23.4 KB
• Stars: 10
• Watchers: 2
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

README

        
# 莉沫工具箱

经常用到的一些小代码，原本它们是我的各个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安装，只要——

```bash

pip install rimo-utils

```

然后`from rimo_utils import 什么`就行了。

有一些注意事项: 

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

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

话说真的有人用吗……