Metadata-Version: 2.1
Name: PicImageSearch
Version: 0.5.3
Summary: PicImageSearch APIs for Python 3.x 适用于 Python 3 以图搜源整合API
Home-page: https://github.com/kitUIN/PicImageSearch
Author: kitUIN
Author-email: kulujun@gmail.com
License: UNKNOWN
Description: # PicImageSearch
        整合图片识别api,包括SauceNAO,tracemoe,iqdb,ascii2d等
        ## TODO
        - [ ] [SauceNAO]
        - [x] [TraceMoe](https://trace.moe/)
        - [ ] [iqdb]
        - [ ] [ascii2d]
        ### 安装
        - 此包需要 Python 3.6 或更新版本。
        - `pip install PicImageSearch`
        - 或者
        - `pip install PicImageSearch -i https://pypi.tuna.tsinghua.edu.cn/simple`
        
        ### 帮助手册目录
          - SauceNAO
          - [TraceMoe](https://github.com/kitUIN/PicImageSearch#tracemoe)
          - iqdb
          - ascii2d
        ### TraceMoe
        #### 如何开始
        如果是需要查找的是网络url
        ```
        from PicImageSearch import TraceMoe
        
        tracemoe = TraceMoe()
        tracemoe.search('https://trace.moe/img/tinted-good.jpg')
        
        #tracemoe.search(网络地址或本地,是否是本地文件(默认否),搜索限制为特定的 Anilist ID(默认无))
        
        print(tracemoe.raw)
        ```
        如果是需要查找的是本地文件,使用以下语句即可
        ```
        tracemoe.search(r'C:/kitUIN/img/tinted-good.jpg',True)
        ```
        
        返回值储存在上文`tracemoe`  
        详细数据见下表
        |变量              |   内容             |  类型  |
        |----              | ----                   | ----  |
        |.raw              |最匹配项返回结果|dict|
        |.raw_all          |总返回|dict|
        |.raws             |其他返回|dict|
        |.viedo            |视频预览url|str|
        |.thumbnail        |缩略图预览url|str|
        |.RawDocsCount     |搜索的帧总数|int|
        |.RawDocsSearchTime|从数据库检索帧所用的时间|int|
        |.ReRankSearchTime |比较帧所用的时间|int|
        |.CacheHit         |是否缓存搜索结果|bool|
        |.trial            |搜索时间|int|
        |.limit            |剩余搜索限制数|int|
        |.limit_ttl        |限制重置之前的时间（秒）|int|
        |.quota            |剩余搜索配额数|int|
        |.quota_ttl        |配额重置之前的时间（秒）|int|
        | 以下可作为.raws的值  |                 |     |
        |.From             |匹配场景的开始时间|int|
        |.to               |匹配场景的结束时间|int|
        |.anilist_id       |匹配的[Anilist  ID](https://anilist.co/)|int|
        |.at               |匹配场景的确切时间|float|
        |.season           |发布时间|str|
        |.anime            |番剧名字|str|
        |.filename         |找到匹配项的文件名|str|
        |.episode          |估计的匹配的番剧的集数|int|
        |.tokenthumb       |用于生成预览的token|str|
        |.similarity       |相似度，相似性低于 87% 的搜索结果可能是不正确的结果|float|
        |.title            |番剧名字|str|
        |.title_native     |番剧世界命名|str|
        |.title_chinese    |番剧中文命名|str|
        |.title_english    |番剧英文命名|str|
        |.title_romaji     |番剧罗马命名|str|
        |.mal_id           |匹配的[MyAnimelist  ID](https://myanimelist.net/)|int|
        |.synonyms         |备用英文标题|str|
        |.synonyms_chinese |备用中文标题|str|
        |.is_adult         |是否R18|bool|
        
        若是想查看其他搜索返回值可以使用.raws[序号(从0开始)][值(上表)]  
        例如`tracemoe.raws[1]['similarity']`查看第2条的相似度
        
        预览图片/视频下载到本地
        ```
        download_image(tracemoe.thumbnail)#下载图片image.png
        
        #download_image(预览图片url)
        
        download_viedo(tracemoe.viedo)#下载视频video.mp4
        
        #download_viedo(预览视频url)
        
        ```
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
