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:
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
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.
scUserCancelled |
1 |
Dialog box canceled--user clicked Cancel |
paramErr |
-50 |
Invalid parameter value |