الصفحة الرئيسية>المتعلقة بالبرمجة>كود مصدر دلفي
تنزيل

Ooogles - برنامج OpenGL-ES 2.0 الموجه للكائنات

Ooogles عبارة عن غلاف دلفي رفيع للغاية موجه للكائنات حول OpenGL-ES 2.0 مع تأثير قريب من الصفر على الأداء. يمكن استخدامه أيضًا لإنشاء تطبيقات OpenGL لمنصات سطح المكتب باستخدام مجموعة OpenGL-ES الفرعية من OpenGL.

لا يزال هذا المجمع منخفض المستوى جدًا. إنه ليس "محرك عرض" أو إطار عمل عالي المستوى، لذلك لا تزال بحاجة إلى معرفة OpenGL.

تتمثل الأهداف الرئيسية لـ Ooogles في جعل استخدام OpenGL-ES أسهل وأقل عرضة للأخطاء، وتقديم تقارير عن الأخطاء في تصميمات DEBUG وتجربة Code Insight أفضل في Delphi IDE.

سمات

تتمتع Ooogles بالميزات التالية:

  • يقوم بتغليف "كائنات" OpenGL في سجلات + طرق دلفي للحصول على واجهة OpenGL منظمة بشكل أفضل وأسهل في الاستخدام.
  • يوفر وصولاً آمنًا للنوع إلى معظم بنيات OpenGL. على سبيل المثال:
    • في OpenGL، كل "كائن" هو مجرد عدد صحيح (أو مقبض)، ولا شيء يمنعك من استدعاء واجهة برمجة تطبيقات نسيج على كائن تظليل. يقوم هذا المجمّع بتغليف واجهة برمجة التطبيقات (API) في فئات (في الواقع تسجل) مثل TGLTexture و TGLShader ، مما يمنع هذه الأنواع من الأخطاء.
    • مصدر كبير آخر لأخطاء OpenGL الشائعة هو استخدام قيم التعداد غير الصحيحة، مما يؤدي إلى أخطاء GL_INVALID_ENUM . يستخدم هذا المجمّع تعدادات دلفي الحقيقية بدلاً من ذلك، مما يمنع معظم هذه الأخطاء.
  • الغلاف رقيق جدًا. لا يتم تضمين مقابض OpenGL في فئات دلفي أو واجهات الكائنات، ولكن في السجلات بدلاً من ذلك. يتم تضمين معظم الطرق وتغليف واجهة برمجة تطبيقات OpenGL واحدة فقط. لذا فإن الحمل العام للغلاف يكون في الغالب صفرًا.
  • تقوم بعض الطرق بإجراء مكالمات OpenGL متعددة للراحة. على سبيل المثال، عند تجميع تظليل، لا يقوم الغلاف باستدعاء واجهة برمجة تطبيقات الترجمة فحسب، بل يتحقق أيضًا من أخطاء الترجمة. في وضع DEBUG ، سيكشف عن هذه الأخطاء من خلال الاستثناءات، وسيقوم أيضًا بتسجيل أي تحذيرات إلى وحدة تحكم التصحيح.
  • يتم تغليف واجهات برمجة تطبيقات OpenGL غير المرتبطة بـ "كائن" OpenGL في فئة gl الثابتة (التي تعمل بشكل أشبه بمساحة الاسم). على سبيل المثال، يتم تغليف واجهة برمجة التطبيقات OpenGL API glClear بالطريقة gl.Clear .
  • يوفر الغلاف بعض الميزات لجعل بنيات OpenGL-ES المحددة متوافقة مع OpenGL (سطح المكتب). على سبيل المثال، يتطلب OpenGL-ES استخدام مؤهلات الدقة في تظليل الأجزاء، ولكن لا يدعمها OpenGL. سيقوم هذا المجمع بتعديل مصدر التظليل بحيث يعمل مع OpenGL أيضًا.
  • يعرض المجمع فقط الطرق المتوافقة مع OpenGL-ES، لذلك لا يمكنك عن طريق الخطأ استخدام واجهات برمجة التطبيقات التي تعمل فقط مع OpenGL، ولكن ليس مع OpenGL-ES. ومع ذلك، يمكنك دائمًا الوصول إلى مقبض OpenGL الأساسي، وبالتالي يمكنك استخدامه مباشرة مع OpenGL API إذا كنت ترغب في ذلك.
  • يتعامل المجمع مع أسماء واجهات برمجة التطبيقات (API) التي تختلف أحيانًا قليلاً على منصات مختلفة.
  • عند التحويل البرمجي باستخدام تعريف DEBUG الشرطي، وتمكين التأكيدات (التكوين الافتراضي لإصدارات Debug)، يتم فحص كل استدعاء OpenGL بحثًا عن الأخطاء، ويتم ظهور استثناء عند حدوث خطأ، مما يشير إلى نوع الخطأ والطريقة التي حدث بها. عندما لا يتم تعريف DEBUG ، أو يتم تعطيل التأكيدات، تتم إزالة كافة تعليمات التحقق من الأخطاء من الإصدار بحيث لا يكون لها أي تأثير على الأداء.
  • أيضًا، عند التجميع في وضع DEBUG مع تمكين التأكيدات، سيتم تسجيل التحذيرات إلى وحدة التحكم في التصحيح إذا نسيت ربط كائن قبل استخدامه (أو عندما يكون كائن مختلف عن الكائن الذي تستخدمه مرتبطًا حاليًا).
  • الغلاف موثق جيدًا. يحتوي كل سجل وطريقة على وثائق من مرجع OpenGL-ES 2.0 الرسمي، بالإضافة إلى وثائق مخصصة عند الحاجة. تعرض الوثائق أيضًا استدعاءات (استدعاءات) واجهة برمجة تطبيقات OpenGL الأصلية المستخدمة في التنفيذ، لتسهيل العثور على طريقة ما إذا كنت تعرف بالفعل ما يعادل واجهة برمجة التطبيقات (API).
  • يأتي مع عينات مختلفة توضح كيفية استخدام هذا المجمع. تعمل هذه العينات على أنظمة التشغيل Windows وmacOS وiOS وAndroid. ومع ذلك، فإنهم لا يستخدمون إطار عمل FireMonkey، ولكن إطار عمل مخصص خفيف الوزن (ومحدود) يمكنك العثور عليه في الدليل ExamplesCommon .

