ybc_box模块

msgbox( msg, image, audio )

功能

展示一个消息弹框

参数

返回值

点击弹框的 ok 按钮返回字符串'ok'，点击关闭按钮返回 None

例子

import ybc_box

# 消息弹框中只显示文字
ybc_box.msgbox('欢迎来到猿编程！')

# 消息弹框中显示文字和图片
ybc_box.msgbox('欢迎来到猿编程！', 'xiaoyuan.jpg')

# 消息弹框中显示文字和多张图片
ybc_box.msgbox('欢迎来到猿编程！', ['xiaoyuan.jpg', 'ybc.jpg', 'hello.jpg'])

# 消息弹框中显示文字和图片，以及播放音频
ybc_box.msgbox('欢迎来到猿编程！', 'xiaoyuan.jpg', '1.wav')

enterbox( msg, image, title, default )

功能

展示一个输入弹框

参数

返回值

返回在弹框中输入的文本(字符串类型)

例子

import ybc_box

text = ybc_box.enterbox('请输入你想对小猿说的话','1.jpg','title','请输入内容')
print(text)

intbox( msg )

功能

展示一个数字输入弹框

参数

返回值

返回在弹框中输入的数字(整数类型)

例子

import ybc_box

number = ybc_box.intbox('请输入整数')
print(number)

fileopenbox()

功能

展示一个可以选择文件的弹框

参数

title:输入框的标题

返回值

返回用户所选择文件的路径(字符串类型)

例子

import ybc_box

filename = ybc_box.fileopenbox()
print(filename)

passwordbox( msg )

功能

展示一个密码弹框

参数

返回值

返回用户输入的文本(字符串类型)

例子

import ybc_box

pwd = ybc_box.passwordbox('请输入密码：')
print(pwd)

textbox( msg, text )

功能

展示一个文本弹框

参数

返回值

返回弹框中输入区域的内容(字符串类型)

例子

import ybc_box

text = ybc_box.textbox('将下面的单词改为大写','python')
print(text)

buttonbox( msg, choices )

功能

展示一个按钮选择弹框

参数

返回值

返回所选择按钮上显示的内容(字符串类型)

例子

import ybc_box

op = ybc_box.buttonbox('请选择',['A', 'B', 'C'])
print(op)

ynbox( msg )

功能

展示一个确认弹框

参数

返回值

返回True/False(布尔类型)

例子

import ybc_box

choice = ybc_box.ynbox('确认删除？')
print(choice)

choicebox( msg, choices )

功能

展示一个选择弹框

参数

返回值

返回所选择的选项(字符串类型)

例子

import ybc_box

choice = ybc_box.choicebox('请选择', ['A', 'B', 'C'])
print(choice)

codebox( msg, text )

功能

展示一个代码弹框

参数

返回值

返回弹框中输入区域的内容(字符串类型)

例子

import ybc_box

text = ybc_box.codebox('请将下面的单词改为小写', 'PYTHON')
print(text)

multenterbox( msg, fields )

功能

展示一个多行输入弹框

参数

返回值

返回输入区域中的内容(列表类型)

例子

import ybc_box

info = ybc_box.multenterbox('请输入', ['姓名', '年龄', '性别'])
print(info)

multpasswordbox( msg, fields )

功能

展示一个多行密码弹框(最后一个输入区域是密码类型)

参数

返回值

返回输入区域中的内容(列表类型)

例子

import ybc_box

info = ybc_box.multpasswordbox('请输入', ['账号', '密码'])
print(info)

tablebox( msg, datalist, list )

功能

展示一个二维列表表格

参数

返回值

点击弹框的 ok 按钮返回字符串'ok'，点击 Cancel 或关闭按钮返回 None

例子

import ybc_box

res = ybc_box.tablebox('城市pm2.5大全', [['黔西南布依族苗族自治','87'],['上海','47'],['南京','168']],['城市','pm2.5'])
print(res)

ybc_speech模块

speak( text, speaker )

功能

让计算机朗读一段文字

参数

返回值

无

例子

import ybc_speech

ybc_speech.speak('欢迎来到猿编程！')
ybc_speech.speak('欢迎来到猿编程！', 2)

text2voice( text, filename )

功能

将文字转换为音频

参数

返回值

返回音频文件的名字(字符串类型)

例子

import ybc_speech

voice = ybc_speech.text2voice('欢迎来到猿编程！', 'temp.wav')
print(voice)

record( filename, seconds )

功能

录音

参数

返回值

返回音频文件的名字(字符串类型)

例子

import ybc_speech

filename = ybc_speech.record('temp.wav', 10)
print(filename)

voice2text( filename )

功能

将音频转换为文字

参数

返回值

识别的文本内容(字符串类型)

例子

import ybc_speech

text = ybc_speech.voice2text('temp.wav')
print(text)

ybc_face模块

info( filename )

功能

识别图片中人脸的信息

参数

返回值

返回识别出的信息(字符串类型)

例子

import ybc_face

result = ybc_face.info('1.jpg')
print(result)

