Writer GuideChapter 8Working with Images

CopyrightThis document is Copyright 2011–2014 by the LibreOffice Documentation Team. Contributorsare listed below. You may distribute it and/or modify it under the terms of either the GNU GeneralPublic License (, version 3 or later, or the Creative CommonsAttribution License (, version 3.0 or later.All trademarks within this guide belong to their legitimate owners.ContributorsJohn A SmithBarbara DupreyJean Hollis WeberJamie EbyRon Faile Jr.FeedbackPlease direct any comments or suggestions about this document to the Documentation Team’smailing list: [email protected]: Everything you send to a mailing list, including your email address and any other personalinformation that is written in the message, is publicly archived and cannot be deleted.AcknowledgmentsThis chapter is adapted and updated from Chapter 8 of the 3.3 Writer Guide. Thecontributors to that chapter are:Agnes BelzunceGary SchnablMichele ZarriJohn KaneBarbara M. TobiasVincenzo PonziJean Hollis WeberPublication date and software versionPublished 18 June 2014. Based on LibreOffice 4.2.Note for Mac usersSome keystrokes and menu items are different on a Mac from those used in Windows and Linux.The table below gives some common substitutions for the instructions in this chapter. For a moredetailed list, see the application Help.Windows or LinuxMac equivalentEffectTools Optionsmenu selectionLibreOffice PreferencesAccess setup optionsRight-clickControl click and/or right-clickdepending on computer setupOpens a context menuCtrl (Control) (Command)Used with other keysF5Shift F5Opens the NavigatorF11 TOpens the Styles and Formatting windowDocumentation for LibreOffice is available at

ContentsCopyright.2Contributors. 2Feedback. 2Acknowledgments. 2Publication date and software version.2Note for Mac users.2Images (graphics) in Writer.5Creating and editing images.5Preparing images for black-and-white printing.6Adding images to a document.6Inserting an image file.6Drag and drop. 6Insert Image dialog. 7Linking an image file. 7Embedding linked images.8Inserting an image from the clipboard.9Inserting an image using a scanner.9Inserting an image from the Gallery.9Modifying an image.10Using the Picture toolbar. 11Graphics mode. 11Flip vertically, horizontally or in 90 rotations.11Filters. 12Color. 12Transparency. 12Using the Formatting toolbar and Picture dialog.13Cropping images. 13Resizing an image. 14Rotating an image. 15Other settings. 16Deleting an image. 16Using Writer’s drawing tools.16Creating drawing objects. 17Set or change properties for drawing objects.17Resizing a drawing object. 18Grouping drawing objects. 18Positioning images within the text.18Arranging images. 19Anchoring images. 20Aligning images. 21Wrapping text around images.21Editing the contour. 23Example 1: Page wrapping.24Working with Images3

Example 2: Simple contour wrapping in action.24Example 3: Wrap Through and In Background.25Adding captions to images.26Adding captions automatically.26Adding captions using the Caption dialog.27Overriding the default positioning of captions.27Adding captions manually. 28Place the graphic and its caption in separate paragraphs.28Use a table. 28Creating an image map.29Managing the Gallery.30Adding an image to the Gallery.30Deleting images from the Gallery.31Adding a new theme to the Gallery.32Deleting a theme from the Gallery.32Location of the Gallery and the objects in it.32LibreLogo scripting.32Logo toolbar. 32The basics. 334Working with Images

Images (graphics) in WriterWhen you create a text document using LibreOffice Writer, you may want to include someillustrations. Illustrations (images or graphics) are added to documents for a variety of reasons:from supporting the description provided in the text—as used in this Guide—to providing animmediate visual representation of the contents, as is often found in a newspaper.Images in Writer are of three basic types: Image files, such as photos, drawings, and scanned images Diagrams created using LibreOffice’s drawing tools Charts created using LibreOffice’s Chart facilityThis chapter covers images and diagrams.More detailed descriptions on working with drawing tools can be found in the Draw Guide andImpress Guide. Instructions on how to create charts are given in the Calc Guide.Creating and editing imagesYou might create images (also called ‘pictures’ in LibreOffice) using a graphics program, scanthem, or download them from the Internet (make sure you have permission to use them), or usephotos taken with a digital camera. Writer can import various vector (line drawing) images, and canrotate and flip such images. Writer also supports raster (bitmap) file formats, the most common ofwhich are GIF, JPG, PNG, and BMP. See the Help for a full list.Writer can import SmartArt images from Microsoft Office files. For example, Writer can open aMicrosoft Word file that contains SmartArt, and you can use Writer to edit the images.Some things to consider when choosing or creating pictures include image quality and whether thepicture will be printed in color or black and white (grayscale).To edit photos and other bitmap images, use a bitmap editor. To edit line drawings, use a vectordrawing program. You do not need to buy expensive programs. Open-source (and usually no-cost)tools such as Gimp (bitmap editor) and Inkscape (vector drawing program) are excellent. For manygraphics, LibreOffice Draw is sufficient. These and many other programs work on Windows,Macintosh OS X, and Linux.For best results: Create images that have the exact dimensions required for the document, or use an appropriate graphics package to scale photographs and large drawings to the requireddimensions. Do not scale images with Writer, even though Writer has tools for doing this,because the results might not be as clear as you would like.Do any other required image manipulation (brightness and contrast, color balance,cropping, conversion to grayscale, and so on) in a graphics package, not in Writer, eventhough Writer has the tools to do a lot of these things too.If the document is meant for screen use only, there is no need to use high resolutionimages of 300 or more dpi (dots per inch). Most computer monitors work at between 72and 96 dpi; reducing the resolution (and the file size) has no negative impact on what isdisplayed but does make Writer more responsive.Creating and editing images5

Preparing images for black-and-white printingIf color images are to be printed in grayscale, check that any adjacent colors have good contrastand print dark enough. Test by printing on a black-and-white printer using a grayscale setting.Better still: change the “mode” of the image to grayscale, either in a photo editor or in Writer itself(see “Graphics mode” on page 11).For example, the following diagram looks good in color. The circle is dark red and the square isdark blue. In grayscale, the difference between the two is not so clear. A third element in thediagram is a yellow arrow, which is almost invisible in grayscale.Original drawing in colorDrawing printed in grayscaleChanging the colors of the circle and the arrow improves the contrast and visibility of the resultinggrayscale image.Original drawing in colorDrawing printed in grayscaleIf the document will be available in black-and-white print only, a better result can often be obtainedby choosing grayscale fills, not color fills—and you don’t have to guess and test to see if you’vemade good choices.Adding images to a documentImages can be added to a document in several ways: by inserting an image file, directly from agraphics program or a scanner, from a file stored on your computer, or by copying and pasting froma source being viewed on your computer.Inserting an image fileWhen the image is in a file stored on the computer, you can insert it into a LibreOffice documentusing either of the following methods.Drag and drop1) Open a file browser window and locate the image you want to insert.2) Drag the image into the Writer document and drop it where you want it to appear. A faintvertical line marks where the image will be dropped.This method embeds (saves a copy of) the image file in the Writer document. To link the fileinstead of embedding it, hold down the Control Shift keys while dragging the image.6Working with Images

