เพิ่มประสิทธิภาพการประมวลผลภาพด้วย Modern API

บทนำ

โดยประวัติศาสตร์ Aspose Slides มีการพึ่งพา java.awt และมีใน API สาธารณะคลาสต่อไปนี้จากนั้น:

ตั้งแต่เวอร์ชัน 24.4 API สาธารณะนี้ถูกประกาศให้เป็นรุ่นล้าสมัยแล้ว

เพื่อกำจัดการพึ่งพาเหล่านี้ เราได้เพิ่ม “Modern API” – คือ API ที่ควรใช้แทน API ที่ล้าสมัย ซึ่งลายเซ็นของมันยังคงอ้างอิงถึง BufferedImage ส่วน Graphics2D ถูกประกาศให้เป็นรุ่นล้าสมัยและการสนับสนุนถูกลบออกจาก API สาธารณะของ Slides

ในเวอร์ชันปัจจุบัน ให้ถือ API สาธารณะที่พึ่งพาชนิดจาก java.awt เป็นรุ่นเก่า/ล้าสมัย ใช้ Modern API สำหรับโค้ดใหม่และเมื่อต้องย้ายงานประมวลผลภาพที่มีอยู่

Modern API

เพิ่มคลาสและ enum ต่อไปนี้ไปยัง API สาธารณะ:

  • IImage – แทนภาพแบบ raster หรือ vector
  • ImageFormat – แทนรูปแบบไฟล์ของภาพ
  • Images – วิธีการสร้างและทำงานกับอินเทอร์เฟซ IImage

โปรดทราบว่า IImage เป็นออบเจกต์ที่ต้องทำลายและควรตามด้วยการเรียก dispose() หรือรูปแบบการทำลายที่สะดวกอื่น ๆ

ใช้ getImage เพื่อเรนเดอร์สไลด์หรือรูปร่างเดี่ยว ใช้ getImages เพื่อเรนเดอร์สไลด์หลายหน้า ใช้วิธีการจาก Images เพื่อโหลดภาพ, addImage พร้อม IImage เพื่อเพิ่มลงในพรีเซนเทชัน, และ replaceImage พร้อม IImage เพื่ออัปเดตภาพที่มีอยู่ในพรีเซนเทชัน

ตัวอย่างการใช้ API ใหม่อาจมีลักษณะดังนี้:

Presentation pres = new Presentation();
try {
    IPPImage ppImage;
    // สร้างอินสแตนซ์ IImage ที่สามารถทำลายได้จากไฟล์บนดิสก์.
    IImage image = Images.fromFile("image.png");
    try {
        // สร้างภาพ PowerPoint โดยเพิ่มอินสแตนซ์ของ IImage ลงในคอลเลกชันภาพของพรีเซนเทชัน.
        ppImage = pres.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }

    // เพิ่มรูปร่างรูปภาพบนสไลด์ที่ 1
    pres.getSlides().get_Item(0).getShapes().addPictureFrame(ShapeType.Rectangle, 10, 10, 100, 100, ppImage);

    // รับอินสแตนซ์ของ IImage ที่แสดงสไลด์ที่ 1.
    IImage slideImage = pres.getSlides().get_Item(0).getImage(new Dimension(1920, 1080));
    try {
        // บันทึกภาพลงบนดิสก์.
        slideImage.save("slide1.jpeg", ImageFormat.Jpeg);
    } finally {
        if (slideImage != null) slideImage.dispose();
    }
} finally {
    if (pres != null) pres.dispose();
}

การแทนที่โค้ดเก่าด้วย Modern API

โดยทั่วไป คุณจะต้องแทนที่การเรียกที่ใช้ BufferedImage และ ImageIO ด้วยเมธอดใหม่ที่ใช้ IImage

API รุ่นเก่า/ล้าสมัย:

BufferedImage slideImage = pres.getSlides().get_Item(0).getThumbnail(new Dimension(1920, 1080));
try {
    ImageIO.write(slideImage, "PNG", new File("image.png"));
} catch (IOException e) {
    e.printStackTrace();
}