info_all( filename )

功能

识别图片中所有人脸的信息

参数

返回值

返回识别出的所有人脸信息(字符串类型)

例子

import ybc_face

result = ybc_face.info_all('1.jpg')
print(result)

ps( filename, decoration )

功能

可以对图片中的人脸进行变妆

参数

返回值

返回变妆后的图片的文件名(字符串类型)

例子

import ybc_face

picname = ybc_face.ps('1.jpg', 10)
print(picname)

mofa( filename, model )

功能

可以对图片中的人脸进行魔法融合

参数

返回值

返回魔法融合后的图片的文件名(字符串类型)

例子

import ybc_face

picname = ybc_face.mofa('1.jpg', 2)
print(picname)

gender( filename )

功能

识别图片中人脸的性别

参数

返回值

返回性别信息(字符串类型)

例子

import ybc_face

res = ybc_face.gender('1.jpg')
print(res)

age( filename )

功能

识别图片中人脸的年龄

参数

返回值

返回年龄信息(整数)

例子

import ybc_face

res = ybc_face.age('1.jpg')
print(res)

beauty( filename )

功能

识别图片中人脸的颜值

参数

返回值

返回颜值(整数)

例子

import ybc_face

res = ybc_face.beauty('1.jpg')
print(res)

ybc_camera模块

camera( filename )

功能

调用计算机摄像头进行拍照(按‘q’拍照退出摄像头)

参数

返回值

返回所拍摄照片的名字(字符串类型)

例子

import ybc_camera

picname = ybc_camera.camera()
print(picname)

ybc_food模块

check( filename )

功能

检测图片中的内容是否为美食

参数

返回值

True/False(布尔类型)

例子

import ybc_food

res = ybc_food.check('1.jpg')
print(res)

food( filename )

功能

检测图片中食物的信息

参数

返回值

食物信息(列表+字典类型)

例子

import ybc_food

result = ybc_food.food('1.jpg')
print(result)

food_name( filename )

功能

检测图片中食物的名称

参数

返回值

食物名称(字符串类型)

例子

import ybc_food 

name = ybc_food.food_name('1.jpg')
print(name)

ybc_animal模块

what( filename )

功能

识别图片中动物的种类

参数

返回值

识别出的动物种类(字符串)

例子

import ybc_animal

result = ybc_animal.what('1.jpg')
print(result)

breed( filename )

功能

识别图片中动物的品种

参数

返回值

识别出的动物品种(字符串)

例子

import ybc_animal

result = ybc_animal.breed('1.jpg')
print(result)

desc( filename )

功能

获取图片中动物的描述信息

参数

返回值

返回图片中动物的描述信息(字符串)

例子

import ybc_animal

result = ybc_animal.desc('1.jpg')
print(result)

calendar模块（Python内置模块）

weekday( year, month, day )

功能

获取指定日期是星期几

参数

返回值

星期几数值(0-6整数，0表示星期一、1表示星期二......6表示星期日)

例子

import calendar

res = calendar.weekday(2018, 8, 8)
print(res)

ybc_art模块

text2art( text, font )

功能

生成艺术字

参数

返回值

艺术字(字符串)

例子

import ybc_art

result = ybc_art.text2art('python')
print(result)

result = ybc_art.text2art('python', 'larry3D')
print(result)

text2img( word, char )

功能

输入字符，生成字符画并保存为图片

参数

返回值

在文件列表区保存一张图片 文件名：{时间戳}_art.jpg

例子

import ybc_art

res=ybc_art.text2img('love','*')
print(res)

img2art(filename)

功能

将图片转成字符画

参数

返回值

在文件列表区保存一张图片 文件名：{时间戳}_imgt2art.jpg

例子

import ybc_art as art
import ybc_box as box
  
res = box.enterbox('请输入内容')
if len(res)>0:
    pic = art.img2art('1.jpg')
    print(pic)

ybc_funny模块

xiaohua()

功能

随机生成一则笑话

参数

无

返回值

笑话(字符串类型)

例子

import ybc_funny

text = ybc_funny.xiaohua()
print(text)

miyu_content()

功能

随机生成一条谜语

参数

无

返回值

谜语(字符串类型)

例子

import ybc_funny

question = ybc_funny.miyu_content()
print(question)

miyu_answer( content )

功能

根据输入的谜语，返回谜语的答案

参数

返回值

谜语的答案(字符串类型)

例子

import ybc_funny

question = ybc_funny.miyu_content()
answer = ybc_funny.miyu_answer(question)
print(question)
print(answer)

xiehouyu_content()

功能

随机生成一条歇后语

参数

无

返回值

歇后语(字符串类型)

例子

import ybc_funny

question = ybc_funny.xiehouyu_content()
print(question)

xiehouyu_answer( content )

功能

根据输入的歇后语，返回歇后语的答案

参数

返回值

歇后语的答案(字符串类型)

例子

import ybc_funny

question = ybc_funny.xiehouyu_content()
answer = ybc_funny.xiehouyu_answer(question)
print(question)
print(answer)

