1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
|
using System;
using System.Diagnostics;
using System.Drawing;
namespace FreeImageAPI.Metadata
{
/// <summary>
/// Provides additional information specific for GIF files. This class cannot be inherited.
/// </summary>
public class GifInformation : MDM_ANIMATION
{
/// <summary>
/// Initializes a new instance of the <see cref="GifInformation"/> class
/// with the specified <see cref="FreeImageBitmap"/>.
/// </summary>
/// <param name="bitmap">A reference to a <see cref="FreeImageBitmap"/> instance.</param>
public GifInformation(FreeImageBitmap bitmap)
: base(bitmap.Dib)
{
}
/// <summary>
/// Gets or sets a value indicating whether this frame uses the
/// GIF image's global palette. If set to <b>false</b>, this
/// frame uses its local palette.
/// </summary>
/// <remarks>
/// <b>Handling of null values</b><para/>
/// A null value indicates, that the corresponding metadata tag is not
/// present in the metadata model.
/// Setting this property's value to a non-null reference creates the
/// metadata tag if necessary.
/// Setting this property's value to a null reference deletes the
/// metadata tag from the metadata model.
/// </remarks>
public bool? UseGlobalPalette
{
get
{
byte? useGlobalPalette = GetTagValue<byte>("NoLocalPalette");
return useGlobalPalette.HasValue ? (useGlobalPalette.Value != 0) : default(bool?);
}
set
{
byte? val = null;
if (value.HasValue)
{
val = (byte)(value.Value ? 1 : 0);
}
SetTagValue("NoLocalPalette", val);
}
}
/// <summary>
/// Creates a global palette for the GIF image, intialized with all entries of the
/// current local palette.
/// The property <see cref="UseGlobalPalette"/> will be set to <b>true</b> when
/// invoking this method. This effectively enables the newly created global palette.
/// </summary>
/// <exception cref="InvalidOperationException">
/// The image does not have a palette.
/// </exception>
public void CreateGlobalPalette()
{
CreateGlobalPalette(new Palette(dib));
}
/// <summary>
/// Creates a global palette for the GIF image with the specified size, intialized
/// with the first <paramref name="size"/> entries of the current local palette.
/// The property <see cref="UseGlobalPalette"/> will be set to <b>true</b> when
/// invoking this method. This effectively enables the newly created global palette.
/// </summary>
/// <param name="size">The size of the newly created global palette.</param>
/// <exception cref="ArgumentNullException">
/// <paramref name="palette"/> is a null reference.</exception>
public void CreateGlobalPalette(int size)
{
CreateGlobalPalette(new Palette(dib), size);
}
/// <summary>
/// Creates a global palette for the GIF image, intialized with the entries
/// of the specified palette.
/// The property <see cref="UseGlobalPalette"/> will be set to <b>true</b> when
/// invoking this method. This effectively enables the newly created global palette.
/// </summary>
/// <param name="palette">The palette that contains the initial values for
/// the newly created global palette.</param>
/// <exception cref="ArgumentNullException">
/// <paramref name="palette"/> is a null reference.</exception>
public void CreateGlobalPalette(Palette palette)
{
if (palette == null)
{
throw new ArgumentNullException("palette");
}
GlobalPalette = palette;
UseGlobalPalette = true;
}
/// <summary>
/// Creates a global palette for the GIF image with the specified size, intialized
/// with the first <paramref name="size"/> entries of the specified palette.
/// The property <see cref="UseGlobalPalette"/> will be set to <b>true</b> when
/// invoking this method. This effectively enables the newly created global palette.
/// </summary>
/// <param name="palette">The palette that contains the initial values for
/// the newly created global palette.</param>
/// <param name="size">The size of the newly created global palette.</param>
/// <exception cref="ArgumentNullException">
/// <paramref name="palette"/> is a null reference.</exception>
public void CreateGlobalPalette(Palette palette, int size)
{
if (palette == null)
{
throw new ArgumentNullException("palette");
}
if (size <= 0)
{
throw new ArgumentOutOfRangeException("size");
}
Palette pal = new Palette(size);
pal.CopyFrom(palette);
GlobalPalette = palette;
UseGlobalPalette = true;
}
}
}
|
