Editing Incubator escapee wiki:Extended image syntax (section)

===Size===
{{Shortcut|WP:PICSIZE}}
Any or none of these options may be specified to control the size of the image. In the case of images with captions, if the image is already smaller than the requested size, then the image retains its original size (it is not enlarged). In the case of images without captions, the image will be enlarged or reduced to match the requested size. Sizing is disabled when the [[#Type|type 'frame']] is use, with the size options being flagged as a [[Special:LintErrors/bogus-image-options|bogus file option]] at [[:Special:LintErrors]].

The default thumbnail width can be set in the preferences, so '''specifying in px is not recommended''' in order to respect the users' preferences, which may be important for accessibility. Exceptions can, of course, be made, but do try to use <code>upright</code> or the default if possible.

{{collapse|2=Implementation details|float=right|1=
{{anchor|Implementation details}} Specifying a size does not just change the apparent image size using HTML; it actually generates a resized version of the image on the fly and links to it appropriately. This happens whether or not you specify the size in conjunction with "thumb".

This means the server does all the work of changing the image size, not the web browser of the user. Having the server do all the work means faster downloading of pages. It also means that larger images can be stored on the server without any slowdown by the browser (especially on dial up telephone lines). Only the data for the actual size on the page is transmitted.

An exception is animated GIF images. Animated GIF images are not processed by the server. When a smaller size is specified the original full sized animated GIF image is served. Whether the animated GIF image is subsequently scaled to fit the allotted space belongs to the capabilities of the receiving browser. Resizing an animated GIF image will significantly reduce its quality, without any reduction of download time.

When there are two or more "size" options of the same type, only the last one is valid. However, if both an upright and an absolute size are used together, the absolute size always takes precedence, regardless of where it appears in the options.
}}

; ''(nothing specified)'' : For thumbnails, use the size specified in preferences for logged in users, and use a size determined by resolution for users who are not logged in. For non-thumbnails, use the native size of the image.
; <code>upright</code> {{nobold|or}} <code>upright=</code>''scaling factor'' : Scale a thumbnail's size to ''scaling factor'' times the default thumbnail size, rounding the result to the nearest multiple of 10. For instance, <code>upright=1.5</code> makes the image larger, which is useful for maps or schematics that need to be larger to be readable. The parameter <code>upright=1</code> returns the same size as thumbnail width, and <code>upright=0.75</code> is functionally identical to <code>upright</code> alone. If you set ''scaling factor'' equal to the image's aspect ratio (width divided by height) the result is equivalent to scaling the height to be equal to the normal thumbnail width.
: The <code>upright</code> option only works with the <code>thumb</code> or <code>frameless</code> parameter (see [[#Type|Type]]).
; ''Width''<code>px</code> : (''E.g.'' <code>100px</code>) Scale the image to make it the specified number of pixels in width, and scale the height to retain the original aspect ratio.
; <code>x</code>''Height''<code>px</code> : (''E.g.'', <code>x150px</code>) Scale the image to make it the specified number of pixels in height, and scale the width to retain the original aspect ratio.
; ''Width''<code>x</code>''Height''<code>px</code> : (''E.g.'' <code>100x150px</code>) Scale the image to be no wider and no higher than the specified number of pixels. The image '''will keep''' its original aspect ratio.