واجهة Raylib وحدودها وأخطاؤها

العقد الأصلي

المضيف الأصلي فقط، لبات 0.7.0 المنشور. استورد core::raylib أو أساسي::رايليب في كل وحدة مصدر تستخدمها. تقبل كل بادئة قصيرة مستوردة مفردات الأعضاء باللغتين، واستورد الصيغتين لاستخدام البادئتين. تحتفظ معرفات المستخدم وحقول سجلاته ونصوصه ومساراته بهويتها. لا تحتاج العمليات الموردة إلى تصريح unsafe ولا تكشف واصفات أصلية.

اقرأ دليل الرسم والنص والصوت ومجموعة الأمثلة. لا يحتاج الفحص والبناء إلى شاشة أو مترجم C. تحتاج عمليات النافذة إلى رسوم Linux مدعومة مع OpenGL 3.3 core، والصوت إلى جهاز PulseAudio متوافق أو ALSA متاح. لا يحتاج النص على المعالج إلى أي منهما. راجع متطلبات النشر. يرفض المتصفح والتضمين الخاص هذه المكتبة الموردة بالرمز unsupported-supplied-library-profile حتى مع الاستيراد غير المستخدم.

تعيد كل الاستدعاءات العادية نتائج مفحوصة. الفحوص الكلية السبعة IsWindowReady وIsTextureValid وIsFontValid وIsTextLayoutValid وIsAudioDeviceReady وIsSoundValid وIsMusicValid تعيد bool. اقرأ فرع النتيجة المحدد وحده. أحجام الأعداد دقيقة، وحوّل القيمة الأوسع ذات النوع المحدد صراحة. تحفظ الجداول أدناه التصريحات المزدوجة المقبولة والمفحوصة مقابل فهرس الإنتاج. تسري قواعد السياق عبر المساعدات وقيم الدوال أيضا.

تحتاج السجلات إلى كل حقل مرة واحدة. تعد صيغتا الحقل الواحد تكرارا. تنسخ السجلات بالقيمة وتحتاج الطفرة إلى جذر قابل للتعديل. تقبل تعدادات المفتاح والفأرة والمرشح والالتفاف واتجاه النص ومحاذاته التخزين والمساواة من النوع نفسه دون بناء من أعداد أو حساب أو ترتيب. يقبل WindowFlags عمليات | و& و^ و~ المحدودة والمساواة من النوع نفسه باستعمال البتات الخمسة المدعومة والمجموعة الفارغة. يقبل TextureFilter القيمتين POINT وBILINEAR، وTextureWrap القيمتين REPEAT وCLAMP. Texture وFont وTextLayout وSound وMusic ملاك مدارون مشتركون معتمون.

الأنواع والحقول

Vector2 / متجه2

Rectangle / مستطيل

Color / لون

Camera2D / كاميرا2

TextOptions / خيارات_النص

TextMetrics / مقاييس_النص

الثوابت

النافذة ودورة الحياة

SetConfigFlags / اضبط_أعلام_الإعداد

(flags: WindowFlags) -> result<unit>

التطبيق والخيط الرئيسي وخارج إطار الرسم، مع شروط الجهاز والمالك.

يستبدل أعلام النافذة التالية المحفوظة. يشترط عدم وجود نافذة حية وتبقى الأعلام بعد إعادة الفتح.

InitWindow / هيئ_نافذة

(width: i32, height: i32, title: string) -> result<unit>

التطبيق والخيط الرئيسي وخارج إطار الرسم، مع شروط الجهاز والمالك.

أبعاد موجبة، ونسخة محفوظة من بايتات العنوان. يعيد الجيل الجديد مفتاح هروب والإدخال والتوقيت إلى البداية.

IsWindowReady / هل_النافذة_جاهزة

() -> bool

فحص كلي، مسموح للمعالجات والدوال الراجعة، دون دخول جهاز أصلي.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

WindowShouldClose / هل_يجب_إغلاق_النافذة

() -> result<bool>

التطبيق والخيط الرئيسي ونافذة حية، وتسمح الملاحظات المأخوذة داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

CloseWindow / أغلق_النافذة

() -> result<unit>

التطبيق والخيط الرئيسي وخارج إطار الرسم، مع شروط الجهاز والمالك.

يغلق نسخ الأنسجة ومخابئ GPU قبل تدمير السياق. تبقى الخطوط والتخطيطات على المعالج.

SetWindowTitle / اضبط_عنوان_النافذة

(title: string) -> result<unit>

التطبيق والخيط الرئيسي وخارج إطار الرسم، مع شروط الجهاز والمالك.

يحتفظ بنسخة العنوان حتى الاستبدال وانتهاء الاستخدام الأصلي. يبقى العنوان الحالي عند الرفض ويرفض NUL.

GetScreenWidth / عرض_الشاشة

() -> result<i32>

التطبيق والخيط الرئيسي ونافذة حية، وتسمح الملاحظات المأخوذة داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

GetScreenHeight / ارتفاع_الشاشة

() -> result<i32>

التطبيق والخيط الرئيسي ونافذة حية، وتسمح الملاحظات المأخوذة داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

GetRenderWidth / عرض_التصيير

() -> result<i32>

التطبيق والخيط الرئيسي ونافذة حية، وتسمح الملاحظات المأخوذة داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

GetRenderHeight / ارتفاع_التصيير

() -> result<i32>

التطبيق والخيط الرئيسي ونافذة حية، وتسمح الملاحظات المأخوذة داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

IsWindowResized / هل_تغير_حجم_النافذة

