L_SetPCDResolution

#include "l_bitmap.h"

L_LTFIL_API L_INT L_SetPCDResolution(nResolution)

L_INT nResolution;

/* resolution for loading or to use in conversion */

Sets the resolution to be used for loading or converting a PhotoCD file.

Parameter

Description

nResolution

Integer indicating the resolution to load or use in conversion. Valid values for nResolution are:

 

Value

Meaning

 

L_PCD_BASE_OVER_64

[0] Resolution 64 x 96

 

L_PCD_BASE_OVER_16

[1] Resolution 128 x 192

 

L_PCD_BASE_OVER_4

[2] Resolution 256 x 384

 

L_PCD_BASE

[3] Resolution 512 x 768

 

L_PCD_4BASE

[4] Resolution 1024 x 1536

 

L_PCD_16BASE

[5] Resolution 2048 x 3072

Returns

SUCCESS

The function was successful.

-13 (ERROR_INV_PARAMETER)

nResolution was not a valid value.

Comments

Use this function after L_GetPCDResolution (which determines valid resolutions of the file) and prior to loading or converting a PhotoCD file. If this function is not used, the default resolution of 512 x 768 will be used.

Note:

If this function is used at any time, the resolution selected will be used until this function is called to select a new resolution, or to reset the resolution to a default value.

Note:

More options are available in the LOADFILEOPTION structure.

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

Windows 2000 / XP/Vista.

See Also

Functions:

L_FileInfo, L_FileInfoMemory, L_ReadFileComment, L_GetPCDResolution, L_GetWMFResolution, L_SetWMFResolution, L_SetLoadInfoCallback, L_GetComment, L_SetComment, L_2DGetViewMode, L_2DGetViewPort, L_2DSetViewMode, L_2DSetViewPort

Topics:

Raster Image Functions: Input and Output

 

Loading and Saving Images

 

For a list of functions that utilize the LOADFILEOPTION or SAVEFILEOPTION structures, refer to Functions Utilizing the LOADFILEOPTION or SAVEFILEOPTION structures.

Example

For an example, refer to L_GetPCDResolution.