AnimationLoop Property

Summary

Gets or sets the animation loop value to use when saving GIF files.

Syntax

Objective-C

C++/CLI

Java

Python

public int AnimationLoop { get; set; }

@property (nonatomic, assign) NSUInteger animationLoop;

public int getAnimationLoop() 
public void setAnimationLoop(int loop)

public: 
property int AnimationLoop { 
   int get(); 
   void set (    int ); 
}

AnimationLoop # get and set (CodecsGifSaveOptions)

Property Value

The animation loop value to use when saving GIF files. The default value is 0.

Remarks

AnimationLoop is only used when the value of UseAnimationLoop is set to true.

Example

Java

using Leadtools; 
using Leadtools.Codecs; 
 
using Leadtools.ImageProcessing.Core; 
using Leadtools.Pdf; 
 
public void CodecsGifOptionsExample() 
{ 
   RasterCodecs codecs = new RasterCodecs(); 
   string srcFileName = Path.Combine(LEAD_VARS.ImagesDir, "eye.gif"); 
 
   // Get all Information about the Gif file that you want to load. 
   CodecsImageInfo imageInfo = codecs.GetInformation(srcFileName, true); 
 
   // set the animation loop value.  
   if (imageInfo.Gif.HasAnimationLoop) 
   { 
      codecs.Options.Gif.Load.AnimationLoop = imageInfo.Gif.AnimationLoop; // CodecsGifOptions & CodecsGifLoadOptions reference 
      if (imageInfo.Gif.AnimationLoop > 10) 
         codecs.Options.Gif.Save.AnimationLoop = 10; // CodecsGifSaveOptions reference 
   } 
 
   // if this image that you want to load uses the Animation loop then use it in the save options. 
   codecs.Options.Gif.Save.UseAnimationLoop = imageInfo.Gif.HasAnimationLoop; 
 
   // if this image that you want to load uses the Animation Background then use it in the save options. 
   if (imageInfo.Gif.HasAnimationBackground) 
   { 
      codecs.Options.Gif.Save.AnimationBackground = imageInfo.Gif.AnimationBackground; 
      codecs.Options.Gif.Save.UseAnimationBackground = false; 
   } 
 
   // if this image that you want to load uses the Animation Palette then use it in the save options. 
   if (imageInfo.Gif.HasAnimationPalette) 
      codecs.Options.Gif.Save.SetAnimationPalette(imageInfo.Gif.GetAnimationPalette()); 
 
   codecs.Options.Gif.Save.UseAnimationPalette = imageInfo.Gif.HasAnimationPalette; 
 
   // if this image that you want to load uses the Intrlaced option, then use it otherwise don't use it. 
   codecs.Options.Gif.Save.Interlaced = imageInfo.Gif.IsInterlaced; 
 
   codecs.Options.Gif.Save.AnimationWidth = imageInfo.Gif.AnimationWidth; 
   codecs.Options.Gif.Save.AnimationHeight = imageInfo.Gif.AnimationHeight; 
 
   RasterImage srcImage = codecs.Load(srcFileName); 
 
   codecs.Save(srcImage, Path.Combine(LEAD_VARS.ImagesDir, "gif1.gif"), RasterImageFormat.Gif, srcImage.BitsPerPixel, 1, srcImage.PageCount, 1, CodecsSavePageMode.Overwrite); 
 
   //change some save options and save the image in a new file. 
   codecs.Options.Gif.Save.UseAnimationLoop = true; 
   codecs.Options.Gif.Save.AnimationLoop = 1; 
   codecs.Options.Gif.Save.AnimationWidth = imageInfo.Gif.AnimationWidth + 100; 
   codecs.Options.Gif.Save.AnimationHeight = imageInfo.Gif.AnimationHeight + 100; 
 
   //Saving the image after the Gif setting. 
   codecs.Save(srcImage, Path.Combine(LEAD_VARS.ImagesDir, "gif2.gif"), RasterImageFormat.Gif, srcImage.BitsPerPixel, 1, srcImage.PageCount, 1, CodecsSavePageMode.Overwrite); 
 
   // Clean up 
   srcImage.Dispose(); 
   codecs.Dispose(); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS23\Resources\Images"; 
}

 
import java.io.File; 
import java.io.IOException; 
import java.net.URI; 
import java.net.URISyntaxException; 
import java.nio.file.Paths; 
 
import org.junit.*; 
import org.junit.runner.JUnitCore; 
import org.junit.runner.Result; 
import org.junit.runner.notification.Failure; 
import static org.junit.Assert.*; 
 
