Merge pull request #89034 from PatrickFarley/comvis-qss

[cog serv] Comvis qss

Author: v-albemi

articles/cognitive-services/Computer-vision/index.yml

@@ -43,7 +43,11 @@ landingContent:
             url: quickstarts-sdk/csharp-sdk.md
           - text: Using the Python SDK
             url: quickstarts-sdk/python-sdk.md
-
+          - text: Using the Java SDK
+            url: quickstarts-sdk/java-sdk.md
+          - text: Using the Node SDK
+            url: quickstarts-sdk/node-sdk.md
+            
 
   - title: Detect objects in images
     linkLists:
@@ -59,6 +63,8 @@ landingContent:
             url: quickstarts-sdk/python-sdk.md
           - text: Using the Java SDK
             url: quickstarts-sdk/java-sdk.md
+          - text: Using the Node SDK
+            url: quickstarts-sdk/node-sdk.md
 
   # Card 
   - title: Apply content tags to images
@@ -75,6 +81,8 @@ landingContent:
             url: quickstarts-sdk/python-sdk.md
           - text: Using the Java SDK
             url: quickstarts-sdk/java-sdk.md
+          - text: Using the Node SDK
+            url: quickstarts-sdk/node-sdk.md
 
   - title: Use containers
     linkLists:
@@ -107,6 +115,8 @@ landingContent:
             url: quickstarts-sdk/python-sdk.md
           - text: Using the Java SDK
             url: quickstarts-sdk/java-sdk.md
+          - text: Using the Node SDK
+            url: quickstarts-sdk/node-sdk.md
 
 #  - title: Get image descriptions
 #    linkLists:

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

@@ -19,6 +19,7 @@ Get started with the Computer Vision client library for Java. Follow these steps
 Use the Computer Vision client library for Java to:
 
 * Analyze an image for tags, text description, faces, adult content, and more.