غير الميزات

لا يوفر المجمع ميزات ذات مستوى أعلى مثل إدارة موارد OpenGL التلقائية. تحتاج إلى تحرير موارد OpenGL بنفسك عندما لا تعود بحاجة إليها. عادةً ما يتم إنشاء الموارد باستخدام طريقة تسمى New ويتم إصدارها باستخدام طريقة تسمى Delete . على سبيل المثال: 

 var
  Texture: TGLTexture;
begin
  Texture.New;
  // Do something with texture
  Texture.Delete;
end ;

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

كما أن المجمّع يدعم الإصدار 2.0 من OpenGL-ES فقط. وهو لا يدعم الإصدار 1 "القديم" من خط أنابيب عرض الوظيفة الثابتة. يمكنني إضافة دعم للإصدار 3.0 وما فوق بمجرد أن يتم تقديمه بواسطة دلفي ليصبح أكثر انتشارًا.

التبعيات

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

ابدء

للبدء:

  • تأكد من أن دليل FastMath في نفس مستوى دليل Ooogles.
  • عادةً ما تريد إضافة التعريف الشرطي FM_COLUMN_MAJOR إلى مشروعك (لجميع التكوينات - جميع الأنظمة الأساسية). يتيح ذلك تخزين المصفوفات في الأعمدة الرئيسية، وهو أمر أكثر منطقية لتطبيقات OpenGL.
  • بعد إنشاء سياق OpenGL وتنشيطه، اتصل بـ InitOoogles . يعد هذا ضروريًا لمحاكاة OpenGL-ES على منصات OpenGL. إذا كان تطبيقك يستخدم سياقات متعددة، فيجب عليك استدعاء InitOoogles مرة واحدة لكل سياق (بعد جعله حاليًا). قم بإلقاء نظرة على الوحدات Sample.Platform.* للحصول على أمثلة حول متى يتم استدعاء هذا.
  • عند استخدام Ooogles في وحدتك، قد تحصل على تلميحات للمترجم تقول شيئًا مثل "لم يتم توسيع الوظيفة المضمنة H2443 X لأن الوحدة Y لم يتم تحديدها في قائمة الاستخدامات" . وذلك لأن Ooogles يقوم بتضمين معظم الوظائف وأن دلفي تتطلب منك استخدام وحدات OpenGL لتضمينها للعمل. ولسوء الحظ، تختلف أسماء هذه الوحدات حسب النظام الأساسي (على سبيل المثال Winapi.OpenGL و iOSapi.OpenGLES وما إلى ذلك). لتسهيل استخدام وحدات OpenGL الصحيحة، يكون من الأسهل إذا قمت بتضمين ملف "OpenGL.inc" في عبارات الاستخدام الخاصة بك بدلاً من ذلك، كما في: 
 uses
  { $INCLUDE 'OpenGL.inc' }
  Neslib.Ooogles;

