GifOptions

Inheritance: java.lang.Object, com.aspose.imaging.DisposableObject, com.aspose.imaging.ImageOptionsBase

public class GifOptions extends ImageOptionsBase

用于图形交换格式 (GIF) 栅格图像文件创建的 API 为开发者提供了生成 GIF 图像的精确控制的全面选项。该 API 具备设置背景颜色、颜色调色板、分辨率、交错类型、透明颜色、XMP 元数据容器以及图像压缩等功能，确保在创建针对特定应用需求的优化且视觉上吸引人的 GIF 时具备灵活性和高效性。

构造函数

构造函数描述
GifOptions()初始化 GifOptions 类的新实例。
GifOptions(GifOptions gifOptions)初始化 GifOptions 类的新实例。

方法

方法描述
getDoPaletteCorrection()获取或设置指示是否应用调色板校正的值。
setDoPaletteCorrection(boolean value)获取或设置指示是否应用调色板校正的值。
getLoopsCount()获取循环计数（默认 1 次循环）
setLoopsCount(int value)设置循环计数（默认 1 次循环）
getColorResolution()获取或设置 GIF 颜色分辨率。
setColorResolution(byte value)获取或设置 GIF 颜色分辨率。
isPaletteSorted()获取或设置指示调色板条目是否已排序的值。
setPaletteSorted(boolean value)获取或设置指示调色板条目是否已排序的值。
getPixelAspectRatio()获取或设置 GIF 像素宽高比。
setPixelAspectRatio(byte value)获取或设置 GIF 像素宽高比。
getBackgroundColorIndex()获取或设置 GIF 背景颜色索引。
setBackgroundColorIndex(byte value)获取或设置 GIF 背景颜色索引。
hasTrailer()获取或设置指示 GIF 是否具有尾部的值。
setTrailer(boolean value)获取或设置指示 GIF 是否具有尾部的值。
getInterlaced()如果图像应交错，则为 true。
setInterlaced(boolean value)如果图像应交错，则为 true。
getMaxDiff()获取或设置允许的最大像素差异。
setMaxDiff(int value)获取或设置允许的最大像素差异。
getBackgroundColor()获取背景颜色。
setBackgroundColor(Color value)设置背景颜色。
hasTransparentColor()获取一个值，指示 GIF 图像是否具有透明颜色。
setTransparentColor(Boolean value)设置一个值，指示 GIF 图像是否具有透明颜色。

Example: This example demonstrates the use of different classes from SaveOptions Namespace for export purposes.

此示例演示了如何使用 SaveOptions 命名空间中的不同类进行导出。将类型为 Gif 的图像加载到 Image 实例中，然后导出为多种格式。

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

//在 Image 类的实例中加载现有的（Gif 类型）图像
com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    //使用默认选项导出为 BMP 文件格式
    image.save(dir + "output.bmp", new com.aspose.imaging.imageoptions.BmpOptions());

    //使用默认选项导出为 JPEG 文件格式
    image.save(dir + "output.jpeg", new com.aspose.imaging.imageoptions.JpegOptions());

    //使用默认选项导出为 PNG 文件格式
    image.save(dir + "output.png", new com.aspose.imaging.imageoptions.PngOptions());

    //使用默认选项导出为 TIFF 文件格式
    image.save(dir + "output.tif", new com.aspose.imaging.imageoptions.TiffOptions(com.aspose.imaging.fileformats.tiff.enums.TiffExpectedFormat.Default));
} finally {
    image.dispose();
}

Example: The following example shows how to convert a multipage vector image to GIF format in general way without referencing to a particular image type.

String dir = "C:\\aspose.imaging\\net\\misc\\ImagingReleaseQATester\\Tests\\testdata\\2548\\";
String inputFilePath = dir + "Multipage.cdr";
String outputFilePath = dir + "Multipage.cdr.gif";

com.aspose.imaging.ImageOptionsBase exportOptions = new com.aspose.imaging.imageoptions.GifOptions();

