MLX42

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

فهو يوفر أدوات بدائية لرسم الأنسجة على النافذة بالإضافة إلى تعديلها في وقت التشغيل عند عرضها على النافذة.

مهم

في بعض الأحيان قد يبدو أنه لم يتم إجراء أي تحديثات لفترة طويلة. هذا أمر متوقع، ويعتبر المشروع / lib مكتملًا ويتطلب الحد الأدنى من التحديثات. لا تزال إصلاحات الأخطاء مضمونة ولا يزال المشروع قيد الصيانة النشطة.

سمات

يأتي MLX42 مع مجموعة كبيرة من الميزات التي تجعل استخدامه في الواقع متعة وليس عملاً روتينيًا.

عبر منصة

قم بتشغيله على نظام التشغيل WindowsXP الخاص بجدتك، أو على نظام دبيان الخاص بعمك، أو على نظام التشغيل MacOS الخاص بعشاق الموضة! بغض النظر عن النظام الأساسي، إذا كان بإمكان MLX42 البناء عليه، فسيتم تشغيله على نظام النوافذ الأصلي الخاص به.

يتيح لك هذا العمل على مشروعك بغض النظر عن الجهاز الذي يعمل عليه.

موثقة

يهتم MLX42 بالتوثيق الجيد، حيث يتم توثيق كل وظيفة واستخدام وحتى بعض الأعمال الداخلية! لا مزيد من التخمين والبحث عن كيفية عمل شيء ما أو من المفترض أن يعمل.

أداء

إنه مبني على OpenGL ويستخدم العرض المجمع لتسريع عملية العرض مقارنة بالمكتبات الأخرى.

مفتوح المصدر && مدفوع بالمجتمع

تتم صيانة هذا المشروع بشكل نشط بواسطة Codam بالإضافة إلى طلاب من شبكة 42. يمنح هذا الطلاب فرصة مباشرة لمعرفة المزيد عن المكتبة نفسها بالإضافة إلى إصلاح أي أخطاء محتملة بدلاً من مجرد قبولها.

التوافق مع إمسكريتن

يقدم MLX42 التوافق مع Emscripten، مما يسمح بتشغيل MLX42 في متصفحات الويب من خلال WebAssembly. أصبح هذا التعديل ممكنًا بفضل @PepeLevi، الفضل له في شوكته ومساهماته.

أبرز

• دعم Emscripten : قم بتجميع MLX42 مع Emscripten، مما يتيح تشغيل التطبيقات الرسومية في بيئة الويب.
• توافق WebAssembly : يضمن إمكانية استخدام MLX42 في متصفحات الويب الحديثة، مما يزيد من إمكانية استخدامه خارج بيئات سطح المكتب التقليدية.
• الوثائق المحدثة : تم تقديم إرشادات حول كيفية إنشاء مشاريع MLX42 وتشغيلها باستخدام Emscripten.

---

تثبيت

التجميع العام

عموما بناء هذا المشروع هو كما يلي لجميع الأنظمة. طالما أن CMake يمكن أن يفهم ذلك.

1. قم بتنزيل وبناء MLX42

في حالة عدم تثبيت برنامج glfw على نظامك، سيقوم cmake باكتشاف ذلك وتنزيله لك. يمكنك بعد ذلك تشغيل sudo make install في دليل _deps الخاص بـ glfw. إذا كنت تستخدم جهاز كمبيوتر (MacOS وLinux)، فاطلب من مسؤول النظام المفضل لديك تثبيته. الأمر نفسه ينطبق على CMake أو أي تبعيات أخرى قد تحتاجها لنظامك.

ومع ذلك، إذا لم تتمكن من القيام بأي من CMake، فسيظل بإمكانك جلب GLFW وإنشائه. يمكنك بعد ذلك ربطه بشكل ثابت من المجلد _deps .

ملحوظة

بالنسبة إلى Codam، تم تثبيت GLFW بالفعل على أجهزة Mac.

ملحوظة

أثناء مرحلة الربط، يمكن أن تكون العلامة لربط GLFW إما: -lglfw3 أو -lglfw حسب نظامك.

1. قم بتجميع برنامجك مع المكتبة:

   • ل: ماك
   • ل: لينكس
   • ل: ويندوز

2. ربح!

التثبيت على النظام

لإنشاء المكتبة بالكامل وتثبيتها على نظامك، قم بتشغيل الأمر التالي:

cmake -B build && cmake --build build --parallel --config (Debug | Release | RelWithDebInfo | MinSizeRel) --target install

افتراضيًا، سيقوم Windows بوضع lib المثبت في: C:Program Files (x86)mlx42 وبالنسبة لنظام التشغيل MacOS / Linux، سيتم وضعه في /usr/local/lib و /usr/local/include على التوالي.

اختبارات الوحدة

يأتي MLX42 مع بعض اختبارات الوحدات للتأكد من سلامة المكتبة، ولبنائها قم بتشغيل الأمر التالي:

cmake -DBUILD_TESTS=ON -B build && cmake --build build --parallel

