voidImageViewer 内置的 WebP 工具链全解析：cwebp、dwebp、webpmux 等命令行工具详解-北京尧图网络

桌面应用图像处理【免费下载链接】voidImageViewerLightweight image viewer for Windows with animated GIF/WEBP support项目地址https://gitcode.com/gh_mirrors/vo/voidImageViewer点击查看免费下载本篇基于 libwebp 官方文档 doc/tools.md系统讲解 WebP 工具集——编码工具 cwebp、解码工具 dwebp、文件分析工具 webpinfo、可视化工具 vwebp、动画生成工具 img2webp、GIF 转换工具 gif2webp、动画对比工具 anim_diff 以及多路复用工具 webpmux 的完整用法与参数。voidImageViewer 在 src/webp.c 中集成了同一套 libwebp 解码与 demux 源码本文末尾会说明两者关系读完全文后你可以独立完成 WebP 图片的有损/无损编码调优、格式转换、结构分析与动画文件操作。编码工具 cwebplibwebp/examples/cwebp.c 是 WebP 编码命令行工具的实现它将输入图片PNG、JPEG、TIFF、WebP 等编码为 WebP 码流。最简单的用法cwebp input.png -q 80 -o output.webp该命令将输入文件转换为 WebP 文件-q 80指定 0→100 的质量因子0 为最低质量100 为最高默认值 75。此外还可以尝试-lossless标志它对源图RGBA 格式做无损压缩。在无损模式下-q参数转而控制编码器“为把输出文件压到最小”所花费的处理时间——质量值越高压缩越狠但耗时越长。完整的选项列表可通过-longhelp查看 cwebp -longhelp Usage: cwebp [-preset ...] [options] in_file [-o out_file]若未通过-s指定输入尺寸则假定输入为 PNG、JPEG、TIFF 或 WebP 文件。注意不支持动画 PNG 和动画 WebP 文件。cwebp 完整选项列表-h / -help ............. short help -H / -longhelp ......... long help -q float ............. quality factor (0:small..100:big), default75 -alpha_q int ......... transparency-compression quality (0..100), default100 -preset string ....... preset setting, one of: default, photo, picture, drawing, icon, text -preset must come first, as it overwrites other parameters -z int ............... activates lossless preset with given level in [0:fast, ..., 9:slowest] -m int ............... compression method (0fast, 6slowest), default4 -segments int ........ number of segments to use (1..4), default4 -size int ............ target size (in bytes) -psnr float .......... target PSNR (in dB. typically: 42) -s int int ......... input size (width x height) for YUV -sns int ............. spatial noise shaping (0:off, 100:max), default50 -f int ............... filter strength (0off..100), default60 -sharpness int ....... filter sharpness (0:most .. 7:least sharp), default0 -strong ................ use strong filter instead of simple (default) -nostrong .............. use simple filter instead of strong -sharp_yuv ............. use sharper (and slower) RGB-YUV conversion -partition_limit int . limit quality to fit the 512k limit on the first partition (0no degradation ... 100full) -pass int ............ analysis pass number (1..10) -qrange min max .... specifies the permissible quality range (default: 0 100) -crop x y w h .. crop picture with the given rectangle -resize w h ........ resize picture (*after* any cropping) -mt .................... use multi-threading if available -low_memory ............ reduce memory usage (slower encoding) -map int ............. print map of extra info -print_psnr ............ prints averaged PSNR distortion -print_ssim ............ prints averaged SSIM distortion -print_lsim ............ prints local-similarity distortion -d file.pgm .......... dump the compressed output (PGM file) -alpha_method int .... transparency-compression method (0..1), default1 -alpha_filter string . predictive filtering for alpha plane, one of: none, fast (default) or best -exact ................. preserve RGB values in transparent area, defaultoff -blend_alpha hex ..... blend colors against background color expressed as RGB values written in hexadecimal, e.g. 0xc0e0d0 for red0xc0 green0xe0 and blue0xd0 -noalpha ............... discard any transparency information -lossless .............. encode image losslessly, defaultoff -near_lossless int ... use near-lossless image preprocessing (0..100off), default100 -hint string ......... specify image characteristics hint, one of: photo, picture or graph -metadata string ..... comma separated list of metadata to copy from the input to the output if present. Valid values: all, none (default), exif, icc, xmp -short .................. condense printed message -quiet .................. dont print anything -version ............... print version number and exit -noasm ................. disable all assembly optimizations -v ..................... verbose, e.g. print encoding/decoding times -progress .............. report encoding progress实验性选项-jpeg_like ............. roughly match expected JPEG size -af .................... auto-adjust filter strength -pre int ............. pre-processing filter四个核心质量调优参数preset / sns / f / m官方文档特别指出为进一步提升视觉质量最值得尝试的核心选项按顺序是-preset-sns-f-m。preset针对特定输入类型设置一组默认编码配置应放在选项列表最前面这样后续选项才能叠加在预设之上。默认值为default。sns从 0 到 100 逐步开启额外的视觉优化如重新强化分割图它会重新平衡比特分配——尝试从图像“容易”的部分抽取比特转给“困难”的部分。通常在-q固定时提高 sns 值会得到更大但质量更好的文件典型取值约为 75。f直接对应编解码器 in-loop 滤波强度。值越高高压缩区域看起来越平滑在追求极小文件时特别有用典型值 20~30。-strong/-nostrong会改变滤波类型-f 0可完全关闭滤波。m控制编码速度与质量的权衡默认 4。可尝试-m 5或-m 6探索更多耗时更长的编码可能性值越小编码越快但质量下降。从源码看参数是如何生效的对照 cwebp.c 的参数解析实现可以印证文档中几个关键行为-preset被解析为WebPPreset枚举WEBP_PRESET_DEFAULT/WEBP_PRESET_PHOTO/WEBP_PRESET_PICTURE/WEBP_PRESET_DRAWING/WEBP_PRESET_ICON/WEBP_PRESET_TEXT后调用WebPConfigPreset(config, preset, config.quality)初始化配置见 cwebp.c#L850-L872。预设的具体默认值定义在 src/enc/config_enc.c 的预设表中预设枚举声明在 src/webp/encode.h#L158。-z是无损预设级别cwebp.c 中默认lossless_preset 6最终调用WebPConfigLosslessPreset()应用cwebp.c#L942-L947。注意一旦显式给出-q或-m-z会被自动禁用见 cwebp.c#L731-L739。-near_lossless在源码中会同时强制config.lossless 1即近似无损只能在无损模式下使用cwebp.c#L770-L772。若指定了-size或-psnr目标但未给-pass程序会自动将分析通道数提升为 6cwebp.c#L961-L965同时无损模式下目标大小/PSNR 与partition_limit选项会被忽略并给出警告cwebp.c#L951-L960。-metadata选项按逗号分割 tokenall / none / exif / icc / xmp解析为位掩码cwebp.c#L873-L910在 Windows WinCodec 构建下有平台限制只支持 ICC 提取并会打印警告。这些行为解释了为什么文档反复强调-preset must come first预设会覆写此前已设置的参数而后续的-sns、-f、-m等选项是在预设结果之上逐项修改WebPConfig字段。解码工具 dwebplibwebp/examples/dwebp.c 是解码示例程序它将 .webp 文件解码为 PNG默认或其他格式。仓库自带了一组校验素材test.webp应能精确解码为test_ref.ppm验证方式cd examples ./dwebp test.webp -ppm -o test.ppm diff test.ppm test_ref.ppm对应仓库中的素材文件为 examples/test.webp 与 examples/test_ref.ppm。完整选项列表通过dwebp -h查看 dwebp -h Usage: dwebp in_file [options] [-o out_file]默认解码为 PNG 格式。注意不支持动画 WebP 文件。其他目标格式-pam ......... save the raw RGBA samples as a color PAM -ppm ......... save the raw RGB samples as a color PPM -bmp ......... save as uncompressed BMP format -tiff ........ save as uncompressed TIFF format -pgm ......... save the raw YUV samples as a grayscale PGM file with IMC4 layout -yuv ......... save the raw YUV samples in flat layout其他选项-version ..... print version number and exit -nofancy ..... dont use the fancy YUV420 upscaler -nofilter .... disable in-loop filtering -nodither .... disable dithering -dither d .. dithering strength (in 0..100) -alpha_dither use alpha-plane dithering if needed -mt .......... use multi-threading -crop x y w h ... crop output with the given rectangle -resize w h ......... resize output (*after* any cropping) -flip ........ flip the output vertically -alpha ....... only save the alpha plane -incremental . use incremental decoding (useful for tests) -h ........... this help message -v ........... verbose (e.g. print encoding/decoding times) -quiet ....... quiet mode, dont print anything -noasm ....... disable all assembly optimizationsWebP 文件分析工具 webpinfolibwebp/examples/webpinfo.c 中的webpinfo用于打印 WebP 文件的 chunk 级结构与码流头部信息并可用于检查文件是否为合法 WebP 格式。用法webpinfo [options] in_files注意可以传入多个输入文件选项必须写在输入文件之前。选项-version ........... Print version number and exit. -quiet ............. Do not show chunk parsing information. -diag .............. Show parsing error diagnosis. -summary ........... Show chunk stats summary. -bitstream_info .... Parse bitstream header.这些选项在 webpinfo.c 的参数解析中一一对应实现-diag、-summary、-bitstream_info分别控制诊断输出、chunk 统计与码流头解析。当拿到来源不明的 WebP 文件时webpinfo是排查容器结构问题的首选工具。可视化工具 vwebpvwebplibwebp/examples/vwebp.c是一个自助式的可视化小工具使用 OpenGL 打开一个简单绘制窗口并显示解码后的 WebP 文件。它尚未集成进 automake 构建系统但可以按下面的说明手动编译。用法vwebp in_file [options]解码 WebP 图像文件并使用 OpenGL 显示。选项-version ..... print version number and exit -noicc ....... dont use the icc profile if present -nofancy ..... dont use the fancy YUV420 upscaler -nofilter .... disable in-loop filtering -dither int dithering strength (0..100), default50 -noalphadither disable alpha plane dithering -usebgcolor .. display background color -mt .......... use multi-threading -info ........ print info -h ........... this help message键盘快捷键c ................ toggle use of color profile b ................ toggle background color display i ................ overlay file information d ................ disable blending disposal (debug) q / Q / ESC .... quit编译 vwebp前置依赖OpenGL 与 OpenGL Utility ToolkitGLUTLinuxsudo apt-get install freeglut3-dev mesa-common-devMac Xcode这些库应在 OpenGL / GLUT 框架中可用Windows需要 freeglut 开发包可选qcmsQuick Color Management System从 Mozilla / Chromium 获取 qcms 源码编译并归档源文件为libqcms.a/qcms.lib修改makefile.unix/Makefile.vc定义WEBP_HAVE_QCMS并把 include / 库路径指向 qcms 目录使用 makefile.unix / Makefile.vc 编译$ make -f makefile.unix examples/vwebp nmake /f Makefile.vc CFGrelease-static \ ../obj/x64/release-static/bin/vwebp.exe动画生成工具 img2webp工具img2webplibwebp/examples/img2webp.c可以把一系列输入图像PNG、JPEG 等转换为动画 WebP 文件并对时长、编码模式等提供精细控制。用法img2webp [file_options] [[frame_options] frame_file]... [-o webp_file]文件级选项仅在压缩开始时使用-min_size ............ minimize size -kmax int .......... maximum number of frame between key-frames (0only keyframes) -kmin int .......... minimum number of frame between key-frames (0disable key-frames altogether) -mixed ............... use mixed lossy/lossless automatic mode -near_lossless int . use near-lossless image preprocessing (0..100off), default100 -sharp_yuv ........... use sharper (and slower) RGB-YUV conversion (lossy only) -loop int .......... loop count (default: 0, infinite loop) -v ................... verbose mode -h ................... this help -version ............. print version number and exit逐帧选项仅用于后续输入图像-d int ............. frame duration in ms (default: 100) -lossless ........... use lossless mode (default) -lossy ... ........... use lossy mode -q float ........... quality -m int ............. method to use示例img2webp -loop 2 in0.png -lossy in1.jpg -d 80 in2.tiff -o out.webp注意如果传入的参数是单个文件名则命令行参数会从该文件中按 token 解析。文件名不能以-开头。动画 GIF 转换 gif2webpgif2webplibwebp/examples/gif2webp.c可以把动画 GIF 文件转换为带动画的 WebP 文件转换结果可用 vwebp 查看。用法gif2webp [options] gif_file -o webp_file选项-h / -help ............. this help -lossy ................. encode image using lossy compression -mixed ................. for each frame in the image, pick lossy or lossless compression heuristically -q float ............. quality factor (0:small..100:big) -m int ............... compression method (0fast, 6slowest) -min_size .............. minimize output size (default:off) lossless compression by default; can be combined with -q, -m, -lossy or -mixed options -kmin int ............ min distance between key frames -kmax int ............ max distance between key frames -f int ............... filter strength (0off..100) -metadata string ..... comma separated list of metadata to copy from the input to the output if present Valid values: all, none, icc, xmp (default) -loop_compatibility .... use compatibility mode for Chrome version prior to M62 (inclusive) -mt .................... use multi-threading if available -version ............... print version number and exit -v ..................... verbose -quiet ................. dont print anything编译 gif2webp在安装好 libgif 开发文件的前提下可使用 makefile.unix 构建$ make -f makefile.unix examples/gif2webp或使用 autoconf$ ./configure --enable-everything $ make动画图像对比工具 anim_diff测试工具anim_difflibwebp/examples/anim_diff.c可用于比较两幅动画图像GIF 或 WebP 均可。用法anim_diff image1 image2 [options]选项-dump_frames folder dump decoded frames in PAM format -min_psnr float ... minimum per-frame PSNR -raw_comparison ..... if this flag is not used, RGB is premultiplied before comparison -max_diff int ..... maximum allowed difference per channel between corresponding pixels in subsequent frames -h .................. this help -version ............ print version number and exit编译 anim_diff在安装好 libgif 开发文件的前提下$ make -f makefile.unix examples/anim_diff或使用 autoconf$ ./configure --enable-everything $ makeWebP Mux 工具 webpmuxwebpmuxlibwebp/examples/webpmux.c用于操作扩展格式的 WebP 文件创建扩展格式 WebP 文件以及从中提取或剥离相关数据ICC 配置文件、EXIF、XMP 与动画帧。选项列表通过-help查看 webpmux -help Usage: webpmux -get GET_OPTIONS INPUT -o OUTPUT webpmux -set SET_OPTIONS INPUT -o OUTPUT webpmux -duration DURATION_OPTIONS [-duration ...] INPUT -o OUTPUT webpmux -strip STRIP_OPTIONS INPUT -o OUTPUT webpmux -frame FRAME_OPTIONS [-frame...] [-loop LOOP_COUNT] [-bgcolor BACKGROUND_COLOR] -o OUTPUT webpmux -info INPUT webpmux [-h|-help] webpmux -version webpmux argument_file_name GET_OPTIONS: Extract relevant data: icc get ICC profile exif get EXIF metadata xmp get XMP metadata frame n get nth frame SET_OPTIONS: Set color profile/metadata/parameters: loop LOOP_COUNT set the loop count bgcolor BACKGROUND_COLOR set the animation background color icc file.icc set ICC profile exif file.exif set EXIF metadata xmp file.xmp set XMP metadata where: file.icc contains the ICC profile to be set, file.exif contains the EXIF metadata to be set, file.xmp contains the XMP metadata to be set DURATION_OPTIONS: Set duration of selected frames: duration set duration for all frames duration,frame set duration of a particular frame duration,start,end set duration of frames in the interval [start,end]) where: duration is the duration in milliseconds start is the start frame index end is the inclusive end frame index The special end value 0 means: last frame. STRIP_OPTIONS: Strip color profile/metadata: icc strip ICC profile exif strip EXIF metadata xmp strip XMP metadata FRAME_OPTIONS(i): Create animation: file_i di[xiyi[mi[bi]]] where: file_i is the ith animation frame (WebP format), di is the pause duration before next frame, xi,yi specify the image offset for this frame, mi is the dispose method for this frame (0 or 1), bi is the blending method for this frame (b or -b) LOOP_COUNT: Number of times to repeat the animation. Valid range is 0 to 65535 [Default: 0 (infinite)]. BACKGROUND_COLOR: Background color of the canvas. A,R,G,B where: A, R, G and B are integers in the range 0 to 255 specifying the Alpha, Red, Green and Blue component values respectively [Default: 255,255,255,255] INPUT OUTPUT are in WebP format. Note: The nature of EXIF, XMP and ICC data is not checked and is assumed to be valid. Note: if a single file name is passed as the argument, the arguments will be tokenized from this file. The file name must not start with the character -.webpmux的典型工作流用-frame把若干静态 WebP 帧带时长、偏移、dispose/blending 方法拼装成动画再用-set loop设置循环次数、-set icc/exif/xmp附加元数据反之用-get frame n提取第 n 帧或用-strip移除元数据以减小体积。工具链与 voidImageViewer 的关系voidImageViewer 是一个轻量级 Windows 图像查看器支持动画 GIF/WEBP 预览。该仓库将 libwebp 源码整体内置于 libwebp/ 目录下其动画 WebP 加载层 src/webp.c 直接包含src/webp/decode.h与src/webp/demux.h即WebPDemuxer接口来实现多帧解码——这与本文的img2webp/gif2webp/webpmux所操作的动画容器是同一套规范。可以这样理解两者的分工本文介绍的命令行工具链用于在“仓库外”生产、检查、转换 WebP 文件包括 dwebp 的test.webp/test_ref.ppm这类回归素材所对应的编解码正确性验证而 voidImageViewer 只使用 libwebp 的解码侧 API 来消费这些文件。熟悉这些工具的参数含义如 key-frame 间隔kmin/kmax、dispose/blending 方法、循环次数有助于理解查看器解析动画 WebP 时实际处理的数据结构。相关入口文件编码libwebp/examples/cwebp.c解码libwebp/examples/dwebp.c分析libwebp/examples/webpinfo.c可视化libwebp/examples/vwebp.c动画libwebp/examples/img2webp.c、libwebp/examples/gif2webp.c、libwebp/examples/anim_diff.cMuxlibwebp/examples/webpmux.c构建libwebp/makefile.unix、libwebp/Makefile.vc、libwebp/examples/Makefile.am编码配置实现libwebp/src/enc/config_enc.c、API 声明 libwebp/src/webp/encode.h赞分享桌面应用图像处理【免费下载链接】voidImageViewerLightweight image viewer for Windows with animated GIF/WEBP support项目地址https://gitcode.com/gh_mirrors/vo/voidImageViewer点击查看免费下载相关推荐Frida工具链大全frida-tools命令行工具详解Frida工具链大全frida tools命令行工具详解 1. frida tools概述 frida tools是Frida工具链的核心组件提供了一系列命逆向工程应用安全网络安全Weblate 管理命令详解weblate 命令行工具与内置维护命令完全指南Weblate 管理命令详解weblate 命令行工具与内置维护命令完全指南 Weblate 的绝大部分运维与批处理工作——初始化安装、仓库同步、组件批量导入后端开发工具Pixelfed命令行工具详解Artisan命令大全Pixelfed命令行工具详解Artisan命令大全 Pixelfed作为开源的照片分享平台提供了丰富的命令行工具基于Laravel Artisan用于后端前端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

