# @bitpatty/imgproxy-url-builder 中文文档 规范地址：https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/ 版本：2\.1\.0 npm 元数据更新时间：2025-12-09T21:05:21.580Z 中文译文更新时间：2026-11-08T04:39:03.564Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40bitpatty/imgproxy-url-builder 原文对照：https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/?lang=original 项目主页：https://github.com/BitPatty/imgproxy-url-builder#readme 源码仓库：https://github.com/BitPatty/imgproxy-url-builder ## 关键信息（来自 npm 元数据） - 包体积（解压后）：566 kB，86 个文件 - 模块格式：ESM + CJS - TypeScript 类型：包内自带 - 运行依赖：0 个 - 首次发布：2021-10-31T20:11:14.609Z - 最新版本发布：2025-12-09T21:05:21.385Z - 近 30 天下载量：23573（2026-10-08 至 2026-11-06，npm 官方下载统计） - 已发布版本数：35（近 12 个月 1 个） ## 中文简介 用于构建 imgproxy URL 的 TypeScript 帮助库 ## 安装 ```sh npm install @bitpatty/imgproxy-url-builder ``` 也可以使用：`pnpm add @bitpatty/imgproxy-url-builder`、`yarn add @bitpatty/imgproxy-url-builder`、`bun add @bitpatty/imgproxy-url-builder` ## README ![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/BitPatty/imgproxy-url-builder/build.yml?label=Build&style=flat-square) [![Coverage Status](https://img.shields.io/coverallsCoverage/github/BitPatty/imgproxy-url-builder?label=Coverage&style=flat-square)](https://coveralls.io/github/BitPatty/imgproxy-url-builder?branch=master) ![npm](https://img.shields.io/npm/dm/@bitpatty/imgproxy-url-builder?label=Downloads&style=flat-square) # imgproxy-url- 构建器 用于构建的 TypeScript 帮助库 [缩写](https://github.com/imgproxy/imgproxy) URLs (英语). ## 安装 ```sh npm i --save @bitpatty/imgproxy-url-builder ``` ## 使用量 您可以导入参数构建器并链接您的转换 。 关于可用的变换列表,请检查以下各节. ```typescript import pb from '@bitpatty/imgproxy-url-builder'; // Just the transformer params // Returns rot:90/bl:10 pb().rotate(90).blur(10).build(); // The transformer params with the target image // Returns /-/rot:90/bl:10/czM6Ly9teWJ1Y2tldC9teWltYWdlLnBuZw pb().rotate(90).blur(10).build({ path: 's3://mybucket/myimage.png', }); // You can disable path encoding by setting 'plain' to true // Returns /-/rot:90/bl:10/plain/s3://mybucket/myimage.png pb().rotate(90).blur(10).build({ plain: true, path: 's3://mybucket/myimage.png', }); // To sign your URL provide the key and salt // The path is required to sign your URL! // Returns /TXf2QXtZkU-ULvrg0pLDqJlWUb7XdHkXD0h6NFWD-mo/rot:90/bl:10/czM6Ly9teWJ1Y2tldC9teWltYWdlLnBuZw pb() .rotate(90) .blur(10) .build({ path: 's3://mybucket/myimage.png', signature: { key: 'a91bdcda48ce22cd7d8d3a0eda93', salt: 'a91bdcda48ce22cd7d8d3a0eda93', size: 32, // Optional, specify the signature size. Defaults to 32 }, }); // To automatically prepend the imgproxy URL // provide it as the 'baseUrl' setting // Returns https://my-imgproxy-instance.example.com/-/rot:90/bl:10/czM6Ly9teWJ1Y2tldC9teWltYWdlLnBuZw pb().rotate(90).blur(10).build({ path: 's3://mybucket/myimage.png', baseUrl: 'https://my-imgproxy-instance.example.com', }); // You can clone the current configuration for templating / reuse const template = pb().rotate(90); const copy = template.clone(); // To remove a modifier, use the `unset` function const t = pb().rotate(90).blur(10); t.unset('rotate'); // ... Or you can replace the previous setting by calling the // modifier again const t = pb().rotate(90).blur(10); // rotate: 90, blur: 10 t.rotate(34); // rotate: 34, blur: 10 ``` ## 链管 管道 [可被锁链](https://github.com/imgproxy/imgproxy/blob/41b9ebe9277ef3e664e0a842fbc0e912b2640969/docs/chained_pipelines.md) 使用链式公用功能: ```typescript import pb, { chain } from '@bitpatty/imgproxy-url-builder'; // Returns bl:10/rot:90/-/bl:10/rot:270 chain([pb().blur(10).rotate(90), pb().blur(10).rotate(270)]); // Returns /8q2Ey2URdWizZb8PgAUKMO6C2tD4aXOa2IbCMV9pTKA/bl:10/-/ar:true/dGVzdC5wbmc chain({ buildOptions: { path: 'test.png', signature: { key: '73757065722d7365637265742d6b6579', // super-secret-key salt: '73757065722d7365637265742d73616c74', // super-secret-salt }, }, builders: [pb().blur(10), pb().autoRotate()], }); ``` ## 许可证 现按 [MIT 许可证](https://github.com/BitPatty/imgproxy-url-builder/blob/master/LICENSE)。 。 。 . ## 修改器 - [调整](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-adjust-imgproxy-docs) - [自动旋转](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-autorotate-imgproxy-docs) - [背景情况](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-background-imgproxy-docs) - [阿尔法](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-backgroundalpha-imgproxy-docs) - [模糊](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-blur-imgproxy-docs) - [模糊的检测](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-blurdetections-imgproxy-docs) - [亮度](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-brightness-imgproxy-docs) - [缓存按钮](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-cachebuster-imgproxy-docs) - [对比](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-contrast-imgproxy-docs) - [作物](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-crop-imgproxy-docs) - [禁用动画](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-disableanimation-imgproxy-docs) - [dpi 语录](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-dpi-imgproxy-docs) - [4月 (单位:千美元)](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-dpr-imgproxy-docs) - [绘图检测](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-drawdetections-imgproxy-docs) - [双音](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-duotone-imgproxy-docs) - [执行Thumbnail](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-enforcethumbnail-imgproxy-docs) - [扩展](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-enlarge-imgproxy-docs) - [过期](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-expires-imgproxy-docs) - [扩展](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-extend-imgproxy-docs) - [扩展视野Ratio](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-extendaspectratio-imgproxy-docs) - [倒转图像Url](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-fallbackimageurl-imgproxy-docs) - [文件Name](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-filename-imgproxy-docs) - [格式](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-format-imgproxy-docs) - [格式 质量](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-formatquality-imgproxy-docs) - [渐变](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-gradient-imgproxy-docs) - [重力](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-gravity-imgproxy-docs) - [半径](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-hashsum-imgproxy-docs) - [jpeg 选项](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-jpegoptions-imgproxy-docs) - [保持对映](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-keepcopyright-imgproxy-docs) - [最大字节](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-maxbytes-imgproxy-docs) - [分钟高](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-minheight-imgproxy-docs) - [微风](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-minwidth-imgproxy-docs) - [单色](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-monochrome-imgproxy-docs) - [选项](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-pad-imgproxy-docs) - [页 次](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-page-imgproxy-docs) - [像素化](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-pixelate-imgproxy-docs) - [png 选项](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-pngoptions-imgproxy-docs) - [预设](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-preset-imgproxy-docs) - [质量](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-quality-imgproxy-docs) - [原始内容](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-raw-imgproxy-docs) - [调整大小](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-resize-imgproxy-docs) - [调整大小 算法](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-resizingalgorithm-imgproxy-docs) - [返回连接](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-returnattachment-imgproxy-docs) - [旋转](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-rotate-imgproxy-docs) - [饱和度](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-saturation-imgproxy-docs) - [锐化](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-sharpen-imgproxy-docs) - [跳过处理中](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-skipprocessing-imgproxy-docs) - [条条彩色文件](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-stripcolorprofile-imgproxy-docs) - [条形元数据](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-stripmetadata-imgproxy-docs) - [样式](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-style-imgproxy-docs) - [修饰](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-trim-imgproxy-docs) - [打开](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-unsharpen-imgproxy-docs) - [视频 Thumbnail 关键框架](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-videothumbnailkeyframes-imgproxy-docs) - [视频 Thumbnail 二等](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-videothumbnailsecond-imgproxy-docs) - [视频ThumbnailTile](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-videothumbnailtile-imgproxy-docs) - [水印](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-watermark-imgproxy-docs) - [水上标记](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-watermarkshadow-imgproxy-docs) - [水印大小](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-watermarksize-imgproxy-docs) - [水印图文](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-watermarktext-imgproxy-docs) - [水标记Url](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-watermarkurl-imgproxy-docs) - [缩放](https://npmcn.com/package/%40bitpatty/imgproxy-url-builder/#readme-zoom-imgproxy-docs) ### 调整([imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#adjust-idadjust)(中文(简体) ) 定义亮度、对比度和饱和度. #### 示例 ```typescript pb().adjust({ brightness: 100, // optional contrast: 0.8, // optional saturation: 0.9 // optional }); ``` ### 自动旋转( E)[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#auto-rotate)(中文(简体) ) 基于 EXIF 方向参数自动旋转图像. #### 示例 ```typescript pb().autoRotate(); ``` ### 背景情况([imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#background)(中文(简体) ) 用指定的颜色填充图像背景. #### 示例 ```typescript pb().background('ff0000'); pb().background({ r: 255, g: 0, b: 0 }); ``` ### 阿尔法([imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#background-alpha-idbackground-alpha)(中文(简体) ) 将α 通道添加到背景 . #### 示例 ```typescript pb().backgroundAlpha(0.4); ``` ### 模糊( e)[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#blur)(中文(简体) ) 在图像上应用了高斯模糊过滤器. #### 示例 ```typescript pb().blur(10); ``` ### 模糊检测( O)[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#blur-detections-idblur-detections)(中文(简体) ) 检测所提供的类的物体并模糊它们. #### 示例 ```typescript pb().blurDetections({ sigma: 10, classNames: ['face'] }); ``` ### 亮度( 微弱)[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#brightness-idbrightness)(中文(简体) ) 调整图像的亮度. #### 示例 ```typescript pb().brightness(-100); ``` ### 缓存屏( B)[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#cache-buster)(中文(简体) ) 将缓存缓存添加到 imgproxy 参数. #### 示例 ```typescript pb().cacheBuster("abcdef123"); ``` ### 对比([imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#contrast-idcontrast)(中文(简体) ) 调整结果图像的对比度 . #### 示例 ```typescript pb().contrast(0.3); ``` ### 作物([imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#crop)(中文(简体) ) 裁剪图像. #### 示例 ```typescript pb().crop({ width: 100, // optional height: 50, // optional gravity: { // optional type: GravityType.CENTER, // required offset: { // optional x: 20, // required y: 20 // required } } }) ``` ### 禁用动画( E)[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/cfa4b596d1f31656f9116cc16f2a4ff7d15c2837/docs/generating_the_url.md#disable-animation-iddisable-animation)(中文(简体) ) 使用单帧动画图像. #### 示例 ```typescript pb().disableAnimation(); ``` ### dpi (英语:[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/8629c5eca1e422908363f471513bfc887d778a85/docs/generating_the_url.md#dpi-iddpi)(中文(简体) ) 设定时, Ingproxy 将用所提供的值来取代图像的DPI元数据. #### 示例 ```typescript pb().dpi(300); ``` ### dpr (时速[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#dpr)(中文(简体) ) 根据指定的因子来乘以尺寸. #### 示例 ```typescript pb().dpr(18); ``` ### 绘图检测( E)[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#draw-detections-iddraw-detections)(中文(简体) ) 探测所提供类别的物体并绘制其边框. #### 示例 ```typescript pb().drawDetections({ classNames: ["face"] }); ``` ### 双音( n)[imgproxy 文档](https://github.com/imgproxy/imgproxy-docs/blob/7d15484aea6a1fae5f1dfd1806b5551a4774658d/docs/usage/processing.mdx?plain=1#L429)(中文(简体) ) 用指定的强度和颜色将图像转换为双音. #### 示例 ```typescript pb().duotone({ intensity: 1.0, // required color1: 'ff0000', // required color2: '00ff00' // required }); ``` ### 执行Thumbnail([imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#enforce-thumbnail)(中文(简体) ) 如果源图像有嵌入式缩略图,imgproxy将使用嵌入式缩略图来代替主图像. #### 示例 ```typescript pb().enforceThumbnail(); ``` ### 扩大( e)[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#enlarge)(中文(简体) ) 如果图像比给定的大小小,则扩大图像. #### 示例 ```typescript pb().enlarge(); ``` ### 期满[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#expires)(中文(简体) ) 如果到期日已到,则返回 a 404. #### 示例 ```typescript pb().expires(new Date()); pb().expires(1661431326); ``` ### 扩展( e)[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#extend)(中文(简体) ) 如果图像小于给定大小,则扩展图像. #### 示例 ```typescript pb().extend(); pb().extend({ gravity: { type: GravityType.NORTH // required offset: { // optional x: 10; // required y: 20; // required } } }); ``` ### 扩展视野Ratio([imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/1a9768a2c682e88820064aa3d9a05ea234ff3cc4/docs/generating_the_url.md#extend-aspect-ratio)(中文(简体) ) 将图像扩展至请求的宽比 . #### 示例 ```typescript pb().extendAspectRatio(); pb().extendAspectRatio({ gravity: { type: GravityType.NORTH // required offset: { // optional x: 10; // required y: 20; // required } } }); ``` ### 倒置图像Url([imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#fallback-image-url-idfallback-image-url)(中文(简体) ) 通过指定其 URL 设置自定义倒置图像. #### 示例 ```typescript pb().fallbackImageUrl('https://example.com'); ``` ### 文件Name[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/41b9ebe9277ef3e664e0a842fbc0e912b2640969/docs/generating_the_url.md#filename)(中文(简体) ) 设置内容偏移标题的文件名. #### 示例 ```typescript // Not encoded pb().fileName('filename.png'); // Encoded pb().fileName('ZmlsZW5hbWUucG5n', true); ``` ### 格式 (单位:千美元)[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#format)(中文(简体) ) 指定生成的图像格式. #### 示例 ```typescript pb().format('png'); ``` ### 格式 质量[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#format-quality)(中文(简体) ) 设置每种格式所需的质量. #### 示例 ```typescript pb().formatQuality({ jpeg: 100, png: 50, // ... }); ``` ### 渐变( e)[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/cfa4b596d1f31656f9116cc16f2a4ff7d15c2837/docs/generating_the_url.md#gradient-idgradient)(中文(简体) ) 在已处理的图像上放置梯度. #### 示例 ```typescript pb().gradient({ opacity: 1, // required color: 'ababab', // optional direction: 'up', // optional start: 0.0, // optional stop: 0.7 // optional }); ``` ### 重力( r)[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#gravity)(中文(简体) ) 设定重力. #### 示例 ```typescript pb().gravity({ type: GravityType.NORTH // required offset: { // optional x: 10, // required y: 20 // required } }); ``` ### 半径( hashum) ([imgproxy 文档](https://github.com/imgproxy/imgproxy-docs/blob/f9d7908d253ec2b31425b988a48f8c28cb271c58/docs/usage/processing.mdx#L916)(中文(简体) ) 何时 `hashsum_type` 没有 `none`, imgproxy 将计算出源图像的散列和所提供散列相比较. #### 示例 ```typescript pb().hashsum({ hashsum: 'ABCDEF', // required type: HashsumType.NONE // optional }); ``` ### jpeg 选项[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#jpeg-options-idjpeg-options)(中文(简体) ) 允许重新定义 JPEG 保存选项 . #### 示例 ```typescript pb().jpegOptions({ progressive: boolean, // optional noSubsample: boolean, // optional trellisQuant: boolean, // optional overshootDeringing: boolean, // optional optimizeScans: boolean, // optional quantizationTable: 7 // optional }); ``` ### 保持版权( E)[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#keep-copyright)(中文(简体) ) 在剥去元数据的同时保留版权信息. #### 示例 ```typescript pb().keepCopyright(); ``` ### 最大字节( E)[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#max-bytes)(中文(简体) ) 将文件大小限制为指定的字节数 . #### 示例 ```typescript pb().maxBytes(10); ``` ### 分钟( MinH8)[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#min-height)(中文(简体) ) 定义生成的图像的最小高度. #### 示例 ```typescript pb().minHeight(100); ``` ### 分钟( MinWidth) ([imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#min-width)(中文(简体) ) 定义所产生的图像最小宽度. #### 示例 ```typescript pb().minWidth(100); ``` ### 单色( r)[imgproxy 文档](https://github.com/imgproxy/imgproxy-docs/blob/7d15484aea6a1fae5f1dfd1806b5551a4774658d/docs/usage/processing.mdx?plain=1#L415)(中文(简体) ) 将图像转换为单色 . #### 示例 ```typescript pb().monochrome({ intensity: 0.3, // required color: 'ff0000' // optional }); ``` ### 垫 (e)[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#padding)(中文(简体) ) 对图像应用指定的编码. #### 示例 ```typescript pb().pad({ top: 100, // optional (Note: sets all other sides if not set explicitly) right: 100, // optional bottom: 10, // optional left: 10 // optional }); ``` ### 页 次[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#page-idpage)(中文(简体) ) 当源图像支持页化(PDF,TIFF)或动画(GIF,WebP)时,此选项允许指定要使用的页面. #### 示例 ```typescript pb().page(10); ``` ### 有像素( n)[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#pixelate)(中文(简体) ) 将像素过滤器应用到生成的图像中. #### 示例 ```typescript pb().pixelate(5); ``` ### png 选项[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#png-options-idpng-options)(中文(简体) ) 允许重新定义 PNG 保存选项 . #### 示例 ```typescript pb().pngOptions({ interlaced: true, // optional quantize: false, // optional quantization_colors: 10 // optional }); ``` ### 预设( e)[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#preset)(中文(简体) ) 设置一个或多个预设,供imgproxy使用. #### 示例 ```typescript pb().preset('mypreset'); pb().preset(['preset1', 'preset2']); ``` ### 质量([imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#quality)(中文(简体) ) 重新定义生成图像的质量 . #### 示例 ```typescript pb().quality(80); ``` ### 生 ([imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/f95f57bb4df35c69ae2257958006ef54b1c1d8c7/docs/generating_the_url.md#raw)(中文(简体) ) 返回原始未处理和未受限制的源图像 #### 示例 ```typescript pb().raw(); ``` ### 调整大小( e)[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#resize)(中文(简体) ) 调整图像大小. #### 示例 ```typescript pb().resize({ type: ResizeType.AUTO, // optional width: 100, // optional height: 50 // optional }); ``` ### 调整算法大小( E)[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#resizing-algorithm-idresizing-algorithm)(中文(简体) ) 定义 imgproxy 用于再大小的算法. #### 示例 ```typescript pb().resizingAlgorithm(ResizingAlgorithm.NEAREST)); ``` ### 返回标记( A)[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#return-attachment)(中文(简体) ) 返回内容- Disposition 页眉中的附件. #### 示例 ```typescript pb().returnAttachment(); ``` ### 旋转( r)[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#rotate)(中文(简体) ) 以指定角度旋转图像. #### 示例 ```typescript pb().rotate(90); ``` ### 饱和度( e)[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#saturation-idsaturation)(中文(简体) ) 调整所生成图像的饱和度. #### 示例 ```typescript pb().saturation(0.3); ``` ### 磨口 ([imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#sharpen)(中文(简体) ) 对图像使用磨刀过滤器. #### 示例 ```typescript pb().sharpen(3); ``` ### 跳过处理( T)[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#skip-processing)(中文(简体) ) 跳过列表格式的处理 . #### 示例 ```typescript pb().skipProcessing(['png', 'svg']); ``` ### 条纹彩色文件[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#strip-color-profile)(中文(简体) ) 从图像中去除颜色描述文件. #### 示例 ```typescript pb().stripColorProfile(); ``` ### 条形元数据( T)[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#strip-metadata)(中文(简体) ) 剥离图像中的元数据. #### 示例 ```typescript pb().stripMetadata(); ``` ### 样式( e)[imgproxy 文档](https://github.com/imgproxy/imgproxy/blob/6f292443eafb2e39f9252175b61faa6b38105a7c/docs/generating_the_url.md#style-idstyle)(中文(简体) ) 预留 a `