<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">

<!--
 * This file is part of the LibreOffice project.
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
 *
 * This file incorporates work covered by the following license notice:
 *
 *   Licensed to the Apache Software Foundation (ASF) under one or more
 *   contributor license agreements. See the NOTICE file distributed
 *   with this work for additional information regarding copyright
 *   ownership. The ASF licenses this file to you under the Apache
 *   License, Version 2.0 (the "License"); you may not use this file
 *   except in compliance with the License. You may obtain a copy of
 *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
 -->


<meta>
<topic id="textsharedguideinsert_bitmapxml" indexer="include">
<title id="tit">Inserting, Editing, Saving Bitmaps</title>
<filename>/text/shared/guide/insert_bitmap.xhp</filename>
</topic>
</meta>
<body>
<bookmark branch="index" id="bm_id3154136"><bookmark_value>graphics, see also pictures</bookmark_value>
<bookmark_value>images, see also pictures</bookmark_value>
<bookmark_value>images; inserting and editing bitmaps</bookmark_value>
<bookmark_value>illustrations, see pictures</bookmark_value>
<bookmark_value>bitmaps; inserting and editing</bookmark_value>
<bookmark_value>pixel graphics; inserting and editing</bookmark_value>
<bookmark_value>exporting; bitmaps</bookmark_value>
<bookmark_value>importing; bitmaps</bookmark_value>
<bookmark_value>pictures; editing</bookmark_value>
<bookmark_value>editing; pictures</bookmark_value>
<bookmark_value>invert filter</bookmark_value>
<bookmark_value>smoothing filter</bookmark_value>
<bookmark_value>sharpening filter</bookmark_value>
<bookmark_value>remove noise filter</bookmark_value>
<bookmark_value>solarization filter</bookmark_value>
<bookmark_value>aging filter</bookmark_value>
<bookmark_value>posterizing filter</bookmark_value>
<bookmark_value>pop-art filter</bookmark_value>
<bookmark_value>charcoal sketches filter</bookmark_value>
<bookmark_value>mosaic filter</bookmark_value>
<bookmark_value>pictures;filters</bookmark_value>
<bookmark_value>filters;pictures</bookmark_value>
</bookmark><comment>mw made "illustrations,..." a see-reference</comment>
<h1 id="hd_id3154136"><variable id="insert_bitmap"><link href="text/shared/guide/insert_bitmap.xhp">Inserting, Editing, Saving Bitmaps Images</link>
</variable></h1>
<h2 id="hd_id3149811">Inserting Bitmaps</h2>
<paragraph role="paragraph" id="par_id3153031">A bitmap image can be inserted in $[officename] Writer, $[officename] Calc, $[officename] Draw and $[officename] Impress documents.</paragraph>