() -> result<bool>

التطبيق والخيط الرئيسي ونافذة حية، وتسمح الملاحظات المأخوذة داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

إطارات الرسم والتوقيت

BeginDrawing / ابدأ_الرسم

() -> result<unit>

التطبيق والخيط الرئيسي، مع قواعد أزواج الرسم ووضع الكاميرا.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

EndDrawing / أنه_الرسم

() -> result<unit>

التطبيق والخيط الرئيسي، مع قواعد أزواج الرسم ووضع الكاميرا.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

ClearBackground / امسح_الخلفية

(color: Color) -> result<unit>

التطبيق والخيط الرئيسي وداخل إطار رسم.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

SetTargetFPS / اضبط_معدل_الإطارات

(fps: i32) -> result<unit>

التطبيق والخيط الرئيسي وخارج إطار الرسم، مع شروط الجهاز والمالك.

معدل غير سالب. الصفر بلا سقف وتبقى إعدادات التوقيت بعد إعادة الفتح.

GetFrameTime / زمن_الإطار

() -> result<f32>

التطبيق والخيط الرئيسي ونافذة حية، وتسمح الملاحظات المأخوذة داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

GetTime / الزمن

() -> result<f64>

التطبيق والخيط الرئيسي ونافذة حية، وتسمح الملاحظات المأخوذة داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

GetFPS / معدل_الإطارات

() -> result<i32>

التطبيق والخيط الرئيسي ونافذة حية، وتسمح الملاحظات المأخوذة داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

إدخال لوحة المفاتيح والفأرة والحجم

IsKeyPressed / هل_ضغط_المفتاح

(key: Key) -> result<bool>

التطبيق والخيط الرئيسي ونافذة حية، وتسمح الملاحظات المأخوذة داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

IsKeyPressedRepeat / هل_تكرر_ضغط_المفتاح

(key: Key) -> result<bool>

التطبيق والخيط الرئيسي ونافذة حية، وتسمح الملاحظات المأخوذة داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

IsKeyDown / هل_المفتاح_مضغوط

(key: Key) -> result<bool>

التطبيق والخيط الرئيسي ونافذة حية، وتسمح الملاحظات المأخوذة داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

IsKeyReleased / هل_حرر_المفتاح

(key: Key) -> result<bool>

التطبيق والخيط الرئيسي ونافذة حية، وتسمح الملاحظات المأخوذة داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

IsKeyUp / هل_المفتاح_غير_مضغوط

(key: Key) -> result<bool>

التطبيق والخيط الرئيسي ونافذة حية، وتسمح الملاحظات المأخوذة داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

GetKeyPressed / المفتاح_المضغوط

() -> result<Key>

التطبيق والخيط الرئيسي ونافذة حية، وتسمح الملاحظات المأخوذة داخل إطار.

يستهلك عنصرا واحدا من الطابور. يعيد مفتاح_لا_شيء عندما يكون الطابور فارغا.

GetCharPressed / المحرف_المدخل

() -> result<i32>

التطبيق والخيط الرئيسي ونافذة حية، وتسمح الملاحظات المأخوذة داخل إطار.

يستهلك عنصرا واحدا من الطابور ويعيد صفرا أو قيمة Unicode مفحوصة من نوع ص32.

SetExitKey / اضبط_مفتاح_الخروج

(key: Key) -> result<unit>

التطبيق والخيط الرئيسي وخارج إطار الرسم، مع شروط الجهاز والمالك.

مفتاح_لا_شيء يعطل مفتاح الخروج. يعيد الفتح مفتاح هروب.

IsMouseButtonPressed / هل_ضغط_زر_الفأرة

(button: MouseButton) -> result<bool>

التطبيق والخيط الرئيسي ونافذة حية، وتسمح الملاحظات المأخوذة داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

IsMouseButtonDown / هل_زر_الفأرة_مضغوط

(button: MouseButton) -> result<bool>

التطبيق والخيط الرئيسي ونافذة حية، وتسمح الملاحظات المأخوذة داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

IsMouseButtonReleased / هل_حرر_زر_الفأرة

(button: MouseButton) -> result<bool>

التطبيق والخيط الرئيسي ونافذة حية، وتسمح الملاحظات المأخوذة داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

IsMouseButtonUp / هل_زر_الفأرة_غير_مضغوط

(button: MouseButton) -> result<bool>

التطبيق والخيط الرئيسي ونافذة حية، وتسمح الملاحظات المأخوذة داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

GetMousePosition / موضع_الفأرة

() -> result<Vector2>

التطبيق والخيط الرئيسي ونافذة حية، وتسمح الملاحظات المأخوذة داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

GetMouseDelta / تغير_موضع_الفأرة

() -> result<Vector2>

التطبيق والخيط الرئيسي ونافذة حية، وتسمح الملاحظات المأخوذة داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

GetMouseWheelMove / حركة_عجلة_الفأرة

() -> result<f32>

التطبيق والخيط الرئيسي ونافذة حية، وتسمح الملاحظات المأخوذة داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

GetMouseWheelMoveV / حركة_عجلة_الفأرة_بمتجه

() -> result<Vector2>

التطبيق والخيط الرئيسي ونافذة حية، وتسمح الملاحظات المأخوذة داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

الرسم ثنائي الأبعاد

DrawPixel / ارسم_بكسلا

(posX: i32, posY: i32, color: Color) -> result<unit>

التطبيق والخيط الرئيسي وداخل إطار رسم.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

DrawPixelV / ارسم_بكسلا_بمتجه

