Difference between revisions of "Glloader/ru"

From KlayGE
Jump to: navigation, search
(Uncomplete Ru)
 
(Ru page complete)
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);
 
  int glloader_is_supported(const char* name);
 +
</pre>
 +
Определяет, доступна ли определенная функция на вашей платформе . Параметр '''name''' задаёт строку имени. Возвращает 0 если не доступно.
  
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.
+
 
+
  
 +
<pre>
 
  void* glloader_get_gl_proc_address(const char* name);
 
  void* glloader_get_gl_proc_address(const char* name);
 +
</pre>
 +
Загружает функцию OpenGL. Параметр '''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.
+
 
+
  
 +
<pre>
 
  int glloader_num_features();
 
  int glloader_num_features();
 +
</pre>
 +
Возвращает число поддерживаемых возможностей, включая возможности ядра и расширений.
  
Get the number of supported features, including the core and the extensions.
+
<pre>
 
+
 
+
 
  const char* glloader_get_feature_name(int index);
 
  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]]
 
[[en:Glloader/en]]
 
[[zh:Glloader]]
 
[[zh:Glloader]]

Revision as of 07:00, 6 July 2011

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


Основной особенностью glloader является то, что он предоставляет возможность инициализации расширения. Если расширение предоставлено ядром, то загрузчик попытается загрузить расширение из ядра прежде чем оно будет использовано.

После установки путе к каталогам include и lib, всё что вам нужно сделать, это добавить строку#include <glloader/glloader.h> в ваш код.

Заметки

Пожалуйста, не помещайте glloader в каталог с не-английскими названиями. Иначе скрипт autogen.py не сможет запуститься нормально.

Интерфейс

 int glloader_is_supported(const char* name);

Определяет, доступна ли определенная функция на вашей платформе . Параметр name задаёт строку имени. Возвращает 0 если не доступно.

Обратите внимание: Вы можете использовать строку вида "GL_VERSION_x_y" для определения поддерживаетмой версии x.y ядра OpenGL.

 void* glloader_get_gl_proc_address(const char* name);

Загружает функцию OpenGL. Параметр name задаёт имя функции. Возвращает адрес функции для расширения.

Обратите внимание: Когда функция завершается неудачно, то НЕТ гарантии что возвращенное значение будет NULL.

 int glloader_num_features();

Возвращает число поддерживаемых возможностей, включая возможности ядра и расширений.

 const char* glloader_get_feature_name(int index);

Возвращает имя возможности. Параметр index' в диапазоне [0, glloader_num_features() - 1].


Автоматический генератор кода

Так как написание загрузки кода очень скучное занятие, то я разработал автоматический генератор кода для того чтобы помочь писать код. Есть много xml файлов в каталоге "./xml". Каждый xml-файл содержит определение типов, токены, функции, и путь инициализации расширения. Пользователи могут написать ствои xml-скрипты, тспользуя "autogen.py". О н сгенерирует код загрузки кода в каталогах src и include.

Зависимость

Python 2.6 и и выше нужен для запуска "autogen.py".