LFileSettings::SetPCDResolution

#include "ltwrappr.h"

static L_INT LFileSettings::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. Possible 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 LFileSettings::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.

See Also

Functions:

LFile::GetInfo, LMemoryFile::GetInfo, LFile::ReadComment, LFileSettings::GetPCDResolution, LFileSettings::GetWMFResolution, LFileSettings::SetWMFResolution, LFileSettings::GetExtFileOption, LFileSettings::SetExtFileOption, LFileSettings::GetComment, LFileSettings::SetComment, LFileSettings::GetViewMode2D, LFileSettings::GetViewPort2D, LFileSettings::SetViewMode2D, LFileSettings::SetViewPort2D, LFileSettings::GetWMFResolutionExt, LFileSettings::SetWMFResolutionExt

Topics:

Raster Image Functions: Input and Output

 

Loading and Saving Images

For a list of functions that use either the LOADFILEOPTION structure or the SAVEFILEOPTION structure, refer to Functions Utilizing the LOADFILEOPTION or SAVEFILEOPTION Structures.

Example

For an example, refer to LFileSettings::GetPCDResolution.