Esegue la ricerca di somiglianza sulle immagini.
L'API prevede un modello TFLite con metadati del modello TFLite facoltativi, ma fortemente consigliati. .
- Tensore immagine di input (
kTfLiteUInt8
/kTfLiteFloat32
)- input immagine di dimensioni
[batch x height x width x channels]
. - l'inferenza batch non è supportata (
batch
deve essere 1). - sono supportati solo gli ingressi RGB (
channels
devono essere 3). - se il tipo è
kTfLiteFloat32
, è necessario allegare NormalizationOptions ai metadati per la normalizzazione dell'input.
- input immagine di dimensioni
kTfLiteUInt8
/ kTfLiteFloat32
)-
N
componenti corrispondenti alleN
dimensioni del vettore di caratteristiche restituito per questo livello di output. - 2 o 4 dimensioni, ovvero
[1 x N]
o[1 x 1 x 1 x N]
.
TODO(b/180502532): aggiunge il puntatore al modello di esempio.
TODO(b/222671076): aggiunti metodi di creazione di fabbrica senza opzioni, come `createFromFile`, una volta supportato il formato di file singolo (file di indice compresso nel modello).
Classi nidificate
classe | ImageSearcher.ImageSearcherOptions | Opzioni per impostare un ImageSearcher. |
Metodi pubblici
Ricerca immagini statiche | createFromBufferAndOptions (opzioni ByteBuffer modelBuffer, ImageSearcher.ImageSearcherOptions ) Crea un'istanza ImageSearcher con un buffer del modello e ImageSearcher.ImageSearcherOptions . |
Ricerca immagini statiche | createFromBufferAndOptionsImpl ( opzioni ByteBuffer modelBuffer, ImageSearcher.ImageSearcherOptions , int indexFd) |
Ricerca immagini statiche | createFromFileAndOptions (contesto di contesto, stringa modelPath, opzioni ImageSearcher.ImageSearcherOptions ) Crea un'istanza ImageSearcher da ImageSearcher.ImageSearcherOptions . |
Ricerca immagini statiche | createFromFileAndOptions (opzioni File modelFile, ImageSearcher.ImageSearcherOptions ) Crea un'istanza ImageSearcher . |
Elenco < Vicino più vicino > | ricerca (immagine TensorImage , opzioni ImageProcessingOptions ) Esegue l'estrazione di incorporamento sull'oggetto TensorImage fornito con ImageProcessingOptions , seguita dalla ricerca del vicino più vicino nell'indice. |
Elenco < Vicino più vicino > | |
Elenco < Vicino più vicino > | ricerca (immagine MlImage , opzioni ImageProcessingOptions ) Esegue l'estrazione dell'incorporamento sull'oggetto MlImage fornito con ImageProcessingOptions , seguita dalla ricerca del vicino più vicino nell'indice. |
Elenco < Vicino più vicino > | ricerca (immagine TensorImage ) Esegue l'estrazione dell'incorporamento sul TensorImage fornito, seguita dalla ricerca del vicino più vicino nell'indice. |
Metodi ereditati
Metodi pubblici
ImageSearcher pubblico statico createFromBufferAndOptions (opzioni ByteBuffer modelBuffer, ImageSearcher.ImageSearcherOptions )
Crea un'istanza ImageSearcher
con un buffer del modello e ImageSearcher.ImageSearcherOptions
.
Parametri
modelBuffer | un ByteBuffer diretto o un MappedByteBuffer del modello di ricerca |
---|---|
opzioni |
Lancia
IllegalArgumentException | se il buffer del modello non è un ByteBuffer diretto o un MappedByteBuffer |
---|---|
IOException | se si verifica un errore I/O durante il caricamento del file indice |
IllegalStateException | se c'è un errore interno |
RuntimeException | se è presente un errore altrimenti non specificato |
ImageSearcher pubblico statico createFromBufferAndOptionsImpl ( ByteBuffer modelBuffer, opzioni ImageSearcher.ImageSearcherOptions , int indexFd)
Parametri
modelBuffer | |
---|---|
opzioni | |
indiceFd |
ImageSearcher pubblico statico createFromFileAndOptions (contesto di contesto, stringa modelPath, opzioni ImageSearcher.ImageSearcherOptions )
Crea un'istanza ImageSearcher
da ImageSearcher.ImageSearcherOptions
.
Parametri
contesto | |
---|---|
modelPath | percorso del modello di ricerca con metadati nelle risorse |
opzioni |
Lancia
IOException | se si verifica un errore I/O durante il caricamento del modello tflite o del file indice |
---|---|
IllegalArgumentException | se un argomento non è valido |
IllegalStateException | se c'è un errore interno |
RuntimeException | se è presente un errore altrimenti non specificato |
ImageSearcher pubblico statico createFromFileAndOptions (opzioni file modelFile, ImageSearcher.ImageSearcherOptions )
Crea un'istanza ImageSearcher
.
Parametri
modelFile | l'istanza File del modello di ricerca |
---|---|
opzioni |
Lancia
IOException | se si verifica un errore I/O durante il caricamento del modello tflite o del file indice |
---|---|
IllegalArgumentException | se un argomento non è valido |
IllegalStateException | se c'è un errore interno |
RuntimeException | se è presente un errore altrimenti non specificato |
elenco pubblico < NearestNeighbor > ricerca (immagine TensorImage , opzioni ImageProcessingOptions )
Esegue l'estrazione di incorporamento sull'oggetto TensorImage
fornito con ImageProcessingOptions
, seguita dalla ricerca del vicino più vicino nell'indice.
ImageSearcher
supporta le seguenti opzioni:
- Regione di interesse (ROI) (tramite
ImageProcessingOptions.Builder.setRoi(Rect)
). Per impostazione predefinita, viene utilizzata l'intera immagine. - rotazione dell'immagine (tramite
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
). Il valore predefinito èImageProcessingOptions.Orientation.TOP_LEFT
.
ImageSearcher
supporta i seguenti tipi di spazio colore TensorImage
:
Parametri
Immagine | un oggetto TensorImage UINT8 che rappresenta un'immagine RGB o YUV |
---|---|
opzioni |
Lancia
IllegalArgumentException | se il tipo di spazio colore dell'immagine non è supportato |
---|
elenco pubblico < vicino più vicino > ricerca (immagine MlImage )
Esegue l'estrazione dell'incorporamento sul MlImage
fornito, seguita dalla ricerca del vicino più vicino nell'indice.
Parametri
Immagine | un oggetto MlImage che rappresenta un'immagine |
---|
Lancia
IllegalArgumentException | se il tipo di archiviazione o il formato dell'immagine non è supportato |
---|
elenco pubblico <NeaestNeighbor> ricerca (immagine MlImage , opzioni ImageProcessingOptions )
Esegue l'estrazione dell'incorporamento sull'oggetto MlImage
fornito con ImageProcessingOptions
, seguita dalla ricerca del vicino più vicino nell'indice.
ImageSearcher
supporta le seguenti opzioni:
- Regione di interesse (ROI) (tramite
ImageProcessingOptions.Builder.setRoi(Rect)
). Per impostazione predefinita, viene utilizzata l'intera immagine. - rotazione dell'immagine (tramite
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
). Il valore predefinito èImageProcessingOptions.Orientation.TOP_LEFT
.MlImage.getRotation()
non è efficace.
Parametri
Immagine | un oggetto MlImage che rappresenta un'immagine |
---|---|
opzioni | configura le opzioni tra cui ROI e rotazione |
Lancia
IllegalArgumentException | se il tipo di archiviazione o il formato dell'immagine non è supportato |
---|
ricerca elenco pubblico < vicino più vicino > (immagine TensorImage )
Esegue l'estrazione dell'incorporamento sul TensorImage
fornito, seguita dalla ricerca del vicino più vicino nell'indice.
ImageSearcher
supporta i seguenti tipi di spazio colore TensorImage
:
Parametri
Immagine | un oggetto TensorImage UINT8 che rappresenta un'immagine RGB o YUV |
---|
Lancia
IllegalArgumentException | se il tipo di spazio colore dell'immagine non è supportato |
---|