Modern API:

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

การดึง Thumbnail ของสไลด์

API รุ่นเก่า/ล้าสมัย:

Presentation pres = new Presentation("pres.pptx");
try {
    BufferedImage slideImage = pres.getSlides().get_Item(0).getThumbnail();
    try {
        ImageIO.write(slideImage, "PNG", new File("slide1.png"));
    } 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();
}

การดึง Thumbnail ของรูปร่าง

API รุ่นเก่า/ล้าสมัย:

Presentation pres = new Presentation("pres.pptx");
try {
    BufferedImage shapeImage = pres.getSlides().get_Item(0).getShapes().get_Item(0).getThumbnail();
    try {
        ImageIO.write(shapeImage, "PNG", new File("shape.png"));
    } 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();
}

การดึง Thumbnail ของพรีเซนเทชัน

API รุ่นเก่า/ล้าสมัย:

Presentation pres = new Presentation("pres.pptx");
try {
    BufferedImage[] bitmaps = pres.getThumbnails(new RenderingOptions(), new Dimension(1980, 1028));
    for (int index = 0; index < bitmaps.length; index++)
    {
        try 
        {
            BufferedImage thumbnail = bitmaps[index];
            ImageIO.write(thumbnail, "PNG", new File("slide" + index + ".png"));
        } 
        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 Dimension(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();
}

การเพิ่มรูปภาพลงในพรีเซนเทชัน

API รุ่นเก่า/ล้าสมัย:

Presentation pres = new Presentation();
try {
    IPPImage ppImage = null;
    try {
        BufferedImage bufferedImages = ImageIO.read(new File("image.png"));
        ppImage = pres.getImages().addImage(bufferedImages);
    } catch (IOException e) {
        e.printStackTrace();
    }

    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();
}

เมธอดที่ล้าสมัยและการแทนที่ใน Modern API

Presentation

ลายเซ็นของเมธอด ลายเซ็นเมธอดทดแทน
public final BufferedImage[] getThumbnails(IRenderingOptions options) public final IImage[] getImages(IRenderingOptions options)
public final BufferedImage[] getThumbnails(IRenderingOptions options, float scaleX, float scaleY) public final IImage[] getImages(IRenderingOptions options, float scaleX, float scaleY)
public final BufferedImage[] getThumbnails(IRenderingOptions options, int[] slides) public final IImage[] getImages(IRenderingOptions options, int[] slides)
public final BufferedImage[] getThumbnails(IRenderingOptions options, int[] slides, float scaleX, float scaleY) public final IImage[] getImages(IRenderingOptions options, int[] slides, float scaleX, float scaleY)
public final BufferedImage[] getThumbnails(IRenderingOptions options, int[] slides, Dimension imageSize) public final IImage[] getImages(IRenderingOptions options, int[] slides, Dimension imageSize)
public final BufferedImage[] getThumbnails(IRenderingOptions options, Dimension imageSize) public final IImage[] getImages(IRenderingOptions options, Dimension imageSize)

Shape

ลายเซ็นของเมธอด ลายเซ็นเมธอดทดแทน
public final BufferedImage getThumbnail() public final IImage getImage()
public final BufferedImage getThumbnail(int bounds, float scaleX, float scaleY) public final IImage getImage(int bounds, float scaleX, float scaleY)

Slide

ลายเซ็นของเมธอด ลายเซ็นเมธอดทดแทน
public final BufferedImage getThumbnail() public final IImage getImage()
public final BufferedImage getThumbnail(float scaleX, float scaleY) public final IImage getImage(float scaleX, float scaleY)
public final BufferedImage getThumbnail(IRenderingOptions options) public final IImage getImage(IRenderingOptions options)
public final BufferedImage getThumbnail(IRenderingOptions options, float scaleX, float scaleY) public final IImage getImage(IRenderingOptions options)
public final BufferedImage getThumbnail(IRenderingOptions options, Dimension imageSize) public final IImage getImage(IRenderingOptions options, Dimension imageSize)
public final BufferedImage getThumbnail(ITiffOptions options) public final IImage getImage(ITiffOptions options)
public final BufferedImage getThumbnail(Dimension imageSize) public final IImage getImage(Dimension imageSize)
public final void renderToGraphics(IRenderingOptions options, Graphics2D graphics) No Modern API replacement
public final void renderToGraphics(IRenderingOptions options, Graphics2D graphics, float scaleX, float scaleY) No Modern API replacement
public final void renderToGraphics(IRenderingOptions options, Graphics2D graphics, Dimension renderingSize) No Modern API replacement

Output

ลายเซ็นของเมธอด ลายเซ็นเมธอดทดแทน
public final IOutputFile add(String path, BufferedImage image) public final IOutputFile add(String path, IImage image)

ImageCollection

ลายเซ็นของเมธอด ลายเซ็นเมธอดทดแทน
public final IPPImage addImage(BufferedImage image) public final IPPImage addImage(IImage image)

PPImage

ลายเซ็นของเมธอด ลายเซ็นเมธอดทดแทน
public final BufferedImage getSystemImage() public final IImage getImage()

PatternFormat

ลายเซ็นของเมธอด ลายเซ็นเมธอดทดแทน
public final BufferedImage getTileImage(Color styleColor) public final IImage getTile(Color styleColor)
public final BufferedImage getTileImage(Color background, Color foreground) public final IImage getTile(Color background, Color foreground)

PatternFormatEffectiveData

ลายเซ็นของเมธอด ลายเซ็นเมธอดทดแทน
public final java.awt.image.BufferedImage getTileImage(Color background, Color foreground) public final IImage getTileIImage(Color background, Color foreground)

การสนับสนุน API สำหรับ Graphics2D

เมธอดที่มี Graphics2D ถูกประกาศให้เป็นรุ่นล้าสมัยและไม่มีการแทนที่โดยตรงใน Modern API

ใช้เมธอดเรนเดอร์ภาพของ Modern API แทนการเรนเดอร์ไปยัง Graphics2D:

Slide

FAQ

ทำไมจึงยกเลิกการใช้ Graphics2D?

การสนับสนุน Graphics2D ถูกทำให้เป็นรุ่นล้าสมัยใน API สาธารณะเพื่อ統合การทำงานกับการเรนเดอร์และภาพ, กำจัดการเชื่อมโยงกับการพึ่งพาแพลตฟอร์มเฉพาะ, และเปลี่ยนไปใช้แนวทางข้ามแพลตฟอร์มกับ IImage. ใช้ getImage หรือ getImages แทนการเรนเดอร์ไปยัง Graphics2D.

ประโยชน์เชิงปฏิบัติของ IImage เปรียบเทียบกับ BufferedImage คืออะไร?

IImage ทำให้การทำงานกับภาพ raster และ vector เป็นหนึ่งเดียวและทำให้การบันทึกเป็นรูปแบบต่าง ๆ ง่ายขึ้นผ่าน ImageFormat.

Modern API จะส่งผลต่อประสิทธิภาพของการสร้าง thumbnail หรือไม่?

การสลับจาก getThumbnail ไปเป็น getImage ไม่ทำให้สถานการณ์แย่ลง: เมธอดใหม่ให้ความสามารถเดียวกันในการสร้างภาพพร้อมตัวเลือกและขนาดต่าง ๆ พร้อมยังคงสนับสนุนตัวเลือกการเรนเดอร์ ผลลัพธ์ที่ดีหรือเสียขึ้นอยู่กับกรณีการใช้งาน แต่ด้านฟังก์ชันการแทนที่นั้นเท่าเทียมกัน.

สร้างเอฟเฟกต์ 3 มิติในงานนำเสนอโดยใช้ Java จัดการโครงการ VBA ในงานนำเสนอโดยใช้ Java