Kentico CMS 7.0 Developer's Guide

Image editing

Image editing

Previous topic Next topic Mail us feedback on this topic!  

Image editing

Previous topic Next topic JavaScript is required for the print function Mail us feedback on this topic!  

Here you will learn how to edit the selected image. Besides, you will learn how to view the image properties:

 

Resize

Rotation

Convert

Crop

Color

Properties

 

Each action is performed after clicking the OK button. Please refer to the Saving changes topic for more details.

 

Resize

 

The Resize action lets you change the size of the image. The image is either enlarged or reduced to the size you specify. You may specify either a relative percentage to resize the image by, or an absolute pixel size. If the Maintain aspect ratio option is checked, then typing a new Width value will maintain a proportional Height value, and vice versa.

 

devguide_clip1400

 

By percentage - resizes the image to the entered percentage of side size.

By absolute size - resizes the image to the size specified in the Width and Height fields.

Width - the width size of the image; in pixels.

Height - the height size of the image; in pixels.

Maintain aspect ratio - if checked, proportional values of the image dimensions will be maintained.

 

Rotation

 

The Rotation action commands enable you to rotate the image by 90 degrees (in either the clockwise or counter-clockwise directions) and to flip the image, both horizontally and vertically.

 

devguide_clip1401

 

Rotate 90° left - rotates the image to the left by 90 degrees.

Rotate 90° right - rotates the image to the right by 90 degrees.

Flip horizontally - flips the image horizontally.

Flip vertically - flips the image vertically.

 

Convert

 

The Convert action enables you to transform the image file from one format to another. The From field of the action dialog tab is always filled in automatically according to the current format of the edited image. Please note that for the .jpeg image file type, you can also define image quality by entering the image quality percentage into the Quality field.

 

devguide_clip1402

 

From - the source format of the image.

To - the target format of the image; .bmp, .gif, .png and .jpg image formats are supported.

Quality - the quality of compression; applicable only for .jpg conversion.

 

Crop

 

The Crop action enables you to remove portions of the image to create focus or strengthen the composition. Image size is reduced without changing image resolution, so that the edited image is not distorted. Using Kentico CMS Image editor, you can crop images either manually by entering the coordinates of the upper-left point of the crop area rectangle and its width and height or you can move the mouse over the area of focus. The crop area rectangle can be resized in any direction unless the Lock aspect ratio option is checked. If checked, proportions of the currently selected crop area rectangle are maintained while resizing.

 

devguide_clip1403

 

X - the X coordinate of the upper-left point of the crop area rectangle.

Y - the Y coordinate of the upper-left point of the crop area rectangle.

Width - the width of the crop area rectangle; in pixels.

Height - the height of the crop area rectangle; in pixels.

Lock aspect ratio - if checked, the crop area rectangle will keep its current proportions while resizing it in any direction.

The same functionality can be achieved by holding the SHIFT key while moving the mouse. If the Lock aspect ratio option is checked while performing this operation, the result is inverse.

Pressing the CTRL key will result in returning the square of the currently selected rectangle area.

 

Please note that the crop area rectangle can be moved within the crop area by moving the mouse inside the rectangle.

 

Click OK to confirm the immediate change or click Reset or anywhere within the edited image outside the crop area rectangle to clear all the Crop action input fields.

 

Color

 

The Color action lets you easily convert the image from color to grayscale.

 

devguide_clip1405

 

Convert to grayscale - clicking this link results in converting the image from color to grayscale.

 

Properties

 

The Properties tab displays important information about the image such as its file name, title, description, extension, size, width and height. The File name, Title and Description fields are editable, enabling you to change the respective properties of the image.

 

devguide_clip1406

 

File name - the file name of the image.

Title - the title of the image; image metadata that can be used e.g. in transformations.

Description - the description of the image; image metadata that can be used e.g. in transformations.

Extension - the file type extension of the image.

Size - the size of the image; in kB.

Width - the width of the image; in pixels.

Height - the height of the image; in pixels.

 

 

 

 

Please note

 

If you decide to leave the Image editor without saving the changes you have made (by clicking the Close button), a message window will pop up informing you that all changes will be lost.