Delen via

Informatie ophalen over omzettingen

  • Artikel

Informatie over een conversie: het resultaatbestand

Wanneer de conversieservice een asset converteert, schrijft deze een samenvatting van eventuele problemen in een resultaatbestand. Als een bestand buggy.gltf bijvoorbeeld wordt geconverteerd, bevat de uitvoercontainer een bestand met de naam buggy.result.json.

Het resultaatbestand bevat eventuele fouten en waarschuwingen die zijn opgetreden tijdens de conversie en geeft een resultaatoverzicht, een van succeeded, failed of succeeded with warnings. Het resultaatbestand is gestructureerd als een JSON-matrix met objecten, die elk een tekenreekseigenschap heeft die een van, , , en resultinternal error. internal warningerrorwarning Er is maximaal één fout (of errorinternal error) en er is altijd één result.

Voorbeeld van resultaatbestand

In het volgende voorbeeld wordt een conversie beschreven waarmee een arrAsset is gegenereerd. Omdat er echter een ontbrekend patroon is, is de resulterende arrAsset mogelijk niet zoals bedoeld.

[
  {"conversionId":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"},
  {"warning":"4004","title":"Missing texture","details":{"texture":"buggy_baseColor.png","material":"buggy_col"}},
  {"result":"succeeded with warnings"}
]

Notitie

Dit conversionId is een interne id die niet overeenkomt met de id die is gebruikt om de conversie te maken.

Informatie over een geconverteerd model: het infobestand

Het arrAsset-bestand dat door de conversieservice wordt geproduceerd, is uitsluitend bedoeld voor gebruik door de renderingservice. Het kan echter voorkomen dat u toegang wilt krijgen tot informatie over een model zonder een renderingsessie te starten. Ter ondersteuning van deze werkstroom plaatst de conversieservice een JSON-bestand naast het arrAsset-bestand in de uitvoercontainer. Als een bestand buggy.gltf bijvoorbeeld wordt geconverteerd, bevat de uitvoercontainer een bestand dat naast de geconverteerde asset buggy.arrAssetwordt aangeroepenbuggy.info.json. Het bevat informatie over het bronmodel, het geconverteerde model en over de conversie zelf.

Voorbeeldgegevensbestand

Hier volgt een voorbeeld van een infobestand dat wordt geproduceerd door het converteren van een bestand met de naam buggy.gltf:

{
    "files": {
        "input": "Buggy.gltf"
    },
    "conversionSettings": {
        "recenterToOrigin": true
    },
    "inputInfo": {
        "sourceAssetExtension": ".gltf",
        "sourceAssetFormat": "glTF2 Importer",
        "sourceAssetFormatVersion": "2.0",
        "sourceAssetGenerator": "COLLADA2GLTF"
    },
    "inputStatistics": {
        "numMeshes": 148,
        "numFaces": 308306,
        "numVertices": 245673,
        "numMaterial": 149,
        "numFacesSmallestMesh": 2,
        "numFacesBiggestMesh": 8764,
        "numNodes": 206,
        "numMeshUsagesInScene": 236,
        "maxNodeDepth": 3
    },
    "materialOverrides": {
        "numOverrides": 4,
        "numOverriddenMaterials": 4
    },
    "outputInfo": {
        "conversionToolVersion": "3b28d840de9916f9d628342f474d38c3ab949590",
        "conversionHash": "CCDB1F7A4C09F565"
    },
    "outputStatistics": {
        "numMeshPartsCreated": 236,
        "numMeshPartsInstanced": 88,
        "numMaterials": 149,
        "numPrimitives": 308306,
        "recenteringOffset": [
            -24.1,
            -50.9,
            -16.5974
        ],
        "boundingBox": {
            "min": [
                -43.52,
                -61.775,
                -79.6416
            ],
            "max": [
                43.52,
                61.775,
                79.6416
            ]
        }
    }
}

Informatie in het infobestand

De sectie Bestanden

Deze sectie bevat de opgegeven bestandsnamen.

  • input: De naam van het bronbestand.
  • output: De naam van het uitvoerbestand, wanneer de gebruiker een niet-standaardnaam opgeeft.

De sectie conversie Instellingen

Deze sectie bevat een kopie van de conversie Instellingen die is opgegeven toen het model werd geconverteerd.

De sectie inputInfo

In deze sectie wordt informatie over de bronbestandsindeling vastgelegd.

  • sourceAssetExtension: De bestandsextensie van het bronbestand.
  • sourceAssetFormat: Een beschrijving van de bronbestandsindeling.
  • sourceAssetFormatVersion: De versie van de bronbestandsindeling.
  • sourceAssetGenerator: De naam van het hulpprogramma dat het bronbestand heeft gegenereerd, indien beschikbaar.

De sectie materialOverrides

In deze sectie vindt u informatie over het overschrijven van materiaal wanneer er een materiaaloverschrijvingsbestand is opgegeven voor de conversieservice. De tijdlijn bevat de volgende informatie:

  • numOverrides: Het aantal onderdrukkingsvermeldingen dat wordt gelezen uit het bestand met materiaaloverschrijvingen.
  • numOverriddenMaterials: Het aantal materialen dat is overschreven.

Deze sectie is niet aanwezig voor puntcloudconversies.

De sectie inputStatistics

Deze sectie bevat informatie over de bronscène. Er zijn vaak verschillen tussen de waarden in deze sectie en de equivalente waarden in het hulpprogramma waarmee het bronmodel is gemaakt. Dergelijke verschillen worden verwacht, omdat het model wordt gewijzigd tijdens de export- en conversiestappen.

De inhoud van deze sectie verschilt voor driehoekige meshes en puntwolken.

  • numMeshes: Het aantal mesh-onderdelen, waarbij elk onderdeel naar één materiaal kan verwijzen.
  • numFaces: Het totale aantal driehoeken in het bronmodel. Raadpleeg de vermelding in de numPrimitivesuitvoersectie voor een nauwkeurig aantal uitvoerprimitief.
  • numVertices: Het totale aantal hoekpunten in het bronmodel.
  • numMaterial: Het totale aantal materialen in het bronmodel.
  • numFacesSmallestMesh: Het aantal driehoeken/punten in de kleinste mesh van het model.
  • numFacesBiggestMesh: Het aantal driehoeken/punten in de grootste mesh van het model.
  • numNodes: Het aantal knooppunten in de scènegrafiek van het model.
  • numMeshUsagesInScene: Het aantal keer dat knooppunten verwijzen naar meshes. Meerdere knooppunten kunnen verwijzen naar dezelfde mesh.
  • maxNodeDepth: De maximale diepte van de knooppunten in de scènegrafiek.

De sectie outputInfo

Deze sectie registreert algemene informatie over de gegenereerde uitvoer.

  • conversionToolVersion: Versie van het modelconversieprogramma.
  • conversionHash: Een hash van de gegevens in de arrAsset die kan bijdragen aan rendering. Kan worden gebruikt om te begrijpen of de conversieservice een ander resultaat produceert wanneer het opnieuw wordt uitgevoerd op hetzelfde bestand.

De sectie outputStatistics

In deze sectie worden gegevens vastgelegd die zijn berekend op basis van de geconverteerde asset. Nogmaals, de sectie bevat verschillende informatie voor driehoekige meshes en puntwolken.

  • numPrimitives: Het totale aantal driehoeken/lijnen in het geconverteerde model. Dit getal draagt bij aan de primitieve limiet in de standaardrenderingsservergrootte.
  • numMeshPartsCreated: Het aantal meshes in de arrAsset. Het kan verschillen van numMeshes in de inputStatistics sectie, omdat de instancing wordt beïnvloed door het conversieproces.
  • numMeshPartsInstanced: Het aantal meshes dat opnieuw wordt gebruikt in de arrAsset.
  • numMaterials: Het totale aantal unieke materialen in het model, na materiaalontdubbeling.
  • recenteringOffset: Wanneer de recenterToOrigin optie in de conversie is ingeschakeld Instellingen is deze waarde de vertaling waarmee het geconverteerde model weer naar de oorspronkelijke positie wordt verplaatst.
  • boundingBox: De grenzen van het model.

Volgende stappen