Insert Image dialog1) Click in the LibreOffice document where you want the image to appear.2) Choose Insert Image From File from the Menu bar.3) On the Insert Image dialog, navigate to the file to be inserted, and select it.At the bottom of the dialog are two options, Preview and Link. Select Preview to view athumbnail of the selected image on the right (as shown in the example), so you can verifythat you have the correct file. See “Inserting an image file” below for the use of Link.4) Click Open.Figure 1: Insert Image dialogLinking an image fileIf the Link option in the Insert picture dialog is selected, LibreOffice creates a link to the filecontaining the image instead of saving a copy of the image in the document. The result is that theimage is displayed in the document, but when the document is saved, it contains only a referenceto the image file—not the image itself. The document and the image remain as two separate files,and they are merged together only when you open the document again.Figure 2: Cautionary message box when inserting a linked imageLinking an image has two advantages and one disadvantage: Advantage – Linking can reduce the size of the document when it is saved, because theimage file itself is not included. File size is usually not a problem on a modern computerwith a reasonable amount of memory, unless the document includes many large imagesfiles; LibreOffice can handle quite large files.Adding images to a document7

Advantage – You can modify the image file separately without changing the document because the link to the file remains valid, and the modified image will appear when younext open the document. This can be a big advantage if you (or someone else, perhaps agraphic artist) is updating images.Disadvantage – If you send the document to someone else, or move it to a differentcomputer, you must also send the image files, or the recipient will not be able to see thelinked images. You need to keep track of the location of the images and make sure therecipient knows where to put them on another machine, so the document can find them.For example, you might keep images in a subfolder named Images (under the foldercontaining the document); the recipient of the file needs to put the images in a subfolderwith the same name (under the folder containing the document).NoteWhen inserting the same image several times in the document it would appearbeneficial to create links; however, this is not necessary as LibreOffice embeds inthe document only one copy of the image file.Embedding linked imagesIf you originally linked the images, you can easily embed one or more of them later if you wish. Todo so:1) Open the document in LibreOffice and choose Edit Links.2) The Edit Links dialog shows all the linked files. In the Source file list, select the files youwant to change from linked to embedded. Click Update to ensure you have the latestimage where changes may have taken place.3) Click the Break Link button.4) Click Yes in the confirmation message box.5) Save the document.NoteGoing the other way, from embedded to linked, is not so easy—you must deleteand reinsert each image, one at a time, selecting the Link option when you do so.Figure 3: The Edit Links dialog8Working with Images

