image_constrain_size_for_editor( int $width, int $height, string|int[] $size = 'medium', string $context = null ): int[]

73function image_constrain_size_for_editor( $width, $height, $size = 'medium', $context = null ) {74	global $content_width;75 76	$_wp_additional_image_sizes = wp_get_additional_image_sizes();77 78	if ( ! $context ) {79		$context = is_admin() ? 'edit' : 'display';80	}81 82	if ( is_array( $size ) ) {83		$max_width  = $size[0];84		$max_height = $size[1];85	} elseif ( 'thumb' === $size || 'thumbnail' === $size ) {86		$max_width  = (int) get_option( 'thumbnail_size_w' );87		$max_height = (int) get_option( 'thumbnail_size_h' );88		// Last chance thumbnail size defaults.89		if ( ! $max_width && ! $max_height ) {90			$max_width  = 128;91			$max_height = 96;92		}93	} elseif ( 'medium' === $size ) {94		$max_width  = (int) get_option( 'medium_size_w' );95		$max_height = (int) get_option( 'medium_size_h' );96 97	} elseif ( 'medium_large' === $size ) {98		$max_width  = (int) get_option( 'medium_large_size_w' );99		$max_height = (int) get_option( 'medium_large_size_h' );100 101		if ( (int) $content_width > 0 ) {102			$max_width = min( (int) $content_width, $max_width );103		}104	} elseif ( 'large' === $size ) {105		/*106		 * We're inserting a large size image into the editor. If it's a really107		 * big image we'll scale it down to fit reasonably within the editor108		 * itself, and within the theme's content width if it's known. The user109		 * can resize it in the editor if they wish.110		 */111		$max_width  = (int) get_option( 'large_size_w' );112		$max_height = (int) get_option( 'large_size_h' );113 114		if ( (int) $content_width > 0 ) {115			$max_width = min( (int) $content_width, $max_width );116		}117	} elseif ( ! empty( $_wp_additional_image_sizes ) && in_array( $size, array_keys( $_wp_additional_image_sizes ), true ) ) {118		$max_width  = (int) $_wp_additional_image_sizes[ $size ]['width'];119		$max_height = (int) $_wp_additional_image_sizes[ $size ]['height'];120		// Only in admin. Assume that theme authors know what they're doing.121		if ( (int) $content_width > 0 && 'edit' === $context ) {122			$max_width = min( (int) $content_width, $max_width );123		}124	} else { // $size === 'full' has no constraint.125		$max_width  = $width;126		$max_height = $height;127	}128 129	/**130	 * Filters the maximum image size dimensions for the editor.131	 *132	 * @since 2.5.0133	 *134	 * @param int[]        $max_image_size {135	 *     An array of width and height values.136	 *137	 *     @type int $0 The maximum width in pixels.138	 *     @type int $1 The maximum height in pixels.139	 * }140	 * @param string|int[] $size     Requested image size. Can be any registered image size name, or141	 *                               an array of width and height values in pixels (in that order).142	 * @param string       $context  The context the image is being resized for.143	 *                               Possible values are 'display' (like in a theme)144	 *                               or 'edit' (like inserting into an editor).145	 */146	list( $max_width, $max_height ) = apply_filters( 'editor_max_image_size', array( $max_width, $max_height ), $size, $context );147 148	return wp_constrain_dimensions( $width, $height, $max_width, $max_height );149}