Working with image frames

This article is intended to be a compilation of operations pertaining to image frames.

If you are using 1.3.8/1.3.9, you will find more accurate information in Working with Frames and Working with Images in your handy online manual.

Creation
Create an image frame by: This will enable your mouse to place and size the image frame: click-and-hold-down mouse button, then drag diagonally on the page. The click determines one corner of the frame, letting up the diagonally opposite corner. It may be more conventional to start with the upper-left hand corner, but you may start with any corner to its opposite.
 * 1) Clicking the Insert Image Frame icon on the toolbar
 * 2) Selecting Insert > Image Frame from menu
 * 3) Keyboard: I, or Alt+N, I.

Context Menu
Clicking with the right mouse button brings up the Context Menu, which contains several common frame operations, an important one of which is the ability to convert a Image Frame to another type of frame.

Size and Position
At this point you will find that the Properties window is an indispensible item for working with Scribus. If not already present, open it under the menu item Windows > Properties. The XYZ tab of the Properties window shows very precise information about the X,Y position of the upper left hand corner, the width and height of the frame, and the frame's rotation. Note that information is only displayed for a selected frame -- displayed as a dashed red border. A frame is automatically selected when created. Unselect a frame by clicking on the page outside its borders, select it again by clicking inside. A frame must be selected to be modified or repositioned.

Properties: XYZ Tab - Resizing, Repositioning
Some Additional Help
 * From the Menu, Page > Snap to Grid will cause your frame to "stick" to the grid lines on the page. View > Show Grid toggles the grid on and off. (The grid does not print or become part of a PDF.) If you want to adjust the line spacing of the grid, go to File > Preferences > Guides.


 * From the Menu, Page > Snap to Guides will cause your frame to "stick" to guide lines on the page. View > Show Guides toggles them on and off. (Like the grid, guides do not print or become part of a PDF.) If you want to edit or add guides, go to Page > Manage Guides or File > Preferences > Guides.

Properties: Image Tab
If your frame is already the correct size, click Scale to Frame Size. Subsequent adjustments in frame size will adjust scaling to maintain scaling to the frame size. Clicking back to Free Scaling will allow you to crop edges, reposition, or change scaling.

Scaling, Repositioning -- the Image

See Resizing, Repositioning above for instructions on moving and resizing the frame -- Properties: XYZ Tab. X-Pos, Y-Pos: These refer to the offset of the image inside the frame. Negative values will expose the background color of the frame.

X-Scale, Y-Scale, Actual X-DPI, Actual Y-DPI: Default linked, click the chain to unlink. Obviously, scaling and DPI are inversely related, but for high-quality printed output, knowing the end-product DPI is essential to avoid poor quality results. If your end-product will be a PDF for the web or for a presentation, a lower DPI may suffice. See this page at the Scribus website for more details.

Some Additional Info:

The Context Menu (right-click in frame) > Info will give some basic information about your image -- file source, original and final scaling. The menu item Extras > Manage Pictures may also be of help.

Rotation
With the mouse:

Click the Rotate Item icon on the toolbar (keyboard: R), then click inside the frame and drag-rotate to desired angle.

With the Properties window: XYZ Tab

Just like resizing and repositioning, you have the same three ways to change the rotation digitally. There is also an icon just below (looks something like one of a pair of dice) to alter the point around which rotation takes place -- center or one of the four corners.

Copying Frames and Similar Operations
There are several different ways to copy or move frames.


 * 1) You should be familiar with Copy and Paste (keyboard: Ctrl+C, Ctrl+V) and Cut and Paste (keyboard: Ctrl+X, Ctrl+V) -- also accessible from Edit on the menu, and from the Context Menu (right-click in frame). To paste to another page, move to that page, click on it, then paste -- the frame will have the same coordinates as on the original page.
 * 2) There is also Duplicate (keyboard: Ctrl+Alt+Shift+D) Item > Duplicate. This makes a copy which is slightly offset from the original, and on a layer above it.
 * 3) There is Multiple Duplicate, Item > Multiple Duplicate, which brings up a requestor to automatically create as many copies as you wish, with a sequential adjustable offset. You can also use this for a single duplication when you want to set the offset. Note that once you set the offset here, Item > Duplicate will use this same offset.
 * 4) Finally, there is the Scrapbook, Item > Send to Scrapbook or from Context Menu (right-click in frame). This will make a named copy of the selected frame and its contents to the Scrapbook. To retrieve a saved item from Scrapbook, select from the menu Windows > Scrapbook, to bring up a requestor to paste an item to a page. Also note that you can save your entire Scrapbook to a file, which can then be loaded and used in another document.

