gregwar/tex2png

LaTeX 公式转PNG

v1.0.0 2015-09-20 12:56 UTC

This package is auto-updated.

Last update: 2024-09-07 13:06:22 UTC


README

此类提供了一种轻松创建LaTeX公式的途径。

使用它,您可以转换原始公式,例如

Σ(i=0...n) i/2

转换为漂亮的图片,例如

Sum formula

需求

要使用此库,您需要

  • latex:编译公式(带有数学支持)
  • dvipng:将dvi转换为png
  • shell_exec:您需要能够调用PHP的shell_exec()函数

您还需要一个临时文件夹,当然,还需要足够的权限来写入目标目录

用法

只需包含Tex2png.php文件或将此存储库目录注册为Gregwar\Tex2png\命名空间,然后执行以下操作

<?php

// This will create a formula and save it to sum.png
Tex2png::create('\sum_{i = 0}^{i = n} \frac{i}{2}')
    ->saveTo('sum.png')
    ->generate();

您可以在example/目录中查看示例。

使用缓存

Tex2png库包含一个缓存系统,允许您只生成一次图像。要做到这一点,只需不要告诉Tex2png目标文件是什么

<?php

Tex2png::create('\sum_{i = 0}^{i = n} \frac{i}{2}')
    ->generate();

// The filename will be choosen using an hash of the formula and
// the image density. (file name will look like cache/tex/3/0/2/e/6/8febefe7aaed9eeb8abf09070d10e02e93e.png)

如果文件已存在,它将不会生成任何内容,否则,它将生成它。这导致了一个微小但强大的缓存系统,避免了两次重新生成公式PNG。

注意,您可以调用setCacheDirectory()函数来更改缓存目录

这是基于Gregwar/Cache库的。

更改密度

第二个构造函数/创建()参数是图像密度

<?php

Tex2png::create('\sum_{i = 0}^{i = n} \frac{i}{2}', 300)
    ->generate();

默认密度为155,您可以选择生成非常大的图像,这是公式密度为1000的示例

Sum formula (density=1000)

许可证

此类受MIT许可证保护,有关更多信息,请参阅LICENSE文件