L_SetPLTOptions

#include "l_bitmap.h"

L_LTFIL_API L_INT L_SetPLTOptions(pOptions)

pointer to a structure

Sets the file options used by LEADTOOLS when loading HPGL files.

Parameter	Description
pOptions	Pointer to a structure that contains the options to use when loading HPGL files.

Returns

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

Comments

The nSize member of the FILEPLTOPTIONS structure must be set before calling this function. If an HPGL file is loaded without first calling this function, the following default values will be used:

FILEPLTOPTIONS Member:	Default value:
PenWidth[0]	1
PenWidth[1]	1
PenWidth[2]	1
PenWidth[3]	1
PenWidth[4]	1
PenWidth[5]	1
PenWidth[6]	1
PenWidth[7]	1
PenColor[0]	0x00FFFFFF
PenColor[1]	0x00000000
PenColor[2]	0x000000FF
PenColor[3]	0x0000FF00
PenColor[4]	0x0000FFFF
PenColor[5]	0x00FF0000
PenColor[6]	0x00FF00FF
PenColor[7]	0x00FFFF00
bPenColorOverride	FALSE

The values set by this function are valid for the current thread. To change the values used by the current thread, this function must be called again.

Required DLLs and Libraries

LTFIL
File format DLLs

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 loads a PLT file, with a pen widths and pen colors defined by the user

#define MAKE_IMAGE_PATH(pFileName) TEXT("C:\\Users\\Public\\Documents\\LEADTOOLS Images\\")pFileName 
L_INT SetPLTOptionsExample(L_TCHAR     * pszPLTFileName, 
pBITMAPHANDLE pBitmap, 
L_INT       * pPenWidths, 
COLORREF    * pPenColors) 
{ 
   L_INT nRet; 
   FILEPLTOPTIONS PltOptions; 
   L_INT  nPen; 
   /* Get the current PLT options */ 
   nRet = L_GetPLTOptions(&PltOptions, sizeof(FILEPLTOPTIONS)); 
   if(nRet != SUCCESS) 
      return nRet; 
   for ( nPen = 0; nPen <  8; nPen++ ) 
   { 
      /*Change pen width */ 
      PltOptions.PenWidth[nPen] = pPenWidths[nPen]; 
      /* Change pen color*/ 
      PltOptions.PenColor[nPen] = pPenColors[nPen]; 
   } 
   /* Set new PLT options */ 
   nRet = L_SetPLTOptions(&PltOptions); 
   if(nRet != SUCCESS) 
      return nRet; 
   /* Now load the PLT file */ 
   if(pBitmap->Flags.Allocated) 
      L_FreeBitmap(pBitmap); 
   nRet = L_LoadBitmap(pszPLTFileName, 
   pBitmap, 
   sizeof(BITMAPHANDLE), 
   0, 
   ORDER_RGB, 
   NULL, 
   NULL); 
   if(nRet != SUCCESS) 
      return nRet; 
   nRet = L_SaveBitmap(MAKE_IMAGE_PATH(TEXT("Result.BMP")), pBitmap, FILE_BMP, 24, 0, NULL); 
   if(nRet != SUCCESS) 
      return nRet; 
   return SUCCESS; 
}

Help Version 19.0.2017.10.27

Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C API Help

Introduction

Version History

Getting Started

LEADTOOLS Raster Imaging Features

Redistributables/Files To Be Included With Your Application

Functions:	L_GetPLTOptions
Topics:	Raster Image Functions: Loading Files
	Loading and Saving Images
	Using Color Values in LEADTOOLS