REF API untuk API Pengenalan Teks di SDK Aplikasi Windows
Pelajari tentang API pengenalan teks Artificial Intelligence (AI) baru yang akan dikirim dengan SDK Aplikasi Windows dan dapat digunakan untuk mengidentifikasi karakter dalam gambar, mengenali kata, garis, batas poligonal, dan memberikan tingkat keyakinan untuk kecocokan yang dihasilkan.
Untuk detail selengkapnya, lihat Pengenalan Teks di SDK Aplikasi Windows.
Penting
Saluran eksperimental SDK Aplikasi Windows mencakup API dan fitur pada tahap awal pengembangan. Semua API di saluran eksperimental tunduk pada revisi yang luas dan melanggar perubahan dan dapat dihapus dari rilis berikutnya kapan saja. Mereka tidak didukung untuk digunakan di lingkungan produksi, dan aplikasi yang menggunakan fitur eksperimental tidak dapat diterbitkan ke Microsoft Store.
Namespace Microsoft.Windows.Vision
Menyediakan API untuk model pembelajaran mesin yang menganalisis konten tekstual gambar.
Struktur Microsoft.Windows.Vision.TextRecognition.BoundingBox
public struct BoundingBox
Poligon dengan 4 poin yang digunakan untuk batas kata dan baris teks yang dikenali.
Bidang
BottomLeft
Sudut kiri bawah kotak pembatas.
Tegak Luncur
Sudut kanan bawah kotak pembatas.
TopLeft
Titik kiri atas kotak pembatas.
TopRight
Titik kanan atas kotak pembatas.
Keterangan
Saat dikembalikan sebagai batas untuk kata atau baris, titik TopLeft, TopRight, BottomRight, dan BottomLeft relatif terhadap rotasi dan condong teks yang dikenali dalam gambar. Diagram berikut menunjukkan tata letak titik untuk rotasi teks yang berbeda di mana 0 adalah TopLeft, 1 adalah TopRight, 2 adalah BottomRight, dan 3 adalah BottomLeft, semuanya relatif terhadap teks.
Enum Microsoft.Windows.Vision.DetectedLineStyle
public enum DetectedLineStyle
Menentukan gaya garis yang dapat dikenali.
Bidang Enum
Tulisan tangan: 0
Baris teks ditulis tangan.
Lainnya: 1
Baris teks tidak ditulis tangan.
Enum Microsoft.Windows.Vision.OrientationDetectionOptions
public enum OrientationDetectionOptions
Menentukan orientasi teks yang dapat dikenali.
Bidang Enum
Tidak Ada: 0
Orientasi tidak dikenali.
DetectOrientation: 1
Orientasi dikenali.
Kelas Microsoft.Windows.Vision.RecognizedLine
public sealed class RecognizedLine
Mewakili satu baris teks yang dikenali.
Properti Microsoft.Windows.Vision.RecognizedLine.Style
public Microsoft.Windows.Vision.RecognizedLineStyle Style { get; }
Mendapatkan gaya garis yang dikenali.
Nilai properti
gaya garis yang dikenali.
Keterangan
Termasuk apakah baris teks ditulis tangan atau tidak dan tingkat keyakinan pengenalan.
Properti Microsoft.Windows.Vision.RecognizedLine.Text
public string Text { get; }
Mendapatkan teks baris yang dikenali.
Nilai properti
Teks baris yang dikenali.
Keterangan
Semua kata digabungkan dengan spasi.
Properti Microsoft.Windows.Vision.RecognizedLine.Words
public Microsoft.Windows.Vision.RecognizedWord[] Words { get; }
Kata-kata dalam baris yang dikenali.
Nilai properti
Kata-kata dalam baris yang dikenali.
Struktur Microsoft.Windows.Vision.RecognizedLineStyle
public struct RecognizedLineStyle
Mewakili gaya garis yang dikenali.
Bidang struct
Keyakinan
Tingkat keyakinan pengenalan gaya garis.
Nama
Nama gaya garis.
Kelas Microsoft.Windows.Vision.RecognizedText
public sealed class RecognizedText
Mewakili hasil operasi pengenalan gambar ke teks.
Properti Microsoft.Windows.Vision.RecognizedText.ImageAngle
public float ImageAngle { get; }
Mendapatkan sudut rotasi searah jarum jam dari teks yang dikenali dalam derajat.
Nilai properti
Sudut rotasi searah jarum jam dari teks yang dikenali dalam derajat.
Properti Microsoft.Windows.Vision.RecognizedText.Lines
public Microsoft.Windows.Vision.RecognizedLine[] Lines { get; }
Mendapatkan koleksi garis yang dikenali.
Nilai properti
Kumpulan garis yang dikenali.
Kelas Microsoft.Windows.Vision.RecognizedWord
public sealed class RecognizedWord
Mewakili satu kata yang dikenali.
Properti Microsoft.Windows.Vision.RecognizedWord.BoundingBox
public Microsoft.Windows.Vision.BoundingBox BoundingBox { get; }
Mendapatkan batas kuadrilateral dari kata yang dikenali.
Nilai properti
Batas kuadrilateral dari kata yang dikenali. TopLeft relatif terhadap rotasi kata.
Properti Microsoft.Windows.Vision.RecognizedWord.Confidence
public float Confidence { get; }
Mendapatkan seberapa besar kemungkinan kata ini dikenali dengan benar.
Nilai properti
Wow kemungkinan kata ini dikenali dengan benar. Nilai berkisar dari 0,0 hingga 1,0, inklusif.
Properti Microsoft.Windows.Vision.RecognizedWord.Text
public string Text { get; }
Mendapatkan teks kata yang dikenali.
Nilai properti
Teks kata yang dikenali.
Kelas Microsoft.Windows.Vision.TextRecognition.TextRecognizer
public sealed class TextRecognizer : System.IDisposable
Mengenali kata dan garis, dan batas kuadrilateralnya, dalam gambar sumber.
Metode Microsoft.Windows.Vision.TextRecognizer.Close
Membuang objek dan sumber daya terkait.
Keterangan
Tidak diimplementasikan dalam C#.
Metode Microsoft.Windows.Vision.TextRecognizer.CreateAsync
public static Windows.Foundation.IAsyncOperation<Microsoft.Windows.Vision.TextRecognizer> CreateAsync ();
Secara asinkron membuat instans baru kelas TextRecognizer.
Mengembalikan
Instans baru kelas TextRecognizer.
Ini akan mengembalikan kesalahan jika GetModelReadyStatus tidak Siap.
Metode Microsoft.Windows.Vision.TextRecognizer.IsAvailable
public static bool IsAvailable ();
Mengambil apakah model bahasa yang mendasar diinstal.
Mengembalikan
True jika model bahasa yang mendasar diinstal. Jika tidak, salah.
Metode Microsoft.Windows.Vision.TextRecognizer.MakeAvailableAsync
public static Windows.Foundation.IAsyncOperationWithProgress<Microsoft.Windows.Management.Deployment.PackageDeploymentResult,
Microsoft.Windows.Management.Deployment.PackageDeploymentProgress> MakeAvailableAsync ();
Memastikan model bahasa yang mendasar diinstal dan tersedia untuk digunakan.
Mengembalikan
Tindakan asinkron dengan kemajuan yang mengembalikan PackageDeploymentResult setelah selesai.
Metode Microsoft.Windows.Vision.TextRecognizer.RecognizeTextFromImage(Microsoft.Windows.Imaging.ImageBuffer, Microsoft.Windows.Vision.TextRecognizerOptions)
public Microsoft.Windows.Vision.RecognizedText RecognizeTextFromImage (Microsoft.Windows.Imaging.ImageBuffer imageBuffer,
Microsoft.Windows.Vision.TextRecognizerOptions options);
Kenali teks dalam gambar yang disediakan.
Parameter
imageBuffer
Bitmap yang tidak dikompresi.
opsi
Opsi untuk mengonfigurasi model pengenalan teks untuk TextRecognizer.
Mengembalikan
Teks yang dikenali.
Metode Microsoft.Windows.Vision.TextRecognizer.RecognizeTextFromImageAsync(Microsoft.Windows.Imaging.ImageBuffer, Microsoft.Windows.Vision.TextRecognizerOptions)
public Windows.Foundation.IAsyncOperation<Microsoft.Windows.Vision.RecognizedText> RecognizeTextFromImageAsync (Microsoft.Windows.Imaging.ImageBuffer imageBuffer,
Microsoft.Windows.Vision.TextRecognizerOptions options);
Mengenali teks secara asinkron dalam gambar yang disediakan.
Parameter
imageBuffer
Bitmap yang tidak dikompresi.
opsi
Opsi untuk mengonfigurasi model pengenalan teks untuk TextRecognizer.
Mengembalikan
Teks yang dikenali.
Kelas Microsoft.Windows.Vision.TextRecognizerOptions
public sealed class TextRecognizerOptions
Menyediakan opsi untuk mengonfigurasi model pengenalan teks untuk TextRecognizer.
Properti Microsoft.Windows.Vision.TextRecognizerOptions.MaxAnalysisSize
public Windows.Graphics.SizeInt32 MaxAnalysisSize { get; set; }
Mendapatkan atau mengatur ukuran gambar maksimum.
Nilai properti
Ukuran gambar maksimum. Nilai defaultnya adalah lebar 1152 dan tinggi 768.
Keterangan
Ukuran ini adalah saran, dan mungkin tidak selalu dihormati.
Jika gambar sumber lebih besar dari ukuran maksimum, gambar tersebut akan secara otomatis diturunkan ke batas ukuran atas.
Properti Microsoft.Windows.Vision.TextRecognizerOptions.MaxLineCount
public uint MaxLineCount { get; set; }
Mendapatkan atau mengatur jumlah baris maksimum yang akan dikembalikan dari operasi pengenalan.
Nilai properti
Jumlah maksimum baris yang akan dikembalikan dari operasi pengenalan.
Keterangan
Default ke MaxLineCountSupported. Jika ditentukan, baris maksimum yang dikembalikan akan menjadi lebih kecil dari nilai ini dan MaxLineCountSupported.
Properti Microsoft.Windows.Vision.TextRecognizerOptions.OrientationDetection
public Microsoft.Windows.Vision.OrientationDetectionOptions OrientationDetection { get; set; }
Mendapatkan atau mengatur apakah akan mendeteksi orientasi teks.
Nilai properti
Apakah akan mendeteksi orientasi teks. Nilai defaultnya adalah Tidak Ada.
Konstruktor Microsoft.Windows.Vision.TextRecognizerOptions.#ctor
public TextRecognizerOptions ();
Menginisialisasi instans baru kelas TextRecognizerOptions.
Namespace Microsoft.Windows.Imaging
Menyediakan API untuk model pembelajaran mesin yang memanipulasi gambar.
Kelas Microsoft.Windows.Imaging.ImageBuffer
public sealed class ImageBuffer : System.IDisposable
Mewakili bitmap yang tidak dikompresi untuk marshaling lintas proses yang efisien.
Keterangan
ImageBuffer dapat digunakan dengan API model AI seperti TextRecognizer yang memerlukan data gambar. Penggunaan umum melibatkan pembuatan ImageBuffer dari SoftwareBitmap yang ada.
Properti Microsoft.Windows.Imaging.ImageBuffer.Buffer
public Windows.Storage.Streams.IBuffer Buffer { get; }
Mendapatkan buffer gambar saat ini.
Nilai properti
Buffer gambar saat ini.
Properti Microsoft.Windows.Imaging.ImageBuffer.BufferLength
public uint BufferLength { get; }
Mendapatkan panjang buffer gambar.
Nilai properti
Panjang buffer gambar.
Metode Microsoft.Windows.Imaging.ImageBuffer.Close
Membuang objek dan sumber daya terkait.
Keterangan
Tidak diimplementasikan dalam C#.
Metode Microsoft.Windows.Imaging.ImageBuffer.CopyToBuffer(System.Byte[])
public void CopyToBuffer (byte[] values);
Menyalin buffer saat ini ke dalam buffer target yang disediakan.
Parameter
nilai
Vektor byte di buffer.
Metode Microsoft.Windows.Imaging.ImageBuffer.CreateBufferAttachedToBitmap(Windows.Graphics.Imaging.SoftwareBitmap)
public static Microsoft.Windows.Imaging.ImageBuffer CreateBufferAttachedToBitmap (Windows.Graphics.Imaging.SoftwareBitmap softwareBitmap);
Buat ImageBuffer baru dari SotftwareBitmap yang ada dengan mendapatkan IMemoryBufferReference dari objek bitmap.
Parameter
softwareBitmap
SotftwareBitmap untuk membuat ImageBuffer.
Mengembalikan
ImageBuffer atau null jika formatnya tidak didukung.
Keterangan
SoftwareBitmap dikunci hingga operasi asinkron selesai dan ImageBuffer baru dihancurkan.
Metode Microsoft.Windows.Imaging.ImageBuffer.CreateCopyFromBitmap(Windows.Graphics.Imaging.SoftwareBitmap)
public static Microsoft.Windows.Imaging.ImageBuffer CreateCopyFromBitmap (Windows.Graphics.Imaging.SoftwareBitmap softwareBitmap);
Buat ImageBuffer baru dari SotftwareBitmap yang ada dengan menyalin data bitmap yang mendasar.
Parameter
softwareBitmap
SotftwareBitmap untuk membuat ImageBuffer.
Mengembalikan
ImageBuffer atau null jika formatnya tidak didukung.
Keterangan
SoftwareBitmap dikunci hingga operasi asinkron selesai dan ImageBuffer baru dihancurkan.
Metode Microsoft.Windows.Imaging.ImageBuffer.CreateSoftwareBitmap
public Windows.Graphics.Imaging.SoftwareBitmap CreateSoftwareBitmap ();
Buat SoftwareBitmap baru jenis piksel BGRA32 dari data piksel yang disimpan di ImageBuffer.
Mengembalikan
SoftwareBitmap baru jenis piksel BGRA32.
Properti Microsoft.Windows.Imaging.ImageBuffer.Height
public uint Height { get; }
Mendapatkan tinggi gambar, dalam piksel.
Nilai properti
Tinggi gambar, dalam piksel.
Konstruktor Microsoft.Windows.Imaging.ImageBuffer.#ctor(Windows.Storage.Streams.IBuffer, Microsoft.Windows.Imaging.PixelFormat, System.UInt32, System.UInt32)
public ImageBuffer (Windows.Storage.Streams.IBuffer buffer,
Microsoft.Windows.Imaging.PixelFormat pixelFormat, uint width, uint height);
Menginisialisasi instans baru kelas ImageBuffer.
Parameter
Buffer
The ImageBuffer.
pixelFormat
Format piksel gambar.
lebar
Lebar gambar, dalam piksel.
tinggi
Tinggi gambar, dalam piksel.
Properti Microsoft.Windows.Imaging.ImageBuffer.PixelFormat
public Microsoft.Windows.Imaging.PixelFormat PixelFormat { get; }
Mendapatkan format piksel gambar.
Nilai properti
Format piksel gambar.
Properti Microsoft.Windows.Imaging.ImageBuffer.Width
public uint Width { get; }
Mendapatkan lebar gambar, dalam piksel.
Nilai properti
Lebar gambar, dalam piksel.
Enum Microsoft.Windows.Imaging.PixelFormat
public enum PixelFormat
Menentukan jenis tata letak biner untuk data bitmap yang mendasarinya.
Bidang Enum
Tidak ditentukan: 0
Format biner tidak terdefinisi.
Rgb24: 1
Format biner adalah 24 bit per piksel; Masing-masing 8 bit digunakan untuk komponen merah, hijau, dan biru.
Argb32: 2
Format biner 32 bit per piksel; Masing-masing 8 bit digunakan untuk komponen alfa, merah, hijau, dan biru.
Rgba32: 3
Format biner adalah 32 bit per piksel; Masing-masing 8 bit digunakan untuk komponen merah, hijau, biru, dan alfa. Komponen warna disimpan dalam urutan merah, hijau, biru, dan alfa.
Bgra32: 4
Format biner adalah 32 bit per piksel; Masing-masing 8 bit digunakan untuk komponen biru, hijau, merah, dan alfa. Komponen warna disimpan dalam urutan biru, hijau, merah, dan alfa.
Abu-abu8: 5
Format biner adalah 16 bit per piksel. Informasi warna menentukan 65536 warna abu-abu.
Konten terkait
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk