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.