## Working with Images

Your first impulse on adding images to your document may be to simply load an image file into it. However, Scribus works in a frame-based environment, so that all content is contained within a frame or box which defines the boundaries of that content. Your first step, then, is to create an Image Frame, after which you will then load an image file into that frame.

See Working with Frames to learn about Image Frame frame creation and manipulation. Note that the image frame shows as a red border with small square handles at the corners and at the midpoints of each side. Diagonals in black are drawn to indicate that it is an image frame. Note that these small square handles disappear when the frame is locked.

The quickest way to load an image into the frame is to right-click on the frame, and select Get Image from the Context Menu. Pressing Ctrl+I or menu File > Import > Get Image will also work. A file dialog will appear, showing the image types that Scribus can import, which include bitmap formats like TIFF, PNG and JPG, as well as vector/mixed vector-bitmap formats PS (PostScript), EPS (Encapsulated PostScript) and PDF, which will be converted to bitmaps.

A new feature in image loading is the ability to create a stack of images, in other words, select a number of images. To do this, hold down Ctrl while selecting one image after another. If you change your mind, click again to unselect your choice.

You can even choose images from another directory by navigating with the dialog. As long as you don't click OK, you will continue to add to your stack of images. When you get back to the canvas, you must have created image frames already to utilize your stack. At this point, just click-click-click from one frame to the next to empty your stack of images. If you click a frame that already has an image, it will be replaced.

Notice how you create a particular order to your list of images.

After import the image may only partly show, depending on your default settings in Preferences. We’ll see below in Properties: Image how to adjust scaling and positioning of the image in the frame, but for now, you might just right-click on the image, then from the Context Menu that pops up, select Image > Adjust Image to Frame to show how quickly you can size the image to your frame.

Descriptions, advantages and disadvantages of various file formats will be discussed elsewhere, in Importing Bitmap Files.

### The Context Menu

Right-click on the empty frame to show its Context Menu as seen to the right. An empty frame will not show all these choices. There have been a number of changes, mostly rearrangements, as of version 1.5.3.

- Info gives a short list of information about the image, its name, the PPI (pixels per inch) of the original and as shown in Scribus, its colorspace, and whether it is set to print (and export to PDF).
- Content has submenu items.

- Get Image allows for importing an image, as indicated above. This will be the only choice if the frame is empty.
- Copy means to copy the contents, not the entire frame.
- Clear clears the contents of the frame.

- Preview Settings This allows to image to be visible or not, and if visible, the resolution can be selected. Lower resolution or not showing images will speed up screen refreshes if this is sluggish. Full Resolution can only be as high as your monitor supports. These settings do not affect printing your image or exporting to PDF.
- Image has submenu items, as shown here.

- Image Effects (also Ctrl + E) provide for a number of editing types, like blurring or changing contrast and brightness. These edits happen in a nondestructive way, i.e., the source file is not altered.
- Edit Image starts your image editor as set in the File->Preferences->External Tools and loads the image.
- Embed Image is now an option, which will put the image data in your Scribus file.
- More Info... shows additional information from the file such as the camera and camera settings.
- Update Image reloads the image. Would be used if you have edited the source file. See Edit Image below.
- Adjust Frame to Image enlarges or shrinks the width and height of your frame to fit the image at its current resolution.
- Adjust Image to Frame adjusts the image to the frame. Image will remain proportional if this is checked in Image tab of Properties.

- Locking has submenu items.

- Is Locked locks the frame’s position, size, and content.
- Size is Locked locks only the size. Frame and image can otherwise be moved and edited.

- Send to has submenu items.

- Choices here are Scrapbook, Patterns, and Inline Items but will not be covered here, except to say that these allow for saving content to be shared among documents.

- Send to Layer (not shown) will appear if your document has more than one layer, to allow moving the frame to a different layer.
- Level has submenu items. Just as in the X,Y,Z tab of Properties, you can Raise or Lower a level, or Raise to Top or Lower to Bottom.
- Convert to gives you the following sub-choices:

- Polygon, converts to a polygon, with apparent loss of your image, recoverable with Convert to Image Frame.
- Text Frame converts to that kind of frame, in which case your image becomes invisible, but will be restored if you convert back to an image frame. You cannot show text and an image together, except where text is incorporated in an image. Use a superimposed text frame to apply text over an image.
- Symbol, which is new to 1.5.3 versions, allows its reuse as is, or as a Pattern. From the menu, Windows > Symbols brings up the Symbols palette.

- Attributes will not be discussed here.
- Edit has submenu items.

- Cut, Copy, and Delete are covered in Working with Frames. Note that these apply to the entire frame.
- Undo will be available for any recent undoable change.
- Redo will also be available, if applicable.

- Properties brings up or hides the Properties Palette

### Image Properties

We now have moved Image Properties to its own dockable palette. What you see here is what has been removed from Properties. In the top section, we see X-Pos, Y-Pos, and Rotation. These refer to the position of the image inside the frame. For example, X-Pos is the relative position of the image itself compared to the upper left corner of the frame. Similarly, Rotation applies to the rotation of the image relative to the frame.

When an Image is first loaded, the default is for it to have Free Scaling or as is set in File > Preferences/Document Setup > Tools > Image.

Under Free Scaling the spinboxes are:

- X-Pos and Y-Pos - Relative position of the left upper corner of the image to the left upper corner of the frame.
- X-Scale and Y-Scale - Magnification of the image, compared to its native DPI.
- Actual X-DPI and Actual Y-DPI - These of course are inversely related to magnification. Your monitor will still likely be showing the image at no better than 72 or 96 PPI, but this setting refers to the final resolution to be exported to the PDF.

In many cases, we may have a more or less set frame size we wish to squeeze an entire image into, in which case choosing To Frame Size (or Adjust Image to Frame from the Context Menu) makes sense. Without checking Proportional, the image is simply stretched to fit the frame and may be quite distorted. You should find the combination of scaling to frame size (proportional) and then Adjust Frame to Image from the Context Menu very useful for making a frame exactly the right size for your image.

The PDF Compression section tells us that you can now specify per-frame values.

The Image Effects button brings up its dialog, which allows you to apply some selected imaging manipulation, such as adjusting Brightness or Contrast, Blurring, and so on.

| If you see this warning triangle in the lower right corner of your frame, it indicates that the image resolution is below 144 DPI, or whatever you have set as your minimum value in the Preflight Verifier settings in File > Preferences or File > Document Settings. This is strictly a warning.

### Edit Contents Mode

Enter Edit Contents mode by clicking the icon on the toolbar, or pressing E from the keyboard. Go back to Select Item mode by pressing Esc, or clicking outside, then inside the frame. You will need to have checked Free Scaling in order for this to be operational.

With image frames, Edit Contents mode allows you to click-drag with the mouse to shift the image relative to the frame, i.e., the same as adjusting the X-Pos and Y-Pos in the Image tab.