2
0

FileLoader.html 5.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131
  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. فئة منخفضة المستوى لتحميل الموارد باستخدام Fetch ، يتم استخدامها داخليًا من قبل
  14. معظم المحملات. يمكن أيضًا استخدامها مباشرة لتحميل أي نوع ملف لا يحتوي على
  15. محمل.
  16. </p>
  17. <h2>مثال الكود</h2>
  18. <code>
  19. const loader = new THREE.FileLoader();
  20. //load a text file and output the result to the console
  21. loader.load(
  22. // resource URL
  23. 'example.txt',
  24. // onLoad callback
  25. function ( data ) {
  26. // output the text to the console
  27. console.log( data )
  28. },
  29. // onProgress callback
  30. function ( xhr ) {
  31. console.log( (xhr.loaded / xhr.total * 100) + '% loaded' );
  32. },
  33. // onError callback
  34. function ( err ) {
  35. console.error( 'An error happened' );
  36. }
  37. );
  38. </code>
  39. <p>
  40. * ملاحظة: * يجب تمكين ذاكرة التخزين المؤقت باستخدام
  41. <code>THREE.Cache.enabled = true;</code>
  42. هذه خاصية عالمية ولا يحتاج إلى تعيينها مرة واحدة فقط لتستخدمها جميع
  43. المحملات التي تستخدم FileLoader داخليًا. [page:Cache Cache] هو وحدة ذاكرة التخزين المؤقت
  44. التي تحتوي على الاستجابة من كل طلب يتم من خلال هذا المحمل ،
  45. لذلك يتم طلب كل ملف مرة واحدة.
  46. </p>
  47. <h2>المنشئ (Constructor)</h2>
  48. <h3>[name] ( [param:LoadingManager manager] )</h3>
  49. <p>
  50. [page:LoadingManager manager] - [page:LoadingManager loadingManager]
  51. للمحمل الذي سيستخدمه. الافتراضي هو [page:DefaultLoadingManager].
  52. </p>
  53. <h2>الخصائص (Properties)</h2>
  54. <p>انظر إلى الصفحة الأساسية [page:Loader] للخصائص المشتركة.</p>
  55. <h3>[property:String mimeType]</h3>
  56. <p>
  57. المتوقع
  58. [link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types mimeType].
  59. انظر [page:.setMimeType]. الافتراضي هو `undefined`.
  60. </p>
  61. <h3>[property:String responseType]</h3>
  62. <p>
  63. نوع الاستجابة المتوقع. انظر [page:.setResponseType]. الافتراضي هو
  64. `undefined`.
  65. </p>
  66. <h2>الطرق (Methods)</h2>
  67. <p>انظر إلى الصفحة الأساسية [page:Loader] للطرق المشتركة.</p>
  68. <h3>
  69. [method:undefined load]( [param:String url], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )
  70. </h3>
  71. <p>
  72. [page:String url] - المسار أو عنوان URL للملف. يمكن أن يكون هذا أيضًا
  73. [link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URI].<br />
  74. [page:Function onLoad] (اختياري) - سيتم استدعاؤه عند اكتمال التحميل.
  75. الوسيطة ستكون الاستجابة المحملة.<br />
  76. [page:Function onProgress] (اختياري) - سيتم استدعاؤه أثناء تقدم التحميل.
  77. الوسيطة ستكون مثيل ProgressEvent ، والذي
  78. يحتوي على .[page:Boolean lengthComputable]، .[page:Integer total] و
  79. .[page:Integer loaded]. إذا لم يضع الخادم رأس Content-Length
  80. ؛ .[page:Integer total] ستكون 0.<br />
  81. [page:Function onError] (اختياري) - سيتم استدعاؤه في حالة حدوث خطأ.<br /><br />
  82. قم بتحميل عنوان URL وإرسال الاستجابة إلى وظيفة onLoad.
  83. </p>
  84. <h3>[method:this setMimeType]( [param:String mimeType] )</h3>
  85. <p>
  86. قم بتعيين
  87. [link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types mimeType]
  88. المتوقع للملف الذي يتم تحميله. لاحظ أنه في كثير من الحالات سيتم
  89. تحديده تلقائيًا ، لذلك بشكل افتراضي هو `undefined`.
  90. </p>
  91. <h3>[method:this setResponseType]( [param:String responseType] )</h3>
  92. <p>
  93. قم بتغيير نوع الاستجابة. القيم المقبولة هي:<br />
  94. [page:String text] أو سلسلة فارغة (افتراضية) - تعود بالبيانات كـ
  95. [page:String String].<br />
  96. [page:String arraybuffer] - يحمل البيانات في
  97. [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer ArrayBuffer]
  98. ويرجع ذلك.<br />
  99. [page:String blob] - يعود بالبيانات كـ
  100. [link:https://developer.mozilla.org/en/docs/Web/API/Blob Blob].<br />
  101. [page:String document] - يحلل الملف باستخدام
  102. [link:https://developer.mozilla.org/en-US/docs/Web/API/DOMParser DOMParser].<br />
  103. [page:String json] - يحلل الملف باستخدام
  104. [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/parse JSON.parse].<br />
  105. </p>
  106. <h2>المصدر (Source)</h2>
  107. <p>
  108. [link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
  109. </p>
  110. </body>
  111. </html>