try (com.aspose.imaging.Image image = com.aspose.imaging.Image.load(inputFilePath))
{
    exportOptions.setMultiPageOptions(null);

    // 仅导出前两页。这些页面将在输出的 GIF 中作为动画帧呈现。
    com.aspose.imaging.IMultipageImage multipageImage = (image instanceof com.aspose.imaging.IMultipageImage) ? (com.aspose.imaging.IMultipageImage) image : null;
    if (multipageImage != null && (multipageImage.getPages() != null && multipageImage.getPageCount() > 2))
    {
        exportOptions.setMultiPageOptions(new com.aspose.imaging.imageoptions.MultiPageOptions(new com.aspose.imaging.IntRange(0, 2)));
    }

    if (image instanceof com.aspose.imaging.VectorImage)
    {
        com.aspose.imaging.imageoptions.VectorRasterizationOptions defaultOptions = (com.aspose.imaging.imageoptions.VectorRasterizationOptions) image.getDefaultOptions(new Object[]{Color.getWhite(), image.getWidth(), image.getHeight()});
        exportOptions.setVectorRasterizationOptions(defaultOptions);
        defaultOptions.setTextRenderingHint(com.aspose.imaging.TextRenderingHint.SingleBitPerPixel);
        defaultOptions.setSmoothingMode(com.aspose.imaging.SmoothingMode.None);
    }

    image.save(outputFilePath, exportOptions);
}

GifOptions()

public GifOptions()

初始化 GifOptions 类的新实例。

GifOptions(GifOptions gifOptions)

public GifOptions(GifOptions gifOptions)

初始化 GifOptions 类的新实例。

Parameters:

参数类型描述
gifOptionsGifOptionsGIF 选项。

getDoPaletteCorrection()

public boolean getDoPaletteCorrection()

获取或设置指示是否应用调色板校正的值。

Returns: 布尔型 - 如果已应用调色板校正则为 true；否则为 false。

调色板校正意味着每当图像导出为 GIF 时，源图像的颜色将被分析，以构建最匹配的调色板（如果图像调色板不存在或在选项中未指定）。分析过程需要一些时间，但输出图像将拥有最佳匹配的颜色调色板，视觉效果更佳。

setDoPaletteCorrection(boolean value)

public void setDoPaletteCorrection(boolean value)

获取或设置指示是否应用调色板校正的值。

Parameters:

参数类型描述
valueboolean

调色板校正意味着每当图像导出为 GIF 时，源图像的颜色将被分析，以构建最匹配的调色板（如果图像调色板不存在或在选项中未指定）。分析过程需要一些时间，但输出图像将拥有最佳匹配的颜色调色板，视觉效果更佳。 |

Example: This example shows how to save a BMP image to GIF format using various options.

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

com.aspose.imaging.Image bmpImage = new com.aspose.imaging.fileformats.bmp.BmpImage(1000, 1000);
try {
    // 用蓝黄渐变填充整个图像。
    com.aspose.imaging.brushes.LinearGradientBrush gradientBrush = new com.aspose.imaging.brushes.LinearGradientBrush(
            new com.aspose.imaging.Point(0, 0),
            new com.aspose.imaging.Point(bmpImage.getWidth(), bmpImage.getHeight()),
            com.aspose.imaging.Color.getBlue(),
            com.aspose.imaging.Color.getYellow());

    com.aspose.imaging.Graphics graphics = new com.aspose.imaging.Graphics(bmpImage);
    graphics.fillRectangle(gradientBrush, bmpImage.getBounds());

    com.aspose.imaging.imageoptions.GifOptions saveOptions = new com.aspose.imaging.imageoptions.GifOptions();

    // 存储一种颜色所需的位数减 1。
    saveOptions.setColorResolution((byte) 7);

    // 调色板校正意味着每当图像导出为 GIF 时，源图像的颜色将被分析
    // 以构建最匹配的调色板（如果图像调色板不存在或在选项中未指定）
    saveOptions.setDoPaletteCorrection(true);

    // 以渐进方式加载 GIF 图像。
    // 交错的 GIF 不会从上到下线性显示其扫描线，而是重新排序它们
    // 因此 GIF 的内容在加载完成之前就已经清晰可见。
    saveOptions.setInterlaced(true);

    // 另存为无损 GIF。
    java.io.FileOutputStream stream = new java.io.FileOutputStream(dir + "output.gif");
    try {
        bmpImage.save(stream, saveOptions);
        System.out.printf("The size of the lossless GIF: %s bytes.\r\n", stream.getChannel().size());
    } finally {
        stream.close();
    }

    // 设置允许的最大像素差异。如果大于零，将使用有损压缩。
    // 推荐的最佳有损压缩值为 80。30 表示非常轻的压缩，200 表示较重的压缩。
    saveOptions.setMaxDiff(80);

    // 另存为有损 GIF。
    stream = new java.io.FileOutputStream(dir + "output.lossy.gif");
    try {
        bmpImage.save(stream, saveOptions);
        System.out.printf("The size of the lossy GIF: %s bytes.\r\n", stream.getChannel().size());
    } finally {
        stream.close();
    }
} finally {
    bmpImage.close();
}

//输出可能如下所示：
//无损 GIF 的大小：212816 字节。
//有损 GIF 的大小：89726 字节。

