add_image_size()

最后更新于:2021-11-25 19:11:48

add_image_size( string$name, int$width, int$height, bool|array$crop=false)

Register a new image size.

参数

$name

(string) (Required) Image size identifier.

$width

(int) (Optional) Image width in pixels. Default 0.

$height

(int) (Optional) Image height in pixels. Default 0.

$crop

(bool|array) (Optional) Image cropping behavior. If false, the image will be scaled (default), If true, image will be cropped to the specified dimensions using center positions. If an array, the image will be cropped using the array to specify the crop location. Array values must be in the format: array( x_crop_position, y_crop_position ) where:

  • x_crop_position accepts: ‘left’, ‘center’, or ‘right’.
  • y_crop_position accepts: ‘top’, ‘center’, or ‘bottom’.

Default value: false

源文件

文件: gc-includes/media.php

function add_image_size( $name, $width = 0, $height = 0, $crop = false ) {
	global $_gc_additional_image_sizes;

	$_gc_additional_image_sizes[ $name ] = array(
		'width'  => absint( $width ),
		'height' => absint( $height ),
		'crop'   => $crop,
	);
}