# Zlepšení zpracování obrázků pomocí Moderního API

> Modernizujte zpracování obrázků snímků nahrazením zastaralých API pro práci s obrázky pomocí .NET Moderního API pro bezproblémovou automatizaci PowerPointu a OpenDocument.

Source: https://docs.aspose.com/slides/cs/net/modern-api/
Updated: 2026-06-12

## **Úvod**

Historicky má Aspose Slides závislost na System.Drawing a v veřejném API obsahuje následující třídy z této knihovny:
- [Graphics](https://learn.microsoft.com/en-us/dotnet/api/system.drawing.graphics)
- [Image](https://learn.microsoft.com/en-us/dotnet/api/system.drawing.image)
- [Bitmap](https://learn.microsoft.com/en-us/dotnet/api/system.drawing.bitmap)
- [PrinterSettings](https://learn.microsoft.com/en-us/dotnet/api/system.drawing.printing.printersettings)

Od verze 24.4 je toto veřejné API označeno jako zastaralé.

Jelikož podpora System.Drawing ve verzích .NET6 a vyšších byla odstraněna pro ne‑Windows verze ([breaking change](https://learn.microsoft.com/en-us/dotnet/core/compatibility/core-libraries/6.0/system-drawing-common-windows-only)), Slides implementoval dvoubalíčkový přístup:
- [Aspose.Slides.NET](https://www.nuget.org/packages/Aspose.Slides.NET) – podpora pro .NET6+ na Windows, .NETStandard pro Windows/Linux/macOS, .NETFramework 2+ (Windows).  
  - závisí na [System.Drawing.Common](https://www.nuget.org/packages/System.Drawing.Common/).
- [Aspose.Slides.NET6.CrossPlatform](https://www.nuget.org/packages/Aspose.Slides.NET6.CrossPlatform) – verze pro Windows/Linux/macOS bez externích závislostí.

Nevýhodou [Aspose.Slides.NET6.CrossPlatform](https://www.nuget.org/packages/Aspose.Slides.NET6.CrossPlatform) je, že implementuje vlastní verzi System.Drawing ve stejném jmenném prostoru (kvůli zpětné kompatibilitě s veřejným API). Proto při současném použití Aspose.Slides.NET6.CrossPlatform a System.Drawing z .NET Framework nebo balíčku System.Drawing.Common dochází ke konfliktu názvů, pokud není použita aliasace.

Abychom se zbavili závislostí na System.Drawing v hlavním balíčku Aspose.Slides.NET, přidali jsme takzvané „Moderní API“ – tj. API, které má být použito místo zastaralého, jehož signatury obsahují závislosti na typech [Image](https://learn.microsoft.com/en-us/dotnet/api/system.drawing.image) a [Bitmap](https://learn.microsoft.com/en-us/dotnet/api/system.drawing.bitmap). [PrinterSettings](https://learn.microsoft.com/en-us/dotnet/api/system.drawing.printing.printersettings) a [Graphics](https://learn.microsoft.com/en-us/dotnet/api/system.drawing.graphics) jsou označeny jako zastaralé a jejich podpora je z veřejného API Slides odstraněna.

V současných verzích považujte veřejné API závislé na System.Drawing za legacy/zastaralé. Používejte Moderní API pro nový kód i při migraci existujících workflow zpracování obrázků.

## **Moderní API**

Do veřejného API byly přidány následující třídy a výčty:

- [Aspose.Slides.IImage](https://reference.aspose.com/slides/cs/net/aspose.slides/iimage/) – představuje rastrový nebo vektorový obrázek.
- [Aspose.Slides.ImageFormat](https://reference.aspose.com/slides/cs/net/aspose.slides/imageformat/) – představuje formát souboru obrázku.
- [Aspose.Slides.Images](https://reference.aspose.com/slides/cs/net/aspose.slides/images/) – metody pro vytvoření a práci s rozhraním [IImage](https://reference.aspose.com/slides/cs/net/aspose.slides/iimage/).

Všimněte si, že [IImage](https://reference.aspose.com/slides/cs/net/aspose.slides/iimage/) je disposable (implementuje rozhraní [IDisposable](https://learn.microsoft.com/en-us/dotnet/api/system.idisposable) a jeho použití by mělo být obaleno pomocí `using` nebo uvolněno jiným vhodným způsobem).

Použijte `GetImage` pro vykreslení jedné snímku nebo tvaru. Použijte `GetImages` pro vykreslení několika snímků prezentace. Použijte metody [Images](https://reference.aspose.com/slides/cs/net/aspose.slides/images/) k načtení obrázků, `AddImage` s [IImage](https://reference.aspose.com/slides/cs/net/aspose.slides/iimage/) pro jejich přidání do prezentace a `ReplaceImage` s [IImage](https://reference.aspose.com/slides/cs/net/aspose.slides/iimage/) pro aktualizaci existujícího obrázku v prezentaci.

Typický scénář použití nového API může vypadat následovně:

``` csharp
using (Presentation pres = new Presentation())
{
    IPPImage ppImage;
    // vytvořte odpadatelnou instanci IImage ze souboru na disku.  
    using (IImage image = Images.FromFile("image.png"))
    {
        // vytvořte obrázek PowerPoint tím, že přidáte instanci IImage do obrázků prezentace.
        ppImage = pres.Images.AddImage(image);
    }

    // přidejte obrázkový tvar na snímek #1
    pres.Slides[0].Shapes.AddPictureFrame(ShapeType.Rectangle, 10, 10, 100, 100, ppImage);

    // získáte instanci IImage představující snímek #1.
    using (var slideImage = pres.Slides[0].GetImage(new Size(1920, 1080)))
    {
        // uložte obrázek na disk.
        slideImage.Save("slide1.jpeg", ImageFormat.Jpeg);
    }
}
```

## **Nahrazení starého kódu moderním API**

Pro usnadnění přechodu rozhraní nového [IImage](https://reference.aspose.com/slides/cs/net/aspose.slides/iimage/) opakuje samostatné signatury tříd [Image](https://learn.microsoft.com/en-us/dotnet/api/system.drawing.image) a [Bitmap](https://learn.microsoft.com/en-us/dotnet/api/system.drawing.bitmap). V podstatě stačí nahradit volání staré metody používající System.Drawing novou.

### **Získání miniatury snímku**

Legacy/deprecated API:

``` csharp
using (Presentation pres = new Presentation("pres.pptx"))
{
    pres.Slides[0].GetThumbnail().Save("slide1.png");
}
```

Modern API:

``` csharp
using (Presentation pres = new Presentation("pres.pptx"))
{
    pres.Slides[0].GetImage().Save("slide1.png");
}
```

### **Získání miniatury tvaru**

Legacy/deprecated API:

``` csharp
using (Presentation pres = new Presentation("pres.pptx"))
{
    pres.Slides[0].Shapes[0].GetThumbnail().Save("shape.png");
}
```

Modern API:

``` csharp
using (Presentation pres = new Presentation("pres.pptx"))
{
    pres.Slides[0].Shapes[0].GetImage().Save("shape.png");
}
```

### **Získání miniatury prezentace**

Legacy/deprecated API:

``` csharp
using (Presentation pres = new Presentation("pres.pptx"))
{
    var bitmaps = pres.GetThumbnails(new RenderingOptions(), new Size(1980, 1028));
    try
    {
        for (var index = 0; index < bitmaps.Length; index++)
        {
            Bitmap thumbnail = bitmaps[index];
            thumbnail.Save($"slide{index}.png", ImageFormat.Png);
        }
    }
    finally
    {
        foreach (Bitmap bitmap in bitmaps)
        {
            bitmap.Dispose();
        }
    }
}
```

Modern API:

``` csharp
using (Presentation pres = new Presentation("pres.pptx"))
{
    var images = pres.GetImages(new RenderingOptions(), new Size(1980, 1028));
    try
    {
        for (var index = 0; index < images.Length; index++)
        {
            IImage thumbnail = images[index];
            thumbnail.Save($"slide{index}.png", ImageFormat.Png);
        }
    }
    finally
    {
        foreach (IImage image in images)
        {
            image.Dispose();
        }
    }
}
```

### **Přidání obrázku do prezentace**

Legacy/deprecated API:

``` csharp
using (Presentation pres = new Presentation())
{
    IPPImage ppImage;
    using (Image image = Image.FromFile("image.png"))
    {
        ppImage = pres.Images.AddImage(image);
    }

    pres.Slides[0].Shapes.AddPictureFrame(ShapeType.Rectangle, 10, 10, 100, 100, ppImage);
}
```

Modern API:

``` csharp
using (Presentation pres = new Presentation())
{
    IPPImage ppImage;
    using (IImage image = Aspose.Slides.Images.FromFile("image.png"))
    {
        ppImage = pres.Images.AddImage(image);
    }

    pres.Slides[0].Shapes.AddPictureFrame(ShapeType.Rectangle, 10, 10, 100, 100, ppImage);
}
```

## **Zastaralé metody/vlastnosti a jejich náhrada v moderním API**

### **Presentation**
| Podpis metody | Podpis nahrazující metody |
|-------------------------------|---------------------------------------------------------|
| public Bitmap[] GetThumbnails(IRenderingOptions options) | [GetImages(IRenderingOptions options)](https://reference.aspose.com/slides/cs/net/aspose.slides/presentation/getimages#getimages) |
| public Bitmap[] GetThumbnails(IRenderingOptions options, int[] slides) | [GetImages(IRenderingOptions options, int[] slides)](https://reference.aspose.com/slides/cs/net/aspose.slides/presentation/getimages#getimages_1) |
| public Bitmap[] GetThumbnails(IRenderingOptions options, float scaleX, float scaleY) | [GetImages(IRenderingOptions options, float scaleX, float scaleY)](https://reference.aspose.com/slides/cs/net/aspose.slides/presentation/getimages#getimages_4) |
| public Bitmap[] GetThumbnails(IRenderingOptions options, int[] slides, float scaleX, float scaleY) | [GetImages(IRenderingOptions options, int[] slides, float scaleX, float scaleY)](https://reference.aspose.com/slides/cs/net/aspose.slides/presentation/getimages#getimages_2) |
| public Bitmap[] GetThumbnails(IRenderingOptions options, Size imageSize) | [GetImages(IRenderingOptions options, Size imageSize)](https://reference.aspose.com/slides/cs/net/aspose.slides/presentation/getimages) |
| public Bitmap[] GetThumbnails(IRenderingOptions options, int[] slides, Size imageSize) | [GetImages(IRenderingOptions options, int[] slides, Size imageSize)](https://reference.aspose.com/slides/cs/net/aspose.slides/presentation/getimages#getimages_3) |
| public void Save(string fname, SaveFormat format, HttpResponse response, bool showInline) | Žádná náhrada v moderním API |
| public void Save(string fname, SaveFormat format, ISaveOptions options, HttpResponse response, bool showInline) | Žádná náhrada v moderním API |
| public void Print() | Žádná náhrada v moderním API |
| public void Print(PrinterSettings printerSettings) | Žádná náhrada v moderním API |
| public void Print(string printerName) | Žádná náhrada v moderním API |
| public void Print(PrinterSettings printerSettings, string presName) | Žádná náhrada v moderním API |

### **Shape**
| Podpis metody | Podpis nahrazující metody |
|-------------------------------|-----------------------------------|
| public Bitmap GetThumbnail() | [GetImage](https://reference.aspose.com/slides/cs/net/aspose.slides/shape/getimage#getimage) |
| public Bitmap GetThumbnail(ShapeThumbnailBounds bounds, float scaleX, float scaleY) | [GetImage(ShapeThumbnailBounds bounds, float scaleX, float scaleY)](https://reference.aspose.com/slides/cs/net/aspose.slides/shape/getimage#getimage_1) |

### **Slide**
| Podpis metody | Podpis nahrazující metody |
|-------------------------------|-----------------------------------|
| public Bitmap GetThumbnail(float scaleX, float scaleY) | [GetImage(float scaleX, float scaleY)](https://reference.aspose.com/slides/cs/net/aspose.slides/slide/getimage#getimage_5) |
| public Bitmap GetThumbnail() | [GetImage](https://reference.aspose.com/slides/cs/net/aspose.slides/slide/getimage#getimage) |
| public Bitmap GetThumbnail(IRenderingOptions options) | [GetImage(IRenderingOptions options)](https://reference.aspose.com/slides/cs/net/aspose.slides/slide/getimage#getimage_1) |
| public Bitmap GetThumbnail(Size imageSize) | [GetImage(Size imageSize)](https://reference.aspose.com/slides/cs/net/aspose.slides/slide/getimage#getimage_6) |
| public Bitmap GetThumbnail(ITiffOptions options) | [GetImage(ITiffOptions options)](https://reference.aspose.com/slides/cs/net/aspose.slides/slide/getimage#getimage_4) |
| public Bitmap GetThumbnail(IRenderingOptions options, float scaleX, float scaleY) | [GetImage(IRenderingOptions options, float scaleX, float scaleY)](https://reference.aspose.com/slides/cs/net/aspose.slides/slide/getimage#getimage_2) |
| public Bitmap GetThumbnail(IRenderingOptions options, Size imageSize) | [GetImage(IRenderingOptions options, Size imageSize)](https://reference.aspose.com/slides/cs/net/aspose.slides/slide/getimage#getimage_3) |
| public void RenderToGraphics(IRenderingOptions options, Graphics graphics) | Žádná náhrada v moderním API |
| public void RenderToGraphics(IRenderingOptions options, Graphics graphics, float scaleX, float scaleY) | Žádná náhrada v moderním API |
| public void RenderToGraphics(IRenderingOptions options, Graphics graphics, Size renderingSize) | Žádná náhrada v moderním API |

### **Output**
| Podpis metody | Podpis nahrazující metody |
|-------------------------------|-------------------------------------------------------------|
| public IOutputFile Add(string path, Image image) | [Add(string path, IImage image)](https://reference.aspose.com/slides/cs/net/aspose.slides.export.web/output/add#add_1) |

### **ImageCollection**
| Podpis metody | Podpis nahrazující metody |
|-------------------------------|--------------------------------------------|
| IPPImage AddImage(Image image) | [AddImage(IImage image)](https://reference.aspose.com/slides/cs/net/aspose.slides/imagecollection/addimage#addimage) |

### **ImageWrapperFactory**
| Podpis metody | Podpis nahrazující metody |
|-------------------------------|---------------------------------|
| IImageWrapper CreateImageWrapper(Image image) | [CreateImageWrapper(IImage image)](https://reference.aspose.com/slides/cs/net/aspose.slides/imagewrapperfactory/createimagewrapper#createimagewrapper) |

### **PPImage**
| Podpis metody/vlastnosti | Podpis nahrazující metody |
|-------------------------------|-----------------------------------|
| void ReplaceImage(Image newImage) | [ReplaceImage(IImage newImage)](https://reference.aspose.com/slides/cs/net/aspose.slides/ppimage/replaceimage#replaceimage) |
| Image SystemImage { get; } | [IImage Image { get; }](https://reference.aspose.com/slides/cs/net/aspose.slides/ppimage/image) |

### **PatternFormat**
| Podpis metody | Podpis nahrazující metody |
|-------------------------------|-----------------------------------|
| Bitmap GetTileImage(Color background, Color foreground) | [GetTile(Color background, Color foreground)](https://reference.aspose.com/slides/cs/net/aspose.slides/patternformat/gettile#gettile_1) |
| Bitmap GetTileImage(Color styleColor) | [GetTile(Color styleColor)](https://reference.aspose.com/slides/cs/net/aspose.slides/patternformat/gettile#gettile) |

### **IPatternFormatEffectiveData**
| Podpis metody | Podpis nahrazující metody |
|-------------------------------|-----------------------------------|
| Bitmap GetTileImage(Color background, Color foreground) | [GetTileIImage(SlidesImage image)](https://reference.aspose.com/slides/cs/net/aspose.slides/ipatternformateffectivedata/gettileiimage) |

## **Podpora API pro Graphics a PrinterSettings**

Třída [Graphics](https://learn.microsoft.com/en-us/dotnet/api/system.drawing.graphics) není podporována pro cross‑platform verze .NET6 a novější. V Aspose Slides použijte metody renderování obrázků Moderního API místo API, které renderuje do [Graphics](https://learn.microsoft.com/en-us/dotnet/api/system.drawing.graphics):
[ISlide](https://reference.aspose.com/slides/cs/net/aspose.slides/islide/)
- [public void RenderToGraphics(IRenderingOptions options, Graphics graphics)](https://reference.aspose.com/slides/cs/net/aspose.slides/slide/rendertographics/#rendertographics_3)
- [public void RenderToGraphics(IRenderingOptions options, Graphics graphics, float scaleX, float scaleY)](https://reference.aspose.com/slides/cs/net/aspose.slides/slide/rendertographics/#rendertographics_3)
- [public void RenderToGraphics(IRenderingOptions options, Graphics graphics, Size renderingSize)](https://reference.aspose.com/slides/cs/net/aspose.slides/slide/rendertographics/#rendertographics_5)

Také API související s tiskem přes [PrinterSettings](https://learn.microsoft.com/en-us/dotnet/api/system.drawing.printing.printersettings) nemá přímou náhradu v Moderním API:

[IPresentation](https://reference.aspose.com/slides/cs/net/aspose.slides/ipresentation/):
- [public void Presentation.Print](https://reference.aspose.com/slides/cs/net/aspose.slides/presentation/print/#print)
- [public void Print(PrinterSettings printerSettings)](https://reference.aspose.com/slides/cs/net/aspose.slides/presentation/print/#print_1)
- [public void Print(string printerName)](https://reference.aspose.com/slides/cs/net/aspose.slides/presentation/print/#print_3)
- [public void Print(PrinterSettings printerSettings, string presName)](https://reference.aspose.com/slides/cs/net/aspose.slides/presentation/print/#print_2)

## **Často kladené otázky**

**Proč bylo [Graphics](https://learn.microsoft.com/en-us/dotnet/api/system.drawing.graphics) odstraněno?**

Podpora [Graphics](https://learn.microsoft.com/en-us/dotnet/api/system.drawing.graphics) je v veřejném API označena jako zastaralá, aby se sjednotila práce s renderováním a obrázky, eliminovaly se vazby na platformně specifické závislosti a přešlo se na cross‑platform přístup s [IImage](https://reference.aspose.com/slides/cs/net/aspose.slides/iimage/). Používejte `GetImage` nebo `GetImages` místo renderování do [Graphics](https://learn.microsoft.com/en-us/dotnet/api/system.drawing.graphics).

**Jaký je praktický přínos [IImage](https://reference.aspose.com/slides/cs/net/aspose.slides/iimage/) oproti [Image](https://learn.microsoft.com/en-us/dotnet/api/system.drawing.image)/[Bitmap](https://learn.microsoft.com/en-us/dotnet/api/system.drawing.bitmap)?**

[IImage](https://reference.aspose.com/slides/cs/net/aspose.slides/iimage/) sjednocuje práci s rastrovými i vektorovými obrázky, zjednodušuje ukládání do různých formátů pomocí [ImageFormat](https://reference.aspose.com/slides/cs/net/aspose.slides/imageformat/), snižuje závislost na `System.Drawing` a činí kód přenosnějším mezi prostředími.

**Ovlivní Moderní API výkon při generování miniatur?**

Přepnutí z `GetThumbnail` na `GetImage` výkon nesnižuje. Nové metody nabízejí stejné možnosti tvorby obrázků s volbami a velikostmi a zachovávají podporu pro renderovací možnosti. Konkrétní zisk či pokles výkonu závisí na scénáři, ale funkčně jsou náhrady ekvivalentní.