فقط تأكد من "استخدام" وحدة أخرى واحدة على الأقل بعد ملف التضمين.

الفئات الرئيسية والتوثيق

فيما يلي قائمة بالفئات الرئيسية (في الواقع السجلات) المستخدمة في Ooogles، بالإضافة إلى روابط لوثائقها:

  • gl: فئة ثابتة (أو مساحة اسم) لواجهات برمجة تطبيقات OpenGL غير المرتبطة بكائن معين.
  • TGLShader: تظليل قمة أو جزء.
  • TGLProgram: برنامج يجمع بين تظليل قمة الرأس وتظليل جزء.
  • TGLVertexAttrib: يمثل سمة قمة واحدة في TGLProgram. هذه هي المتغيرات المميزة attribute في تظليل قمة الرأس.
  • TGLuniform: يمثل الزي الرسمي في برنامج TGLProgram. هذه هي المتغيرات المميزة بالزي uniform في تظليل الرأس أو الجزء.
  • TGLBuffer: مخزن مؤقت لصفيف (قمة الرأس) أو مخزن مؤقت لصفيف العناصر (فهرس).
  • TGLTexture: نسيج ثنائي الأبعاد أو نسيج cubemap.
  • TGLFramebuffer: مخزن مؤقت للإطارات.
  • TGLRenderbuffer: مستودع مؤقت للعرض. يعمل كمخزن لـ TGLFramebuffer.

التعيين من OpenGL إلى Ooogles

إذا كنت تتقن OpenGL، فقد تجد الجدول التالي مفيدًا للترجمة من OpenGL API إلى أسلوب Ooogles. يجب أن يكون كل شيء واضحًا ومباشرًا.

