1 <?xml version="1.0" encoding="UTF-8"?>
2 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="en" xml:id="uigetcolor">
4 <refname>uigetcolor</refname>
5 <refpurpose>Opens a dialog for selecting a color.</refpurpose>
11 RGB = uigetcolor([title])
12 RGB = uigetcolor([title,] defaultRGB)
13 RGB = uigetcolor([title,] defaultRed, defaultGreen, defaultBlue)
14 [R, G, B] = uigetcolor([title])
15 [R, G, B] = uigetcolor([title,] defaultRGB)
16 [R, G, B] = uigetcolor([title,] defaultRed, defaultGreen, defaultBlue)
20 <title>Arguments</title>
25 <para>String: Optional argument, the title to display in the dialog. Default value is "Color Chooser".</para>
29 <term>defaultRGB</term>
31 <para>1x3 vector: the default values for Red, Green and Blue values given as a vector [red, green, blue].</para>
35 <term>defaultRed</term>
37 <para>Scalar: the default value for red.</para>
41 <term>defaultGreen</term>
43 <para>Scalar: the default value for green.</para>
47 <term>defaultBlue</term>
49 <para>Scalar: the default value for blue.</para>
55 <para>1x3 vector: the values for Red, Green and Blue values given as a vector [red, green, blue] or [] if the user cancels.</para>
61 <para>Scalar: the value for red or [] if the user cancels.</para>
67 <para>Scalar: the value for green or [] if the user cancels.</para>
73 <para>Scalar: the value for blue or [] if the user cancels.</para>
79 <title>Description</title>
80 <para>Creates a dialog window for selecting a color. All (default and returned) values must be in the interval [0 255].</para>
83 <title>Examples</title>
84 <programlisting role="example"><![CDATA[
86 [R, G, B] = uigetcolor([255 128 0])
87 RBG = uigetcolor(0, 128, 255)
88 RBG = uigetcolor("My color chooser", 0, 128, 255)
91 <refsection role="see also">
92 <title>See also</title>
93 <simplelist type="inline">
95 <link linkend="getcolor">getcolor</link>