Minn\Media

The primary image's size, bit depth and channels from a file's first bytes.

A canvas over a GD image already in hand (what WP_Image_Editor_GD::_save is given).

The GD image behind the canvas (what WP_Image_Editor_GD::_resize hands back).

A canvas from an image file, or null when it cannot be decoded or would not fit in memory. The header names the dimensions before a pixel is decoded, so a small file that claims a huge canvas is refused instead of taking the request down.

Resamples a source box onto a destination box.

A canvas cut to a rectangle, resized to a target when given.

A canvas turned by an angle, or null when GD refuses.

A canvas mirrored on either axis.

A canvas mirrored left to right.

An untouched copy of the canvas.

Writes the bitmap in the given format; the directory is created when missing.

The bitmap written progressively from now on (an interlaced JPEG).

The bitmap written line by line from now on, as it is by default.

Writes the image to the output in a format, at a quality.

The table: mime (extensions => type), allowed (the ones uploads take by default) and ext2type (kind => extensions).

Every extension's MIME type (wp_get_mime_types), as mime_types leaves them.

The types a user (the request's, unless one is given) may upload (get_allowed_mime_types): HTML and JavaScript too for one with unfiltered_html; then upload_mimes.

The extension and type a file name has among the types given (the allowed ones by default), false for each when none matches (wp_check_filetype).

The extensions of each kind (wp_get_ext_types), as ext2type leaves them.

The kind an extension is (wp_ext2type), or null.

The gallery shortcode's HTML for these attachments.

The gallery's opening element: its instance id, its post, columns and size as classes.

The style block printed before a gallery when use_default_gallery_style asks for it (themes without HTML5 galleries), as the reference prints it (probe filter-inputs-3): the items floated in equal whole-percent columns, a border on the images, the caption flush left.

The icon's address for a type or an attachment id.

The image type the file's header declares, or null.

The media library's filter groups: a MIME pattern (a top-level type, or a comma list of full types) => its plural label, its manage label, and the singular and plural count labels.

Real mime types grouped under the wildcard patterns that match them (image, audio/*, image/jpeg, *), the last pattern first; a pattern with no matches is omitted (probe post-remaining).

Whether a file is of a media type, by mime prefix or by extension list.

Whether an image location names the attachment's file, one of its sizes, or its original (probe media-tags): the location, its query dropped, must end with the stored path, or with the stored folder and a size's or the original's file name. A bare file name with no folder matches nothing.

The attachment metadata blob as an array, tolerant of anything missing.

The image_meta block a fresh upload carries.

EXIF is read for these image types only: JPEG and TIFF, both byte orders.

The metadata, the image type, the IPTC and EXIF it came from; null when there is no such file.

The largest box inside the limits that keeps the ratio: only sides over their limit shrink, the smaller ratio wins, and a result one pixel short of a limit it was constrained by snaps to that limit.

The GD-style resize box (dst x, dst y, src x, src y, dst w, dst h, src w, src h), or null when every asked dimension is larger than the image (nothing to make).

Whether a resize box makes the image's own size again, a pixel either way counting as rounding.

The registered size that serves a request: by name, or for a requested box the size of exactly that box, else the smallest larger one in its proportion (the full size never counts), else the thumbnail when it is wide enough; with its path and URL beside the file's.

The srcset candidates by width: every size on the image's ratio (and the same edit, when the file was edited) no wider than the cap, the source itself winning a width clash and passing the cap.

The srcset attribute for at least two sources; null for fewer.

The image sizes an attachment offers the editor, each with orientation. @param Closure(string): (array|false) $downsize

The old thumbnail an image's metadata names (its `thumb`), as a file beside the image with its size, while it is still there (probe image-downsize).

Null when the request carries no file.

The file a Content-Disposition names, as the reference reads one (probe rest-attachments-controller): the parameters after the disposition type, split on semicolons as written; the last non-empty filename= of all the headers, unquoted when double quotes wrap it. "filename" is matched as written, and filename* is not read. Null when none names one.

Why a raw body cannot be taken, in the reference's order: no data, no Content-Type, no Content-Disposition, one naming no file, a Content-MD5 the data does not match. Null when it can. The headers are the REST request's, keyed by lower-case names with underscores.

The mime type the extension maps to, or null for one the library refuses.

The post the client wants the file attached to: form field, query, or JSON body.

extension => canonical mime

The uploads directory on disk.

The uploads directory's URL.

The URL of a file by its relative path.

The path of a file by its relative path.

A safe file name: one extension. Every dot-separated part between the base and the last extension that is not itself an allowed extension is joined with an underscore, so "shell.php.png" lands as "shell_php.png" and no handler can be talked into running it.

A stored file's path relative to the uploads folder, or null for a file outside it.

Every file an attachment owns, in deletion order: the legacy thumb, each sub-size, the original image, the backup sizes, then the file itself.

Where uploads live, from the site's options: the default folder under wp-content, a relative upload_path under ABSPATH, or an absolute one; the URL likewise, with year/month subfolders when the site asks.

The width, height and kind a file's first bytes declare. @return array{width: int|false, height: int|false, type: string|false}

A stored file's address.

A stored file's path on disk.

A stored file's path relative to the uploads folder, or null for one outside it.