jizhuanwan_content()

功能

随机生成一条急转弯

参数

无

返回值

急转弯(字符串类型)

例子

import ybc_funny

question = ybc_funny.jizhuanwan_content()
print(question)

jizhuanwan_answer( content )

功能

根据输入的急转弯，返回急转弯的答案

参数

返回值

急转弯的答案(字符串类型)

例子

import ybc_funny

question = ybc_funny.jizhuanwan_content()
answer = ybc_funny.jizhuanwan_answer(question)
print(question)
print(answer)

raokouling()

功能

随机生成一条绕口令

参数

无

返回值

绕口令(字符串类型)

例子

import ybc_funny

text = ybc_funny.raokouling()
print(text)

os模块（Python内置模块）

system( text )

功能

执行系统命令

参数

返回值

0或1(整数)：0代表执行成功，1代表执行失败

例子

import os

os.system('calc')
os.system('temp.wav')

listdir( path )

功能

获取指定目录中全部内容的名称

参数

返回值

返回一个列表，列表每个元素是指定目录中全部内容的名称

例子

import os

lists = os.listdir('desktop')
print(lists)

remove( path )

功能

删除指定文件

参数

返回值

无

例子

import os

os.remove('desktop/1.jpg')

urllib.request模块（Python内置模块）

urlretrieve( url, filename )

功能

从网络上下载文件

参数

返回值

无

例子

import urllib.request as rq

url = 'https://www.yuanfudao.com/info/emojis/1.gif'
picname = '1.gif'
rq.urlretrieve(url, picname)

ybc_face_ps模块

bianzhuang( filename, biantype )

功能

对图片中的人脸进行变妆

参数

返回值

变妆后的图片的名字(字符串)

例子

import ybc_face_ps
import ybc_box

filename = ybc_face_ps.bianzhuang('1.jpg', '恶魔妆')
ybc_box.msgbox('变妆后的图片', filename)

ronghe( filename, rongtype )

功能

对图片中的人脸进行融合

参数

返回值

融合后的图片的名字(字符串)

例子

import ybc_face_ps
import ybc_box

filename = ybc_face_ps.ronghe('1.jpg', '青春风采')
ybc_box.msgbox('融合后的图片', filename)

bianzhuang_type()

功能

获取所有的变妆类型

参数

无

返回值

返回所有的变妆类型(列表类型)

例子

import ybc_face_ps

models = ybc_face_ps.bianzhuang_type()
print(models)

ronghe_type()

功能

获取所有的融合类型

参数

无

返回值

返回所有的融合类型(列表类型)

例子

import ybc_face_ps

models = ybc_face_ps.ronghe_type()
print(models)

ybc_trans模块

zh2en( text )

功能

汉译英

参数

返回值

翻译后的英文内容(字符串)

例子

import ybc_trans

en = ybc_trans.zh2en('你好')
print(en)

en2zh( text )

功能

英译汉

参数

返回值

翻译后的汉语内容(字符串)

例子

import ybc_trans

zh = ybc_trans.en2zh('hello')
print(zh)

qrcode模块

make( data )

功能

生成二维码对象

参数

返回值

二维码对象

例子

import qrcode

obj = qrcode.make('I love Python')
print(obj)

二维码对象.save( filename )

功能

将二维码保存为图片

参数

返回值

无

例子

import qrcode

obj = qrcode.make('I love Python')
obj.save('1.jpg')

二维码对象.show()

功能

展示二维码

参数

无

返回值

无

例子

import qrcode

obj = qrcode.make('I love Python')
obj.save('1.jpg')
obj.show()

qrdecode模块

decode( filename )

功能

识别二维码中的内容

参数

返回值

识别出的信息(字符串类型)

例子

import qrdecode

text = qrdecode.decode('1.jpg')
print(text)

random模块（Python内置模块）

randint( a, b )

功能

随机返回[a, b]范围内的一个整数

参数

返回值

随机返回[a, b]范围内的一个整数(范围包括a和b)

例子

import random

num = random.randint(1, 10)
print(num)

choice( seq )

功能

随机选取字符串/列表/元组中的一个元素

参数

返回值

字符串/列表/元组中的一个随机元素

例子

import random

num = random.choice([1,2,3,4,5])
print(num)

time模块

ctime(sec)

功能

把一个时间戳（按秒计算的浮点数）转化为可读的形式。如果参数未给或者为None的时候，将当前时间戳默认为参数。

参数

sec:要转换为字符串时间的秒数（可省略）

返回值

无

例子

import time

res = time.ctime()
print(res)

ybc_carbrand模块

brands()

功能

获取汽车品牌

参数

无

返回值

返回汽车品牌(列表类型)

例子

import ybc_carbrand

result = ybc_carbrand.brands()
print(result)

ybc_pic_search模块

pic_search( keyword, total )

功能

批量下载图片

参数

返回值

无

例子

import ybc_pic_search

ybc_pic_search.pic_search('熊猫', 5)

ybc_china模块

provinces()

功能

获取中国所有的省份

参数

