(Tcl) Build a multipart/related MIME Message

Demonstrates how to construct a multipart/related MIME message containing HTML and a related JPG image.

Chilkat Tcl Extension Downloads

Chilkat Tcl Extension Downloads

load ./chilkat.dll

# This example requires the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.

# Start with an empty MIME object...
set mime [new_CkMime]

# Initialize it as multipart/related.
CkMime_NewMultipartRelated $mime

# Set a top-level MIME header field.
CkMime_SetHeaderField $mime "Subject" "Test HTML email with JPG image."

# Generate a Content-ID.  This will contain random data that will allow
# the HTML's "img" tag to reference the image part in the MIME.
set crypt [new_CkCrypt2]

CkCrypt2_put_EncodingMode $crypt "hex"

set sbContentId [new_CkStringBuilder]

CkStringBuilder_Append $sbContentId "part1."
CkStringBuilder_Append $sbContentId [CkCrypt2_genRandomBytesENC $crypt 4]
CkStringBuilder_Append $sbContentId "."
CkStringBuilder_Append $sbContentId [CkCrypt2_genRandomBytesENC $crypt 4]
CkStringBuilder_Append $sbContentId "@chilkatsoft.com"

# Create the HTML body.
set sbHtml [new_CkStringBuilder]

CkStringBuilder_Append $sbHtml "<html><head>\r\n"
CkStringBuilder_Append $sbHtml "<meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\r\n"
CkStringBuilder_Append $sbHtml "  </head>\r\n"
CkStringBuilder_Append $sbHtml "  <body bgcolor=\"#FFFFFF\" text=\"#000000\">\r\n"
CkStringBuilder_Append $sbHtml "    <p>This is a test.&nbsp; <img src=\"cid:CONTENT_ID\" height=\"20\" width=\"20\"></p>\r\n"
CkStringBuilder_Append $sbHtml "  </body>\r\n"
CkStringBuilder_Append $sbHtml "</html>\r\n"
set numReplacements [CkStringBuilder_Replace $sbHtml "CONTENT_ID" [CkStringBuilder_getAsString $sbContentId]]

# Create the HTML MIME part.
set htmlMime [new_CkMime]

CkMime_SetBodyFromHtml $htmlMime [CkStringBuilder_getAsString $sbHtml]
CkMime_put_Encoding $htmlMime "8bit"
CkMime_put_Charset $htmlMime "utf-8"

# Load our JPG image from a file.
set fac [new_CkFileAccess]

set jpgBytes [new_CkByteData]

set success [CkFileAccess_ReadEntireFile $fac "qa_data/jpg/starfish20.jpg" $jpgBytes]

# Create an image/jpeg MIME part.
set jpgMime [new_CkMime]

CkMime_SetBodyFromBinary $jpgMime $jpgBytes
# Setting the following properties has the effect of adding
# the Content-Type, Content-Transfer-Encoding, and Content-Disposition header fields.
# These header fields could also be set via the SetHeaderField method, in which case
# the values of the affected properties would be updated.
CkMime_put_ContentType $jpgMime "image/jpeg"
CkMime_put_Name $jpgMime "starfish20.jpg"
CkMime_put_Encoding $jpgMime "base64"
CkMime_put_Disposition $jpgMime "inline"
CkMime_put_Filename $jpgMime "starfish20.jpg"

set sbContentIdHdr [new_CkStringBuilder]

CkStringBuilder_Append $sbContentIdHdr "<CONTENT_ID>"
set numReplacements [CkStringBuilder_Replace $sbContentIdHdr "CONTENT_ID" [CkStringBuilder_getAsString $sbContentId]]
CkMime_SetHeaderField $jpgMime "Content-ID" [CkStringBuilder_getAsString $sbContentIdHdr]

# Add both parts as children of the multipart/related
CkMime_AppendPart $mime $htmlMime
CkMime_AppendPart $mime $jpgMime
puts [CkMime_getMime $mime]

