Convert to Diagram with advanced options Leave feedback

GroupDocs.Conversion provides DiagramConvertOptions for converting between diagram formats. Along with common convert options from the base class, DiagramConvertOptions provides the following additional options:

Convert diagram files with default options:

using (var converter = new Converter("flowchart.vsdx"))
{
    var options = new DiagramConvertOptions();
    converter.Convert("flowchart-copy.vsdx", options);
}

Convert modern Visio format to legacy binary format:

using (var converter = new Converter("network-diagram.vsdx"))
{
    var options = new DiagramConvertOptions
    {
        Format = DiagramFileType.Vsd
    };
    converter.Convert("network-diagram.vsd", options);
}

Modernize legacy Visio files to the current format:

using (var converter = new Converter("legacy-diagram.vsd"))
{
    var options = new DiagramConvertOptions
    {
        Format = DiagramFileType.Vsdx
    };
    converter.Convert("modernized-diagram.vsdx", options);
}

Automatically adjust the page size to fit all drawing content:

using (var converter = new Converter("org-chart.vsdx"))
{
    var options = new DiagramConvertOptions
    {
        AutoFitPageToDrawingContent = true
    };
    converter.Convert("org-chart-autofit.vsdx", options);
}

This feature is useful when:

• Diagrams have content extending beyond page boundaries
• You want to eliminate excessive white space
• Creating PDFs or images with optimal dimensions
• Preparing diagrams for presentations

Convert only selected pages from multi-page diagrams:

using (var converter = new Converter("multi-page-diagram.vsdx"))
{
    var options = new DiagramConvertOptions
    {
        PageNumber = 1,
        PagesCount = 1
    };
    converter.Convert("selected-page.vsdx", options);
}

using (var converter = new Converter("architecture-plans.vsdx"))
{
    var options = new DiagramConvertOptions
    {
        PageNumber = 2,   // Start from page 2
        PagesCount = 3    // Convert 3 pages (pages 2-4)
    };
    converter.Convert("selected-pages.vsdx", options);
}

DiagramConvertOptions works with the following Visio formats:

• VSDX - Visio Drawing (default format for Visio 2013 and later)
• VSSX - Visio Stencil
• VSTX - Visio Template

• VSD - Visio Drawing (binary format)
• VSS - Visio Stencil (binary format)
• VST - Visio Template (binary format)

• VSDM - Visio Macro-Enabled Drawing
• VSSM - Visio Macro-Enabled Stencil
• VSTM - Visio Macro-Enabled Template

• VDX - Visio Drawing XML
• VSX - Visio Stencil XML
• VTX - Visio Template XML

• VDW - Visio Web Drawing

VSDX (Modern Format):

• XML-based open format
• Smaller file sizes (compression)
• Better compatibility with Office 365
• Preferred for new diagrams

VSD (Legacy Format):

• Binary format
• Larger file sizes
• Required for older Visio versions (2010 and earlier)
• Use for backward compatibility

Stencils contain reusable shapes and templates:

• VSS - Legacy stencil format
• VSSX - Modern stencil format
• Used for maintaining consistent diagram elements

Templates provide starting points for new diagrams:

• VST - Legacy template format
• VSTX - Modern template format
• Include predefined layouts and styles

Upgrade legacy Visio files to modern format:

using (var converter = new Converter("legacy-flowchart.vsd"))
{
    var options = new DiagramConvertOptions
    {
        Format = DiagramFileType.Vsdx,
        AutoFitPageToDrawingContent = true
    };
    converter.Convert("modern-flowchart.vsdx", options);
}

Optimize diagrams by auto-fitting content:

using (var converter = new Converter("process-diagram.vsdx"))
{
    var options = new DiagramConvertOptions
    {
        AutoFitPageToDrawingContent = true
    };
    converter.Convert("optimized-diagram.vsdx", options);
}

Extract specific pages from large diagram sets:

using (var converter = new Converter("complete-architecture.vsdx"))
{
    var options = new DiagramConvertOptions
    {
        PageNumber = 5,
        PagesCount = 1
    };
    converter.Convert("network-layer.vsdx", options);
}

Standardize diagram formats across an organization:

string[] diagramFiles = Directory.GetFiles(@"C:\diagrams", "*.vsd");

foreach (var file in diagramFiles)
{
    using (var converter = new Converter(file))
    {
        var options = new DiagramConvertOptions
        {
            Format = DiagramFileType.Vsdx
        };

        string outputFile = Path.ChangeExtension(file, ".vsdx");
        converter.Convert(outputFile, options);
    }
}

Use DiagramConvertOptions when you need to:

• Convert between Visio formats (VSD ↔ VSDX, etc.)
• Modernize legacy diagrams to current Visio format
• Optimize diagram pages with auto-fit functionality
• Extract specific pages from multi-page diagrams
• Standardize diagram formats across projects
• Prepare diagrams for archival or distribution

To convert diagram files to non-diagram formats (PDF, images, documents), use the appropriate ConvertOptions for the target format:

// Convert diagram to PDF
using (var converter = new Converter("flowchart.vsdx"))
{
    var options = new PdfConvertOptions();
    converter.Convert("flowchart.pdf", options);
}

// Convert diagram to PNG images (page by page)
using (var converter = new Converter("org-chart.vsdx"))
{
    var options = new ImageConvertOptions
    {
        Format = ImageFileType.Png
    };
    converter.Convert("org-chart-page.png", options);
}

// Convert diagram to Word document
using (var converter = new Converter("process-flow.vsdx"))
{
    var options = new WordProcessingConvertOptions();
    converter.Convert("process-flow.docx", options);
}

1. Use modern formats (VSDX, VSSX, VSTX) for new diagrams:

   • Better compression
   • Improved compatibility
   • Enhanced features

2. Enable auto-fit when appropriate:

   • Eliminates unnecessary whitespace
   • Optimizes output dimensions
   • Improves readability

3. Convert VSD to VSDX for long-term storage:

   • Smaller file sizes
   • Better archival format
   • Future-proof compatibility

4. Extract pages strategically:

   • Reduce file sizes
   • Focus on specific content
   • Improve processing speed

5. Test macro-enabled conversions:

   • VSDM, VSSM, VSTM contain macros
   • Verify macro requirements in target environment
   • Consider security implications

DiagramConvertOptions provides comprehensive control over diagram format conversions:

• Format conversion: Convert between 13 Visio format types
• Auto-fit functionality: Automatically adjust pages to content
• Page selection: Convert specific pages or page ranges
• Format modernization: Upgrade legacy VSD files to modern VSDX
• Diagram optimization: Optimize page sizes and content fitting

All examples on this page have been verified through automated testing to ensure accuracy.

• Common Conversion Options
• DiagramConvertOptions API Reference
• DiagramFileType API Reference