ثم قم بتشغيلها ببساطة باستخدام:

ctest --output-on-failure --test-dir build

---

التنزيل والإنشاء - MLX42

git clone https://github.com/codam-coding-college/MLX42.git
cd MLX42
cmake -B build # build here refers to the outputfolder.
cmake --build build -j4 # or do make -C build -j4

يسمى ملف مكتبة الإخراج libmlx42.a وهو موجود في مجلد build الذي حددته.

الخيارات المتاحة

يمكنك تمرير خيارات البناء إلى cmake، على سبيل المثال: cmake -DDEBUG=1 -DGLFW_FETCH=0... . ستتيح لك هذه على سبيل المثال إنشاءه في وضع DEBUG أو تغيير أي نوع من السلوك في وقت الإنشاء.

يمكنك العثور على مثال لملف makefile في الوثائق هنا.

---

لنظام التشغيل MacOS:

تثبيت التبعيات

إذا كان نظامك لا يحتوي على GLFW أو CM، فمن المستحسن بشدة استخدام Brew لتثبيت تلك التبعيات المفقودة.

بالنسبة لـ 42 حرمًا جامعيًا، يمكنك استخدام: 42Homebrew

خلاف ذلك مع البيرة المنزلية:

brew install glfw
brew install cmake

إذا كنت تستخدم Apple Silicon (شريحة M1 أو أحدث)، فلاحظ أن مسار تثبيت Homebrew مختلف. قد ترغب في تحديث ملف تكوين Shell الخاص بك. لمستخدمي Zsh (الواجهة الافتراضية في إصدارات macOS الأحدث):

nano ~ /.zshrc
export LIBRARY_PATH=/opt/homebrew/lib

أعد تشغيل جلسة Shell الخاصة بك أو أعد تشغيل جهازك حتى تدخل التغييرات حيز التنفيذ.

بالنسبة لنظام التشغيل MacOS، يتعين عليك استخدام العلامات التالية لتجميع برنامجك مع المكتبة من أجل ربط البرنامج بأطر العمل الصحيحة:

-framework Cocoa -framework OpenGL -framework IOKit

عادةً، إذا قمت ببساطة بتثبيت/إنشاء glfw من المصدر أو قمت بالفعل بتثبيته، فيجب أن يكون التجميع:

gcc main.c ... libmlx42.a -Iinclude -lglfw

عبر البيرة المنزلية / 42 البيرة المنزلية

 # Homebrew
gcc main.c ... libmlx42.a -Iinclude -lglfw -L " /opt/homebrew/Cellar/glfw/3.3.8/lib/ "

# 42Homebrew
gcc main.c ... libmlx42.a -Iinclude -lglfw -L " /Users/ $( USER ) /.brew/opt/glfw/lib/ " 

أمان نظام التشغيل MacOS:

عند تشغيل برنامجك على نظام MacOS، قد يشكو، لأنه مع أجهزة Mac يجب عليك التفكير بشكل مختلف. في حالة ظهور أي تحذيرات أمنية أو إخبارك لنظام التشغيل MacOS بأنه لا يمكنه التحقق من المؤلف/المطور، انتقل إلى Settings > Security & Privacy .

ستكون هناك نافذة منبثقة في الأسفل تخبرك بمحاولة تطبيق ما للتشغيل، انقر فوق الخيار للسماح بتشغيله.

---

لنظام التشغيل Linux:

1. تثبيت الحزم اللازمة:

بالنسبة لنظام Debian مثل (Ubuntu، Mint، Pop OS...):

sudo apt update
sudo apt install build-essential libx11-dev libglfw3-dev libglfw3 xorg-dev

بالنسبة إلى Arch-linux (Manjaro وEndeavour وGaruda):

sudo pacman -S glfw-x11

أو (إذا كنت تستخدم مؤلف sway/wlroots أو مؤلف Wayland آخر)

sudo pacman -S glfw-wayland

2. قم بتنزيل وبناء MLX42

3. قم بتجميع برنامجك مع المكتبة:

gcc main.c ... libmlx42.a -Iinclude -ldl -lglfw -pthread -lm

4. ربح!

---

لنظام التشغيل Windows (مع نظام Windows الفرعي لنظام التشغيل Linux 2 (WSL2))

مهم

قبل البدء بكل هذه الخطوات، اقرأ هذا

1. قم بتعيين هذه المتغيرات في .zshrc أو .bashrc :

 export DISPLAY= $( ip route list default | awk ' {print $3} ' ) :0
export LIBGL_ALWAYS_INDIRECT=0

(إذا فشل أمر تصدير DISPLAY، راجع منشور StackOverflow هذا للحصول على البدائل)

2. قم بتنزيل وتثبيت تطبيق XServer بتكوين موسع (XMing غير مؤهل) يعمل VcXsrv: https://sourceforge.net/projects/vcxsrv/

3. افتح جدار حماية Windows Defender، واتبع الخطوات التالية:

