Displaying the Standard Image-Compression Dialog Box

Standard image-compression dialog components provide two functions that allow you to display the standard dialog box to the user and retrieve the compression parameters specified by the user.

Use the SCRequestImageSettings function to retrieve the user's preferences for compressing a single image; use the SCRequestSequenceSettings functions when you are working with an image sequence.

Both of these functions manipulate the compression settings that the component stores for you. The component may derive the current settings from a number of different sources:

SCRequestImageSettings

The SCRequestImageSettings function displays the standard image dialog box to the user; the dialog box is populated with the default settings you have established.

FUNCTION SCRequestImageSettings(ci as ComponentInstance) as Integer

ci
Identifies your application's connection to a standard image-compression dialog component.

DESCRIPTION

The standard dialog component retrieves and validates the user's selections, and saves the resulting settings for use later.

Use this function when you are working with a single still image.

RESULT CODES

scUserCancelled

1

Dialog box canceled--user clicked Cancel

paramErr

-50

Invalid parameter value