GifImage

GifImage class

一个 gif 图像。

public sealed class GifImage : RasterCachedMultipageImage, IMultipageImageExt

构造函数

姓名描述
GifImage(GifFrameBlock)初始化GifImage类.
GifImage(GifFrameBlock, IColorPalette)初始化GifImage类.
GifImage(GifFrameBlock, IColorPalette, bool, byte, byte, byte, bool)初始化GifImage类.

特性

姓名描述
ActiveFrame { get; set; }获取或设置活动帧。
AutoAdjustPalette { get; set; }获取或设置是否自动调整调色板的值。
override BackgroundColor { get; set; }获取或设置背景颜色。
BackgroundColorIndex { get; set; }获取或设置背景色索引。
override BitsPerPixel { get; }获取每像素计数的图像位数。
Blocks { get; }获取 GIF 块。
Bounds { get; }获取图像边界。
BufferSizeHint { get; set; }获取或设置缓冲区大小提示，该提示定义了所有内部缓冲区的最大允许大小。
Container { get; }获取Image容器.
DataStreamContainer { get; }获取对象的数据流。
Disposed { get; }获取一个值，该值指示此实例是否被释放。
override FileFormat { get; }获取文件格式的值
override HasAlpha { get; }获取一个值，该值指示此实例是否具有 alpha。
override HasBackgroundColor { get; }获取一个值，该值指示图像是否具有背景色。
HasTrailer { get; set; }获取或设置一个值，表示 GIF 是否有预告片。
override HasTransparentColor { get; set; }获取指示活动帧是否具有透明颜色的值。
override Height { get; }获取图像高度。
virtual HorizontalResolution { get; set; }获取或设置此图像的水平分辨率，以每英寸像素为单位RasterImage .
override ImageOpacity { get; }获取此图像的不透明度（活动帧）。
InterruptMonitor { get; set; }获取或设置中断监视器。
IsCached { get; }获取当前是否缓存图像数据的值。
IsInterlaced { get; }获取一个值，指示此图像实例是否是隔行扫描的。
IsPaletteSorted { get; set; }获取或设置一个指示调色板是否排序的值。
IsRawDataAvailable { get; }获取一个值，指示是否可以加载原始数据。
LoopsCount { get; set; }获取循环计数（如果 gif 图像包含有关循环的信息）
override PageCount { get; }获取页数。
override PageExportingAction { get; set; }获取或设置页面导出动作。 请注意，设置此方法执行后会自动释放页面资源。 会在每页保存前执行。
override Pages { get; }获取页面。
Palette { get; set; }获取或设置调色板。直接表示像素时不使用调色板。
PaletteColorResolutionBits { get; set; }获取或设置调色板颜色分辨率位。
PixelAspectRatio { get; set; }获取或设置像素纵横比。
virtual PremultiplyComponents { get; set; }获取或设置一个值，该值指示是否必须对图像分量进行预乘。
RawCustomColorConverter { get; set; }获取或设置自定义颜色转换器
virtual RawDataFormat { get; }获取原始数据格式。
RawDataSettings { get; }获取当前的原始数据设置。请注意，使用这些设置时，数据加载时无需转换。
RawFallbackIndex { get; set; }获取或设置调色板索引超出范围时使用的回退索引
RawIndexedColorConverter { get; set; }获取或设置索引颜色转换器
virtual RawLineSize { get; }以字节为单位获取原始行大小。
Size { get; }获取图像大小。
override TransparentColor { get; }获取活动框架透明颜色。
virtual UpdateXmpData { get; set; }获取或设置是否更新 XMP 元数据的值。
override UsePalette { get; }获取指示是否使用图像调色板的值。
virtual UseRawData { get; set; }获取或设置一个值，指示当原始数据加载可用时是否使用原始数据加载。
virtual VerticalResolution { get; set; }获取或设置此对象的垂直分辨率，以每英寸像素为单位RasterImage .
override Width { get; }获取图像宽度。
override XmpData { get; set; }获取或设置 XMP 元数据。

方法

