Doxygen \image 标签大小规范语法

Question

doxygen \image 标记文档指定height 和width 属性都可以给出，但只接受第一个属性。第二个属性作为描述性文本输出到生成的 XML。

我想将两个图像属性指定为：

\image rtf myimage.png width=100px height=250px

声明允许这两个属性的文档的链接是：http://www.doxygen.nl/manual/commands.html#cmdimage

注意相关部分说：“sizeindication 可以指定要使用的宽度或高度（或组合）。”我想知道的是：正确的语法是什么？还是文档有误？

Answer 1

我觉得

这对于 LaTeX 或 docbook 输出（即 format=latex 或 format=docbook）很有用。

语句实际上可能意味着它仅对这些格式有用。我无法让宽度/高度自己工作，即使它似乎解析了第一个 sizeindicator 参数，它实际上并没有使用它。

有一些可用的旧文档 here 似乎暗示它过去只适用于 Latex

这仅对 LaTeX 输出有用（即 format=latex）。 sizeindication 可以是宽度或高度。大小应该是 LaTeX 中的有效大小说明符（例如 10cm 或 6in 或像 \textwidth 这样的符号宽度）。

我还可以在网上找到一些关于此的帖子：

Here

and here

让我相信这不适用于 Latex 格式。

我认为this answer 可能是实现您想要的唯一可行的方法。

编辑：

在查看docparser.cpp 中docparser.cpp 中的解析器代码后，它实际上只会处理第一个宽度或高度属性，之后它将停止。