برنامج OpenGL أووغلز
glActiveTexture TGLTexture.BindToTextureUnit
glAttachShader TGLProgram.AttachShader
glBindAttribLocation TGLvertexAttrib.Bind
glBindBuffer TGLBuffer.Bind
glBindFramebuffer TGLframebuffer.Bind
glBindTexture TGLTexture.Bind
glBlendColor gl.BlendColor
glBlendEquation gl.BlendEquation
glBlendEquationSeparate gl.BlendEquationSeparate
glBlendFunc gl.BlendFunc
glBlendFuncSeparate gl.BlendFuncSeparate
glBufferData TGLBuffer.Data
glBufferSubData TGLBuffer.SubData
glCheckFramebufferStatus TGLframebuffer.Status
glClear GL.Clear
glClearColor gl.ClearColor
glClearDepthf gl.ClearDepth
glClearStencil gl.ClearStencil
glColorMask gl.ColorMask
glCompileShader TGLShader.Compile
glCompressedTexImage2D TGLTexture.UploadCompressed
glCompressedTexSubImage2D TGLTexture.SubUploadCompressed
glCopyTexImage2D TGLTexture.نسخ
glCopyTexSubImage2D TGLTexture.SubCopy
glCreateProgram TGLProgram.New
glCreateShader TGLShader.New
com.glCullFace gl.CullFace
glDeleteBuffers TGLBuffer.Delete
glDeleteFramebuffers TGLframebuffer.Delete
glDeleteProgram TGLProgram.Delete
glDeleteRenderbuffers TGLRenderbuffer.Delete
glDeleteShader TGLShader.Delete
glDeleteTextures TGLTexture.Delete
glDepthFunc gl.DepthFunc
com.glDepthMask gl.DepthMask
glDepthRangef gl.DepthRange
glDetachShader TGLProgram.DetachShader
glDisable gl.Disable
glDisableVertexAttribArray TGLvertexAttrib.Disable
glDrawArrays gl.DrawArrays
glDrawElements gl.DrawElements
glEnable gl.Enable
glEnableVertexAttribArray TGLvertexAttrib.Enable
glFinish gl.Finish
com.glFlush gl.Flush
glFramebufferRenderbuffer TGLFramebuffer.AttachRenderbuffer
glFramebufferTexture2D TGLframebuffer.AttachTexture
glFrontFace gl.FrontFace
glGenBuffers TGLBuffer.New
glGenFramebuffers TGLframebuffer.New
glGenRenderbuffers TGLRenderbuffer.New
glGenTextures TGLTexture.New
glGenerateMipmap TGLTexture.GenerateMipmap
glGetBooleanv طرق Get* المختلفة
glGetFloatv طرق Get* المختلفة
glGetIntegerv طرق Get* المختلفة
glGetActiveAttrib TGLProgram.GetAttributeInfo
glGetActiveUniform TGLProgram.GetUniformInfo
glGetAttachedShaders TGLProgram.GetAttachedShaders
glGetAttribLocation TGLvertexAttrib.Init
glGetBufferParameteriv TGLBuffer.Get*
glGetError gl.GetError
glGetFramebufferAttachmentParameteriv TGLframebuffer.Get*
glGetProgramInfoLog TGLProgram (في وضع التصحيح)
glGetProgramiv TGLProgram.Get*
glGetRenderbufferParameteriv TGLRenderbuffer.Get*
glGetShaderInfoLog TGLShader (في وضع التصحيح)
glGetShaderSource TGLShader.GetSource
glGetShaderiv TGLShader.Get*
glGetString الحصول على*
جلجيتكسباراميتر* TGLTexture.Get*
com.glGetUniform TGLuniform.GetValue
glGetUniformLocation TGLuniform.Init
جلجيتفيرتيكساتريب* تي جي إلفيرتيكس أتريب.جيت*
glGetVertexAttribPointerv TGLvertexAttrib.GetOffset/GetData
glHint TGLTexture.MipmapHint
glisBuffer ليست هناك حاجة
glIsEnabled gl.IsEnabled
glisFramebuffer ليست هناك حاجة
glisProgram ليست هناك حاجة
glisRenderbuffer ليست هناك حاجة
com.glIsShader ليست هناك حاجة
glisTexture ليست هناك حاجة
glLineWidth gl.LineWidth
glLinkProgram TGLProgram.Link
glPixelStorei gl.PixelStore
glPolygonOffset gl.PolygonOffset
glReadPixels TGLframebuffer.ReadPixels
glReleaseShaderCompiler TGLShader.ReleaseCompiler
glRenderbufferStorage TGLRenderbuffer.Storage
glSampleCoverage gl.SampleCoverage
glScissor gl.Scissor
glShaderSource TGLShader.SetSource
glStencilFunc gl.StencilFunc
glStencilFuncSeparate gl.StencilFuncSeparate
glStencilMask gl.StencilMask
glStencilMaskSeparate gl.StencilMaskSeparate
glStencilOp gl.StencilOp
glStencilOpSeparate gl.StencilOpSeparate
glTexImage2D TGLTexture.Upload
glTexParameter TGLTexture.MinFilter/MagFilter/WrapS/WrapT
glTexSubImage2D TGLTexture.SubUpload
جلونيفورم* TGLUniform.SetValue/SetValues
glUseProgram TGLProgram.Use
glValidateProgram TGLProgram.Validate
جلفيرتيكس أتريب* TGLvertexAttrib.SetValue
glVertexAttribPointer TGLvertexAttrib.SetConfig/SetData
com.glViewport gl.Viewport
يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل