Images Java API 總覽

「應用服務引擎」的「影像」專屬服務提供操縱影像資料的功能。「影像」服務可以調整影像大小、旋轉影像、翻轉影像以及裁剪影像；它可以將多個影像合成單一影像，也可以在多種格式之間轉換影像資料，您還能使用預先定義的演算法來加強相片的影像效果。此外，API 還可以提供影像的相關資訊，例如格式、寬度、高度以及色彩值的長條圖。

• 在 Java 轉換影像
• 支援的影像轉換功能
• 影像格式
• 影像和開發伺服器
• 配額和限制

在 Java 轉換影像

Image Service Java API (影像服務 Java API) 可讓您使用服務轉換影像，而不是在應用程式伺服器執行影像處理程序。 應用程式準備一個擁有轉換影像資料的 Image 物件，以及一個擁有轉換影像指示的 Transform 物件。應用程式取得一個 ImagesService 物件，然後透過 Image 及 Transform 物件呼叫它的 applyTransform() 方法，然後方法傳回一個已轉換影像的 Image 物件。

應用程式使用 ImagesServiceFactory 取得 ImagesService、Image 及 Transform 實例。

import com.google.appengine.api.images.Image;
import com.google.appengine.api.images.ImagesService;
import com.google.appengine.api.images.ImagesServiceFactory;
import com.google.appengine.api.images.Transform;

// ...
        byte[] oldImageData;  // ...

        ImagesService imagesService = ImagesServiceFactory.getImagesService();

        Image oldImage = ImagesServiceFactory.makeImage(oldImageData);
        Transform resize = ImagesServiceFactory.makeResize(200, 300);

        Image newImage = imagesService.applyTransform(resize, oldImage);

        byte[] newImageData = newImage.getImageData();

多項轉換程序可使用 CompositeTransform 實例，合併至一個單一的動作中。請參閱影像 API 參考資料。

支援的影像轉換功能

「影像」服務可以調整影像大小、旋轉影像、翻轉影像、裁剪影像以及加強相片的影像效果。它也可以將多個影像合成單一影像。

調整大小

您可以在維持相同比例的情況下，調整影像的大小。

  

旋轉

您可以將影像以 90 度的倍數進行旋轉。

  

水平翻轉

您可以將影像水平翻轉。

  

垂直翻轉

您可以將影像垂直翻轉。

  

裁剪

您可以將影像裁剪為指定的方塊。

  

好手氣

「好手氣」轉換功能會強化影像中的暗色和亮色，並同時將色彩和對比調整為最佳。

  

影像格式

此服務可以接受 JPEG、PNG、GIF (包括動畫 GIF)、BMP、TIFF 以及 ICO 格式的影像資料，

並可以輸出 JPEG 和 PNG 格式的轉換影像。如果輸入與輸出格式不同，此服務會先將輸入資料轉換成輸出格式，然後執行轉換。

影像和開發伺服器

開發伺服器會使用本機機器執行「影像」服務的功能。

Java 開發伺服器擁有可以模擬「影像」服務的功能，可是不支援「好手氣」的照片影像強化功能。

配額和限制

「影像」服務的每個要求會算入 Image Manipulation API Calls (影像操縱 API 呼叫) 的配額中。在單次 API 呼叫中，應用程式可以執行多次影像轉換。

傳送至「影像」服務的資料會算入「傳送至 (影像) API 的資料」的配額中。從「影像」服務接收的資料會算入「從 (影像) API 接收的資料」的配額中。

影像的每次轉換會算入「已執行的轉換」的配額中。

如需瞭解配額的詳細資訊，請參閱「配額」，或參閱「管理控制台」的「配額詳細資訊」一節。

除了配額之外，使用「影像」服務時也需遵循下列限制：