Aurigma Image Uploader 4.6 Dual
What's New?

# Aurigma Image Uploader 5.0 Dual - Released December 20, 2007

Important
Please be sure to learn about the changed trial licensing policy. From now on, you will need a trial license key to test-drive the trial version (except for `localhost`). For details, see How to Evaluate Image Uploader topic.

##### Both ActiveX and Java Version Improvements

- ZIP compression for files is now available. Use these properties to change the compression mode:
  - UploadThumbnail1CompressionMode,
  - UploadThumbnail2CompressionMode,
  - UploadThumbnail3CompressionMode,
  - UploadThumbnailCompressionMode.
- POST request format is now customizable to seamlessly integrate with CMSs, blogging systems, etc. You can omit standard POST text fields (SendDefaultFields property) or rename them (RenameField method). For details, also see POST Field Reference and Configuring POST Format sections.
- Progress bar placement behavior changed for the Advanced Details view (see UploadView property to learn more about view modes). Now if you upload a single image in a package (i.e. FilesPerOnePackageCount value is 1), the progress bar appears in the list item of that specific image and not in the list item allotted specifically for progress indication.
- Instant upload for the Advanced Details view. You can specify that the upload start immediately after you drag the file into the upload pane. To this end, set EnableInstantUpload property value to true.
- You can now opt to display an image instead of the ‘Drop file here’ text message (OnePane and ThreePanes layouts). See DropFilesHereImageFormat property for details.
- You choose to show a background image in the Advanced Details view. See UploadPaneBackgroundImageFormat property for details.
- Minimum file count for upload: if this is specified, the upload will not start unless the minimum allowed amount of files are selected for upload (MinFileCount property).
- Upload file list feature. You can save\load\delete lists of files to be uploaded (see SaveUploadList, LoadUploadList and ResetUploadList methods).
- Upload can be denied for CMYK images (AllowCmykImages property). Custom warning can be shown to the user
  - in the said file description (CmykImagesAreNotAllowedText property) and\or
  - in the pop up box (MessageCmykImagesAreNotAllowedText property).
- New upload control events added:
  - PackageBeforeUpload – raised right before the package is to be uploaded,
  - PackageError – raised if an error occurred while uploading the current package,
  - PackageComplete – raised upon successful package upload completion.
- On-hover tooltips now can be displayed individually
  - for the description of a file (DescriptionTooltipText property) and
  - for the line that prompts user to edit said description (EditDescriptionTooltipText property).
- Pane item unchecking via PaneItem API has been implemented (PaneItemChecked property).

##### ActiveX version specific improvements

- Windows Vista native view. Turned on by default for Vista users (UseSystemColors property must be true which it is by default).
- PackageProgress event added. It is the same as Progress but the values are returned only for the package specified in the event index.

##### Java version specific improvements

- Same version numbers as the ActiveX version from now on.
- Now horizontal and vertical thumbnail spacing is available:
  - ThumbnailVerticalSpacing,
  - ThumbnailHorizontalSpacing.
- Thumbnail controls border colors are now customizable:
  - PreviewThumbnailBorderColor,
  - PreviewThumbnailBorderHoverColor.
- Pane border styles are now customizable. The following properties modify this setting:
  - TreePaneBorderStyle,
  - FolderPaneBorderStyle,
  - UploadPaneBorderStyle.
- Folder change warning text feature implemented (MessageSwitchAnotherFolderWarningText property).
- Sun JIMI image processing library is no longer used. ImageIO library is used instead as being much more stable.

# Aurigma Image Uploader 4.5 Dual - Released June 7, 2007

##### Both ActiveX and Java Version Improvements

- Now you can choose between two resize algorithms - high quality but slower and medium quality but faster. Use these properties to change the quality setting:
  - UploadThumbnail1ResizeQuality
  - UploadThumbnail2ResizeQuality
  - UploadThumbnail3ResizeQuality
  - UploadThumbnailResizeQuality
