wp_image_src_get_dimensions() – Determines an image’s width and height dimensions based on the source file.

You appear to be a bot. Output may be restricted

Description

Determines an image's width and height dimensions based on the source file.

Usage

$array|false = wp_image_src_get_dimensions( $image_src, $image_meta, $attachment_id );

Parameters

$image_src
( string ) required – The image source file.
$image_meta
( array ) required – The image meta data as returned by 'wp_get_attachment_metadata()'.
$attachment_id
( int ) optional – Optional. The image attachment ID. Default 0.

Returns

array|false Array with first element being the width and second element being the height, or false if dimensions cannot be determined.

Source

File name: wordpress/wp-includes/media.php
Lines:

1 to 44 of 44
function wp_image_src_get_dimensions( $image_src, $image_meta, $attachment_id = 0 ) {
  $dimensions = false;

  // Is it a full size image?
  if (
    isset( $image_meta['file'] ) &&
    strpos( $image_src, wp_basename( $image_meta['file'] ) ) !== false
  ) {
    $dimensions = array(
      (int) $image_meta['width'],
      (int) $image_meta['height'],
    );
  }

  if ( ! $dimensions && ! empty( $image_meta['sizes'] ) ) {
    $src_filename = wp_basename( $image_src );

    foreach ( $image_meta['sizes'] as $image_size_data ) {
      if ( $src_filename === $image_size_data['file'] ) {
        $dimensions = array(
          (int) $image_size_data['width'],
          (int) $image_size_data['height'],
        );

        break;
      }
    }
  }

  
/**
 * Filters the 'wp_image_src_get_dimensions' value.
 *
 * @since 5.7.0
 *
 * @param array|false $dimensions    Array with first element being the width
 *                                   and second element being the height, or
 *                                   false if dimensions could not be determined.
 * @param string      $image_src     The image source file.
 * @param array       $image_meta    The image meta data as returned by
 *                                   'wp_get_attachment_metadata()'.
 * @param int         $attachment_id The image attachment ID. Default 0.
 */
  return apply_filters( 'wp_image_src_get_dimensions', $dimensions, $image_src, $image_meta, $attachment_id );
}
 

 View on GitHub View on Trac