{"id":5610,"date":"2015-02-09T03:08:02","date_gmt":"2015-02-09T11:08:02","guid":{"rendered":"https:\/\/blogs.plm.automation.siemens.com\/t5\/Solid-Edge-Blog\/How-to-export-draft-images\/ba-p\/290473"},"modified":"2026-03-26T07:16:11","modified_gmt":"2026-03-26T11:16:11","slug":"how-to-export-draft-images","status":"publish","type":"post","link":"https:\/\/blogs.sw.siemens.com\/solidedge\/how-to-export-draft-images\/","title":{"rendered":"How to export draft images"},"content":{"rendered":"

Have you ever had a need to export vector graphics<\/A> or raster graphics<\/A> from a draft file? Over my 15 years of working with Solid Edge, I have found myself in that position many, many times. In this post, I’ll cover two possible approaches to accomplishing this task.<\/P>

Background<\/STRONG><\/P>

When a Solid Edge draft file is saved, an Enhanced Metafile (EMF)<\/A> is embedded into the file for each working sheet. The reason Solid Edge does this is so that their lightweight viewer can easily and quickly render a graphical view of the draft. The EMF format is ideal in this scenario as it is lightweight, vector based and scales perfectly when resized rather than distorting like a raster image would.<\/P>

\"revision-manager.png\"<\/P>

If we can aquire these vector images ourselves, a lot of doors open to what we can accomplish. The question is, how do we access these embedded EMF images for our own purposes.<\/P>

For technical details about the EMF format, see the Enhanced Metafile Format Specification<\/A>.<\/EM><\/P>

Option 1 – Solid Edge API + a touch of open source<\/STRONG><\/P>

If we examine the Solid Edge API, in this case draft.tlb, we will find a CopyEMFToClipboard() method available for a Sheet object.<\/P>

\/\/ Generated .IDL file (by the OLE\/COM Object Viewer)
\n\/\/
\n\/\/ typelib filename: draft.tlb
\n[
\n  uuid(3E2B3BDC-F0B9-11D1-BDFD-080036B4D502),
\n  version(1.0),
\n  helpstring(“Solid Edge Draft Type Library”),
\n]
\nlibrary SolidEdgeDraft
\n{
\n\t[
\n\t  uuid(FFB20FA0-339B-11CE-956A-08003601DFE5),
\n\t  helpstring(“Represents a sheet in a document.”),
\n\t  helpcontext(0x00007537)
\n\t]
\n\tdispinterface Sheet {
\n\t\tproperties:
\n\t\tmethods:
\n\t\t\t[id(0x000000de), helpstring(“Copies an enhanced metafile to the operating system clipboard.”), helpcontext(0x0000756c)]
\n\t\t\tvoid CopyEMFToClipboard();
\n\t};
\n};<\/PRE>
The CopyEMFToClipboard() method creates an in-memory EMF and places it on the clipboard in CF_ENHMETAFILE<\/A> format. In order to access the EMF data, we use the GetClipboardData()<\/A> function which returns a pointer to a HMETAFILE. For most (non C++) programmers, everything comes to a screeching halt right there. Unless you have ever dabbled with C++, you likely have no idea how to proceed.<\/P>
Fortunately, it’s 2015 and people actually share code. If you don’t want to dig into the gory details of how to access the EMF on the clipboard, you can easily install the SolidEdge.Community NuGet package<\/A> and leverage pre-built extension methods to gain access to the actual EMF. If you’re not familiar with NuGet, no worries, I’ve got you covered in my How to use NuGet for Solid Edge custom development<\/A> post. If you’re not comfortable using an open source library, no problem! You can view the full source code for SolidEdge.Community on GitHub<\/A>. Specifically for this article, you’ll want to reference SheetExtensions.cs<\/A> and look for the SaveAsEnhancedMetafile() extension method. Extension methods like this enhance the base Solid Edge API by overlaying additional methods to classes like SolidEdgeDraft.Sheet.<\/P>
For an example of how to use the SaveAsEnhancedMetafile() extension method, head over to the Solid Edge Community on GitHub<\/A>. There is a C# sample<\/A> and Visual Basic sample<\/A> available. The following is a short snippet demonstrating the usage.<\/SPAN><\/P>
foreach (SolidEdgeDraft.Sheet sheet in workingSection.Sheets)
\n{
\n    \/\/ Note: SaveAsEnhancedMetafile() is an extension method from SolidEdge.Community.dll.
\n    sheet.SaveAsEnhancedMetafile(emfFileName);
\n}<\/PRE>
I should also mention that the GetEnhancedMetafile() extension method is also available. This will return a .NET friendly System.Drawing.Imaging.Metafile<\/A>.<\/P>
Note that in order to enabled these extension methods, you must use the C# using keyword or the Visual Basic Imports keyword.<\/P>
using SolidEdgeCommunity.Extensions;<\/PRE>
 or<\/P>
Imports SolidEdgeCommunity.Extensions<\/PRE>
Option 2 – Open source only<\/STRONG><\/P>
As an Applications Architect, I often find myself with project requirements that don’t always agree with existing software APIs. For example, I’ve needed to process and export 11,000+ draft files as fast as possible. I’ve also needed to perform this export process in an automated server environment. Automating Solid Edge as shown in Option 1 was not really a (good) option as Solid Edge is a UI application.<\/P>
Considering these requirements, the SolidEdge.Community.Reader NuGet package<\/A> was born. Full source code can be found on the SolidEdge.Community.Reader GitHub page<\/A>. Installing this NuGet package into your project adds a reference to the SolidEdge.Community.Reader.dll assembly. The assembly has the ability to read Solid Edge files natively and perform the same export operation without the need to have Solid Edge running.<\/P>
For an example of how to use the SolidEdge.Community.Reader NuGet package<\/A>, head over to the Solid Edge Community on GitHub<\/A>. There is a C# sample<\/A> and Visual Basic sample<\/A> available. The following is a short snippet demonstrating the usage.<\/SPAN><\/P>
\/\/ Open the file.
\nusing (var draftDocument = DraftDocument.Open(options.FileName))
\n{
\n    \/\/ Process each sheet.
\n    foreach (var sheet in draftDocument.Sheets)
\n    {
\n        \/\/ Save EMF.
\n        sheet.SaveAsEmf(emfFileName);
\n    }
\n}<\/PRE>
In my particular project, using the SolidEdge.Community.Reader NuGet package<\/A> yielded the following results.<\/P>