姓名描述
AddBlock(IGifBlock)添加一个新的 GIF 块。
AddPage(RasterImage)将页面添加到图像。
override AdjustBrightness(int)调整一个brightness对于图像.
override AdjustContrast(float)调整对比度。
override AdjustGamma(float)图像的 Gamma 校正。
override AdjustGamma(float, float, float)图像的 Gamma 校正。
override BinarizeBradley(double)使用 Bradley 自适应阈值算法对图像进行二值化，使用积分图像阈值
override BinarizeBradley(double, int)使用 Bradley 自适应阈值算法对图像进行二值化，使用积分图像阈值
override BinarizeFixed(byte)具有预定义阈值的图像二值化
override BinarizeOtsu()使用 Otsu 阈值对图像进行二值化
override CacheData()缓存私有数据。
CanSave(ImageOptionsBase)判断图像是否可以保存为传递的保存选项所代表的指定文件格式。
ClearBlocks()清除所有 GIF 块。
override Crop(Rectangle)裁剪图像。
override Crop(int, int, int, int)使用班次裁剪图像。
Dispose()处理当前实例。
Dither(DitheringMethod, int)对当前图像执行抖动。
override Dither(DitheringMethod, int, IColorPalette)对当前图像执行抖动。
override Filter(Rectangle, FilterOptionsBase)过滤指定的矩形。
GetArgb32Pixel(int, int)获取图像 32 位 ARGB 像素。
GetDefaultArgb32Pixels(Rectangle)获取默认的 32 位 ARGB 像素数组。
virtual GetDefaultOptions(object[])获取默认选项。
GetDefaultPixels(Rectangle, IPartialArgb32PixelLoader)使用部分像素加载器获取默认像素数组。
GetDefaultRawData(Rectangle, RawDataSettings)获取默认的原始数据数组。
GetDefaultRawData(Rectangle, IPartialRawDataLoader, RawDataSettings)使用部分像素加载器获取默认原始数据数组。
virtual GetModifyDate(bool)获取上次修改资源图像的日期和时间。
override GetOriginalOptions()获取基于原始文件设置的选项。 这有助于保持原始图像的位深度和其他参数不变。 例如，如果我们加载一个每像素 1 位的黑白 PNG 图像，然后使用 the 保存它Save方法，将产生每像素8位的输出PNG图像。 为了避免它并以每像素1位保存PNG图像，使用此方法获取相应的保存选项并将它们 传递给Save方法作为第二个参数。
GetPixel(int, int)获取图像像素。
GetSkewAngle()获取倾斜角度。 该方法适用于扫描的文本文档，确定扫描时的倾斜角度。
override Grayscale()将图像转换为其灰度表示
InsertBlock(int, IGifBlock)添加一个新的 GIF 块。
LoadArgb32Pixels(Rectangle)加载 32 位 ARGB 像素。
LoadArgb64Pixels(Rectangle)加载 64 位 ARGB 像素。
LoadCmyk32Pixels(Rectangle)以 CMYK 格式加载像素。
LoadPartialArgb32Pixels(Rectangle, IPartialArgb32PixelLoader)部分按包加载 32 位 ARGB 像素。
LoadPartialPixels(Rectangle, IPartialPixelLoader)部分按包加载像素。
LoadPixels(Rectangle)加载像素。
LoadRawData(Rectangle, RawDataSettings, IPartialRawDataLoader)加载原始数据。
LoadRawData(Rectangle, Rectangle, RawDataSettings, IPartialRawDataLoader)加载原始数据。
NormalizeAngle()角度归一化。 此方法适用于扫描的文本文档，以消除倾斜扫描。 此方法使用GetSkewAngle和Rotate方法.
override NormalizeAngle(bool, Color)角度归一化。 此方法适用于扫描的文本文档，以消除倾斜扫描。 此方法使用!:GetSkewAngle和Rotate方法.
OrderBlocks()根据 GIF 规范对 GIF 块进行排序。一些GifGraphicsControlBlock为了正确的 GIF 布局，可能会被删除。
ReadArgb32ScanLine(int)按指定的扫描线索引读取整个扫描线。
ReadScanLine(int)按指定的扫描线索引读取整个扫描线。
RemoveBlock(IGifBlock)删除 GIF 块。
ReplaceColor(Color, byte, Color)用允许的差异将一种颜色替换为另一种颜色，并保留原始 alpha 值以保存平滑边缘。
override ReplaceColor(int, byte, int)用允许的差异将一种颜色替换为另一种颜色，并保留原始 alpha 值以保存平滑边缘。
ReplaceNonTransparentColors(Color)将所有不透明的颜色替换为新颜色并保留原始 alpha 值以保存平滑的边缘。 注意：如果在不透明的图像上使用它，所有颜色都将替换为一个颜色。
override ReplaceNonTransparentColors(int)将所有不透明的颜色替换为新颜色并保留原始 alpha 值以保存平滑的边缘。 注意：如果在不透明的图像上使用它，所有颜色都将替换为一个颜色。
Resize(int, int)调整图像大小。默认NearestNeighbourResample已使用。
override Resize(int, int, ImageResizeSettings)调整图像大小。
override Resize(int, int, ResizeType)调整图像大小。
ResizeFullFrame(int, int, ResizeType)使用每个 GIF 页面的全帧调整图像大小。需要避免可能出现的伪影。
ResizeHeightProportionally(int)按比例调整高度。默认NearestNeighbourResample已使用。
virtual ResizeHeightProportionally(int, ImageResizeSettings)按比例调整高度。
override ResizeHeightProportionally(int, ResizeType)按比例调整宽度。
ResizeProportional(int, int, ResizeType)对图像执行比例调整大小。 比例调整大小将根据比例调整每一帧的大小newWidth/宽度和newHeight/身高.
ResizeWidthProportionally(int)按比例调整宽度。默认NearestNeighbourResample已使用。
virtual ResizeWidthProportionally(int, ImageResizeSettings)按比例调整宽度。
override ResizeWidthProportionally(int, ResizeType)按比例调整宽度。
virtual Rotate(float)围绕中心旋转图像。
override Rotate(float, bool, Color)!:RasterCahcedMultipageImage.Rotate中心周围的图像。
override RotateFlip(RotateFlipType)仅旋转、翻转或旋转和翻转活动帧。
Save()将图像数据保存到底层流。
Save(Stream)将对象的数据保存到指定的流中。
override Save(string)将图像保存到指定的文件位置。
Save(Stream, ImageOptionsBase)根据保存选项将图像的数据以指定的文件格式保存到指定的流中。
virtual Save(string, bool)将对象的数据保存到指定的文件位置。
virtual Save(string, ImageOptionsBase)根据保存选项将对象的数据以指定的文件格式保存到指定的文件位置。
override Save(Stream, ImageOptionsBase, Rectangle)根据保存选项将图像的数据以指定的文件格式保存到指定的流中。
virtual Save(string, ImageOptionsBase, Rectangle)根据保存选项将对象的数据以指定的文件格式保存到指定的文件位置。
SaveArgb32Pixels(Rectangle, int[])保存 32 位 ARGB 像素。
SaveCmyk32Pixels(Rectangle, int[])保存像素。
SavePixels(Rectangle, Color[])保存像素。
SaveRawData(byte[], int, Rectangle, RawDataSettings)保存原始数据。
SetArgb32Pixel(int, int, int)为指定位置设置图像 32 位 ARGB 像素。
SetFrameTime(ushort)以毫秒为单位设置所有帧的持续时间。 更改此值将重置所有帧的延迟。
override SetPalette(IColorPalette, bool)设置图像调色板。
SetPixel(int, int, Color)为指定位置设置图像像素。
virtual SetResolution(double, double)为此设置分辨率RasterImage .
virtual ToBitmap()将光栅图像转换为位图。
WriteArgb32ScanLine(int, int[])将整个扫描线写入指定的扫描线索引。
WriteScanLine(int, Color[])将整个扫描线写入指定的扫描线索引。