<section id="insertgraphicsequence">
<list type="ordered">
<listitem>
<paragraph role="listitem" id="par_id3147209">Choose <emph>Insert - Image</emph>.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3149236">Select the file. In the <emph>File type</emph> box you can restrict the selection to certain file types.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" id="par_id361654339227514"><switchinline select="appl"><caseinline select="WRITER">Select the frame style for the image.</caseinline><caseinline select="CALC">Select the anchor type for the image at the current cell position.</caseinline><defaultinline>Check below.</defaultinline></switchinline></paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3153126">Click the <emph>Link</emph> box if you want a link to the original file.</paragraph>
<paragraph role="listitem" id="par_id3154306">If the <emph>Link</emph> box is marked, whenever the document is updated and loaded the bitmap image is reloaded. The editing steps that you have carried out in the local copy of the image in the document are re-applied and the image is displayed.</paragraph>
<paragraph role="listitem" id="par_id3147336">If the <emph>Link</emph> box is not marked, you are always working with the copy created when the graphic was first inserted.</paragraph>
<paragraph role="listitem" id="par_id3153824">To embed graphics that were first inserted as links, go to <emph>Edit - Links</emph> and click the <emph>Break Link</emph> button.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3151384">Click <emph>Open</emph> to insert the image.</paragraph>
</listitem>
</list>
</section>
<h2 id="hd_id3147303">Editing Bitmaps</h2>
<h3 id="hd_id187078">Icons on the Image bar</h3>
<paragraph role="paragraph" id="par_id3148552">When you select the bitmap image, the <emph>Image</emph> Bar offers you the tools for editing the image. Only a local copy is edited in the document, even if you have inserted an image as a link.</paragraph>
<note id="par_id3159413">The <emph>Image</emph> Bar may look slightly different depending to the module you are using.</note>
<paragraph role="paragraph" id="par_id3154124">A number of filters are located on the <link href="text/shared/02/24010000.xhp"><emph>Image Filter</emph></link> toolbar, which you can open with the icon on the <emph>Image</emph> Bar. </paragraph>
<paragraph role="paragraph" id="par_id7055574">The original image file will not be changed by the filters. Filters are applied to an image only inside the document. </paragraph>
<paragraph role="paragraph" id="par_id3145273">Some of the filters open a dialog, which you can use to select, for example, the intensity of the filter. Most filters can be applied multiple times to increase the filter effect.</paragraph>
<note id="par_id3150105">In $[officename] Draw and $[officename] Impress, you can add text and graphics, select these objects together with the bitmap, and export the selection as a new bitmap image.</note>
<h3 id="hd_id2572405">The Image dialog</h3>
<list type="ordered">
<listitem>
<paragraph role="paragraph" id="par_id6457411">Right-click the image and choose <emph>Image</emph> from the submenu to open a properties dialog.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" id="par_id7991882">Change the properties of the selected image, then click OK.</paragraph>
</listitem>
</list>
<h2 id="hd_id3153574">Saving Bitmaps</h2>
<paragraph role="paragraph" id="par_id3152576">If you want to save in a format such as GIF, JPEG or TIFF, you must select and export the bitmap image.</paragraph>
<paragraph role="paragraph" id="par_id0801200803544667">To export a bitmap in Draw or Impress:</paragraph>
<list type="ordered">
<listitem>
<paragraph role="listitem" id="par_id3155414">Select the bitmap image. You can also select additional objects, such as text, to be exported with the image by pressing the shift key while selecting or by opening a selection frame around all objects.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3148618">Choose <emph>File - Export</emph>. The <emph>Export</emph> dialog opens.</paragraph>
<paragraph role="listitem" id="par_id3157139">The <emph>Export</emph> command writes the image with all applied filter effects to a file. The <emph>Save Image</emph> command in the context menu saves the image without any filter effects, if the image was inserted as a linked image. An embedded image will always be saved or exported with filters applied.<comment>see i70055</comment></paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3083443">In the <emph>File format</emph> field, select the file format you want, for example GIF or JPEG.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3152462">If you only want to export the selected objects, mark the <emph>Selection</emph> box.</paragraph>
<paragraph role="listitem" id="par_id3150874">If <emph>Selection</emph> is not marked, the entire page of the document is exported.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3149417">Enter a name for the file and click <emph>Export</emph>.</paragraph>
</listitem>
</list>
<paragraph role="paragraph" id="par_id0801200803525078"><ahelp hid=".">To export a bitmap in Writer: Right-click the bitmap, choose Save Graphics. You see the Image Export dialog. Enter a file name and select a file type.</ahelp></paragraph>
<section id="relatedtopics">
<embed href="text/shared/guide/dragdrop.xhp#dragdrop"/>
<embed href="text/shared/guide/imagemap.xhp#imagemap"/>
<paragraph role="paragraph" id="par_id1033051"><link href="text/shared/02/24010000.xhp">Image Filter Bar from the Image Bar</link></paragraph>
<switch select="appl">
<case select="WRITER">
<embed href="text/swriter/guide/insert_graphic_dialog.xhp#insert_graphic_dialog"/>
<embed href="text/shared/guide/gallery_insert.xhp#gallery_insert"/>
<embed href="text/swriter/guide/insert_graphic_scan.xhp#insert_graphic_scan"/>
<embed href="text/swriter/guide/insert_graphic_fromdraw.xhp#insert_graphic_fromdraw"/>
<embed href="text/swriter/guide/insert_graphic_fromchart.xhp#insert_graphic_fromchart"/>
</case>
</switch>
</section>
</body>
</helpdocument>