voidImageViewer 内置的 WebP 工具链全解析：cwebp、dwebp、webpmux 等命令行工具详解

相关推荐

C#与MATLAB混合开发：神经网络训练与预测实战

Java读取Word并上传数据库：解析、存储与避坑指南

数据结构与算法分析Java版习题答案详解：从链表到图的备考攻略

更多资讯

两相短路故障Matlab/Simulink仿真模型搭建与波形分析详解

带注解的深度学习入门源码：MNIST神经网络训练与调参避坑指南

8086系统结构深度解析：从寄存器到分段寻址的底层原理

微信小程序闹钟源码实战：从定时逻辑到真机唤醒的完整避坑指南

C语言手写FFT：从DFT到O(N log N)的实战指南

易语言大漠模块封装与免注册调用实战指南

今日更新

小波包能量谱原理与MATLAB实现：从频带分解到故障特征提取

基于LSTM的网易云音乐评论情感分析：数据清洗与模型调优实战

Alpha-Beta剪枝与极大极小值算法：博弈树搜索原理与实战优化

本周精选

交通拥堵预测毕设：基于Python+LSTM的车辆流量预测系统全流程解析

MATLAB/Simulink搭建10机39节点电力系统暂态稳定仿真实战

无人机航拍三维重建全流程：从SfM到网格生成的避坑指南

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？