WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

wp_expand_dimensions()

wp_expand_dimensions( int $example_width, int $example_height, int $max_width, int $max_height ): int[]

In this article

Back to top

Based on a supplied width/height example, returns the biggest possible dimensions based on the max width/height.

Description

See also

Parameters

$example_widthintrequired
The width of an example embed.
$example_heightintrequired
The height of an example embed.
$max_widthintrequired
The maximum allowed width.
$max_heightintrequired
The maximum allowed height.

Return

int[] An array of maximum width and height values.
  • int
    The maximum width in pixels.
  • 1 int
    The maximum height in pixels.

Source

function wp_expand_dimensions( $example_width, $example_height, $max_width, $max_height ) {
	$example_width  = (int) $example_width;
	$example_height = (int) $example_height;
	$max_width      = (int) $max_width;
	$max_height     = (int) $max_height;

	return wp_constrain_dimensions( $example_width * 1000000, $example_height * 1000000, $max_width, $max_height );
}

View all references View on Trac View on GitHub

UsesDescription
wp_constrain_dimensions()wp-includes/media.php

Calculates the new dimensions for a down-sampled image.

Changelog

VersionDescription
2.9.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.