Create Resized Images Plug-in
This plug-in allows an administrator to specify that multiple resized images will be created when a user uploads a single image. For example, if the administrator desires that a thumbnail automatically be generated for an image that a user uploads, the administrator will attach this plug-in to the asset factory that will be used to upload the image.
Use this plug-in anytime there is a need for having multiple copies of the same image in Cascade Server so that each copy is of different size. For example, when the users need thumbnail versions of the images, low-res and high-res versions, etc. The plug-in cuts the time of working on images for web pages. Users do not need to be using graphics tools to get different versions of the same image. Cascade Server will resize images for them.
Note: this plug-in relies on the Java Imaging API and as such is only able to work with freely licensed image formats. This means this plug-in can work with JPEG, JPEG2000, BMP, and PNG images, but not GIF images.
To activate this plug-in:
- In the Administration area select Asset Factories.
- Select a current asset factory, or create a new one by selecting “New Asset Factory”.
- If you are creating a new asset factory, “Asset Factory Type” select “File” and click “Submit”. On the “General” tab, select the desired attributes for your asset factory. Make sure to leave the “Base Asset” value blank.
- On the “Plugins” tab, select “Create Resized Image Plugin” from the “Add Plugin” drop down. Click the green plus sign to add the plug-in.
- This plug-in takes parameters, so return to the “Plugins” tab and find the“Create Resized Images Plug-in” section .
- Click the green plus sign next to “Add parameter” three times to add all available parameters.
- Once these parameters are added, you may now fill them in with the desired values. Return to the “Plugins” tab to fill out the three parameters:
Number of additional images: This is a non-negative integer for how many additional images the plug-in will create in addition to the original.
Image widths: This is a comma-delimited list of the widths for the additional images. Note that both pixel values and percentages may be used interchangeably. A blank space character could be used as well as one of the values. This would make the resizer calculate the width of the resized image so that the width to height ratio is kept. However, leaving both width and height values blank for the same image is not allowed. To use a pixel value, simply enter the number of pixels. To use a percentage, enter the percentage followed by the percent sign. Example: "450, ,20%" would create an additional image 450 pixels wide, another image that has calculated width based on its new height and the original image’s width to height ratio and another image that had a width 20% of the original image's pixel width value. Please make sure that there is a space character between the two commas.
Image heights: This is a comma-delimited list of the heights for the additional images. Note that both pixel values and percentages may be used interchangeably. A blank space character could be used as well as one of the values. This would make the resizer calculate the height of the resized image so that the width to height ratio is kept. However, leaving both width and height values blank for the same image is not allowed. To use a pixel value, simply enter the number of pixels. To use a percentage, enter the percentage followed by the percent sign. Example: "450, ,20%" would create an additional image 450 pixels high, another image that has calculated height based on its new width and the original image’s width to height ratio and another image that had a width 20% of the original image's pixel width value. Please make sure that there is a space character between the two commas.
Both the width and height comma delimited lists must be specified and must contain an amount of comma-delimited values equal to the number of additional images.
Examples:
|
Number of Additional Images:
|
1
|
|
Widths:
|
15%
|
|
Height:
|
15%
|
The plug-in will create an image that is 15% of the size of the original image. So that if an uploaded image had size of 1000x1000 then the new size will be 150x150. If an uploaded image has size of 2000x1000 then the new size will be 300x200.
|
Number of Additional Images:
|
1
|
|
Widths:
|
200
|
|
Height:
|
100
|
The plug-in will create an image that is 200 pixels wide and 100 pixels high. So that no matter what the original image size was, the new image will always be 200x100.
|
Number of Additional Images:
|
1
|
|
Widths:
|
150
|
|
Height:
|
|
Height is an empty space and the plug-in will create an image with width of 150 and the calculated height so that the width to height ratio is not changed. So that if an uploaded image had size of 1500x1000 then the new size will be 150x100. If an uploaded image has size of 1500x2000 then the new size will be 150x200.
|
Number of Additional Images:
|
1
|
|
Widths:
|
|
|
Height:
|
150
|
Width is an empty space and the plug-in will create an image with height of 150 and the calculated width so that the width to height ratio is not changed. So that if an uploaded image had size of 1000x1500 then the new size will be 100x150. If an uploaded image has size of 2000x1500 then the new size will be 200x150.
|
Number of Additional Images:
|
2
|
|
Widths:
|
150,300
|
|
Height:
|
,200
|
Height is: space, comma and number 200 and the plug-in will create two extra images. One will have width 150 and calculated height so that the width to height ratio is kept. The second image will be 300 by 200.
|
Number of Additional Images:
|
2
|
|
Widths:
|
, |
|
Height:
|
150, 300
|
Width is space, comma and space and the plug-in will create two extra images. One will have height of 150 and calculated width and another will have height 300 and calculated width. The widths will be calculated the way so that the width to height aspect ratio is kept.