Inserting an image from the clipboardUsing the clipboard, you can copy images into a LibreOffice document from another LibreOfficedocument and from other programs. To do this:1) Open both the source document and the target document.2) In the source document, select the image to be copied.3) Move the mouse pointer over the selected image and press Control C (or right-click andselect Copy from the context menu) to copy the image to the clipboard.4) Switch to the target document.5) Click to place the cursor where the image is to be inserted.6) Press Control V (or right-click and select Paste from the context menu) to insert the image.CautionIf the application from which the image was copied is closed before the image ispasted into the target, the image stored on the clipboard could be lost.Inserting an image using a scannerIf a scanner is connected to your computer, LibreOffice can call the scanning application and insertthe scanned item into the LibreOffice document as an image. To start this procedure, click whereyou want the image to be inserted and select Insert Image Scan Select Source.Select the scan source from the list. This list will contain available devices and, on Windowssystems the Windows Imaging Acquisition (WIA) platform to these devices. After choosing thedevice, select Insert Image Scan Request. This will open the imaging software to permityou to adjust settings for picture quality, size, and other settable attributes. This practice is quickand easy, but may not result in a high-quality image of the correct size. You may get better resultsby scanning material into a graphics program and cleaning it up there before inserting the resultingimage into LibreOffice.Inserting an image from the GalleryThe Gallery provides a convenient way to group reusable objects such as images and sounds thatyou can insert into your documents. The Gallery is available in all components of LibreOffice. Itcomes with many images, but you can still add your own pictures or find extensions containingmore images. The Gallery is explained in more detail in Chapter 11, Graphics, the Gallery, andFontwork, in the Getting Started guide. For more about extensions, see Chapter 16, CustomizingWriter, in this book.This section explains the basics of inserting a Gallery image into a Writer document.1) To open the Gallery, click on the Gallery icon () (located in the Standard toolbar and inthe Drawing toolbar) or choose Tools Gallery from the Menu bar. The Gallery can alsobe accessed through the Gallery tab on the Sidebar (View Sidebar Gallery).2) Navigate through the Gallery to find the desired picture.3) To insert the picture, click and drag it from the Gallery into the Writer document. You canalso right-click on the picture and choose Insert Copy.Figure 4 shows an example of an image dragged from the Gallery.By default, the Gallery is docked above the Writer workspace unless accessed from the Sidebar, inwhich case it is docked on the right hand side in a vertical orientation. To expand the Galleryopened from other than the Sidebar, position the pointer over the line that divides it from the top ofAdding images to a document9