无

返回值

中国所有的省份(列表类型)

例子

import ybc_china

result = ybc_china.provinces()
print(result)

cities( province )

功能

获取指定省份下的所有城市

参数

返回值

指定省份下的所有城市(列表类型)

例子

import ybc_china

result = ybc_china.cities('云南')
print(result)

all_cities()

功能

获取中国所有的城市

参数

无

返回值

中国所有的城市(列表类型)

例子

import ybc_china

cities = ybc_china.all_cities()
print(cities)

ybc_descpic模块

desc( filename )

功能

描述图片中的内容

参数

返回值

返回图片的描述信息(字符串类型)

例子

import ybc_descpic

info = ybc_descpic.desc('1.jpg')
print(info)

ybc_news模块

channels()

功能

获取新闻分类

参数

无

返回值

新闻分类(列表类型)

例子

import ybc_news

result = ybc_news.channels()
print(result)

news( channel )

功能

获取指定分类的新闻

参数

返回值

指定分类的新闻(二维列表)

例子

import ybc_news

result = ybc_news.news('头条')
print(result)

ybc_weather模块

today( cityname )

功能

获取指定城市的当前天气

参数

返回值

指定城市的当前天气(列表类型)

例子

import ybc_weather

result = ybc_weather.today('上海')
print(result)

week( cityname )

功能

获取指定城市的一周天气

参数

返回值

指定城市的一周天气(二维列表)

例子

import ybc_weather

result = ybc_weather.week('成都')
print(result)

ybc_table模块

table( data )

功能

制作表格

参数

返回值

表格(字符串类型)

例子

import ybc_table

result = ybc_table.table([['姓名','性别','年龄'],
                          ['小明','男','12'],
                          ['小红','女','11']])
print(result)

ybc_pinyin模块

pin( text )

功能

生成汉字的拼音(带音标)

参数

返回值

汉字的拼音，带音标(字符串类型)

例子

import ybc_pinyin

result = ybc_pinyin.pin('小猿')
print(result)

pin1( text )

功能

生成汉字的拼音(不带音标)

参数

返回值

汉字的拼音，不带音标(字符串类型)

例子

import ybc_pinyin

result = ybc_pinyin.pin1('小猿')
print(result)

json模块

dumps( text )

功能

将参数内容进行编码

参数

返回值

经过编码后的内容（字符串类型）

例子

from json

res = json.dumps({'猿辅导'：'https://www.yuanfudao.com'})
print(res)

loads( text )

功能

将参数内容进行解码

参数

返回值

经过解码后的内容（字符串类型）

例子

from json

res = json.loads('{"\u733f\u8f85\u5bfc":"https://www.yuanfudao.com"}')
print(res)

pillow库中的Image模块

open( fp )

功能

打开图片文件

参数

返回值

图片对象

例子

from PIL import Image

img = Image.open('1.jpg')
img.show()

图片对象的一些属性

图片对象.resize( size )

功能

缩放图片

参数

返回值

缩放后的图片对象

例子

from PIL import Image

img = Image.open('1.jpg')
new_img = img.resize((500,500))
new_img.show()

图片对象.rotate( angle )

功能

逆时针旋转图片

参数

返回值

旋转后的图片对象

例子

from PIL import Image

img = Image.open('1.jpg')
new_img = img.rotate(45)
new_img.show()

new( mode, size, color )

功能

创建画布对象

参数

返回值

画布对象

例子

from PIL import Image

img = Image.new('RGB',(200,60),(70,130,180))
img.show()

图片对象.show()

功能

显示画布

参数

无

返回值

无

例子

from PIL import Image

img = Image.new('RGB',(200,60),(70,130,180))
img.show()

图片对象.save( fp )

功能

将画布保存为图片

参数

返回值

无

例子

from PIL import Image

img = Image.new('RGB',(200,60),(70,130,180))
img.save('1.jpg')

pillow库中的ImageDraw模块

Draw( im )

功能

在画布上创建画笔

参数

返回值

画笔对象

例子

from PIL import Image
from PIL import ImageDraw

img = Image.new('RGB',(200,60),(0,0,0))
draw = ImageDraw.Draw(img)
draw.text([20,20],'Python')
img.show()

画笔对象.text( xy, text, fill, font )

功能

在画布绘制文字

参数

返回值

无

例子

from PIL import Image
from PIL import ImageDraw
from PIL import ImageFont

img = Image.new('RGB',(200,60),(255,255,255))
draw = ImageDraw.Draw(img)
font = ImageFont.truetype('msyhl.ttc',36)
draw.text([10,10],'Python',(135,222,255),font)
img.show()

pillow库中的ImageFont模块

truetype( font, size )

功能

创建字体格式

参数

返回值

字体格式对象

例子

from PIL import Image
from PIL import ImageDraw
from PIL import ImageFont

img = Image.new('RGB',(200,60),(255,255,255))
draw = ImageDraw.Draw(img)
font = ImageFont.truetype('msyhl.ttc',36)
draw.text([10,10],'Python',(135,222,255),font)
img.show()

