ImageBitmapLoader.html 4.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117
  1. <!DOCTYPE html>
  2. <html lang="ar">
  3. <head>
  4. <meta charset="utf-8" />
  5. <base href="../../../" />
  6. <script src="page.js"></script>
  7. <link type="text/css" rel="stylesheet" href="page.css" />
  8. </head>
  9. <body class="rtl">
  10. [page:Loader] &rarr;
  11. <h1>[name]</h1>
  12. <p class="desc">
  13. محمل لتحميل صورة [page:Image] كـ
  14. [link:https://developer.mozilla.org/en-US/docs/Web/API/ImageBitmap ImageBitmap]. يوفر ImageBitmap مسارًا غير متزامن وفعال من حيث الموارد
  15. لإعداد القوام للتقديم في WebGL.<br />
  16. على عكس [page:FileLoader]، [name] لا يتجنب الطلبات المتعددة المتزامنة
  17. إلى نفس عنوان URL.
  18. </p>
  19. <p>
  20. لاحظ أن [page:Texture.flipY] و [page:Texture.premultiplyAlpha] مع
  21. [link:https://developer.mozilla.org/en-US/docs/Web/API/ImageBitmap ImageBitmap] يتم تجاهلهم.
  22. [link:https://developer.mozilla.org/en-US/docs/Web/API/ImageBitmap ImageBitmap]
  23. يحتاج هذه التكوينات على إنشاء الخريطة البيانية على عكس الصور العادية التي تحتاجها عند تحميلها على وحدة معالجة الرسومات. تحتاج إلى تعيين الخيارات المكافئة عبر [page:ImageBitmapLoader.setOptions] بدلاً من ذلك. راجع
  24. [link:https://www.khronos.org/registry/webgl/specs/latest/1.0/#6.10 WebGL specification] للحصول على التفاصيل.
  25. </p>
  26. <h2>مثال الكود</h2>
  27. <code>
  28. const loader = new THREE.FileLoader();
  29. //load a text file and output the result to the console
  30. loader.load(
  31. // resource URL
  32. 'example.txt',
  33. // onLoad callback
  34. function ( data ) {
  35. // output the text to the console
  36. console.log( data )
  37. },
  38. // onProgress callback
  39. function ( xhr ) {
  40. console.log( (xhr.loaded / xhr.total * 100) + '% loaded' );
  41. },
  42. // onError callback
  43. function ( err ) {
  44. console.error( 'An error happened' );
  45. }
  46. );
  47. </code>
  48. <h2>أمثلة (Examples)</h2>
  49. <p>[example:webgl_loader_imagebitmap WebGL / loader / ImageBitmap]</p>
  50. <h2>المنشئ (Constructor)</h2>
  51. <h3>[name]( [param:LoadingManager manager] )</h3>
  52. <p>
  53. [page:LoadingManager manager] - [page:LoadingManager loadingManager]
  54. للمحمل الذي سيستخدمه. الافتراضي هو [page:LoadingManager THREE.DefaultLoadingManager].<br /><br />
  55. ينشئ جديد [name].
  56. </p>
  57. <h2>الخصائص (Properties)</h2>
  58. <p>انظر إلى الصفحة الأساسية [page:Loader] للخصائص المشتركة.</p>
  59. <h3>[property:Boolean isImageBitmapLoader]</h3>
  60. <p>علامة للقراءة فقط للتحقق مما إذا كان الكائن المعطى هو من نوع [name].</p>
  61. <h3>[property:String options]</h3>
  62. <p>
  63. كائن اختياري يضع خيارات لـ
  64. [link:https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/createImageBitmap createImageBitmap]
  65. طريقة المصنع المستخدمة داخليًا. الافتراضي هو `undefined`.
  66. </p>
  67. <h2>الطرق (Methods)</h2>
  68. <p>انظر إلى الصفحة الأساسية [page:Loader] للطرق المشتركة.</p>
  69. <h3>
  70. [method:undefined load]( [param:String url], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )
  71. </h3>
  72. <p>
  73. [page:String url] - المسار أو عنوان URL للملف. يمكن أن يكون هذا أيضًا
  74. [link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URI].<br />
  75. [page:Function onLoad] - سيتم استدعاؤه عند اكتمال التحميل. الوسيطة
  76. ستكون الصورة المحملة [page:Image image].<br />
  77. [page:Function onProgress] (اختياري) - هذه وظيفة رد الاتصال
  78. غير مدعوم حاليًا.<br />
  79. [page:Function onError] (اختياري) - سيتم استدعاؤه عند حدوث خطأ في التحميل.<br />
  80. </p>
  81. <p>
  82. قم ببدء التحميل من عنوان URL وإرجاع كائن الصورة [page:ImageBitmap image]
  83. الذي سيحتوي على البيانات.
  84. </p>
  85. <h3>[method:this setOptions]( [param:Object options] )</h3>
  86. <p>
  87. يضع كائن الخيارات لـ
  88. [link:https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/createImageBitmap createImageBitmap].
  89. </p>
  90. <h2>المصدر (Source)</h2>
  91. <p>
  92. [link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
  93. </p>
  94. </body>
  95. </html>