(position: Vector2, color: Color) -> result<unit>

التطبيق والخيط الرئيسي وداخل إطار رسم.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

DrawLine / ارسم_خطا

(startPosX: i32, startPosY: i32, endPosX: i32, endPosY: i32, color: Color) -> result<unit>

التطبيق والخيط الرئيسي وداخل إطار رسم.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

DrawLineV / ارسم_خطا_بمتجه

(startPos: Vector2, endPos: Vector2, color: Color) -> result<unit>

التطبيق والخيط الرئيسي وداخل إطار رسم.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

DrawLineEx / ارسم_خطا_موسعا

(startPos: Vector2, endPos: Vector2, thick: f32, color: Color) -> result<unit>

التطبيق والخيط الرئيسي وداخل إطار رسم.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

DrawCircle / ارسم_دائرة

(centerX: i32, centerY: i32, radius: f32, color: Color) -> result<unit>

التطبيق والخيط الرئيسي وداخل إطار رسم.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

DrawCircleV / ارسم_دائرة_بمتجه

(center: Vector2, radius: f32, color: Color) -> result<unit>

التطبيق والخيط الرئيسي وداخل إطار رسم.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

DrawCircleLines / ارسم_محيط_دائرة

(centerX: i32, centerY: i32, radius: f32, color: Color) -> result<unit>

التطبيق والخيط الرئيسي وداخل إطار رسم.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

DrawRectangle / ارسم_مستطيلا

(posX: i32, posY: i32, width: i32, height: i32, color: Color) -> result<unit>

التطبيق والخيط الرئيسي وداخل إطار رسم.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

DrawRectangleV / ارسم_مستطيلا_بمتجه

(position: Vector2, size: Vector2, color: Color) -> result<unit>

التطبيق والخيط الرئيسي وداخل إطار رسم.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

DrawRectangleRec / ارسم_مستطيلا_بسجل

(rec: Rectangle, color: Color) -> result<unit>

التطبيق والخيط الرئيسي وداخل إطار رسم.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

DrawRectanglePro / ارسم_مستطيلا_متقدما

(rec: Rectangle, origin: Vector2, rotation: f32, color: Color) -> result<unit>

التطبيق والخيط الرئيسي وداخل إطار رسم.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

DrawRectangleLines / ارسم_محيط_مستطيل

(posX: i32, posY: i32, width: i32, height: i32, color: Color) -> result<unit>

التطبيق والخيط الرئيسي وداخل إطار رسم.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

DrawRectangleLinesEx / ارسم_محيط_مستطيل_موسعا

(rec: Rectangle, lineThick: f32, color: Color) -> result<unit>

التطبيق والخيط الرئيسي وداخل إطار رسم.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

DrawTriangle / ارسم_مثلثا

(v1: Vector2, v2: Vector2, v3: Vector2, color: Color) -> result<unit>

التطبيق والخيط الرئيسي وداخل إطار رسم.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

DrawTriangleLines / ارسم_محيط_مثلث

(v1: Vector2, v2: Vector2, v3: Vector2, color: Color) -> result<unit>

التطبيق والخيط الرئيسي وداخل إطار رسم.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

الأنسجة والصور

LoadTexture / حمل_نسيجا

(fileName: string) -> result<Texture>

التطبيق والخيط الرئيسي وخارج إطار الرسم، مع شروط الجهاز والمالك.

PNG فقط، بمسار نسبة إلى مجلد العمل ونسخة من بايتات المسار. يتطلب نافذة حية.

IsTextureValid / هل_النسيج_صالح

(texture: Texture) -> bool

فحص كلي، مسموح للمعالجات والدوال الراجعة، دون دخول جهاز أصلي.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

UnloadTexture / حرر_النسيج

(texture: Texture) -> result<unit>

التطبيق والخيط الرئيسي. يجوز الإغلاق المنطقي داخل إطار وينجح تحرير المورد المغلق.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

SetTextureFilter / اضبط_مرشح_النسيج

(texture: Texture, filter: TextureFilter) -> result<unit>

التطبيق والخيط الرئيسي وخارج إطار الرسم، مع شروط الجهاز والمالك.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

SetTextureWrap / اضبط_التفاف_النسيج

(texture: Texture, wrap: TextureWrap) -> result<unit>

التطبيق والخيط الرئيسي وخارج إطار الرسم، مع شروط الجهاز والمالك.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

DrawTexture / ارسم_نسيجا

(texture: Texture, posX: i32, posY: i32, tint: Color) -> result<unit>

التطبيق والخيط الرئيسي وداخل إطار رسم.

الأبعاد الموقعة للمصدر تحفظ الانعكاس. يبقى سلوك رايليب المسموح للمقياس الصفري والسالب والوجهات الموقعة، مع فحص إمكان تمثيل الحسابات الناتجة.

DrawTextureV / ارسم_نسيجا_بمتجه

(texture: Texture, position: Vector2, tint: Color) -> result<unit>

التطبيق والخيط الرئيسي وداخل إطار رسم.

الأبعاد الموقعة للمصدر تحفظ الانعكاس. يبقى سلوك رايليب المسموح للمقياس الصفري والسالب والوجهات الموقعة، مع فحص إمكان تمثيل الحسابات الناتجة.

DrawTextureEx / ارسم_نسيجا_موسعا

(texture: Texture, position: Vector2, rotation: f32, scale: f32, tint: Color) -> result<unit>

التطبيق والخيط الرئيسي وداخل إطار رسم.

