L_SetPLTOptions (original) (raw)
Summary
Sets the file options used by LEADTOOLS when loading HPGL files.
Syntax
#include "l_bitmap.h"
L_LTFIL_API L_INT L_SetPLTOptions(pOptions)
Parameters
pFILEPLTOPTIONS pOptions
Pointer to a structure that contains the options to use when loading HPGL files.
Returns
| Value | Meaning |
|---|---|
| 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:
| 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.
See Also
Functions
Topics
- Raster Image Functions: Loading Files
- Loading and Saving Images
- Using Color Values in LEADTOOLS
- For a list of functions that utilize the LOADFILEOPTION or SAVEFILEOPTION structures, refer to the Usage section of their documentation.
Example
This example loads a PLT file, with a pen widths and pen colors defined by the user
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;
}
LEADTOOLS Raster Imaging C API Help