ybc_tel模块

detail( tel )

功能

获取手机号码的信息

参数

返回值

手机号码的信息(字典类型)

例子

import ybc_tel

result = ybc_tel.detail(13800138000)
print(result)

ybc_wordcloud模块

cut( text )

功能

对一段文本进行分词

参数

返回值

分词后的词语(列表类型)

例子

import ybc_wordcloud

words = ybc_wordcloud.cut('欢迎来到猿编程')
print(words)

wordcloud( text, bgfile )

功能

根据传入的文本生成词云图片

参数

返回值

词云图片对象

例子

import ybc_wordcloud

words = ybc_wordcloud.cut('欢迎来到猿编程')
img = ybc_wordcloud.wordcloud(words, '背景.jpg')
img.show('1.jpg')

ybc_pminfo模块

pm25( city )

功能

获取指定城市的pm2.5信息

参数

返回值

指定城市的pm2.5信息(字典类型)

例子

import ybc_pminfo

data = ybc_pminfo.pm25('北京')
print(data)

ybc_idcard_ocr模块

idcard_info( filename )

功能

识别身份证中的信息

参数

返回值

识别成功返回身份证中的信息(字典类型)，失败返回-1

例子

import ybc_idcard_ocr

result = ybc_idcard_ocr.idcard_info('1.jpg')
print(result)

ybc_idiom模块

meaning( keyword )

功能

获取成语的详细解释

参数

返回值

查询成功返回成语的详细解释(字典类型)，失败返回-1

例子

import ybc_idiom

result = ybc_idiom.meaning('一心一意')
print(result)

search( keyword )

功能

按关键字查询成语

参数

返回值

查询成功返回包含该关键字的成语(列表类型)，失败返回-1

例子

import ybc_idiom

result = ybc_idiom.search('一')
print(result)

ybc_bot模块

chat( text )

功能

与智能机器人对话

参数

返回值

返回智能机器人的回答(字符串)

例子

import ybc_bot

result = ybc_bot.chat('北京的天气')
print(result)

ybc_browser模块

open_browser( text )

功能

打开指定名称的网站

参数

返回值

无

例子

import ybc_browser

ybc_browser.open_browser('xiaoyuan')
ybc_browser.open_browser('猿辅导')

ybc_scene模块

scene_recog( filename )

功能

识别图片中的场景信息

参数

返回值

识别成功返回图片中的场景信息(列表+字典形式)，失败返回-1

例子

import ybc_scene

result = ybc_scene.scene_recog('1.jpg')
print(result)

object_recog( filename )

功能

识别图片中的物体信息

参数

返回值

识别成功返回图片中的物体信息(列表+字典形式)，失败返回-1

例子

import ybc_scene

result = ybc_scene.object_recog('1.jpg')
print(result)

matplotlib.pyplot模块

figure( figsize )

功能

新建一个图板对象

参数

返回值

无

例子

import matplotlib.pyplot as plt

plt.figure(figsize = (12,7))

bar( x, height, width )

功能

绘制条形统计图

参数

返回值

无

例子

import matplotlib.pyplot as plt
import ybc_box as box

plt.figure(figsize = (12,7))
plt.bar(('football','basketball','volleyball'),(10,31,34),0.5)
plt.savefig('1.jpg')
box.msgbox('hello','1.jpg')

pie( x, labels, textprops, colors, autopct )

功能

绘制扇形统计图

参数

返回值

无

例子

import matplotlib.pyplot as plt
import ybc_box as box

plt.figure(figsize = (12,7))
plt.pie(x = [10,20,10],
        labels = ['A','B','C'],
        textprops = {'fontsize':20},
        colors = ['blue','orange','yellow'],
        autopct = '%.1f%%')
plt.savefig('1.jpg')
box.msgbox('hello','1.jpg')

设置中文字体

plt.rcParams['font.family'] = 'SimHei'

xticks( fontsize ) 和 yticks( fontsize )

功能

分别用于设置x和y轴上的刻度

参数

返回值

无

例子

import matplotlib.pyplot as plt
import ybc_box as box

plt.figure(figsize = (12,7))
plt.bar(('football','basketball','volleyball'),(10,31,34),0.5)
plt.xticks(fontsize = 20)
plt.yticks(fontsize = 20)
plt.savefig('1.jpg')
box.msgbox('hello','1.jpg')

savefig( fname )

功能

将绘制后的图表保存为图片

参数

返回值

无

例子

import matplotlib.pyplot as plt
import ybc_box as box

plt.figure(figsize = (12,7))
plt.bar(('football','basketball','volleyball'),(10,31,34),0.5)
plt.xticks(fontsize = 20)
plt.savefig('1.jpg')
box.msgbox('hello','1.jpg')

title( label, fontsize )

功能

为绘制的图表添加标题

参数

返回值

无

例子

import matplotlib.pyplot as plt
import ybc_box as box