例子

根据时间间隔从 GIF 图像中导出部分动画。

[C#]

using (var image = Image.Load("Animation.gif"))
{
    var options = new GifOptions
    {
        FullFrame = true,
        MultiPageOptions = new MultiPageOptions
        {
            Mode = MultiPageMode.TimeInterval,
            TimeInterval = new TimeInterval(0, 400)
        }
    };

    image.Save("PartOfAnimation.gif", options);
}

此示例说明如何创建 GIF 图像并将其保存到文件中。

[C#]

string dir = "c:\\temp\\";

// 创建一个 100x100 像素的 GIF 帧块。
using (Aspose.Imaging.FileFormats.Gif.Blocks.GifFrameBlock firstBlock = new Aspose.Imaging.FileFormats.Gif.Blocks.GifFrameBlock(100, 100))
{
    // 用红色填充整个块。
    Aspose.Imaging.Graphics gr = new Aspose.Imaging.Graphics(firstBlock);
    Aspose.Imaging.Brushes.SolidBrush brush = new Aspose.Imaging.Brushes.SolidBrush(Aspose.Imaging.Color.Red);
    gr.FillRectangle(brush, firstBlock.Bounds);

    using (Aspose.Imaging.FileFormats.Gif.GifImage gifImage = new Aspose.Imaging.FileFormats.Gif.GifImage(firstBlock))
    {
        gifImage.Save(dir + "output.gif");
    }
}

使用单页光栅图像创建多页 GIF 图像。

[C#]

static void Main(string[] args)
{
    // 加载帧
    var frames = LoadFrames("Animation frames").ToArray();

    // 使用第一帧创建 GIF 图像
    using (var image = new GifImage(new GifFrameBlock(frames[0])))
    {
        // 使用 AddPage 方法将帧添加到 GIF 图像
        for (var index = 1; index < frames.Length; index++)
        {
            image.AddPage(frames[index]);
        }

        // 保存 GIF 图片
        image.Save("Multipage.gif");
    }
}

private static IEnumerable<RasterImage> LoadFrames(string directory)
{
    foreach (var filePath in Directory.GetFiles(directory))
    {
        yield return (RasterImage)Image.Load(filePath);
    }
}

也可以看看

GifBlocksRegistry IGifBlock