assistsx-js 0.1.41 → 0.2.0

package/dist/imageutils/image-utils.d.ts

@@ -1,442 +0,0 @@
-/**
- * 图片尺寸信息
- */
-export interface ImageSize {
-    filePath: string;
-    width: number;
-    height: number;
-}
-/**
- * 图片类型信息
- */
-export interface ImageType {
-    filePath: string;
-    imageType: string;
-}
-/**
- * 图片旋转角度信息
- */
-export interface ImageRotateDegree {
-    filePath: string;
-    degree: number;
-}
-/**
- * 图片处理结果
- */
-export interface ImageProcessResult {
-    filePath: string;
-}
-/**
- * 图片保存结果
- */
-export interface ImageSaveResult {
-    success: boolean;
-    filePath: string;
-}
-export declare class ImageUtils {
-    /**
-     * 执行异步调用
-     * @param method 方法名
-     * @param args 参数对象
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns Promise<调用响应>
-     */
-    private asyncCall;
-    /**
-     * 获取图片尺寸
-     * @param imagePath 图片路径
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns Promise<图片尺寸信息>
-     */
-    getSize(imagePath: string, timeout?: number): Promise<ImageSize>;
-    /**
-     * 获取图片类型
-     * @param imagePath 图片路径
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns Promise<图片类型信息>
-     */
-    getImageType(imagePath: string, timeout?: number): Promise<ImageType>;
-    /**
-     * 判断是否为图片
-     * @param fileName 文件名
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns Promise<是否为图片>
-     */
-    isImage(fileName: string, timeout?: number): Promise<boolean>;
-    /**
-     * 获取图片旋转角度
-     * @param imagePath 图片路径
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns Promise<图片旋转角度信息>
-     */
-    getRotateDegree(imagePath: string, timeout?: number): Promise<ImageRotateDegree>;
-    /**
-     * 缩放图片
-     * @param imagePath 图片路径
-     * @param options 缩放选项
-     * @param options.scaleWidth 缩放宽度（可选）
-     * @param options.scaleHeight 缩放高度（可选）
-     * @param options.savePath 保存路径（可选）
-     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认"PNG"
-     * @param options.timeout 超时时间(秒)，默认30秒
-     * @returns Promise<处理后的图片路径>
-     */
-    scale(imagePath: string, options?: {
-        scaleWidth?: number;
-        scaleHeight?: number;
-        savePath?: string;
-        format?: "PNG" | "JPEG" | "JPG" | "WEBP";
-        timeout?: number;
-    }): Promise<string>;
-    /**
-     * 裁剪图片
-     * @param imagePath 图片路径
-     * @param options 裁剪选项
-     * @param options.x 起始X坐标，默认0
-     * @param options.y 起始Y坐标，默认0
-     * @param options.width 裁剪宽度（可选，不提供则裁剪到图片右边界）
-     * @param options.height 裁剪高度（可选，不提供则裁剪到图片下边界）
-     * @param options.savePath 保存路径（可选）
-     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认"PNG"
-     * @param options.timeout 超时时间(秒)，默认30秒
-     * @returns Promise<处理后的图片路径>
-     */
-    clip(imagePath: string, options?: {
-        x?: number;
-        y?: number;
-        width?: number;
-        height?: number;
-        savePath?: string;
-        format?: "PNG" | "JPEG" | "JPG" | "WEBP";
-        timeout?: number;
-    }): Promise<string>;
-    /**
-     * 倾斜图片
-     * @param imagePath 图片路径
-     * @param options 倾斜选项
-     * @param options.kx X轴倾斜系数，默认0
-     * @param options.ky Y轴倾斜系数，默认0
-     * @param options.px X轴倾斜点（可选）
-     * @param options.py Y轴倾斜点（可选）
-     * @param options.savePath 保存路径（可选）
-     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认"PNG"
-     * @param options.timeout 超时时间(秒)，默认30秒
-     * @returns Promise<处理后的图片路径>
-     */
-    skew(imagePath: string, options?: {
-        kx?: number;
-        ky?: number;
-        px?: number;
-        py?: number;
-        savePath?: string;
-        format?: "PNG" | "JPEG" | "JPG" | "WEBP";
-        timeout?: number;
-    }): Promise<string>;
-    /**
-     * 旋转图片
-     * @param imagePath 图片路径
-     * @param options 旋转选项
-     * @param options.degree 旋转角度，默认0
-     * @param options.px 旋转中心X坐标（可选）
-     * @param options.py 旋转中心Y坐标（可选）
-     * @param options.savePath 保存路径（可选）
-     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认"PNG"
-     * @param options.timeout 超时时间(秒)，默认30秒
-     * @returns Promise<处理后的图片路径>
-     */
-    rotate(imagePath: string, options?: {
-        degree?: number;
-        px?: number;
-        py?: number;
-        savePath?: string;
-        format?: "PNG" | "JPEG" | "JPG" | "WEBP";
-        timeout?: number;
-    }): Promise<string>;
-    /**
-     * 转为圆形图片
-     * @param imagePath 图片路径
-     * @param options 选项
-     * @param options.savePath 保存路径（可选）
-     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认"PNG"
-     * @param options.timeout 超时时间(秒)，默认30秒
-     * @returns Promise<处理后的图片路径>
-     */
-    toRound(imagePath: string, options?: {
-        savePath?: string;
-        format?: "PNG" | "JPEG" | "JPG" | "WEBP";
-        timeout?: number;
-    }): Promise<string>;
-    /**
-     * 转为圆角图片
-     * @param imagePath 图片路径
-     * @param options 选项
-     * @param options.radius 圆角半径，默认0
-     * @param options.savePath 保存路径（可选）
-     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认"PNG"
-     * @param options.timeout 超时时间(秒)，默认30秒
-     * @returns Promise<处理后的图片路径>
-     */
-    toRoundCorner(imagePath: string, options?: {
-        radius?: number;
-        savePath?: string;
-        format?: "PNG" | "JPEG" | "JPG" | "WEBP";
-        timeout?: number;
-    }): Promise<string>;
-    /**
-     * 添加圆角边框
-     * @param imagePath 图片路径
-     * @param options 选项
-     * @param options.borderSize 边框大小，默认0
-     * @param options.color 边框颜色，默认"#000000"
-     * @param options.cornerRadius 圆角半径，默认0
-     * @param options.savePath 保存路径（可选）
-     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认"PNG"
-     * @param options.timeout 超时时间(秒)，默认30秒
-     * @returns Promise<处理后的图片路径>
-     */
-    addCornerBorder(imagePath: string, options?: {
-        borderSize?: number;
-        color?: string;
-        cornerRadius?: number;
-        savePath?: string;
-        format?: "PNG" | "JPEG" | "JPG" | "WEBP";
-        timeout?: number;
-    }): Promise<string>;
-    /**
-     * 添加圆形边框
-     * @param imagePath 图片路径
-     * @param options 选项
-     * @param options.borderSize 边框大小，默认0
-     * @param options.color 边框颜色，默认"#000000"
-     * @param options.savePath 保存路径（可选）
-     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认"PNG"
-     * @param options.timeout 超时时间(秒)，默认30秒
-     * @returns Promise<处理后的图片路径>
-     */
-    addCircleBorder(imagePath: string, options?: {
-        borderSize?: number;
-        color?: string;
-        savePath?: string;
-        format?: "PNG" | "JPEG" | "JPG" | "WEBP";
-        timeout?: number;
-    }): Promise<string>;
-    /**
-     * 添加倒影
-     * @param imagePath 图片路径
-     * @param options 选项
-     * @param options.reflectionHeight 倒影高度，默认0
-     * @param options.savePath 保存路径（可选）
-     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认"PNG"
-     * @param options.timeout 超时时间(秒)，默认30秒
-     * @returns Promise<处理后的图片路径>
-     */
-    addReflection(imagePath: string, options?: {
-        reflectionHeight?: number;
-        savePath?: string;
-        format?: "PNG" | "JPEG" | "JPG" | "WEBP";
-        timeout?: number;
-    }): Promise<string>;
-    /**
-     * 添加文字水印
-     * @param imagePath 图片路径
-     * @param options 选项
-     * @param options.text 水印文字，默认""
-     * @param options.x 文字X坐标，默认0
-     * @param options.y 文字Y坐标，默认0
-     * @param options.color 文字颜色，默认"#000000"
-     * @param options.size 文字大小，默认16
-     * @param options.savePath 保存路径（可选）
-     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认"PNG"
-     * @param options.timeout 超时时间(秒)，默认30秒
-     * @returns Promise<处理后的图片路径>
-     */
-    addTextWatermark(imagePath: string, options?: {
-        text?: string;
-        x?: number;
-        y?: number;
-        color?: string;
-        size?: number;
-        savePath?: string;
-        format?: "PNG" | "JPEG" | "JPG" | "WEBP";
-        timeout?: number;
-    }): Promise<string>;
-    /**
-     * 添加图片水印
-     * @param imagePath 图片路径
-     * @param options 选项
-     * @param options.watermarkPath 水印图片路径（必需）
-     * @param options.x 水印X坐标，默认0
-     * @param options.y 水印Y坐标，默认0
-     * @param options.alpha 透明度，默认255
-     * @param options.savePath 保存路径（可选）
-     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认"PNG"
-     * @param options.timeout 超时时间(秒)，默认30秒
-     * @returns Promise<处理后的图片路径>
-     */
-    addImageWatermark(imagePath: string, options: {
-        watermarkPath: string;
-        x?: number;
-        y?: number;
-        alpha?: number;
-        savePath?: string;
-        format?: "PNG" | "JPEG" | "JPG" | "WEBP";
-        timeout?: number;
-    }): Promise<string>;
-    /**
-     * 转为 alpha 位图
-     * @param imagePath 图片路径
-     * @param options 选项
-     * @param options.savePath 保存路径（可选）
-     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认"PNG"
-     * @param options.timeout 超时时间(秒)，默认30秒
-     * @returns Promise<处理后的图片路径>
-     */
-    toAlpha(imagePath: string, options?: {
-        savePath?: string;
-        format?: "PNG" | "JPEG" | "JPG" | "WEBP";
-        timeout?: number;
-    }): Promise<string>;
-    /**
-     * 转为灰度图片
-     * @param imagePath 图片路径
-     * @param options 选项
-     * @param options.savePath 保存路径（可选）
-     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认"PNG"
-     * @param options.timeout 超时时间(秒)，默认30秒
-     * @returns Promise<处理后的图片路径>
-     */
-    toGray(imagePath: string, options?: {
-        savePath?: string;
-        format?: "PNG" | "JPEG" | "JPG" | "WEBP";
-        timeout?: number;
-    }): Promise<string>;
-    /**
-     * 快速模糊
-     * @param imagePath 图片路径
-     * @param options 选项
-     * @param options.radius 模糊半径，默认0
-     * @param options.scale 缩放比例，默认1
-     * @param options.savePath 保存路径（可选）
-     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认"PNG"
-     * @param options.timeout 超时时间(秒)，默认30秒
-     * @returns Promise<处理后的图片路径>
-     */
-    fastBlur(imagePath: string, options?: {
-        radius?: number;
-        scale?: number;
-        savePath?: string;
-        format?: "PNG" | "JPEG" | "JPG" | "WEBP";
-        timeout?: number;
-    }): Promise<string>;
-    /**
-     * RenderScript 模糊
-     * @param imagePath 图片路径
-     * @param options 选项
-     * @param options.radius 模糊半径，默认0
-     * @param options.savePath 保存路径（可选）
-     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认"PNG"
-     * @param options.timeout 超时时间(秒)，默认30秒
-     * @returns Promise<处理后的图片路径>
-     */
-    renderScriptBlur(imagePath: string, options?: {
-        radius?: number;
-        savePath?: string;
-        format?: "PNG" | "JPEG" | "JPG" | "WEBP";
-        timeout?: number;
-    }): Promise<string>;
-    /**
-     * Stack 模糊
-     * @param imagePath 图片路径
-     * @param options 选项
-     * @param options.radius 模糊半径，默认0
-     * @param options.savePath 保存路径（可选）
-     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认"PNG"
-     * @param options.timeout 超时时间(秒)，默认30秒
-     * @returns Promise<处理后的图片路径>
-     */
-    stackBlur(imagePath: string, options?: {
-        radius?: number;
-        savePath?: string;
-        format?: "PNG" | "JPEG" | "JPG" | "WEBP";
-        timeout?: number;
-    }): Promise<string>;
-    /**
-     * 按缩放压缩
-     * @param imagePath 图片路径
-     * @param options 选项
-     * @param options.scaleWidth 缩放宽度（可选）
-     * @param options.scaleHeight 缩放高度（可选）
-     * @param options.savePath 保存路径（可选）
-     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认"PNG"
-     * @param options.timeout 超时时间(秒)，默认30秒
-     * @returns Promise<压缩后的图片路径>
-     */
-    compressByScale(imagePath: string, options?: {
-        scaleWidth?: number;
-        scaleHeight?: number;
-        savePath?: string;
-        format?: "PNG" | "JPEG" | "JPG" | "WEBP";
-        timeout?: number;
-    }): Promise<string>;
-    /**
-     * 按质量压缩
-     * @param imagePath 图片路径
-     * @param options 选项
-     * @param options.quality 压缩质量，0-100，默认100
-     * @param options.format 图片格式，支持 "JPEG"、"PNG"、"WEBP"，默认"JPEG"
-     * @param options.savePath 保存路径（可选）
-     * @param options.timeout 超时时间(秒)，默认30秒
-     * @returns Promise<压缩后的图片路径>
-     */
-    compressByQuality(imagePath: string, options?: {
-        quality?: number;
-        format?: "JPEG" | "PNG" | "WEBP";
-        savePath?: string;
-        timeout?: number;
-    }): Promise<string>;
-    /**
-     * 按采样大小压缩
-     * @param imagePath 图片路径
-     * @param options 选项
-     * @param options.sampleSize 采样大小，默认1
-     * @param options.savePath 保存路径（可选）
-     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认"PNG"
-     * @param options.timeout 超时时间(秒)，默认30秒
-     * @returns Promise<压缩后的图片路径>
-     */
-    compressBySampleSize(imagePath: string, options?: {
-        sampleSize?: number;
-        savePath?: string;
-        format?: "PNG" | "JPEG" | "JPG" | "WEBP";
-        timeout?: number;
-    }): Promise<string>;
-    /**
-     * 保存图片
-     * @param imagePath 图片路径
-     * @param options 选项
-     * @param options.savePath 保存路径（可选，不提供则自动生成）
-     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认"PNG"
-     * @param options.timeout 超时时间(秒)，默认30秒
-     * @returns Promise<保存结果>
-     */
-    save(imagePath: string, options?: {
-        savePath?: string;
-        format?: "PNG" | "JPEG" | "JPG" | "WEBP";
-        timeout?: number;
-    }): Promise<ImageSaveResult>;
-    /**
-     * 保存图片到相册
-     * @param imagePath 图片路径
-     * @param options 选项
-     * @param options.fileName 文件名（可选，不提供则自动生成）
-     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认"PNG"
-     * @param options.timeout 超时时间(秒)，默认30秒
-     * @returns Promise<保存结果>
-     */
-    save2Album(imagePath: string, options?: {
-        fileName?: string;
-        format?: "PNG" | "JPEG" | "JPG" | "WEBP";
-        timeout?: number;
-    }): Promise<ImageSaveResult>;
-}
-export declare const imageUtils: ImageUtils;