ImagesService 인터페이스
-
public interface ImagesService
이미지 서비스는 이미지에 변환을 적용하는 방법을 제공합니다.
-
-
중첩 클래스 요약
중첩 클래스 한정자 및 유형 인터페이스 및 설명 static class
ImagesService.OutputEncoding
이미지 변환에 사용할 수 있는 유효한 출력 인코딩 형식입니다.
-
필드 요약
필드 한정자 및 유형 필드 및 설명 static int
MAX_COMPOSITES_PER_REQUEST
static int
MAX_RESIZE_DIMENSIONS
static int
MAX_TRANSFORMS_PER_REQUEST
static java.util.Set<java.lang.Integer>
SERVING_CROP_SIZES
지원 중단되었습니다.static java.util.Set<java.lang.Integer>
SERVING_SIZES
지원 중단되었습니다.static int
SERVING_SIZES_LIMIT
-
메소드 요약
모든 메소드 인스턴스 메소드 추상 메소드 지원 중단된 메소드 한정자 및 유형 메소드 및 설명 Image
applyTransform(Transform transform, Image image)
제공된transform
을 제공된image
에 적용하고, PNG 파일 형식을 사용하여 저장된 변환 대상 이미지를 인코딩합니다.Image
applyTransform(Transform transform, Image image, ImagesService.OutputEncoding encoding)
제공된transform
을 제공된image
에 적용하고,encoding
파일 형식을 사용하여 저장된 변환 대상 이미지를 인코딩합니다.Image
applyTransform(Transform transform, Image image, InputSettings inputSettings, OutputSettings outputSettings)
제공된transform
을 제공된image
에 적용하고,inputSettings
에 따라image
를 해석하는outputSettings
를 사용하여 저장된 변환 대상 이미지를 인코딩합니다.Image
applyTransform(Transform transform, Image image, OutputSettings settings)
제공된transform
을 제공된image
에 적용하고,settings
를 사용하여 저장된 변환 대상 이미지를 인코딩합니다.java.util.concurrent.Future<Image>
applyTransformAsync(Transform transform, Image image)
제공된transform
을 제공된image
에 비동기식으로 적용하고, PNG 파일 형식을 사용하여 저장된 변환 대상 이미지를 인코딩합니다.java.util.concurrent.Future<Image>
applyTransformAsync(Transform transform, Image image, ImagesService.OutputEncoding encoding)
제공된transform
을 제공된image
에 비동기식으로 적용하고,encoding
파일 형식을 사용하여 저장된 변환 대상 이미지를 인코딩합니다.java.util.concurrent.Future<Image>
applyTransformAsync(Transform transform, Image image, InputSettings inputSettings, OutputSettings outputSettings)
제공된transform
을 제공된image
에 비동기식으로 적용하고,inputSettings
에 따라image
를 해석하는settings
를 사용하여 저장된 변환 대상 이미지를 인코딩합니다.java.util.concurrent.Future<Image>
applyTransformAsync(Transform transform, Image image, OutputSettings settings)
제공된transform
을 제공된image
에 비동기식으로 적용하고,settings
를 사용하여 저장된 변환 대상 이미지를 인코딩합니다.Image
composite(java.util.Collection<Composite> composites, int width, int height, long color)
Image
composite(java.util.Collection<Composite> composites, int width, int height, long color, ImagesService.OutputEncoding encoding)
Image
composite(java.util.Collection<Composite> composites, int width, int height, long color, OutputSettings settings)
void
deleteServingUrl(BlobKey blobKey)
이전에getServingUrl(BlobKey)
에 의해 생성된 URL을 삭제합니다.java.lang.String
getServingUrl(BlobKey blobKey)
지원이 중단되었습니다.getServingUrl(ServingUrlOptions)
로 대체되었습니다.java.lang.String
getServingUrl(BlobKey blobKey, boolean secureUrl)
지원이 중단되었습니다.getServingUrl(ServingUrlOptions)
로 대체되었습니다.java.lang.String
getServingUrl(BlobKey blobKey, int imageSize, boolean crop)
지원이 중단되었습니다.getServingUrl(ServingUrlOptions)
로 대체되었습니다.java.lang.String
getServingUrl(BlobKey blobKey, int imageSize, boolean crop, boolean secureUrl)
지원이 중단되었습니다.getServingUrl(ServingUrlOptions)
로 대체되었습니다.java.lang.String
getServingUrl(ServingUrlOptions options)
blob으로 저장되는 이미지를 동적으로 제공할 수 있는 URL을 가져옵니다.int[][]
histogram(Image image)
이미지의 히스토그램을 계산합니다.
-
-
-
필드 세부정보
-
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)
- 매개변수:
composites
- 적용할 합성 연산width
- 캔버스의 너비(픽셀)height
- 캔버스의 높이(픽셀)color
- 캔버스의 배경 색상(ARGB 형식)- 반환:
- 합성 결과가 적용된 새 이미지
- 예외 처리:
java.lang.IllegalArgumentException
-width
또는height
가 4,000보다 크거나 색상이 [0, 0xffffffff] 범위를 벗어나거나composites
에 16개가 넘는 요소가 포함되어 있거나composites
의 콘텐츠에 이상이 있는 경우ImagesServiceFailureException
- 이미지 서비스에 문제가 있는 경우
-
composite
Image composite(java.util.Collection<Composite> composites, int width, int height, long color, ImagesService.OutputEncoding encoding)
- 매개변수:
composites
- 적용할 합성 연산width
- 캔버스의 너비(픽셀)height
- 캔버스의 높이(픽셀)color
- 캔버스의 배경 색상(ARGB 형식)encoding
- 결과 이미지에 사용할 인코딩- 반환:
- 합성 결과가 적용된 새 이미지
- 예외 처리:
java.lang.IllegalArgumentException
-width
또는height
가 4,000보다 크거나 색상이 [0, 0xffffffff] 범위를 벗어나거나composites
에 16개가 넘는 요소가 포함되어 있거나composites
의 콘텐츠에 이상이 있는 경우ImagesServiceFailureException
- 이미지 서비스에 문제가 있는 경우
-
composite
Image composite(java.util.Collection<Composite> composites, int width, int height, long color, OutputSettings settings)
- 매개변수:
composites
- 적용할 합성 연산width
- 캔버스의 너비(픽셀)height
- 캔버스의 높이(픽셀)color
- 캔버스의 배경 색상(ARGB 형식)settings
- 결과 이미지에 사용할 OutputSettings- 반환:
- 합성 결과가 적용된 새 이미지
- 예외 처리:
java.lang.IllegalArgumentException
-width
또는height
가 4,000보다 크거나 색상이 [0, 0xffffffff] 범위를 벗어나거나composites
에 16개가 넘는 요소가 포함되어 있거나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 키가 잘못된 경우
-
-