Configure image formats

If you need different image formats for different outputs, such as high resolution images for print-based outputs and lower-resolution images for HTML-based outputs, you can configure those formats.

About this task

Important: As mentioned in the multiimage.xmlfile, it is not advisable to rename or delete existing image formats. If you must do so, first ensure that no images are using the format you want to rename or delete. Images that use a non-existent image format are invalid.
Important: Make configuration changes in a test environment and confirm they work before copying them to a production environment.

Procedure

  1. In the TEXTML Administration perspective, connect to your server.
  2. Check out and open the /system/conf/multiimage.xml file.
  3. In the <formatnames> section, add a new <formatname> element to specify each image format that your users can select when they import or add new images.
    For example:
    <formatnames>
        <formatname file-extensions="">LowRes</formatname>
        <formatname file-extensions="">HiRes</formatname>
        <formatname file-extensions="">Source</formatname>
    </formatnames>

    The first format in the <formatnames> list is the default format. This means that when users add or import an image, it is automatically given the default format unless you have associated file extensions with the formats.

    The image thumbnails that appear in theImage Preview column of datagrids and the images that appear in Web Author are based on the default format. Larger images take longer to render as thumbnails and the thumbnail files are larger. For this reason, MadCap recommends that you make a lower-resolution format the default.

    Note: The format names defined in multiimage.xml must match the format names called by the Output Generator targets. If you change the default image formats, be sure to make corresponding changes in the Output Generator output targets.
  4. Optional: If you want the file extension of an image to determine the default format that is assigned when a user imports the image, add this information using the @file-extensions attribute.

    For details about how file formats and file extensions work together, see Image formats and types.

  5. Optional: Continue to Configure image types.
  6. Save, close, and check in the file.
  7. Inform users of the changes.
    The changes are automatically applied once users close and then reopen their IXIA CCMS Desktop. Users can also apply the changes without restarting their CCMS Desktop by clicking IXIA CCMS > Synchronize Configuration.