←Select platform

GetThumbnailsGrid Method

Summary

Gets an image that contains one or more page thumbnails.

Syntax
C#
C++/CLI
Java
Python
public RasterImage GetThumbnailsGrid( 
   int firstPageNumber, 
   int lastPageNumber, 
   int maximumGridWidth 
) 
public: 
   RasterImage^ GetThumbnailsGrid( 
      int firstPageNumber, 
      int lastPageNumber, 
      int maximumGridWidth 
   ) 
public RasterImage getThumbnailsGrid(int firstPageNumber, int lastPageNumber, int maximumGridWidth) 
def GetThumbnailsGrid(self,firstPageNumber,lastPageNumber,maximumGridWidth): 

Parameters

firstPageNumber

1-based number of the first page number in the document.

lastPageNumber

1-based number of the last page number in the document.

maximumGridWidth

The maximum width of the grid in pixels.

Return Value

A raster image object that contains the thumbnails in a grid layout.

Remarks

Thumbnail grids can be used to obtain the thumbnails of one or more pages in a single call. The result image will contain the images in a grid layout, left to right by row; each image will be of size thumbnailPixelSize. The grid width will be less than or equal to maximumGridWidth in pixels. The number of columns is calculated by dividing maximumGridWidth by the thumbnailPixelSize width. The grid height and number of rows is determined by the columns and total number of images to obtain.

The total number of images to obtain is calculated from firstPageNumber and lastPageNumber. If lastPageNumber is 0 or -1, the last page number in the document will be used; in this case, all pages from firstPageNumber to the end of the document will be returned in the thumbnail grid.

The LEADTOOLS Document Viewer can use GetThumbnailsGrid to speed up obtaining the thumbnails of the pages in the document instead of iterating each page and calling DocumentPage.GetThumbnailImage.

Note that this method does not update the cache.

Example
C#
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.Document.Writer; 
 
using Leadtools.Document; 
using Leadtools.Caching; 
using Leadtools.Annotations.Engine; 
using Leadtools.Ocr; 
using Leadtools.Barcode; 
using Leadtools.Document.Converter; 
 
public void GetThumbnailsGridExample() 
{ 
   var options = new LoadDocumentOptions(); 
   using (var document = DocumentFactory.LoadFromFile(Path.Combine(LEAD_VARS.ImagesDir, "Leadtools.pdf"), options)) 
   { 
      // GetThumbnailsGrid(int firstPageNumber, int lastPageNumber, int maximumGridWidth) 
      document.Images.GetThumbnailsGrid(1, 5, 300); 
   } 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS22\Resources\Images"; 
} 

Consider the following parameters:

In this example, we will load 10 images (specified by firstPageNumber and lastPageNumber). Each image will be 100 pixels by 100 pixels. Because maximumGridWidth is 300, and the width of a single image is 100, we will have 3 columns. Because we have 10 images and 3 columns, we can calculate that we will need four rows. Our images will look like this:

Full Image - 3 columns, 4 rows 
+----+----+----+ 
| 1  | 2  | 3  | 
+----+----+----+ 
| 4  | 5  | 6  | 
+----+----+----+ 
| 7  | 8  | 9  | 
+----+----+----+ 
| 10 | __ | __ | 
+----+----+----+ 
Requirements

Target Platforms

Help Version 22.0.2023.4.21
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Document Assembly

Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.