Aurigma Image Uploader 6.5 Dual
A value which defines print formats for the quality meter.
Get/Set Value in Runtime
getImageUploader("ImageUploaderID").setQualityMeterFormats(value); value = getImageUploader("ImageUploaderID").getQualityMeterFormats();
A string value that specifies a set of the print formats used in the quality meter. Format of this string is the following:
Format1 name,format1 width (pixels),format1 height (pixels),format1 acceptable ratio;Format2 name,format2 width (pixels),format2 height (pixels),format2 acceptable ratio;...
In other words:
- Each format is defined with 4 mandatory parameters: name, width, height, and acceptable ratio.
- Parameters are separated by comma.
- Formats are separated by semicolon.
Example of quality meter string can be found in the Remarks section.
If it is equal to the empty string, no quality meter is displayed.
Default value is "".
As mentioned above, each print format is described with four parameters:
- Format name
Name of the print format which will be displayed as a tooltip when a mouse is hovering over an appropriate quality meter element.
If the format name contains semicolon or quotation mark characters enclose this format in single (' ') or double (" ") quotes. Additionally, quotation marks (both single ' and double ") inside the name should be escaped with a backslash. For example, to get a User's format name, set this format as follows:
- Format width
- Minimum width (in pixels) which the photo should have to be interpreted as high quality for this print format (i.e. colored by the QualityMeterHighQualityColor value).
- Format height
- Minimum height (in pixels) which the photo should have to be interpreted as high quality for this print format (i.e. colored by the QualityMeterHighQualityColor value).
- Acceptable ratio (further, AR)
- Maximum acceptable ratio of format width (or height) and actual photo width (or height). If format width/photo width will be larger than AR, the photo will be interpreted as unacceptable for this print format.
For example, imagine we specify the following quality meter string:
iu.addParam("QualityMeterFormats", "4x6 inches,1800,1200,1.2;6x8 inches,2400,1800,1.3;");
It means that you specify two formats: 4x6 inches (1200x1800 pixels if to print with resolution equal to 300 DPI) and 6x8 inches (1800x2400 pixels for 300 DPI). This way the quality meter will have two elements. The table below demonstrates the quality meter values for images of different size. Let's assume that the default values for the quality meter colors are used (allowed formats are green, acceptable - yellow, non-recommended ones are gray).
|Image dimensions||Quality meter colors||Comment|
||Image dimensions exceed both format restrictions, so we can freely print it in both formats.|
The dimensions are larger than 4x6 inches, but smaller than 6x8 inches. Now we should estimate if it can be printed with the acceptable quality in 6x8 format. To do it, calculate the ratio between the format dimensions and the actual image dimensions (let's take a width for brevity):
1800/1500 = 1.2
Now we compare this value with the acceptable ratio (AR) specified as the fourth parameter. If this value is larger than AR, an image cannot be printed with this format, if otherwise - it is acceptable.
The AR specified for 6x8 inches is 1.3, thus it is acceptable and we mark a color meter with yellow.
The dimensions conform 4x6 inches, but are smaller than 6x8 inches. This time if we calculate the ratio between the format dimensions and the actual image dimensions, we will get:
1800/1200 = 1.5
It is larger than the AR (which is equal to 1.3) and that's why if we print this image in the 6x8 inches format, we will get quite poor quality. So we mark this color meter item to gray (i.e. as "not recommended").
The dimensions of this image are smaller than both formats. It is obviously too small for the 6x8 inches format, but let's check it for the 4x6 format:
The AR for the 4x6 inches format is 1.2, i.e. this image acceptable for it, and the appropriate quality meter element is yellow.
It is obvious that this image is too small to be printed even on a matchbox, so both elements of the quality meter are gray.