• انتقل إلى "السماح لتطبيق أو ميزة من خلال جدار حماية Windows Defender"
• تغيير الإعدادات
• ابحث عن XServer المثبت، لـ VcXsrv وهو "VcXsrv windows server"
• تمكين الاتصال عبر الشبكة الخاصة والعامة اختياريًا، قد تتمكن من توفير هذه الإعدادات عند التشغيل الأول لتطبيق XServer، وقد لا تظهر حتى في القائمة حتى أول مرة تقوم فيها بتشغيل التطبيق.

4. ابدأ تشغيل تطبيق XLaunch (لـ VcXsrv) وقم بتوفير إعدادات التكوين التالية:

• اترك رقم العرض على تلقائي
• لا تبدأ أي عميل
• قم بإلغاء تحديد خيار Native opengl
• حدد Disable access control
• الانتهاء من بدء تشغيل الخادم

5. من المحتمل أن يتم تطبيق جميع الخطوات الأخرى لنظام التشغيل Linux، فقط قم بالاستنساخ والبناء والتشغيل.

---

لنظام التشغيل Windows الأصلي:

مهم

انتبه إلى أن Visual Studio (2022) مطلوب لهذا الغرض. قد يكون التطوير على Windows محبطًا إلى حد ما.

نوصي بشدة باستخدام WSL2 لجعل هذا الأمر غير مؤلم قدر الإمكان. ومع ذلك، إذا كنت تصر على إنشاء Windows محليًا، فكل ما تحتاجه فيما يتعلق بالتبعيات هو:

• CMake
• جلفو

بمجرد الانتهاء من تثبيت جميع التبعيات بشكل صحيح، سيقوم CMake بإنشاء ملفات مشروع الاستوديو المرئي. ما عليك سوى إنشائه وبمجرد حصولك على ملف .lib ، انقله إلى مشروعك الفعلي وقم بتثبيته كما تفعل مع أي مكتبة أخرى.

فقط في حالة وجود مقطع فيديو يوضح لك كيف يمكن القيام بذلك. ويغطي هذا الفيديو أيضًا كيفية ربط glfw .

بالطبع الأمر متروك لك للتأكد من أن الكود الذي تكتبه قابل للنقل. الأشياء الموجودة على Unix لا توجد بالضرورة على Win32 .

مثال

 // -----------------------------------------------------------------------------
// Codam Coding College, Amsterdam @ 2022-2023 by W2Wizard.
// See README in the root project for more information.
// -----------------------------------------------------------------------------

#include 
#include 
#include 
#include 

#define WIDTH 512
#define HEIGHT 512

static mlx_image_t * image ;

// -----------------------------------------------------------------------------

int32_t ft_pixel ( int32_t r , int32_t g , int32_t b , int32_t a )
{
    return ( r << 24 | g << 16 | b << 8 | a );
}

void ft_randomize ( void * param )
{
	( void ) param ;
	for ( uint32_t i = 0 ; i < image -> width ; ++ i )
	{
		for ( uint32_t y = 0 ; y < image -> height ; ++ y )
		{
			uint32_t color = ft_pixel (
				rand () % 0xFF , // R
				rand () % 0xFF , // G
				rand () % 0xFF , // B
				rand () % 0xFF  // A
			);
			mlx_put_pixel ( image , i , y , color );
		}
	}
}

void ft_hook ( void * param )
{
	mlx_t * mlx = param ;

	if ( mlx_is_key_down ( mlx , MLX_KEY_ESCAPE ))
		mlx_close_window ( mlx );
	if ( mlx_is_key_down ( mlx , MLX_KEY_UP ))
		image -> instances [ 0 ]. y -= 5 ;
	if ( mlx_is_key_down ( mlx , MLX_KEY_DOWN ))
		image -> instances [ 0 ]. y += 5 ;
	if ( mlx_is_key_down ( mlx , MLX_KEY_LEFT ))
		image -> instances [ 0 ]. x -= 5 ;
	if ( mlx_is_key_down ( mlx , MLX_KEY_RIGHT ))
		image -> instances [ 0 ]. x += 5 ;
}

// -----------------------------------------------------------------------------

int32_t main ( void )
{
	mlx_t * mlx ;

	// Gotta error check this stuff
	if (!( mlx = mlx_init ( WIDTH , HEIGHT , "MLX42" , true)))
	{
		puts ( mlx_strerror ( mlx_errno ));
		return ( EXIT_FAILURE );
	}
	if (!( image = mlx_new_image ( mlx , 128 , 128 )))
	{
		mlx_close_window ( mlx );
		puts ( mlx_strerror ( mlx_errno ));
		return ( EXIT_FAILURE );
	}
	if ( mlx_image_to_window ( mlx , image , 0 , 0 ) == -1 )
	{
		mlx_close_window ( mlx );
		puts ( mlx_strerror ( mlx_errno ));
		return ( EXIT_FAILURE );
	}
	
	mlx_loop_hook ( mlx , ft_randomize , mlx );
	mlx_loop_hook ( mlx , ft_hook , mlx );

	mlx_loop ( mlx );
	mlx_terminate ( mlx );
	return ( EXIT_SUCCESS );
}