Merge pull request #3772 from MicrosoftDocs/iawilt-nov20

PMR - November updates

Author: iaanw

powerapps-docs/maker/canvas-apps/media/augmented-overview/measure-in-mixed-reality.png

@@ -22,11 +22,8 @@ You can use the **Measure in MR** component in your app to let users measure dis
 
 The component creates a button in your app. When app users click the button, it shows a live camera feed of the device. App users can then identify a starting point and then individual points to measure from. The distances of measured segments are shown directly on the live camera feed.
 
-An example of how the component works inside an app is shown in the following video:
-
-
-> [!VIDEO https://www.microsoft.com/videoplayer/embed/RE4vyoW]
 
+:::image type="content" source="./media/augmented-overview/measure-in-mixed-reality.png" alt-text="Photo showing a corner between two construction walls being measured with a mobile device.":::
 
 When the user exits the component, the measurements that were taken are captured in the **Measurements** and **MeasurementsDetailed** properties so they can be saved or stored.
 
@@ -69,13 +66,13 @@ Note that some properties are only available under **More options** in the **Adv
 
 Property | Description | Type | Location
 - | - | - | -
-Text | Label for the button | String | **Properties** (also in **Advanced**)
-Display type | Whether the button shows just an icon, text, or both | Drop-down selection | **Properties** (also in **Advanced**)
-Unit of measurement | What unit the measurements should be shown and returned in | Drop-down selection | **Properties** (also in **Advanced**)
+Text | Label for the button. | String | **Properties** (also in **Advanced**)
+Display type | Whether the button shows just an icon, text, or both. | Drop-down selection | **Properties** (also in **Advanced**)
+Unit of measurement | What unit the measurements should be shown and returned in. | Drop-down selection | **Properties** (also in **Advanced**)
 Measurement type | What type of measurement the user can make, whether point-to-point distance, a complete area, or a three-dimensional volume (area plus height or depth). | Drop-down selection | **Properties** (also in **Advanced**)
 Measurements | Table containing the measured segments, composed of: <ul><li>Length - Number representing the length of the segment</li><li>Unit - String describing the unit of this measurement</li></ul> | String | Not applicable (output property only)
 MeasurementsDetailed | Table describing the measured volumes and areas, composed of:<ul><li>Units - String describing the base unit of this measurement</li><li>Height - Number representing the height of the captured volume, or 0 if not a completed volume or 2D area</li><li>PathLength - Number representing the total length of the path</li><li>Segments - Table describing all segments in the given measurement object with the following properties:<ul><li>Distance - Number representing the total distance of a given segment in the given units of measure (for example, .52)</li><li>Direction - Vector describing the direction of the segment, normalized</li><li>X - Number specifying the X direction of the segment in world space (for example, 0.5)</li><li>Y - Number specifying the Y direction of the measurement in world space (typically 0)</li><li>Z - Number specifying the Z direction of the measurement in world space (for example, 0.5)</li></ul></li></li> | | Not applicable (output property only)
-Photos | The photos captured during the mixed reality session | | Not applicable (output property only)
+Photos | The photos captured during the mixed reality session.<br/>You can [upload the mixed-reality photos to OneDrive and show them in a gallery](mixed-reality-take-upload-photos.md). | | Not applicable (output property only)
 
 ### Additional properties
 

powerapps-docs/maker/canvas-apps/media/augmented-overview/mixed-reality-overview.png

@@ -23,7 +23,8 @@ Add 3D content to your canvas apps. Use the **View in 3D** component to rotate a
 
 You can display a single 3D model, or you can let the user select from a gallery [by connecting to a **Gallery** control](#define-where-the-3d-content-is-stored).
 
-> [!VIDEO https://www.microsoft.com/videoplayer/embed/RE4vyoW]
+:::image type="content" source="./media/augmented-overview/view-in-3d.png" alt-text="Photo showing a 3D object being viewed in a mobile device.":::
+
 
 > [!IMPORTANT]
 > Your 3D content must be in the .glb file format.  
@@ -56,7 +57,8 @@ Some properties are only available in the **Advanced** tab on the **View in 3D**
 Property | Description | Type | Location
 - | - | - | -
 Source | Data source that identifies the .glb file to display. The **View in 3D** component 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> | Not applicable | **Properties** (also in **Advanced** as **Src**)
-Background fill | Set the background color for the component | Color picker | **Properties** (also in **Advanced** as **BackgroundFill**, where it accepts RGBA or HTML hexadecimal color codes)
+Background fill | Set the background color for the component. | 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). | Drop-down selection | **Properties**
 
 ### Additional properties
 
@@ -155,6 +157,12 @@ Loading models as attachments or media content works through the binary storage
 1. Set the gallery data source to the Excel Online workbook.
 1. In the **Advanced** properties tab for the **View in 3D** component, set the **Src** property to **Gallery1.Selected.3DModel**.
 
+## Performance considerations
+
+Having multiple instances of the **View in 3D** component on one screen can lead to poor performance, as each version of the component will try to load the 3D models at the same time. 
+
+For situations where you want to have a gallery of 3D models, you should put the **View in 3D** component outside of the gallery, and then set its source to the gallery's selected property as described in the [Loading models as attachments or media content](#loading-models-as-attachments-or-media-content) section.
+
 ## Known constraints
 
 - The security architecture of Power Apps requires HTTPS links, not HTTP.

powerapps-docs/maker/canvas-apps/media/augmented-overview/view-in-3D.png

@@ -23,7 +23,7 @@ You can use the **View in MR** component in your app to let users see how a part
 
 The component creates a button in your app. When app users click the button, it overlays a selected 3D model (in the .glb file format) or image (in .jpg or .png file formats) onto the live camera feed of the device.
 
-> [!VIDEO https://www.microsoft.com/videoplayer/embed/RE4vvwR]
+:::image type="content" source="./media/augmented-overview/view-in-mixed-reality.png" alt-text="Photo showing a 3D model of a forklift being overlaid onto the real world through a mobile device.":::
 
 You can also take photos and [upload them to OneDrive](mixed-reality-take-upload-photos.md).
 
@@ -62,14 +62,14 @@ Some properties are only available under **More options** in the **Advanced** ta
 
 Property | Description | Type | Location
 - | - | - | -
-Text | Label for the button | String | Properties (also in **Advanced**)
+Text | Label for the button. | String | Properties (also in **Advanced**)
 Display type | Whether the button shows just an icon, text, or both. | Drop-down selection | Properties (also in **Advanced**)
 Source | Data source that identifies the .glb file to display. The **View in MR** component 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><br/>For more information, see [Define where the 3D content is stored](mixed-reality-component-view-3d.md#define-where-the-3d-content-is-stored) in the **View in 3D** component's topic. | Not applicable | **Properties** (also in **Advanced**)
 Object width | Width of the displayed image or 3D content. | Integer | **Properties** (also in **Advanced**)
 Object height | Height of the displayed image or 3D content. | Integer | **Properties** (also in **Advanced**)
 Object depth | The three-dimensional depth of the 3D content. | Integer | **Properties** (also in **Advanced**)
 Units | The unit used for the object width, height, and depth fields. | Drop-down selection | **Properties** (also in **Advanced**)
-Photos | The photos captured during the mixed reality session. | | Not applicable (output property only)
+Photos | The photos captured during the mixed reality session.<br/>You can [upload the mixed-reality photos to OneDrive and show them in a gallery](mixed-reality-take-upload-photos.md). | | Not applicable (output property only)
 
 ### Additional properties
 

powerapps-docs/maker/canvas-apps/media/augmented-overview/view-in-mixed-reality.png

@@ -23,7 +23,7 @@ You can use the **View shape in MR** component in your app to let users see if a
 
 The component creates a button in your app. When app users click the button, it overlays a cube onto the live camera feed of the device. You set up the dimensions of the cube when you edit the component in Power Apps.
 
-> [!VIDEO https://www.microsoft.com/videoplayer/embed/RE4vvwR]
+:::image type="content" source="./media/augmented-overview/view-shape-in-mixed-reality.png" alt-text="Photo showing a 3D shape being overlaid onto the real world through a mobile device.":::
 
 To use the component, you need to [enable the mixed reality (MR) features for each app](mixed-reality-overview.md#enable-the-mixed-reality-features-for-each-app) that you want to use it in.
 
@@ -62,7 +62,7 @@ Shape width | Width of the cube. | Integer | **Properties** (also in **Advanced*
 Shape height | Height of the cube. | Integer | **Properties** (also in **Advanced**)
 Shape depth | The three-dimensional depth of the cube. | Integer | **Properties** (also in **Advanced**)
 Unit of measurement | The measurement unit used for the width, height, and depth fields. | Drop-down selection | **Properties** (also in **Advanced**)
-Photos | The photos captured during the mixed reality session. | | Not applicable (output property only)
+Photos | The photos captured during the mixed reality session.<br/>You can [upload the mixed-reality photos to OneDrive and show them in a gallery](mixed-reality-take-upload-photos.md). | | Not applicable (output property only)
 
 ### Additional properties
 

powerapps-docs/maker/canvas-apps/media/augmented-overview/view-shape-in-mixed-reality.png

@@ -27,6 +27,10 @@ Components are groups of controls that can answer the need for a specific scenar
 - Measure distance, area, and volume using your device with MR.
 - Identify spaces in the real world through an MR overlay.
 
+mixed-reality-overview.png
+
+:::image type="content" source="./media/augmented-overview/mixed-reality-overview.png" alt-text="A photo showing the Power Apps editor portal with the view in 3D component next to the app on a mobile device.":::
+
 You can read more about components and how to build your own in [Power Apps component framework docs](/powerapps/developer/component-framework/custom-controls-overview).