الأبعاد الموقعة للمصدر تحفظ الانعكاس. يبقى سلوك رايليب المسموح للمقياس الصفري والسالب والوجهات الموقعة، مع فحص إمكان تمثيل الحسابات الناتجة.

DrawTextureRec / ارسم_جزء_نسيج

(texture: Texture, source: Rectangle, position: Vector2, tint: Color) -> result<unit>

التطبيق والخيط الرئيسي وداخل إطار رسم.

الأبعاد الموقعة للمصدر تحفظ الانعكاس. يبقى سلوك رايليب المسموح للمقياس الصفري والسالب والوجهات الموقعة، مع فحص إمكان تمثيل الحسابات الناتجة.

DrawTexturePro / ارسم_نسيجا_متقدما

(texture: Texture, source: Rectangle, dest: Rectangle, origin: Vector2, rotation: f32, tint: Color) -> result<unit>

التطبيق والخيط الرئيسي وداخل إطار رسم.

الأبعاد الموقعة للمصدر تحفظ الانعكاس. يبقى سلوك رايليب المسموح للمقياس الصفري والسالب والوجهات الموقعة، مع فحص إمكان تمثيل الحسابات الناتجة.

GetTextureWidth / عرض_النسيج

(texture: Texture) -> result<i32>

بيانات مالك للقراءة فقط، مسموحة للمعالجات والدوال الراجعة مع فحص إغلاق المالك.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

GetTextureHeight / ارتفاع_النسيج

(texture: Texture) -> result<i32>

بيانات مالك للقراءة فقط، مسموحة للمعالجات والدوال الراجعة مع فحص إغلاق المالك.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

أوضاع كاميرا2 وتحويلاتها

BeginMode2D / ابدأ_وضع_ثنائي_الأبعاد

(camera: Camera2D) -> result<unit>

التطبيق والخيط الرئيسي، مع قواعد أزواج الرسم ووضع الكاميرا.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

EndMode2D / أنه_وضع_ثنائي_الأبعاد

() -> result<unit>

التطبيق والخيط الرئيسي، مع قواعد أزواج الرسم ووضع الكاميرا.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

GetWorldToScreen2D / من_العالم_إلى_الشاشة

(position: Vector2, camera: Camera2D) -> result<Vector2>

حساب مفحوص، مسموح للمعالجات والدوال الراجعة، دون اشتراط جهاز أو إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

GetScreenToWorld2D / من_الشاشة_إلى_العالم

(position: Vector2, camera: Camera2D) -> result<Vector2>

حساب مفحوص، مسموح للمعالجات والدوال الراجعة، دون اشتراط جهاز أو إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

هندسة التصادم

CheckCollisionRecs / هل_يتداخل_مستطيلان

(rec1: Rectangle, rec2: Rectangle) -> result<bool>

حساب مفحوص، مسموح للمعالجات والدوال الراجعة، دون اشتراط جهاز أو إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

CheckCollisionCircles / هل_تتداخل_دائرتان

(center1: Vector2, radius1: f32, center2: Vector2, radius2: f32) -> result<bool>

حساب مفحوص، مسموح للمعالجات والدوال الراجعة، دون اشتراط جهاز أو إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

CheckCollisionCircleRec / هل_تتداخل_دائرة_ومستطيل

(center: Vector2, radius: f32, rec: Rectangle) -> result<bool>

حساب مفحوص، مسموح للمعالجات والدوال الراجعة، دون اشتراط جهاز أو إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

CheckCollisionPointRec / هل_النقطة_في_مستطيل

(point: Vector2, rec: Rectangle) -> result<bool>

حساب مفحوص، مسموح للمعالجات والدوال الراجعة، دون اشتراط جهاز أو إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

CheckCollisionPointCircle / هل_النقطة_في_دائرة

(point: Vector2, center: Vector2, radius: f32) -> result<bool>

حساب مفحوص، مسموح للمعالجات والدوال الراجعة، دون اشتراط جهاز أو إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

CheckCollisionPointTriangle / هل_النقطة_في_مثلث

(point: Vector2, p1: Vector2, p2: Vector2, p3: Vector2) -> result<bool>

حساب مفحوص، مسموح للمعالجات والدوال الراجعة، دون اشتراط جهاز أو إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

GetCollisionRec / مستطيل_التداخل

(rec1: Rectangle, rec2: Rectangle) -> result<Rectangle>

حساب مفحوص، مسموح للمعالجات والدوال الراجعة، دون اشتراط جهاز أو إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

اختيار الخطوط وملكيتها

GetFontDefault / الخط_الافتراضي

() -> result<Font>

نص على المعالج، مسموح للمعالجات والدوال الراجعة، دون نافذة.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

LoadFont / حمل_خطا

(fileName: string) -> result<Font>

التطبيق والخيط الرئيسي وخارج إطار الرسم، مع شروط الجهاز والمالك.

خط TrueType ذو وجه واحد وحدود متجهة. تبقى بايتات الملف المنسوخة بعد استبداله وتتوفر الخطوط الاحتياطية المضمنة.

LoadFontEx / حمل_خطا_موسعا

(fileName: string, fontSize: i32, codepoints: list<i32>) -> result<Font>

التطبيق والخيط الرئيسي وخارج إطار الرسم، مع شروط الجهاز والمالك.

حجم أساسي 1..4096. قائمة ص32 تلميحات لتجهيز المحارف تنسخها المكتبة. القائمة الفارغة بلا تلميحات ولا تحد التغطية.

IsFontValid / هل_الخط_صالح

(font: Font) -> bool

