Bitbybit Docs
    Preparing search index...

    Class Asset

    Ficheiros a entrar e a sair de um script: recursos que a aplicação em execução guarda sob um nome, ficheiros obtidos a partir de um URL, transferências, e conversões entre File, Blob, ArrayBuffer e Uint8Array. A aplicação fornece as consultas através de assetManager, por isso aquilo a que um nome de recurso corresponde depende de onde o script corre; a obtenção precisa de um endpoint que permita pedidos entre origens.

    Index

    Constructors

    Properties

    assetManager: AssetManager

    convert

    • Lê todos os bytes de um File ou Blob para um ArrayBuffer, a forma que os carregadores binários e os conversores STEP recebem.

      Parameters

      • inputs: FileDto

        O File ou Blob a ler

      Returns Promise<ArrayBuffer>

      Os bytes como um ArrayBuffer

      const buffer = await bitbybit.asset.toArrayBuffer({ file });
      
    • Lê todos os bytes de um File ou Blob para um Uint8Array, um array de bytes que pode ser indexado e fatiado.

      Parameters

      • inputs: FileDto

        O File ou Blob a ler

      Returns Promise<Uint8Array<ArrayBufferLike>>

      Os bytes como um Uint8Array

      const bytes = await bitbybit.asset.toUint8Array({ file });
      
    • Envolve um Blob num File com um nome e um tipo MIME, de que os carregadores que querem um nome de ficheiro precisam; o tipo próprio do Blob é mantido quando mimeType é omitido.

      Parameters

      • inputs: BlobToFileDto

        O Blob, o nome do ficheiro e o tipo MIME opcional

      Returns File

      O File

      const file = bitbybit.asset.blobToFile({ blob, fileName: "part.step", mimeType: "application/step" });
      
    • Copia os bytes de um File para um Blob simples do mesmo tipo, descartando o nome; um Blob dado à entrada volta como uma cópia.

      Parameters

      • inputs: FileDto

        O File ou Blob a copiar

      Returns Blob

      O Blob

      const blob = bitbybit.asset.fileToBlob({ file });
      
    • Vê os bytes de um ArrayBuffer como um Uint8Array; nenhum byte é copiado, ambos partilham a mesma memória.

      Parameters

      Returns Uint8Array

      O Uint8Array sobre os mesmos bytes

      const bytes = bitbybit.asset.arrayBufferToUint8Array({ arrayBuffer });
      
    • Copia exatamente os bytes que um Uint8Array cobre para um novo ArrayBuffer, de modo que uma vista sobre parte de um buffer maior dá só a sua própria parte.

      Parameters

      Returns ArrayBuffer

      O novo ArrayBuffer

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

    create

    • Cria um URL temporário para um File ou Blob guardado em memória, para que possa ser entregue a qualquer coisa que carregue a partir de um URL, como uma textura ou um carregador de modelos.

      O URL vive enquanto a página viver.

      Parameters

      Returns string

      O URL temporário

      const url = bitbybit.asset.createObjectURL({ file });
      
    • Cria um URL temporário para cada File ou Blob numa lista, pela mesma ordem, tal como createObjectURL faz para um.

      Parameters

      Returns string[]

      Um URL temporário por ficheiro, pela mesma ordem

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

    download

    • Inicia uma transferência no navegador do conteúdo dado como um ficheiro chamado fileName mais a extension.

      O conteúdo de texto é envolvido num Blob do contentType; um Blob é descarregado tal como está.

      Parameters

      • inputs: DownloadDto

        O nome do ficheiro, o conteúdo, a extensão e o tipo de conteúdo

      Returns void

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

    fetch

    • Descarrega o conteúdo num URL como um Blob, bytes brutos sem nome de ficheiro; o servidor tem de permitir pedidos de origem cruzada.

      Parameters

      Returns Promise<Blob>

      O corpo da resposta como um Blob

      const blob = await bitbybit.asset.fetchBlob({ url: "https://example.com/models/part.glb" });
      
    • Descarrega o conteúdo num URL como um File com o nome da última parte do URL, sem a sua string de consulta; o servidor tem de permitir pedidos de origem cruzada.

      Parameters

      Returns Promise<File>

      O corpo da resposta como um 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 });
    • Descarrega o conteúdo num URL e analisa-o como JSON; o servidor tem de permitir pedidos de origem cruzada e o corpo tem de ser JSON válido.

      Parameters

      Returns Promise<any>

      O valor JSON analisado

      const settings = await bitbybit.asset.fetchJSON({ url: "https://example.com/data/settings.json" });
      
    • Descarrega o conteúdo num URL como texto simples; o servidor tem de permitir pedidos de origem cruzada.

      Parameters

      Returns Promise<string>

      O corpo da resposta como texto

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

    get

    • Carrega um recurso com nome da aplicação em execução como um File, através da procura que a aplicação fornece em assetManager.getAsset.

      Em que repositório o nome é procurado depende da aplicação; um recurso em falta rejeita a promessa.

      Parameters

      Returns Promise<File>

      O recurso como um File

      const file = await bitbybit.asset.getFile({ fileName: "part.step" });
      const shape = await bitbybit.occt.io.loadSTEPorIGES({ assetFile: file, adjustZtoY: true });
    • Carrega um recurso com nome da aplicação em execução e lê-o como texto, para JSON, CSV ou outros ficheiros de texto guardados como recursos.

      Parameters

      Returns Promise<string>

      O conteúdo do recurso como texto

      const csv = await bitbybit.asset.getTextFile({ fileName: "points.csv" });
      const rows = bitbybit.csv.parseToArray({ csv, rowSeparator: "\n", columnSeparator: "," });
    • Carrega um recurso local com nome, um guardado no navegador em vez de num servidor, através da procura que a aplicação fornece em assetManager.getLocalAsset.

      Um nome que resolva para vários ficheiros dá uma lista.

      Parameters

      Returns Promise<File | File[]>

      O recurso como um File, ou uma lista de Files quando o nome contém vários

      const file = await bitbybit.asset.getLocalFile({ fileName: "part.step" });
      
    • Carrega um recurso local com nome, um guardado no navegador em vez de num servidor, e lê-o como texto; um nome que resolva para vários ficheiros dá uma lista de textos.

      Parameters

      Returns Promise<string | string[]>

      O conteúdo como texto, ou uma lista de textos quando o nome contém vários ficheiros

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