tdf#128150 (related) Illustrate "use background"

+ Add illustration for "Use Background" for area fill in Impress
+ Refactor

Change-Id: Ia70861904d9e4c3b1d126aa50b468cd226995792
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/157431
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
diff --git a/Package_html_media.mk b/Package_html_media.mk
index 5a45802..7057587 100644
--- a/Package_html_media.mk
+++ b/Package_html_media.mk
@@ -171,6 +171,7 @@ $(eval $(call gb_Package_add_files_with_dir,helpcontent2_html_media,$(LIBO_SHARE
    helpimg/sbasic/Write_statement.svg \
    helpimg/scalc/coordinates-to-polar-01.svg \
    helpimg/scalc/calczoomslider.png \
    helpimg/sdraw/area-fill-none-same-vs-background.png \
    helpimg/sdraw/control_points.png \
    helpimg/sdraw/distribute-orig.svg \
    helpimg/sdraw/distribute-HR.svg \
diff --git a/source/media/helpimg/sdraw/area-fill-none-same-vs-background.png b/source/media/helpimg/sdraw/area-fill-none-same-vs-background.png
new file mode 100644
index 0000000..0fa8a80
--- /dev/null
+++ b/source/media/helpimg/sdraw/area-fill-none-same-vs-background.png
Binary files differ
diff --git a/source/text/shared/01/05210100.xhp b/source/text/shared/01/05210100.xhp
index 8215d8e..73647d6 100644
--- a/source/text/shared/01/05210100.xhp
+++ b/source/text/shared/01/05210100.xhp
@@ -19,13 +19,13 @@
<helpdocument version="1.0">
<meta>
<topic id="textshared0105210100xml" indexer="include" status="PUBLISH">
<title id="tit" xml-lang="en-US">Area tab</title>
<title id="tit">Area tab</title>
<filename>/text/shared/01/05210100.xhp</filename>
</topic>
</meta>
<body>

<bookmark xml-lang="en-US" branch="index" id="bm_id3149999">
<bookmark branch="index" id="bm_id3149999">
<bookmark_value>areas; styles</bookmark_value>
<bookmark_value>fill patterns for areas</bookmark_value>
<bookmark_value>fill colors for areas</bookmark_value>
@@ -37,40 +37,40 @@
<bookmark_value>footers;backgrounds</bookmark_value>
<bookmark_value>headers;backgrounds</bookmark_value>
</bookmark>
<bookmark xml-lang="en-US" branch="hid/cui/ui/areatabpage/AreaTabPage" id="bm_id3146959" localize="false"/>
<bookmark xml-lang="en-US" branch="hid/cui/ui/areatabpage/@@nowidget@@" id="bm_id3146959" localize="false"/>
<bookmark xml-lang="en-US" branch="hid/cui/ui/areatabpage/tablelb" id="bm_id3144245" localize="false"/>
<bookmark branch="hid/cui/ui/areatabpage/AreaTabPage" id="bm_id3146959" localize="false"/>
<bookmark branch="hid/cui/ui/areatabpage/@@nowidget@@" id="bm_id3146959" localize="false"/>
<bookmark branch="hid/cui/ui/areatabpage/tablelb" id="bm_id3144245" localize="false"/>
<section id="area">
<h1 id="hd_id3145759"><link href="text/shared/01/05210100.xhp">Area (Background, Highlighting)</link></h1>
<paragraph role="paragraph" id="par_id3149748" xml-lang="en-US"><ahelp hid="cui/ui/areatabpage/AreaTabPage">Set the fill options for the selected drawing object or document element.</ahelp></paragraph>
<paragraph role="paragraph" id="par_id3149748"><ahelp hid="cui/ui/areatabpage/AreaTabPage">Set the fill options for the selected drawing object or document element.</ahelp></paragraph>
<comment>This is not only for drawing objects, but pages, paragraphs and others too. Need better wording</comment>
</section>
<paragraph role="paragraph" id="par_id3154863" xml-lang="en-US">You can add custom colors, gradients, hatchings, two color patterns and image patterns to the default lists for later use.</paragraph>
<paragraph role="paragraph" id="par_id3154863">You can add custom colors, gradients, hatchings, two color patterns and image patterns to the default lists for later use.</paragraph>
<section id="howtoget">
  <embed href="text/shared/00/00040502.xhp#area2"/>
</section>
<bookmark xml-lang="en-US" branch="hid/cui/ui/areatabpage/btnnone" id="bm_id3149245" localize="false"/>
<bookmark branch="hid/cui/ui/areatabpage/btnnone" id="bm_id3149245" localize="false"/>
<h2 id="hd_id3147373">None</h2>
<paragraph role="paragraph" id="par_id3149751" xml-lang="en-US"><ahelp hid="cui/ui/areatabpage/btnnone">Do not fill the selected object.</ahelp></paragraph>
<paragraph role="paragraph" id="par_id3149751"><ahelp hid="cui/ui/areatabpage/btnnone">Do not fill the selected object.</ahelp></paragraph>

<bookmark xml-lang="en-US" branch="hid/cui/ui/areatabpage/btncolor" id="bm_id3149244" localize="false"/>
<bookmark branch="hid/cui/ui/areatabpage/btncolor" id="bm_id3149244" localize="false"/>
<embed href="text/shared/01/05210200.xhp#colorpagehead"/>

<bookmark xml-lang="en-US" branch="hid/cui/ui/areatabpage/btngradient" id="bm_id3145085" localize="false"/>
<bookmark branch="hid/cui/ui/areatabpage/btngradient" id="bm_id3145085" localize="false"/>
<switch select="appl">
<case select="CALC"></case>
<case select="CALC"/>
<default>
<h2 id="hd_id3144438"><link href="text/shared/01/05210300.xhp">Gradient</link></h2>
<paragraph role="paragraph" id="par_id3153716" xml-lang="en-US"><ahelp hid="cui/ui/areatabpage/btngradient">Fills the object with a gradient selected on this page.</ahelp></paragraph>
<paragraph role="paragraph" id="par_id3153716"><ahelp hid="cui/ui/areatabpage/btngradient">Fills the object with a gradient selected on this page.</ahelp></paragraph>

<bookmark xml-lang="en-US" branch="hid/cui/ui/areatabpage/btnbitmap" id="bm_id3161458" localize="false"/>
<bookmark branch="hid/cui/ui/areatabpage/btnbitmap" id="bm_id3161458" localize="false"/>
<embed href="text/shared/01/05210500.xhp#image"/>

<bookmark xml-lang="en-US" branch="hid/cui/ui/areatabpage/btnpattern" id="bm_id3161457" localize="false"/>
<bookmark branch="hid/cui/ui/areatabpage/btnpattern" id="bm_id3161457" localize="false"/>
<embed href="text/shared/01/05210800.xhp#patternh1"/>
<bookmark xml-lang="en-US" branch="hid/cui/ui/areatabpage/btnhatch" id="bm_id3144510" localize="false"/>
<bookmark branch="hid/cui/ui/areatabpage/btnhatch" id="bm_id3144510" localize="false"/>
<h2 id="hd_id3154047"><link href="text/shared/01/05210400.xhp">Hatch</link></h2>
<paragraph role="paragraph" id="par_id3153698" xml-lang="en-US"><ahelp hid="cui/ui/areatabpage/btnhatch">Fills the object with a hatching pattern selected on this page.</ahelp></paragraph>
<paragraph role="paragraph" id="par_id3153698"><ahelp hid="cui/ui/areatabpage/btnhatch">Fills the object with a hatching pattern selected on this page.</ahelp></paragraph>

<tip id="par_id3148548">You can quickly select fill options from the list boxes on the <emph>Drawing Object Properties</emph> toolbar.</tip>
<embed href="text/shared/00/00000004.xhp#syarea_style"/>
@@ -86,11 +86,25 @@
    <paragraph role="paragraph" id="par_id191693919151752">
      Use the slide background as a fill. This differs from "None" in that the area is actually filled with the slide background at that location, instead of simply showing what is behind the shape.
    </paragraph>
    <paragraph role="paragraph" id="par_id661696079947729">
      <image src="media/helpimg/sdraw/area-fill-none-same-vs-background.png" id="img_id871696079947730" width="700px" height="392px"><alt id="alt_id991696079947732">Illustration of different fill styles.</alt></image>
    </paragraph>
    <list type="ordered">
      <listitem>
        <paragraph id="par_id221696080666194"  role="listitem"><emph>Use Background</emph>: the object area is filled with the background fill. The object covers the blue circle.</paragraph>
      </listitem>
      <listitem>
        <paragraph id="par_id331696080747331"  role="listitem"><emph>Fill</emph>: The object uses the same gradient fill of the background. The object covers the blue circle.</paragraph>
      </listitem>
      <listitem>
        <paragraph id="par_id991696080772879"  role="listitem"><emph>None</emph>: the object does not have a fill. The blue circle is visible though the object.</paragraph>
      </listitem>
    </list>
  </case>
</switch>

<bookmark xml-lang="en-US" branch="hid/.uno:FillStyle" id="bm_id3154186" localize="false"/>
<paragraph role="paragraph" id="par_id3154673" xml-lang="en-US"><variable id="sytext"><ahelp hid=".uno:FillStyle">Select the type of fill that you want to apply to the selected drawing object.</ahelp>
<bookmark branch="hid/.uno:FillStyle" id="bm_id3154186" localize="false"/>
<paragraph role="paragraph" id="par_id3154673"><variable id="sytext"><ahelp hid=".uno:FillStyle">Select the type of fill that you want to apply to the selected drawing object.</ahelp>
</variable></paragraph>
<embed href="text/shared/00/00000001.xhp#reset"/>
<comment>Chart does not have an Apply button</comment>