summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGabor Kelemen <kelemeng@gnome.hu>2017-05-08 03:20:53 +0200
committerGabor Kelemen <kelemeng@ubuntu.com>2017-05-30 16:14:29 +0200
commit1855c986461918b9ccac692e8d80a6d4b8c8ff3e (patch)
treec575617833eed3012dd657c84e99afb12c584f5e
parent35eb7f229b9d244d5c215984f025a2b10a24d31b (diff)
tdf#107077 New help page for the 'Pick a Color' window
Change-Id: I18ccf5444aee8d6dbdbfc98102524ef8f46ffd44 TODO: correct the howtoget section Reviewed-on: https://gerrit.libreoffice.org/37369 Reviewed-by: Olivier Hallot <olivier.hallot@edx.srv.br> Tested-by: Olivier Hallot <olivier.hallot@edx.srv.br> (cherry picked from commit bf3f3bd7b3428fc1c9bc0ec47d1b0962f059e747) Reviewed-on: https://gerrit.libreoffice.org/38222 Reviewed-by: Gabor Kelemen <kelemeng@ubuntu.com> Tested-by: Gabor Kelemen <kelemeng@ubuntu.com>
-rw-r--r--source/text/shared/optionen/01010501.xhp141
1 files changed, 85 insertions, 56 deletions
diff --git a/source/text/shared/optionen/01010501.xhp b/source/text/shared/optionen/01010501.xhp
index 107cb1a682..32e2d49210 100644
--- a/source/text/shared/optionen/01010501.xhp
+++ b/source/text/shared/optionen/01010501.xhp
@@ -22,79 +22,108 @@
<helpdocument version="1.0">
<meta>
<topic id="textsharedoptionen01010501xml" indexer="include" status="PUBLISH">
-<title id="tit" xml-lang="en-US">Color</title>
+<title id="tit" xml-lang="en-US">Selecting a new color</title>
<filename>/text/shared/optionen/01010501.xhp</filename>
</topic>
-<history>
-<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created>
-</history>
</meta>
<body>
-<paragraph role="heading" id="hd_id3153126" xml-lang="en-US" level="1">Color</paragraph>
-<bookmark xml-lang="en-US" branch="index" id="bm_id3150771"><bookmark_value>defining;colors</bookmark_value>
+<paragraph role="heading" id="hd_id3153126" xml-lang="en-US" level="1">Selecting a new color</paragraph>
+<bookmark xml-lang="en-US" branch="index" id="bm_id3150771">
+<bookmark_value>defining;colors</bookmark_value>
<bookmark_value>colors;selection</bookmark_value>
<bookmark_value>colors;adding</bookmark_value>
</bookmark>
-<paragraph role="paragraph" id="par_id3150771" xml-lang="en-US"><variable id="farbentext"><ahelp hid=".">Allows you to define your own colors using the two-dimensional graphic and numerical gradient chart.</ahelp>
-</variable> Click <emph>OK</emph> to display the newly defined color in the preview box of the <emph>Colors</emph> register, where you can then decide if you want to add or replace the new color in the current color palette.<comment>UFI: make this a guide file plus ref link</comment></paragraph>
+
+<bookmark xml-lang="en-US" branch="hid/cui/ui/colorpickerdialog/ColorPicker" id="bm_id3151211" localize="false"/>
+<paragraph role="paragraph" id="par_id3150771" xml-lang="en-US"><variable id="farbentext"><ahelp hid=".">%PRODUCTNAME let you to define custom colors using a two-dimensional graphic and numerical gradient chart of the Pick a Color dialog.</ahelp></variable> Click <emph>OK</emph> to display the newly defined color in the <emph>New</emph> preview box of the <emph>Colors</emph> tab, where you can then decide if you want to add or replace the new color in the current color palette.</paragraph>
<section id="howtoget">
<embed href="text/shared/00/00000406.xhp#color2"/>
</section>
-<paragraph role="heading" id="hd_id3149514" xml-lang="en-US" level="2">Color Window</paragraph>
-<paragraph role="paragraph" id="par_id3153061" xml-lang="en-US">In the two big color windows, you click to select a new color. You can select the color in the left or the right color window as you wish.</paragraph>
-<paragraph role="paragraph" id="par_id3148944" xml-lang="en-US">In the right color window, you will see the entire color spectrum from the left to the right, with the colors at the top being fully saturated and the colors at the bottom being unsaturated.</paragraph>
-<paragraph role="paragraph" id="par_id3149670" xml-lang="en-US">In the left color window, you will see a selection of colors, displaying a progressive spectrum, varying between the four colors in the four corners of this window. You can change the colors in the four corners as follows:</paragraph>
-<list type="ordered">
+<paragraph role="heading" id="hd_id3149514" xml-lang="en-US" level="2">Pick a Color Window</paragraph>
+<paragraph role="paragraph" id="par_id3148944" xml-lang="en-US">The Pick a Color Dialog window consist of four main areas.</paragraph>
+
+<list type="unordered">
+<listitem>
+<paragraph role="paragraph" id="par_id3148945" xml-lang="en-US">The radio buttons select the color component of the color. This color component can be expressed in either RGB (Red, Green, Blue) or HSB (Hue, Saturation, Brightness) color models. The CMYK color model is not selectable are provided only to ease the input of color values using CMYK notation.</paragraph>
+</listitem>
<listitem>
-<paragraph role="listitem" id="par_id3154758" xml-lang="en-US">Click the corner of the field in which you want to change the color.</paragraph>
+<paragraph role="paragraph" id="par_id3148946" xml-lang="en-US">The spin buttons are for entering the numerical value of the color component.</paragraph>
</listitem>
<listitem>
-<paragraph role="listitem" id="par_id3150398" xml-lang="en-US">In the right color window, click the desired new color for the corner field or enter the values, which define the color, in the numeric input fields.</paragraph>
+<bookmark xml-lang="en-US" branch="hid/cui/ui/colorpickerdialog/colorSlider" id="bm_id3153572" localize="false"/>
+<paragraph role="paragraph" id="par_id3148947" xml-lang="en-US"><ahelp hid=".">With the vertical color component slider you can modify the value of each component of the color.</ahelp> With the large colored square you can select the color component approximatively.</paragraph>
</listitem>
<listitem>
-<paragraph role="listitem" id="par_id3151210" xml-lang="en-US">Apply the color selected on the right to the small field that is marked in the left color window by clicking the <emph>&lt;--</emph> button.</paragraph>
+<paragraph role="paragraph" id="par_id3148948" xml-lang="en-US">The horizontal bottom color bar shows the current color and the new color, side by side.</paragraph>
</listitem>
</list>
-<paragraph role="paragraph" id="par_id3151383" xml-lang="en-US">The gradient in the left color window is immediately adjusted with respect to hue, saturation, and brightness.</paragraph>
+
+<bookmark xml-lang="en-US" branch="hid/cui/ui/colorpickerdialog/colorField" id="bm_id3153571" localize="false"/>
+<paragraph role="paragraph" id="par_id3153061" xml-lang="en-US"><ahelp hid=".">Click in the big color area on the left to select a new color. Using this selector area you can modify two components of the color as represented in the RGB or HSB color models. Note that these are the two components not selected with the radio buttons on the right side of the dialog.</ahelp></paragraph>
+
+<bookmark xml-lang="en-US" branch="hid/cui/ui/colorpickerdialog/previous" id="bm_id3155855" localize="false"/>
+<paragraph role="paragraph" id="par_id3154164" xml-lang="en-US"><ahelp hid=".">In the right part of the bottom bar, you will see the original color from the parent tab, <emph>Colors</emph>.</ahelp></paragraph>
+
+<bookmark xml-lang="en-US" branch="hid/cui/ui/colorpickerdialog/preview" id="bm_id3155856" localize="false"/>
+<paragraph role="paragraph" id="par_id3154165" xml-lang="en-US"><ahelp hid=".">In the left part of the bottom bar, the current result of your work in this dialog is visible.</ahelp></paragraph>
+
<paragraph role="note" id="par_id9701528" xml-lang="en-US">%PRODUCTNAME uses only the RGB color model for printing in color. The CMYK controls are provided only to ease the input of color values using CMYK notation.</paragraph>
-<bookmark xml-lang="en-US" branch="hid/svtools:PushButton:DLG_COLOR:BTN_1" id="bm_id3154126" localize="false"/>
-<paragraph role="heading" id="hd_id3153192" xml-lang="en-US" level="2">&lt;--</paragraph>
-<paragraph role="paragraph" id="par_id3154909" xml-lang="en-US"><ahelp hid="SVTOOLS:PUSHBUTTON:DLG_COLOR:BTN_1">Click the <emph>&lt;--</emph> button to replace the selected color in the color palette with the color selected at the right. The button is enabled when you select a color in one of the four corners.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/svtools:PushButton:DLG_COLOR:BTN_2" id="bm_id3145608" localize="false"/>
-<paragraph role="heading" id="hd_id3158409" xml-lang="en-US" level="2">--&gt;</paragraph>
-<paragraph role="paragraph" id="par_id3151043" xml-lang="en-US"><ahelp hid="SVTOOLS:PUSHBUTTON:DLG_COLOR:BTN_2">Sets the small selection cursor in the right window on the color, which corresponds to the selected color in the left window and updates the respective values in the numerical fields.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/svtools:MetricField:DLG_COLOR:NUM_CYAN" id="bm_id3153367" localize="false"/>
-<paragraph role="heading" id="hd_id3149203" xml-lang="en-US" level="2">Cyan</paragraph>
-<paragraph role="paragraph" id="par_id3159252" xml-lang="en-US"><ahelp hid="SVTOOLS_METRICFIELD_DLG_COLOR_NUM_CYAN">Sets the Cyan color value in the CMYK color model.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/svtools:MetricField:DLG_COLOR:NUM_MAGENTA" id="bm_id3150486" localize="false"/>
-<paragraph role="heading" id="hd_id3155429" xml-lang="en-US" level="2">Magenta</paragraph>
-<paragraph role="paragraph" id="par_id3152596" xml-lang="en-US"><ahelp hid="SVTOOLS_METRICFIELD_DLG_COLOR_NUM_MAGENTA">Sets the Magenta color value in the CMYK color model.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/svtools:MetricField:DLG_COLOR:NUM_YELLOW" id="bm_id3152576" localize="false"/>
-<paragraph role="heading" id="hd_id3154147" xml-lang="en-US" level="2">Yellow</paragraph>
-<paragraph role="paragraph" id="par_id3155306" xml-lang="en-US"><ahelp hid="SVTOOLS_METRICFIELD_DLG_COLOR_NUM_YELLOW">Sets the Yellow color value in the CMYK color model.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/cui:MetricField:RID_SVXPAGE_COLOR:MTR_FLD_4" id="bm_id3155854" localize="false"/>
-<bookmark xml-lang="en-US" branch="hid/svtools:MetricField:DLG_COLOR:NUM_KEY" id="bm_id3154012" localize="false"/>
-<paragraph role="heading" id="hd_id3150105" xml-lang="en-US" level="2">Key</paragraph>
-<paragraph role="paragraph" id="par_id3146148" xml-lang="en-US"><ahelp hid="SVTOOLS_METRICFIELD_DLG_COLOR_NUM_KEY">Sets the Black color value or key (black) in the CMYK color model.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/svtools:NumericField:DLG_COLOR:NUM_RED" id="bm_id3153573" localize="false"/>
-<paragraph role="heading" id="hd_id3151114" xml-lang="en-US" level="2">Red</paragraph>
-<paragraph role="paragraph" id="par_id3153726" xml-lang="en-US"><ahelp hid="SVTOOLS:NUMERICFIELD:DLG_COLOR:NUM_RED">Sets the Red color value in the RGB color model.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/svtools:NumericField:DLG_COLOR:NUM_GREEN" id="bm_id3149481" localize="false"/>
-<paragraph role="heading" id="hd_id3148618" xml-lang="en-US" level="2">Green</paragraph>
-<paragraph role="paragraph" id="par_id3149298" xml-lang="en-US"><ahelp hid="SVTOOLS:NUMERICFIELD:DLG_COLOR:NUM_GREEN">Sets the Green color value in the RGB color model.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/svtools:NumericField:DLG_COLOR:NUM_BLUE" id="bm_id3145799" localize="false"/>
-<paragraph role="heading" id="hd_id3151075" xml-lang="en-US" level="2">Blue</paragraph>
-<paragraph role="paragraph" id="par_id3148455" xml-lang="en-US"><ahelp hid="SVTOOLS:NUMERICFIELD:DLG_COLOR:NUM_BLUE">Sets the Blue color value in the RGB color model.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/svtools:NumericField:DLG_COLOR:NUM_HUE" id="bm_id3149581" localize="false"/>
-<paragraph role="heading" id="hd_id3145647" xml-lang="en-US" level="2">Color</paragraph>
-<paragraph role="paragraph" id="par_id3154729" xml-lang="en-US"><ahelp hid="SVTOOLS:NUMERICFIELD:DLG_COLOR:NUM_HUE">Sets the Hue in the HSB color model.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/svtools:NumericField:DLG_COLOR:NUM_SATURATION" id="bm_id3153415" localize="false"/>
-<paragraph role="heading" id="hd_id3144766" xml-lang="en-US" level="2">Saturation</paragraph>
-<paragraph role="paragraph" id="par_id3153512" xml-lang="en-US"><ahelp hid="SVTOOLS:NUMERICFIELD:DLG_COLOR:NUM_SATURATION">Sets the Saturation in the HSB color model.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/svtools:NumericField:DLG_COLOR:NUM_LUMINANCE" id="bm_id3146990" localize="false"/>
-<paragraph role="heading" id="hd_id3156180" xml-lang="en-US" level="2">Luminance</paragraph>
-<paragraph role="paragraph" id="par_id3146969" xml-lang="en-US"><ahelp hid="SVTOOLS:NUMERICFIELD:DLG_COLOR:NUM_LUMINANCE">Sets the Brightness in the HSB color model.</ahelp></paragraph>
-<embed href="text/shared/00/00000001.xhp#vorschau"/>
-<paragraph role="paragraph" id="par_id3154164" xml-lang="en-US">In the left preview field, you will see the original color from the parent tab, <emph>Colors</emph>. In the right preview field, you will always see the current result of your work in this dialog.</paragraph>
+
+<paragraph role="heading" id="hd_id315200" xml-lang="en-US" level="2">RGB</paragraph>
+
+<paragraph role="heading" id="hd_id3151114" xml-lang="en-US" level="3">Red</paragraph>
+<bookmark xml-lang="en-US" branch="hid/cui/ui/colorpickerdialog/redRadiobutton" id="bm_id3153574" localize="false"/>
+<paragraph role="paragraph" id="par_id3153727" xml-lang="en-US"><ahelp hid=".">Sets the Red component modifiable on the vertical color slider, and the Green and Blue components in the two dimensional color picker field. Allowed values are 0 to 255.</ahelp></paragraph>
+<paragraph role="paragraph" id="par_id3153726" xml-lang="en-US"><ahelp hid="cui/ui/colorpickerdialog/redSpinbutton" visibility="hidden">Set the Red color value directly. Allowed values are 0 to 255.</ahelp></paragraph>
+
+<paragraph role="heading" id="hd_id3148618" xml-lang="en-US" level="3">Green</paragraph>
+<bookmark xml-lang="en-US" branch="hid/cui/ui/colorpickerdialog/greenRadiobutton" id="bm_id3153575" localize="false"/>
+<paragraph role="paragraph" id="par_id3153728" xml-lang="en-US"><ahelp hid=".">Sets the Green component modifiable on the vertical color slider, and the Green and Blue components in the two dimensional color picker field. Allowed values are 0 to 255.</ahelp></paragraph>
+<paragraph role="paragraph" id="par_id3149298" xml-lang="en-US"><ahelp hid="cui/ui/colorpickerdialog/greenSpinbutton" visibility="hidden">Set the Green color value directly. Allowed values are 0 to 255.</ahelp></paragraph>
+
+<paragraph role="heading" id="hd_id3151075" xml-lang="en-US" level="3">Blue</paragraph>
+<bookmark xml-lang="en-US" branch="hid/cui/ui/colorpickerdialog/blueRadiobutton" id="bm_id3153576" localize="false"/>
+<paragraph role="paragraph" id="par_id3153729" xml-lang="en-US"><ahelp hid=".">Sets the Red component modifiable on the vertical color slider, and the Green and Blue components in the two dimensional color picker field. Allowed values are 0 to 255.</ahelp></paragraph>
+<paragraph role="paragraph" id="par_id3148455" xml-lang="en-US"><ahelp hid="cui/ui/colorpickerdialog/blueSpinbutton" visibility="hidden">Set the Blue color value directly. Allowed values are 0 to 255.</ahelp></paragraph>
+
+<bookmark xml-lang="en-US" branch="hid/cui/ui/colorpickerdialog/hexEntry" id="bm_id3145800" localize="false"/>
+<paragraph role="heading" id="hd_id3151076" xml-lang="en-US" level="2">Hex #</paragraph>
+<paragraph role="paragraph" id="par_id3148456" xml-lang="en-US"><ahelp hid=".">Displays and sets the color value in the RGB color model expressed as a hexadecimal number.</ahelp></paragraph>
+
+<paragraph role="heading" id="hd_id315201" xml-lang="en-US" level="2">HSB</paragraph>
+
+<paragraph role="heading" id="hd_id3145647" xml-lang="en-US" level="3">Hue</paragraph>
+<bookmark xml-lang="en-US" branch="hid/cui/ui/colorpickerdialog/hueRadiobutton" id="bm_id3153577" localize="false"/>
+<paragraph role="paragraph" id="par_id3153730" xml-lang="en-US"><ahelp hid=".">Sets the Hue component modifiable on the vertical color slider, and the Saturation and Brightness components in the two dimensional color picker field. Values are expressed in degrees from 0 to 359.</ahelp></paragraph>
+<paragraph role="paragraph" id="par_id3154729" xml-lang="en-US"><ahelp hid="cui/ui/colorpickerdialog/hueSpinbutton" visibility="hidden">Set the Hue directly in the HSB color model. Values are expressed in degrees from 0 to 359.</ahelp></paragraph>
+
+<paragraph role="heading" id="hd_id3144766" xml-lang="en-US" level="3">Saturation</paragraph>
+<bookmark xml-lang="en-US" branch="hid/cui/ui/colorpickerdialog/satRadiobutton" id="bm_id3153578" localize="false"/>
+<paragraph role="paragraph" id="par_id3153731" xml-lang="en-US"><ahelp hid=".">Sets the Saturation component modifiable on the vertical color slider, and the Hue and Brightness components in the two dimensional color picker field. Values are expressed in percent ( 0 to 100).</ahelp></paragraph>
+<paragraph role="paragraph" id="par_id3153512" xml-lang="en-US"><ahelp hid="cui/ui/colorpickerdialog/satSpinbutton" visibility="hidden">Set the Saturation directly in the HSB color model. Values are expressed in percent ( 0 to 100).</ahelp></paragraph>
+
+<paragraph role="heading" id="hd_id3156180" xml-lang="en-US" level="3">Brightness</paragraph>
+<bookmark xml-lang="en-US" branch="hid/cui/ui/colorpickerdialog/brightRadiobutton" id="bm_id3153579" localize="false"/>
+<paragraph role="paragraph" id="par_id3153732" xml-lang="en-US"><ahelp hid=".">Sets the Brightness component modifiable on the vertical color slider, and the Hue and Saturation components in the two dimensional color picker field. Values are expressed in percent ( 0 to 100).</ahelp></paragraph>
+<paragraph role="paragraph" id="par_id3146969" xml-lang="en-US"><ahelp hid="cui/ui/colorpickerdialog/brightSpinbutton" visibility="hidden">Set the Brightness directly in the HSB color model. Values are expressed in percent ( 0 to 100).</ahelp></paragraph>
+
+<paragraph role="heading" id="hd_id315202" xml-lang="en-US" level="2">CMYK</paragraph>
+
+<bookmark xml-lang="en-US" branch="hid/cui/ui/colorpickerdialog/cyanSpinbutton" id="bm_id3153367" localize="false"/>
+<paragraph role="heading" id="hd_id3149203" xml-lang="en-US" level="3">Cyan</paragraph>
+<paragraph role="paragraph" id="par_id3159252" xml-lang="en-US"><ahelp hid=".">Set the Cyan color value as expressed in the CMYK color model.</ahelp></paragraph>
+
+<bookmark xml-lang="en-US" branch="hid/cui/ui/colorpickerdialog/magSpinbutton" id="bm_id3150486" localize="false"/>
+<paragraph role="heading" id="hd_id3155429" xml-lang="en-US" level="3">Magenta</paragraph>
+<paragraph role="paragraph" id="par_id3152596" xml-lang="en-US"><ahelp hid=".">Set the Magenta color value as expressed in the CMYK color model.</ahelp></paragraph>
+
+<bookmark xml-lang="en-US" branch="hid/cui/ui/colorpickerdialog/yellowSpinbutton" id="bm_id3152576" localize="false"/>
+<paragraph role="heading" id="hd_id3154147" xml-lang="en-US" level="3">Yellow</paragraph>
+<paragraph role="paragraph" id="par_id3155306" xml-lang="en-US"><ahelp hid=".">Set the Yellow color value as expressed in the CMYK color model.</ahelp></paragraph>
+
+<bookmark xml-lang="en-US" branch="hid/cui/ui/colorpickerdialog/keySpinbutton" id="bm_id3155854" localize="false"/>
+<paragraph role="heading" id="hd_id3150105" xml-lang="en-US" level="3">Key</paragraph>
+<paragraph role="paragraph" id="par_id3146148" xml-lang="en-US"><ahelp hid=".">Set the Black color value or key (black) as expressed in the CMYK color model.</ahelp></paragraph>
+
</body>
</helpdocument>