@@ -14,27 +14,34 @@ public enum AlphaOption
14
14
Undefined ,
15
15
16
16
/// <summary>
17
- /// Activate.
17
+ /// Enable the image's transparency channel. Note that normally Set should be used instead of
18
+ /// this, unless you specifically need to preserve the existing (but specifically turned Off)
19
+ /// transparency channel.
18
20
/// </summary>
19
21
Activate ,
20
22
21
23
/// <summary>
22
- /// Associate.
24
+ /// Associate the alpha channel with the image .
23
25
/// </summary>
24
26
Associate ,
25
27
26
28
/// <summary>
27
- /// Background.
29
+ /// Set any fully-transparent pixel to the background color, while leaving it fully-transparent.
30
+ /// This can make some image file formats, such as PNG, smaller as the RGB values of transparent
31
+ /// pixels are more uniform, and thus can compress better.
28
32
/// </summary>
29
33
Background ,
30
34
31
35
/// <summary>
32
- /// Copy.
36
+ /// Turns 'On' the alpha/matte channel, then copies the grayscale intensity of the image, into
37
+ /// the alpha channel, converting a grayscale mask into a transparent shaped mask ready to be
38
+ /// colored appropriately. The color channels are not modified.
33
39
/// </summary>
34
40
Copy ,
35
41
36
42
/// <summary>
37
- /// Deactivate.
43
+ /// Disables the image's transparency channel. This does not delete or change the existing data,
44
+ /// it just turns off the use of that data.
38
45
/// </summary>
39
46
Deactivate ,
40
47
@@ -44,12 +51,14 @@ public enum AlphaOption
44
51
Discrete ,
45
52
46
53
/// <summary>
47
- /// Disassociate.
54
+ /// Disassociate the alpha channel from the image .
48
55
/// </summary>
49
56
Disassociate ,
50
57
51
58
/// <summary>
52
- /// Extract.
59
+ /// Copies the alpha channel values into all the color channels and turns 'Off' the image's
60
+ /// transparency, so as to generate a grayscale mask of the image's shape. The alpha channel
61
+ /// data is left intact just deactivated. This is the inverse of 'Copy'.
53
62
/// </summary>
54
63
Extract ,
55
64
@@ -64,27 +73,32 @@ public enum AlphaOption
64
73
On ,
65
74
66
75
/// <summary>
67
- /// Opaque .
76
+ /// Enables the alpha/matte channel and forces it to be fully opaque .
68
77
/// </summary>
69
78
Opaque ,
70
79
71
80
/// <summary>
72
- /// Remove .
81
+ /// Composite the image over the background color .
73
82
/// </summary>
74
83
Remove ,
75
84
76
85
/// <summary>
77
- /// Set.
86
+ /// Activates the alpha/matte channel. If it was previously turned off then it also
87
+ /// resets the channel to opaque. If the image already had the alpha channel turned on,
88
+ /// it will have no effect.
78
89
/// </summary>
79
90
Set ,
80
91
81
92
/// <summary>
82
- /// Shape.
93
+ /// As per 'Copy' but also colors the resulting shape mask with the current background color.
94
+ /// That is the RGB color channels is replaced, with appropriate alpha shape.
83
95
/// </summary>
84
96
Shape ,
85
97
86
98
/// <summary>
87
- /// Transparent.
99
+ /// Activates the alpha/matte channel and forces it to be fully transparent. This effectively
100
+ /// creates a fully transparent image the same size as the original and with all its original
101
+ /// RGB data still intact, but fully transparent.
88
102
/// </summary>
89
103
Transparent ,
90
104
}
0 commit comments