plt.figure(figsize = (12,7))
plt.bar(('football','basketball','volleyball'),(10,31,34),0.5)
plt.xticks(fontsize = 20)
plt.yticks(fontsize = 20)
plt.title('BALL', fontsize = 20)
plt.savefig('1.jpg')
box.msgbox('hello','1.jpg')

xlabel( xlabel, fontsize ) 和 ylabel( ylabel, fontsize )

功能

分别用于设置x和y轴的标签

参数

返回值

无

例子

import matplotlib.pyplot as plt
import ybc_box as box

plt.figure(figsize = (12,7))
plt.bar(('football','basketball','volleyball'),(10,31,34),0.5)
plt.xticks(fontsize = 20)
plt.yticks(fontsize = 20)
plt.xlabel('category',fontsize = 20)
plt.ylabel('quantity',fontsize = 20)
plt.title('BALL', fontsize = 20)
plt.savefig('1.jpg')
box.msgbox('hello','1.jpg')

text( x, y, s, fontsize, ha )

功能

在图表的指定位置添加文本

参数

返回值

无

例子

import matplotlib.pyplot as plt
import ybc_box as box

plt.figure(figsize = (12,7))
plt.bar(('football','basketball','volleyball'),(10,31,34),0.5)
plt.xticks(fontsize = 20)
plt.yticks(fontsize = 20)
plt.xlabel('category',fontsize = 20)
plt.ylabel('quantity',fontsize = 20)
plt.text(0,10,10,fontsize = 20,ha = 'center')
plt.savefig('1.jpg')
box.msgbox('hello','1.jpg')

ybc_namecard模块

namecard_info( filename )

功能

识别名片的信息

参数

返回值

识别成功返回名片信息(字典类型)，失败返回-1

例子

import ybc_namecard

result = ybc_namecard.namecard_info('1.jpg')
print(result)

openpyxl模块

Workbook()

功能

创建Excel文件对象

参数

无

返回值

返回一个Excel文件对象

例子

import openpyxl

wb = openpyxl.Workbook()
wb.save('test.xlsx')

表单对象.cell( row, column )

功能

获取单元格对象

参数

返回值

返回一个单元格对象

例子

import openpyxl

wb = openpyxl.Workbook()
sheet = wb.active
cell_1 = sheet.cell(row = 1,column = 1)
cell_1.value = 'xiaoyuan'
wb.save('test.xlsx')

Excel文件对象.save( filename )

功能

保存Excel文件

参数

返回值

无

例子

import openpyxl

wb = openpyxl.Workbook()
sheet = wb.active
cell_1 = sheet.cell(row = 1,column = 1)
cell_1.value = 'xiaoyuan'
wb.save('test.xlsx')

load_workbook( filename )

功能

打开一个已经存在的Excel文件

参数

返回值

Excel文件对象

例子

import openpyxl

wb = openpyxl.load_workbook('test.xlsx')
sheet = wb.active
cell_1 = sheet.cell(row = 1,column = 1)
print(cell_1.value)

Excel文件对象.get_sheet_by_name( name )

功能

获取指定名字的表单对象

参数

返回值

指定名字的表单对象

例子

import openpyxl

wb = openpyxl.load_workbook('test.xlsx')
sheet = wb.get_sheet_by_name('Sheet')
cell_1 = sheet.cell(row = 1,column = 1)
print(cell_1.value)

一些属性

获取默认表单对象(第一个)

sheet = Excel文件对象.active

获取和设置表单名字

通过表单对象的title属性即可获取该表单的名字：表单对象.title
为表单对象的title赋值即可为该表单重新命名：表单对象.title = '表单一'

获取和设置单元格的值

通过单元格对象的value属性可获取该单元格的值：单元格对象.value
为单元格对象的value属性赋值可设置该单元格的值：单元格对象.value = 'xiaoyuan'

获取表单的最大行数

通过表单对象的max_row属性可以获取表单的最大行数：表单对象.max_row

wxpy模块

Bot()

功能

实例化(创建)微信对象

参数

无

返回值

返回一个微信对象

例子

import wxpy

bot = wxpy.Bot()

微信对象.friends()

功能

获取所有微信好友对象

参数

无

返回值

所有的微信好友对象(列表类型)

例子

import wxpy

bot = wxpy.Bot()
friends_list = bot.friends()
print(friends_list)

微信好友对象列表.search( keywords )

功能

查询指定名称的好友对象

参数

返回值

返回满足指定名称的好友对象列表

例子

import wxpy

bot = wxpy.Bot()
friend = bot.friends().search('小猿')[0]
print(friend)

微信对象.join()

功能

保持程序运行

参数

无

返回值

无

例子

import wxpy

bot = wxpy.Bot()
@bot.register()
def answer(msg):
    msg.reply_image('1.jpg')
bot.embed()

微信对象.logout()

功能

退出当前帐号

参数

无

返回值

无

例子

import wxpy

bot = wxpy.Bot()
friends_list = bot.friends()
print(friends_list)
bot.logout()

一些属性

获取好友的昵称

通过好友对象的name属性可以获取好友的昵称：好友对象.name

获取好友的性别

