PureBasic

Convert Inline Data-URL Images to Related Parts

Demonstrates the Chilkat Email.ConvertInlineImages method, which converts images embedded inline within HTML (as base64 data URLs) into multipart/related MIME parts referenced from the HTML by cid:. This example sets an HTML body containing a data-URL image and converts it.

Background: HTML can embed an image two ways: as a data: URL (the base64 bytes sit right in the src attribute) or as a related part referenced by cid:. Many email clients don't render data: URLs for security reasons, so converting them to proper multipart/related parts — the traditional email way to embed images — greatly improves how reliably the images display.

Chilkat PureBasic Downloads

Download Chilkat for PureBasic

PureBasic

IncludeFile "CkEmail.pb"

Procedure ChilkatExample()

    success.i = 0

    ;  Demonstrates the ConvertInlineImages method, which converts images embedded inline within
    ;  HTML (as base64 data URLs) into multipart/related MIME parts referenced from the HTML by
    ;  CID.

    email.i = CkEmail::ckCreate()
    If email.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkEmail::setCkSubject(email, "Convert inline images")

    ;  An HTML body with a base64 data-URL image (a 1x1 PNG).
    CkEmail::ckSetHtmlBody(email,"<html><body><img src=" + Chr(34) + "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==" + Chr(34) + "/></body></html>")

    Debug "NumRelatedItems before = " + Str(CkEmail::ckNumRelatedItems(email))

    ;  Convert the inline data-URL image(s) to multipart/related parts referenced by CID.

    success = CkEmail::ckConvertInlineImages(email)
    If success = 0
        Debug CkEmail::ckLastErrorText(email)
        CkEmail::ckDispose(email)
        ProcedureReturn
    EndIf

    Debug "NumRelatedItems after = " + Str(CkEmail::ckNumRelatedItems(email))


    CkEmail::ckDispose(email)


    ProcedureReturn
EndProcedure