فحص كلي، مسموح للمعالجات والدوال الراجعة، دون دخول جهاز أصلي.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

UnloadFont / حرر_الخط

(font: Font) -> result<unit>

نص على المعالج، مسموح للمعالجات والدوال الراجعة، دون نافذة.

يغلق النسخ المشتركة بأمان. تحتفظ التخطيطات ببيانات الخط المستقلة ويقبل تحرير الخط الافتراضي دون إغلاقه.

GetFontBaseSize / حجم_الخط_الأساسي

(font: Font) -> result<i32>

نص على المعالج، مسموح للمعالجات والدوال الراجعة، دون نافذة.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

تخطيطات النص الثابتة

CreateTextLayout / أنشئ_تخطيط_نص

(font: Font, text: string, options: TextOptions) -> result<TextLayout>

نص على المعالج، مسموح للمعالجات والدوال الراجعة، دون نافذة.

تخطيط ثابت على المعالج. يجب تحديد كل حقول الخيارات ويحتفظ بالخطوط ويبقى بعد إعادة إنشاء النافذة.

MeasureTextLayout / قس_تخطيط_النص

(layout: TextLayout) -> result<TextMetrics>

نص على المعالج، مسموح للمعالجات والدوال الراجعة، دون نافذة.

حجم هو الصندوق المنطقي وحبر هو حدود المحارف المحلية. القياس والرسم يستخدمان المواضع نفسها.

IsTextLayoutValid / هل_تخطيط_النص_صالح

(layout: TextLayout) -> bool

فحص كلي، مسموح للمعالجات والدوال الراجعة، دون دخول جهاز أصلي.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

UnloadTextLayout / حرر_تخطيط_النص

(layout: TextLayout) -> result<unit>

نص على المعالج، مسموح للمعالجات والدوال الراجعة، دون نافذة.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

قياس النص المشكل

MeasureText / قس_النص

(text: string, fontSize: i32) -> result<i32>

نص على المعالج، مسموح للمعالجات والدوال الراجعة، دون نافذة.

عرض بخط افتراضي مشكل، يقرب لأعلى إلى ص32 مفحوص. الحجم 1..4096.

MeasureTextEx / قس_النص_موسعا

(font: Font, text: string, fontSize: f32, spacing: f32) -> result<Vector2>

نص على المعالج، مسموح للمعالجات والدوال الراجعة، دون نافذة.

حجم منطقي لنص مشكل. التباعد صفر وحجم الخط 0.5..4096.

رسم النص المشكل

DrawText / ارسم_نصا

(text: string, posX: i32, posY: i32, fontSize: i32, color: Color) -> result<unit>

التطبيق والخيط الرئيسي وداخل إطار رسم.

نص عربي ولاتيني مشكل في ترتيب منطقي. فشل التجهيز المعروف لا يرسل أي رسم لهذا الطلب. تباعد Ex وPro يجب أن يكون صفرا.

DrawTextEx / ارسم_نصا_موسعا

(font: Font, text: string, position: Vector2, fontSize: f32, spacing: f32, tint: Color) -> result<unit>

التطبيق والخيط الرئيسي وداخل إطار رسم.

نص عربي ولاتيني مشكل في ترتيب منطقي. فشل التجهيز المعروف لا يرسل أي رسم لهذا الطلب. تباعد Ex وPro يجب أن يكون صفرا.

DrawTextPro / ارسم_نصا_متقدما

(font: Font, text: string, position: Vector2, origin: Vector2, rotation: f32, fontSize: f32, spacing: f32, tint: Color) -> result<unit>

التطبيق والخيط الرئيسي وداخل إطار رسم.

نص عربي ولاتيني مشكل في ترتيب منطقي. فشل التجهيز المعروف لا يرسل أي رسم لهذا الطلب. تباعد Ex وPro يجب أن يكون صفرا.

DrawTextLayout / ارسم_تخطيط_النص

(layout: TextLayout, position: Vector2, tint: Color) -> result<unit>

التطبيق والخيط الرئيسي وداخل إطار رسم.

نص عربي ولاتيني مشكل في ترتيب منطقي. فشل التجهيز المعروف لا يرسل أي رسم لهذا الطلب. تباعد Ex وPro يجب أن يكون صفرا.

DrawTextLayoutPro / ارسم_تخطيط_النص_متقدما

(layout: TextLayout, position: Vector2, origin: Vector2, rotation: f32, tint: Color) -> result<unit>

التطبيق والخيط الرئيسي وداخل إطار رسم.

نص عربي ولاتيني مشكل في ترتيب منطقي. فشل التجهيز المعروف لا يرسل أي رسم لهذا الطلب. تباعد Ex وPro يجب أن يكون صفرا.

جهاز الصوت والأصوات

InitAudioDevice / هيئ_جهاز_الصوت

() -> result<unit>

التطبيق والخيط الرئيسي وخارج إطار الرسم، مع شروط الجهاز والمالك.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

CloseAudioDevice / أغلق_جهاز_الصوت

() -> result<unit>

التطبيق والخيط الرئيسي وخارج إطار الرسم، مع شروط الجهاز والمالك.

يوقف ويغلق نسخ الصوت والموسيقى التابعة قبل تحرير الجهاز.

IsAudioDeviceReady / هل_جهاز_الصوت_جاهز

() -> bool

فحص كلي، مسموح للمعالجات والدوال الراجعة، دون دخول جهاز أصلي.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

SetMasterVolume / اضبط_مستوى_الصوت_العام

(volume: f32) -> result<unit>

