SVG Embedded Content

Embedded content is content that imports into the document from another resource. SVG <image> and <foreignObject> elements are used for SVG embedded content support.

Loading and Displaying Bitmaps

The SVG <image> element allows to include and render bitmaps within an SVG object. It can display image formats JPEG, PNG and the SVG pictures too. Attributes of the <image> element indicate that the contents of a file (a bitmap) should be displayed into a given rectangle (“window”) within the current user coordinate system. The main attributes are:

x and y - the coordinates of the top-left image corner.

width and height - the width and the height of the “window” for image render. These attributes are required.

href and xlink:href - points at a URL for the image file.

preserveAspectRatio - controls how the image is scaled.

How to use the SVG <image> element? The following code snippet shows as a .png and .svg images can embed inside the SVG document:

1<svg width="500" height="400" xlink="">
2    <image href="" x="20" y="20" height="180" width="180" />
3    <image href="" x="250" y="10" height="350" width="350" />
4    <text x="40" y="250">Embedded PNG image</text>
5    <text x="300" y="250">Embedded SVG image</text>

The above code snippet is displayed like this: Two images embedded in svg

HTML inside SVG

SVG is designed to be consistent with other XML languages for describing and rendering of embedded content. The <foreignObject> element allows to include in SVG file the elements in a non-SVG namespace. In the context of a browser, it is most likely HTML. The foreign graphical content can be processed with transformations, filters, clipping, masking and compositing.

As attributes, you must specify the x, y coordinates, width and height of the <foreignObject> container. Otherwise, the child elements will not display at all.

Let’s see an example:

 1<svg viewBox="0 0 300 300" xmlns="">
 2    <style>
 3        div {
 4            color: grey;
 5            font: 14px serif;
 6            }
 7    </style>
 8    <circle cx="65" cy="60" r="60" fill="red" fill-opacity="0.1" />
 9    <!-- example of  HTML text embedding in SVG -->
10    <foreignObject x="20" y="20" width="200" height="180">
11    <!--In the context of HTML embedded in the SVG document, the XHTML namespace is mandatory-->
12        <div xmlns="">
13        Convert SVG to PNG. Aspose.SVG for .NET can read and convert SVG files to PNG, PDF, XPS, and major image formats. 
14        </div>
15    </foreignObject>

HTML element embedded in the SVG document

Using the <foreignObject> inside SVG, you need to specify the namespace from which the foreign object originates. In this example, it sets in line 12:

<div xmlns="">