如何在Doxygen中设置\image命令将图片缩放为原尺寸的指定百分比？

针对Doxygen 1.8.17版本输出HTML格式时，将图片缩放到原始尺寸50%的需求，可通过以下几种方式实现：

方法1：直接指定像素宽度（最简便，适合少量图片） #

如果已知图片的原始像素宽度，直接在\image命令中填写一半宽度的像素值即可，该方式不会跟随页面宽度变化，完全匹配原始尺寸的50%效果：

\image html some.png width=400px

示例中假设图片原始宽度为800px，可根据实际图片尺寸替换数值

方法2：嵌入原生HTML代码（无需修改Doxygen配置，适配动态需求） #

通过Doxygen支持的\htmlonly块插入原生HTML，利用CSS实现相对于原始尺寸的缩放：

\htmlonly
<div style="width: fit-content;">
  <img src="some.png" style="width: 50%; height: auto;" />
</div>
\endhtmlonly

原理是外层div的width: fit-content会将容器宽度设置为图片原始宽度，此时内层img的50%宽度就是相对于图片原始尺寸计算的，不会受页面宽度影响。

如果不需要考虑缩放后的元素占位问题，也可以直接用transform缩放：

\htmlonly
<img src="some.png" style="transform: scale(0.5); transform-origin: top left;" />
\endhtmlonly

方法3：自定义CSS统一配置（适合批量处理图片） #

如果有大量图片需要统一设置为原始尺寸的50%，可以通过自定义全局样式实现：

1. 新建自定义CSS文件（比如custom.css），添加如下样式：

.half-size-img {
  max-width: none !important;
  width: 50% !important;
}
.half-size-wrap {
  width: fit-content;
}

2. 打开Doxygen配置文件（Doxyfile），找到HTML_EXTRA_STYLESHEET配置项，添加自定义CSS文件路径：

HTML_EXTRA_STYLESHEET = custom.css

3. 在注释中调用时给图片套上对应的类即可：

\htmlonly
<div class="half-size-wrap">
  \image html some.png class=half-size-img
\endhtmlonly

注意：Doxygen原生\image命令的百分比宽度默认相对于页面内容区宽度计算，目前没有原生参数支持直接按图片原始尺寸百分比缩放，上述三种方案都是兼容性较好的实现方式。

内容的提问来源于stack exchange，提问作者sofname