Merge pull request #5753 from MicrosoftDocs/edit_12630

Edit Request #12630 ready for review

Author: tapanm-MSFT

powerapps-docs/maker/canvas-apps/media/augmented-3d/augmented-3d-viewer-controls.png

@@ -2,11 +2,10 @@
 title: Use the View in 3D control in Power Apps
 description: View 3D models in Power Apps.
 author: anuitz
-
 ms.topic: conceptual
 ms.custom: canvas
 ms.reviewer: tapanm
-ms.date: 3/25/2021
+ms.date: 02/15/2022
 ms.subservice: canvas-maker
 ms.author: anuitz
 search.audienceType: 
@@ -20,83 +19,61 @@ contributors:
 
 # View 3D content in Power Apps
 
-Add 3D content to your canvas apps. Use the **View in 3D** control to rotate and zoom into the model with simple gestures.
-
-You can display a single 3D model, or you can let the user select from a gallery [by connecting to a **Gallery** control](mixed-reality-component-view-3d-store.md).
-
-:::image type="content" source="./media/augmented-overview/view-in-3d.png" alt-text="Photo showing a 3D object being viewed in a mobile device.":::
+Easily add interactive 3D content to your canvas apps. You can [select from a gallery of 3D content](mixed-reality-component-view-3d-store.md) then rotate and zoom into the model with simple gestures.
 
+:::image type="content" source="./media/augmented-overview/view-in-3d.png" alt-text="A photo of two phones side by side, both of which show a 3D model of a forklift viewed in two mobile apps.":::
 
 > [!IMPORTANT]
-> Your 3D content must be in the .glb, .obj, or .stl file formats.  
-> You can [convert your existing 3D models into the .glb file format](/dynamics365/mixed-reality/guides/3d-content-guidelines/) from a variety of 3D formats.
+> Your 3D content must be in the .glb, .obj, or .stl file formats. You can [convert your existing 3D models into the .glb file format](/dynamics365/mixed-reality/guides/3d-content-guidelines/) from a variety of 3D formats.
 
 > [!TIP]
