Bitbybit Docs
    Bereite Suchindex vor...

    Klasse Asset

    Dateien in ein Skript hinein und heraus: Assets, die die laufende Anwendung unter einem Namen speichert, Dateien, die von einer URL abgerufen werden, Downloads und Umwandlungen zwischen File, Blob, ArrayBuffer und Uint8Array. Die Anwendung stellt die Nachschlagevorgänge über assetManager bereit, daher hängt es davon ab, wo das Skript läuft, worauf ein Asset-Name aufgelöst wird; das Abrufen braucht einen Endpunkt, der Cross-Origin-Anfragen erlaubt.

    Index

    Konstruktoren

    • Rückgabewert Bit.Asset

    Eigenschaften

    assetManager: AssetManager

    convert

    • Liest alle Bytes eines File oder Blob in einen ArrayBuffer, die Form, die binäre Lader und die STEP-Konverter nehmen.

      Parameter

      • inputs: FileDto

        Das zu lesende File oder der zu lesende Blob

      Rückgabewert Promise<ArrayBuffer>

      Die Bytes als ArrayBuffer

      const buffer = await bitbybit.asset.toArrayBuffer({ file });
      
    • Liest alle Bytes eines File oder Blob in ein Uint8Array, ein Byte-Array, das indiziert und geschnitten werden kann.

      Parameter

      • inputs: FileDto

        Das zu lesende File oder der zu lesende Blob

      Rückgabewert Promise<Uint8Array<ArrayBufferLike>>

      Die Bytes als Uint8Array

      const bytes = await bitbybit.asset.toUint8Array({ file });
      
    • Packt ein Blob in ein File mit einem Namen und einem MIME-Typ, was Lader brauchen, die einen Dateinamen wollen; der eigene Typ des Blobs bleibt erhalten, wenn mimeType weggelassen wird.

      Parameter

      • inputs: BlobToFileDto

        Der Blob, der Dateiname und der optionale MIME-Typ

      Rückgabewert File

      Das File

      const file = bitbybit.asset.blobToFile({ blob, fileName: "part.step", mimeType: "application/step" });
      
    • Kopiert die Bytes eines File in ein einfaches Blob desselben Typs und lässt den Namen weg; ein übergebenes Blob kommt als Kopie zurück.

      Parameter

      • inputs: FileDto

        Das zu kopierende File oder der zu kopierende Blob

      Rückgabewert Blob

      Der Blob

      const blob = bitbybit.asset.fileToBlob({ file });
      
    • Betrachtet die Bytes eines ArrayBuffer als Uint8Array; keine Bytes werden kopiert, beide teilen denselben Speicher.

      Parameter

      Rückgabewert Uint8Array

      Das Uint8Array über dieselben Bytes

      const bytes = bitbybit.asset.arrayBufferToUint8Array({ arrayBuffer });
      
    • Kopiert genau die Bytes, die ein Uint8Array abdeckt, in einen neuen ArrayBuffer, sodass eine Ansicht über einen Teil eines größeren Puffers nur ihren eigenen Teil ergibt.

      Parameter

      Rückgabewert ArrayBuffer

      Der neue ArrayBuffer

      const buffer = bitbybit.asset.uint8ArrayToArrayBuffer({ uint8Array: bytes });
      

    create

    • Erstellt eine temporäre URL für ein im Speicher gehaltenes File oder Blob, sodass es an alles übergeben werden kann, das von einer URL lädt, etwa einen Textur- oder Modell-Lader.

      Die URL lebt so lange wie die Seite.

      Parameter

      • inputs: FileDto

        Das File oder der Blob

      Rückgabewert string

      Die temporäre URL

      const url = bitbybit.asset.createObjectURL({ file });
      
    • Erstellt eine temporäre URL für jedes File oder Blob in einer Liste, in derselben Reihenfolge, wie createObjectURL es für eines tut.

      Parameter

      Rückgabewert string[]

      Eine temporäre URL pro Datei, in derselben Reihenfolge

      const urls = bitbybit.asset.createObjectURLs({ files: [fileA, fileB] });
      

    download

    • Startet einen Browser-Download des gegebenen Inhalts als Datei mit dem Namen fileName plus der extension.

      Textinhalt wird in ein Blob vom Typ contentType gepackt; ein Blob wird heruntergeladen, wie es ist.

      Parameter

      • inputs: DownloadDto

        Der Dateiname, der Inhalt, die Erweiterung und der Inhaltstyp

      Rückgabewert void

      bitbybit.asset.download({ fileName: "points", content: "x,y,z\n1,2,3", extension: "csv", contentType: "text/csv" });
      

    fetch

    • Lädt den Inhalt einer URL als Blob herunter, rohe Bytes ohne Dateinamen; der Server muss Cross-Origin-Anfragen erlauben.

      Parameter

      Rückgabewert Promise<Blob>

      Der Antwortinhalt als Blob

      const blob = await bitbybit.asset.fetchBlob({ url: "https://example.com/models/part.glb" });
      
    • Lädt den Inhalt einer URL als File herunter, benannt nach dem letzten Teil der URL, ohne ihre Query-Zeichenkette; der Server muss Cross-Origin-Anfragen erlauben.

      Parameter

      Rückgabewert Promise<File>

      Der Antwortinhalt als File

      const file = await bitbybit.asset.fetchFile({ url: "https://example.com/models/part.step" });
      const shape = await bitbybit.occt.io.loadSTEPorIGES({ assetFile: file, adjustZtoY: true });
    • Lädt den Inhalt einer URL herunter und parst ihn als JSON; der Server muss Cross-Origin- Anfragen erlauben und der Inhalt muss gültiges JSON sein.

      Parameter

      Rückgabewert Promise<any>

      Der geparste JSON-Wert

      const settings = await bitbybit.asset.fetchJSON({ url: "https://example.com/data/settings.json" });
      
    • Lädt den Inhalt einer URL als reinen Text herunter; der Server muss Cross-Origin-Anfragen erlauben.

      Parameter

      Rückgabewert Promise<string>

      Der Antwortinhalt als Text

      const csv = await bitbybit.asset.fetchText({ url: "https://example.com/data/points.csv" });
      

    get

    • Lädt ein benanntes Asset der laufenden Anwendung als File, über die Suche, die die Anwendung in assetManager.getAsset bereitstellt.

      In welchem Speicher der Name nachgeschlagen wird, hängt von der Anwendung ab; ein fehlendes Asset lehnt das Promise ab.

      Parameter

      Rückgabewert Promise<File>

      Das Asset als File

      const file = await bitbybit.asset.getFile({ fileName: "part.step" });
      const shape = await bitbybit.occt.io.loadSTEPorIGES({ assetFile: file, adjustZtoY: true });
    • Lädt ein benanntes Asset der laufenden Anwendung und liest es als Text, für JSON, CSV oder andere als Assets gespeicherte Textdateien.

      Parameter

      Rückgabewert Promise<string>

      Der Inhalt des Assets als Text

      const csv = await bitbybit.asset.getTextFile({ fileName: "points.csv" });
      const rows = bitbybit.csv.parseToArray({ csv, rowSeparator: "\n", columnSeparator: "," });
    • Lädt ein benanntes lokales Asset, eines, das im Browser statt auf einem Server gehalten wird, über die Suche, die die Anwendung in assetManager.getLocalAsset bereitstellt.

      Ein Name, der auf mehrere Dateien aufgelöst wird, ergibt eine Liste.

      Parameter

      Rückgabewert Promise<File | File[]>

      Das Asset als File oder eine Liste von Files, wenn der Name mehrere enthält

      const file = await bitbybit.asset.getLocalFile({ fileName: "part.step" });
      
    • Lädt ein benanntes lokales Asset, eines, das im Browser statt auf einem Server gehalten wird, und liest es als Text; ein Name, der auf mehrere Dateien aufgelöst wird, ergibt eine Liste von Texten.

      Parameter

      Rückgabewert Promise<string | string[]>

      Der Inhalt als Text oder eine Liste von Texten, wenn der Name mehrere Dateien enthält

      const text = await bitbybit.asset.getLocalTextFile({ fileName: "settings.json" });