Aurigma Image Uploader 6.0 Dual
ImageUploader.UploadThumbnail1CompressionMode Property
See Also Supported in: ActiveX Java

Compression mode of the first thumbnail.

# Syntax

##### Initialize

JavaScript | Copy Code
--- | ---
    <script type="text/javascript" src="iuembed.js"></script>
    <script type="text/javascript">
    var iu = new ImageUploaderWriter("ImageUploaderID", 610, 500);
    //...other params...
    iu.addParam("UploadThumbnail1CompressionMode", "*.* = Jpeg");
    //...other params...
    iu.writeHtml();
    </script>

##### Get/Set Value in Runtime

JavaScript | Copy Code
--- | ---
    getImageUploader("ImageUploaderID").setUploadThumbnail1CompressionMode(value);
    value = getImageUploader("ImageUploaderID").getUploadThumbnail1CompressionMode();

##### Property Value

A string value that specifies the compression mode format string of the first thumbnail. See the Remarks section for more details about syntax of this string.

Default value is "*.* = Jpeg".

# Remarks

Thumbnail, in Image Uploader terms, is not just a resized copy of an original image; it can also be an icon associated with a source file, its ZIP archive, or contain this file itself. This property defines what data (resized image, ZIP archive, system icon, or source file) should be uploaded for what file types. Data types, so-called compression modes, are specified using predefined constants. Image Uploader supports the following compression modes:

Jpeg
  If a file selected for upload is image, Image Uploader resizes this image to the specified dimensions and uploads it as JPEG file. Otherwise if file is non-image, Image Uploader uploads a system icon associated with the file. By default, this mode is applied to any file regardless of its extension. More information about image resizing before upload you can read in the Resizing and Rotating Images topic.
Zip
  Image Uploader sends a ZIP archive of the original file.
Icon
  Image Uploader sends a system icon associated with a file selected for the upload.
SourceFile
  Image Uploader sends the original file.

File types are specified with file masks which can be constructed using standard wildcards, such as asterisk `*` (arbitrary substring) and question mark `?` (arbitrary character). In a common case, this property accepts a string which has the following syntax:

`mask11,mask12,...=mode1,mode2,...;mask21,mask22,...=mode1,mode2,...;...`

This string consists of `file masks=compression modes` pairs separated by semicolons. Each pair defines a type of uploaded data which should be sent for listed file types. Thus, a single thumbnail (the `UploadThumbnailX` POST field) can contain data of different types depending on type of the selected file. Find examples of compression mode format strings in the Handling Files Compression topic.

Note
You can specify several compression modes for one list of file types. In that case if applying of the first compression mode has failed Image Uploader will try to use the next one. For example, if you set this property to the `"*.*=Jpeg,Source"` value, Image Uploader will send either JPEG thumbnail or source file in the case when it is unable to create JPEG thumbnail for a selected file (when this file is corrupted or non-image).

# See Also

##### Examples

Handling Files Compression
POST Field Reference

##### Reference

UploadThumbnail1BackgroundColor Property
UploadThumbnail1CompressOversizedOnly Property
UploadThumbnail1CopyExif Property
UploadThumbnail1CopyIptc Property
UploadThumbnail1FitMode Property
UploadThumbnail1Height Property
UploadThumbnail1JpegQuality Property
UploadThumbnail1ResizeQuality Property
UploadThumbnail1Resolution Property
UploadThumbnail1Watermark Property
UploadThumbnail1Width Property