# -*- coding: UTF-8 -*-
import poimage


def compress_image(input_file: str, output_file: str, quality: int):
 """压缩图像文件,以减小其文件大小,同时尽量保持视觉质量。

 Args:
 input_file (str): 需要压缩的输入图像文件的路径
 output_file (str): 压缩后的图像文件保存路径
 quality (int): 压缩质量等级,取值范围为 0 到 95。数值越高,表示图像质量越好,但文件体积也越大

 Returns:
 None
 """

 poimage.compress_image(input_file, output_file, quality)


def image2gif():
 """将图像转换为 GIF 格式。

 本函数通过调用 poimage 模块的 image2gif 方法来实现图像到 GIF 格式的转换。
 该方法负责处理图像数据,将其编码为 GIF 格式,并保存或输出转换后的 GIF 文件。

 Returns:
 None
 """
 poimage.image2gif()



# todo:输出文件路径

def add_watermark(file, mark, output_path='./', color="#eaeaea", size=30, opacity=0.35, space=200,
 angle=30):
 """给图片加水印。

 Args:
 file (str): 图片位置
 mark (str): 水印内容
 output_path (str, optional): 输出位置,默认为当前目录
 color (str, optional): 水印颜色,默认为"#eaeaea"
 size (int, optional): 水印大小,默认为30
 opacity (float, optional): 不透明度,0.01~1,默认为0.35
 space (int, optional): 水印间距,默认为200
 angle (int, optional): 水印角度,默认为30

 Returns:
 None
 """
 poimage.add_watermark(file, mark, output_path, color, size, opacity, space, angle)
 # mainImage.add_watermark(file, mark, out, color, size, opacity, space, angle)


# todo:输入文件路径

def img2Cartoon(path, client_api='', client_secret=''):
 """将图片转换为卡通风格。

 本函数通过调用百度的API,将给定路径下的图片转换成卡通风格的图片。客户端的API密钥和密钥秘密用于认证。

 Args:
 path (str): 图片文件的路径
 client_api (str, optional): 客户端的API密钥,默认值为'OVALewIvPyLmiNITnceIhrYf'
 client_secret (str, optional): 客户端的密钥秘密,默认值为'rpBQH8WuXP4ldRQo5tbDkv3t0VgzwvCN'

 Returns:
 None
 """
 # 调用img2Cartoon函数处理图片,参数包括图片路径、API密钥和密钥秘密
 poimage.img2Cartoon(path, client_api, client_secret)



def down4img(url, output_path='.', output_name='down4img', type='jpg'):
 """下载图片并保存到指定路径。

 调用此函数以从给定的URL下载图片,并将其保存在指定的输出路径中。如果没有指定输出路径和名称,将使用默认值。

 Args:
 url (str): 图片的URL地址
 output_path (str, optional): 保存图片的路径,默认为当前目录
 output_name (str, optional): 保存图片时使用的文件名,默认为'down4img'
 type (str, optional): 图片的文件类型,默认为'jpg'

 Returns:
 None
 """
 # 调用poimage模块中的down4img函数执行图片下载和保存操作
 poimage.down4img(url, output_path, output_name, type)


def txt2wordcloud(filename, color="white", result_file="your_wordcloud.png"):
 """根据指定的文本文件生成词云图像。

 Args:
 filename (str): 文本文件的路径
 color (str, optional): 词云的背景颜色,默认为"white"
 result_file (str, optional): 生成的词云图像文件名,默认为"your_wordcloud.png"

 Returns:
 None
 """
 # 调用poimage模块的txt2wordcloud方法生成词云
 poimage.txt2wordcloud(filename, color, result_file)



def pencil4img(input_img, output_path='./', output_name='pencil4img.jpg'):
 """使用pencil4img算法处理图像。

 该函数接受一个输入图像,并将其转换为铅笔画风格的图像。转换后的图像将保存在指定的输出路径下,文件名为output_name。

 Args:
 input_img (str): 输入的图像文件路径
 output_path (str, optional): 输出图像的路径,默认为当前目录
 output_name (str, optional): 转换后的图像文件名,默认为'pencil4img.jpg'

 Returns:
 None
 """
 # 调用poimage库中的pencil4img函数处理图像
 poimage.pencil4img(input_img, output_path, output_name)



def decode_qrcode(qrcode_path):
 """解析二维码。

 Args:
 qrcode_path (str): 二维码图片的路径

 Returns:
 None
 """
 poimage.decode_qrcode(qrcode_path)


def del_watermark(input_image, output_image=r'./del_water_mark.jpg'):
 """从输入的图片中删除水印,并保存处理后的图片到指定路径。

 Args:
 input_image (str): 输入图片的路径,这是需要进行水印删除处理的图片
 output_image (str, optional): 处理后图片的保存路径,默认为当前目录下的'del_water_mark.jpg'

 Returns:
 None
 """
 # 调用poimage库中的del_watermark函数来删除图片中的水印
 poimage.del_watermark(input_image, output_image)