- Image watermarks can now be put at each uploaded photo (in addition to text watermarks).
- Users can preview an image in a large window, if the AllowLargePreview property is set to true.
- New functionality is added to allow customizing appearance of single thumbnail items in folder and upload panes. This functionality comprises several properties and an event:
  - PaneItemCanBeUploaded
  - PaneItemChecked
  - PaneItemCount
  - PaneItemDesign
  - PaneItemEnabled
  - PaneItemSelected
  - FolderChange
- Added two more events that simplify error handling:
  - AfterUpload—raised only upon successful upload
  - Error—raised only upon an error
- Source files can now be sent instead of thumbnails, if there was an error while creating thumbnails. This way you can upload mixed content in a single upload session - thumbnails for images and original files for non-images. The following properties modify this setting:
  - UploadThumbnail1FallbackMode
  - UploadThumbnail2FallbackMode
  - UploadThumbnail3FallbackMode
  - UploadThumbnailFallbackMode
- IPTC support is now improved, and now the following properties can be used to preserve IPTC metadata:
  - UploadThumbnail1CopyIptc
  - UploadThumbnail2CopyIptc
  - UploadThumbnail3CopyIptc
  - UploadThumbnailCopyIptc

##### ActiveX Version Specific Improvements

- Format of displayed time values can now be customized using the TimeFormat property.
- Background color for thumbnails of images with transparency can now be set using these properties:
  - UploadThumbnail1BackgroundColor
  - UploadThumbnail2BackgroundColor
  - UploadThumbnail3BackgroundColor
  - UploadThumbnailBackgroundColor
- If image dimensions are smaller than required thumbnail size, you can upload original image without recompression. This behavior can be set using these properties:
  - UploadThumbnail1CompressOversizedOnly
  - UploadThumbnail2CompressOversizedOnly
  - UploadThumbnail3CompressOversizedOnly
  - UploadThumbnailCompressOversizedOnly
- Maximum possible POST request length was increased from 2GB to 4GB.

##### Java Version Specific Improvements

Java version functionality became much closer to ActiveX:

- Full support of watermarking (both text and image).
- An unlimited number of thumbnails can now be created, as in the ActiveX version. Properties specifying behavior of the additional thumbnails are the same as in the ActiveX version (except for UploadThumbnailXXXBackgroundColor, UploadThumbnailXXXCompressOversizedOnly and alike).
- The same limitations as in the ActiveX version are now available.
- Folder upload is now supported.
- Thumbnails can now be removed from panes using the remove control on the thumbnail as in the ActiveX version.
- Automatic rotation based on EXIF metadata is now supported.
- Hash values can now be sent along with images (as in ActiveX version).
- Tooltips for icons on thumbnails are now also supported.
- Full support of button customization. As in ActiveX version you can specify custom images for each state of each button and icon.
- Quality meter height is now adjustable as in the ActiveX version.

# Aurigma Image Uploader 4.1 Dual - Released December 30, 2006

##### Both ActiveX and Java Version Improvements

- Compatibility with Windows Vista.
- Localization to Ukrainian language is added.
- A number of minor improvements and bug fixes.

##### ActiveX Version Specific Improvements

- Upload speed was dramatically increased.
- When entire folders are uploaded, relative path is sent along with file name, so that it would be possible to restore the folder structure on the server.

# Aurigma Image Uploader 4.0 Dual - Released July 5, 2006

Since this version separate ActiveX and Java version of Image Uploader will be united into a single product: Aurigma Image Uploader Dual. Find the information about changes comparing with previous versions.

##### Both Versions Improvements

- New demo applications revealing Image Uploader features more thoroughly. Now the following demos are available:
  - Basic Demo Sample
  - User Quota Sample
  - Optimized Upload Sample
  - Photo Order Sample
  - Localization Sample
  - Concurrent Upload Sample
  - Open File Dialog Sample
  - Multiple Descriptions Sample
  - Robust Upload Sample
  - Watermark Sample
  - Server Imaging Sample
- Demo applications for new platforms are added:
  - Python
  - Ruby
