Resizing Images

You can resize images with various methods. Following are the tasks you can perform.

  • Resize With Styles You can resize many images at once by using the img style in the Stylesheet Editor. Not only can you select a specific image size, but you can also set a maximum or minimum height or width. You can set either the width or height on the image tag and let Contributor set the other property automatically, maintaining the aspect ratio (i.e., size proportion of the image).

  • Resize Locally Using Properties You can resize an image locally by setting its height and width properties, including maximum or minimum height or width. This is similar to the styles method, except that the properties are set only for a specific image, not on a style that can be applied to many images.
  • Resize Locally Dragging the Icon You can resize an image locally by clicking and dragging the icon in the lower-right corner of the image. When you use this feature, Contributor automatically sets the new height and width on the image tag.
  • Reset Size If you resize an image and then decide you want it to be its original size (even after you save your work), you can easily reset it.

How to Resize Images by Using Styles

  1. Open the stylesheet you want to modify or create a new one.
  2. From the Medium drop-down in the Stylesheet Editor, make sure the proper medium is selected before you begin. In the Advanced view, you can open multiple mediums at once; you just need to look at the title at the top of the medium pane and make sure you are working in the correct one. If you are not using stylesheet mediums for your different outputs or if you want all mediums to have the same settings, just leave the medium set to default and continue.

    Mediums can be used if you want to use one group of settings for online output types and another group of settings for print-based output types. For example, you might use the default medium for your online outputs and the print medium for your print outputs. See Mediums and Media Queries.

    Please note that Contributor remembers the last medium that you used when working in the stylesheet, so it may or may not be the one that you want to use the next time around.

  3. In the local toolbar, make sure the first button displays The button to change the stylesheet to the advanced view.. If the button displays The button to change the stylesheet to the simplified view. instead, then click it.
  4. In the upper-left corner of the editor, click in the drop-down field and select .
  5. From the area below, select the img tag. If you created classes of the tag, you can expand the img style and select the class instead.

    Example You are creating a PDF manual that is 8 inches wide and you want to ensure that none of your largest images are wider than 6 inches. You can create a class of the img style and name it "MaxWidth6Inches." For most of your images, you can use the parent img style, but for the large ones, you can use the img.MaxWidth6Inches style class. The large images will automatically be resized if necessary so that they are no wider than 6 inches.

  6. From the Show drop-down list on the upper-right side of the editor, select Show drop-down set to display all properties in styles..
  7. (Optional) You can use the toggle button in the local toolbar to show properties below in a group view Stylesheet local toolbar button to show properties in a group view. or an alphabetical view Stylesheet local toolbar button to show properties in an alphabetical view..
  8. You can use the following steps to specify a precise width or height for the style. You can also specify a maximum or minimum width or height.

    To Set a Precise Width and/or Width

    1. If you are using the group view, expand the Box group.
    2. To the right of height and/or width, click Display more options., and complete the fields in the popup. Enter a value in the lower-left area and choose from several different units of measurement (points, pixels, centimeters, etc.) in the lower-right area. See Units of Measurement. Click OK when you are finished.

    To Set the Maximum Width and/or Height

    If the original image is larger than the maximum width or height that is set, it will be reduced in size so that it is no greater than the maximum value. If the original image is smaller than the maximum width or height, it will not be resized.

    1. If you are using the grouped view, expand the Unclassified group.
    2. To the right of max-height and/or max-width, click Display more options., and complete the fields in the popup. Enter a value in the lower-left area and choose from several different units of measurement (points, pixels, centimeters, etc.) in the lower-right area. See Units of Measurement. Click OK when you are finished.

    To Set the Minimum Width and/or Height

    If the original image is smaller than the minimum width or height that is set, it will be enlarged so that it reaches the minimum value. If the original image is larger than the minimum width or height, it will not be resized.

    1. If you are using the grouped view, expand the Unclassified group.
    2. To the right of min-height and/or min-width, click Display more options., and complete the fields in the popup. Enter a value in the lower-left area and choose from several different units of measurement (points, pixels, centimeters, etc.) in the lower-right area. See Units of Measurement. Click OK when finished.
  9. Click Save the active file. to save your work.

To apply a particular style class to an image (after you create it in the Stylesheet Editor), simply right-click the image where it is inserted. Then from the menu, select Style Class and choose the appropriate style.

How to Resize Images Locally by Using Properties

  1. Open the document or topic.
  2. Right-click on the image.
  3. From the context menu, select Image Properties. The Image Properties dialog opens.
  4. In the Image Properties dialog, adjust any of the following settings to resize the image.

    To Set a Precise Width and/or Height

    • In the Width and/or Height field of the Size section, provide the settings. First you need to select Length in the top drop-down list. You can then enter a value in the lower-left area and choose from several different units of measurement (points, pixels, centimeters, etc.) in the lower-right area. See Units of Measurement.

    To Set the Minimum Width and/or Height

    If the original image is smaller than the minimum width or height that is set, it will be enlarged so that it reaches the minimum value. If the original image is larger than the minimum width or height, it will not be resized.

    • In the Width and/or Height field of the Minimum Size section, provide the settings. First you need to select Length in the top drop-down list. You can then enter a value in the lower-left area and choose from several different units of measurement (points, pixels, centimeters, etc.) in the lower-right area. See Units of Measurement.

    To Set the Maximum Width and/or Height

    If the original image is larger than the maximum width or height that is set, it will be reduced in size so that it is no greater than the maximum value. If the original image is smaller than the maximum width or height, it will not be resized.

    • In the Width and/or Height field of the Maximum Size section, provide the settings. First you need to select Length in the top drop-down list. You can then enter a value in the lower-left area and choose from several different units of measurement (points, pixels, centimeters, etc.) in the lower-right area. See Units of Measurement.

  5. Click OK.
  6. Click Save the active file. to save your work.

How to Resize Images Locally by Dragging the Icon

  1. Open the content file.
  2. Hover over the image. An icon displays in the lower-right corner of the image.
  3. Click on the icon and drag your mouse either up and to the left (to reduce the size of the image) or down and to the right (to increase the size of the image).
  4. Click Save the active file. to save your work.

How to Reset the Size of an Image

  1. Open the content file.
  2. Right-click on the image.
  3. From the context menu, select Reset Size. The image returns to its original size.
  4. Click Save the active file. to save your work.

What’s Noteworthy?

Note This feature is not supported for MadCap Lingo review package (LIREV) files.

Note You cannot use stylesheets for this feature in the Review (Full Registered) workflow.

Note When resizing objects, you can ensure the aspect ratio is maintained. For example, if you want certain objects to be resized so that each is exactly 3 inches high, you can make sure the width of each object is adjusted accordingly to stay in proportion. To do this, first set the height at 3 inches. You would not set the width property at all. In the same way, if you were to specify an exact width, you could maintain the aspect ratio by not setting the height.

Note Please be aware that if you are using percentage for the size of an object, the percentage refers to the block containing that object, not to the object itself. For example, if you have an object in a topic and set the width to 60%, this does not mean that the object will be reduced to 60% of its size. Instead, it means that the object will be resized so that its width is 60% of the "container" where it is inserted.