التطبيق والخيط الرئيسي وجهاز صوت أو مالك حي، مسموح داخل إطار.

مستوى الصوت 0..1.

GetMasterVolume / مستوى_الصوت_العام

() -> result<f32>

التطبيق والخيط الرئيسي وجهاز صوت أو مالك حي، مسموح داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

LoadSound / حمل_صوتا

(fileName: string) -> result<Sound>

التطبيق والخيط الرئيسي وخارج إطار الرسم، مع شروط الجهاز والمالك.

ملفات WAV وOGG وMP3، بمسار نسبة إلى مجلد العمل. المورد تابع لجيل الصوت الحالي.

IsSoundValid / هل_الصوت_صالح

(sound: Sound) -> bool

فحص كلي، مسموح للمعالجات والدوال الراجعة، دون دخول جهاز أصلي.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

UnloadSound / حرر_الصوت

(sound: Sound) -> result<unit>

التطبيق والخيط الرئيسي. يجوز الإغلاق المنطقي داخل إطار وينجح تحرير المورد المغلق.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

PlaySound / شغل_الصوت

(sound: Sound) -> result<unit>

التطبيق والخيط الرئيسي وجهاز صوت أو مالك حي، مسموح داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

StopSound / أوقف_الصوت

(sound: Sound) -> result<unit>

التطبيق والخيط الرئيسي وجهاز صوت أو مالك حي، مسموح داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

PauseSound / أوقف_الصوت_مؤقتا

(sound: Sound) -> result<unit>

التطبيق والخيط الرئيسي وجهاز صوت أو مالك حي، مسموح داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

ResumeSound / استأنف_الصوت

(sound: Sound) -> result<unit>

التطبيق والخيط الرئيسي وجهاز صوت أو مالك حي، مسموح داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

IsSoundPlaying / هل_الصوت_يعمل

(sound: Sound) -> result<bool>

التطبيق والخيط الرئيسي وجهاز صوت أو مالك حي، مسموح داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

SetSoundVolume / اضبط_مستوى_الصوت

(sound: Sound, volume: f32) -> result<unit>

التطبيق والخيط الرئيسي وجهاز صوت أو مالك حي، مسموح داخل إطار.

مستوى الصوت 0..1.

SetSoundPitch / اضبط_حدة_الصوت

(sound: Sound, pitch: f32) -> result<unit>

التطبيق والخيط الرئيسي وجهاز صوت أو مالك حي، مسموح داخل إطار.

درجة صوت موجبة ومنتهية مع فحص معدل إعادة التعيين الناتج. الرفض قبل الدخول الأصلي يحفظ الدرجة السابقة.

SetSoundPan / اضبط_توازن_الصوت

(sound: Sound, pan: f32) -> result<unit>

التطبيق والخيط الرئيسي وجهاز صوت أو مالك حي، مسموح داخل إطار.

توازن الصوت -1..1.

بث الموسيقى الصريح

LoadMusicStream / حمل_تدفق_موسيقى

(fileName: string) -> result<Music>

التطبيق والخيط الرئيسي وخارج إطار الرسم، مع شروط الجهاز والمالك.

ملفات WAV وOGG وMP3، بمسار نسبة إلى مجلد العمل. المورد تابع لجيل الصوت الحالي.

IsMusicValid / هل_الموسيقى_صالحة

(music: Music) -> bool

فحص كلي، مسموح للمعالجات والدوال الراجعة، دون دخول جهاز أصلي.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

UnloadMusicStream / حرر_تدفق_الموسيقى

(music: Music) -> result<unit>

التطبيق والخيط الرئيسي. يجوز الإغلاق المنطقي داخل إطار وينجح تحرير المورد المغلق.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

PlayMusicStream / شغل_تدفق_الموسيقى

(music: Music) -> result<unit>

التطبيق والخيط الرئيسي وجهاز صوت أو مالك حي، مسموح داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

IsMusicStreamPlaying / هل_تدفق_الموسيقى_يعمل

(music: Music) -> result<bool>

التطبيق والخيط الرئيسي وجهاز صوت أو مالك حي، مسموح داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

UpdateMusicStream / حدث_تدفق_الموسيقى

(music: Music) -> result<unit>

التطبيق والخيط الرئيسي وجهاز صوت أو مالك حي، مسموح داخل إطار.

تحديث صريح من التطبيق، دون حلقة بث تلقائية أو استدعاء دالة مصدر.

StopMusicStream / أوقف_تدفق_الموسيقى

(music: Music) -> result<unit>

التطبيق والخيط الرئيسي وجهاز صوت أو مالك حي، مسموح داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

PauseMusicStream / أوقف_تدفق_الموسيقى_مؤقتا

(music: Music) -> result<unit>

التطبيق والخيط الرئيسي وجهاز صوت أو مالك حي، مسموح داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

ResumeMusicStream / استأنف_تدفق_الموسيقى

(music: Music) -> result<unit>

التطبيق والخيط الرئيسي وجهاز صوت أو مالك حي، مسموح داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

SeekMusicStream / اضبط_موضع_تدفق_الموسيقى

(music: Music, position: f32) -> result<unit>

التطبيق والخيط الرئيسي وجهاز صوت أو مالك حي، مسموح داخل إطار.

ثوان منتهية بين صفر والطول المبلغ عنه شاملا الطرفين. الطرف الأخير نهاية منطقية. التحديث التالي يعيد الموسيقى الجارية المتكررة أو يوقف غير المتكررة والفارغة. رفض المفكك يغلق المالك.

SetMusicVolume / اضبط_مستوى_الموسيقى

