공지사항:
2025년 4월 15일 전에 Earth Engine 사용을 위해 등록된 모든 비상업용 프로젝트는 Earth Engine 액세스를 유지하기 위해
비상업용 자격 요건을 인증해야 합니다.
ee.Image.cast
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이미지의 일부 또는 모든 밴드를 지정된 유형으로 변환합니다.
| 사용 | 반환 값 |
|---|
Image.cast(bandTypes, bandOrder) | 이미지 |
| 인수 | 유형 | 세부정보 |
|---|
다음과 같은 경우: image | 이미지 | 전송할 이미지입니다. |
bandTypes | 딕셔너리 | 밴드 이름에서 밴드 유형으로의 사전입니다. 유형은 PixelTypes 또는 문자열일 수 있습니다. 유효한 문자열은 'int8', 'int16', 'int32', 'int64', 'uint8', 'uint16', 'uint32', 'byte', 'short', 'int', 'long', 'float', 'double'입니다. bandTypes에 입력 이미지에 아직 없는 밴드가 포함되어 있으면 투명 밴드로 이미지에 추가됩니다. bandOrder도 지정하지 않으면 새 밴드가 알파벳순으로 추가됩니다. |
bandOrder | 목록, 기본값: null | 결과의 밴드 순서를 지정하는 목록입니다. 지정된 경우 결과의 전체 대역 목록과 일치해야 합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 2025-07-26(UTC)"],[[["\u003cp\u003eCasts image bands to specified data types like 'int8', 'float', etc., allowing for data type conversions within an image.\u003c/p\u003e\n"],["\u003cp\u003eAccepts a dictionary mapping band names to desired types, enabling selective casting for individual bands.\u003c/p\u003e\n"],["\u003cp\u003eCan introduce new bands with specified types, appending them to the image with optional ordering using the \u003ccode\u003ebandOrder\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eReturns a new Image with the converted bands, preserving the original image unchanged.\u003c/p\u003e\n"]]],["The `Image.cast` function modifies an image by changing the data type of its bands. It takes a dictionary, `bandTypes`, mapping band names to new data types (PixelTypes or strings like 'int8', 'float'). If a specified band is not present in the original image, a transparent band of that type is added. An optional `bandOrder` list defines the sequence of the resulting bands. The function returns the modified `Image`.\n"],null,["# ee.Image.cast\n\nCasts some or all bands of an image to the specified types.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|----------------------------------------|---------|\n| Image.cast`(bandTypes, `*bandOrder*`)` | Image |\n\n| Argument | Type | Details |\n|---------------|---------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `image` | Image | The image to cast. |\n| `bandTypes` | Dictionary | A dictionary from band name to band types. Types can be PixelTypes or strings. The valid strings are: 'int8', 'int16', 'int32', 'int64', 'uint8', 'uint16', 'uint32', 'byte', 'short', 'int', 'long', 'float', and 'double'. If bandTypes includes bands that are not already in the input image, they will be added to the image as transparent bands. If bandOrder isn't also specified, new bands will be appended in alphabetical order. |\n| `bandOrder` | List, default: null | A list specifying the order of the bands in the result. If specified, must match the full list of bands in the result. |"]]
