README

php 验证码识别库，对非粘连字符识别效果良好，对一般粘连字符也能有较好的识别。支持除噪算法，包括孤立点除杂和连通域除噪；分割算法支持等宽分割、连通域分割以及滴水算法分割。

示例效果

安装

composer require mohuishou/image-ocr

使用方法

示例代码请见 example

使用 docker

docker run --rm -p 8088:8088 mohuishou/image-ocr

点击 https://:8088 查看效果

大致流程：

初始化 -> 灰度化 ---> 二值化 ---> 除噪点 -> 分割 -> 标准化 -> 识别

初始化

对象初始化

$image=new Image($img_path);
$image_ocr=new ImageOCR($image)

初始化二值化阈值

$image_ocr->setMaxGrey(90);
$image_ocr->setMinGrey(10);

初始化标准化图片宽高

$image_ocr->setStandardWidth(13);
$image_ocr->setStandardHeight(20);

开启 Debug

$image_ocr->setDebug(true);

灰度化

try{
    $image_ocr->grey();
}catch (\Exception $e){
    echo $e->getMessage();
}

二值化

注意：这一步需要在灰度化之后执行，否则会抛出错误

try{
    $image_ocr->hash($max_grey=null,$min_grey=null);
}catch (\Exception $e){
    echo $e->getMessage();
}

二值化支持两种方式，第一种$image_ocr->hash($max_grey=null,$min_grey=null)为固定的阈值范围，第二种为hashByBackground($model=self::MAX_MODEL,$max_grey=null,$min_grey=null)，通过背景图像的灰度值动态取阈值，支持三种模式MAX_MODEL、MIN_MODEL、BG_MODEL分别是最大值、最小值和背景模式，最大值模式会用背景的灰度值替换阈值的上限，最小值模式替换下限，背景模式上下限都替换，即为只去除背景

除噪点

前置条件为二值化

孤立点除噪法

try{
    $image_ocr->removeSpots();
}catch (\Exception $e){
    echo $e->getMessage();
}

连通域除噪法

[如果要使用连通域分割法，可以跳过连通域除噪点，分割的同时可以一并除噪]

try{
    //使用之前需要初始化连通域对象
    $image_ocr->setImageConnect();
    //除噪
    $image_ocr->removeSpotsByConnect();
}catch (\Exception $e){
    echo $e->getMessage();
}

分割

非粘连字符串

连通域分割法

try{
    //使用之前需要初始化连通域对象
    $image_ocr->setImageConnect();
    //分割
    $image_ocr->splitByConnect();
}catch (\Exception $e){
    echo $e->getMessage();
}

粘连字符串

滴水算法分割

TODO: 待测试

标准化

try{
    $standard_data=$image_ocr->standard();
}catch (\Exception $e){
    echo $e->getMessage();
}

识别

TODO: 待完善

API

ImageOCR::__construct(Image $image)
ImageOCR::saveImage($path)
ImageOCR::grey()
ImageOCR::hash($max_grey=null,$min_grey=null)
ImageOCR::hashByBackground($model=self::MAX_MODEL,$max_grey=null,$min_grey=null)
ImageOCR::removeSpots()
ImageOCR::removeSpotsByConnect()
ImageOCR::standard()
ImageOCR::setImageConnect()
ImageOCR::setImage(Image $image)
ImageOCR::getStandardData()
ImageOCR::setMaxGrey($max_grey)
ImageOCR::setMinGrey($min_grey)
ImageOCR::setStandardWidth($standard_width)
ImageOCR::setStandardHeight($standard_height)

//ImageTool的方法均为静态方法
ImageTool::removeZero($data)
ImageTool::removeZeroColumn($hash_data)
ImageTool::drawBrowser($data)
ImageTool::transposeAndRemoveZero($hash_data)
ImageTool::hashTranspose($hash_data)
ImageTool::img2hash($img)
ImageTool::hash2img($hash_data,$padding=0)

变更日志

0.2 [2017-4-1]

0.1 [2016-10-7]

默认模板保存方式由数据库改为文件，保存路径为./db/db.json
使用 composer 安装

mohuishou / image-ocr

维护者

详细信息