(music: Music, volume: f32) -> result<unit>

التطبيق والخيط الرئيسي وجهاز صوت أو مالك حي، مسموح داخل إطار.

مستوى الصوت 0..1.

SetMusicPitch / اضبط_حدة_الموسيقى

(music: Music, pitch: f32) -> result<unit>

التطبيق والخيط الرئيسي وجهاز صوت أو مالك حي، مسموح داخل إطار.

درجة صوت موجبة ومنتهية مع فحص معدل إعادة التعيين الناتج. الرفض قبل الدخول الأصلي يحفظ الدرجة السابقة.

SetMusicPan / اضبط_توازن_الموسيقى

(music: Music, pan: f32) -> result<unit>

التطبيق والخيط الرئيسي وجهاز صوت أو مالك حي، مسموح داخل إطار.

توازن الصوت -1..1.

GetMusicTimeLength / مدة_الموسيقى

(music: Music) -> result<f32>

التطبيق والخيط الرئيسي وجهاز صوت أو مالك حي، مسموح داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

GetMusicTimePlayed / زمن_الموسيقى_المنقضي

(music: Music) -> result<f32>

التطبيق والخيط الرئيسي وجهاز صوت أو مالك حي، مسموح داخل إطار.

تتبع الأحجام المفحوصة وأجيال المالك والنتائج الدليل. الرفض قبل الدخول يحفظ الحالة.

GetMusicLooping / هل_الموسيقى_تتكرر

(music: Music) -> result<bool>

بيانات مالك للقراءة فقط، مسموحة للمعالجات والدوال الراجعة مع فحص إغلاق المالك.

يقرأ بيانات محفوظة دون دخول جهاز الصوت.

SetMusicLooping / اضبط_تكرار_الموسيقى

(music: Music, looping: bool) -> result<unit>

التطبيق والخيط الرئيسي وجهاز صوت أو مالك حي، مسموح داخل إطار.

تحكم صوتي يتطلب سياق التطبيق ومالك صوت حي.

حدود الأعداد والموارد

يجب أن تكون المدخلات العائمة الفعالة منتهية. أبعاد النافذة وتكبير الكاميرا موجبة. نصف القطر وFPS المستهدف غير سالبين، وسماكة الخط موجبة. يجب أن تبقى الإحداثيات والحسابات الناتجة قابلة للتمثيل حتى عندما تكون المدخلات المفردة منتهية. تحتفظ مستطيلات النسيج الموقعة والمقياس الصفري أو السالب والأشكال المنحلة المقبولة بالسلوك المثبت. تستخدم السجلات إحداثيات f32 وقنوات لون u8 وأحجام الأعداد الدقيقة في كل توقيع.

ترفض نصوص العنوان والمسار NUL. يقبل LoadTexture صيغة PNG فقط. تحل المسارات نسبة إلى مجلد عمل العملية. توفر عائلة الصور الأطلس الدقيق بحجم 32 في 16 RGBA وإشعاره Apache-2.0 OR MIT. يحتاج التحميل وتغيير المرشح والالتفاف إلى إطار مغلق. لا تحتاج هذه العائلات العامة إلى Raylib نظامي أو وحدات مصدر مساعدة.

الحدود الافتراضية 256 MiB لذاكرة الآلة الافتراضية وحساب خلفية مشترك واحد قدره 128 MiB لـRaylib وHTTP. تحسب التخصيصات الأصلية ونسخ العناوين وذاكرة المسارات وتخزين النسيج والذاكرة المحتفظ بها ضمن الحد المناسب. لا يحرر الإغلاق المنطقي التكلفة حتى انتهاء الاستخدام الأصلي. تبقى حدود تعليمات الآلة الافتراضية والزمن وإطارات الاستدعاء والخانات سارية.

يمتلك تنفيذ واحد حجز أجهزة العملية. يتبع النسيج جيل نافذته وتتشارك نسخه الإغلاق. يبطل CloseWindow النسخ قبل تدمير السياق ولا تعيد إعادة الفتح إحياءها. ينجح تكرار UnloadTexture حتى داخل الإطار، وقد يحتفظ الرسم المقبول بالذاكرة حتى العرض أو انتهاء الاستخدام. تسبق فحوص إغلاق المالك غياب الجهاز السابق. يسمح ببيانات القراءة فقط والفحوص الكلية والتحويلات النقية ومساعدات التصادم في المعالجات والاستدعاءات الراجعة. الدخول إلى الجهاز والرسم للتطبيق فقط على الخيط الرئيسي.

يجب إقران BeginDrawing وEndDrawing وBeginMode2D وEndMode2D دون تداخل. أنه وضع الكاميرا قبل الإطار. تحتاج دورة الحياة والتحميل وتغييرات العنوان ومفتاح الخروج وFPS والمرشح والالتفاف إلى إطار مغلق. يسمح بملاحظات عينات الإدخال والتوقيت داخله. يحفظ الرفض قبل الدخول الأصلي الحالة الحالية. يضمن الفشل بعد الآثار تنظيف الموارد المملوكة دون تراجع عام. يهجر الرجوع أو المصيدة أو الحد أو الإلغاء الإطار المفتوح، ويحرر التنظيف عمل GPU قبل نافذته. يحتفظ التحرير الأصلي غير المثبت بالذاكرة والحجز. لا يوجد ضمان قطع قسري داخل العملية لتعليق برنامج تشغيل المضيف.

