In This Topic ▼

LFileSettings::GetSaveResolution

#include "ltwrappr.h"

static L_INT LFileSettings::GetSaveResolution(puCount, pResolutions)

L_UINT * puCount;	address of the count variable to be updated
pDIMENSION pResolutions;	pointer to the array to be updated

Gets the information saved by the last LFileSettings::SetSaveResolution.

Parameter	Description
puCount	Address of the puCount variable to be updated with the number of resolutions set by LFileSettings::SetSaveResolution.
pResolutions	Pointer to the array of DIMENSION structures to be updated with the physical resolutions set by the last call to LFileSettings::SetSaveResolution. You can pass NULL if you only want to get the number of resolutions.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

Currently, this function only works with the JBIG format.

You must allocate the array to be updated. One way to do this is to declare an array of the maximum size (29 elements). Another way is to call this function twice the first time with NULL in the pResolutions parameter, so that you can get the number of elements and allocate storage of the appropriate size.

For JBIG files, only pResolutions[0].nWidth and pResolutions[0].nHeight are used when a save operation is performed. However, the exact values specified in the last call to LFileSettings::SetSaveResolution are returned.

Required DLLs and Libraries

LTFIL

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64.

Example

This example gets the dimensions set by the last call to LFileSettings::SetSaveResolution and displays them.

L_INT LFileSettings__GetSaveResolutionExample() 
{ 
   L_TCHAR szMessage[256];      // MessageBox string 
   L_UINT uCount; // variable to be updated with the number of resolutions 
   pDIMENSION pDimensions=NULL;// Pointer to the array to be updated 
   HGLOBAL hDimensions=NULL;   // Handle to the buffer for the array 
   L_UINT i;                   // loop variable 
   LFileSettings FileSet; 
   L_INT nRet; 
 
   // Count the number of dimensions 
   nRet = FileSet.GetSaveResolution (&uCount, NULL); 
   if(nRet != SUCCESS) 
      return nRet; 
 
   if((uCount>0)) 
   { 
      // Allocate memory to hold the array of DIMENSION structures 
      hDimensions = GlobalAlloc(GMEM_MOVEABLE, sizeof(DIMENSION)* uCount); 
      pDimensions = (pDIMENSION)GlobalLock( hDimensions ); 
      // Get the information saved by the last LFileSettings::SetSaveResolution 
      nRet = FileSet.GetSaveResolution(&uCount, pDimensions); 
   } 
 
   // Display a message box that shows the available sizes 
   // In the case of JBIG only  pDimensions[0].nWidth, 
   // pDimensions[0].nHeight are valid 
   wsprintf (szMessage,TEXT("Available dimensions:\n")); 
   for(i = 0; i < uCount; ++i) 
   { 
      wsprintf (szMessage,TEXT("%s\n%d x %d"),szMessage, 
      pDimensions[i].nWidth, pDimensions[i].nHeight); 
   } 
 
   ::MessageBox( NULL,szMessage, TEXT("File Information"), MB_OK ); 
   if(hDimensions) 
   { 
      // Free the memory that we allocated 
      GlobalUnlock (hDimensions); 
      GlobalFree (hDimensions); 
   } 
 
   return SUCCESS; 
}

Download our FREE evaluation

Help Version 20.0.2020.4.5

LEADTOOLS Raster Imaging C++ Class Library Help

Introduction

Version History

Getting Started

LEADTOOLS Raster Imaging Features

Redistributables/Files To Be Included With Your Application

Quick Reference

Tutorials

Classes and Member Functions

Summary of Features

Functions:	Class Members
Topics:	Raster Image Functions: Saving Files
	Raster Image Functions: Getting and Setting File Information
	Implementing JBIG Features