-> The MR controls in Power Apps leverage Babylon and Babylon React Native. As a result of this shared MR platform, 3D content that works in the [Babylon sandbox](https://sandbox.babylonjs.com/) should work in Power Apps. For troubleshooting and help, submit a ticket in the Admin Center for Mixed Reality, or [post a question on the Power Apps community forum](https://powerusers.microsoft.com/t5/Get-Help-with-Power-Apps/ct-p/PA_General) (be sure to tag it with "mixed reality".)
-
-
-## Use the control
-
-Insert the control into your app as you normally would for any other control or control.
-
-With an app open for editing in [Power Apps Studio](https://create.powerapps.com):
-
-1. Open the **Insert** tab.
-2. Expand **Media**.
-3. Select the control **View in 3D** to place it in the center of the app screen, or drag and drop it to position it anywhere on the screen.
-
-
-    :::image type="content" source="./media/augmented-3d/augmented-3d-insert.png" alt-text="Insert the View in 3D control into the app.":::
-
-See the [Load models with the View in 3D control](mixed-reality-component-view-3d-store.md) topic for details on how to connect existing and external models with URLs, as media attachments, or as encoded URIs.
+> The mixed reality (MR) controls in Power Apps use Babylon and Babylon React Native. Mixed reality content that works in the [Babylon sandbox](https://sandbox.babylonjs.com/) should work in Power Apps through this shared MR platform. If your content works in Babylon but not in Power Apps, ask a question in the [Power Apps Community Forum](https://powerusers.microsoft.com/t5/Get-Help-with-Power-Apps/ct-p/PA_General). (Tag it with "mixed reality.")
 
-You can modify the control with a number of properties.
+## Add View in 3D control to an app screen
 
-### Properties
+With your app open for [editing](edit-app.md) in [Power Apps Studio](https://create.powerapps.com):
 
-The following properties are on the control's **View in 3D** pane on the **Properties** and **Advanced** tabs.
+1. Open the **Insert** tab and expand **Media**.
+2. Select **View in 3D** to place the control in the app screen, or drag the control to the screen to position it more precisely.
 
+## Key properties
 
 
-:::image type="content" source="./media/augmented-3d/augmented-3d-viewer-controls.png" alt-text="Properties on the control's View in 3D pane.":::
+Change the 3D content control's behavior and appearance using properties. Some properties are only available on the **Advanced** tab.
 
-Some properties are only available in the **Advanced** tab on the **View in 3D** pane.
+:::image type="content" source="./media/augmented-3d/augmented-3d-viewer-controls.png" alt-text="A 3D content control displayed next to the properties tab in Power Apps Studio.":::
 
-Property | Description | Type | Location
-- | - | - | -
-Source | Data source that identifies the .glb file to display. The **View in 3D** control supports loading models from:<br/><ul><li>Publicly accessible, CORS-compliant URLs</li><li>Base64-encoded URIs</li><li>Attachments or media content accessed through data connectors</li></ul>See the [Loading external 3D models topic](mixed-reality-component-view-3d-store.md) for more details. | Not applicable | **Properties** (also in **Advanced**)
-Alternative text | Text to be displayed if the model can't load, or if the app user hovers on the model. | String | **Properties** (also in **Advanced** as **AltText**)
-Background fill | Set the background color for the control. | Color picker | **Properties** (also in **Advanced** as **BackgroundFill**, where it accepts RGBA or HTML hexadecimal color codes)
-Pins(Items) | [Add pins to specific coordinates on the 3D model](mixed-reality-add-pins-3d-model.md). | Data table | **Properties** (also in **Advanced** and the formula bar as **Items**)
-Show pins | Show the pins defined in **Pins(Items)**. | Toggle | **Properties** (also in **Advanced** as **ShowPins**)
-Show reset button | Enables or disables the reset button, which resets the camera view onto the model. | Toggle | **Properties** (also in **Advanced** as **ShowReset**)
-OnModelLoad | Behavior that is triggered when a model is loaded into the control. | Defined action | **Advanced**
-OnChange | Behavior that is triggered when any property of the control is changed. | Defined action | **Advanced**
-OnSelect | Behavior that is triggered when a pin is selected or the user focuses on the control | Defined action | **Advanced**
-
-### Additional properties
-
-**[DisplayMode](./controls/properties-core.md)** – Whether the control allows user input (**Edit**), only displays data (**View**), or is disabled (**Disabled**).
-
-**[Height](./controls/properties-size-___location.md)** – The distance between a control's top and bottom edges.
-
-**[TabIndex](./controls/properties-accessibility.md)** – Keyboard navigation order.
-
-**[Visible](./controls/properties-core.md)** – Whether a control appears or is hidden.
-
-**[Width](./controls/properties-size-___location.md)** – The distance between a control's left and right edges.
-
-**[X](./controls/properties-size-___location.md)** – The distance between the left edge of a control and the left edge of its parent container (or the screen if there's no parent container).
-
-**[Y](./controls/properties-size-___location.md)** – The distance between the top edge of a control and the top edge of the parent container (or the screen if there's no parent container).
+| Property | Description | Type | Location |
+| - | - | - | - |
+| Source | Identifies the object file to display. The **View in 3D** control supports loading models from various sources. See [Loading external 3D models](mixed-reality-component-view-3d-store.md) for details. | Not applicable | Properties; Advanced: **Source** |
+| Alternative text | Specifies the text to be displayed if the model can't load or if the user hovers over the model. | String | Properties; Advanced: **AltText** |
+| Background fill | Sets the control's background color. | Color picker | Properties; Advanced: **BackgroundFill** (accepts RGBA or HTML hexadecimal color codes) |
+| Pins(Items) | [Shows pins on the model at specific coordinates](mixed-reality-add-pins-3d-model.md), provided in a data source (**Items**). If *None*, no pins are shown. | Data table | Properties; Advanced: **Items** |
+| Show pins | Shows the pins described in **Items**. | Boolean | Properties; Advanced: **ShowPins** |
+| MaxPins | Specifies the maximum number of pins that can be shown on the model. | Integer | Advanced |
+| PinsX | Specifies the ___location of pins on the X axis in 3D coordinate space. | Floating point number | Advanced |
+| PinsY | Specifies the ___location of pins on the Y axis in 3D coordinate space. | Floating point number | Advanced |
+| PinsZ | Specifies the ___location of pins on the Z axis in 3D coordinate space. | Floating point number | Advanced |
+| Show reset button | Shows or hides a button that resets the model to its initial state. | Boolean | Properties; Advanced; **ShowReset** |
+| OnModelLoad | Contains behavior formula that runs when a model is loaded.| Event | Advanced |
+| OnChange | Contains behavior formula that runs when any property of the control is changed. | Event | Advanced |
+| OnSelect | Contains behavior formula that runs when the user selects a pin or the control. | Event | Advanced |
 
+## Additional properties
 
+| Property | Description | Type | Location |
+| - | - | - | - |
+| ContentLanguage | Determines the display language of the control, if it's different from the language used in the app. | String | Advanced |
+| [DisplayMode](./controls/properties-core.md) |  Determines whether the control allows user input (*Edit*), only displays data (*View*), or is disabled (*Disabled*). | Dropdown list | Advanced |
+| Position | Places the upper-left corner of the control at the screen coordinates specified in *x* and *y*. | Floating point number | Properties; Advanced: **[X](./controls/properties-size-___location.md)**, **[Y](./controls/properties-size-___location.md)** |
+| Size | Determines the size of the control using the pixel values provided in *Width* and *Height*. | Integer | Properties; Advanced: **[Width](./controls/properties-size-___location.md)**, **[Height](./controls/properties-size-___location.md)** |
+| [TabIndex](./controls/properties-accessibility.md) | Specifies the order the control is selected if the user navigates the app using the Tab key. | Integer |  Advanced |
+| [Tooltip](./controls/properties-core.md) | Determines the text to display when the user hovers over a pin. | String | Advanced |
+| [Visible](./controls/properties-core.md) | Shows or hides the control. | Boolean | Properties; Advanced: **Visible** |
 
 ## Performance considerations
 
-Having multiple instances of the **View in 3D** control on one screen can lead to poor performance, as each version of the control will try to load the 3D models at the same time. 
-
-
+We recommend that you use one 3D control on a screen for the best user experience. Multiple instances of the **View in 3D** control on one screen will try to load their 3D models at the same time, which can severely degrade the performance of your app.
 
 ## Other mixed reality controls