{"id":18951805,"url":"https://github.com/neteasegame/aircv","last_synced_at":"2025-04-05T18:10:10.898Z","repository":{"id":24750664,"uuid":"28163434","full_name":"NetEaseGame/aircv","owner":"NetEaseGame","description":"Find object position based on python-opencv2","archived":false,"fork":false,"pushed_at":"2021-11-05T04:43:13.000Z","size":5567,"stargazers_count":385,"open_issues_count":4,"forks_count":122,"subscribers_count":36,"default_branch":"master","last_synced_at":"2025-03-29T17:11:48.621Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NetEaseGame.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-12-18T01:35:40.000Z","updated_at":"2025-03-18T02:00:17.000Z","dependencies_parsed_at":"2022-08-03T06:01:26.606Z","dependency_job_id":null,"html_url":"https://github.com/NetEaseGame/aircv","commit_stats":null,"previous_names":["netease/aircv"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NetEaseGame%2Faircv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NetEaseGame%2Faircv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NetEaseGame%2Faircv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NetEaseGame%2Faircv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NetEaseGame","download_url":"https://codeload.github.com/NetEaseGame/aircv/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247378149,"owners_count":20929297,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-08T13:29:31.207Z","updated_at":"2025-04-05T18:10:10.883Z","avatar_url":"https://github.com/NetEaseGame.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# aircv\n[![Build Status](https://travis-ci.org/NetEaseGame/aircv.svg?branch=master)](https://travis-ci.org/NetEaseGame/aircv)\n[![PyPI](https://img.shields.io/pypi/v/aircv.svg)](https://pypi.python.org/pypi/aircv)\n\nFind object position based on python-opencv2 *for python2.7+*\n\n## Usage\n\n    import aircv as ac\n    imsrc = ac.imread('youimage.png') # 原始图像\n    imsch = ac.imread('searched.png') # 带查找的部分\n\n#### SIFT查找图像\n\n    print ac.find_sift(imsrc, imsch)\n    # - when Not found\n    @return None \n    # 之前是返回的 []\n    \n    # - when found\n    @return {'point': (203, 245), 'rectangle': [(160, 24), (161, 66), (270, 66), (269, 24)], 'confidence': 0.09}\n    # point: 查找到的点\n    # rectangle： 目标图像周围四个点的坐标\n    # confidence: 查找图片匹配成功的特征点 除以 总的特征点\n    \n\n#### SIFT多个相同的部分查找\n\n    print ac.find_all_sift(imsrc, imsch, maxcnt = 0)\n    # - when not found\n    @return []\n    # - when found\n    @return [{..}, {..}]\n    # {..}的内容跟SIFT查找到单个图像的格式一样\n\nmaxcnt是可选参数，限制最多匹配的数量。\n\n#### 直接匹配查找图像\n\n    print ac.find_template(imsrc, imsch)\n\n期望输出 (目标图片的中心点，相似度)， 相似度是电脑计算出来的一个值，跟平常所说的相似97%不是一个意思。对于这个值，达到0.999以上才算是图片一样。\n\n    (294, 13), 0.9715\n\n查找多个相同的图片，如在图形\n\n![template1](tests/testdata/2s.png)\n\n中查找\n\n![template2](tests/testdata/2t.png)\n\n    print ac.find_all_template(imsrc, imsch)\n\n期望输出 (目标图片的中心点，相似度)\n\n    [((294, 13), 0.9715), ...]\n\n效果\n\n![2res](tests/testdata/2res.png)\n\n## 开发规范\n[开发规范](docs/DEVELOPMENT.md)\n\n## LICENSE\nLICENCE under [MIT](LICENSE)\n\n## Some other idea. Not implemented\n\n### example\n```python\nimport aircv\n\nimsrc = aircv.Image('demo.png')\nimobj = aircv.Image('object.png')\n\nprint imsrc.find(imobj, method=aircv.FIND_TMPL) # or method=aircv.FIND_SIFT\n# expect aircv.Position(x=10, y=20, extra={'method': aircv.FIND\\_TMPL, 'result': 0.98})\n\nprint imobj.find_in(imsrc, method=aircv.FIND_TMPL)\n# expect aircv.Position(x=10, y=20)\n\nrect = aircv.Rect(left=80, top=10, width=50, height=90)\n# Rect define: Rect(left=0, top=0, right=None, bottom=None, width='100%', height='100%')\npos = imsrc.find(imobj, rect=rect, method=aircv.FIND_TMPL)\nprint pos\n# expect aircv.Position(x=10, y=20)\n\nprint imsrc.draw_point(pos) # .draw_point(pos2)\n# expect aircv.Image object\n\nprint imsrc.draw_rectangle(aircv.Rect(left=80))\n# expect aircv.Image object\n\nprint imsrc.draw_circle(??)\n\nprint imsrc.cv_object\n# expect numpy object\n\nimsrc.save('source.png')\n# An Exception raised when file exists\n\nprint imsrc.rect() == imobj.rect()\n# expect True or False\n\nprint imsrc.percent(imobj)\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneteasegame%2Faircv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fneteasegame%2Faircv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneteasegame%2Faircv/lists"}