ClearImage 8 Help
SaveAs Method
See Also  Send Feedback
Inlite.ClearImage Namespace > CiImage Class : SaveAs Method

Save image in new file


Visual Basic (Declaration) 
Public Function SaveAs( _
   ByVal FileName As String, _
   ByVal Format As EFileFormat _
) As Integer
Visual Basic (Usage)Copy Code
Dim instance As CiImage
Dim FileName As String
Dim Format As EFileFormat
Dim value As Integer
value = instance.SaveAs(FileName, Format)
public int SaveAs( 
   string FileName,
   EFileFormat Format
public function SaveAs( 
    FileName: String;
    Format: EFileFormat
): Integer; 
public function SaveAs( 
   FileName : String,
   Format : EFileFormat
) : int;
Managed Extensions for C++ 
public: int SaveAs( 
   string* FileName,
   EFileFormat Format
int SaveAs( 
   String^ FileName,
   EFileFormat Format




This method saves the following image file formats:

  • Bitonal: TIFF, PCX, BMP
  • Color and Grayscale: TIFF, BMP, WMF, JPEG, Targa, PCX, and PICT.

If Format=ciEXT, then the format is derived from file extension of the FileName parameter.

See EFileFormat for list of supported formats. Some formats are "read-only" and are not supported by this method.

Additional formats might be supported. Review current specification at or contact technical support

Some formats use lossy compression. Saving images with those compression methods will modify the saved image as compared to the original image. For JPEG, the amount of JPEG compression is controlled by the JpegQuality parameter.

Not all formats support the range of CiImage. BitsPerPixel values. Prior to being saved, the image is converted to the nearest supported BPP of that particular format. For example, a bitonal image is converted to Grayscale prior to saving as a JPEG format. The saved file image may show severe blocking effects, typical of JPEG. Similarly a Color or Grayscale image is converted to bitonal prior to being saved as a TIFF format.


Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

© 2007-2013. Inlite Research, Inc. All Rights Reserved.