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: Text “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>

Text “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="">

Aspose.SVG offers SVG Free Web Applications for converting SVG or image files, merging SVG files, image vectorizing, SVG sprite generating, SVG to Base64 data encoding, and text vectorizing. These online Apps work on any operating system with a web browser and don’t require additional software installation. It’s a fast and easy way to efficiently and effectively solve your SVG-related tasks!

Subscribe to Aspose Product Updates

Get monthly newsletters & offers directly delivered to your mailbox.