بهبود پردازش تصویر با API مدرن

مقدمه

به‌صورت تاریخی، Aspose Slides به java.awt وابسته بوده و در API عمومی کلاس‌های زیر را در بر می‌گیرد:

از نسخه 24.4، این API عمومی به‌عنوان منسوخ اعلام شده است.

برای حذف وابستگی به این کلاس‌ها، “API مدرن” اضافه شد؛ یعنی APIی که به‌جای نسخهٔ منسوخ استفاده می‌شود و امضاهای آن دیگر به BufferedImage وابسته نیستند. Graphics2D منسوخ شده و پشتیبانی آن از API عمومی Slides حذف شده است.

در نسخه‌های فعلی، API عمومی که به انواع java.awt وابسته است به‌عنوان قدیمی/منسوخ در نظر گرفته می‌شود. برای کدهای جدید و هنگام مهاجرت گردش‌کارهای پردازش تصویر، از API مدرن استفاده کنید.

API مدرن

کلاس‌ها و enum‌های زیر به API عمومی اضافه شد:

IImage – نمایانگر تصویر رستری یا برداری.
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 {
        // با افزودن یک نمونه از IImage به تصاویر ارائه، یک تصویر PowerPoint ایجاد می‌کند.
        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);

    // دریافت یک نمونه از IImage که نمایانگر اسلاید شماره ۱ است.
    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();
}

جایگزینی کدهای قدیمی با 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();
}

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

دریافت تصویر بندانگشتی اسلاید

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

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

دریافت تصویر بندانگشتی شکل

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

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

دریافت تصویر بندانگشتی ارائه

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

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

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

متدهای منسوخ و جایگزین‌های آن‌ها در 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 ندارند.

به‌جای API رندر به Graphics2D، از متدهای رندر تصویر در API مدرن استفاده کنید:

Slide

FAQ

چرا Graphics2D حذف شد؟

پشتیبانی از Graphics2D در API عمومی منسوخ شده است تا کار با رندر و تصاویر یکپارچه شود، وابستگی به پلتفرم خاص حذف شود و به رویکردی چند‑پلتفرمی با استفاده از IImage سوئیچ شود. به‌جای رندر به Graphics2D از getImage یا getImages استفاده کنید.

مزیت عملی استفاده از IImage نسبت به BufferedImage چیست؟

IImage کار با تصاویر رستری و برداری را یکپارچه می‌کند و ذخیره در فرمت‌های مختلف را از طریق ImageFormat ساده می‌سازد.

آیا API مدرن بر عملکرد تولید تصویر بندانگشتی تأثیر می‌گذارد؟

تغییر از getThumbnail به getImage عملکرد را کاهش نمی‌دهد؛ متدهای جدید همان قابلیت تولید تصویر با گزینه‌ها و اندازه‌ها را فراهم می‌کنند و همچنان از گزینه‌های رندر پشتیبانی می‌شود. سود یا زیان خاصی بستگی به سناریو دارد، اما از نظر کارکرد جایگزین‌ها معادل هستند.

ایجاد افکت‌های 3D در ارائه‌ها با استفاده از Java مدیریت پروژه‌های VBA در ارائه‌ها با استفاده از Java