Combines an existing JPEG with the current IPTC information.
Syntax

[C#]

byte[] Embed(byte[] inData);
string Embed(string inPath);

[Visual Basic]

Function Embed(inData As Byte()) As Byte()
Function Embed(inPath As String) As String
Params
Name Description
inData The raw JPEG data.
inPath A path to the existing JPEG.
return The new JPEG - see below for details.
Notes

Use this method to add the current IPTC information to an existing JPEG. You can specify your JPEG using either a file path or using raw data - an array of bytes.

If you pass this function a path to your JPEG it will return the same path. If you pass this function raw data it will return an array of data representing the new JPEG image.

Example

[C#]string theFile = Server.MapPath("rez/iptc.jpg");
XImageLoadOptions loadOptions = new XImageLoadOptions();
loadOptions.ReadIPTC = true;
XImage image = XImage.FromFile(theFile, loadOptions);
if (image.IPTC != null) {
  image.IPTC.Add("Headline", true).Text = "Oxford University Ball";
  image.IPTC.Add("Caption", true).Text = "What a laugh!";
  image.IPTC.Embed(theFile);
}


[Visual Basic]Dim theFile As String = Server.MapPath("rez/iptc.jpg")
Dim loadOptions As New XImageLoadOptions()
loadOptions.ReadIPTC = True
Dim image As XImage = XImage.FromFile(theFile, loadOptions)
If image.IPTC IsNot Nothing Then
  image.IPTC.Add("Headline", True).Text = "Oxford University Ball"
  image.IPTC.Add("Caption", True).Text = "What a laugh!"
  image.IPTC.Embed(theFile)
End If


The code reads the IPTC information from a JPEG file. It then changes the headline and caption and embeds the changed information into the original file.