ImageResizer

A virtual file. Implementing this allows usage of your VirtualProvider without registering it with ASP.NET

Returns an opened stream to the file contents.

The virtual path of the file (relative to the domain, like /app/folder/file.ext)

Can be used by plugins to implement 'trial version' functionality. Not currently used.

Provides a useable base class that can be used to modify the behavior of ImageBuilder. When registered with an ImageBuilder instance, the ImageBuilder will call the corresponding methods on the extension prior to executing its own methods.

Not for external use. Inherit from BuilderExtension instead. Dual-purpose base class for both ImageBuilder and BuilderExtension Extensions can inherit and override certain methods. ImageBuilder inherits this method to utilize its extension invocation code. Each method of AbstractImageProcessor loops through all extensions and executes the same method on each. Provides a sort of multiple-inheritance mechanisim.

Creates a new AbstractImageProcessor with no extensions

Creates a new AbstractImageProcessor which will run the specified extensions with each method call.

Contains the set of extensions that are called for every method.

Extend this to allow additional types of source objects to be accepted by transforming them into Bitmap instances.

Extend this to allow additional types of source objects to be accepted by transforming them into Stream instances. First plugin to return a Stream wins.

Extensions are executed until one extension returns a non-null value. This is taken to mean that the error has been resolved. Extensions should not throw an exception unless they wish to cause subsequent extensions to not execute. If extensions throw an ArgumentException or ExternalException, it will be wrapped in an ImageCorruptedException instance. If the Bitmap class is used for decoding, read gdi-bugs.txt and make sure you set b.Tag to new BitmapTag(optionalPath,stream);

Extend this to support alternate image source formats. If the Bitmap class is used for decoding, read gdi-bugs.txt and make sure you set b.Tag to new BitmapTag(optionalPath,stream);

Extend this to modify the Bitmap instance after it has been decoded by DecodeStream or DecodeStreamFailed

Extend this to allow additional types of *destination* objects to be accepted by transforming them into a stream.

The method to override if you want to replace the entire pipeline. All Build() calls call this method first. Does nothing in ImageBuilder

