<?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="textsharedguideimagemapxhp" indexer="include" status="PUBLISH">
         <title xml-lang="en-US" id="tit">Adding Clickable Hotspots to Images</title>
         <filename>/text/shared/guide/imagemap.xhp</filename>
      </topic>
   </meta>
   <body>
<bookmark xml-lang="en-US" branch="index" id="bm_id3150502"><bookmark_value>ImageMap; editor</bookmark_value>
      <bookmark_value>editors; ImageMap editor</bookmark_value>
      <bookmark_value>images; ImageMap</bookmark_value>
      <bookmark_value>pictures; ImageMap</bookmark_value>
      <bookmark_value>hotspots;adding to images</bookmark_value>
      <bookmark_value>URL;in pictures</bookmark_value>
</bookmark><comment>mw added 2 index entries</comment><comment>MW made "hotspots" a two level entry</comment>
<paragraph xml-lang="en-US" id="par_idN10631" role="heading" level="1"><variable id="imagemap"><link href="text/shared/guide/imagemap.xhp">Adding Clickable Hotspots to Images</link>
</variable></paragraph>
  <paragraph xml-lang="en-US" id="par_idN1064F" role="paragraph">An ImageMap allows you to attach URLs to specific areas, called hotspots, on a picture in your document. An image map is a group of one or more hotspots.</paragraph>
  <paragraph xml-lang="en-US" id="par_idN1066C" role="paragraph">You can draw three types of hotspots: rectangles, ellipses, and polygons. When you click a hotspot, the URL is opened in the browser window or frame that you specify. You can also specify the text that appears when your mouse rests on the hotspot.</paragraph>
  <h2 id="par_idN10677">To add a clickable hotspot to an image</h2>
  <list type="ordered">
   <listitem>
    <paragraph xml-lang="en-US" id="par_idN1067E" role="paragraph">Position the cursor where you want the ImageMap in your document.</paragraph>
   </listitem>
   <listitem>
    <paragraph xml-lang="en-US" id="par_idN10682" role="paragraph">Choose <emph>Insert - Image</emph>, select and insert a bitmap image.</paragraph>
   </listitem>
   <listitem>
    <paragraph xml-lang="en-US" id="par_idN1068A" role="paragraph">With the image selected, choose <menuitem>Tools - ImageMap</menuitem> to open the <link href="text/shared/01/02220000.xhp">ImageMap Editor</link>, which displays the selected image and contains the hotspot editing tools.</paragraph>
   </listitem>
   <listitem>
    <paragraph xml-lang="en-US" id="par_idN106A0" role="paragraph">Use the icons in the ImageMap Editor to draw a hotspot shape, for example a rectangle, over the image at the background.</paragraph>
    <paragraph xml-lang="en-US" id="par_idN106A3" role="paragraph">You can see an extended help text on the functions of each icon when you enable Extended Help in <switchinline select="sys"><caseinline select="MAC"><emph>%PRODUCTNAME - Preferences</emph></caseinline><defaultinline><emph>Tools - Options</emph></defaultinline></switchinline><emph> - %PRODUCTNAME - General</emph>.</paragraph>
   </listitem>
   <listitem>
    <paragraph xml-lang="en-US" id="par_idN106AB" role="paragraph">Enter the "Address" URL that will be shown in a Web browser when the user clicks the hotspot.</paragraph>
   </listitem>
   <listitem>
    <paragraph xml-lang="en-US" id="par_idN106AF" role="paragraph">Optionally, enter the "Text" that will be shown as a tip when the user points the mouse to the hotspot.</paragraph>
   </listitem>
   <listitem>
    <paragraph xml-lang="en-US" id="par_idN106B3" role="paragraph">Click the Apply button to apply your changes, and close the ImageMap Editor.</paragraph>
   </listitem>
   <listitem>
    <paragraph xml-lang="en-US" id="par_idN106B7" role="paragraph">Save the document in the %PRODUCTNAME or HTML format.</paragraph>
   </listitem>
  </list>
  <paragraph xml-lang="en-US" id="par_idN106BA" role="paragraph">You may save the ImageMap as a file and upload that file to a Web server, for example.</paragraph>
  <embed href="text/shared/00/00000002.xhp#imagemap"/>
  <embed href="text/shared/00/00000002.xhp#ss_imagemaps"/>
  <embed href="text/shared/00/00000002.xhp#cs_imagemaps"/>
 </body>
</helpdocument>
