Aurigma Image Uploader 5.0 Dual
API and Behaviour Changes from Image Uploader 1.x for ActiveX

Aurigma Image Uploader 4.0 Dual has a lot of API changes in comparison with the ActiveX versions 1.x. It means that old code (both server-side and client-side) should be modified to work with this version. This topic describes what changes you should make to get old code working with the Aurigma Image Uploader 4.0 Dual.

- Inserting Image Uploader into HTML in Different Way
- Updating License Key
- Changes in Client-Side Code
- Changes in Server-Side Code

# Inserting Image Uploader into HTML in Different Way

Aurigma Image Uploader Dual includes not only ActiveX, but also Java version. To unify the Image Uploader-related client-side code, there is a special helper JavaScript file called iuembed.js . You can read about it more detailed in the Helper Script Reference (iuembed.js).

In particular, it means that you should insert Image Uploader to the page through this script rather than through the OBJECT element. See the Inserting Image Uploader into Web Page topic for more details.

# Updating License Key

License keys for Image Uploader 1.x are not valid for the new version. That is why you should contact us to get new license key/keys. In particular, you should purchase a separate license key for Java version.

After you receive your updated license key, put it into the LicenseKey parameter. See the Removing Limitations of Evaluation Version topic for more details.

# Changes in Client-Side Code

Some parameters of the ActiveX version 1.x are not valid in new version of Image Uploader. See the table below.

Aurigma Image Uploader 1.0 for ActiveX | Aurigma Image Uploader 4.0 Dual | Comments
--- | --- | ---
BackgroundColor | PaneBackgroundColor BackgroundColor | The behavior was changed. Now BackgroundColor specifies entire background color, and PaneBackgroundColor specifies tree and files pane color.
FileMask | FileMask | The syntax was changed. Unlike for version 1.x, you should specify not only the extension, but also the entire file mask with wildcard (e.g. *.jpg instead of jpg).
FrameColor | N/A | The property was removed to provide compliance with Windows XP themes.
LicenseKey | LicenseKey | Old license keys are not compatible with new Image Uploader. Contact sales@aurigma.com to upgrade. Several license keys can be passed to single property (semicolon-separated).
MaxUploadSize | MaxTotalFileSize | Renamed.
PanelStyle | N/A | The property was removed to provide compliance with Windows XP themes.
PreviewThumbnailActiveColor | PreviewThumbnailBorderColor | Renamed.
PreviewThumbnailInactiveColor | PreviewThumbnailBorderHoverColor | Renamed.
ButtonsVisible | ShowButtons | Renamed.
DescriptionsVisible | ShowDescriptions | Renamed.
UploadThumbnailFitMode SourceImageFitMode | UploadThumbnail1FitMode UploadThumbnail2FitMode UploadThumbnail3FitMode | Now you can create and upload up to three thumbnails. It is useful if you want to send not only a preview, but also a screen-size image. However you cannot change the source file, that's why fit mode for source file makes no sense now. If you want to upload an image in its original size, apply rotation and change JPEG quality, set ActualSize for one of thumbnail's fit mode.
UploadThumbnailSize SourceImageSize | UploadThumbnail1Width UploadThumbnail1Height UploadThumbnail2Width UploadThumbnail2Height UploadThumbnail3Width UploadThumbnail3Height | Now you can specify a bounding rectangle instead of a square. As the source file now is unchanged, you cannot specify a bounding box for it.
JPEGQuality | UploadThumbnail1JpegQuality UploadThumbnail2JpegQuality UploadThumbnail3JpegQuality | You can specify JPEG quality for each thumbnail individually.

Some changes to the methods had been applied. These changes are described in the table below.

Aurigma Image Uploader 1.0 for ActiveX | Aurigma Image Uploader 4.0 Dual | Comments
--- | --- | ---
DeselectAll | DeselectAll | The behavior was changed. Now it does not uncheck the files, but removes the selection only.
SelectAll | SelectAll | The behavior was changed. Now it does not check files, but only makes them selected (user should click some of selected files to make them checked).

Some changes to the events had been applied. These changes are described in the table below.

Aurigma Image Uploader 1.0 for ActiveX | Aurigma Image Uploader 4.0 Dual | Comments
--- | --- | ---
OnProgress | Progress | Renamed.

Also, a number of new properties, methods, events, and controls had been added. Refer the What's New? topic for more details.

# Changes in Server-Side Code

As Image Uploader is a client-side control, changes in server scripts are minimal. The only thing you need to change are field names used by the upload component to extract uploaded files or other data. The table below demonstrates what POST fields were renamed and what extra fields you can use:

Aurigma Image Uploader 1.0 for ActiveX | Aurigma Image Uploader 4.0 Dual | Comments
--- | --- | ---
ImageCount | FileCount | Renamed. Image Uploader can upload not only images, but also other file types, so old name was misleading.
ImageN | SourceFile_N | The behavior has been changed. Now this field contains an unchanged file (no rotate or recompression is applied to it).
ThumbnailN | Thumbnail1_N Thumbnail2_N Thumbnail3_N ... | Instead of a single thumbnail, unlimited number of thumbnail images can be sent at one time now. None thumbnails are sent by default.
DescriptionN | Description_N | Unchanged.
WidthN | Width_N | Unchanged.
HeightN | Height_N | Unchanged.

A number of new POST fields are sent in the new version. See the POST Field Reference for a full list of uploaded fields.