|
5 | 5 | \pnum
|
6 | 6 | Brushes serve as sources of visual data for composing operations.
|
7 | 7 |
|
| 8 | +There are four types of brushes: |
| 9 | +\begin{itemize} |
| 10 | + \item color; |
| 11 | + \item linear gradient; |
| 12 | + \item radial gradient; and, |
| 13 | + \item surface. |
| 14 | +\end{itemize} |
| 15 | + |
8 | 16 | \pnum
|
9 |
| -A brush has its own coordinate space (by default the standard coordinate space). |
| 17 | +A brush has its own coordinate space (by default the standard coordinate space). It is controlled by a \tcode{matrix_2d} value. |
10 | 18 |
|
11 | 19 | \pnum
|
12 | 20 | It possesses a \tcode{filter} value and a \tcode{tiling} value, which combine to determine the visual data value returned when a composing operation samples a brush.
|
|
17 | 25 | \pnum
|
18 | 26 | The \tcode{tiling} value controls what happens when a composing operation needs to sample from a point that is outside of the bounds of the brush.
|
19 | 27 |
|
| 28 | +%\pnum |
| 29 | +%Excluding brushes created using a \tcode{solid_color_brush_factory} object, brushes produce very different composing operation results depending on the values of their mutable state. |
| 30 | +% |
| 31 | + |
20 | 32 | \pnum
|
21 |
| -A brush is created using one of four factory classes: |
22 |
| -\begin{itemize} |
23 |
| -\item \tcode{solid_color_brush_factory}, |
24 |
| -\item \tcode{linear_brush_factory}, |
25 |
| -\item \tcode{radial_brush_factory}, and |
26 |
| -\item \tcode{surface_brush_factory}. |
27 |
| -\end{itemize} |
| 33 | +Color brushes produce the same sampling result regardless of their coordinate space, \tcode{filter}, and \tcode{tiling}. They are unbounded and as such always produce the \tcode{rgba_color} value they were created with when sampled from, regardless of the requested point. |
28 | 34 |
|
29 | 35 | \pnum
|
30 |
| -Excluding brushes created using a \tcode{solid_color_brush_factory} object, brushes produce very different composing operation results depending on the values of their mutable state. |
| 36 | +Linear gradient and radial gradient brushes share similarities with each other that are not shared by the other types of brushes. This is discussed in more detail below (\ref{gradients}). |
31 | 37 |
|
32 | 38 | \pnum
|
33 |
| -Brushes created using either a \tcode{linear_brush_factory} object or a \tcode{radial_brush_factory} object are considered to be gradient brushes. They share similarities with each other that are not shared by brushes created using the other brush factories. This is discussed in more detail below (\ref{gradients}). |
| 39 | +Surface brushes take an \tcode{image_surface} object and use it as the source of the brush's visual data. |
34 | 40 |
|
35 | 41 | \addtocounter{SectionDepthBase}{1}
|
36 | 42 | \input{gradients}
|
|
39 | 45 | \input{brush-type}
|
40 | 46 | \input{color-stop}
|
41 | 47 | \input{brush}
|
42 |
| -\input{solid-color-brush-factory} |
43 |
| -\input{linear-brush-factory} |
44 |
| -\input{radial-brush-factory} |
45 |
| -%%\input{mesh-brush-factory} |
46 |
| -\input{surface-brush-factory} |
| 48 | +%\input{solid-color-brush-factory} |
| 49 | +%\input{linear-brush-factory} |
| 50 | +%\input{radial-brush-factory} |
| 51 | +%%%\input{mesh-brush-factory} |
| 52 | +%\input{surface-brush-factory} |
47 | 53 | \addtocounter{SectionDepthBase}{-1}
|
0 commit comments