getLoopsCount()

public final int getLoopsCount()

获取循环计数（默认 1 次循环）

值：循环计数。

Returns: int - 循环计数（默认 1 次循环）

setLoopsCount(int value)

public final void setLoopsCount(int value)

设置循环计数（默认 1 次循环）

值：循环计数。

Parameters:

参数类型描述
valueint循环计数（默认 1 次循环）

getColorResolution()

public byte getColorResolution()

获取或设置 GIF 颜色分辨率。

Returns: byte - 颜色分辨率。

颜色分辨率 - 原始图像每个主色可用的位数减 1。此值表示用于选择图形颜色的整个调色板的大小，而不是图形实际使用的颜色数量。例如，如果此字段的值为 3，则原始图像的调色板每个主色有 4 位可用于创建图像。即使源机器上并非所有调色板颜色都可用，也应设置此值以指示原始调色板的丰富程度。

setColorResolution(byte value)

public void setColorResolution(byte value)

获取或设置 GIF 颜色分辨率。

Parameters:

参数类型描述
valuebyte

颜色分辨率 - 原始图像每个主色可用的位数减 1。此值表示用于选择图形颜色的整个调色板的大小，而不是图形实际使用的颜色数量。例如，如果此字段的值为 3，则原始图像的调色板每个主色有 4 位可用于创建图像。即使源机器上并非所有调色板颜色都可用，也应设置此值以指示原始调色板的丰富程度。 |

Example: This example shows how to save a BMP image to GIF format using various options.

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

com.aspose.imaging.Image bmpImage = new com.aspose.imaging.fileformats.bmp.BmpImage(1000, 1000);
try {
    // 用蓝黄渐变填充整个图像。
    com.aspose.imaging.brushes.LinearGradientBrush gradientBrush = new com.aspose.imaging.brushes.LinearGradientBrush(
            new com.aspose.imaging.Point(0, 0),
            new com.aspose.imaging.Point(bmpImage.getWidth(), bmpImage.getHeight()),
            com.aspose.imaging.Color.getBlue(),
            com.aspose.imaging.Color.getYellow());

    com.aspose.imaging.Graphics graphics = new com.aspose.imaging.Graphics(bmpImage);
    graphics.fillRectangle(gradientBrush, bmpImage.getBounds());

    com.aspose.imaging.imageoptions.GifOptions saveOptions = new com.aspose.imaging.imageoptions.GifOptions();

    // 存储一种颜色所需的位数减 1。
    saveOptions.setColorResolution((byte) 7);

    // 调色板校正意味着每当图像导出为 GIF 时，源图像的颜色将被分析
    // 以构建最匹配的调色板（如果图像调色板不存在或在选项中未指定）
    saveOptions.setDoPaletteCorrection(true);

    // 以渐进方式加载 GIF 图像。
    // 交错的 GIF 不会从上到下线性显示其扫描线，而是重新排序它们
    // 因此 GIF 的内容在加载完成之前就已经清晰可见。
    saveOptions.setInterlaced(true);

    // 另存为无损 GIF。
    java.io.FileOutputStream stream = new java.io.FileOutputStream(dir + "output.gif");
    try {
        bmpImage.save(stream, saveOptions);
        System.out.printf("The size of the lossless GIF: %s bytes.\r\n", stream.getChannel().size());
    } finally {
        stream.close();
    }

    // 设置允许的最大像素差异。如果大于零，将使用有损压缩。
    // 推荐的最佳有损压缩值为 80。30 表示非常轻的压缩，200 表示较重的压缩。
    saveOptions.setMaxDiff(80);

    // 另存为有损 GIF。
    stream = new java.io.FileOutputStream(dir + "output.lossy.gif");
    try {
        bmpImage.save(stream, saveOptions);
        System.out.printf("The size of the lossy GIF: %s bytes.\r\n", stream.getChannel().size());
    } finally {
        stream.close();
    }
} finally {
    bmpImage.close();
}

//输出可能如下所示：
//无损 GIF 的大小：212816 字节。
//有损 GIF 的大小：89726 字节。

isPaletteSorted()

public boolean isPaletteSorted()

获取或设置指示调色板条目是否已排序的值。

Returns: boolean - true 表示调色板条目已排序；否则为 false。

setPaletteSorted(boolean value)

public void setPaletteSorted(boolean value)

获取或设置指示调色板条目是否已排序的值。

Parameters:

参数类型描述
valuebooleantrue 表示调色板条目已排序；否则为 false。

getPixelAspectRatio()

public byte getPixelAspectRatio()

获取或设置 GIF 像素宽高比。