通过好友对象的sex属性可以获取好友的性别：好友对象.sex

获取好友的省份

通过好友对象的province属性可以获取好友的省份：好友对象.province

获取好友的城市

通过好友对象的city属性可以获取好友的城市：好友对象.city

获取消息的类型

通过消息对象的type属性可以获取消息的类型：消息对象.type

wxpy定义的消息类型

文本类型：wxpy.TEXT
图片类型：wxpy.PICTURE
语音类型：wxpy.RECORDING

获取消息的文本内容

通过消息对象的text属性可以获取消息的文本内容：消息对象.text

获取消息中文件的名称

通过消息对象的file_name属性可以获取消息中文件的名称：消息对象.file_name

获取消息发送者的id

通过消息对象中sender对象的user_name属性可以获取消息发送者的id：消息对象.sender.user_name

获取文件传输助手对象

通过微信对象的file_helper可以获取到文件传输助手对象：微信对象.file_helper

好友对象.send( content )

功能

发送文字消息

参数

返回值

无

例子

import wxpy

bot = wxpy.Bot()
bot.file_helper.send('hello')
bot.logout()

好友对象.send_image( path )

功能

发送图片消息

参数

返回值

无

例子

import wxpy

bot = wxpy.Bot()
bot.file_helper.send_image('1.jpg')
bot.logout()

消息对象.get_file( save_path )

功能

下载消息中的文件

参数

返回值

无

例子

import wxpy

bot = wxpy.Bot()
@bot.register()
def answer(msg):
    msg.get_file('1.jpg')
wxpy.embed()

消息对象.reply( text )

功能

回复文本消息

参数

返回值

无

例子

import wxpy

bot = wxpy.Bot()
@bot.register()
def answer(msg):
    msg.reply('hello')
wxpy.embed()

消息对象.reply_image( filename )

功能

回复图片消息

参数

返回值

无

例子

import wxpy

bot = wxpy.Bot()
@bot.register()
def answer(msg):
    msg.reply_image('1.jpg')
wxpy.embed()

embed()

功能

保持程序运行

参数

无

返回值

无

例子

import wxpy

bot = wxpy.Bot()
@bot.register()
def answer(msg):
    msg.reply_image('1.jpg')
wxpy.embed()

webbrowser模块

open(url)

功能

打开指定网址的网站

参数

返回值

无

例子

import webbrowser

webbrowser.open('https://www.yuanfudao.com')

ybc_coordinate模块

list_provinces()

功能

获取中国的所有省份

参数

无

返回值

返回中国的所有省份(列表类型)

例子

import ybc_coordinate

result = ybc_coordinate.list_provinces()
print(result)

get_coordinate( province, city )

功能

获取指定城市的经纬度

参数

返回值

指定城市的经纬度(列表类型)

例子

import ybc_coordinate

result = ybc_coordinate.get_coordinate('北京','朝阳')
print(result)

ybc_echarts模块

Geo( title, subtitle, title_pos, width, height )

功能

创建一个地图

参数

返回值

地图对象

例子

import ybc_echarts

geo = ybc_echarts.Geo('地图主标题',
                      '地图副标题',
                      title_pos = 'center',
                      width = 1600,
                      height = 800)
print(geo)

地图对象.add( attr, value, geo_cities_coords )

功能

在地图中添加数据

参数

返回值

无

例子

import ybc_echarts

geo = ybc_echarts.Geo('地图主标题',
                      '地图副标题',
                      title_pos = 'center',
                      width = 1600,
                      height = 800)
geo.add(['北京朝阳','吉林长春'],
        [7,2],
        geo_cities_coords = {'北京朝阳':[116.44,39.92],
                             '吉林长春':[125.32,43.9]})
geo.render()

地图对象.render( path )

功能

生成地图图表网页

参数

返回值

无

例子

import ybc_echarts

geo = ybc_echarts.Geo('地图主标题',
                      '地图副标题',
                      title_pos = 'center',
                      width = 1600,
                      height = 800)
geo.add(['北京朝阳','吉林长春'],
        [7,2],
        geo_cities_coords = {'北京朝阳':[116.44,39.92],
                             '吉林长春':[125.32,43.9]})
geo.render('my.html')

ybc_imgcar模块

car_recognition( filename )

功能

识别汽车品牌

参数

返回值

汽车型号(字符串类型)

例子

import ybc_imgcar

result = ybc_imgcar.car_recognition('1.jpg')
print(result)

ybc_switch模块

analysis( filename )

功能

解析微信语音中的内容

参数

返回值

语音文件中的内容(字符串类型)

例子

import ybc_switch

result = ybc_switch.analysis('1.mp3')
print(result)

ybc_player模块

play( filename )

功能

播放音频、视频文件

参数

返回值

无

例子

import ybc_player as player

player.play('test.wav')

ybc_history模块

history_info( month, day )

功能

获取历史上的今天所发生的事件

参数

返回值

历史上的今天发生的事件(字符串类型)

例子

import ybc_history as history

info = history.history_info(1, 3)
print(info)

