Fix the XML declarations
[scilab.git] / scilab / modules / graphics / help / en_US / pixel_drawing_mode.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) 2010 - DIGITEO - Pierre Lando <pierre.lando@scilab.org>
5  *
6  * This file must be used under the terms of the CeCILL.
7  * This source file is licensed as described in the file COPYING, which
8  * you should have received as part of this distribution.  The terms
9  * are also available at
10  * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
11  *
12  -->
13 <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="pixel_drawing_mode">
14     <refnamediv>
15         <refname>pixel_drawing_mode</refname>
16         <refpurpose>bitwise pixel rendering functions.</refpurpose>
17     </refnamediv>
18     <refsection>
19         <title>Description</title>
20         <para>
21             Here, the color encoding is RGB.
22             The <literal>pixel_drawing_mode</literal> is a <link
23             linkend="figure_properties">figure property</link> that
24             specifies a bitwise operation applied on any figure pixel
25             between the incoming color and the already existing color
26             on the figure. The result of this operation will be the new pixel color.
27             
28             
29             <literal>src</literal> is the incoming color of the pixel.
30             <literal>prv</literal> is the previous color of the pixel (which is already drawn).
31             <literal>res</literal> is the resulting color of the pixel (which will be drawn).
32             
33             Possible values for <literal>pixel_drawing_mode</literal> are:
34         </para>
35         <informaltable border="1">
36             <tr>
37                 <td>value</td>
38                 <td>bitwise operation</td>
39                 <td>comments</td>
40             </tr>
41             <tr>
42                 <td>0</td>
43                 <td>CLEAR</td>
44                 <td>Result color is black</td>
45             </tr>
46             <tr>
47                 <td>1</td>
48                 <td>AND</td>
49                 <td>res = src AND prv</td>
50             </tr>
51             <tr>
52                 <td>2</td>
53                 <td>AND REVERSE</td>
54                 <td>res = src AND (NOT prv)</td>
55             </tr>
56             <tr>
57                 <td>3</td>
58                 <td>COPY</td>
59                 <td>res = src, default value</td>
60             </tr>
61             <tr>
62                 <td>4</td>
63                 <td>AND INVERTED</td>
64                 <td>res = (NOT src) AND prv</td>
65             </tr>
66             <tr>
67                 <td>5</td>
68                 <td>NOOP</td>
69                 <td>res = prv</td>
70             </tr>
71             <tr>
72                 <td>6</td>
73                 <td>XOR</td>
74                 <td>res = src XOR prv</td>
75             </tr>
76             <tr>
77                 <td>7</td>
78                 <td>OR</td>
79                 <td>res = src OR prv</td>
80             </tr>
81             <tr>
82                 <td>8</td>
83                 <td>NOR</td>
84                 <td>res = NOT (src OR prv)</td>
85             </tr>
86             <tr>
87                 <td>9</td>
88                 <td>EQUIV</td>
89                 <td>res = (NOT src) XOR prv</td>
90             </tr>
91             <tr>
92                 <td>10</td>
93                 <td>INVERT</td>
94                 <td>res = NOT prv</td>
95             </tr>
96             <tr>
97                 <td>11</td>
98                 <td>OR REVERSE</td>
99                 <td>res = src OR (NOT prv)</td>
100             </tr>
101             <tr>
102                 <td>12</td>
103                 <td>COPY INVERTED</td>
104                 <td>res = NOT src</td>
105             </tr>
106             <tr>
107                 <td>13</td>
108                 <td>OR INVERTED</td>
109                 <td>res = (NOT src) OR prv</td>
110             </tr>
111             <tr>
112                 <td>14</td>
113                 <td>NAND</td>
114                 <td>res = NOT (src AND prv)</td>
115             </tr>
116             <tr>
117                 <td>15</td>
118                 <td>SET</td>
119                 <td>Result color is white</td>
120             </tr>
121         </informaltable>
122     </refsection>
123 </refentry>