像素纵横比 - 用于计算原始图像中像素纵横比近似值的因子。如果字段值不为 0，则根据公式计算该纵横比近似值：Aspect Ratio = (Pixel Aspect Ratio + 15) / 64 像素纵横比定义为像素宽度除以高度的商。此字段的值范围允许指定最宽像素为 4:1 到最高像素为 1:4，步长为 1/64。取值：0 - 未提供纵横比信息。1..255 - 用于计算的值。

Returns: byte - GIF 像素纵横比。

setPixelAspectRatio(byte value)

public void setPixelAspectRatio(byte value)

获取或设置 GIF 像素宽高比。

像素纵横比 - 用于计算原始图像中像素纵横比近似值的因子。如果字段值不为 0，则根据公式计算该纵横比近似值：Aspect Ratio = (Pixel Aspect Ratio + 15) / 64 像素纵横比定义为像素宽度除以高度的商。此字段的值范围允许指定最宽像素为 4:1 到最高像素为 1:4，步长为 1/64。取值：0 - 未提供纵横比信息。1..255 - 用于计算的值。

Parameters:

参数类型描述
valuebyteGIF 像素纵横比。

getBackgroundColorIndex()

public byte getBackgroundColorIndex()

获取或设置 GIF 背景颜色索引。

Returns: byte - GIF 背景颜色索引。

setBackgroundColorIndex(byte value)

public void setBackgroundColorIndex(byte value)

获取或设置 GIF 背景颜色索引。

Parameters:

参数类型描述
valuebyteGIF 背景颜色索引。

hasTrailer()

public boolean hasTrailer()

获取或设置指示 GIF 是否具有尾部的值。

Returns: boolean - true 表示 GIF 有尾部；否则为 false。

setTrailer(boolean value)

public void setTrailer(boolean value)

获取或设置指示 GIF 是否具有尾部的值。

Parameters:

参数类型描述
valuebooleantrue 表示 GIF 有尾部；否则为 false。

getInterlaced()

public boolean getInterlaced()

如果图像应交错，则为 true。

Returns: boolean

setInterlaced(boolean value)

public void setInterlaced(boolean value)

如果图像应交错，则为 true。

Parameters:

参数类型描述
valueboolean

Example: This example shows how to save a BMP image to GIF format using various options.

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

com.aspose.imaging.Image bmpImage = new com.aspose.imaging.fileformats.bmp.BmpImage(1000, 1000);
try {
    // 用蓝黄渐变填充整个图像。
    com.aspose.imaging.brushes.LinearGradientBrush gradientBrush = new com.aspose.imaging.brushes.LinearGradientBrush(
            new com.aspose.imaging.Point(0, 0),
            new com.aspose.imaging.Point(bmpImage.getWidth(), bmpImage.getHeight()),
            com.aspose.imaging.Color.getBlue(),
            com.aspose.imaging.Color.getYellow());

    com.aspose.imaging.Graphics graphics = new com.aspose.imaging.Graphics(bmpImage);
    graphics.fillRectangle(gradientBrush, bmpImage.getBounds());

    com.aspose.imaging.imageoptions.GifOptions saveOptions = new com.aspose.imaging.imageoptions.GifOptions();

    // 存储一种颜色所需的位数减 1。
    saveOptions.setColorResolution((byte) 7);

    // 调色板校正意味着每当图像导出为 GIF 时，源图像的颜色将被分析
    // 以构建最匹配的调色板（如果图像调色板不存在或在选项中未指定）
    saveOptions.setDoPaletteCorrection(true);

    // 以渐进方式加载 GIF 图像。
    // 交错的 GIF 不会从上到下线性显示其扫描线，而是重新排序它们
    // 因此 GIF 的内容在加载完成之前就已经清晰可见。
    saveOptions.setInterlaced(true);

    // 另存为无损 GIF。
    java.io.FileOutputStream stream = new java.io.FileOutputStream(dir + "output.gif");
    try {
        bmpImage.save(stream, saveOptions);
        System.out.printf("The size of the lossless GIF: %s bytes.\r\n", stream.getChannel().size());
    } finally {
        stream.close();
    }

    // 设置允许的最大像素差异。如果大于零，将使用有损压缩。
    // 推荐的最佳有损压缩值为 80。30 表示非常轻的压缩，200 表示较重的压缩。
    saveOptions.setMaxDiff(80);

    // 另存为有损 GIF。
    stream = new java.io.FileOutputStream(dir + "output.lossy.gif");
    try {
        bmpImage.save(stream, saveOptions);
        System.out.printf("The size of the lossy GIF: %s bytes.\r\n", stream.getChannel().size());
    } finally {
        stream.close();
    }
} finally {
    bmpImage.close();
}