- Improved documentation.
- New features in the iuembed.js helper script. Now it:
  - Eliminates necessity to activate Image Uploader controls by clicking them when Internet Explorer security update 912945 is installed.
  - Incorporates ability to detect whether ActiveX version of Image Uploader is already installed.
  - Includes wrappers for new controls, i.e.:
    - ThumbnailWriter
    - UploadPaneWriter
    - ShellComboBoxWriter
  - Includes new members:
    - getHtml method - returns HTML code which embeds Image Uploader to the page property (unlike writeHtml that will write this code directly into the page).
    - activeXClassID, activeXProgID, javaAppletJarFileName, and javaAppletClassName properties - configures private-label versions of Image Uploader, allowing to use standard iuembed.js with them.
    - showNonemptyResponse - specify whether to display server response. This property is an additional debugging facility.

##### ActiveX Version Improvements

- Internet Explorer 7 compatibility.
- New view mode for the upload pane called advanced details list. It displays images as detailed list, displays its thumbnail, and show progress bar during the upload directly in the upload pane. See the View Modes topic for more details.
- Ability to upload several files simultaneously (several concurrent HTTP connections are established). See the Uploading Files Sequentially And Concurrently topic for more details.
- Ability to upload more than three thumbnails per one image file. See the Resizing and Rotating Images topic for more details.
- Ability to upload files to several URLs in the same upload session. For example, if you have two storage servers, you can set two URLs that will alternate each other for each POST request in the upload session.
- Ability to replace Image Uploader buttons by specified images (inside Image Uploader GUI rather than in HTML). See the Customizing Buttons topic for more details.
- Ability to draw text watermark on each uploaded thumbnail. You can configure the text string, font, color, opacity, position, background color, and some other settings. See the Adding Watermarks topic for more details.
- Ability to sort items in the upload list (either manually with drag-and-drop operation or using menu). This way now the user can specify the sequence files will be uploaded with.
- Ability to delete files after the upload completion. A dialog confirming that the user wants to delete files to the Recycle Bin is displayed.
- Ability to rotate multiple items from the upload list with a single click.
- Ability to upload entire folders in addition to separate files.
- Ability to navigate to arbitrary folder with the GoToFolder method.
- Ability to work with IPTC fields in the same manner as with EXIF.
- Ability to set limitation for minimum allowed file size.
- Automatic photo rotate if it has wrong orientation (based on EXIF information stored in the photo).
- New controls that enables you to create customize layout, or even build your own upload list (as described in the Customizing Upload Pane topic):
  - UploadPane
  - Thumbnail
- Tooltips are displayed for all GUI elements including the quality meter.
- Improved user interface accessibility. most operations can be carried out through the keyboard, in particular: image rotating, description editing, etc.
- Automatic tree view refresh if removable media is plugged or unplugged.
- Memory-friendly upload for huge files (like video movies, etc). Files are never loaded into memory, but read directly from hard drive.
- User interface improvements, including:
  - Customizable splitter line.
  - Configurable settings for each pane including:
    - Background color.
    - Border style.
    - Ability to rotate items.
    - Ability to edit descriptions.
  - An icon in the top right corner of each item of the upload item that removes this item from the upload list when clicked.
- Minor improvements and bug fixes:
  - Drop Files Here text string can be multiline.
  - Multiple monitors are handled properly now.
  - Now ZIP files are not ignored when a total folder added to the upload list (using Add Folders button).
  - Image resolution now is preserved in thumbnails.

    Note
    Do not confuse image resolution with image dimensions.

  - Length limitation for the FileMask property is eliminated.
  - Limitation for the MaxTotalFileSize property now is increased to maximum number that 32-bit value can hold (i.e. 4294967296).
  - Rotation is remembered if the item is rotated in the folder pane and dragged to the upload pane.
  - ...a number of other bug fixes and minor enhancements.

Some changes in API and behavior were made:

- These members are obsolete:
  - CodePage property - renamed to Charset and the syntax becomes the same as in Java version.
  - EnableRotate property - renamed to AllowRotate.
  - Layout property - renamed to PaneLayout.
  - Padding and ShellComboBox.Padding - eliminated. Use HTML formatting instead.
  - PreviewThumbnailActiveColor property - renamed to PreviewThumbnailBorderColor.
  - PreviewThumbnailInactiveColor property - renamed to PreviewThumbnailBorderHoverColor.
  - ShowUploadCompleteMessage property - eliminated. Set the MessageUploadCompleteText property to an empty string to hide the upload complete message.
  - UploadItems property and appropriate class - eliminated. Instead of this class ImageUploader exposes a number of UploadFileXXX methods and properties that implement the same functionality.
  - UploadMode property - eliminated. Use the FilesPerOnePackageCount property instead.

  Note
  Although all these properties are still working for backward compatibility, it is highly recommend to stop using them.

