WP_Image_Editor_GD::crop( int $src_x, int $src_y, int $src_w, int $src_h, int $dst_w = null, int $dst_h = null, bool $src_abs = false )

Crops Image.



(int) (Required) The start x position to crop from.


(int) (Required) The start y position to crop from.


(int) (Required) The width to crop.


(int) (Required) The height to crop.


(int) (Optional) The destination width.

Default value: null


(int) (Optional) The destination height.

Default value: null


(bool) (Optional) If the source crop points are absolute.

Default value: false




File: wp-includes/class-wp-image-editor-gd.php

	public function crop( $src_x, $src_y, $src_w, $src_h, $dst_w = null, $dst_h = null, $src_abs = false ) {
		// If destination width/height isn't specified, use same as
		// width/height from source.
		if ( ! $dst_w )
			$dst_w = $src_w;
		if ( ! $dst_h )
			$dst_h = $src_h;

		$dst = wp_imagecreatetruecolor( $dst_w, $dst_h );

		if ( $src_abs ) {
			$src_w -= $src_x;
			$src_h -= $src_y;

		if ( function_exists( 'imageantialias' ) )
			imageantialias( $dst, true );

		imagecopyresampled( $dst, $this->image, 0, 0, $src_x, $src_y, $dst_w, $dst_h, $src_w, $src_h );

		if ( is_resource( $dst ) ) {
			imagedestroy( $this->image );
			$this->image = $dst;
			return true;

		return new WP_Error( 'image_crop_error', __('Image crop failed.'), $this->file );


Version Description
WP-3.5.0 Introduced.