IMcFiles Methods

Converts a file from one file type to another, with options. Similiar to McImageLib.McImage.Convert, but with files. Properties: String Source - The directory or filename, with or without tokens, you wish to convert.

This method allows a client to persist the settings of an individual Stream type, for an indivdual context. For example, one could use this method to save the settings of the last ScreenCapture, and these values would be available the next time ScreenCapture is run as the default values. These values would not, however, be the default settings for Convert or for File Open or Save. The pStream parameter is optional, and will override the ImageFiles own member stream. Properties: LPUNKNOWN ContextPropertyBag - The IPropertyBag object in which to save the Settings IMcStream* pStream - [optional] the settings to save, or if NULL, then save the settings of the current McStream.

This method stores an McImage to a file. If the OutputPrefix property is set, that string is used as the base for the file name. Then the method will determine the next OutputNumber to append to the OutputPrefix, and finally the extension of the format indicated by OutputStream. If the Overwrite flag is not set, the method will increment OutputNumber until a unique filename is found. If the Overwrite flag is set, the image is written despite any existing files with the same name. After writing, the OutputNumber is incremented by one. If the OutputPrefix is not set, the FileName of the OutputStream is used as the FileName. The String of the FileName used to store the image is returned in either case.