- These members are completely eliminated and no longer supported:
  - SignatureFilter
  - ShowStatusPane
  - StatusFilesInFolderText
  - StatusSelectedFilesText
- Behavior changes:
  - No thumbnails are uploaded now by default. Only original file is uploaded unless you override it by modifying appropriate properties (such as UploadThumbnail1FitMode, etc).
  - Full file path no longer sent to the server when when uploading a file name. It sends only the name of the file, but does not send folder structure. The FileName_I cannot be used to retrieve full path anymore as well. If an ability to extract full path is critical to you, you should order a private label version. Feel free to email to sales@aurigma.com if you are interested.

##### Java Version Improvements

All changes made to Java version are intended to make its API and behavior closer to ActiveX version.

- New features:
  - Add Files and AddFolders buttons in the OnePane layout.
  - Increased speed of thumbnail generation.
  - Ability to upload files to several URLs in the same upload session. For example, if you have two storage servers, you can set two URLs that will alternate each other for each POST request in the upload session.
  - More image formats are supported:
    - BMP
    - TIFF (partially)
    - PCX
    - PSD
- API changes (all these properties are already exist in ActiveX version):
  - Added the AddFiles and AddFolders methods, as well as appropriate buttons when OnePane layout is used.
  - Added the AllowAutoRotate property (EXIF-based automatic photo rotate if it has wrong orientation).
  - Added the DeniedFileMask property (file mask for files denied for the upload).
  - Added the DescriptionsReadOnly property (whether descriptions are editable).
  - Added the ExtractExif and ExtractIptc properties (a list of EXIF or IPTC fields to extract and upload as separate POST variables).
  - Added the FolderPaneAllowRotate and UploadPaneAllowRotate properties (toggle an ability to rotate images in the folder and upload pane accordingly).
  - Added the FolderPaneShowDescriptions and UploadPaneShowDescriptions properties (toggle descriptions in the folder and upload pane accordingly).
  - Added the GoToFolder and CanGoToFolder methods (used to navigate folders through JavaScript).
  - Added the ProgressDialogPreviewThumbnailSize property (size of the preview thumbnail on the progress dialog).
  - Added the ShowSubfolders property (toggles visibility of subfolders in the folder pane).
  - Added the UploadFileXXX methods and properties that provides access to files added to the upload list.
  - Added new applets:
    - ShellComboBox
    - Thumbnail
    - UploadPane
  - The EnableRotate property is renamed to AllowRotate.
- Behavior changes:
  - Tree or upload pane are hidden when the TreePaneWidth or FolderPaneHeight accordingly are set to -1.
  - Image resolution now is preserved in thumbnails.

    Note
    Do not confuse image resolution with image dimensions.

  - Setting all Image Uploader controls (button, check boxes, etc) caption to an empty string hides these controls now.
  - AddField property has new behavior when a field with existing name is added. Now it will overwrite old value.
  - Proper content type for images now is sent.
- A lot of other minor improvements and bug fixes.

# Aurigma Image Uploader 3.5 for ActiveX - Released April 14, 2005

- EXIF metadata support. Now you can:
  - Specify whether to preserve EXIF metadata in thumbnails. To do it you can use a group of properties UploadThumbnailNCopyExif, where N is the number of the thumbnail version (UploadThumbnail1CopyExif, UploadThumbnail2CopyExif, and UploadThumbnail3CopyExif).
  - Extract necessary EXIF details and upload them as separate fields. To do it you can use the property named ExtractExif.
