The "Automatic resizes" sub-page inside the "Image definition” tab (see Image definitions - Overview) makes it possible to configure I-Load for the automatic generation of an unlimited number of custom thumbnails when the user uploads or edits an image.
Within the I-Load object model, the properties of this sub-page represent the class WebImageResizeDefinition (see also the ResizeDefinitions property in the WebImageDefinition class).

(Figure 1 – The "Automatic resizes" sub-page inside the "Image definition” tab)

• The dropdown menu (1.1) makes it possible to select the thumbnail to be configured.
  The dropdown menu (1.1) is active only if at least one thumbnail has been defined.
• Button (1.2) allows changing title and internal code of the thumbnail definition currently selected with the control (1.1).
  Button (1.2) is active only if at least one thumbnail has been defined.
• Button (1.3) allows deleting the thumbnail definition currently selected by the control (1.1).
  Button (1.3) is active only if at least one thumbnail has been defined.
• Button (1.4) makes it possible to create a new thumbnail definition.
  Pressing this button (1.4) will open a window where the user can insert a title and an internal code for the new thumbnail definition.
  An unlimited number of thumbnails can be created.
• Through the commands present in the sub-page (1.5) you can configure the thumbnail image size
• Through the commands present in the sub-page (1.6) you can configure the thumbnail format and format options
• Through the commands present in the sub-page (1.7) you can configure other thumbnail options

Configuration sub-page

(Figure 2 – The thumbnail "Configuration" sub-page)

• Option (2.1) allows configuring I-Load to create a "zoom" thumbnail.
  (Mode property in the WebImageResizeDefinition class set to ImageResizeMode.Zoom)
• Option (2.2) allows configuring I-Load to create an "adaptive" thumbnail.
  (Mode property in the WebImageResizeDefinition class set to ImageResizeMode.Adaptive)
• Option (2.3) allows configuring I-Load to create a "Fixed" thumbnail.
  (Mode property in the WebImageResizeDefinition class set to ImageResizeMode.Fixed)

"Zoom" type thumbnail 

(Figure 3 – “Zoom” type thumbnail configuration)

This mode creates thumbnails of a size directly proportional to the size of the image selected by the user.

• The text field (3.1) allows configuring the zoom percentage to be applied to the image (see also the ZoomFactor property in the WebImageResizeDefinition class).
  Ex: 200 creates a thumbnail double in size compared to the image selected by the user.
  50 creates a thumbnail half size compared to the image selected by the user.

"Adaptive" type Thumbnail

(Figure 4 - "Adaptive" type thumbnail configuration)

This mode creates a thumbnail of variable size.
The selected image is proportionally reduced so it can be entirely contained within a fixed size rectangle (see also the AdaptiveMaxSize property in the
WebImageResizeDefinition class).

• The text field (4.1) allows configuring the thumbnail maximum width.
• The text field (4.2) allows configuring the thumbnail maximum height.

(Figure 5 – "Adaptive" type thumbnail)

"Fixed" type Thumbnail

(Figure 6 - “Fixed" type thumbnail configuration)

This mode creates a fixed size thumbnail (see also FixedSize property in the WebImageResizeDefinition class).

• The text field (6.1) allows configuring the thumbnail fixed width.
• The text field (6.2) allows configuring the thumbnail fixed height.
• If option (6.3) is active (see also the Fit property in the WebImageResizeDefinition class), the selected image will be resized to completely fill the thumbnail fixed size.
  If the selected image aspect ratio is different from the thumbnail aspect ratio, the selected image will be automatically resized and cropped to completely “fill” the thumbnail.
  If option (6.3) is not active, the selected image will be resized to be entirely contained within the thumbnail fixed size.
  If the selected image aspect ratio is different from the thumbnail aspect ratio, a background color will be used to “fill” the thumbnail.
• Button (6.4) allows selecting the background color to be used for filling when option (6.3) is not active (see also BackgroundColor property in the
  WebImageResizeDefinition class).

(Figure 7 - Two "Fixed" type thumbnails)

Output options sub-page

(Figure 8 – The thumbnail "Output options" sub-page) 

The "Output options" sub-page allows configuring the format and the options for the thumbnail generated by I-Load.
Within the I-Load object model, the properties of this sub-page represent the class WebImageResizeOutputOptions (see also the OutputOptions property in the
WebImageResizeDefinition class).

• The drop-down menu (8.1) makes it possible to select one of these three settings:
  
  • Selected
    The thumbnails saved by I-Load will always keep the same format as the selected image (it corresponds to the WebImageResizeOutputFormatMode.Selected value).
    Please see the OutputOptions property in the WebImageDefinition class.
  • Source
    The thumbnails saved by I-Load will always keep the same format as the original images loaded by the user (it corresponds to the WebImageResizeOutputFormatMode.Source value).
    This option is useful for keeping as many features as possible of the original image uploaded by the user (Ex: retaining the transparency of the GIF images uploaded, that would be lost if the images were saved in a JPG format).
  • Custom
    The thumbnails will always be saved in a fixed format regardless of the format of the images loaded by the user (it corresponds to the WebImageResizeOutputFormatMode.Custom value).
  This option corresponds to the FormatMode property in the WebImageResizeOutputOptions class.
  The default value is "Selected".
• The drop-down menu (8.2) makes it possible to select the format that will be used to save the images loaded by the user.
  Note: This field can be used only when option (8.1) is set to "Custom".
  This option corresponds to the Format property in the WebImageResizeOutputOptions class.
  The default value is "Jpeg".
  

  Format Property in the WebImageResizeOutputOptions class is of type Guid. The Guid values of the graphic formats available with Windows GDI+ are defined in the System.Drawing.Imaging.ImageFormat class. Ex: System.Drawing.Imaging.ImageFormat.Jpeg.Guid

• The numeric box (8.3) allows the selection of the quality of Jpeg images.
  Note: This field can be used only when option (8.1) is set to "Source" or "Custom".
  If the FormatMode property (option 8.1) is set to "Selected", then the JPEGQuality will be the same of the Selected image (WebImageOutputOptions.JPEGQuality)
  The range of selectable values is 0 - 100.
  The higher the value (maximum 100), the better will be the quality of the Jpeg files saved, and the higher the file byte size.
  On the other hand, if the value is lower (minimum 0), the quality of the Jpeg files saved will be inferior and the file byte size will be smaller.
  This option corresponds to the JPEGQuality in the WebImageResizeOutputOptions class.
  The default value is "92".

Additional options  sub-page

(Figure 9 – The thumbnail "Additional options" sub-page)

• Option (9.1) allows configuring the thumbnail so that it will be generated applying the crop settings selected by the user (see also the ApplyCrop property in the WebImageResizeDefinition class).
• Option (9.2) allows configuring the thumbnail so that it will be generated applying the rotate/flip settigs selected by the user (see also the ApplyRotateFlip property in the WebImageResizeDefinition class).
• Option (9.3) allows configuring the thumbnail so that it will be generated applying the resize settigs selected by the user (see also the ApplyResize property in the WebImageResizeDefinition class).
• Option (9.4) allows configuring the thumbnail to prevent the selected image from being resized if the selected image size is smaller than the thumbnail (see also the DisableIfSmaller property in the WebImageResizeDefinition class).

See Also