Revision as of 15:26, 29 March 2011

CKFinder allows you to create thumbnails and to scale uploaded images to the preferred size.

This section describes working with images. It will provide you with the information on how to properly configure thumbnails and image resizing options.

Thumbnails

You can set thumbnails parameters by changing the following values:

Set Thumbnails = server.CreateObject("Scripting.Dictionary")
Thumbnails.Add "url", baseUrl & "_thumbs"
Thumbnails.Add "directory", baseDir & "_thumbs"
Thumbnails.Add "enabled", true
Thumbnails.Add "maxWidth", 100
Thumbnails.Add "maxHeight", 100
Thumbnails.Add "quality", 80

• maxWidth and maxHeight – determine the maximum size of the thumbnails which can appear in CKFinder. These values are defined in pixels. You can obviously increase them, but the thumbnails will then look more like full-sized images than like miniatures.

• quality – sets the quality of a thumbnail in a range from 1 to 100. The smaller the quality value, the smaller the size of the thumbnail. Notice that an acceptable quality value is about 45 and the most frequently used one is about 80.

• directAccess – this setting may increase the overall performance of CKFinder. By default, CKFinder connects to the server connector to get the thumbnail. It is not a problem in most cases, because the connector sends the HTTP/304 Not Modified header most of the time to save the traffic and reduce server-side processing. However, sometimes it is better to leave cache control to the browser. When directAccess is set to true, thumbnails are loaded directly from the _thumbs folder by CKFinder. Note that it is impossible to use this setting, if the thumbnail directory is located outside the document root.

• You may disable thumbnails by placing the bool value false in the enabled section.

Scaling

The scaling (resizing) option allows you to define the maximum size of uploaded images. If the image size is bigger than the one specified by you, the image will be scaled to the defined dimensions.

You can also change the quality of uploaded images by setting it in a range from 1 to 100. To apply these options you should change the following configuration settings:

Set Images = server.CreateObject("Scripting.Dictionary")
Images.Add "maxWidth", 1200
Images.Add "maxHeight", 1200
Images.Add "quality", 80
Images.Add "component", "Auto"

The component entry specifies the method that should be used to handle images and thumbnails. It can be set to one of the following values:

• Asp.Net – it should work with Asp.Net 1.1 and 2.0 without any extra software.
• Persits.Jpeg – commercial component from Persits.
• briz.AspThumb – commercial component from BRIZ Software.
• AspImage.Image – commercial component from ServerObjects. The available demo is expired and does not seem to handle .gif files properly.
• shotgraph.image – commercial component from ShotGraph. The demo version does not allow for resizing.
• Auto – this setting will try to autodetect the available solution, in the order described above. It is the default value, but for better performance you should specify the component that you are going to use.
• None – image manipulation (thumbnails, maximum dimensions, validation) will not be available.