Fejlessze a képfeldolgozást a Modern API-val

Bevezetés

Történelmileg az Aspose Slides függ a android.graphics-tól, és a nyilvános API-jában a következő osztályok találhatók onnan:

A 24.4-es verziótól kezdve ez a nyilvános API elavultnak van nyilvánítva.

Az ilyen osztályokhoz való függőségek megszüntetése érdekében hozzáadtuk az úgynevezett “Modern API”-t – vagyis az API-t, amelyet a deprecated helyett kell használni, és amelynek aláírásai függnek a Bitmap-tól. A Canvas elavultnak van nyilvánítva, és támogatása eltávolításra került a nyilvános Slides API-ból.

Az aktuális verziókban a android.graphics típusokra támaszkodó nyilvános API-t tekintse örököltnek/elavultnak. Új kódhoz és a meglévő képfeldolgozó munkafolyamatok átmigrálásához használja a Modern API-t.

Modern API

A következő osztályokat és felsorolásokat adtuk hozzá a nyilvános API-hoz:

IImage – a raszteres vagy vektorgrafikus képet képviseli.
ImageFormat – a kép fájlformátumát jelöli.
Images – módszerek az IImage interfész példányosításához és használatához.

Felhívjuk a figyelmet, hogy az IImage felszabadítható, és használata után dispose() hívást vagy más kényelmes erőforrás-felszabadítási mintát kell alkalmazni.

Használja a getImage metódust egyetlen dia vagy alakzat rendereléséhez. A getImages metódus több diát renderel. Használja az Images metódusait a képek betöltéséhez, a addImage-et az IImage‑el a prezentációhoz való hozzáadáshoz, és a replaceImage-et az IImage‑el egy meglévő prezentációs kép frissítéséhez.

Egy tipikus szituáció az új API használatára a következőképpen nézhet ki:

Presentation pres = new Presentation();
try {
    IPPImage ppImage;
    // példányosít egy felszabadítható IImage példányt a lemezen lévő fájlból.
    IImage image = Images.fromFile("image.png");
    try {
        // létrehoz egy PowerPoint képet az IImage példány prezentáció képeihez való hozzáadásával.
        ppImage = pres.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }

    // képes alakzatot ad hozzá az 1. diára
    pres.getSlides().get_Item(0).getShapes().addPictureFrame(ShapeType.Rectangle, 10, 10, 100, 100, ppImage);

    // lekér egy IImage példányt, amely az 1. diát képviseli.
    IImage slideImage = pres.getSlides().get_Item(0).getImage(new Size(1920, 1080));
    try {
        // elmenti a képet a lemezre.
        slideImage.save("slide1.jpeg", ImageFormat.Jpeg);
    } finally {
        if (slideImage != null) slideImage.dispose();
    }
} finally {
    if (pres != null) pres.dispose();
}

A régi kód cseréje a Modern API-val

Általánosságban a Bitmap használatával történő hívásokat az IImage‑et használó új metódusokra kell cserélni.

Legacy/elavult API:

