MLKitVision 프레임워크 참조
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
GMLImage
@interface GMLImage : NSObject
기기 내 머신러닝에 사용되는 이미지입니다.
-
선언
Objective-C
@property (nonatomic, readonly) CGFloat width;
-
선언
Objective-C
@property (nonatomic, readonly) CGFloat height;
-
선언
Objective-C
@property (nonatomic) int orientation;
-
-
선언
Objective-C
@property (nonatomic, readonly, nullable) int *image;
-
선언
Objective-C
@property (nonatomic, readonly, nullable) CVPixelBufferRef pixelBuffer;
-
선언
Objective-C
@property (nonatomic, readonly, nullable) CMSampleBufferRef sampleBuffer;
-
지정된 이미지로 MLImage
객체를 초기화합니다.
선언
Objective-C
- (nullable instancetype)initWithImage:(id)image;
매개변수
image
|
소스로 사용할 이미지입니다. CGImage 속성은 NULL 이 아니어야 합니다.
|
반환 값
지정된 이미지를 소스로 사용하는 새 MLImage
인스턴스 주어진 image
의 경우 nil
은 nil
이거나 잘못되었습니다.
-
지정된 픽셀 버퍼를 사용하여 MLImage
객체를 초기화합니다.
선언
Objective-C
- (nullable instancetype)initWithPixelBuffer:
(nonnull CVPixelBufferRef)pixelBuffer;
매개변수
pixelBuffer
|
소스로 사용할 픽셀 버퍼입니다. 새
MLImage 인스턴스가 이 수명 주기 동안 지속될 수 있습니다.
|
반환 값
지정된 픽셀 버퍼를 소스로 사용하는 새 MLImage
인스턴스입니다. 주어진 경우 nil
픽셀 버퍼가 nil
이거나 잘못되었습니다.
-
지정된 샘플 버퍼를 사용하여 MLImage
객체를 초기화합니다.
선언
Objective-C
- (nullable instancetype)initWithSampleBuffer:
(nonnull CMSampleBufferRef)sampleBuffer;
매개변수
sampleBuffer
|
소스로 사용할 샘플 버퍼입니다. 새
MLImage 인스턴스가 이 수명 주기 동안 지속될 수 있습니다. 샘플 버퍼는
픽셀 버퍼 (압축 데이터 아님)에 있는 값을 정의합니다. 실제로는 카메라의 동영상 출력이어야 합니다.
다른 임의의 유형의 CMSampleBuffer 가 아닌 iOS 기기에서는 필요합니다.
|
반환 값
지정된 샘플 버퍼를 소스로 사용하는 새 MLImage
인스턴스 주어진 경우 nil
샘플 버퍼가 nil
이거나 잘못되었습니다.
-
선언
Objective-C
- (nonnull instancetype)init;
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003e\u003ccode\u003eGMLImage\u003c/code\u003e is an object used for on-device machine learning representing an image.\u003c/p\u003e\n"],["\u003cp\u003eIt can be initialized with an image, a pixel buffer, or a sample buffer, defining the image source.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eGMLImage\u003c/code\u003e provides read-only access to properties like width, height, orientation, and the image source type.\u003c/p\u003e\n"],["\u003cp\u003eIf initialized with an image, the \u003ccode\u003eimage\u003c/code\u003e property holds the source image; otherwise, it's \u003ccode\u003enil\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eSimilarly, \u003ccode\u003epixelBuffer\u003c/code\u003e and \u003ccode\u003esampleBuffer\u003c/code\u003e properties hold the respective source data depending on the initialization type, being \u003ccode\u003enil\u003c/code\u003e otherwise.\u003c/p\u003e\n"]]],["GMLImage manages images for on-device machine learning, defining properties like `width`, `height`, `orientation`, and `imageSourceType`. It can be initialized using `-initWithImage:`, `-initWithPixelBuffer:`, or `-initWithSampleBuffer:`, accepting an image, pixel buffer, or sample buffer respectively as the source. It also exposes the source data through read-only properties, such as `image`, `pixelBuffer`, and `sampleBuffer`, depending on `imageSourceType`. The `-init` method is unavailable.\n"],null,["# MLKitVision Framework Reference\n\nGMLImage\n========\n\n\n @interface GMLImage : NSObject\n\nAn image used in on-device machine learning.\n- `\n ``\n ``\n `\n\n ### [width](#/c:objc(cs)GMLImage(py)width)\n\n `\n ` \n Width of the image in pixels. \n\n #### Declaration\n\n Objective-C \n\n @property (nonatomic, readonly) CGFloat width;\n\n- `\n ``\n ``\n `\n\n ### [height](#/c:objc(cs)GMLImage(py)height)\n\n `\n ` \n Height of the image in pixels. \n\n #### Declaration\n\n Objective-C \n\n @property (nonatomic, readonly) CGFloat height;\n\n- `\n ``\n ``\n `\n\n ### [orientation](#/c:objc(cs)GMLImage(py)orientation)\n\n `\n ` \n The display orientation of the image. If [imageSourceType](../Classes/GMLImage.html#/c:objc(cs)GMLImage(py)imageSourceType) is [.image](../Classes/GMLImage.html#/c:objc(cs)GMLImage(py)image), the default value is\n `image.imageOrientation`; otherwise the default value is `.up`. \n\n #### Declaration\n\n Objective-C \n\n @property (nonatomic) int orientation;\n\n- `\n ``\n ``\n `\n\n ### [imageSourceType](#/c:objc(cs)GMLImage(py)imageSourceType)\n\n `\n ` \n The type of the image source. \n\n #### Declaration\n\n Objective-C \n\n @property (nonatomic, readonly) ../Type-Definitions.html#/c:GMLImage.h@T@GMLImageSourceType imageSourceType;\n\n- `\n ``\n ``\n `\n\n ### [image](#/c:objc(cs)GMLImage(py)image)\n\n `\n ` \n The source image. `nil` if [imageSourceType](../Classes/GMLImage.html#/c:objc(cs)GMLImage(py)imageSourceType) is not `.image`. \n\n #### Declaration\n\n Objective-C \n\n @property (nonatomic, readonly, nullable) int *image;\n\n- `\n ``\n ``\n `\n\n ### [pixelBuffer](#/c:objc(cs)GMLImage(py)pixelBuffer)\n\n `\n ` \n The source pixel buffer. `nil` if [imageSourceType](../Classes/GMLImage.html#/c:objc(cs)GMLImage(py)imageSourceType) is not `.pixelBuffer`. \n\n #### Declaration\n\n Objective-C \n\n @property (nonatomic, readonly, nullable) CVPixelBufferRef pixelBuffer;\n\n- `\n ``\n ``\n `\n\n ### [sampleBuffer](#/c:objc(cs)GMLImage(py)sampleBuffer)\n\n `\n ` \n The source sample buffer. `nil` if [imageSourceType](../Classes/GMLImage.html#/c:objc(cs)GMLImage(py)imageSourceType) is not `.sampleBuffer`. \n\n #### Declaration\n\n Objective-C \n\n @property (nonatomic, readonly, nullable) CMSampleBufferRef sampleBuffer;\n\n- `\n ``\n ``\n `\n\n ### [-initWithImage:](#/c:objc(cs)GMLImage(im)initWithImage:)\n\n `\n ` \n Initializes an `MLImage` object with the given image. \n\n #### Declaration\n\n Objective-C \n\n - (nullable instancetype)initWithImage:(id)image;\n\n #### Parameters\n\n |---------------|----------------------------------------------------------------------------|\n | ` `*image*` ` | The image to use as the source. Its `CGImage` property must not be `NULL`. |\n\n #### Return Value\n\n A new `MLImage` instance with the given image as the source. `nil` if the given [image](../Classes/GMLImage.html#/c:objc(cs)GMLImage(py)image)\n is `nil` or invalid.\n- `\n ``\n ``\n `\n\n ### [-initWithPixelBuffer:](#/c:objc(cs)GMLImage(im)initWithPixelBuffer:)\n\n `\n ` \n Initializes an `MLImage` object with the given pixel buffer. \n\n #### Declaration\n\n Objective-C \n\n - (nullable instancetype)initWithPixelBuffer:\n (nonnull CVPixelBufferRef)pixelBuffer;\n\n #### Parameters\n\n |---------------------|-----------------------------------------------------------------------------------------------------------------------------|\n | ` `*pixelBuffer*` ` | The pixel buffer to use as the source. It will be retained by the new `MLImage` instance for the duration of its lifecycle. |\n\n #### Return Value\n\n A new `MLImage` instance with the given pixel buffer as the source. `nil` if the given\n pixel buffer is `nil` or invalid.\n- `\n ``\n ``\n `\n\n ### [-initWithSampleBuffer:](#/c:objc(cs)GMLImage(im)initWithSampleBuffer:)\n\n `\n ` \n Initializes an `MLImage` object with the given sample buffer. \n\n #### Declaration\n\n Objective-C \n\n - (nullable instancetype)initWithSampleBuffer:\n (nonnull CMSampleBufferRef)sampleBuffer;\n\n #### Parameters\n\n |----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n | ` `*sampleBuffer*` ` | The sample buffer to use as the source. It will be retained by the new `MLImage` instance for the duration of its lifecycle. The sample buffer must be based on a pixel buffer (not compressed data). In practice, it should be the video output of the camera on an iOS device, not other arbitrary types of `CMSampleBuffer`s. |\n\n #### Return Value\n\n A new `MLImage` instance with the given sample buffer as the source. `nil` if the given\n sample buffer is `nil` or invalid.\n- `\n ``\n ``\n `\n\n ### [-init](#/c:objc(cs)GMLImage(im)init)\n\n `\n ` \n Unavailable. \n\n #### Declaration\n\n Objective-C \n\n - (nonnull instancetype)init;"]]