- Increased quality of thumbnails (both the quality of the previews and thumbnails which are uploaded).
- New fields are uploaded along with the file - creation and last modification dates.
- Lossless JPEG rotation is used when possible (when image dimensions are divisible by 8).
- Ability to upload a hash value for the uploaded file. SHA, MD5, and MD2 algorithms are supported. Use the HashAlgorithm property to enable this feature.
- Ability to get an image from the clipboard and insert it into the upload list. It is convenient to upload screenshots using this feature.
- Additional appearance customization properties are added:
  - Ability to disable and resize the tree view using the mouse.
  - Ability to change distance between thumbnails in the folder and upload pane.
  - Additional color settings.
- The detailed list now allows sorting. Also, the detailed list now displays size of the folders.
- Improved algorithm of the upload time estimation.
- Ability to determine type of the files which are added to the upload list.
- Ability to hide some standard buttons.
- Evaluation version now has time limitation.
- Added an event named BeforeUpload which is convenient to verify input data and cancel the upload if it is incorrect.
- Added a method named AddField which enables you to add extra fields for the upload without the <form>.
- Fixed the problem with the Cancel button in the description editor.
- Fixed the problem with uploading <textarea> form elements along with the uploaded images.
- Fixed the problem of the server returning the HTTP code 3xx (redirect).
- Fixed other minor bugs.

# Aurigma Image Uploader 1.1 for Java - Released July 23, 2005

- Added PaneLayout parameter support. Now you can use Image Uploader not only with three panes layout, but with one pane and two panes layouts as well.
- Added other parameters which relate to the two panes layout, including CheckFilesBySelectAllButton and EnableFileViewer properties, a block of IncorrectFileXXXColor properties, etc.
- Added proxy support. Now Image Uploader can send files through the proxy server as well.
- Added support of authorization. If password is required, the login dialog appears (appropriate localization properties names are AuthenticationRequestXXX).
- Added DropFilesHereText property.
- Improved string encodings support. Now the Charset parameter supports all possible encodings. This way now you can freely upload files with non-English names, etc.
- Improved iuembed.js script. Now it enables you to determine what Image Uploader is currently used (ActiveX or Java).
- Fixed the problem with certain ASP components (some ASP components could not parse the request properly).
- Fixed the problem with the Send button when no files are selected. Now it is automatically disabled when no files are selected.
- Fixed the problem with incorrect sort order of folders in the treeview.
- Fixed the problem with incorrect aspect ratio of thumbnails which occurred with certain images.
- Fixed the problem with thumbnail generation when the original image is smaller than the thumbnail. Now images are not stretched in this case.
- Other minor bug fixes.

# Aurigma Image Uploader 3.0 for ActiveX - Released August 24, 2004

- Support of new image formats such as PSD, TIFF, PNG, and WBMP (in addition to already supported JPEG, GIF, and BMP).
- Greatly increased thumbnail and file details extraction speed. Now Image Uploader is as fast as Windows Explorer in Thumbnails mode on Windows XP.
- Ability to display quality meter for photos, which demonstrates the user the maximum possible print size.
- Revised upload progress dialog. Now it displays thumbnail for currently uploaded image.
- Support of automatic upload recovery if connection was broken.
- Rewritten from the scratch in order to be completely Unicode-compatible. Image Uploader now supports filenames, descriptions, resources in all languages including East Asian ones (Chinese, Japanese, Korean, etc). It is also tested on all East Asian versions of Windows, including Windows 98.
- Opened access to the list of UploadItems files that are currently selected. You can get path, width, height, and resolution of the selected files.

  Note
  You still cannot programmatically add files to upload list due to the security reasons (as before).

- Ability to specify minimum and maximum allowed image dimensions.
- Ability to adjust the number of files that can be sent in a single request in separate upload mode.
- Ability to hide file names displayed in the folder and upload pane.
- Now displays warning in two panes mode when user exits a folder in which some items were selected (stating that selection will be discarded).
- Added uploading of additional info such as resolution, thumbnail width and height, and so on.
- Added a code sample for JSP Tomcat server.

# Aurigma Image Uploader 2.5 for ActiveX - Released May 31, 2004