Presentation pres = new Presentation();
try {
    Bitmap slideImage = pres.getSlides().get_Item(0).getThumbnail(new Size(1920, 1080));
    FileOutputStream fos = null;
    try {
        fos = new FileOutputStream("image.png");
        slideImage.compress(android.graphics.Bitmap.CompressFormat.PNG, 100, fos);
    } catch (FileNotFoundException e) {
        e.printStackTrace();
    } finally {
        if (fos != null) {
            try {
                fos.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }
} finally {
    if (pres != null) pres.dispose();
}

Modern API:

Presentation pres = new Presentation();
try {
    IImage slideImage = pres.getSlides().get_Item(0).getImage(new Size(1920, 1080));
    try {
        slideImage.save("image.png", ImageFormat.Png);
    } finally {
        if (slideImage != null) slideImage.dispose();
    }
} finally {
    if (pres != null) pres.dispose();
}

Dia bélyegkép lekérése

Legacy/elavult API:

Presentation pres = new Presentation("pres.pptx");
try {
    Bitmap slideImage = pres.getSlides().get_Item(0).getThumbnail();
    FileOutputStream fos = null;
    try {
        fos = new FileOutputStream("slide1.png");
        slideImage.compress(android.graphics.Bitmap.CompressFormat.PNG, 100, fos);
    } catch (FileNotFoundException e) {
        e.printStackTrace();
    } finally {
        if (fos != null) {
            try {
                fos.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }
} finally {
    if (pres != null) pres.dispose();
}

Modern API:

Presentation pres = new Presentation("pres.pptx");
try {
    IImage slideImage = pres.getSlides().get_Item(0).getImage();
    try {
        slideImage.save("slide1.png", ImageFormat.Png);
    } finally {
        if (slideImage != null) slideImage.dispose();
    }
} finally {
    if (pres != null) pres.dispose();
}

Alakzat bélyegkép lekérése

Legacy/elavult API:

Presentation pres = new Presentation("pres.pptx");
try {
    Bitmap shapeImage = pres.getSlides().get_Item(0).getShapes().get_Item(0).getThumbnail();
    FileOutputStream fos = null;
    try {
        fos = new FileOutputStream("shape.png");
        shapeImage.compress(android.graphics.Bitmap.CompressFormat.PNG, 100, fos);
    } catch (FileNotFoundException e) {
        e.printStackTrace();
    } finally {
        if (fos != null) {
            try {
                fos.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }
} finally {
    if (pres != null) pres.dispose();
}

Modern API:

Presentation pres = new Presentation("pres.pptx");
try {
    IImage shapeImage = pres.getSlides().get_Item(0).getShapes().get_Item(0).getImage();
    try {
        shapeImage.save("shape.png");
    } finally {
        if (shapeImage != null) shapeImage.dispose();
    }
} finally {
    if (pres != null) pres.dispose();
}

Prezentáció bélyegkép lekérése

Legacy/elavult API:

Presentation pres = new Presentation("pres.pptx");
try {
    Bitmap[] bitmaps = pres.getThumbnails(new RenderingOptions(), new Size(1980, 1028));
    for (int index = 0; index < bitmaps.length; index++)
    {
        android.graphics.Bitmap thumbnail = bitmaps[index];
        FileOutputStream fos = null;
        try {
            fos = new FileOutputStream("slide" + index + ".png");
            thumbnail.compress(android.graphics.Bitmap.CompressFormat.PNG, 100, fos);
        } catch (FileNotFoundException e) {
            e.printStackTrace();
        } finally {
            if (fos != null) {
                try {
                    fos.close();
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }
        }
    }
} finally {
    if (pres != null) pres.dispose();
}

Modern API:

Presentation pres = new Presentation("pres.pptx");
try {
    IImage[] images = pres.getImages(new RenderingOptions(), new Size(1980, 1028));
    try
    {
        for (int index = 0; index < images.length; index++)
        {
            IImage thumbnail = images[index];
            thumbnail.save("slide" + index + ".png", ImageFormat.Png);
        }
    }
    finally
    {
        for (IImage image : images)
        {
            image.dispose();
        }
    }
} finally {
    if (pres != null) pres.dispose();
}

Kép hozzáadása a prezentációhoz

Legacy/elavult API:

Presentation pres = new Presentation();
try {
    IPPImage ppImage = null;
    File file = new File("image.png");
    Bitmap bitmap = BitmapFactory.decodeFile(file.getAbsolutePath());
    ppImage = pres.getImages().addImage(bitmap);

    pres.getSlides().get_Item(0).getShapes().addPictureFrame(ShapeType.Rectangle, 10, 10, 100, 100, ppImage);
} finally {
    if (pres != null) pres.dispose();
}

Modern API:

Presentation pres = new Presentation();
try {
    IPPImage ppImage;
    IImage image = Images.fromFile("image.png");
    try {
        ppImage = pres.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }

    pres.getSlides().get_Item(0).getShapes().addPictureFrame(ShapeType.Rectangle, 10, 10, 100, 100, ppImage);
} finally {
    if (pres != null) pres.dispose();
}

Elavult metódusok és helyettesítéseik a Modern API-ban

Presentation

Metódus aláírás	Helyettesítő metódus aláírás
public final Bitmap[] getThumbnails(IRenderingOptions options)	public final IImage[] getImages(IRenderingOptions options)
public final Bitmap[] getThumbnails(IRenderingOptions options, Size imageSize)	public final IImage[] getImages(IRenderingOptions options, Size imageSize)
public final Bitmap[] getThumbnails(IRenderingOptions options, float scaleX, float scaleY)	public final IImage[] getImages(IRenderingOptions options, float scaleX, float scaleY)
public final Bitmap[] getThumbnails(IRenderingOptions options, int[] slides)	public final IImage[] getImages(IRenderingOptions options, int[] slides)
public final Bitmap[] getThumbnails(IRenderingOptions options, int[] slides, Size imageSize)	public final IImage[] getImages(IRenderingOptions options, int[] slides, Size imageSize)
public final Bitmap[] getThumbnails(IRenderingOptions options, int[] slides, float scaleX, float scaleY)	public final IImage[] getImages(IRenderingOptions options, int[] slides, float scaleX, float scaleY)

Shape

Metódus aláírás	Helyettesítő metódus aláírás
public final Bitmap getThumbnail()	public final IImage getImage()
public final Bitmap getThumbnail(int bounds, float scaleX, float scaleY)	public final IImage getImage(int bounds, float scaleX, float scaleY)

Slide

Metódus aláírás	Helyettesítő metódus aláírás
public final Bitmap getThumbnail()	public final IImage getImage()
public final Bitmap getThumbnail(Size imageSize)	public final IImage getImage(Size imageSize)
public final Bitmap getThumbnail(float scaleX, float scaleY)	public final IImage getImage(float scaleX, float scaleY)
public final Bitmap getThumbnail(IRenderingOptions options)	public final IImage getImage(IRenderingOptions options)
public final Bitmap getThumbnail(IRenderingOptions options, Size imageSize)	public final IImage getImage(IRenderingOptions options, Size imageSize)
public final Bitmap getThumbnail(IRenderingOptions options, float scaleX, float scaleY)	public final IImage getImage(IRenderingOptions options, float scaleX, float scaleY)
public final Bitmap getThumbnail(ITiffOptions options)	public final IImage getImage(ITiffOptions options)
public final void renderToGraphics(IRenderingOptions options, Canvas graphics)	No Modern API replacement
public final void renderToGraphics(IRenderingOptions options, Canvas graphics, Size renderingSize)	No Modern API replacement
public final void renderToGraphics(IRenderingOptions options, Canvas graphics, float scaleX, float scaleY)	No Modern API replacement

Output

Metódus aláírás	Helyettesítő metódus aláírás
public final IOutputFile add(String path, Bitmap image)	public final IOutputFile add(String path, IImage image)

ImageCollection

Metódus aláírás	Helyettesítő metódus aláírás
public final IPPImage addImage(Bitmap image)	public final IPPImage addImage(IImage image)

PPImage

Metódus aláírás	Helyettesítő metódus aláírás
public final Bitmap getSystemImage()	public final IImage getImage()

PatternFormat

Metódus aláírás	Helyettesítő metódus aláírás
public final Bitmap getTileImage(Integer styleColor)	public final IImage getTile(Integer styleColor)
public final Bitmap getTileImage(Integer background, Integer foreground)	public final IImage getTile(Integer background, Integer foreground)

PatternFormatEffectiveData

Metódus aláírás	Helyettesítő metódus aláírás
public final Bitmap getTileImage(Integer background, Integer foreground)	public final IImage getTileIImage(Integer background, Integer foreground)

Canvas támogatás az API-ban

Az Canvas használatával rendelkező metódusok elavultnak vannak nyilvánítva, és nincs közvetlen Modern API helyettesítőjük.

Használja a Modern API kép-renderelési metódusait a Canvas felé renderelő API helyett:

Slide

FAQ

Miért került a android.graphics.Canvas mellőzésre?

Az Canvas támogatása elavult a nyilvános API-ban, hogy egységesítsük a renderelést és a képek kezelését, megszüntessük a platformfüggő függőségeket, és a IImage felé való átállást egy cross-platform megközelítéssel. Használja a getImage vagy getImages metódusokat a Canvas helyett.

Mi a gyakorlati előnye az [IImage] használatának a [Bitmap]-hez képest?

Az [IImage] egységesíti a raszteres és vektorgrafikus képek kezelését, és egyszerűsíti a különféle formátumokba való mentést a ImageFormat segítségével.

A Modern API befolyásolja a bélyegképek generálásának teljesítményét?

A getThumbnail-ról getImage-re való áttérés nem rontja a teljesítményt: az új metódusok ugyanazt a funkcionalitást biztosítják képek előállításához opciókkal és méretekkel, miközben megőrzik a renderelési beállítások támogatását. A konkrét nyereség vagy veszteség a szituációtól függ, de funkcionálisan a helyettesítők egyenértékűek.

3D hatások létrehozása prezentációkban Androidon VBA projektek kezelése bemutatókban Androidon