Class Asset

constructor

• new Asset(): Bit.Asset

  Returns Bit.Asset

assetManager

toArrayBuffer

• toArrayBuffer(inputs: FileDto): Promise<ArrayBuffer>

  يقرأ كل بايتات File أو Blob في ArrayBuffer، الصيغة التي تأخذها المحمّلات الثنائية ومحوّلات STEP.

  Parameters

  • inputs: FileDto

    كائن File أو Blob المراد قراءته

  Returns Promise<ArrayBuffer>

  البايتات ككائن ArrayBuffer

  Example

  const buffer = await bitbybit.asset.toArrayBuffer({ file });
  Copy

toUint8Array

• toUint8Array(inputs: FileDto): Promise<Uint8Array<ArrayBufferLike>>

  يقرأ كل بايتات File أو Blob في Uint8Array، مصفوفة بايتات يمكن فهرستها وتقطيعها.

  Parameters

  • inputs: FileDto

    كائن File أو Blob المراد قراءته

  Returns Promise<Uint8Array<ArrayBufferLike>>

  البايتات ككائن Uint8Array

  Example

  const bytes = await bitbybit.asset.toUint8Array({ file });
  Copy

blobToFile

• blobToFile(inputs: BlobToFileDto): File

  يلف Blob في ملف File باسم ونوع MIME، وهو ما تحتاجه المحمّلات التي تريد اسم ملف؛ يُحتفظ بنوع Blob نفسه عند ترك mimeType.

  Parameters

  • inputs: BlobToFileDto

    كائن Blob واسم الملف ونوع MIME الاختياري

  Returns File

  كائن File

  Example

  const file = bitbybit.asset.blobToFile({ blob, fileName: "part.step", mimeType: "application/step" });
  Copy

fileToBlob

• fileToBlob(inputs: FileDto): Blob

  ينسخ بايتات ملف File في Blob عادي من النوع نفسه، مسقطا الاسم؛ و Blob المعطى يعود كنسخة.

  Parameters

  • inputs: FileDto

    كائن File أو Blob المراد نسخه

  Returns Blob

  كائن Blob

  Example

  const blob = bitbybit.asset.fileToBlob({ file });
  Copy

arrayBufferToUint8Array

• arrayBufferToUint8Array(inputs: ArrayBufferToUint8ArrayDto): Uint8Array

  يعرض بايتات ArrayBuffer كـ Uint8Array؛ لا تُنسخ أي بايتات، ويتشاركان الذاكرة نفسها.

  Parameters

  • inputs: ArrayBufferToUint8ArrayDto

    كائن ArrayBuffer المراد عرضه

  Returns Uint8Array

  كائن Uint8Array على البايتات نفسها

  Example

  const bytes = bitbybit.asset.arrayBufferToUint8Array({ arrayBuffer });
  Copy

uint8ArrayToArrayBuffer

• uint8ArrayToArrayBuffer(inputs: Uint8ArrayToArrayBufferDto): ArrayBuffer

  ينسخ بالضبط البايتات التي تغطيها Uint8Array في ArrayBuffer جديد، بحيث يعطي العرض على جزء من مخزن أكبر جزءه الخاص فقط.

  Parameters

  • inputs: Uint8ArrayToArrayBufferDto

    كائن Uint8Array المراد نسخه

  Returns ArrayBuffer

  كائن ArrayBuffer الجديد

  Example

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

createObjectURL

• createObjectURL(inputs: FileDto): string

  يصنع عنوان URL مؤقتا لملف File أو Blob محفوظ في الذاكرة، بحيث يمكن تسليمه لأي شيء يحمّل من عنوان URL، مثل نسيج أو محمّل نماذج.

  يعيش عنوان URL ما دامت الصفحة حية.

  Parameters

  • inputs: FileDto

    كائن File أو Blob

  Returns string

  عنوان URL المؤقت

  Example

  const url = bitbybit.asset.createObjectURL({ file });
  Copy

createObjectURLs

• createObjectURLs(inputs: FilesDto): string[]

  يصنع عنوان URL مؤقتا لكل File أو Blob في قائمة، بالترتيب نفسه، كما تفعل createObjectURL لواحد.

  Parameters

  • inputs: FilesDto

    كائنات File أو Blob

  Returns string[]

  عنوان URL مؤقت واحد لكل ملف، بالترتيب نفسه

  Example

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

download

• download(inputs: DownloadDto): void

  يبدأ تنزيلا في المتصفح للمحتوى المعطى كملف مسمى fileName زائد extension.

  يُلف المحتوى النصي في Blob من نوع contentType؛ و Blob يُنزّل كما هو.

  Parameters

  • inputs: DownloadDto

    اسم الملف والمحتوى والامتداد ونوع المحتوى

  Returns void

  Example

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

fetchBlob

