Getting Default Settings for an Image or a Sequence

This section describes the functions that allow you to derive sensible default compression settings for an image or a sequence. The standard dialog component examines an image you provide and selects appropriate default settings based on the image's characteristics. The component stores those settings for you and uses them with other functions, including not only functions governing image or sequence compression, but also utility functions such as SCNewGWorld . If you choose to display a dialog box to the user, the component uses these settings as the default dialog box settings.

Any of these functions may be used with a single image or an image that is part of a sequence. You tell the standard dialog component whether the image is part of a sequence when you call the function.

SCDefaultPictHandleSettings

The SCDefaultPictHandleSettings function allows you to derive default compression settings for a picture that is stored in a handle.

FUNCTION SCDefaultPictHandleSettings(ci as ComponentInstance,srcPicture as PicHandle,motion as Integer) as Integer

ci
Identifies your application's connection to a standard image-compression dialog component. You obtain this identifier from the Component Manager's OpenDefaultComponent function.
srcPicture
Contains a handle to the picture to be analyzed.
motion
Specifies whether the image is part of a sequence. Set this parameter to true if the image is part of a sequence; set it to false if you are working with a single still image.

SCDefaultPictFileSettings

The SCDefaultPictFileSettings function allows you to derive default compression settings for a picture that is stored in a file.

FUNCTION SCDefaultPictFileSettings(ci ComponentInstance, srcRef as Integer,motion as Integer) as Integer

ci
Identifies your application's connection to a standard image-compression dialog component. You obtain this identifier from the Component Manager's OpenDefaultComponent function.
srcRef
Contains a reference to the file to be analyzed.
motion
Specifies whether the image is part of a sequence. Set this parameter to true if the image is part of a sequence; set it to false if you are working with a single still image.

RESULT CODES

File Manager errors