//输出可能如下所示：
//无损 GIF 的大小：212816 字节。
//有损 GIF 的大小：89726 字节。

getMaxDiff()

public int getMaxDiff()

获取或设置允许的最大像素差异。如果大于零，将使用有损压缩。推荐的最佳有损压缩值为 80。30 为非常轻度压缩，200 为重度压缩。它在仅引入少量损失时效果最佳，由于压缩算法的限制，非常高的损失水平不会带来太多收益。允许的取值范围为 [0, 1000]。

Returns: int - 允许的取值范围。

setMaxDiff(int value)

public void setMaxDiff(int value)

获取或设置允许的最大像素差异。如果大于零，将使用有损压缩。推荐的最佳有损压缩值为 80。30 为非常轻度压缩，200 为重度压缩。它在仅引入少量损失时效果最佳，由于压缩算法的限制，非常高的损失水平不会带来太多收益。允许的取值范围为 [0, 1000]。

Parameters:

参数类型描述
valueint允许的取值范围。

Example: This example shows how to save a BMP image to GIF format using various options.

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

com.aspose.imaging.Image bmpImage = new com.aspose.imaging.fileformats.bmp.BmpImage(1000, 1000);
try {
    // 用蓝黄渐变填充整个图像。
    com.aspose.imaging.brushes.LinearGradientBrush gradientBrush = new com.aspose.imaging.brushes.LinearGradientBrush(
            new com.aspose.imaging.Point(0, 0),
            new com.aspose.imaging.Point(bmpImage.getWidth(), bmpImage.getHeight()),
            com.aspose.imaging.Color.getBlue(),
            com.aspose.imaging.Color.getYellow());

    com.aspose.imaging.Graphics graphics = new com.aspose.imaging.Graphics(bmpImage);
    graphics.fillRectangle(gradientBrush, bmpImage.getBounds());

    com.aspose.imaging.imageoptions.GifOptions saveOptions = new com.aspose.imaging.imageoptions.GifOptions();

    // 存储一种颜色所需的位数减 1。
    saveOptions.setColorResolution((byte) 7);

    // 调色板校正意味着每当图像导出为 GIF 时，源图像的颜色将被分析
    // 以构建最匹配的调色板（如果图像调色板不存在或在选项中未指定）
    saveOptions.setDoPaletteCorrection(true);

    // 以渐进方式加载 GIF 图像。
    // 交错的 GIF 不会从上到下线性显示其扫描线，而是重新排序它们
    // 因此 GIF 的内容在加载完成之前就已经清晰可见。
    saveOptions.setInterlaced(true);

    // 另存为无损 GIF。
    java.io.FileOutputStream stream = new java.io.FileOutputStream(dir + "output.gif");
    try {
        bmpImage.save(stream, saveOptions);
        System.out.printf("The size of the lossless GIF: %s bytes.\r\n", stream.getChannel().size());
    } finally {
        stream.close();
    }

    // 设置允许的最大像素差异。如果大于零，将使用有损压缩。
    // 推荐的最佳有损压缩值为 80。30 表示非常轻的压缩，200 表示较重的压缩。
    saveOptions.setMaxDiff(80);

    // 另存为有损 GIF。
    stream = new java.io.FileOutputStream(dir + "output.lossy.gif");
    try {
        bmpImage.save(stream, saveOptions);
        System.out.printf("The size of the lossy GIF: %s bytes.\r\n", stream.getChannel().size());
    } finally {
        stream.close();
    }
} finally {
    bmpImage.close();
}

//输出可能如下所示：
//无损 GIF 的大小：212816 字节。
//有损 GIF 的大小：89726 字节。

getBackgroundColor()

public final Color getBackgroundColor()

获取背景颜色。

Returns: Color - the background color.

setBackgroundColor(Color value)

public final void setBackgroundColor(Color value)

设置背景颜色。

Parameters:

参数类型描述
valueColor背景颜色。

hasTransparentColor()

public final Boolean hasTransparentColor()

获取一个值，指示 GIF 图像是否具有透明颜色。如果返回值为 null，则此属性被源图像上下文覆盖。

Returns: java.lang.Boolean - 指示 GIF 图像是否具有透明颜色的值。

setTransparentColor(Boolean value)

public final void setTransparentColor(Boolean value)

设置一个值，指示 GIF 图像是否具有透明颜色。如果返回值为 null，则此属性被源图像上下文覆盖。

Parameters:

参数类型描述
valuejava.lang.Boolean指示 GIF 图像是否具有透明颜色的值。
EpsRasterizationOptions Html5CanvasOptions