주의: 앞으로 몇 개월에 걸쳐 Google은 콘텐츠를 보다 손쉽게 찾고 나머지 Google Cloud 제품과 더 잘 연동되도록 App Engine 문서 사이트를 재구성할 예정입니다. 제공되는 콘텐츠는 동일하지만, 이제 탐색 기능이 나머지 클라우드 제품과 일치하게 됩니다. 사이트를 탐색할 때 의견이나 질문이 있으면 '의견 보내기'를 클릭하세요.

ImagesService(자바용 Google App Engine API)

com.google.appengine.api.images

ImagesService 인터페이스



  • public interface ImagesService
    이미지 서비스는 이미지에 변환을 적용하는 방법을 제공합니다.
    • 필드 세부정보

      • MAX_TRANSFORMS_PER_REQUEST

        static final int MAX_TRANSFORMS_PER_REQUEST
        참조:
        상수 필드 값
      • MAX_RESIZE_DIMENSIONS

        static final int MAX_RESIZE_DIMENSIONS
        참조:
        상수 필드 값
      • MAX_COMPOSITES_PER_REQUEST

        static final int MAX_COMPOSITES_PER_REQUEST
        참조:
        상수 필드 값
      • SERVING_SIZES_LIMIT

        static final int SERVING_SIZES_LIMIT
        참조:
        상수 필드 값
      • SERVING_SIZES

        @Deprecated
        static final java.util.Set<java.lang.Integer> SERVING_SIZES
        지원 중단되었습니다.
      • SERVING_CROP_SIZES

        @Deprecated
        static final java.util.Set<java.lang.Integer> SERVING_CROP_SIZES
        지원 중단되었습니다.
    • 메소드 세부정보

      • applyTransform

        Image applyTransform(Transform transform,
                             Image image)
        제공된 transform을 제공된 image에 적용하고, PNG 파일 형식을 사용하여 저장된 변환 대상 이미지를 인코딩합니다. 제공된 이미지 대신에 해당 변환이 적용됩니다.
        매개변수:
        transform - 적용할 변환
        image - 변환할 이미지
        반환:
        변환된 이미지
        예외 처리:
        java.lang.IllegalArgumentException - transform 또는 image가 잘못된 경우
        ImagesServiceFailureException - 이미지 서비스에 문제가 있는 경우
      • applyTransformAsync

        java.util.concurrent.Future<Image> applyTransformAsync(Transform transform,
                                                               Image image)
        제공된 transform을 제공된 image에 비동기식으로 적용하고, PNG 파일 형식을 사용하여 저장된 변환 대상 이미지를 인코딩합니다. 제공된 이미지 대신에 해당 변환이 적용됩니다.
        매개변수:
        transform - 적용할 변환
        image - 변환할 이미지
        반환:
        변환된 이미지 또는 applyTransform(Transform, Image)과 관련하여 규정된 예외 중 하나를 포함하는 future
      • applyTransform

        Image applyTransform(Transform transform,
                             Image image,
                             ImagesService.OutputEncoding encoding)
        제공된 transform을 제공된 image에 적용하고, encoding 파일 형식을 사용하여 저장된 변환 대상 이미지를 인코딩합니다. 제공된 이미지 대신에 해당 변환이 적용됩니다.
        매개변수:
        transform - 적용할 변환
        image - 변환할 이미지
        encoding - 사용할 출력 인코딩
        반환:
        변환된 이미지
        예외 처리:
        java.lang.IllegalArgumentException - transform, image 또는 encoding이 잘못된 경우
        ImagesServiceFailureException - 이미지 서비스에 문제가 있는 경우
      • applyTransformAsync

        java.util.concurrent.Future<Image> applyTransformAsync(Transform transform,
                                                               Image image,
                                                               ImagesService.OutputEncoding encoding)
        제공된 transform을 제공된 image에 비동기식으로 적용하고, encoding 파일 형식을 사용하여 저장된 변환 대상 이미지를 인코딩합니다. 제공된 이미지 대신에 해당 변환이 적용됩니다.
        매개변수:
        transform - 적용할 변환
        image - 변환할 이미지
        encoding - 사용할 출력 인코딩
        반환:
        변환된 이미지 또는 applyTransform(Transform, Image, OutputEncoding)과 관련하여 규정된 예외 중 하나를 포함하는 future
      • applyTransform

        Image applyTransform(Transform transform,
                             Image image,
                             OutputSettings settings)
        제공된 transform을 제공된 image에 적용하고, settings를 사용하여 저장된 변환 대상 이미지를 인코딩합니다. 제공된 이미지 대신에 해당 변환이 적용됩니다.
        매개변수:
        transform - 적용할 변환
        image - 변환할 이미지
        settings - 사용할 출력 설정
        반환:
        변환된 이미지
        예외 처리:
        java.lang.IllegalArgumentException - transform, image 또는 settings가 잘못된 경우
        ImagesServiceFailureException - 이미지 서비스에 문제가 있는 경우
      • applyTransformAsync

        java.util.concurrent.Future<Image> applyTransformAsync(Transform transform,
                                                               Image image,
                                                               OutputSettings settings)
        제공된 transform을 제공된 image에 비동기식으로 적용하고, settings를 사용하여 저장된 변환 대상 이미지를 인코딩합니다. 제공된 이미지 대신에 해당 변환이 적용됩니다.
        매개변수:
        transform - 적용할 변환
        image - 변환할 이미지
        settings - 사용할 출력 설정
        반환:
        변환된 이미지 또는 applyTransform(Transform, Image, OutputSettings)과 관련하여 규정된 예외 중 하나를 포함하는 future
      • applyTransform

        Image applyTransform(Transform transform,
                             Image image,
                             InputSettings inputSettings,
                             OutputSettings outputSettings)
        제공된 transform을 제공된 image에 적용하고, inputSettings에 따라 image를 해석하는 outputSettings를 사용하여 저장된 변환 대상 이미지를 인코딩합니다. 제공된 이미지 대신에 해당 변환이 적용됩니다.
        매개변수:
        transform - 적용할 변환
        image - 변환할 이미지
        inputSettings - 사용할 입력 설정
        outputSettings - 사용할 출력 설정
        반환:
        변환된 이미지
        예외 처리:
        java.lang.IllegalArgumentException - transform, image, inputSettings 또는 outputSettings가 잘못된 경우
        ImagesServiceFailureException - 이미지 서비스에 문제가 있는 경우
      • applyTransformAsync

        java.util.concurrent.Future<Image> applyTransformAsync(Transform transform,
                                                               Image image,
                                                               InputSettings inputSettings,
                                                               OutputSettings outputSettings)
        제공된 transform을 제공된 image에 비동기식으로 적용하고, inputSettings에 따라 image를 해석하는 settings를 사용하여 저장된 변환 대상 이미지를 인코딩합니다. 제공된 이미지 대신에 해당 변환이 적용됩니다.
        매개변수:
        transform - 적용할 변환
        image - 변환할 이미지
        inputSettings - 사용할 입력 설정
        outputSettings - 사용할 출력 설정
        반환:
        변환된 이미지 또는 applyTransform(Transform, Image, InputSettings, OutputSettings)과 관련하여 규정된 예외 중 하나를 포함하는 future
      • composite

        Image composite(java.util.Collection<Composite> composites,
                        int width,
                        int height,
                        long color)
        크기가 widthheight이고 배경 색상이 color인 캔버스를 사용하여 제공된 CompositeCollection을 적용합니다. 출력 인코딩으로 PNG를 사용합니다.
        매개변수:
        composites - 적용할 합성 연산
        width - 캔버스의 너비(픽셀)
        height - 캔버스의 높이(픽셀)
        color - 캔버스의 배경 색상(ARGB 형식)
        반환:
        합성 결과가 적용된 새 이미지
        예외 처리:
        java.lang.IllegalArgumentException - width 또는 height4,000보다 크거나 색상이 [0, 0xffffffff] 범위를 벗어나거나 composites16개가 넘는 요소가 포함되어 있거나 composites의 콘텐츠에 이상이 있는 경우
        ImagesServiceFailureException - 이미지 서비스에 문제가 있는 경우
      • composite

        Image composite(java.util.Collection<Composite> composites,
                        int width,
                        int height,
                        long color,
                        ImagesService.OutputEncoding encoding)
        크기가 widthheight이고 배경 색상이 color인 캔버스를 사용하여 제공된 CompositeCollection을 적용합니다.
        매개변수:
        composites - 적용할 합성 연산
        width - 캔버스의 너비(픽셀)
        height - 캔버스의 높이(픽셀)
        color - 캔버스의 배경 색상(ARGB 형식)
        encoding - 결과 이미지에 사용할 인코딩
        반환:
        합성 결과가 적용된 새 이미지
        예외 처리:
        java.lang.IllegalArgumentException - width 또는 height4,000보다 크거나 색상이 [0, 0xffffffff] 범위를 벗어나거나 composites16개가 넘는 요소가 포함되어 있거나 composites의 콘텐츠에 이상이 있는 경우
        ImagesServiceFailureException - 이미지 서비스에 문제가 있는 경우
      • composite

        Image composite(java.util.Collection<Composite> composites,
                        int width,
                        int height,
                        long color,
                        OutputSettings settings)
        크기가 widthheight이고 배경 색상이 color인 캔버스를 사용하여 제공된 CompositeCollection을 적용합니다.
        매개변수:
        composites - 적용할 합성 연산
        width - 캔버스의 너비(픽셀)
        height - 캔버스의 높이(픽셀)
        color - 캔버스의 배경 색상(ARGB 형식)
        settings - 결과 이미지에 사용할 OutputSettings
        반환:
        합성 결과가 적용된 새 이미지
        예외 처리:
        java.lang.IllegalArgumentException - width 또는 height4,000보다 크거나 색상이 [0, 0xffffffff] 범위를 벗어나거나 composites16개가 넘는 요소가 포함되어 있거나 composites의 콘텐츠에 이상이 있는 경우
        ImagesServiceFailureException - 이미지 서비스에 문제가 있는 경우
      • histogram

        int[][] histogram(Image image)
        이미지의 히스토그램을 계산합니다.
        매개변수:
        image - 히스토그램을 계산할 이미지
        반환:
        각각 색상 채널 1개의 이미지 히스토그램을 포함하며 길이가 256인 3개의 배열로 구성된 하나의 배열. 각 채널은 항목 0에서 3까지 RGB로 순서가 정해집니다. 각 채널의 범위는 색상이 존재하지 않는 0에서부터 색상이 최대 밝기인 255까지입니다.
      • getServingUrl

        @Deprecated
        java.lang.String getServingUrl(BlobKey blobKey)
        지원이 중단되었습니다.getServingUrl(ServingUrlOptions)로 대체되었습니다.
        blob으로 저장되는 이미지를 동적으로 제공할 수 있는 URL을 가져옵니다.

        이 URL은 전 세계에 서비스를 제공하는 고성능 동적 이미지 제공 인프라에 의해 제공됩니다. 이 메서드가 반환하는 URL은 항상 공개되어 있지만 추측은 불가능하며, 비공개 URL은 현재 지원되지 않습니다. URL 제공을 중지하려면 기본 blob 키를 삭제하세요. 중지가 적용되기까지 최대 24시간이 소요됩니다. 또한 이 URL 형식은 몇 가지 제한 사항을 전제로 동적인 크기 조절과 자르기 기능을 지원합니다. 동적인 크기 조절과 자르기 기능을 가져오려면 이 호출을 통해 가져온 url의 끝에 몇 가지 옵션을 추가하기만 하면 됩니다. 예를 들면 다음과 같습니다. getServingUrl -> "http://lh3.ggpht.com/SomeCharactersGoesHere"

        32픽셀 크기의 버전(보존된 가로세로 비율)을 가져오려면 다음과 같이 url에 '=s32'를 추가하면 됩니다. "http://lh3.ggpht.com/SomeCharactersGoesHere=s32"

        32픽셀 자르기 버전을 가져오려면 다음과 같이 '=s32-c'를 추가하면 됩니다. "http://lh3.ggpht.com/SomeCharactersGoesHere=s32-c"

        유효한 크기 값은 [0, 1600] 범위의 정수이며 SERVING_SIZES_LIMIT로 제공됩니다.

        매개변수:
        blobKey - 반환된 URL이 제공할 이미지의 blob 키
        반환:
        이미지를 동적으로 제공할 수 있는 URL
        예외 처리:
        java.lang.IllegalArgumentException - blob 키가 유효하지 않거나 이미지를 포함하고 있지 않은 경우
        ImagesServiceFailureException - 이미지 서비스에 문제가 있는 경우
      • getServingUrl

        @Deprecated
        java.lang.String getServingUrl(BlobKey blobKey,
                                                   boolean secureUrl)
        지원이 중단되었습니다.getServingUrl(ServingUrlOptions)로 대체되었습니다.
        blob으로 저장되는 이미지를 동적으로 제공할 수 있는 URL을 가져옵니다.

        이 URL은 전 세계에 서비스를 제공하는 고성능 동적 이미지 제공 인프라에 의해 제공됩니다. 이 메서드가 반환하는 URL은 항상 공개되어 있지만 추측은 불가능하며, 비공개 URL은 현재 지원되지 않습니다. URL 제공을 중지하려면 기본 blob 키를 삭제하세요. 중지가 적용되기까지 최대 24시간이 소요됩니다. 또한 이 URL 형식은 몇 가지 제한 사항을 전제로 동적인 크기 조절과 자르기 기능을 지원합니다. 동적인 크기 조절과 자르기 기능을 가져오려면 이 호출을 통해 가져온 url의 끝에 몇 가지 옵션을 추가하기만 하면 됩니다. 예를 들면 다음과 같습니다. getServingUrl -> "http://lh3.ggpht.com/SomeCharactersGoesHere"

        32픽셀 크기의 버전(보존된 가로세로 비율)을 가져오려면 다음과 같이 url에 '=s32'를 추가하면 됩니다. "http://lh3.ggpht.com/SomeCharactersGoesHere=s32"

        32픽셀 자르기 버전을 가져오려면 다음과 같이 '=s32-c'를 추가하면 됩니다. "http://lh3.ggpht.com/SomeCharactersGoesHere=s32-c"

        유효한 크기 값은 [0, 1600] 범위의 정수이며 SERVING_SIZES_LIMIT로 제공됩니다.

        매개변수:
        blobKey - 반환된 URL이 제공할 이미지의 blob 키
        secureUrl - url 스키마를 https로 할지 http로 할지를 제어합니다.
        반환:
        이미지를 동적으로 제공할 수 있는 URL
        예외 처리:
        java.lang.IllegalArgumentException - blob 키가 유효하지 않거나 이미지를 포함하고 있지 않은 경우
        ImagesServiceFailureException - 이미지 서비스에 문제가 있는 경우
      • getServingUrl

        @Deprecated
        java.lang.String getServingUrl(BlobKey blobKey,
                                                   int imageSize,
                                                   boolean crop)
        지원이 중단되었습니다.getServingUrl(ServingUrlOptions)로 대체되었습니다.
        getServingUrl(BlobKey)에 의해 반환된 일반 URL을 통해 서비스 제공 URL의 특정 크기 및 자르기 매개변수를 계산합니다.
        매개변수:
        blobKey - 반환된 URL이 제공할 특정 크기와 자르기 속성을 지닌 이미지의 blob 키
        imageSize - 제공된 이미지의 크기(픽셀)
        crop - 이미지의 크기를 조절해야 할지, 잘라야 할지를 제어합니다.
        반환:
        이미지를 동적으로 제공할 수 있는 URL
        예외 처리:
        java.lang.IllegalArgumentException - blob 키가 유효하지 않거나 이미지를 포함하고 있지 않거나, 지정한 크기를 서비스에서 지원하지 않는 경우
        ImagesServiceFailureException - 이미지 서비스에 문제가 있는 경우
        참조:
        getServingUrl(BlobKey)
      • getServingUrl

        @Deprecated
        java.lang.String getServingUrl(BlobKey blobKey,
                                                   int imageSize,
                                                   boolean crop,
                                                   boolean secureUrl)
        지원이 중단되었습니다.getServingUrl(ServingUrlOptions)로 대체되었습니다.
        getServingUrl(BlobKey)에 의해 반환된 일반 URL을 통해 서비스 제공 URL의 특정 크기 및 자르기 매개변수를 계산합니다.
        매개변수:
        blobKey - 반환된 URL이 제공할 특정 크기와 자르기 속성을 지닌 이미지의 blob 키
        imageSize - 제공된 이미지의 크기(픽셀)
        crop - 이미지의 크기를 조절해야 할지, 잘라야 할지를 제어합니다.
        secureUrl - url 스키마를 https로 할지 http로 할지를 제어합니다.
        반환:
        이미지를 동적으로 제공할 수 있는 URL
        예외 처리:
        java.lang.IllegalArgumentException - blob 키가 유효하지 않거나 이미지를 포함하고 있지 않거나, 지정한 크기를 서비스에서 지원하지 않는 경우
        ImagesServiceFailureException - 이미지 서비스에 문제가 있는 경우
        참조:
        getServingUrl(BlobKey)
      • getServingUrl

        java.lang.String getServingUrl(ServingUrlOptions options)
        blob으로 저장되는 이미지를 동적으로 제공할 수 있는 URL을 가져옵니다.

        이 URL은 전 세계에 서비스를 제공하는 고성능 동적 이미지 제공 인프라에 의해 제공됩니다. 이 메서드가 반환하는 URL은 항상 공개되어 있지만 추측은 불가능하며, 비공개 URL은 현재 지원되지 않습니다. URL 제공을 중지하려면 기본 blob 키를 삭제하세요. 중지가 적용되기까지 최대 24시간이 소요됩니다. 또한 이 URL 형식은 몇 가지 제한 사항을 전제로 동적인 크기 조절과 자르기 기능을 지원합니다. 동적인 크기 조절과 자르기 기능을 가져오려면 이 호출을 통해 가져온 url의 끝에 몇 가지 옵션을 추가하기만 하면 됩니다. 예를 들면 다음과 같습니다. getServingUrl -> "http://lh3.ggpht.com/SomeCharactersGoesHere"

        32픽셀 크기의 버전(보존된 가로세로 비율)을 가져오려면 다음과 같이 url에 '=s32'를 추가하면 됩니다. "http://lh3.ggpht.com/SomeCharactersGoesHere=s32"

        32픽셀 자르기 버전을 가져오려면 다음과 같이 '=s32-c'를 추가하면 됩니다. "http://lh3.ggpht.com/SomeCharactersGoesHere=s32-c"

        유효한 크기 값은 [0, 1600] 범위의 정수입니다(최대값은 SERVING_SIZES_LIMIT로 제공됨).

        매개변수:
        options - 서비스 제공 URL을 생성하기 위한 구체적인 옵션
        반환:
        이미지를 동적으로 제공할 수 있는 URL
        예외 처리:
        java.lang.IllegalArgumentException - 옵션에 유효한 blobKey 또는 googleStorageFileName이 포함되어 있지 않은 경우
        ImagesServiceFailureException - 이미지 서비스에 문제가 있는 경우
      • deleteServingUrl

        void deleteServingUrl(BlobKey blobKey)
        이전에 getServingUrl(BlobKey)에 의해 생성된 URL을 삭제합니다.
        매개변수:
        blobKey - 이전에 서비스 제공 URL을 만들기 위해 호출에 사용했던 blob 키.
        예외 처리:
        java.lang.IllegalArgumentException - blob 키가 잘못된 경우