Glloader/ru - Revision history

Gongminmin at 16:10, 30 April 2012

2012-04-30T16:10:34Z

Gongminmin at 01:17, 21 August 2011

2011-08-21T01:17:56Z

Cin2000: Ru page complete

2011-07-06T11:00:59Z

Ru page complete

Cin2000: Uncomplete Ru

2011-07-05T16:59:41Z

Uncomplete Ru

New page

[[glloader]], под-проект [[KlayGE|Klay Game Engine]], это библиотека загрузки расширений OpenGL. Этот проект был запущен в 2004 году(см. '[[glloader's History]]'). Он поддерживает OpenGL от 1.0 до 4.1, OpenGL ES от 1.0 до 2.0, также хорошо как WGL, GLX, и другие расширения GL. Имеется автоматическая генерация кода. Если вам нужна поддержка новых расширений, то всё что вам нужно, это написать сценарий на XMLязыке.

----

The [[glloader]]'s primary feature is that it offers a initializing path of an extension. So if an extension has promoted into the core, the loader will try to load it from the core before try the extension one.

After setting include and lib directories, all you need to do is add '''#include <glloader/glloader.h>''' into your code.

== Заметки ==
Please don't put [[glloader]] into a folder with non-english name. Or else it's possible that autogen.py can't run normally.

== Интерфейс ==

int glloader_is_supported(const char* name);

Find out if a particular feature is available on your platform. The parameter '''name''' is the name string. Returns non-zero means it's supported, or it'll return zero.

'''Note''': You can use name string "GL_VERSION_x_y" to determine if the x.y core version of OpenGL is supported.

void* glloader_get_gl_proc_address(const char* name);

Load a OpenGL function. The parameter '''name''' is the function's name. The return value is the address of the extension function.

'''Note''': When the function fails, there is '''NOT''' guarantee that the return value is NULL.

int glloader_num_features();

Get the number of supported features, including the core and the extensions.

const char* glloader_get_feature_name(int index);

Get the name of a feature. The parameter '''index''''s range is [0, glloader_num_features() - 1].

== Automatic Code Generator ==

Because writing the loading code is very boring, I developed a automatic code generator to help writting the code. There are many xml files in the "./xml" directory. Each xml contains the typedefs, tokens, functions, and initializing path of an extension. Users can write their own xml scripts, the run "autogen.py". And it'll generate the loading code in src and include directories.

== Dependency ==
Python 2.6 and up is required to run "autogen.py".

[[en:Glloader/en]]
[[zh:Glloader]]

@@ Line 42: / Line 42: @@
 == Зависимость ==
 Python 2.6 и и выше нужен для запуска "autogen.py".
 [[en:Glloader/en]]
 [[zh:Glloader]]

← Older revision		Revision as of 01:17, 21 August 2011
Line 1:		Line 1:
−	[[glloader]], под-проект [[KlayGE\|Klay Game Engine]], это библиотека загрузки расширений OpenGL. Этот проект был запущен в 2004 году(см. '[[glloader's History]]'). Он поддерживает OpenGL от 1.0 до 4.1, OpenGL ES от 1.0 до 2.0, также хорошо как WGL, GLX, и другие расширения GL. Имеется автоматическая генерация кода. Если вам нужна поддержка новых расширений, то всё что вам нужно, это написать сценарий на XMLязыке.	+	[[glloader]], под-проект [[KlayGE\|Klay Game Engine]], это библиотека загрузки расширений OpenGL. Этот проект был запущен в 2004 году(см. '[[glloader's History]]'). Он поддерживает OpenGL от 1.0 до 4.2, OpenGL ES от 1.0 до 2.0, также хорошо как WGL, GLX, и другие расширения GL. Имеется автоматическая генерация кода. Если вам нужна поддержка новых расширений, то всё что вам нужно, это написать сценарий на XMLязыке.

	----		----

@@ Line 3: / Line 3: @@
 ----
-The [[glloader]]'s primary feature is that it offers a initializing path of an extension. So if an extension has promoted into the core, the loader will try to load it from the core before try the extension one.
+Основной особенностью [[glloader]] является то, что он предоставляет возможность инициализации расширения. Если расширение предоставлено ядром, то загрузчик попытается загрузить расширение из ядра прежде чем оно будет использовано.
-After setting include and lib directories, all you need to do is add '''#include <glloader/glloader.h>''' into your code.
+После установки путе к каталогам include и lib, всё что вам нужно сделать, это добавить строку'''#include <glloader/glloader.h>''' в ваш код.
 == Заметки ==
-Please don't put [[glloader]] into a folder with non-english name. Or else it's possible that autogen.py can't run normally.
+Пожалуйста, не помещайте [[glloader]] в каталог с не-английскими названиями. Иначе скрипт autogen.py не сможет запуститься нормально.
 == Интерфейс ==
+<pre>
   int glloader_is_supported(const char* name);
-Find out if a particular feature is available on your platform. The parameter '''name''' is the name string. Returns non-zero means it's supported, or it'll return zero.
+'''Обратите внимание''': Вы можете использовать строку вида "GL_VERSION_x_y" для определения поддерживаетмой версии x.y ядра OpenGL.
-−
-'''Note''': You can use name string "GL_VERSION_x_y" to determine if the x.y core version of OpenGL is supported.
-−
   void* glloader_get_gl_proc_address(const char* name);
-Load a OpenGL function. The parameter '''name''' is the function's name. The return value is the address of the extension function.
+'''Обратите внимание''': Когда функция завершается неудачно, то '''НЕТ''' гарантии что возвращенное значение будет NULL.
-−
-'''Note''': When the function fails, there is '''NOT''' guarantee that the return value is NULL.
-−
   int glloader_num_features();
-Get the number of supported features, including the core and the extensions.
+<pre>
-−
-−
   const char* glloader_get_feature_name(int index);
+</pre>
-Get the name of a feature. The parameter '''index''''s range is [0, glloader_num_features() - 1].
+Возвращает имя возможности. Параметр '''index'''' в диапазоне [0, glloader_num_features() - 1].
-== Automatic Code Generator ==
+== Автоматический генератор кода ==
-Because writing the loading code is very boring, I developed a automatic code generator to help writting the code. There are many xml files in the "./xml" directory. Each xml contains the typedefs, tokens, functions, and initializing path of an extension. Users can write their own xml scripts, the run "autogen.py". And it'll generate the loading code in src and include directories.
+Так как написание  загрузки кода очень скучное занятие, то я разработал автоматический генератор кода для того чтобы помочь писать код. Есть много xml файлов в каталоге "./xml". Каждый xml-файл содержит определение типов, токены, функции, и путь инициализации расширения. Пользователи могут написать ствои xml-скрипты, тспользуя "autogen.py". О н сгенерирует код загрузки кода в каталогах src и include.
-== Dependency ==
+== Зависимость ==
-Python 2.6 and up is required to run "autogen.py".
+Python 2.6 и и выше нужен для запуска "autogen.py".
 [[en:Glloader/en]]
 [[zh:Glloader]]