+* Recognize printed and handwritten text with the Batch Read API.
 
 [Reference documentation](https://docs.microsoft.com/java/api/overview/azure/cognitiveservices/client/computervision?view=azure-java-stable) | [Artifact (Maven)](https://www.nuget.org/packages/Microsoft.Azure.CognitiveServices.Vision.ComputerVision/) | [Samples](https://azure.microsoft.com/resources/samples/?service=cognitive-services&term=vision&sort=0)
 
@@ -110,6 +111,7 @@ These code snippets show you how to do the following tasks with the Computer Vis
 
 * [Authenticate the client](#authenticate-the-client)
 * [Analyze an image](#analyze-an-image)
+* [Read printed and handwritten text](#read-printed-and-handwritten-text)
 
 ## Authenticate the client
 
@@ -207,6 +209,29 @@ The following code prints information about the type of image—whether it i
 
 [!code-java[](~/cognitive-services-quickstart-code/java/ComputerVision/ComputerVisionQuickstart.java?name=snippet_imagetype)]
 
+## Read printed and handwritten text
+
+Computer Vision can read visible text in an image and convert it to a character stream.
+
+> [!NOTE]
+> You can also read text in a remote image using its URL. See the sample code on [GitHub](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/java/ComputerVision/ComputerVisionQuickstart.java) for scenarios involving remote images.
+
+### Call the Recognize API
+
+First, use the following code to call the **recognizePrintedTextInStream** method for the given image. When you add this code to your project, you need to replace the value of `localTextImagePath` with the path to your local image. 
+
+[!code-java[](~/cognitive-services-quickstart-code/java/ComputerVision/ComputerVisionQuickstart.java?name=snippet_imagetype)]
+
+### Print Recognize results
+
+The following block of code processes the returned text and parses it to print out the first word in each line. You can use this code to quickly understand the structure of an **OcrResult** instance.
+
+[!code-java[](~/cognitive-services-quickstart-code/java/ComputerVision/ComputerVisionQuickstart.java?name=snippet_read_print)]
+
+Finally, close out the try/catch block and the method definition.
+
+[!code-java[](~/cognitive-services-quickstart-code/java/ComputerVision/ComputerVisionQuickstart.java?name=snippet_read_catch)]
+
 ## Run the application
 
 You can build the app with:

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

@@ -0,0 +1,265 @@
+---
+title: "Quickstart: Computer Vision client library for Node.js | Microsoft Docs"
+description: Get started with the Computer Vision client library for Node.js...
+services: cognitive-services
+author: PatrickFarley
+manager: nitinme
+ms.service: cognitive-services
+ms.subservice: computer-vision
+ms.topic: quickstart
+ms.date: 09/18/2019
+ms.author: pafarley
+---
+
+# Quickstart: Computer Vision client library for Node.js
+
+Get started with the Computer Vision client library for Node.js. Follow these steps to install the package and try out the example code for basic tasks. 
+
+Use the Computer Vision client library for Node.js to:
+
+* [Analyze an image](#analyze-an-image)
+* [Read printed and handwritten text](#read-printed-and-handwritten-text)
+
+[Reference documentation](https://docs.microsoft.com/javascript/api/@azure/cognitiveservices-computervision/?view=azure-node-latest) | [Library source code](https://github.com/Azure/azure-sdk-for-js/tree/master/sdk/cognitiveservices/cognitiveservices-computervision) | [Package (npm)](https://www.npmjs.com/package/azure-cognitiveservices-computervision) | [Samples](https://azure.microsoft.com/resources/samples/?service=cognitive-services&term=vision&sort=0)
+
+## Prerequisites
+
+* Azure subscription - [Create one for free](https://azure.microsoft.com/free/)
+* The current version of [Node.js](https://nodejs.org/)
+
+## Setting up
+
+### Create a Computer Vision Azure resource
+
+Azure Cognitive Services are represented by Azure resources that you subscribe to. Create a resource for Computer Vision using the [Azure portal](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account) or [Azure CLI](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account-cli) on your local machine. You can also:
+
+* Get a [trial key](https://azure.microsoft.com/try/cognitive-services/#decision) valid for seven days for free. After you sign up, it will be available on the [Azure website](https://azure.microsoft.com/try/cognitive-services/my-apis/).  
+* View your resource on the [Azure portal](https://portal.azure.com/).
+
+After you get a key from your trial subscription or resource, [create environment variables](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account#configure-an-environment-variable-for-authentication) for the key and endpoint URL, named `COMPUTER_VISION_SUBSCRIPTION_KEY` and `COMPUTER_VISION_ENDPOINT` respectively.
+ 
+### Create a new Node.js application
+
+In a console window (such as cmd, PowerShell, or Bash), create a new directory for your app, and navigate to it. 
+
+```console
+mkdir myapp && cd myapp
+```
+
+Run the `npm init` command to create a node application with a `package.json` file. 
+
+```console
+npm init
+```
+
+### Install the client library
+
+Install the `ms-rest-azure` and `azure-cognitiveservices-computervision` NPM packages:
+
+```console
+npm install azure-cognitiveservices-computervision ms-rest-azure
+```
+
+Your app's `package.json` file will be updated with the dependencies.
+
+### Prepare the Node.js script
+
+Create a new file, *index.js*, and open it in a text editor. Add the following import statements.
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_imports)]
+
+Then, define a function `computerVision` and declare an async series with primary function and callback function. You will add your quickstart code into the primary function, and call `computerVision` at the bottom of the script.
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_functiondef_begin)]
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_functiondef_end)]
+
+## Object model
+
+The following classes and interfaces handle some of the major features of the Computer Vision Node.js SDK.
+
+|Name|Description|
+|---|---|
+| [ComputerVisionClient](https://docs.microsoft.com/javascript/api/@azure/cognitiveservices-computervision/computervisionclient?view=azure-node-latest) | This class is needed for all Computer Vision functionality. You instantiate it with your subscription information, and you use it to do most image operations.|
+|[VisualFeatureTypes](https://docs.microsoft.com/javascript/api/@azure/cognitiveservices-computervision/visualfeaturetypes?view=azure-node-latest)| This enum defines the different types of image analysis that can be done in a standard Analyze operation. You specify a set of **VisualFeatureTypes** values depending on your needs. |
+
+## Code examples
+
+These code snippets show you how to do the following tasks with the Computer Vision client library for Node.js:
+
+* [Authenticate the client](#authenticate-the-client)
+* [Analyze an image](#analyze-an-image)
+* [Read printed and handwritten text](#read-printed-and-handwritten-text)
+
+## Authenticate the client
+
+Create variables for your resource's Azure endpoint and key. If you created the environment variable after you launched the application, you will need to close and reopen the editor, IDE, or shell running it to access the variable.
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_vars)]
+
+Instantiate a client with your endpoint and key. Create a [ApiKeyCredentials](https://docs.microsoft.com/python/api/msrest/msrest.authentication.apikeycredentials?view=azure-python) object with your key and endpoint, and use it to create a [ComputerVisionClient](https://docs.microsoft.com/javascript/api/@azure/cognitiveservices-computervision/computervisionclient?view=azure-node-latest) object.
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_client)]
+
+## Analyze an image
+
+The code in this section analyzes remote images to extract various visual features. You can do these operations as part of the **analyzeImage** method of the client object, or you can call them using individual methods. See the [reference documentation](https://docs.microsoft.com/javascript/api/@azure/cognitiveservices-computervision/?view=azure-node-latest) for details.
+
+> [!NOTE]
+> You can also analyze a local image. See the sample code on [GitHub](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/javascript/ComputerVision/ComputerVisionQuickstart.js) for scenarios involving local images.
+
+### Get image description
+
+The following code gets the list of generated captions for the image. See [Describe images](../concept-describing-images.md) for more details.
+
+First, define the URL of an image to analyze:
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_describe_image)]
+
+Then add the following code to get the image description and print it to the console.
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_describe)]
+
+### Get image category
+
+The following code gets the detected category of the image. See [Categorize images](../concept-categorizing-images.md) for more details.
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_categories)]
+
+Define the helper function `formatCategories`:
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_categories_format)]
+
+### Get image tags
+
+The following code gets the set of detected tags in the image. See [Content tags](../concept-tagging-images.md) for more details.
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_tags)]
+
+Define the helper function `formatTags`:
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_tagsformat)]
+
+### Detect objects
+
+The following code detects common objects in the image and prints them to the console. See [Object detection](../concept-object-detection.md) for more details.
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_objects)]
+
+Define the helper function `formatRectObjects`:
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_objectformat)]
+
+### Detect brands
+
+The following code detects corporate brands and logos in the image and prints them to the console. See [Brand detection](../concept-brand-detection.md) for more details.
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_brands)]
+
+### Detect faces
+
+The following code returns the detected faces in the image with their rectangle coordinates and select face attributes. See [Face detection](../concept-detecting-faces.md) for more details.
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_faces)]
+
+Define the helper function `formatRectFaces`:
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_formatfaces)]
+
+### Detect adult or racy content
+
+The following code prints the detected presence of adult or racy content in the image. See [Adult and racy content](../concept-detecting-adult-content.md) for more details.
+
+Define the URL of the image to use:
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_adult_image)] 
+
+Then add the following code to detect adult content and print the results to the console.
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_adult)] 
+
+### Get image color scheme
+
+The following code prints the detected color attributes in the image, like the dominant colors and accent color. See [Color schemes](../concept-detecting-color-schemes.md) for more details.
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_colors)]
+
+Define the helper function `printColorScheme` to print the details of the color scheme to the console.
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_colors_print)]
+
+### Get domain-specific content
+
+Computer Vision can use specialized model to do further analysis on images. See [Domain-specific content](../concept-detecting-domain-content.md) for more details. 
+
+First, define the URL of an image to analyze:
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_domain_image)]
+
+The following code parses data about detected landmarks in the image.
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_landmarks)]
+
+Define the helper function `formatRectDomain` to parse the location data about detected landmarks.
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_landmarks_rect)]
+
+### Get the image type
+
+The following code prints information about the type of image—whether it is clip art or line drawing.
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_imagetype)]
+
+Define the helper function `describeType`:
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_imagetype_describe)]
+
+## Read printed and handwritten text
+
+Computer Vision can read visible text in an image and convert it to a character stream.
+
+> [!NOTE]
+> You can also read text from a local image. See the sample code on [GitHub](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/javascript/ComputerVision/ComputerVisionQuickstart.js) for scenarios involving local images.
+
+### Set up test images
+
+Save a reference the URL of the images you want to extract text from.
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_read_images)]
+
+### Call the Recognize API
+
+Add the code below, which calls the `recognizeText` function for the given images.
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_read_call)]
+
+Define the `recognizeText` function. This calls the **recognizeText** method on the client object, which returns an operation ID and starts an asynchronous process to read the content of the image. Then it uses the operation ID to check the operation at one-second intervals until the results are returned. It then returns the extracted results.
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_read_helper)]
+
+Then, define the helper function `printRecText`, which prints the results of a Recognize operation to the console.
+
+[!code-javascript[](~/cognitive-services-quickstart-code/javascript/ComputerVision/ComputerVisionQuickstart.js?name=snippet_read_print)]
+
+## Run the application
+
+Run the application with the `node` command on your quickstart file.
+
+```console
+node index.js
+```
+
+## Clean up resources
+
+If you want to clean up and remove a Cognitive Services subscription, you can delete the resource or resource group. Deleting the resource group also deletes any other resources associated with it.
+
+* [Portal](../../cognitive-services-apis-create-account.md#clean-up-resources)
+* [Azure CLI](../../cognitive-services-apis-create-account-cli.md#clean-up-resources)
+
+## Next steps
+
+> [!div class="nextstepaction"]
+>[Computer Vision API reference (Node.js)](https://docs.microsoft.com/javascript/api/@azure/cognitiveservices-computervision/?view=azure-node-latest)
+
+* [What is the Computer Vision API?](../Home.md)
+* The source code for this sample can be found on [GitHub](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/javascript/ComputerVision/ComputerVisionQuickstart.js).

articles/cognitive-services/Computer-vision/toc.yml

@@ -15,6 +15,8 @@
       href: quickstarts-sdk/python-sdk.md
     - name: Java SDK
       href: quickstarts-sdk/java-sdk.md
+    - name: Node.js SDK
+      href: quickstarts-sdk/node-sdk.md
   - name: Using the REST API
     items:
     - name: Analyze a remote image