import leadtools.*; 
import leadtools.codecs.*; 
import leadtools.imageprocessing.core.MinMaxBitsCommand; 
 
 
public void codecsGifOptionsExample() { 
   final String LEAD_VARS_IMAGES_DIR = "C:\\LEADTOOLS23\\Resources\\Images"; 
   RasterCodecs codecs = new RasterCodecs(); 
   String srcFileName = combine(LEAD_VARS_IMAGES_DIR, "eye.gif"); 
 
   // Get all Information about the Gif file that you want to load. 
   CodecsImageInfo imageInfo = codecs.getInformation(srcFileName, true); 
 
   // set the animation loop value. 
   if (imageInfo.getGif().hasAnimationLoop()) { 
      codecs.getOptions().getGif().getLoad().setAnimationLoop(imageInfo.getGif().getAnimationLoop()); // CodecsGifOptions 
                                                                                                      // & 
                                                                                                      // CodecsGifLoadOptions 
                                                                                                      // reference 
      if (imageInfo.getGif().getAnimationLoop() > 10) 
         codecs.getOptions().getGif().getSave().setAnimationLoop(10); // CodecsGifSaveOptions reference 
   } 
 
   // if this image that you want to load uses the Animation loop then use it in 
   // the save options. 
   codecs.getOptions().getGif().getSave().setUseAnimationLoop(imageInfo.getGif().hasAnimationLoop()); 
 
   // if this image that you want to load uses the Animation Background then use it 
   // in the save options. 
   if (imageInfo.getGif().hasAnimationBackground()) { 
      codecs.getOptions().getGif().getSave().setAnimationBackground(imageInfo.getGif().getAnimationBackground()); 
      codecs.getOptions().getGif().getSave().setUseAnimationBackground(false); 
   } 
 
   // if this image that you want to load uses the Animation Palette then use it in 
   // the save options. 
   if (imageInfo.getGif().hasAnimationPalette()) 
      codecs.getOptions().getGif().getSave().setUseAnimationPalette(imageInfo.getGif().hasAnimationPalette()); 
 
   // if this image that you want to load uses the Intrlaced option, then use it 
   // otherwise don't use it. 
   codecs.getOptions().getGif().getSave().setInterlaced(imageInfo.getGif().isInterlaced()); 
 
   codecs.getOptions().getGif().getSave().setAnimationWidth(imageInfo.getGif().getAnimationWidth()); 
   codecs.getOptions().getGif().getSave().setAnimationHeight(imageInfo.getGif().getAnimationHeight()); 
 
   RasterImage srcImage = codecs.load(srcFileName); 
 
   codecs.save( 
      srcImage,  
      combine(LEAD_VARS_IMAGES_DIR, "gif1.gif"),  
      RasterImageFormat.GIF, 
      srcImage.getBitsPerPixel(),  
      1,  
      srcImage.getPageCount(),  
      1,  
      CodecsSavePageMode.OVERWRITE 
   ); 
 
   // change some save options and save the image in a new file. 
   codecs.getOptions().getGif().getSave().setUseAnimationLoop(true); 
   codecs.getOptions().getGif().getSave().setAnimationLoop(1); 
   codecs.getOptions().getGif().getSave().setAnimationWidth(imageInfo.getGif().getAnimationWidth() + 100); 
   codecs.getOptions().getGif().getSave().setAnimationHeight(imageInfo.getGif().getAnimationHeight() + 100); 
 
   // Saving the image after the Gif setting. 
   String outputFileName = combine(LEAD_VARS_IMAGES_DIR, "gif2.gif"); 
   codecs.save(srcImage, outputFileName, RasterImageFormat.GIF, srcImage.getBitsPerPixel(), 1, 
         srcImage.getPageCount(), 1, CodecsSavePageMode.OVERWRITE); 
 
   assertTrue("File unsuccessfully saved to " + outputFileName, (new File(outputFileName)).exists()); 
   System.out.printf("File successfully saved to %s%n", outputFileName); 
       
   // Clean up 
   srcImage.dispose(); 
   codecs.dispose(); 
}

Requirements

Target Platforms

Reference

CodecsGifSaveOptions Class

CodecsGifSaveOptions Members

Implementing GIF Features

Download our FREE evaluation

Help Version 23.0.2024.2.29

Leadtools.Codecs Assembly

Introduction

Getting Started

Namespaces

Leadtools.Codecs Namespace

Assemblies