Merge pull request #77110 from PatrickFarley/read-api-ga

[Cog serv] Read api ga

Author: PRMerger16

articles/cognitive-services/Computer-vision/Home.md

@@ -43,7 +43,7 @@ You can analyze images to detect and provide insights about their visual feature
 
 You can use Computer Vision to extract text from an image into a machine-readable character stream using [optical character recognition (OCR)](concept-recognizing-text.md#ocr-optical-character-recognition-api). If needed, OCR corrects the rotation of the recognized text and provides the frame coordinates of each word. OCR supports 25 languages and automatically detects the language of the recognized text.
 
-You can also use the [Read API](concept-recognizing-text.md#read-api) to extract both printed and handwritten text from images and text-heavy documents. The Read API uses updated models and works for a variety objects with different surfaces and backgrounds, such as receipts, posters, business cards, letters, and whiteboards. Currently, the Read API is in preview, and English is the only supported language.
+You can also use the [Read API](concept-recognizing-text.md#read-api) to extract both printed and handwritten text from images and text-heavy documents. The Read API uses updated models and works for a variety objects with different surfaces and backgrounds, such as receipts, posters, business cards, letters, and whiteboards. Currently, English is the only supported language.
 
 ## Moderate content in images
 

articles/cognitive-services/Computer-vision/QuickStarts/CSharp-hand-text.md

@@ -106,11 +106,8 @@ namespace CSHttpClientSample
                 client.DefaultRequestHeaders.Add(
                     "Ocp-Apim-Subscription-Key", subscriptionKey);
 
-                // Request parameter.
-                string requestParameters = "mode=Handwritten";
-
                 // Assemble the URI for the REST API method.
-                string uri = uriBase + "?" + requestParameters;
+                string uri = uriBase;
 
                 HttpResponseMessage response;
 

articles/cognitive-services/Computer-vision/QuickStarts/java-hand-text.md

@@ -94,9 +94,6 @@ public class Main {
 
             URIBuilder builder = new URIBuilder(uriBase);
 
-            // Request parameter.
-            builder.setParameter("mode", "Handwritten");
-
             // Prepare the URI for the REST API method.
             URI uri = builder.build();
             HttpPost request = new HttpPost(uri);

articles/cognitive-services/Computer-vision/QuickStarts/javascript-hand-text.md

@@ -69,11 +69,6 @@ To create and run the sample, do the following steps:
         var uriBase =
             "https://westus.api.cognitive.microsoft.com/vision/v2.0/read/core/asyncBatchAnalyze";
 
-        // Request parameter.
-        var params = {
-            "mode": "Handwritten",
-        };
-
         // Display the image.
         var sourceImageUrl = document.getElementById("inputImage").value;
         document.querySelector("#sourceImage").src = sourceImageUrl;
@@ -83,7 +78,7 @@ To create and run the sample, do the following steps:
         //
         // Make the first REST API call to submit the image for processing.
         $.ajax({
-            url: uriBase + "?" + $.param(params),
+            url: uriBase,
 
             // Request headers.
             beforeSend: function(jqXHR){

articles/cognitive-services/Computer-vision/QuickStarts/python-hand-text.md

@@ -73,12 +73,9 @@ text_recognition_url = vision_base_url + "read/core/asyncBatchAnalyze"
 image_url = "https://upload.wikimedia.org/wikipedia/commons/d/dd/Cursive_Writing_on_Notebook_paper.jpg"
 
 headers = {'Ocp-Apim-Subscription-Key': subscription_key}
-# Note: The request parameter changed for APIv2.
-# For APIv1, it is 'handwriting': 'true'.
-params  = {'mode': 'Handwritten'}
 data    = {'url': image_url}
 response = requests.post(
-    text_recognition_url, headers=headers, params=params, json=data)
+    text_recognition_url, headers=headers, json=data)
 response.raise_for_status()
 
 # Extracting handwritten text requires two API calls: One call to submit the

articles/cognitive-services/Computer-vision/concept-recognizing-text.md

@@ -20,12 +20,12 @@ Computer Vision provides a number of services that detect and extract printed or
 
 ## Read API
 
-The Read API detects text content in an image using our latest recognition models and converts the identified text into a machine-readable character stream. It is optimized for text-heavy images (such as documents that have been digitally scanned) and for images with a lot of visual noise. It executes asynchronously because larger documents can take several minutes to return a result.
+The Read API detects text content in an image using our latest recognition models and converts the identified text into a machine-readable character stream. It's optimized for text-heavy images (such as documents that have been digitally scanned) and for images with a lot of visual noise. It will determine which recognition model to use for each line of text, supporting images with both printed and handwritten text. The Read API executes asynchronously because larger documents can take several minutes to return a result.
 
 The Read operation maintains the original line groupings of recognized words in its output. Each line comes with bounding box coordinates, and each word within the line also has its own coordinates. If a word was recognized with low confidence, that information is conveyed as well. See the [Read API reference docs](https://westus.dev.cognitive.microsoft.com/docs/services/5adf991815e1060e6355ad44/operations/2afb498089f74080d7ef85eb) to learn more.
 
 > [!NOTE]
-> This feature is currently in preview and is only available for English text.
+> This feature is only available for English text.
 
 ### Image requirements
 
@@ -76,7 +76,7 @@ The Recognize Text API works with images that meet the following requirements:
 - The dimensions of the image must be between 50 x 50 and 4200 x 4200 pixels.
 - The file size of the image must be less than 4 megabytes (MB).
 
-## Improve results
+## Limitations
 
 The accuracy of text recognition operations depends on the quality of the images. The following factors may cause an inaccurate reading:
 

articles/cognitive-services/Computer-vision/quickstarts-sdk/csharp-hand-text-sdk.md

@@ -49,10 +49,6 @@ To run the sample, do the following steps:
             // subscriptionKey = "0123456789abcdef0123456789ABCDEF"
             private const string subscriptionKey = "<Subscription key>";
 
-            // For printed text, change to TextRecognitionMode.Printed
-            private const TextRecognitionMode textRecognitionMode =
-                TextRecognitionMode.Handwritten;
-
             // localImagePath = @"C:\Documents\LocalImage.jpg"
             private const string localImagePath = @"<LocalImage>";
 
@@ -101,7 +97,7 @@ To run the sample, do the following steps:
                 // Start the async process to read the text
                 BatchReadFileHeaders textHeaders =
                     await computerVision.BatchReadFileAsync(
-                        imageUrl, textRecognitionMode);
+                        imageUrl);
 
                 await GetTextAsync(computerVision, textHeaders.OperationLocation);
             }
@@ -122,7 +118,7 @@ To run the sample, do the following steps:
                     // Start the async process to recognize the text
                     BatchReadFileInStreamHeaders textHeaders =
                         await computerVision.BatchReadFileInStreamAsync(
-                            imageStream, textRecognitionMode);
+                            imageStream);
 
                     await GetTextAsync(computerVision, textHeaders.OperationLocation);
                 }
@@ -172,7 +168,6 @@ To run the sample, do the following steps:
 
 1. Replace `<Subscription Key>` with your valid subscription key.
 1. Change `computerVision.Endpoint` to the Azure region associated with your subscription keys, if necessary.
-1. Optionally set `textRecognitionMode` to `TextRecognitionMode.Printed`.
 1. Replace `<LocalImage>` with the path and file name of a local image.
 1. Optionally, set `remoteImageUrl` to a different image.
 1. Run the program.

articles/cognitive-services/Computer-vision/quickstarts-sdk/python-sdk.md

@@ -215,18 +215,16 @@ You can get any handwritten or printed text from an image. This requires two cal
 
 ```Python
 # import models
-from azure.cognitiveservices.vision.computervision.models import TextRecognitionMode
 from azure.cognitiveservices.vision.computervision.models import TextOperationStatusCodes
 import time
 
 url = "https://azurecomcdn.azureedge.net/cvt-1979217d3d0d31c5c87cbd991bccfee2d184b55eeb4081200012bdaf6a65601a/images/shared/cognitive-services-demos/read-text/read-1-thumbnail.png"
-mode = TextRecognitionMode.handwritten
 raw = True
 custom_headers = None
 numberOfCharsInOperationId = 36
 
 # Async SDK call
-rawHttpResponse = client.batch_read_file(url, mode, custom_headers,  raw)
+rawHttpResponse = client.batch_read_file(url, custom_headers,  raw)
 
 # Get ID from returned headers
 operationLocation = rawHttpResponse.headers["Operation-Location"]