Create an image

Use the Create Image command to add a totally new image to the repository. If you're simply adding a new resolution of an existing image, you should use the Replace image procedure.

Once you've imported the first image, you can keep the dialog open and import several different formats for use with different types of output.
Note: Any document that you create is automatically assigned to you.

To create a new image:

  1. Do one of the following:
    • Press CTRL+ALT+I.
    • On the Document Creation toolbar, click the Create Image button (Image import icon new).
    • From the menu bar, select DITA CMS > Create Image.
    The Show/Edit Image dialog appears.
  2. Enter a Title.
    Titles do not need to be unique.
  3. Enter a brief Description.
    This information becomes part of the file metadata. Enter all the keywords that you think may be useful when you want to search for the file.
  4. Select an Image Type: Screen Capture, Line Art, or Equation.
  5. If the image requires localization, select Needs Translation.
    By default, this check box is enabled for Screen Captures and Line Art. You can override the defaults and select the value that's appropriate.
    Note: If Needs Translation is not selected, then when the map is put into the Localization cycle, the image will automatically be given the status Localization:review (or its equivalent in your workflow).
  6. Select a Language.
  7. In the Images area, select a Format name.
    Format names represent the different graphic formats or resolutions that your system uses with different types of output. The format names that you see here will vary according to how your system is configured.

    A line with no image details (no Mime Type, Width, Height) means that there is no image in the repository for that format.

    images area blank

  8. Click Import.
    The Open dialog appears.
  9. Navigate to the required image, select it, and click Open.
    Tip: You can configure a default import directory where the Open dialog will go automatically by configuring the DITA CMS Import Export options in Preferences.
    The Show/Edit Image dialog reappears. The Images area displays the new image's Mime type, Width, and Height, and the image itself is previewed at the side.
  10. Repeat the import process for the different formats.
    Once an image has been imported into the repository for a specific format name, that line displays in green to indicate that this is a new image. The default image is displayed in bold.

    Images area

  11. Select the image format that you want to use as the default and click Set as Default.
    This is the image that will appear in the Preview view and in the XMetaL editor. It's also the image that will be substituted if the Output Generator cannot find the format specified by a transformation template.
  12. In the Labels pane, click Select to add labels.
    The labels that you select are listed in the Labels pane.
  13. Optional: To save the settings you have selected for Language and Image Type, click Save Settings.
    Your selections are saved and used as the default values in the Show/Edit Image dialog. You'll see them there the next time you import an image.
  14. The next step depends on whether the Dynamic Release Management module is enabled in your deployment:
    • If you see the Next button at the bottom of the Show/Edit Image dialog, this module is enabled in your deployment. Go to the next step to specify the release management details.
    • Otherwise, this module is not enabled. Click OK to create the image. You have completed this procedure.
  15. Click Next.
    The Select Versions dialog box is displayed.
  16. In the Add Object To pane, select Products or Libraries.
  17. In the All Products/All Libraries pane, select the product or library for which you would like to display the releases and versions.
    Use the filter at the bottom of the pane to filter the objects in the list by name.
    The releases and versions for the product or library selected are displayed in the Selected Products/Libraries, Releases, and Versions pane.
  18. To exclude products/libraries, releases, and versions according to the exclusion filters, click Apply global exclusion filter settings.
  19. In the Selected Products/Libraries, Releases, and Versions pane, select the versions in which the object can be used.
    Use the filter at the bottom of the pane to filter the objects by release name.
    The Primary Version drop-down list is populated with the list of selected versions.
  20. In the Primary Version list, select the primary version for the object.

    The primary version is the version for which the object was initially created.

  21. Optional: To save the settings you have selected in this dialog, click Save Settings.
    Your selections are saved and used as the default values in the Select Versions dialog. You'll see them there the next time you create an image.
  22. When you are finished importing, click OK.
All the imported images are assigned a collective ID and stored in a zip file with the extension .image. When output is generated, the transformation template will insert the correct format or the default format if there is no image with the required format.

You can now insert the image in a topic.