info2 = history.history_info()
print(info2)

ybc_gesture模块

gesture_recog( filename )

功能

识别图片中的手势

参数

返回值

返回识别出的手势信息

例子

import ybc_gesture

res = ybc_gesture.gesture_recog('1.jpg')
print(res)

ybc_todo模块

todo()

功能

语音控制计算机进行绘画

参数

返回值

无

例子

import ybc_todo as td

td.todo()

ybc_turtle模块

done()

功能

启动事件循环，使窗口停留在界面上

参数

返回值

无

例子

import ybc_turtle

ybc_turtle.done()

forward(pixel)

功能

对象向前移动pixel个像素点

参数

返回值

无

例子

import ybc_turtle

ybc_turtle.forward(100)
ybc_turtle.done()

left(angle)

功能

对象向左旋转angle的角度

参数

返回值

无

例子

import ybc_turtle

ybc_turtle.left(100)
ybc_turtle.done()

right(angle)

功能

对象向右旋转angle的角度

参数

返回值

无

例子

import ybc_turtle

ybc_turtle.right(100)
ybc_turtle.done()

color(color)

功能

设置画笔的颜色

参数

返回值

无

例子

import ybc_turtle

ybc_turtle.color('red')
ybc_turtle.done()

begin_fill()、end_fill()

功能

进行颜色填充

参数

返回值

无

例子

import ybc_turtle

ybc_turtle.color('red')
ybc_turtle.begin_fill()
for i in range(4):
    ybc_turtle.forward(200)
    ybc_turtle.right(90)
ybc_turtle.end_fill()
ybc_turtle.done()

goto(x,y)

功能

将对象移动到指定坐标

参数

返回值

无

例子

import ybc_turtle

ybc_turtle.goto(100,200)
ybc_turtle.done()

penup()、pendown()

功能

将画笔抬起与放下

参数

返回值

无

例子

import ybc_turtle

ybc_turtle.penup()
ybc_turtle.goto(100,200)
ybc_turtle.pendown()
ybc_turtle.done()

ybc_tuya模块

rgb( r, g, b )

功能

定义颜色

参数

返回值

一种颜色

例子

from ybc_tuya import *

fill_rect(10, 20, 220, 230, rgb(12,56,255))

canvas( bg, width, height )

功能

创建画布

参数

返回值

无

例子

import ybc_tuya

ybc_tuya.canvas(ybc_tuya.rgb(221, 244, 206), 800, 600)

fill_rect( x, y, width, height, bg )

功能

绘制一个方形

参数

返回值

无

例子

from ybc_tuya import *

fill_rect(0, 0, 200, 200, rgb(255,165,0))

fill_circle( x, y, size, bg )

功能

绘制一个圆形

参数

返回值

无

例子

from ybc_tuya import *

fill_circle(100, 150, 50, rgb(71,113,96))

ybc_tuya模块中还有一些功能可以绘制完整图案：

snow(rposition,cposition,size,color)

功能

绘制雪花

参数

返回值

无

例子

from ybc_tuya import *

snow(300,200,20,rgb(225,255,225))

collections模块（Python内置模块）

Counter( args )

功能

统计字符串/列表/元组中不同元素的个数

参数

返回值

返回一个统计对象，对象中数据是字典格式，其中键是不同的元素，值是该元素的个数，可以像操作字典一样操作这个统计对象

例子

import collections

res = collections.Counter('hello world')
print(res)

res2 = collections.Counter(['A', 'B', 'C', 'A', 'A', 'C'])
print(res2)

res3 = collections.Counter(('篮球', '足球', '篮球', '排球', '足球', '篮球'))
print(res3)

ybc_poetry模块

shici( title, author )

功能

根据诗词的题目和作者，搜索相应的诗词内容。

参数

返回值

搜索到的诗词内容

例子

import ybc_poetry

text = ybc_poetry.shici('春晓', '孟浩然')
print(text)

ybc_qrcode模块

make( data )

功能

生成二维码对象图片

参数

返回值

二维码对象图片

例子

import ybc_qrcode

obj = ybc_qrcode.make('I love Python')
print(obj)

decode( filename )

功能

识别二维码中的内容

参数

返回值

识别出的信息（字符串类型）

例子

import ybc_qrcode

text = ybc_qrcode.decode('1.jpg')
print(text)

ybc_music模块

search_music( name, ar )

功能

根据歌曲名字和歌手名字下载音乐。

参数

返回值

如果要下载的音乐存在，则会下载音乐，并返回音乐名；

否则返回 -1。

例子

import ybc_music
import ybc_player

song = ybc_music.search_music('外婆的澎湖湾', '潘安邦')
ybc_player.play(song)

ybc_search模块

article_search( keyword )

功能

搜索课文并下载课文文件。

参数

返回值

课文文件名称

例子

import ybc_search

result = ybc_search.article_search('称赞')
print(result)

pic_search( keyword, total )

功能

批量下载图片

参数

返回值

无

例子

import ybc_search

ybc_search.pic_search('熊猫', 5)