You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/remote-rendering/how-tos/conversion/get-information.md
+29-8Lines changed: 29 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
2
title: Get information about conversions
3
-
description: Get information about conversions
3
+
description: Get information about conversions.
4
4
author: malcolmtyrrell
5
5
ms.author: matyrr
6
6
ms.date: 03/05/2020
@@ -11,12 +11,12 @@ ms.topic: how-to
11
11
12
12
## Information about a conversion: The result file
13
13
14
-
When the conversion service converts an asset, it writes a summary of any issues into a "result file".
15
-
For example, if a file `buggy.gltf` is converted, the output container will contain a file called `buggy.result.json`.
14
+
When the conversion service converts an asset, it writes a summary of any issues into a result file.
15
+
For example, if a file `buggy.gltf` is converted, the output container contains a file called `buggy.result.json`.
16
16
17
17
The result file lists any errors and warnings that occurred during the conversion and gives a result summary, which is one of `succeeded`, `failed` or `succeeded with warnings`.
18
18
The result file is structured as a JSON array of objects, each of which has a string property that is one of `warning`, `error`, `internal warning`, `internal error`, and `result`.
19
-
There will be at most one error (either `error` or `internal error`) and there will always be one `result`.
19
+
There is at most one error (either `error` or `internal error`) and there's always one `result`.
20
20
21
21
## Example *result* file
22
22
@@ -36,7 +36,7 @@ However, since there was a missing texture, the resulting arrAsset may not be as
36
36
37
37
## Information about a converted model: The info file
38
38
39
-
The arrAsset file produced by the conversion service is solely intended for consumption by the rendering service. There may be times, however, when you want to access information about a model without starting a rendering session. To support this workflow, the conversion service places a JSON file beside the arrAsset file in the output container. For example, if a file `buggy.gltf` is converted, the output container will contain a file called `buggy.info.json` beside the converted asset `buggy.arrAsset`. It contains information about the source model, the converted model, and about the conversion itself.
39
+
The arrAsset file produced by the conversion service is solely intended for consumption by the rendering service. There may be times, however, when you want to access information about a model without starting a rendering session. To support this workflow, the conversion service places a JSON file beside the arrAsset file in the output container. For example, if a file `buggy.gltf` is converted, the output container contains a file called `buggy.info.json` beside the converted asset `buggy.arrAsset`. It contains information about the source model, the converted model, and about the conversion itself.
40
40
41
41
## Example *info* file
42
42
@@ -106,7 +106,7 @@ Here's an example *info* file produced by converting a file called `buggy.gltf`:
106
106
This section contains the provided filenames.
107
107
108
108
*`input`: The name of the source file.
109
-
*`output`: The name of the output file, when the user has specified a non-default name.
109
+
*`output`: The name of the output file, when the user has specified a nondefault name.
110
110
111
111
### The *conversionSettings* section
112
112
@@ -128,12 +128,18 @@ It contains the following information:
128
128
*`numOverrides`: The number of override entries read from the material override file.
129
129
*`numOverriddenMaterials`: The number of materials that were overridden.
130
130
131
+
This section isn't present for point cloud conversions.
132
+
131
133
### The *inputStatistics* section
132
134
133
135
This section provides information about the source scene. There will often be discrepancies between the values in this section and the equivalent values in the tool that created the source model. Such differences are expected, because the model gets modified during the export and conversion steps.
134
136
137
+
The content of this section is different for triangular meshes and point clouds.
138
+
139
+
#### Input statistics for triangular meshes
140
+
135
141
*`numMeshes`: The number of mesh parts, where each part can reference a single material.
136
-
*`numFaces`: The total number of triangles/points in the whole model. This number contributes to the primitive limit in the [standard rendering server size](../../reference/vm-sizes.md#how-the-renderer-evaluates-the-number-of-primitives).
142
+
*`numFaces`: The total number of triangles in the whole model. This number contributes to the primitive limit in the [standard rendering server size](../../reference/vm-sizes.md#how-the-renderer-evaluates-the-number-of-primitives).
137
143
*`numVertices`: The total number of vertices in the whole model.
138
144
*`numMaterial`: The total number of materials in the whole model.
139
145
*`numFacesSmallestMesh`: The number of triangles/points in the smallest mesh of the model.
@@ -142,6 +148,12 @@ This section provides information about the source scene. There will often be di
142
148
*`numMeshUsagesInScene`: The number of times nodes reference meshes. More than one node may reference the same mesh.
143
149
*`maxNodeDepth`: The maximum depth of the nodes within the scene graph.
144
150
151
+
#### Input statistics for point clouds
152
+
153
+
For point cloud conversions, this section contains only a single entry:
154
+
155
+
*`numPoints`: The total number of points in the input model.
156
+
145
157
### The *outputInfo* section
146
158
147
159
This section records general information about the generated output.
@@ -151,13 +163,22 @@ This section records general information about the generated output.
151
163
152
164
### The *outputStatistics* section
153
165
154
-
This section records information calculated from the converted asset.
166
+
This section records information calculated from the converted asset. Again, the section holds different information for triangular meshes and point clouds.
167
+
168
+
#### Output statistics for triangular meshes
155
169
156
170
*`numMeshPartsCreated`: The number of meshes in the arrAsset. It can differ from `numMeshes` in the `inputStatistics` section, because instancing is affected by the conversion process.
157
171
*`numMeshPartsInstanced`: The number of meshes that are reused in the arrAsset.
158
172
*`recenteringOffset`: When the `recenterToOrigin` option in the [ConversionSettings](configure-model-conversion.md) is enabled, this value is the translation that would move the converted model back to its original position.
159
173
*`boundingBox`: The bounds of the model.
160
174
175
+
#### Output statistics for point clouds
176
+
177
+
*`numPoints`: The overall number of points in the converted model. This number contributes to the primitive limit in the [standard rendering server size](../../reference/vm-sizes.md#how-the-renderer-evaluates-the-number-of-primitives).
178
+
*`recenteringOffset`: When the `recenterToOrigin` option in the [ConversionSettings](configure-model-conversion.md) is enabled, this value is the translation that would move the converted model back to its original position.
179
+
*`boundingBox`: The bounds of the model.
180
+
181
+
161
182
## Deprecated features
162
183
163
184
The conversion service writes the files `stdout.txt` and `stderr.txt` to the output container, and these files had been the only source of warnings and errors.
0 commit comments