幅と高さを指定して、画像の縮尺を変更する

# imagescale

(PHP 5 >= 5.5.0, PHP 7)

imagescale — 幅と高さを指定して、画像の縮尺を変更する

### 説明

imagescale ( resource `$image` , int `$new_width` [, int `$new_height` = -1 [, int `$mode` = IMG_BILINEAR_FIXED ]] ) : resource

imagescale() は、指定した補間アルゴリズムを使って画像の縮尺を変更します。

### パラメータ

`image`

  imagecreatetruecolor() のような画像作成関数が返す画像リソース。

`new_width`

  変更後の画像の幅。

`new_height`

  変更後の画像の高さ。省略したり負の数を指定したりした場合は、元の画像のアスペクト比を維持します。

  警告

  PHP 5.5.18 以前、あるいは PHP 5.6.2 以前のバージョンでは、常に高さを指定する必要があります。 これらのバージョンでは、高さを省略した場合のアスペクト比の計算が、正しく行われません。

`mode`

  `IMG_NEAREST_NEIGHBOUR`、 `IMG_BILINEAR_FIXED`、 `IMG_BICUBIC`、 `IMG_BICUBIC_FIXED` あるいはそれ以外 (2 パスで使います) のいずれか。

  > 注意: `IMG_WEIGHTED4` にはまだ対応していません。

### 返り値

成功した場合に、縮尺を変更した画像リソースを返します。失敗した場合に `FALSE` を返します。

### 変更履歴

バージョン | 説明
--- | ---
5.5.19/5.6.3 | `new_height` が負の数だったり省略されていたりした場合の、高さの計算の問題が修正されました。 これより前のバージョンでは、アスペクト比を正確に保つことができませんでした。