# PaddleOCRLabel #### 介绍 PaddleOCRLabel是基于百度飞桨（PaddleOCR）开发的一款半自动标注平台。 <img src="./images/a1.png" width="800"> #### 快速体验 本项目提供了不需要任何编译工作就可以直接运行的方法。 解压缩根目录下的PaddleOCRLabel-Release-1.0.zip，运行其中的exe文件，可以直接使用。 此时，该exe程序使用的PaddleOCR服务，是作者搭建在一台云服务器上的服务，地址是http://1.117.249.116:5000。 #### 开发所需的先决条件 1. Windows 10系统 2. Visual Studio 2017 3. Python3.7 #### 单独运行（不开发）所需的先决条件 1. Windows 10系统 2. .NET 4.x 3. Python3.7 #### 安装教程 1. 运行python_rest python_rest是一个使用Python Flask编写的Rest服务，调用paddleocr库，获取扫描识别后的文字。（python_rest所用到的Python第三方库请自行安装） 运行命令： cd python_rest python rest.py python_rest服务可以运行在本机，默认会在本机启动一个http://127.0.0.1:5000的服务。 python_rest服务也可以运行在另一台linux服务器上。点击COR自动标注软件的菜单“设置”->“设置代理”中，把代理服务器的地址，配置为linux服务器的ip和端口即可。 <img src="./images/a3.png" width="400"> 2. 运行paddle_ocrlabel项目 使用Visual Studio 2017打开paddle_ocrlabel目录下的paddle_ocrlabel.sln即可。 3. 不使用Visual Studio 2017，直接运行paddle_ocrlabel 解压缩PaddleOCRLabel-Release-1.0.zip，运行paddle_ocrlabel.exe即可 #### python_rest服务列表 python_rest目前支持三个服务： 1. http://127.0.0.1:5000/detect [POST]输入参数为图片本地的路径，只返回检测区域 2. http://127.0.0.1:5000/recognition [POST]输入参数为图片本地的路径,返回检测区域和识别文本 3. http://127.0.0.1:5000/regregion [POST]输入参数为图片本地的路径和局部区域的坐标，返回这个局部区域的识别文本 #### 使用说明 1. 点击软件左上角的“打开目录”按钮，打开要标注的图片所在的目录。 2. 点击软件左下角的某张图片，点击“单张标注按钮”，对该图片进行标注。 3. 点击软件左上角的“全部标注按钮”，对该目录下的所有图片进行标注。 4. 点击标注按钮后，获取到的标注区域，会显示在图片上为蓝色边框的矩形框，并自动保存在本地。 5. 软件中间的标注区域，虚线为安全区域分界线，手动标注只能在安全区域内进行。 6. 对服务返回的标注结果不满意？可以手动标注，包括以下几个步骤： 6.1) 点击软件右上角的“启动矩形标注”按钮，然后就可以在软件中间的标注区域，用鼠标圈选区域了。新选的区域的边框为橙色。同时，会在软件左下角的标注区域的列表中新增一个条目，显示新增标注区域的坐标。 6.2) 点击软件右上角的“重新识别选中区域”按钮，会调用python_rest服务，返回该区域的文字，显示在软件左下角的标注区域的列表中。 6.3）软件也支持四点标注功能，点击“启动四点标注”按钮，先后在图片上点击四个点，就显示出一个橙色区域，然后点击“重新识别选中区域”按钮，识别橙色区域中的文字。 <img src="./images/a4.png" width="300"> 7. 对于返回的识别区域的坐标和文字，显示在软件左下角的标注区域的列表中。有两种排序方式，一种是通用的横排版书籍（自上而下，从左到右），另一种是竖排版的古籍（从右到左，自上而下），可以灵活切换。 8. 对于手动标注和重新识别文字的结果，可以保存至本地，点击软件右上角的“保存标注”按钮即可，也可以使用快捷键Ctrl+S。 9. 手动标注过程中，支持回滚操作，点击软件右上角的“撤销标注”按钮即可，也可以使用快捷键Ctrl+Z。回滚支持以下操作： 9.1）新增矩形标注 9.2）新增四点标注 9.3）删除标注 9.4）移动标注位置 9.5）重新ocr识别后改变文本内容 9.6）手动修改文本内容 10. 软件左上角的的单选框，默认选中“只检测文字区域”，这样python_rest服务只返回检测到的区域的坐标，而不进行文字识别，这样很快就能返回结果。如果选择“检测区域，并识别文字”，则python_rest服务不光返回区域的坐标，还会返回识别的文字，接口速度要比前面的慢一些。 11. 标注区域支持选中和移动功能。用鼠标选中某个标注区域，该区域的边框会变为红色，可以使用鼠标移动到另一个区域。 12. 点击标注区域，可以看到标注的四角都有一个小矩形框，拖拽小矩形框，可以改变标注区域的形状。 12. 标注区域支持删除功能，用鼠标选中某个标注区域，按删除键即可删除之。 13. 双击右下角的标注列表的某个节点，会弹出修改标注内容的对话框。 14. 软件左边的“到处该目录下所有标注”，可以把该目录下所有图片的标注内容，导出为一个log格式的文件，以供PaddleOCR训练时作为训练数据使用。 #### 待完善的功能点 1. 图片的放大和缩小 2. python_rest服务支持多线程 3. 移动标注区域时，会把标注区域移动到安全区域之外。 #### 参与贡献 1. 希望小伙伴们加入到paddle_ocrlabel标注平台的开发和建设中。