the workspace. When the pointer changes to parallel lines with arrows, click and drag downward.The workspace resizes in response.To expand the Gallery without affecting the workspace, undock it so it floats over the workspace.To do so, hold down the Control key and double-click on the upper part of the Gallery next to theView icons. Double-click in the same area while holding down the Control key to dock it again(restore it to its position over the workspace).When the Gallery is docked, to hide it and view the full Writer workspace, click the Hide/Showbutton in the middle of the thin bar separating the Gallery from the workspace (circled in Figure 4).The vertically oriented Gallery of the Sidebar can be manipulated by similar cursor placements andcontrol selection.To close the Gallery, choose Tools Gallery to toggle the Gallery entry, or click on the Galleryicon again. The Sidebar can be closed by deselecting View Sidebar from the Menu bar.Figure 4: Inserting an image from the GalleryModifying an imageWhen you insert a new image, you may need to modify it to suit the document. The placement ofthe picture relative to the text is discussed in “Positioning images within the text” on page 18. Thissection describes the use of the Picture toolbar, resizing, cropping, and a workaround to rotate apicture.Writer provides many tools for working with images. These tools are sufficient for most people’severyday requirements. However, for professional results it is generally better to use an imagemanipulation program such as GIMP to modify images (for example, to crop, resize, rotate, andchange color values) and then insert the result into Writer. GIMP is an open-source graphicsprogram that can be downloaded from with Images

Using the Picture toolbarWhen you insert an image or select one already present in the document, the Picture toolbarappears. You can set it to always be present (View Toolbars Picture). Picture control buttonsfrom the Picture toolbar can also be added to the Standard Toolbar. See Chapter 16, CustomizingWriter, for more information.This toolbar can be either floating or docked. Figure 5 shows what the Picture toolbar looks likewhen it is floating.123456789FilterGraphics modeColorTransparencyFlip HorizontallyFlip VerticallyRotate 90 LeftRotate 90 RightFrame move NoiseSolarizationAgingPosterizePop ArtCharcoal SketchReliefMosaicFigure 5: Picture toolbar plus tear-off Graphic Filter toolbar and floating Color toolbarTwo other toolbars can be opened from this one: the Graphic Filter toolbar, which can be torn offand placed elsewhere on the window, and the Color toolbar, which opens as a separate floatingtoolbar.From these three toolbars, you can apply small corrections to the image or obtain special effects.Graphics modeYou can change color images to grayscale, to black and white, or to awatermark by selecting the image and then selecting the relevant menuitem from the Graphics mode list.Flip vertically, horizontally or in 90 rotationsTo flip an image vertically horizontally or rotate it by ninety degrees, select the image, and thenclick the relevant button.Modifying an image11

