TdxCustomSmartImage.ConvertToBitmap Method

Rasterizes the stored vector image.

Declaration

procedure ConvertToBitmap;

Remarks

Call the ConvertToBitmap procedure to rasterize the stored vector image.

A ConvertToBitmap procedure call has no effect if the Empty property returns True or the ImageCodec property is set to any other value than TdxSVGImageCodec.

Code Example: Insert an Image to a Rich Text Document

The following code example allows users to select an image in any format and insert the image at the end of a document opened in a TdxRichEditControl:

Delphi

uses
  dxGDIPlusClasses, // Declares the TdxSmartImage class
  dxSVGImage;  // Declares the TdxSVGImageCodec class
//...
procedure TMyForm.cxButton1Click(Sender: TObject);
var
  ADocument: IdxRichEditDocument;
  AImageContainer: TdxSmartImage;
  AFileName: string;
begin
  ADocument := dxRichEditControl1.Document;
  dxOpenPictureDialog1.Execute(Handle);  // Invokes the "Open" dialog for image file selection
  AFileName := dxOpenPictureDialog1.FileName;
  if (AFileName = '') then Exit;  // Exits the procedure if a user selects no image
  AImageContainer := TdxSmartImage.Create;  // Creates a Smart Image container
  try
    AImageContainer.LoadFromFile(AFileName);
    if (AImageContainer.ImageCodec = TdxSVGImageCodec) then  // If the container stores an SVG image
      AImageContainer.ConvertToBitmap;  // Rasterizes the vector image
    ADocument.Images.Append(AImageContainer);  // Creates a new inline image from the stored bitmap
  finally
    AImageContainer.Free;  // Destroys the Smart Image container to prevent memory leaks
  end;
end;

C++

#include "dxGDIPlusClasses.hpp"  // Declares the TdxSmartImage class
#include "dxSVGImage.hpp"  // Declares the TdxSVGImageCodec class
//...
void __fastcall TMyForm::cxButton1Click(Sender: TObject)
{
  _di_IdxRichEditDocument ADocument;
  TdxSmartImage *AImageContainer;
  UnicodeString AFileName;
  // ...
  ADocument = dxRichEditControl1->Document;
  dxOpenPictureDialog1->Execute(Handle);  // Invokes the "Open" dialog for image file selection
  AFileName = dxOpenPictureDialog1->FileName;
  if (AFileName == "") { return; }  // Exits the routine if a user selects no image
  AImageContainer = new TdxSmartImage();  // Creates a Smart Image container
  try
  {
    AImageContainer->LoadFromFile(AFileName);
    if (AImageContainer->ImageCodec == __classid(TdxSVGImageCodec))  // If the container stores an SVG image
      AImageContainer->ConvertToBitmap();  // Rasterizes the vector image
    ADocument->Images->Append(AImageContainer);  // Creates a new inline image from the stored bitmap
  }
  __finally
  {
    delete AImageContainer;  // Destroys the Smart Image container to prevent memory leaks
  }
}

Limitations

Vector image rasterization is irreversible, since Smart Image containers cannot vectorize bitmaps.