Bitbybit Docs
    Preparing search index...

    Class Asset

    Fichiers entrants et sortants d'un script : les actifs que l'application en cours stocke sous un nom, les fichiers récupérés depuis une URL, les téléchargements, et les conversions entre File, Blob, ArrayBuffer et Uint8Array. L'application fournit les recherches par assetManager, donc ce vers quoi un nom d'actif se résout dépend de l'endroit où le script s'exécute ; la récupération a besoin d'un point de terminaison qui autorise les requêtes inter-origines.

    Index

    Constructors

    Properties

    assetManager: AssetManager

    convert

    • Lit tous les octets d'un File ou d'un Blob dans un ArrayBuffer, la forme que les chargeurs binaires et les convertisseurs STEP prennent.

      Parameters

      • inputs: FileDto

        Le File ou le Blob à lire

      Returns Promise<ArrayBuffer>

      Les octets sous forme d'ArrayBuffer

      const buffer = await bitbybit.asset.toArrayBuffer({ file });
      
    • Lit tous les octets d'un File ou d'un Blob dans un Uint8Array, un tableau d'octets qui peut être indexé et découpé.

      Parameters

      • inputs: FileDto

        Le File ou le Blob à lire

      Returns Promise<Uint8Array<ArrayBufferLike>>

      Les octets sous forme de Uint8Array

      const bytes = await bitbybit.asset.toUint8Array({ file });
      
    • Enveloppe un Blob dans un File avec un nom et un type MIME, dont ont besoin les chargeurs qui veulent un nom de fichier ; le type propre du Blob est conservé quand mimeType est omis.

      Parameters

      • inputs: BlobToFileDto

        Le Blob, le nom du fichier et le type MIME facultatif

      Returns File

      Le File

      const file = bitbybit.asset.blobToFile({ blob, fileName: "part.step", mimeType: "application/step" });
      
    • Copie les octets d'un File dans un simple Blob du même type, en abandonnant le nom ; un Blob donné en entrée revient sous forme de copie.

      Parameters

      • inputs: FileDto

        Le File ou le Blob à copier

      Returns Blob

      Le Blob

      const blob = bitbybit.asset.fileToBlob({ file });
      
    • Voit les octets d'un ArrayBuffer comme un Uint8Array ; aucun octet n'est copié, les deux partagent la même mémoire.

      Parameters

      Returns Uint8Array

      Le Uint8Array sur les mêmes octets

      const bytes = bitbybit.asset.arrayBufferToUint8Array({ arrayBuffer });
      
    • Copie exactement les octets qu'un Uint8Array couvre dans un nouvel ArrayBuffer, de sorte qu'une vue sur une partie d'un tampon plus grand ne donne que sa propre partie.

      Parameters

      Returns ArrayBuffer

      Le nouvel ArrayBuffer

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

    create

    • Crée une URL temporaire pour un File ou un Blob tenu en mémoire, pour qu'il puisse être confié à tout ce qui charge depuis une URL, comme une texture ou un chargeur de modèle.

      L'URL vit aussi longtemps que la page.

      Parameters

      Returns string

      L'URL temporaire

      const url = bitbybit.asset.createObjectURL({ file });
      
    • Crée une URL temporaire pour chaque File ou Blob d'une liste, dans le même ordre, comme createObjectURL le fait pour un seul.

      Parameters

      Returns string[]

      Une URL temporaire par fichier, dans le même ordre

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

    download

    • Lance un téléchargement du navigateur du contenu donné sous forme de fichier nommé fileName plus extension.

      Un contenu texte est enveloppé dans un Blob de contentType ; un Blob est téléchargé tel quel.

      Parameters

      • inputs: DownloadDto

        Le nom du fichier, le contenu, l'extension et le type de contenu

      Returns void

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

    fetch

    • Télécharge le contenu d'une URL sous forme de Blob, des octets bruts sans nom de fichier ; le serveur doit autoriser les requêtes cross-origin.

      Parameters

      Returns Promise<Blob>

      Le corps de la réponse sous forme de Blob

      const blob = await bitbybit.asset.fetchBlob({ url: "https://example.com/models/part.glb" });
      
    • Télécharge le contenu d'une URL sous forme de File nommé d'après la dernière partie de l'URL, sans sa chaîne de requête ; le serveur doit autoriser les requêtes cross-origin.

      Parameters

      Returns Promise<File>

      Le corps de la réponse sous forme de 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 });
    • Télécharge le contenu d'une URL et l'analyse en JSON ; le serveur doit autoriser les requêtes cross-origin et le corps doit être du JSON valide.

      Parameters

      Returns Promise<any>

      La valeur JSON analysée

      const settings = await bitbybit.asset.fetchJSON({ url: "https://example.com/data/settings.json" });
      
    • Télécharge le contenu d'une URL sous forme de texte brut ; le serveur doit autoriser les requêtes cross-origin.

      Parameters

      Returns Promise<string>

      Le corps de la réponse sous forme de texte

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

    get

    • Charge un actif nommé de l'application en cours sous forme de File, via la recherche que l'application fournit dans assetManager.getAsset.

      L'espace de stockage dans lequel le nom est recherché dépend de l'application ; un actif manquant rejette la promesse.

      Parameters

      Returns Promise<File>

      L'actif sous forme de File

      const file = await bitbybit.asset.getFile({ fileName: "part.step" });
      const shape = await bitbybit.occt.io.loadSTEPorIGES({ assetFile: file, adjustZtoY: true });
    • Charge un actif nommé de l'application en cours et le lit en texte, pour les fichiers JSON, CSV ou autres fichiers texte stockés comme actifs.

      Parameters

      Returns Promise<string>

      Le contenu de l'actif sous forme de texte

      const csv = await bitbybit.asset.getTextFile({ fileName: "points.csv" });
      const rows = bitbybit.csv.parseToArray({ csv, rowSeparator: "\n", columnSeparator: "," });
    • Charge un actif local nommé, conservé dans le navigateur plutôt que sur un serveur, via la recherche que l'application fournit dans assetManager.getLocalAsset.

      Un nom qui se résout en plusieurs fichiers donne une liste.

      Parameters

      Returns Promise<File | File[]>

      L'actif sous forme de File, ou une liste de File quand le nom en contient plusieurs

      const file = await bitbybit.asset.getLocalFile({ fileName: "part.step" });
      
    • Charge un actif local nommé, conservé dans le navigateur plutôt que sur un serveur, et le lit en texte ; un nom qui se résout en plusieurs fichiers donne une liste de textes.

      Parameters

      Returns Promise<string | string[]>

      Le contenu sous forme de texte, ou une liste de textes quand le nom contient plusieurs fichiers

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