أحجام النص الصحيحة 1..4096 أو f32 المنتهية 0.5..4096، وتقرب إلى 1/64 مع كسر التعادل نحو الزوجي. يجب أن يكون تباعد المحارف في Ex وPro صفرا. تتطلب TextOptions حقولها الستة، والعرض النشط منته وموجب والتباعد الإضافي للأسطر منته وغير سالب. يستخدم Auto أول محرف قوي أو LTR للفقرات المحايدة، ويتبع Start وEnd ذلك الاتجاه. يشترك الصندوق المنطقي وحدود الحبر في مواضع الرسم. تتبع فواصل الفقرات والأسطر والالتفاف والعناقيد الكبيرة دليل التخطيط. تتضمن رسائل النص تفاصيل scalar_index وscalar أو byte_offset الأصلي، وليست حقول نتيجة جديدة.

ينسخ تحميل الخط بايتات الملف المرخص وتلميحات المحارف. Font وTextLayout مالكان على المعالج يبقيان بعد إعادة إنشاء النافذة، وتبقى بيانات التخطيط بعد إغلاق الخط المخصص. ينجح تحرير الخط الافتراضي دون إغلاقه. يتبع Sound وMusic جيل الصوت، ويبطل التحرير أو إغلاق الجهاز النسخ. يسمح بالتحكم في التشغيل والتحديثات الصريحة داخل إطار. مستوى الصوت 0..1 والتوازن -1..1 والحدة موجبة مع فحص معدل إعادة التعيين. يقبل البحث الطرف الأخير المبلغ عنه نهاية منطقية، ويغلق رفض المفكك مالك الموسيقى. يسمح بالفحوص الكلية وبيانات GetMusicLooping المحفوظة في المعالجات، أما ملاحظات التشغيل فللتطبيق فقط.

تشارك تخصيصات الخط والمفكك والمازج والمحارف والمخابئ والبيانات المحتفظ بها حساب الخلفية. يحجز الصوت مكدس عامل مفحوصا قدره 1 MiB وحارسا 64 KiB حتى نجاح الانضمام. لا ترسل إخفاقات تجهيز رسم النص أي جزء من الطلب الفاشل. يحرر التنظيف عمل المازج والمفكك قبل إغلاق الصوت. راجع التنظيف والمقاطعة للموعد الواحد غير المتجدد وتصريف الإشارات.

الأخطاء والرفض

افحص ok قبل value أو error، وافحص error::code وerror::message. تؤدي قراءة الفرع الخطأ إلى مصيدة. تحدد رموز ASCII الثابتة الإخفاقات، وتضم رسائل Raylib الجديدة اللغتين. تستخدم تشخيصات المصدر لغة CLI المختارة ولا تتبع مفردات المصدر.

تفشل الأبعاد غير الصحيحة أو العنوان ذو NUL قبل اكتساب الشاشة. يمكن أن تنتقل محاولة محررة بأمان إلى نقطة شاشة أخرى مضبوطة. لا تؤدي المعاملات غير الصحيحة أو الميزانيات المستنفدة إلى الانتقال بين المضيفين. إذا فشلت كل محاولات الشاشة بأمان تصف فئة المحاولة الأخيرة كل الخلفيات المجربة.

من الأمثلة المهمة إعادة InitWindow(0, 240, "x") للرمز raylib.invalid_argument، وإعادة SetWindowTitle دون نافذة للرمز raylib.invalid_order، وإعادة كاميرا بتكبير صفري للرمز raylib.invalid_argument. تعيد بداية الكاميرا المتداخلة أو EndDrawing مع وضع كاميرا نشط raylib.invalid_order مع حفظ الزوج الحالي. يغلق تحرير نسخة النسيج كل النسخ، ثم تعيد قراءة العرض raylib.closed_resource. تفشل مقارنة التعدادات الاسمية بأعداد أو بناؤها منها أثناء فحص المصدر بالرمز type-mismatch، وتفشل عمليات الجهاز داخل معالجات HTTP في فحص الآثار عبر مسارات الاستدعاء.

يعيد MeasureText("bad\ttext", 32) الرمز raylib.invalid_text مع scalar_index=3 وscalar=U+0009. يعيد تباعد MeasureTextEx غير الصفري وعرض التخطيط النشط الصفري raylib.invalid_argument. تعيد ملفات الخط المخصص المفقودة raylib.load_failed، والبيانات المطلوبة المعطوبة raylib.invalid_font. يغلق UnloadTextLayout كل النسخ ويعيد القياس اللاحق raylib.closed_resource. يعيد تحميل الصوت دون تهيئة raylib.invalid_order. لا يمكن بناء TextDirection وTextAlignment الاسميين من أعداد. راجع برنامج الهوية دون أجهزة وبرنامج النص والصوت.

تبقى الحالات النهائية 5 للمصيدة و6 للحد و7 للإلغاء و8 لفشل المضيف. تحتفظ النتيجة الأساسية السابقة بنسبة التنظيف المنفصلة. اختر تشخيصات CLI عبر --diagnostic-language=en وتشخيصات البرنامج الناتج عبر --aspl-diagnostic-language=en.

يغطي المرجع الحالي عمليات Raylib البالغ عددها 123 و18 نوعا وستة مخططات و161 ثابتا. تحتفظ جلسات HTTP وحالتها وتقدمها الصريح بمرجع HTTP مصدرا لها. يشرح دليل الجمع ترتيب الإطارات والآثار. يحتفظ المرجع الكامل الأصلي (يفتح في نافذة جديدة) بمساره الخام المنشور وبايتاته. لا تمنح قوائم محولات المساهمين وتجهيزاتهم صفة التشغيل العام.