Experimentation will show you that frames can even be outside the document boundaries and still be copied, duplicated and manipulated in various ways. They will even be saved with the document in these locations. If you try to generate a PDF, you will receive error messages about objects not being on the page; if ignored, the PDF will not have these objects. Furthermore, especially in a large multipage document, you may lose track of these off-document objects.

Levels & Layers
Frames in general, not just image frames, represent a two-dimensional space that you manipulate and move around your workspace, much like a small note you can attach and detach. Like small physical notes, they are laid down, one by one, on the page, new ones over the previous ones. The small box labeled Level in the XYZ tab of Properties allows you to move the selected frame up or down levels; the arrows with bars will move all the way to the top or bottom. Since the background of your frame may be opaque or transparent, the level the frame is at will affect how much of the frame can be visible in relationship to other overlapping or underlying frames.

XYZ Tab: The Rest
The remaining buttons in the XYZ tab do the following:


 * 1) Flip the selected frame horizontally or vertically
 * 2) Lock a frame in place. Everything about your frame is locked -- size, position, contents. Copying and pasting a locked frame may produce unexpected results.
 * 3) Lock the size of the frame only. Note that the editing tabs disappear from the corners and sides.
 * 4) Enable/disable printing of the frame. Why? You may want to have a frame on the page that's a message to yourself or someone else, yet not be part of the printed finished work. Or the frame may just be a space-saver for some other purpose.

Prepare the image in a bitmap editor (GIMP for example)

 * select the relevant part of image
 * create a mask from the selection and apply it (for removing background)
 * enlarge the selection if in Scribus you want to have a margin between the text and the image
 * create a path from selection
 * export image to TIF format

Apply the path in Scribus

 * load the image into the frame
 * in the context menu, select the image's extended properties
 * select the path you want to use (there may be multiple path stored in the image)
 * in the Properties Palette go to the Shape tab and select "Use Clipping Path"

Tip
The Clipping path is not properly changed when you manually scale the image in the frame. In that case in Scribus 1.4.1 and above you can convert the clipping path to a contour and edit it manually (move, scale).

Properties: Line Tab
The Line of an Image Frame refers to the border of the frame. The first thing to be aware of is that the default setting for Line Color is None, so regardless of the settings in the Line Tab, nothing will show until the Line Color is set.

Otherwise, the various settings for Line are straightforward. If a setting is greyed-out, it does not apply to frames.

Properties: Color Tab
As noted above, the Line Color refers to the border of the frame, with the default being None.

Fill Color means background color of the frame. None for a Fill Color means that the background is transparent.

Shade refers to saturation of the color, so that 0% should represent a neutral grey scale color. Opacity refers to the relative opacity/transparency, with 100% being totally opaque, 0% totally transparent. It is worth noting at this point that some PDF versions and some PDF viewers do not support transparency.

Overprinting versions 1.3.4 and above

Knockout versus Overprinting are described here.

''Please note that you are not limited to colors you see displayed in the Color Tab, nor are you compelled to have all these choices. See the Menu item Edit > Colors to add, edit, or remove colors. Removing colors can simplify the use of Scribus, and does reduce saved file size.''

(c) Gregory Pittman, 2006, 2007 The content of this page is licensed under the Free Documentation License.

Embed an image or group of objects in a text frame
It's possible to us an small image frame as a special glyph part of a text. - create image frame, choose filling image, copy frame (CTRL+C) - select text frame, enter text-edit mode, place editing carret where you want to place the image - paste (CTRL+V)

See : image now behaves as a glyph in the text frame. You can select it along with other text part, and notably i could use the "advanced parameters" of the text properties palette so as to position it precisely, slightly more up or down the base line.

It's also possible to insert a simple SVG icon as a vector file or a group of objects.

Once an image frame or a group of object is embeded in a text frame, it's still posible to edit it as an image frame or as a group of object : - enter text edit mode, - place editing carret just before the embeded frame or group - double click on image or group

Once this is done, it is possible to resize the object, add image effects, ungroup etc, validate and go back to embeding text frame.