Called for Build() calls that want the result encoded. (Not for Bitmap Build(source,settings) calls. Only override this method if you need to replace the behavior of image encoding and image processing together, such as adding support for resizing multi-page TIFF files or animated GIFs. Does NOT dispose of 'source' or 'source's underlying stream.

Most calls funnel through here. Default behavior configures an ImageState instance and calls Process(imageState); Shouldn't be overriden for any reason I can think of - use the appropriate virtual method under Process(). If an extension returns a Bitmap instance, it will be used instead of the default behavior. Does NOT dispose of 'source' or 'source's underlying stream.

Process.0 First step of the Process() method. Can replace the entire Process method if RequestAction.Cancel is returned. Can be used to add points to translate (for image maps), and also to modify the settings

Process.1 Switches the bitmap to the correct frame or page, and applies source flipping commands.

Process.2 Extend this to apply any pre-processing to the source bitmap that needs to occur before Layout begins

Process.3(Layout).0: This is the last point at which points to translate should be added. Only return RequestedAction.Cancel if you wish to replace the entire Layout sequence logic.

Process.3(Layout).1: This is where the points in the layout are flipped the same way the source bitmap was flipped (unless their flags specify otherwise)

Process.3(Layout).2: Rings 'image' and 'imageArea' are added to the layout.

Process.3(Layout).3: Add rings here to insert them between the image area and the padding

Process.3(Layout).4: Ring "padding" is added to the layout

Process.3(Layout).5: Add rings here to insert them between the padding and the border

Process.3(Layout).6: Ring "border" is added to the layout

Process.3(Layout).7: Add rings here to insert them between the border and the effect rings

Process.3(Layout).8: Effects such as 'shadow' are added here.

Process.3(Layout).9: Add rings here to insert them between the effects and the margin

Process.3(Layout).10: Margins are added to the layout

Process.3(Layout).11: Add rings here to insert them around the margin. Rings will be outermost

Process.3(Layout).anytime: Occurs when the layout is rotated. May be called anytime during Layout()

Process.3(Layout).anytime: Occurs after the layout is rotated. May be called anytime during Layout()

Process.3(Layout).anytime: Occurs when the layout is normalized to 0,0. May be called anytime during Layout()

Process.3(Layout).anytime: Occurs after the layout is normalized. May be called anytime during Layout()

Process.3(Layout).anytime: Occurs when the layout point values are rounded to integers. May be called anytime during Layout()

Process.3(Layout).anytime: Occurs after the layout point values are rounded to integers. May be called anytime during Layout()

Process.3(Layout).12: Occurs once layout has finished. No more changes should occur to points or rings in the layout after this method. destSize is calculated here.

Process.4: The destination bitmap is created and sized based destSize. A graphics object is initialized for rendering.

Process.5(Render) Rendering. Do not return RequestedAction.Cancel unless you want to replace the entire rendering system.

Process.5(Render).1 The background color is rendered

Process.5(Render).2 After the background color is rendered

Process.5(Render).3 Effects (such as a drop shadow or outer glow) are rendered

Process.5(Render).4 After outer effects are rendered

Process.5(Render).5 Image padding is drawn

Process.5(Render).6 After image padding is drawn

Process.5(Render).7: An ImageAttributes instance is created if it doesn't already exist.

Process.5(Render).8: The ImageAttributes instance exists and can be modified or replaced.

Process.5(Render).9: The image is copied to the destination parallelogram specified by ring 'image'.

Process.5(Render).10: After the image is drawn

Process.5(Render).11: The border is rendered

Process.5(Render).12: After the border is drawn

Process.5(Render).13: Any last-minute changes before watermarking or overlays are applied

Process.5(Render).14: Watermarks can be rendered here. All image processing should be done

Process.5(Render).15: Called before changes are flushed and the graphics object is destroyed.

Process.5(Render).16: Changes are flushed to the bitmap here and the graphics object is destroyed.

Process.5(Render).17: Changes have been flushed to the bitmap, but the final bitmap has not been flipped yet.

Process.6: Non-rendering changes to the bitmap object occur here, such as flipping. The graphics object is unavailable.

Process.7: Layout and rendering are both complete.

All plugins must implement this. Enables web.config addition and removal.

Installs the plugin in the specified Config instance. The plugin must handle all the work of loading settings, registering the plugin etc.

Uninstalls the plugin. Should reverse all changes made during Install

The Trial plugin cannot be removed using this method.

Default cache when DiskCache isn't installed. Useful for debugging purposes but unsuited for production use, and will use large quanities of RAM. (Scales to fewer than 5 concurrent requests). Serves content directly to the client from memory.

Provides caching behavior

Returns false if the cache is unable to process the request. If false, the caller should fall back to a different cache

Must update the cache if needed, then either rewrite, redirect or serve the cached data.

Installs the caching system as the first choice.

Removes the plugin.

Sends the response directly to the client with no caching logic.

Provides cache selection logic

Selects a caching system for the specified request and response

IResponseArgs implementation

A collection of data and callbacks that can be passed to a caching object.

A string derived from the request, which can contain any kind of data. To get a cache key that varies with the source modified date, it should be combined with the value of GetModifiedDateUTC() and hashed.

The rewritten querystring. Can be useful for caching systems that accept querystring arguments.

A file extension appropriate for the resulting data. May be different than the extension on the original request.

The content-type of the data, among other things. Set ResponseHeaders.ApplyDuringPreSendRequestHeaders to automatically write caching headers based on ResponseHeaders values. Caching systems that use redirects may use this data as hints when configuring caching on the remote server.

A delegate that returns the modified date of the source data.

True if a modified date is available for verifying cache integrity.

A callback method that will resize, encode, and write the data to the given stream.

A callback method to return the last modified date of the source file if available, or DateTime.MinValue if not.

A callback method that will resize and encode the image into a stream.

A value derived from the request. Can be used as a cache key.

True if the source file/record has a modified date

The rewritten querystring. Can be useful for caching systems that accept querystring arguments.

For virtual files who want to provide their data in Bitmap form (like a PSD reader or gradient generator)

Returns a Bitmap instance of the file's contents

A callback method that will resize, encode, and write the data to the given stream. Callback may throw FileNotFoundException when running on top of an optimistic VPP

A callback method to return the last modified date of the source file if available, or DateTime.MinValue if not available.

Provides basic encoding functionality for Jpeg, png, and gif output. Allows adjustable Jpeg compression, but doesn't implement indexed PNG files or quantized GIF files.

An image encoder. Exposes methods for suitability checking, encoding, transparency compatibility checking, and mime-type/extension calculation.

If the encoder can handle the requirements specified by 'settings' and 'source', it should return an encoder instance. If not, it should return null.

Request settings, like format, quality, colors, dither, etc. May be a Drawing.Image instance, a path, or null. To provide both, set Image.tag to the path. Helps the encoder detect the original format if the format was not specified. May also be used for palette generation hinting by some encoders.

Encodes the image to the specified stream

True if the output format will support transparency as it is currently configured.

Returns the appropriate mime-time for the output format as currently configured.

Returns a file extension appropriate for the output format as currently configured, without a leading dot.

For plugins that access the query string (important!)

If the plugin reads any values from the querystring, the names of the keys should be specified here. This information is required so that the HttpModule knows when to handle an image request.

Returns true if the this encoder supports the specified image format

Writes the specified image to the stream using Quality and OutputFormat

Tries to parse an ImageFormat from the settings.Format value. If an unrecogized format is specified, returns null. If an unsupported format is specified, it is returned. If *no* format is specified, returns defaultValue.

Attempts to determine the ImageFormat of the source image. First attempts to parse the path, if a string is present in original.Tag. (or if 'original' is a string) Falls back to using original.RawFormat. Returns null if both 'original' is null. RawFormat has a bad reputation, so this may return unexpected values, like MemoryBitmap or something in some situations.

The source image that was loaded from a stream, or a string path

Returns the ImageFormat enumeration value based on the extension in the specified physical path. Extensions can lie, just a guess.

Returns an string instance from the specfied ImageFormat. First matching entry in imageExtensions is used. Returns null if not recognized.

Returns a dict of (lowercase invariant) image extensions and ImageFormat values

Returns an ImageFormat instance from the specfied file extension. Extensions lie sometimes, just a guess. returns null if not recognized.

NOT thread-safe!

Supports Png, Jpeg, Gif, Bmp, and Tiff. Throws a ArgumentOutOfRangeException if not png, jpeg, gif, bmp, or tiff

Returns the first ImageCodeInfo instance with the specified mime type. Returns null if there are no matches.

Saves the specified image to the specified stream using jpeg compression of the specified quality.

A number between 0 and 100. Defaults to 90 if passed a negative number. Numbers over 100 are truncated to 100. 90 is a *very* good setting.

Saves the image in png form. If Stream 'target' is not seekable, a temporary MemoryStream will be used to buffer the image data into the stream

Returns the querystring keys used by DefaultEncoder (quality, format, and thumbnail)

If you set this to anything other than Gif, Png, or Jpeg, it will throw an exception. Defaults to Jpeg

0..100 value. The Jpeg compression quality. 90 is the best setting. Not relevant in Png or Gif compression

Returns true if the desired output type supports transparency.

Returns the default mime-type for the OutputFormat

Returns the default file extesnion for OutputFormat

Implementations should support being called on their own result multiple result without behavioral differences.

Encapsulates a node/attribute selection query, such as "node.node.attribute"

Returns a subset of the list starting at the specified index

Provides thread-safe access to plugin addition, removal, and querying methods

Returns a copy of the list of reported issues.

Adds the specified issue to the list unless it is an exact duplicate of another instance.

A provider (or selector) of IEncoder instances.

Returns an encoder based on the provided settings and the source object

Creates a new plugin config section, attached to the specified parent

Processes the <plugins> section if they are not already loaded. Thread safe. Only executes once.

Not thread safe. Performs actual work.

Returns the subset of AllPlugins which implement the specified type or interface

Returns true if at least one plugin of the specified type is registered.

Returns all registered instances of the specified plugins

Returns the first registerd instance of the specified plugin. For IMultiInstancePlugins, use GetAll()

Returns true if 1 or more instances of the type are registered.

Installs the specified plugin, returning the plugin instance. Convenience method, same as plugin.Install(Config.Current).

Attempts uninstallation of the specified plugin, returning true if successful. Convenience method, same as plugin.Uninstall(Config.Current).

Returns an instance of the first encoder that claims to be able to handle the specified settings. Returns null if no encoders are available.

Searches all loaded assemblies for the specified type, applying rules and prefixes to resolve the namespace and assembly. Returns null if it could not find the type, and logs an issue.

For use only by plugins during .Uninstall. Removes the specified plugin from AllPlugins, QuerystringPlugins, CachingSystems, ImageEncoders, and ImageBuiderExtensions, based on which interfaces the instance implements. Plugins may register event handlers and modify settings - thus you should use the plugin's method to uninstall them vs. using this method.

Only for use by plugins during IPlugin.Install. Call Plugin.Install instead of this method, since plugins often must perform other initialization actions. Adds the specified plugin to AllPlugins, QuerystringPlugins, CachingSystems, ImageEncoders, and ImageBuiderExtensions, based on which interfaces the instance implements. For ICache and IEncoder, the plugin is inserted at the beginning of CachingSystems and ImageEncoders respectively. To reiterate, plugins may register event handlers and modify settings - thus you should use the plugin's method to uninstall them vs. using this method. Will not register a plugin that is already installed, unless it implementes IMultiInstancePlugin.

Removes all plugins, of every kind. Logs any errors encountered. (Not all plugins support uninstallation)

Returns true if the <plugins> section has been processed

Currently registered set of ImageBuilderExtensions.

Currently registered IEncoders.

Currently registered ICache instances

Plugins which accept querystring arguments are registered here.

Plugins which accept new file extensions (in the url) are registered here.

Plugins which provide virtual files are registered here.

Plugins which modify image processing settings.

All plugins should be registered here. Used for diagnostic purposes.

Returns the most recently registered Logging plugin, or null.

Implement this to allow your class (or VirtualPathProvider subclass) to be used without registering it with the whole ASP.NET system.

Returns true if the specified file exists.

Returns a virtual file instance for the specified path and querystring.

True if the specified extension is one that the pipeline can handle

True if the querystring contains any directives that are understood by the pipeline

Removes the first fake extension detected at the end of 'path' (like image.jpg.ashx -> image.jpg).

Returns an ImageBuilder instance to use for image processing.

Returns a ICacheProvider instance that provides caching system selection and creation.

Returns an IVirtualFile instance if the specified file exists.

Returns true if (a) A registered IVirtualImageProvider says it exists, or (b) if the VirtualPathProvider chain says it exists.

The key in Context.Items to store the modified querystring (i.e, post-rewrite). Allows VirtualPathProviders to access the rewritten data.

The key in Context.Items to store the IResponseArgs object

The key in Context.Items to set if we want to cancel MVC routing for the request

The key in Context.Items to access a the path to use instead of Request.path

The behavior to use when accessing the file system.

Get or sets whether the file extension check should be applied to the current request. Defaults to true. If set to true, will only affect the current request, and will only cause the Resizer to evaluate the rewriting rules on the request. Processing may still not occur if no querystring values are specified. Add 'cache=always' to force caching to occur.

True once the InterceptModule has been installed.

Returns the value of Context.Items["resizer.newPath"] if present. If not, returns FilePath + PathInfo. Sets Context.Items["resizer.newPath"]. Only useful during the Pipeline.PostAuthorizeRequestStart event.

Populates the cache if it is empty. Not thread safe.

The specified path must not include a querystring. Slashes, spaces, question marks, ampersands, and colons are not permitted in the extension. If it contains a multipart extension like .txt.zip, only "zip" will be recognized.

Returns true if any of the querystring keys match any of the directives supported by the pipeline (such as width, height, format, bgcolor, etc)

Removes the first fake extensionm detected at the end of 'path'

Returns either an IVirtualFile instance or a VirtualFile instance.

Returns true if (a) A registered IVirtualImageProvider says it exists, or (b) if the VirtualPathProvider chain says it exists.

Cache selection occurs as follows: (1) The first registered CachingSystem that returns true from .CanProcess() is the default (2) The SelectCachingSystem event is fired, allowing handlers to modify the selected cache. This method may return null.

Returns a unqiue copy of the image extensions supported by the pipeline. Performs a cached query to all registered IQuerystringPlugin instances. Use IsAcceptedImageType for better performance.

Returns a unqiue copy of all querystring keys supported by the pipeline. Performs a cached query to all registered IQuerystringPlugin instances. Use HasPipelineDirective for better performance. (binary search)

Cached access to pipeline.fakeExtensions

Returns the modified query string. If never set, returns a copy of Request.QueryString. Returns the same instance if called multiple times. Copy it if you want to make changes without causing issues.

Returns true if the current request is being processed and/or cached by the pipeline. Will return false until *after* the FileExists method is called on the VirtualPathProviders, which is after the AuthorizeImage event fires. This will return a usable value if used from VirtualFile.Open(), or if used inside the PreHandleImage event or later.

Fired once, on the first PostAuthorizeRequest event.

Fires during the PostAuthorizeRequest phase, prior to any module-specific logic. Executes for every request to the website. Use only as a last resort. Other events occur only for image requests, and thus have lower overhead.

Fired during PostAuthorizeRequest, after ResizeExtension has been removed. On fired on requests with extensions that match supported image types. You can add additonal supported image extentions by registering a plugin that implementes IQuerystringPlugin, or you can add an extra extension in the URL and remove it here. Example: .psd.jpg

Fired during PostAuthorizeRequest, after Rewrite. Any changes made here (which conflict) will be overwritten by the the current querystring values. I.e, this is a good place to specify default settings. Only fired on accepted image types. (see Rewrite)

Fired after all other rewrite events. Only fired on accepted image types. (see Rewrite)

Fired after all rewriting is finished. e.AllowAccess defaults to the result of the UrlAuthorization module's verdict. It can be changed. Set e.AllowAccess to true to cause and 403 Access Dened result.

Fired when the specified image doesn't exist. Only called for images that would normally be processed. May be called during PostAuthorizeRequest or later - End the request completely with a redirect if you want alternate behavior.

Fired immediately before the image request is sent off to the caching system for proccessing. Allows modification of response headers, caching arguments, and callbacks.

The number of images processed by this pipeline.

True once the InterceptModule has been installed and is intercepting requests.

Allows gradients to be dynamically generated like so: /gradient.png?color1=white&color2=black&angle=40&width=20&height=100

Domain-relative path which also includes the path info portion. I.e, '/app/folder/file.aspx/path/info' could be a valid value. Relative to the domain root, not the site or app root.

An ordered, named collection of polygons. pointsToTranslate, imageOuterEdge, imageAreaOuterEdge.

Inflates the last ring using the specified padding options. Returns the resulting ring object

Gets a bounding box that encloses all rings that don't have ExcludeFromBoundingBox set.

Rotates all existing rings (Except those flagged ignore)

Normalizes all rings and invisible polygons so that the outermost ring's bounding box starts at the specified orign.

Scales all rings and invisible polygons by the specified factor, around the specified point.

Translates and scales all rings and invisible polygons as specified.

Access and set the Point[] arrays of rings by key. Case-insensitive.

Returns the last ring that was added. Only returns PointSets where flags = Ring

This polygon participates in the layout phase, and reserves space when added. Affected by all batch operations. Will be returned by LastRing until a new ring is added.

Doesn't participate in layout, takes no space, but is affected by batch operations. Will never be returned by LastRing and ignored when calculating bounding boxes.

Completely ignored by all operations, left intact.

How the pointsToTranslate should be translated if they are cropped out of the destination image.

Represents the widths of edges of a box.

Create a box with all edges the same width.

Create a box, specifying individual widths for each size

Copies the specified BoxPadding instance

Sets the width of all edges, returning a new instance

Gets edge offsets as a clockwise array, starting with Top.

Returns double.NaN unless all edges are the same width, in which case that width is returned

Returns an instance with a width of 0

Returns true if th

Allows customization of response headers for a processed image, as well as configuration of the caching system.

The mime-type of the output data. Defaults to null.

The cache setting. Defaults to private

The UTC time at which the cached data should expire. Browsers generally don't re-request resources until the they have expired (unlike modififeddate). If MinValue, will be ignored.

The UTC modified date send with the response. Used by browsers with If-Modified-Since to check a cached value is still valid. If = MinValue, will be ignored.

When true: If a client requests a refresh, the response will *still* be served from the server cache. Defaults to false

ASP.Net sometimes sends Vary: * which obliterates caching. Vary is to be avoided anyhow. Defaults to true

These headers should be applied first, prior to the application of other settings

These headers are applied after applying all of the other settings. (and they will overwrite exisiting values).

Returns a collection of dependencies used for invalidating the server cache. Note, having items here will disable kernel-mode caching. Perhaps it is better to simply use LastModified

A delegate method to apply the values stored in IResponseHeaders to the specified HttpContext.

True if the application should automatically execute ApplyToResponse() during the PreSendRequestHeaders event.

We duplicate efforts in PostRewrite to ensure that the DiskCache doesn't block configuration changes. This won't help CloudFront, however.

The default scale mode to use when 'width' and/or 'height' are used, and mode is not 'max'.

The default scale mode to use when 'maxwidth' and/or 'maxheight' are used (or mode=max).

Functions exactly like an IIS virtual folder, but doesn't require IIS configuration.

Tag your plugin with this interface if it supports having multiple instances registered at once

Registers the VirtualFolder plugin as a virtual path provider.

Converts a virtual path in this folder to a physical path. Returns null if the virtual path is outside the folder.

Returns true if the specified path is inside this virtual folder

Returns the LastWriteTimeUtc value for the specified virtual file in this folder, or DateTime.MinValue if missing.

Returns true if the file exists in this virtual folder, and would not be masking an existing file. Returns false if NoIOPermission is true.

Unless the path is not within the virtual folder, or IO permissions are missing, will return an IVirtualFile instance for the path. The file may or may not exist.

For internal use only by the .NET VPP system.

True if the provider attempted to register itself as a VirtualPathProvider and failed due to limited security clearance. False if it did not attempt (say, due to missing IOPermission) , or if it succeeded.

If true, the plugin will attempt to register itself as an application-wide VirtualPathProvider instead of a image resizer-specific IVirtualImageProvider.

The virtual path served by the VirtualFolder

The physical path

True if the plugin has detected it doesn't have sufficient IOPermission to operate.

Always implement this if possible. Allows caching systems to detect changes to source files and invalidate cached data properly.

The modified (last write time) of the source file, in UTC form.

Returns an new NameValueCollection instance that only includes the "preset" and ("hmac" and "urlb64", if specified) querystring pairs from the specified instance.

If true, the plugin will block all commands except those specified in a preset, and the &preset command itself. Only applies to InterceptModule (the URL API). Does not apply to ImageBuilder.Build calls. To replicate the behavior, simply prevent any querystring keys except 'preset' from being passed to ImageBuilder.Build.

No support for namespaces, no intention of eventual serialization. Everything is case-insensitive, but preserves case. Not thread safe.

Builds a tree of Nodes from the specified XML subtree. Duplicate attributes are sent to 'ir'

Returns the subset of Children with a matching element name. (Case-insensitive)

Queryies the subtree for the specified attribute on the specified element. Example selector: element.element.attrname Assumes that the last segment of the selector is an attribute name. Throws an ArgumentException if there is only one segment ( element ). Uses the cache.

Sets the specified attribute value, creating parent elements if needed. Clears the query cache.

Traverses the specified path, creating any missing elements along the way. Uses existing nodes if found.

Same as query(), except results are cached until clearQueryCache() is called. Faster, but can be incorrect if existing nodes are renamed, moved, or deleted.

Makes a recusive copy of the subtree, keeping no duplicate references to mutable types.

Attributes

The name of the element.

Child nodes

Returns true if the element has neither attributes nor children.

Copies a read stream to a write stream.

Represents an non-recoverable exception that occured while processing the image. Possible causes are: a corrupted source file, cache resource timeout (such as a locked file in imagecache), unusable configuration (for example, no registered encoders or caches), invalid syntax, or a size limit was exceeded and the request was stopped by the SizeLimiting extension. May also be caused by a missing source file/resource, in the form of the ImageMissingException subclass.

This error message is safe to display to the public (should not contain any sensitive information)

A source file was corrupted

One or more source files was missing

When to disk cache the image

Request no caching of the resulting image.

Request that the resulting image always be cached on the server, even if no modifications are made.

Default caching behavior. Modified images are cached, unmodified images are not cached.

When to process and re-encode the image.

Request no processing of the image or file (generally used with cache=always). The file contents will be used as-is.

Require the file or image to be processed. Will cause non-image files to fail with an ImageCorruptedException.

Default. Only files with both a supported image extension and resizing settings specified in the querystring will be processed.

Controls whether the image is allowed to upscale, downscale, both, or if only the canvas gets to be upscaled.

The default. Only downsamples images - never enlarges. If an image is smaller than 'width' and 'height', the image coordinates are used instead.

Only upscales (zooms) images - never downsamples except to meet web.config restrictions. If an image is larger than 'width' and 'height', the image coordinates are used instead.

Upscales and downscales images according to 'width' and 'height', within web.config restrictions.

When the image is smaller than the requested size, padding is added instead of stretching the image

[Deprecated (Use FitMode.Stretch)] Previously used to force an image to be 'stretched' to match a different aspect ratio.

[Deprecated (Use FitMode)] Maintains aspect ratio. Default.

[Deprecated (Use FitMode)] Skews image to fit the new aspect ratio defined by 'width' and 'height'

How do deal with aspect ratio differences between the requested size and the original image's size.

Fit mode will be determined by other settings, such as &carve=true, &stretch=fill, and &crop=auto. If none are specified and width/height are specified , &mode=pad will be used. If maxwidth/maxheight are used, &mode=max will be used.

Width and height are considered maximum values. The resulting image may be smaller to maintain its aspect ratio. The image may also be smaller if the source image is smaller

Width and height are considered exact values - seam carving is used if there is an aspect ratio difference. Requires the SeamCarving plugin to be installed, otherwise behaves like 'pad'.

Width and height are considered exact values - if there is an aspect ratio difference, the image is stretched.

Default. No cropping - uses letterboxing if strecth=proportionally and both width and height are specified.

[Deprecated] Use Mode=Crop. Minimally crops to preserve aspect ratio if stretch=proportionally.

Crops using the custom crop rectangle. Letterboxes if stretch=proportionally and both widht and height are specified.

Indicates the crop units are pixels on the original image.

Indicates a custom range is being specified for the values. Base 0.

Wraps a standard ASP.NET VirtualFile instance in an IVirtualFile-compatible wrapper.

The VirtualFile instance this class is wrapping

Creates a 'gatherer' that pulls issues from IIssueProviders throughout the Config structure. Even plugins are queried.

Provides default client-caching behavior. Sends Last-Modified header if present, and Expires header if <clientcache minutes="value" /> is configured. Also defaults Cache-control to Public for anonymous requests (and private for authenticated requests)

Loads NLog configuration from the specified file.

The name of the file to load NLog configuration from.

Creates the specified logger object and assigns a LoggerName to it.

Logger name. The new logger instance.

Monitors incoming image requests to determine if resizing (or other processing) is being requested.

Called when the app is initialized

This is where we filter requests and intercept those that want resizing performed. We first strip FakeExtension, then verify the remaining file extension is supported for decoding. We fire URL rewriting events. If the result includes any supported querystring params afterwards, we process the request. Otherwise we let it fall back to IIS/ASP.NET. If the file doesn't exist, we also ignore the request. They're going to cause a 404 anyway.

Generates the resized image to disk (if needed), then rewrites the request to that location. Perform 404 checking before calling this method. Assumes file exists. Called during PostAuthorizeRequest

We don't actually send the data - but we still want to control the headers on the data. PreSendRequestHeaders allows us to change the content-type and cache headers at excatly the last

Current configuration. Same as Config.Current.Pipeline

What to do about remaining handlers/methods for the specified section

Does nothing

Requests that ImageBuilder cancels the default logic of the method, and stop executing plugin calls for the method immediately.

Implements app-wide size Limits on image size

The image and total size limits

SafeList is mutable, but it uses immutable data structures to minimize the need for locking. The provided manipulation Exposes a immutable list. Changes are made by copying the lists. SafeList is Never perform logic on SafeList directly, always use GetList() or GetCollection() first, followed by SetList(). If you need involved list-fu, use ModifyList and specify a callback. It will execute inside a lock, preventing changes on other threads from overwriting each other.

Returns an immutable snapshot of the collection

Returns a mutable snapshot of the list

Replaces the current collection with a new one. (copied to ensure safety) Use ModifyList when modifying the list. Use this only when the previous or current state of the list is irrelevant.

Adds the specified item to the end of the list

Removes the item from the list

Adds the specified item to the beginning of the list

Allows a caller to perform logic on the list inside a lock, and return a modified list. Callbacks should be fast, and should reference the IList they are fed, not this SafeList instance. Calling methods on the SafeList instance will cause a deadlock.

Returns true if the collection contains the specified item at the moment.

Returns the first item in the list. May return null if the list is empty.

Adds drop shadow capabilities (shadowColor, shadowOffset, and shadowWidth commands)

The mime-type of the encoded image. Defaults to null

Shorthand method for ImageBuilder.Current.Build(this)

Internal use only. Resolves the specified (potenetially templated) path into a physical path. Applies the AddFileExtension setting using the 'ext' variable. Supplies the guid, settings.*, filename, path, and originalExt variables. The resolver method should supply 'ext', 'width', and 'height' (all of which refer to the final image). If AllowDestinationPathVariables=False, only AddFileExtenson will be processed.

Leave 0 if unavailable Leave 0 if unavailable Leave null if unavailable

The source image's physical path, app-relative virtual path, or a Stream, byte array, Bitmap, VirtualFile, IVirtualFile, HttpPostedFile, or HttpPostedFileBase instance.

The destination Stream, physical path, or app-relative virtual path. If a Bitmap instance is desired, set this to typeof(System.Drawing.Bitmap). The result will be stored in .Result

The result if a Bitmap, BitmapSource, or IWICBitmapSource instance is requested.

The image processing settings

If true, and if 'source' is a IDisposable instead like Bitmap or Stream instance, it will be disposed after it has been used. Defaults to true.

If true, and if 'source' is seekable, the stream will be reset to its previous position after being read. Always true for HttpPostedFile(Base) instances, defaults to false for all others.

If true, and if 'dest' is a Stream instance, it will be disposed after the image has been written. Defaults to false.

Contains the final physical path to the image (if 'dest' was a path - null otherwise)

If 'source' contains any path-related data, it is copied into this member for use by format detetction code, so decoding can be optimized. May be a physical or virtual path, or just a file name.

If true, the appropriate extension for the encoding format will be added to the destination path, and the result will be stored in FinalPath in physical path form.

Defaults to false. When true, the parent directory of the destination filename will be created if it doesn't already exist.

Allows subclasses to be used instead of ImageBuilder. Replacements must override the Create method and call their own constructor instead.

Shortuct to CurrentImageBuilder.Build (Useful for COM clients). Also creates a destination folder if needed, unlike the normal .Build() call.

Returns a deep copy of the specified node

Returns a deep copy if the current state of the configuration tree (starting with the 'resizer' element as the root)

Replaces the configuration tree with the specified alternative

Writes a diagnostic page to the specified physical path

Returns a string of the diagnostics page

Gets the current (app-wide) config instance.

Access and modify plugins

Access and modify settings related to the HttpModule pipline. Register URL rewriting hooks, etc.

Returns a shared instance of ImageManager, (or a subclass if it has been upgraded). Instances change whenever ImageBuilderExtensions change.

The ResizeConfigrationSection is not thread safe, and should not be modified Dynamically loads the ResizerSection from web.config when accessed for the first time. If the resizer node doesn't exist, an empty configuration object is created with just the root resizer node.

Returns a list of all issues reported by the resizing core, as well as by all the plugins

Causes IE6 and earlier to use GIF versions of PNG files. By default, only fixes requests with ?iefix=true in the querystring. When catchall is enabled, it will filter all png images, unless iefix=false on those requests. Not compatible with CDNs or proxy servers, as they do not allow varying by user agent reliably.

Returns true if the specified querystring and file will cause a PNG file to be returned.

Returns true if the user agent string specifies MSIE versions 1 through 6 for Windows. Cached in context.Items after first call.

If true, 'iefix=true' will be the default for all PNG images, instead of 'iefix=false'.

If true, the requests from IE will be HTTP redirected to new URLs. If false, the GIF will be silently served instead of the PNG, without any redirection. A CDN or caching proxy will mess things up regardless, but using redirection ensures that the CDN/proxy never caches the GIF version instead of the PNG.

Rounds the elements of the specified array [not used]

Modifies the specified array by applying the specified function to each element.

object delegate(object o){}

Rotates the specified polygon (or set of points) around the origin.

Returns a clockwise array of points on the rectangle. Point 0 is top-left.

Moves the polygon so that the upper-left corner of its bounding box is located at 0,0.

Rotates the specified point around the origin.

Rotates the specified point around the specified origin.

Returns a modified version of the specified vector with the desired length.

Returns a bounding box for the specified set of points.

Returns a modified version of the array, with each element being offset by the specified amount.

Returns true if the member elements of the specified arrays match, and the arrays are of the same length.

Moves element 4 to spot 3 and truncates to 3 elements. For compatiblity with Graphics.DrawImage

Determines the width and height of the paralellogram.

Grabs a single-dimension array from a 2 dimensional array, using the specified primary index.

Approximates a radial brush using a high-rez PathGradientBrush.

Scales 'inner' to fit inside 'bounding' while maintaining aspect ratio. Upscales and downscales.

Scales 'outer' to be equal or larger than 'innerBounds' while maintaining aspect ratio. Upscales and downscales.

Scales 'inner' to fit inside 'bounding' while maintaining aspect ratio. Only downscales.

Returns true if 'inner' fits inside or equals 'outer'

Returns an array of parallelograms. These parallelgrams are the 'corners' outside each vertex in 'poly'. The adjacent edges are perpendicular to 'poly'. Point 1 of each parallelogram will match the respective point in 'poly' Points are clockwise. TODO - some rounding issues going on, not exact numbers here

Returns an array of parallelograms. These parallelgrams are the 'corners' outside each vertex in 'poly'. The adjacent edges are perpendicular to 'poly'. Point 1 of each parallelogram will match the respective point in 'poly' Points are clockwise. Each float in widths[] corresponds to the point in poly[]. This is the distance to go perpendicularly from the line beween poly[i] and poly[i +1].

Returns an array of parallelograms. These parallelgrams are the 'sides' bounding the polygon. Points are clockwise. Point 1 is the top-left outer point, point 2 the top-right, point 3 the bottom-right, and point 4 the bottom-left.

Expands all sides on the specified polygon by the specified offset. Assumes the polygon is concave. Returns a new polygon

Expands all sides on the specified polygon by the specified offsets. Assumes the polygon is concave. Returns a new polygon.

An array the same size as poly[], with the distances to expand the edges. Edges are between i and i+1

Moves 'inner' so that the center of its bounding box equals the center of the bounding box of 'outer'

Creates a rectangle of size 'size' with a center matching that of bounds.

Rounds a floating-point rectangle to an integer rectangle using System.Round

Aligns the specified rectangle object with its reference ('container') rectangle using the specified alignment. The container can be smaller than 'obj'.

Aligns the specified polygon with its container (reference) polygon using the specified alignment. The container can be smaller than 'obj'.

Returns a point equidistant beweteen A and B

Verifies that the specified 4 points are not rotated - that each point shares either the x or y coordinate with the previous point

Provides methods for generating resized images, and for reading and writing them to disk. Use ImageBuilder.Current to get the current instance (as configured in the application configuration), or use ImageBuilder.Current.Create() to control which extensions are used.

For plugins that add support for new source file image extensions.

If the plugin adds support for new file extensions (such as "psd"), they should be returned by this method.

Shouldn't be used except to make a factory instance.

Create a new instance of ImageBuilder using the specified extensions, encoder provider, file provider, and settings filter. Extension methods will be fired in the order they exist in the collection.

Creates another instance of the class using the specified extensions. Subclasses should override this and point to their own constructor.

Copies the instance along with extensions. Subclasses must override this.

Loads a Bitmap from the specified source. If a filename is available, it will be attached to bitmap.Tag in a BitmapTag instance. The Bitmap.Tag.Path value may be a virtual, relative, UNC, windows, or unix path. Does not dispose 'source' if it is a Stream or Image instance - that's the responsibility of the calling code.

May be an instance of string, VirtualFile, IVirtualFile IVirtualBitmapFile, HttpPostedFile, Bitmap, Image, or Stream. If passed an Image instance, the image will be cloned, which will cause metadata, indexed state, and any additional frames to be lost. Accepts physical paths and application relative paths. (C:\... and ~/path) Will ignore ICC profile if ?ignoreicc=true. A Bitmap. The .Tag property will include a BitmapTag instance. If .Tag.Source is not null, remember to dispose it when you dispose the Bitmap.

May be an instance of string, VirtualFile, IVirtualFile IVirtualBitmapFile, HttpPostedFile, Bitmap, Image, or Stream. If passed an Image instance, the image will be cloned, which will cause metadata, indexed state, and any additional frames to be lost. Accepts physical paths and application relative paths. (C:\... and ~/path) Will ignore ICC profile if ?ignoreicc=true. If true, the position of the source stream will be restored after being read A Bitmap. The .Tag property will include a BitmapTag instance. If .Tag.Source is not null, remember to dispose it when you dispose the Bitmap.

Decodes the stream into a System.Drawing.Bitmap instance. As of 3.0.7, now ensures the stream can safely be closed after the method returns. May copy the stream. The copied stream will be in b.Tag.Source. Does not close or dispose any streams.

For plugin use only. Returns a stream instance from the specified source object and settings object. To exend this method, override GetStream.

The physical or app-relative path, or a VirtualFile, IVirtualFile, Stream, HttpPostedFile, or HttpPostedFileBase instance. Querystring settings to pass to the VirtualFileProvider You should externally initialize this to true, unless the user-provided 'source' is a Stream instance. Will be set to false for HttpPostedFile and HttpPostedFileBase instances, so they can be reused. The physical or virtual path associated with the stream (if present). Otherwise null True if you should save and restore the seek position of the stream. True for HttpPostedFile and HttpPostedFileBase instances.

Resizes and processes the specified source image and returns a bitmap of the result. Note! This method assumes that transparency will be supported in the final output format, and therefore does not apply a matte color. Use &bgcolor to specify a background color if you use this method with a non-transparent format such as Jpeg. If passed a source Stream, Bitmap, or Image instance, it will be disposed after use. Use disposeSource=False to disable that behavior.

May be an instance of string (a physical path), VirtualFile, IVirtualBitmapFile, HttpPostedFile, Bitmap, Image, or Stream. Resizing and processing command to apply to the.

May be an instance of string (a physical path), VirtualFile, IVirtualBitmapFile, HttpPostedFile, Bitmap, Image, or Stream. Resizing and processing command to apply to the. If false, 'source' will not be disposed.

Resizes and processes the specified source image and stores the encoded result in the specified destination. If passed a source Stream, Bitmap, or Image instance, it will be disposed after use. Use disposeSource=False to disable that behavior.

May be an instance of string (a physical path or app-relative virtual path), VirtualFile, IVirtualBitmapFile, HttpPostedFile, Bitmap, Image, or Stream. App-relative virtual paths will use the VirtualPathProvider system May be a physical path (string), or a Stream instance. Does not have to be seekable. Resizing and processing command to apply to the image.

Resizes and processes the specified source image and stores the encoded result in the specified destination. If passed a source Stream, Bitmap, or Image instance, it will not be disposed unless disposeSource=true.

Override this when you need to override the behavior of image encoding and/or Bitmap processing Not for external use. Does NOT dispose of 'source' or 'source's underlying stream.

Override this when you need to override the behavior of Bitmap processing. Not for external use. Does NOT dispose of 'source' or 'source's underlying stream.

True if the output method will support transparency. If false, the image should be provided a matte color

Processes an ImageState instance. Used by Build, GetFinalSize, and TranslatePoint. Can be overriden by a plugin with the OnProcess method

Process.3: Handles the layout phase of Processing

Handles the rendering phase of processing

Process.1 Switches the bitmap to the correct frame or page, and applies source flipping commands

Creates a bitmap of s.destSize dimensions, intializes a graphics object for it, and configures all the default settings.

Sets the background color if needed or requested

Doesn't support flipping. Translate a point on the original bitmap to a point on the new bitmap. If the original point no longer exists, returns Empty

Gets the final size of an image

Populates copyRect, as well as Rings image and imageArea. Translates and scales any existing rings as if they existed on the original bitmap.

Returns a list of the file extensions ImageBuilder can load by default. Plugins can implement IFileExtensionPlugin to add new ones.

Returns a list of the querystring commands ImageBuilder can parse by default. Plugins can implement IQuerystringPlugin to add new ones.

Handles the encoder selection and provision proccess.

May be null. A class to modify or normalize ResizeSettings instances before they are used.

Provides a resolution service for app-relative URLs.

Returns a shared instance of ImageBuilder or a subclass, equivalent to Config.Current.CurrentImageBuilder

Writes the diagnostic message at the specified level.

The log level. A to be written.

Writes the diagnostic message at the Trace level.

A to be written.

Writes the diagnostic message at the Debug level.

A to be written.

Writes the diagnostic message at the Info level.

A to be written.

Writes the diagnostic message at the Warn level.

A to be written.

Writes the diagnostic message at the Error level.

A to be written.

Writes the diagnostic message at the Fatal level.

A to be written.

Checks if the specified log level is enabled.

The log level. A value indicating whether the specified log level is enabled.

Gets a value indicating whether the Trace level is enabled.

Gets a value indicating whether the Debug level is enabled.

Gets a value indicating whether the Info level is enabled.

Gets a value indicating whether the Warn level is enabled.

Gets a value indicating whether the Error level is enabled.

Gets a value indicating whether the Fatal level is enabled.

Gets or sets the logger name.

Enforces two kinds of maximum size constraints: a Total size limit, and an Image size limit. Image limits do not include padding, border, or effect widths, and automatically shrink the 'width/height/maxwidth/maxheight' values to fit within the limits. Total limits are absolute and apply to the actual result dimensions, causing an exception if they are exceeded. Limits are checked during the layout phase, prior to resource-intensive bitmap operations.

The maximum final size an image generated by ImageBuilder can be. Defaults to 3200x3200

What action to take when the total size of the final image would exceed the TotalSize value. Defaults to ThowException

Returns true if ImageSize is specified.

The maximum size an un-rotated image can be drawn when creating a resized image. Rotation will increase the total size, as will any borders, paddings, margins, or effects. Not effective at preventing attacks, use totalSize. If larger values are specified in a querystring, they will automatically be scaled to fit within these dimensions. Defaults to 0x0, which means no limits

Matches /resize(x,y,f)/ syntax Fixed Bug - will replace both slashes.. make first a lookbehind

Parses and removes the resize folder syntax "resize(x,y,f)/" from the specified file path. Places settings into the referenced querystring

The collection to place parsed values into

Security and stability issues.

Behavioral issues, such as having no registered image encoders

Errors in the module configuration

Non-optimal settings

Adds URL syntax support for http://webimageresizer.codeplex.com/, http://imagehandler.codeplex.com/, http://bbimagehandler.codeplex.com/, http://dynamicimageprocess.codeplex.com/, and http://bip.codeplex.com/

Parses lists in the form "3,4,5,2,5" and "(3,4,40,50)". If a number cannot be parsed (i.e, number 2 in "5,,2,3") defaultValue is used.

Copies all remaining data from 'source' to 'dest'

Returns RotateNoneFlipNone if not a recognized value.

Returns 0 if not a recognized value. Rounds the value to 0, 90, 180, or 270

Throws an exception if the specified value is unsupported. Rotation values are not supported, and should be specified with the Rotate or srcRotate command.

Parses padding, allowing syntax (all) and (left, top, right, bottom). Parens are optional.

Draws a gradient around the specified polygon. Fades from 'inner' to 'outer' over a distance of 'width' pixels.

Sets the file extension of the specified path to the specified value, returning the result. If an extension has multiple parts, it will replace all of them. Leading dots will be stripped from 'newExtension' and re-addd as required.

Removes all extension segments from the filename or URL, leaving the querystring intact. I.e, image.jpg.bmp.tiff?hi would be image?hi

Removes the extension from the filename or URL, leaving the querystring intact, where the extension is only the last extension segment. I.e, image.jpg.bmp.tiff?hi would be image.jpg.bmp?hi after this call.

Adds the specified extension to path, returning the result. Multiple calls will result in "path.ext.ext.ext.ext". maintains the querystring as-is.

Will return the full extension, like ".jpg.ashx", not just the last bit. Ignores the querystring part. Excludes extensions containing spaces or slashes.

Ignores the querystring. Grabs the last segment of the filename extension. Returns an empty string if there is no extension, or if the extension contains a space. Includes the leading '.'

Turns relative paths into domain-relative paths. Turns app-relative paths into domain relative paths.

Joins the path and querystring. If the path already contains a querystring, they are 'append joined' with the correct character.

Overwrites exisisting querystring values in 'path' with the values in 'newQuerystring'. Doesn't support ; querystrings

Adds the querystring values in 'newQuerystring' to the querystring in Path, but does not overwrite values. Doesn't support ; querystrings

Returns a string querystring in the form "?key=value&key=value". Keys and values are UrlEncoded as they should be.

Returns a string querystring in the form "?key=value&key=value". Keys and values are UrlEncoded if urlEncode=true.

Removes the query string from the specifed path. If the path is only a querystring, an empty string is returned.

Like ParseQueryString, but permits the leading '?' to be omitted.

Parses the querystring from the given path into a NameValueCollection. accepts "file?key=value" and "?key=value&key2=value2" formats. (no path is required) UrlDecodes keys and values.

Converts aribtrary bytes to a URL-safe version of base64 (no = padding, with - instead of + and _ instead of /)

Converts a URL-safe version of base64 to a byte array. (no = padding, with - instead of + and _ instead of /)

Converts aribtrary strings to a URL-safe version of base64 (no = padding, with - instead of + and _ instead of /)

Converts a URL-safe version of base64 to a string. 64U is (no = padding, with - instead of + and _ instead of /)

Returns the physcial mapped path for the specified virtual path if it starts with ~, otherwise retuns the original path.

Generates a resized image url for the specified physical or virtual path. Not CloudFront compatible. Does not support remote URLs, use RemoteReader for that. If you're running in IIS classic, add ".ashx" to the 'path' parameter.

Attempts to guess the virtual path from physical path. Will be thrwarted if the path is mapped as a virtual folder inside the application. If the path is a non-physical path, it will be returned as is. Returns null if the physical path isn't a subfolder of the application's physical path.

Replaces variables in paths with their values. Ex. ~/uploads/thumbs/<guid>.<ext>. Standard variables are <ext> (the default extension for the final file type), <guid>, a randomly generated GUID, <filename>, the original filename without it's extension, <path>, the original path and filename without extension, <settings.width>, (any specified settings value except preset), <width> (final width), and <height> (final height).

Allows a string to be filtered using the specified whitelisting expression (regex style). I.e, "hi YOU 3", "a-z3" will produce "hi3".

Returns HostingEnvironment.ApplicationVirtualPath or "/", if asp.net is not running

If not running in ASP.NET, returns the folder containing the DLL.

A method that resolves variable names to values for the ResolveVariablesInPath method

Handles reading the <resizer> section from Web.Config

Create a ResizerSection instance that wraps the specified node. The node should be a <resizer> element.

Parse the specified XML into a Node. The text should include 1 root element, <resizer>

Returns the specified subtree, deep copied so it can be used without locking.

Called for each child element not specified declaratively

Builds a key for the cached version, using the hashcode of the normalized URL. if subfolders > 1, dirSeparator will be used to separate the subfolder and the key. No extension is appended. I.e, a13514\124211ab132592 or 12412ababc12141

Returns a string for the subfolder name. The bits used are from the end of the hash - this should make the hashes in each directory more unique, and speed up performance (8.3 filename calculations are slow when lots of files share the same first 6 chars. Returns null if not configured. Rounds subfolders up to the nearest power of two.

Returns the ASP.NET trust level

Represents the settings which will be used to process the image. Extends NameValueCollection to provide friendly property names for commonly used settings.

Creates an empty settings collection.

Copies the specified collection into a new ResizeSettings instance.

Parses the specified querystring into name/value pairs. leading ? not required.

Creates a new resize settings object with the specified resizing settings

The desired image format, like 'jpg', 'gif', or 'png'. Leave null if you want to preserve the original format.

Returns true if any of the specified keys are present in this NameValueCollection

If 'thumbnail' and 'format' are not specified, sets 'format' to the specified value.

Returns a string containing all the settings in the class, in querystring form. Use ToStringEncoded() to get a URL-safe querystring. This method does not encode commas, spaces, etc.

Returns a querystring with all the settings in this class. Querystring keys and values are URL encoded properly.

["width"]: Sets the desired width of the image. (minus padding, borders, margins, effects, and rotation). The only instance the resulting image will be smaller is if the original source image is smaller. Set Scale=Both to upscale these images and ensure the output always matches 'width' and 'height'. If both width and height are specified, the image will be 'letterboxed' to match the desired aspect ratio. Use maxwidth/maxheight, crop=auto, or stretch=fill to avoid this behavior.

["height"]: Sets the desired height of the image. (minus padding, borders, margins, effects, and rotation) The only instance the resulting image will be smaller is if the original source image is smaller. Set Scale=Both to upscale these images and ensure the output always matches 'width' and 'height'. If both width and height are specified, the image will be 'letterboxed' to match the desired aspect ratio. Use maxwidth/maxheight, crop=auto, or stretch=fill to avoid this behavior.

["maxwidth"]: Sets the maximum desired width of the image. (minus padding, borders, margins, effects, and rotation). The image may be smaller than this value to maintain aspect ratio when both maxwidth and maxheight are specified.

["quality"]: The jpeg encoding quality to use. (10..100). 90 is the default and best value, you should leave it.

["maxheight"]: Sets the maximum desired height of the image. (minus padding, borders, margins, effects, and rotation). The image may be smaller than this value to maintain aspect ratio when both maxwidth and maxheight are specified.

["mode"]: Sets the fit mode for the image. max, min, pad, crop, carve, stretch

["rotate"] The degress to rotate the image clockwise. -360 to 360.

How to anchor the image when cropping or adding whitespace to meet sizing requirements.

Allows you to flip the entire resulting image vertically, horizontally, or both. Rotation is not supported.

["sFlip"] Allows you to flip the source image vertically, horizontally, or both. Rotation is not supported.

["scale"] Whether to downscale, upscale, upscale the canvas, or both upscale or downscale the image as needed. Defaults to DownscaleOnly when maxwidth/maxheight is used, and Both when width/height are used.

[Deprecated] (Replaced by mode=stretch) Whether to preserve aspect ratio or stretch to fill the bounds.

["cache"]: Server caching mode suggestion for the result

["process"]: Server processing suggestion for the result. Allows you to 'disable' processing of the image (so you can use disk caching with non-image files). Allows you to 'force' processing of the image, for images without a querystring.

["crop"]=none|auto Defaults to None - letterboxing is used if both width and height are supplied, and stretch = proportionally. Set CropTopLeft and CropBottomRight when you need to specify a custom crop rectangle.

4 values specify x1,y1,x2,y2 values for the crop rectangle. Negative values are relative to the bottom right - on a 100x100 picture, (10,10,90,90) is equivalent to (10,10,-10,-10). And (0,0,0,0) is equivalent to (0,0,100,100).

["crop"]=([x1],[y1],x2,y2). Sets x1 and y21, the top-right corner of the crop rectangle. If 0 or greater, the coordinate is relative to the top-left corner of the image. If less than 0, the value is relative to the bottom-right corner. This allows for easy trimming: crop=(10,10,-10,-10). Set ["cropxunits"] and ["cropyunits"] to the width/height of the rectangle your coordinates are relative to, if different from the original image size.

["crop"]=(x1,y1,[x2],[y2]). Sets x2 and y2, the bottom-right corner of the crop rectangle. If 1 or greater, the coordinate is relative to the top-left corner of the image. If 0 or less, the value is relative to the bottom-right corner. This allows for easy trimming: crop=(10,10,-10,-10). Set ["cropxunits"] and ["cropyunits"] to the width/height of the rectangle your coordinates are relative to, if different from the original image size.

["bgcolor"]: Named and hex values are supported. (rgb and rgba, both 3, 6, and 8 digits).

Gets/sets ["paddingColor"]. Named and hex values are supported. (rgb and rgba, both 3, 6, and 8 digits).

["paddingWidth"]: Gets/sets the width(s) of padding inside the image border.

["margin"]: Gets/sets the width(s) of the margin outside the image border and effects.

Gets/sets ["borderColor"]. Named and hex values are supported. (rgb and rgba, both 3, 6, and 8 digits).

Friendly get/set accessor for the ["borderWidth"] value. Returns BoxPadding.Empty when unspecified.

Like this["format"]. Gets or sets the output file format to use. "png", "jpg", and "gif" are valid values. Returns null if unspecified. When format is not specified, the original format of the image is used (unless it is not a web safe format - jpeg is the fallback in that scenario). Also checks the 'thumbnail' value for V2 compatibility. When set, 'thumnail' is removed and only 'format' is used.

The width which the X and X2 crop values should be applied. For example, a value of '100' makes X and X2 percentages of the original image width. This can be set to any non-negative value. Very useful for performing cropping when the original image size is unknown. 0 indicates that the crop values are relative to the original size of the image.

The width which the Y and Y2 crop values should be applied. For example, a value of '100' makes Y and Y2 percentages of the original image height. This can be set to any non-negative value. Very useful for performing cropping when the original image size is unknown. 0 indicates that the crop values are relative to the original size of the image.

Determines when the diagnostics page can be viewed.

Diagnostics are disabled

Only local requests can access diagnostics

All hosts can view diagnostics.

Provides the incredibly helpful /resizer.debug page we all love. Mimics the behavior of customErrors by default. Not available if CustomErrors=true or retail=true. Available only to localhost if customErrors=RemoteOnly. Can be overriden by adding in the <resizer> section <diagnostics enableFor="None|AllHosts|LocalHost" />

True if diagnostics can be displayed to the current user. If <diagnostics enableFor="None" />, returns false. If <diagnostics enableFor="Localhost" />, returns false for remote requests If <diagnostics enableFor="AllHosts" />, returns true. If unspecified, uses the same behavior as ASP.NET Custom Errors.

Implements IHttpHandler, serves content for the NoCache plugin

Redirects image 404 errors to a querystring-specified server-local location, while maintaining querystring values so layout isn't disrupted. For example, missingimage.jpg?404=image.jpg&width=200 with the default setting <image404 baseDir="~/" /> will redirect to ~/image.jpg?width=200. You may also configure 'variables', which is the reccomended approach. Ex. <image404 propertyImageDefault="~/images/nophoto.png" /> and use them like so: missingimage.jpg?404=propertImageDefault?width=200 -> ~/images/nophoto.png?width=200. Querystring values in the variable value take precedence. For example, Ex. <image404 propertyImageDefault="~/images/nophoto.png?format=png" /> and missingimage.jpg?format=jpg&404=propertImageDefault?width=200 -> ~/images/nophoto.png?format=png&width=200.

Encapsulates the state of an image being resized. Can be used to simulate a resize as well as actually perform one. All code should ignore when Bitmaps and Graphics objects are null, and go about simulating all the mathematical functions as normal.

The commands to apply to the bitmap

The original size of the source bitmap. Use this instead of accessing the bitmap directly for this information, since the bitmap may not always be available

Rendering choices can depend on whether the output format supports transparency.

The layout object. Used for calculated and flowing the layout of the various rings around the image (padding, border, effect, margin, etc).

The size of the target bitmap image. Set after all sizing operations have completed.

The dimensions of the bitmap afer all operations have been applied to it (Calling FlipRotate can change the bitmap dimensions).

The rectangular portion of the source image to copy

The source bitmap. If null, skip drawing commands, but continue layout logic.

The destination bitmap. If null, skip drawing commands, but continue layout logic.

A graphics object to write to the destination bitmap. If null, skip drawing commands, but continue layout logic.

Allows color correction/modification during the image copy.

Disposes sourceBitmap, destGraphics, destBitmap, and copyAttributes if they are non-null

(read-only) Same as copyRect.Size, convenience property.

Allows extensions to store data along with the image state