WP_Image_Editor_Imagick::thumbnail_image( int $dst_w, int $dst_h, string $filter_name = 'FILTER_TRIANGLE', bool $strip_meta = true ): void|WP_Error

Source

 * which resizes an image to given dimensions and removes any associated profiles.
 *
 * @since 4.5.0
 *
 * @param int    $dst_w       The destination width.
 * @param int    $dst_h       The destination height.
 * @param string $filter_name Optional. The Imagick filter to use when resizing. Default 'FILTER_TRIANGLE'.
 * @param bool   $strip_meta  Optional. Strip all profiles, excluding color profiles, from the image. Default true.
 * @return void|WP_Error
 */
protected function thumbnail_image( $dst_w, $dst_h, $filter_name = 'FILTER_TRIANGLE', $strip_meta = true ) {
	$allowed_filters = array(
		'FILTER_POINT',
		'FILTER_BOX',
		'FILTER_TRIANGLE',
		'FILTER_HERMITE',
		'FILTER_HANNING',
		'FILTER_HAMMING',
		'FILTER_BLACKMAN',
		'FILTER_GAUSSIAN',
		'FILTER_QUADRATIC',
		'FILTER_CUBIC',
		'FILTER_CATROM',
		'FILTER_MITCHELL',
		'FILTER_LANCZOS',
		'FILTER_BESSEL',
		'FILTER_SINC',
	);

	/**
	 * Set the filter value if '$filter_name' name is in the allowed list and the related
	 * Imagick constant is defined or fall back to the default filter.
	 */
	if ( in_array( $filter_name, $allowed_filters, true ) && defined( 'Imagick::' . $filter_name ) ) {
		$filter = constant( 'Imagick::' . $filter_name );
	} else {
		$filter = defined( 'Imagick::FILTER_TRIANGLE' ) ? Imagick::FILTER_TRIANGLE : false;
	}

	/**
	 * Filters whether to strip metadata from images when they're resized.
	 *
	 * This filter only applies when resizing using the Imagick editor since GD
	 * always strips profiles by default.
	 *
	 * @since 4.5.0
	 *
	 * @param bool $strip_meta Whether to strip image metadata during resizing. Default true.
	 */
	if ( apply_filters( 'image_strip_meta', $strip_meta ) ) {
		$this->strip_meta(); // Fail silently if not supported.
	}

	try {
		/*
		 * To be more efficient, resample large images to 5x the destination size before resizing
		 * whenever the output size is less that 1/3 of the original image size (1/3^2 ~= .111),
		 * unless we would be resampling to a scale smaller than 128x128.
		 */
		if ( is_callable( array( $this->image, 'sampleImage' ) ) ) {
			$resize_ratio  = ( $dst_w / $this->size['width'] ) * ( $dst_h / $this->size['height'] );
			$sample_factor = 5;

			if ( $resize_ratio < .111 && ( $dst_w * $sample_factor > 128 && $dst_h * $sample_factor > 128 ) ) {
				$this->image->sampleImage( $dst_w * $sample_factor, $dst_h * $sample_factor );
			}
		}

		/*
		 * Use resizeImage() when it's available and a valid filter value is set.
		 * Otherwise, fall back to the scaleImage() method for resizing, which
		 * results in better image quality over resizeImage() with default filter
		 * settings and retains backward compatibility with pre 4.5 functionality.
		 */
		if ( is_callable( array( $this->image, 'resizeImage' ) ) && $filter ) {
			$this->image->setOption( 'filter:support', '2.0' );
			$this->image->resizeImage( $dst_w, $dst_h, $filter, 1 );
		} else {
			$this->image->scaleImage( $dst_w, $dst_h );
		}

		// Set appropriate quality settings after resizing.
		if ( 'image/jpeg' === $this->mime_type ) {
			if ( is_callable( array( $this->image, 'unsharpMaskImage' ) ) ) {
				$this->image->unsharpMaskImage( 0.25, 0.25, 8, 0.065 );
			}

			$this->image->setOption( 'jpeg:fancy-upsampling', 'off' );
		}

		if ( 'image/png' === $this->mime_type ) {
			$this->image->setOption( 'png:compression-filter', '5' );
			$this->image->setOption( 'png:compression-level', '9' );
			$this->image->setOption( 'png:compression-strategy', '1' );
			// Check to see if a PNG is indexed, and find the pixel depth.
			if ( is_callable( array( $this->image, 'getImageDepth' ) ) ) {
				$indexed_pixel_depth = $this->image->getImageDepth();

				// Indexed PNG files get some additional handling.
				if ( 0 < $indexed_pixel_depth && 8 >= $indexed_pixel_depth ) {
					// Check for an alpha channel.
					if (
						is_callable( array( $this->image, 'getImageAlphaChannel' ) )
						&& $this->image->getImageAlphaChannel()
					) {
						$this->image->setOption( 'png:include-chunk', 'tRNS' );
					} else {
						$this->image->setOption( 'png:exclude-chunk', 'all' );
					}

					// Reduce colors in the images to maximum needed, using the global colorspace.
					$max_colors = pow( 2, $indexed_pixel_depth );
					if ( is_callable( array( $this->image, 'getImageColors' ) ) ) {

View all references View on Trac View on GitHub