- Fixed bug with invisibility of the control on some Windows 98 installations as well as a number of other problems concerning Windows 98.
- Added Add Files... and Add Folders... buttons for OnePane layout. It allows user to select files via Open File and Open Folder dialogs in addition to the drag-and-drop mode. This functionality is also available via AddFiles and AddFolders methods.
- Added PaneResize event which fires when user moves the splitter. See Adding Color Frames Around Panes code sample to see how and why you can use this event.
- Added possibility to disable multiple files selection. Setting AllowMultipleSelection property to False you can allow user to select a single file only.
- Added new buttons to manage upload list in ThreePanes layout. You can enable them with ShowUploadListButtons property.
- Improved image rotating icons.
- Added support of file system tracking. If you rename a file in a folder which is currently displayed in Image Uploader, changes are automatically reflected.
- Fixed a problem with UploadFileCountChange event (it did not fire if status pane was hidden).
- Fixed a problem with Stop button (under some circumstance it did not abort upload process immediately).
- A number of minor bug fixes and improvements were made.

# Aurigma Image Uploader 2.1 for ActiveX - Released April 28, 2004

- Added a drop-down list control which allows quick navigation through the folders in Windows Explorer style. You can put it on the same page with Image Uploader control and bind it to Image Uploader using AdditionalFolderNavigator property.
- Added CheckFilesBySelectAllButton property which changes the behavior of the Select All button. If you set it to True, files will be checked (or added to upload list) unlike the default behavior when they are just selected . However SelectAll method still just selects files regardless of the value of this property (due to security reasons).
- Added methods which allow navigating special folders like "My Computer", "My Documents", "My Pictures", "My Video", "My Music", etc. This way you can add buttons to the page for easier navigation. This functionality is available via GoToFolder and CanGoToFolder methods.
- Added GoToParentFolder and GoToPreviousFolder methods. You can add buttons to HTML which will call them providing faster navigation for the user.
- New licensing option is available. Now you can purchase a single IP address license (analogue of the single server license), which allows you to use Image Uploader with unlimited number of domains mapped to the single IP address.
- Added Version property which allows to verify Image Uploader version in run-time (so that you can check if user has an outdated version installed from JavaScript).
- Added ShowSubfolders property which allows folders to be displayed in the folder pane along with files.
- Added possibility to hide the folder tree (set TreePaneWidth property to -1 ).
- Folder "My Pictures" is placed in the folder tree on the same level with "My Documents" (for faster navigation).
- Fixed the problem with Image Uploader installation on Windows 98.
- Fixed the problem with slow thumbnail creation.
- Fixed the memory leak.
- Fixed the problem with incorrect behavior when selecting files with CTRL and SHIFT buttons.
- Fixed the problem with displaying thumbnails for JPEG files (sometimes Image Uploader did not display them).
- Fixed the problem with upload failure when submitting files to the page through HTTPS protocol.

# Aurigma Image Uploader 2.0 for ActiveX - Released March 31, 2004

- Thumbnails in the preview area are loaded asynchronously. It dramatically increases speed of folder reading;
- Full support of user interface localization;
- Can upload files not only as a single multipart/form-data block, but send them one by one; it greatly reduces RAM usage both on client and server sides. Besides, it brings other advantages: if upload is aborted, previously uploaded files will be stored (unlike sending them as single block). See comparison of upload modes for more details;
- The request Image Uploader submits to server is cached on disk instead of being stored in memory. This eliminates memory peak before upload of a large number of files (even in old upload mode);
- Display estimated upload time;
- Several layouts:
  - Standart treeview + panel with checkboxes;
  - Treeview + pane with folder content + pane with upload queue (with drag-and-drop operation support);
  - Single panel with upload queue (drag-and-drop operation support);
- Can send thumbnails of several sizes;
- Improved speed and quality of thumbnail preparation;
- Supports several license keys (so you can easily use the same HTML code on multiple domains);
- Can specify limitation for the number of files and maximum size of a single file (in addition to total upload size);
- Supports not only input field in attached form, but also select and textarea elements;
- Can upload not only images, but other file types;
- Improved file filter;
- Full support of XP themes;
- Various view modes of file list (thumbnail, list, details, icons).
- Displaying status bar for operations progress;
- Context menu for quick operations;
- The API is improved compared to versions 1.x;
- Minor bug fixes;