Referencia del framework de MLKitVision
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
GMLImage
@interface GMLImage : NSObject
Una imagen que se usa en el aprendizaje automático en el dispositivo.
-
Es el ancho de la imagen en píxeles.
Declaración
Objective-C
@property (nonatomic, readonly) CGFloat width;
-
Es la altura de la imagen en píxeles.
Declaración
Objective-C
@property (nonatomic, readonly) CGFloat height;
-
Es la orientación en la que se muestra la imagen. Si imageSourceType
es .image
, el valor predeterminado es
image.imageOrientation
; De lo contrario, el valor predeterminado es .up
.
Declaración
Objective-C
@property (nonatomic) int orientation;
-
Es el tipo de fuente de la imagen.
-
Declaración
Objective-C
@property (nonatomic, readonly, nullable) int *image;
-
Es el búfer de píxeles de origen. nil
si imageSourceType
no es .pixelBuffer
.
Declaración
Objective-C
@property (nonatomic, readonly, nullable) CVPixelBufferRef pixelBuffer;
-
Es el búfer de muestra de origen. nil
si imageSourceType
no es .sampleBuffer
.
Declaración
Objective-C
@property (nonatomic, readonly, nullable) CMSampleBufferRef sampleBuffer;
-
Inicializa un objeto MLImage
con la imagen determinada.
Declaración
Objective-C
- (nullable instancetype)initWithImage:(id)image;
Parámetros
image
|
La imagen que se usará como fuente. Su propiedad CGImage no debe ser NULL .
|
Valor de retorno
Una instancia de MLImage
nueva con la imagen determinada como origen. nil
si el valor de image
especificado
es nil
o no válido.
-
Inicializa un objeto MLImage
con el búfer de píxeles determinado.
Declaración
Objective-C
- (nullable instancetype)initWithPixelBuffer:
(nonnull CVPixelBufferRef)pixelBuffer;
Parámetros
pixelBuffer
|
El búfer de píxeles que se usará como fuente. y quedarán retenidos por el nuevo
Instancia MLImage durante su ciclo de vida.
|
Valor de retorno
Una nueva instancia de MLImage
con el búfer de píxeles determinado como origen. nil
si el valor especificado
el búfer de píxeles es nil
o no es válido.
-
Inicializa un objeto MLImage
con el búfer de muestra determinado.
Declaración
Objective-C
- (nullable instancetype)initWithSampleBuffer:
(nonnull CMSampleBufferRef)sampleBuffer;
Parámetros
sampleBuffer
|
El búfer de muestra que se usará como fuente. y quedarán retenidos por el nuevo
Instancia MLImage durante su ciclo de vida. El búfer de muestra se debe basar en un
búfer de píxeles (no datos comprimidos). En la práctica, debería ser la salida de video de la cámara.
en un dispositivo iOS, no otros tipos arbitrarios de CMSampleBuffer .
|
Valor de retorno
Una nueva instancia de MLImage
con el búfer de muestra determinado como origen. nil
si el valor especificado
el búfer de muestra es nil
o no es válido.
-
Declaración
Objective-C
- (nonnull instancetype)init;
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 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;"]]