Aurigma Image Uploader 4.6 Dual
ImageUploader.UploadThumbnailCompressOversizedOnly Property
See Also Supported in: ActiveX Java

Switch that specifies whether an original file should be uploaded as the specified thumbnail in case when original image dimensions and file size are not greater than dimensions and file size of the thumbnail.

# Syntax

##### Get/Set Value in Runtime

JavaScript | Copy Code
--- | ---
    getImageUploader("ImageUploaderID").setUploadThumbnailCompressOversizedOnly(Index, value);
    value = getImageUploader("ImageUploaderID").getUploadThumbnailCompressOversizedOnly(Index);

##### Parameters

Index

  A non-negative integer that specifies an index of the upload thumbnail (one-based). It should not exceed `UploadThumbnailCount - 1` . If extra upload thumbnails are required, use the UploadThumbnailAdd method to add them.

##### Property Value

A boolean value (`true` or `false`). If `true` and:

- The original file is JPEG;
- No watermark is applied;
- The dimensions of the original file are not greater than the dimensions of the specified thumbnail;
- The size in bytes of the original file is not greater than the size of the specified thumbnail.

Then the original file will be sent instead of the specified upload thumbnail. In all other cases a thumbnail is created.

# Remarks

Image Uploader can generate multiple thumbnails per one file sent to the server. To configure sizes of thumbnails and other parameters, you can manipulate a list of upload thumbnail settings. It can be done two ways:

1. Use `UploadThumbnailNXXX` parameters, where N is a number in range from 1 to 3.
2. Use the UploadThumbnailAdd method in JavaScript to add extra thumbnail sizes, and `UploadThumbnailXXX` properties to change specific settings.

First method is simpler, however it allows to upload not more than 3 thumbnails per one file. The second one does not have any limitation on the number of thumbnails.

To get an upload thumbnail on the server use the `UploadThumbnailX` HTTP POST field, where X is an index of the upload thumbnail.

Note
The index of upload thumbnail list is zero-based. However by default upload thumbnail with zero index is disabled (its fit mode is `Off`).

# See Also

##### Examples

Resizing and Rotating Images

##### Reference

UploadThumbnailAdd Method
UploadThumbnailBackgroundColor Property
UploadThumbnailCompressionMode Property
UploadThumbnailCopyExif Property
UploadThumbnailCopyIptc Property
UploadThumbnailFitMode Property
UploadThumbnailHeight Property
UploadThumbnailJpegQuality Property
UploadThumbnailResizeQuality Property
UploadThumbnailWatermark Property
UploadThumbnailWidth Property