FiltersTable 1 provides a short description of the available filters, however the best way to understandthem is to see them in action. Experiment with the different filters and filter settings, rememberingthat you can undo all the changes by pressing Ctrl Z or Alt Backspace or by selecting Edit Undo.Table 1: Graphic filters and their effectsIconNameEffectInvertInverts the color values of a color image or the brightness values ofa grayscale image.SmoothSoftens the contrast of an image.SharpenIncreases the contrast of an image.Remove noiseRemoves single pixels from an image.SolarizationMimics the effects of too much light in a picture. A further dialogopens to adjust the parameters.AgingSimulates the effects of time on a picture. Can be applied severaltimes. A further dialog opens to adjust the aging level.PosterizeMakes a picture appear like a painting by reducing the number ofcolors used.Pop ArtModifies the picture dramatically.CharcoalDisplays the image as a charcoal sketch.ReliefA dialog is displayed to adjust the light source that will create theshadow and, hence, the relief effect.MosaicJoins groups of pixels into a single area of one color.ColorUse this toolbar to modify the individual RGB color components of the image (red, green, blue) aswell as the brightness, contrast, and gamma of the image. If the result is not satisfactory, you canpress Control Z to restore the default values.TransparencyModify the percentage value in the Transparency box on the Picture toolbar to make the imagemore transparent. This is particularly useful when creating a watermark or when wrapping theimage in the background.12Working with Images

Using the Formatting toolbar and Picture dialogWhen an image is selected, you can customize some aspects of its appearance using the toolsavailable on the OLE-Object toolbar (shown in Figure 11) as well as in the dialog that is shown byright-clicking on the image and selecting Picture. You can, for example, create a border around theimage, selecting style and color; or you can (in the Borders page of the Picture dialog) add ashadow to the image.Cropping imagesWhen you are only interested in a section of the image for the purpose of your document, you maywish to crop (cut off) parts of it.NoteIf you crop an image in Writer, the image itself is not changed. Writer hides, notcuts off, part of the image. If you export the document to HTML, the original imageis exported, not the cropped image.To start cropping the image, right-click on it and select Picture from the context menu. In thePicture dialog, select the Crop page.The units of measurement shown on the Crop page are those set in Tools Options LibreOffice Writer General.Two options are available in the crop section for cropping an image.The first option is the default; Keep scale. You can visualize this as using scissors on a paperpicture. As you cut parts off, the image gets smaller.Figure 6: Result on image size of cropping using Keep scale optionThe second option is Keep image size. You can visualize this as having a picture frame and theimage is zoomed in as much as required to fill the fixed-size frame.You can see in Figure 6 that as the values in Left, Right, Top, and Bottom are altered, theboundaries of the image in the preview box alter to show the crop area on the image. This resultsin either an image size change, or a scale change for a fixed image size (Figure 7).The Width and Height fields under either Scale or Image size change as you enter values in theLeft, Right, Top, and Bottom fields, depending on which option, Keep scale, or Keep image size, isselected.Modifying an image13

The original image size is indicated above the Original Size button. The bitmap image density isshown alongside this dimension.Figure 7: Result using Keep image scale optionResizing an imageTo perfectly fit the image into your document, you may have to resize it. There are a number ofoptions available in Writer to do this.A quick and easy way to resize is by dragging the image’s sizing handles:1) Click the image, if necessary, to show the green sizing handles.2) Position the pointer over one of the green sizing handles. The pointer changes shapegiving a graphical representation of the direction of the resizing.3) Click and drag to resize the image.4) Release the mouse button when satisfied with the new size.The corner handles resize both the width and the height of the image simultaneously, while theother four handles only resize one dimension at a time.TipTo retain the original proportions of the image, Shift click one of the corner handles,then drag.Figure 8 shows three examples of an image inserted into a document and resized.For more accurate resizing of images, use either the Crop page of the Picture dialog (Figure 6) or,the Type page of the Picture dialog.On the Crop page you can adjust the following settings: Scale Width and Height: specify in percentages the scaling of the image. The size of the 14image changes accordingly. For a symmetrical resizing, both values need to be identical.Image size: specify the size of the image in your preferred unit of measurement. Theimage enlarges or shrinks accordingly.Original size button: when clicked, restores the image to its original size. This will be thesize resulting after any cropping was carried out.Working with Images

Figure 8: Th

mailing list: [email protected] Note: Everything you send to a mailing list, including your email address and any other personal information that is written in the message, is publicly archived and cannot be deleted. Acknowledgments This chapter is adapted and updated from Chapter 8 of the 3.3 Writer Guide. The