# imagejpeg

(PHP 4, PHP 5, PHP 7)

imagejpeg — 输出图象到浏览器或文件。

### 说明

imagejpeg ( resource `$image` [, string `$filename` [, int `$quality` ]] ) : bool

imagejpeg() 从 `image` 图像以 `filename` 为文件名创建一个 JPEG 图像。

### 参数

`image`

  由图象创建函数(例如imagecreatetruecolor())返回的图象资源。

`filename`

  文件保存的路径，如果未设置或为 `NULL`，将会直接输出原始图象流。

  如果要省略这个参数而提供 `quality` 参数，使用NULL。

`quality`

  `quality` 为可选项，范围从 0（最差质量，文件更小）到 100（最佳质量，文件最大）。默认为 IJG 默认的质量值（大约 75）。

### 返回值

成功时返回 `TRUE`， 或者在失败时返回 `FALSE`。

### 范例

Example #1 输出 JPEG 图像

    <?php
    // 创键空白图像并添加一些文本
    $im = imagecreatetruecolor(120, 20);
    $text_color = imagecolorallocate($im, 233, 14, 91);
    imagestring($im, 1, 5, 5,  'A Simple Text String', $text_color);

    // 设置内容类型标头 —— 这个例子里是 image/jpeg
    header('Content-Type: image/jpeg');

    // 输出图像
    imagejpeg($im);

    // 释放内存
    imagedestroy($im);
    ?>

以上例程的输出类似于：

Example #2 保存一副 JPEG 图像

    <?php
    // 创键空白图像并添加一些文本
    $im = imagecreatetruecolor(120, 20);
    $text_color = imagecolorallocate($im, 233, 14, 91);
    imagestring($im, 1, 5, 5,  'A Simple Text String', $text_color);

    // 保存图像为 'simpletext.jpg'
    imagejpeg($im, 'simpletext.jpg');

    // 释放内存
    imagedestroy($im);
    ?>

Example #3 以 75% 的图像质量输出图像

    <?php
    // 创键空白图像并添加一些文本
    $im = imagecreatetruecolor(120, 20);
    $text_color = imagecolorallocate($im, 233, 14, 91);
    imagestring($im, 1, 5, 5,  'A Simple Text String', $text_color);

    // 设置内容类型标头 —— 这个例子里是 image/jpeg
    header('Content-Type: image/jpeg');

    // 使用 NULL 跳过 filename 参数，并设置图像质量为 75%
    imagejpeg($im, NULL, 75);

    // 释放内存
    imagedestroy($im);
    ?>

### 注释

> Note: JPEG 支持仅在 PHP 与 GD-1.8 或更高版本一起编译时可用。

> Note:

> 如果想输出渐进式 JPEG，需要用 imageinterlace() 函数将隔行扫描比特置位。

### 参见

- imagepng() - 以 PNG 格式将图像输出到浏览器或文件
- imagegif() - 输出图象到浏览器或文件。
- imagewbmp() - 以 WBMP 格式将图像输出到浏览器或文件
- imageinterlace() - 激活或禁止隔行扫描
- imagetypes() - 返回当前 PHP 版本所支持的图像类型