Aurigma Image Uploader 4.8 Dual
ImageUploader.UploadThumbnail1Watermark Property
See Also Supported in: ActiveX Java

Watermark for 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("UploadThumbnail1Watermark", "");
    //...other params...
    iu.writeHtml();
    </script>

##### Get/Set Value in Runtime

JavaScript | Copy Code
--- | ---
    getImageUploader("ImageUploaderID").setUploadThumbnail1Watermark(value);
    value = getImageUploader("ImageUploaderID").getUploadThumbnail1Watermark();

##### Property Value

A string value that specifies watermark settings for the first thumbnail. Watermark string syntax is described in the Remarks section.

If empty string is specified, watermark will not be drawn on this thumbnail.

Default value is "".

# Remarks

The watermark string consists of several variables separated with a semicolon. The following variables are supported:

Variable | Description
--- | ---
Text | Watermark text. It should be enclosed in single quotation marks (`'`). If it is necessary to insert a single quotation mark you should use the `''` character sequence. For example, to get a Andrew's Photos text, set this variable as follows: `Text='Andrew''s Photos'` Default value is an empty string.
Font | Font name. This font should be installed on the client machine. That's why it is highly recommended to use some generic font like `Arial`, `Verdana`, etc. Default value is `Arial`.
ImageUrl | Url to an image that will be used as the watermark. If a non-empty value is specified, `ImageWidth` and `ImageHeight` should also be specified. Default value is an empty string. When the image watermark is specified, the following parameter also make sense: `Position` `OffsetX` `OffsetY` `Opacity` `Background` `BackgroundColor`
ImageWidth | Width of the image that will be used as the watermark. Makes sense only if the `ImageUrl` parameter is non-empty. The image will be resized to the specified dimensions as an ordinary thumbnail, that is, the image can only be downsized, and its proportions are kept.
ImageHeight | Height of the image that will be used as the watermark. Makes sense only if the `ImageUrl` parameter is non-empty. The image will be resized to the specified dimensions as an ordinary thumbnail, that is, the image can only be downsized, and its proportions are kept.
Position | Watermark position. It can take one of the following values: TopLeft - watermark will be drawn in the top left corner of an image. TopCenter - watermark will be drawn in the center of the top of an image. TopRight - watermark will be drawn in the right top corner of an image. CenterLeft - watermark will be drawn in the center of the left edge of an image. Center - watermark will be drawn in the center of an image. CenterRight - watermark will be drawn in the center of the right edge of an image. BottomLeft - watermark will be drawn in the bottom left corner of an image. BottomCenter - watermark will be drawn in the center of the bottom of an image. BottomRight - watermark will be drawn in the bottom right corner of an image. Default value is `BottomRight`.
Size | Font size (in pixels). Default value is `12`.
OffsetX | Horizontal offset (in pixels) of the watermark relatively the position it is anchored to (according to the `Position` variable).
Note
If horizontal position is left or center, coordinates direction is left-to-right. If it is right, coordinates direction is flipped to right-to-left.
Default value is `0` (no offset).
OffsetY | Vertical offset (in pixels) of the watermark relatively the position it is anchored to (according to the `Position` variable).
Note
If vertical position is top or center, coordinates direction is top-to-bottom. If it is bottom, coordinates direction is flipped to bottom-to-top.
Default value is `0` (no offset).
Style | Font style. The following styles are supported: Bold Italic Underlined You can specify several styles separated with a comma. Example: `Style=Bold,Italic` Default value is an empty string (regular font is used).
Opacity | Watermark opacity percentage. If `0`, the watermark is totally transparent. If `100`, the watermark is opaque. Values between `0` and `100` will produce watermark with various level of transparency. This value works for all elements of watermark. There is no way to configure different opacity for background, text outline and text fill. Default value is `100`.
Background | Whether to draw a background under the text. Default value is `false`.
BackgroundColor | Background color. It has the same syntax as all Image Uploader color properties (i.e. HTML-style `#rrggbb` RGB value). Makes sense only if the `Background` variable is set to `true`. Default value is `#ffffff` (white color).
BackgroundMarginWidth | Width of additional space outside of the watermark filled with background (in pixels). Makes sense only if the `Background` variable is set to `true`. Default value is `0`.
BackgroundMarginHeight | Height of additional space outside of the watermark filled with background (in pixels). Makes sense only if the `Background` variable is set to `true`. Default value is `0`.
Outline | Whether to draw outline around the text. Default value is `false`.
OutlineColor | Text outline color. It has the same syntax as all Image Uploader color properties (i.e. HTML-style `#rrggbb` RGB value). Makes sense only if the `Outline` variable is set to `true`. Default value is `#ffffff` (white color).
OutlineWidth | Width of the text outline if the `Outline` variable is sent to `true`. Default value is `1`.
Fill | Whether to draw fill the text. Default value is `true`.
FillColor | Font color. It has the same syntax as all Image Uploader color properties (i.e. HTML-style `#rrggbb` RGB value). Makes sense only if the `Fill` variable is set to `true`. Default value is `#000000` (black color).

Note
The watermark string is case insensitive.

Though you can set both image and text watermarks at the same time, it makes sense to use only one of them. For text watermarks the only required variable is `Text`. Here is an example of the watermark string which will draw green semi-transparent italic text Aurigma in the bottom left corner of an image:

JavaScript | Copy Code
--- | ---
    iu.addParam("UploadThumbnail1Watermark", "Text='Aurigma';Opacity=75;FillColor=#00ff00;Position=BottomLeft;Style=Italic;Size=30");

For image watermarks `ImageUrl`, `ImageWidth`, and `ImageHeight` are required. Here is an example of semi-transparent logo drawn in the top tight corner of the image:

JavaScript | Copy Code
--- | ---
    iu.addParam("UploadThumbnail1Watermark",
    	"ImageUrl=http://localhost/AurigmaLogo.png;ImageWidth=86;ImageHeight=63;" +
    	"Position=TopRight;Opacity=50");

# See Also

##### Examples

Adding Watermarks

##### Reference

UploadThumbnail1BackgroundColor Property
UploadThumbnail1CompressOversizedOnly Property
UploadThumbnail1CopyExif Property
UploadThumbnail1CopyIptc Property
UploadThumbnail1FallbackMode Property
UploadThumbnail1FitMode Property
UploadThumbnail1Height Property
UploadThumbnail1JpegQuality Property
UploadThumbnail1ResizeQuality Property
UploadThumbnail1Width Property
UploadThumbnail2Watermark Property
UploadThumbnail3Watermark Property
UploadThumbnailWatermark Property