# --------------------------------------------------------------
# --------------------------------------------------------------
# This example builds the following MIME message.  The boundary
# and Content-ID strings contain random data and will be different.  

# Content-Type: multipart/related; boundary="------------A940F1230E6F0105F03DB2CB"
# Subject: Test HTML email with JPG image.
# 
# --------------A940F1230E6F0105F03DB2CB
# Content-Type: text/html; charset="utf-8"
# Content-Transfer-Encoding: 8bit
# 
# <html><head>
# <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
#   </head>
#   <body bgcolor="#FFFFFF" text="#000000">
#     <p>This is a test.&nbsp; <img src="cid:part1.E16AE3B4.1505C436@chilkatsoft.com" height="20" width="20"></p>
#   </body>
# </html>
# 
# --------------A940F1230E6F0105F03DB2CB
# Content-Transfer-Encoding: base64
# Content-Type: image/jpeg; name="starfish20.jpg"
# Content-Disposition: inline; filename="starfish20.jpg"
# Content-ID: <part1.E16AE3B4.1505C436@chilkatsoft.com>
# 
# /9j/4AAQSkZJRgABAQEASABIAAD//gAmRmlsZSB3cml0dGVuIGJ5IEFkb2JlIFBob3Rvc2hvcD8g
# NC4w/9sAQwAQCwwODAoQDg0OEhEQExgoGhgWFhgxIyUdKDozPTw5Mzg3QEhcTkBEV0U3OFBtUVdf
# YmdoZz5NcXlwZHhcZWdj/9sAQwEREhIYFRgvGhovY0I4QmNjY2NjY2NjY2NjY2NjY2NjY2NjY2Nj
# Y2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2Nj/8IAEQgAFAAUAwERAAIRAQMRAf/EABcAAAMBAAAA
# AAAAAAAAAAAAAAIDBAX/xAAYAQADAQEAAAAAAAAAAAAAAAABAgMEAP/aAAwDAQACEAMQAAAB2kZY
# NNEijWKddfTmLgALWH//xAAbEAACAgMBAAAAAAAAAAAAAAABAgMRAAQSE//aAAgBAQABBQL0XqN+
# pM2aqJGMiqFFCyg7z//EABwRAAICAgMAAAAAAAAAAAAAAAERAAIQIQMSUf/aAAgBAwEBPwHqU5aq
# Axx+y1tMQl4elj//xAAcEQEAAQUBAQAAAAAAAAAAAAABEQACEBIhA1H/2gAIAQIBAT8B3Bhqy7Zc
# enyiwmGgDhiOzj//xAAdEAABAwUBAAAAAAAAAAAAAAABAAIREBIhIkFR/9oACAEBAAY/ArZyn+Cg
# xtxWuJaoCnqDuin/xAAcEAABBAMBAAAAAAAAAAAAAAABABEhYRAxQVH/2gAIAQEAAT8hkEwPUUR9
# DYfE4nxtRpIkBTsayuALIiuY/9oADAMBAAIAAwAAABDWPTsf/8QAGhEAAwADAQAAAAAAAAAAAAAA
# AAEREDFBIf/aAAgBAwEBPxC0DVPcWm+Ce4OesrkE6bjH/8QAGBEBAQEBAQAAAAAAAAAAAAAAAREA
# QRD/2gAIAQIBAT8QahMiOc8YgSrnTY3ELclHXn//xAAcEAEBAAIDAQEAAAAAAAAAAAABEQAhMUFx
# EFH/2gAIAQEAAT8Qn3igmSZSj+c4N4zapMy9IjFV98wncN2iuLFsCEbDGxQkI6RO/n//2Q==
# 
# --------------A940F1230E6F0105F03DB2CB--
# 

delete_CkMime $mime
delete_CkCrypt2 $crypt
delete_CkStringBuilder $sbContentId
delete_CkStringBuilder $sbHtml
delete_CkMime $htmlMime
delete_CkFileAccess $fac
delete_CkByteData $jpgBytes
delete_CkMime $jpgMime
delete_CkStringBuilder $sbContentIdHdr