• fetchBlob(inputs: FetchDto): Promise<Blob>

  ينزّل المحتوى عند عنوان URL كـ Blob، بايتات خام بلا اسم ملف؛ يجب أن يسمح الخادم بالطلبات عبر الأصول.

  Parameters

  • inputs: FetchDto

    عنوان URL المراد جلبه

  Returns Promise<Blob>

  جسم الاستجابة ككائن Blob

  Example

  const blob = await bitbybit.asset.fetchBlob({ url: "https://example.com/models/part.glb" });
  Copy

fetchFile

• fetchFile(inputs: FetchDto): Promise<File>

  ينزّل المحتوى عند عنوان URL كملف File مسمى على اسم الجزء الأخير من عنوان URL، دون سلسلة الاستعلام؛ يجب أن يسمح الخادم بالطلبات عبر الأصول.

  Parameters

  • inputs: FetchDto

    عنوان URL المراد جلبه

  Returns Promise<File>

  جسم الاستجابة ككائن File

  Example

  const file = await bitbybit.asset.fetchFile({ url: "https://example.com/models/part.step" });
  const shape = await bitbybit.occt.io.loadSTEPorIGES({ assetFile: file, adjustZtoY: true });
  Copy

fetchJSON

• fetchJSON(inputs: FetchDto): Promise<any>

  ينزّل المحتوى عند عنوان URL ويحلله كـ JSON؛ يجب أن يسمح الخادم بالطلبات عبر الأصول وأن يكون المتن JSON صالحا.

  Parameters

  • inputs: FetchDto

    عنوان URL المراد جلبه

  Returns Promise<any>

  قيمة JSON المحللة

  Example

  const settings = await bitbybit.asset.fetchJSON({ url: "https://example.com/data/settings.json" });
  Copy

fetchText

• fetchText(inputs: FetchDto): Promise<string>

  ينزّل المحتوى عند عنوان URL كنص عادي؛ يجب أن يسمح الخادم بالطلبات عبر الأصول.

  Parameters

  • inputs: FetchDto

    عنوان URL المراد جلبه

  Returns Promise<string>

  جسم الاستجابة كنص

  Example

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

getFile

• getFile(inputs: GetAssetDto): Promise<File>

  يحمّل أصلا رقميا مسمى للتطبيق الجاري كملف File، عبر البحث الذي يوفره التطبيق في assetManager.getAsset.

  يعتمد المخزن الذي يُبحث فيه عن الاسم على التطبيق؛ الأصل الرقمي المفقود يرفض الوعد.

  Parameters

  • inputs: GetAssetDto

    اسم ملف الأصل

  Returns Promise<File>

  الأصل ككائن File

  Example

  const file = await bitbybit.asset.getFile({ fileName: "part.step" });
  const shape = await bitbybit.occt.io.loadSTEPorIGES({ assetFile: file, adjustZtoY: true });
  Copy

getTextFile

• getTextFile(inputs: GetAssetDto): Promise<string>

  يحمّل أصلا رقميا مسمى للتطبيق الجاري ويقرؤه كنص، لملفات JSON أو CSV أو غيرها من الملفات النصية المخزنة كأصول رقمية.

  Parameters

  • inputs: GetAssetDto

    اسم ملف الأصل

  Returns Promise<string>

  محتوى الأصل كنص

  Example

  const csv = await bitbybit.asset.getTextFile({ fileName: "points.csv" });
  const rows = bitbybit.csv.parseToArray({ csv, rowSeparator: "\n", columnSeparator: "," });
  Copy

getLocalFile

• getLocalFile(inputs: GetAssetDto): Promise<File | File[]>

  يحمّل أصلا رقميا محليا مسمى، محفوظا في المتصفح لا على خادم، عبر البحث الذي يوفره التطبيق في assetManager.getLocalAsset.

  الاسم الذي يؤدي إلى عدة ملفات يعطي قائمة.

  Parameters

  • inputs: GetAssetDto

    اسم ملف الأصل

  Returns Promise<File | File[]>

  الأصل ككائن File، أو قائمة من كائنات File عندما يحمل الاسم عدة ملفات

  Example

  const file = await bitbybit.asset.getLocalFile({ fileName: "part.step" });
  Copy

getLocalTextFile

• getLocalTextFile(inputs: GetAssetDto): Promise<string | string[]>

  يحمّل أصلا رقميا محليا مسمى، محفوظا في المتصفح لا على خادم، ويقرؤه كنص؛ الاسم الذي يؤدي إلى عدة ملفات يعطي قائمة نصوص.

  Parameters

  • inputs: GetAssetDto

    اسم ملف الأصل

  Returns Promise<string | string[]>

  المحتوى كنص، أو قائمة من النصوص عندما يحمل الاسم عدة ملفات

  Example

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