Библиотека трехмерной графики Open gl
Форма сообщений об ошибках
жүктеу/скачать 1.07 Mb.
|
- Бұл бет үшін навигация:
- Первые команды
- Класс контекста воспроизведения
Форма сообщений об ошибкахПри отладке нового приложения практически неизбежны ошибки времени выполнения. Для вывода на экран сообщений о возможных ошибках, можно добавить к проекту форму, которая будет отображаться каждый раз, когда в цикле главной формы возникают ошибки. Добавьте к проекту gl3D новую форму. Для этого
Теперь проведите редакцию файла проекта pr3D.cs:
try { Application.Run(new f3D()); } catch (Exception e) { if
MessageBox.Show ( e.Message + "\nДетали?", Path.GetFileName(Application.ExecutablePath) + " Ошибка!!", MessageBoxButtons.YesNo, MessageBoxIcon.Exclamation, MessageBoxDefaultButton.Button1 ) == DialogResult.Yes ) {
// создается окно с редактором errMsgTextBox, в который выводится // описание ошибки и детальный маршрут к функции, внутри которой ошибка возникла gl3D.ErrorMsgForm emf = new gl3D.ErrorMsgForm(); // В errMsgTextBox помещается строка с подробным сообщением об ошибке emf.errMsgTextBox.Text = e.ToString(); // Окно изображается в модальном режиме // (пока окно не закроется, фокус не переводится на другие окна) emf.ShowDialog(); // Окно уничтожается в памяти emf.Dispose(); } Application.Exit(); } Для описания ошибок времени выполнения будет использоваться механизм объектов исключительной ситуации. Этот механизм предполагает, что при возникновении ошибки в операторах, находящихся в блоке try (в данном случае практически в любом месте выполняемой программы, т.к. в блоке try находится основной метод Application.Run с формой f3D), управление передается в блок catch, описанный здесь. Параметром блока catch служит объект "e" класса исключительной ситуации Exception, порожденный ошибочным кодом, или намеренно созданный программистом. У объектов класса Exception есть свойство Message, содержащее краткую информацию об ошибке. Метод ToString() объектов класса Exception возвращает полное описание маршрута к источнику ошибки. Проверка работы этого механизма будет проведена ниже на конкретном примере. Скомпилируйте новую версию проекта.
Комплексная цель модуля
Класс контекста воспроизведенияВ этом разделе
Для использования команд библиотеки OpenGL следует сопоставить панели panelGL формы f3D так называемый контекст воспроизведения. Контекст воспроизведения является портом, через который команды OpenGL будут выводить результат своей работы в окно (в данном случае на панель panelGL). С этой целью
using System.Runtime.InteropServices; using System.Windows.Forms;
/// /// Управляет созданием и освобождением контекста воспроизведения OpenGL /// public class glPort : IDisposable { /// /// Буфер дублирован. /// const uint PFD_DOUBLEBUFFER = 0x00000001; /// /// Буфер может передавать содержание в окно или на поверхность устройства /// const uint PFD_DRAW_TO_WINDOW = 0x00000004; /// /// Буфер поддерживает команды OpenGL. /// const uint PFD_SUPPORT_OPENGL = 0x00000020; /// /// Описывает формат пикселей изображающей поверхности. /// [StructLayout(LayoutKind.Sequential)] class PIXELFORMATDESCRIPTOR { internal short nSize = 40; internal short nVersion = 1; internal uint dwFlags = PFD_DRAW_TO_WINDOW | PFD_SUPPORT_OPENGL |PFD_DOUBLEBUFFER; internal byte iPixelType; internal byte cColorBits = 32; internal byte cRedBits; internal byte cRedShift; internal byte cGreenBits; internal byte cGreenShift; internal byte cBlueBits; internal byte cBlueShift; internal byte cAlphaBits = 8; internal byte cAlphaShift; internal byte cAccumBits = 8; internal byte cAccumRedBits; internal byte cAccumGreenBits; internal byte cAccumBlueBits; internal byte cAccumAlphaBits; internal byte cDepthBits = 32; internal byte cStencilBits = 8; internal byte cAuxBuffers; internal byte iLayerType; internal byte bReserved; internal int dwLayerMask; internal uint dwVisibleMask; internal uint dwDamageMask; } #region Поля и свойства /// /// Хранит идентификатор библиотечного модуля OpenGL /// static int openGLdllHandle; /// /// Хранит дескриптор формата пикселей /// PIXELFORMATDESCRIPTOR pixelFD = new PIXELFORMATDESCRIPTOR(); /// /// Устанавливает и возвращает текущий контекст устройства /// public int deviceContext { private set; get; } /// /// Хранит текущий контекст воспроизведения /// int renderContext; /// /// Хранит идентификатор (хэндл) окна /// int controlHandle; #endregion #region Статические методы #region Методы установки формата пикселей /// /// Пытается найти формат пикселей, поддерживаемый данным контекстом устройства и /// наиболее близким к данному формату. /// /// /// Определяет контекст устройства, для которого должен быть выбран формат пикселей. /// /// /// Ссылка на экземпляр структуры типа PIXELFORMATDESCRIPTOR, /// который определяет требуемый формат пикселя /// /// /// Индекс искомого формата пикселей. Если функция выполнена успешно, /// то это значение больше нуля. /// Если нет, то значение равно нулю. /// [DllImport("GDI32")] static extern int ChoosePixelFormat(int dvcContext, [MarshalAs(UnmanagedType.LPStruct)]PIXELFORMATDESCRIPTOR pfd); /// /// устанавливает формат пикселя указанного контекста устройства в формат, /// определенный индексом pixelFormatIndex /// ///
/// Контекст устройства, для которого устанавливается данный формат пикселя ///
///
/// Индекс формата пикселя /// /// /// Ссылка на структуру /// (в данном случае класс, который должен интерпретироваться как структура) типа /// PIXELFORMATDESCRIPTOR, которая содержит спецификацию формата пикселя. /// /// /// При успешном завершении возвращает TRUE, в противном случае FALSE. /// [DllImport("GDI32")] static extern bool SetPixelFormat(int dvcContext, int pixelFormatIndex, [MarshalAs(UnmanagedType.LPStruct)]PIXELFORMATDESCRIPTOR pfd); #endregion #region Методы манипуляции с контекстами /// /// Возвращает идентификатор контекста устройства дисплея для клиентской области окна. /// Контекст может быть использован при вызове функций, /// создающих изображение на клиентской области окна. /// /// /// идентификатор (хэндл) окна, чей контекст должен быть возвращен /// /// /// При успешном завершении возвращает идентификатор контекста устройства, /// в противном случае 0 /// [DllImport("User32")] static extern int GetDC(int handle); /// /// Освобождает контекст устройства для использования другими приложениями. /// /// /// идентификатор (хэндл) окна, чей контекст должен быть освобожден /// /// /// идентификатор освобождаемого контекста устройства /// /// /// При успешном завершении возвращает 1, в противном случае 0 /// [DllImport("User32")] static extern int ReleaseDC(int handle, int dvcContext); /// /// Создает новый контекст воспроизведения OpenGL. /// Контекст воспроизведения соответствует устройству с заданным контекстом. /// Контекст воспроизведения имеет тот же формат пикселя, что и заданный контекст устройства. /// /// /// Идентификатор контекста устройства /// /// /// При успешном завершении возвращает идентификатор контекста воспроизведения, /// в противном случае 0 /// [DllImport("OPENGL32.DLL")] static extern int wglCreateContext(int dvcContext); /// /// Уничтожает контекст воспроизведения /// /// /// Идентификатор контекста воспроизведения /// /// /// При успешном завершении возвращает TRUE, в противном случае FALSE. /// [DllImport("OPENGL32.DLL")] static extern bool wglDeleteContext(int rndContext); /// /// Производит обмен содержимого переднего и заднего буферов, /// если формат пикселя указанного /// контекста устройства включает задний буфер (двойная буферизация) /// /// /// Идентификатор контекста устройства /// /// /// При успешном завершении возвращает TRUE, в противном случае FALSE. /// [DllImport("GDI32")] static extern bool SwapBuffers(int dvcContext); /// /// Делает указанный контекст воспроизведения OpenGL текущим контекстом /// для данного подпроцесса (нити). /// Все последующие вызовы команд OpenGL, сделанные в этом подпроцессе, /// будут выполняться на устройстве /// с указанным контекстом. Функция может использоваться так же для того, чтобы текущий /// контекст воспроизведения перестал быть текущим /// /// /// Идентификатор контекста устройства /// /// /// Идентификатор контекста воспроизведения. Если это значение 0, /// то текущий контекст воспроизведения перестает быть текущим. /// В этом случае второй параметр игнорируется. /// /// /// При успешном завершении возвращает TRUE, в противном случае FALSE. /// [DllImport("OPENGL32.DLL")] static extern bool wglMakeCurrent(int dvcContext, int rndContext); #endregion /// /// Вводит исполняемый модуль в адресное пространство вызываемого процесса /// ///
/// Имя исполняемого модуля /// /// /// При успешном завершении возвращает идентификатор (хэндл) загруженного модуля, /// в противном случае 0 /// [DllImport("Kernel32")] public static extern int LoadLibrary(String funcname); #endregion /// /// Вызывает метод wglMakeCurrent для данных контекстов устройства и воспроизведения /// /// /// Результат, возвращаемый методом wglMakeCurrent /// public bool MakeCurrent() { return wglMakeCurrent(deviceContext, renderContext); } /// /// Вызывает метод SwapBuffers для данного контекста устройства /// /// /// Возвращает результат метода SwapBuffers /// public bool SwapBuffers() { return SwapBuffers(deviceContext); } /// /// Определяет идентификатор данного окна, создает контекст устройства, /// контекст воспроизведения и делает контекст воспроизведения текущим. /// ///
/// данное окно ///
public glPort(Control control) { // Получение контекста устройства if (0 == (deviceContext = GetDC(controlHandle = (int)control.Handle))) throw new Exception("Контекст устройства для данного окна не определен."); // загрузка библиотеки OpenGL if (openGLdllHandle == 0) if (0 == (openGLdllHandle = LoadLibrary("OpenGL32.DLL"))) throw new Exception("Библиотека OPENGL32 не включена в процесс."); // получение индекса требуемого формата пикселя int pixelFormatIndex = ChoosePixelFormat(deviceContext, pixelFD); if (0 == pixelFormatIndex) throw new Exception("Формат пикселей не определен."); // установка формата пикселя для данного контекста устройства if (!SetPixelFormat(deviceContext, pixelFormatIndex, pixelFD)) throw new Exception("Формат пикселей не установлен."); // создание контекста воспроизведения OpenGL для данного контекста устройства if (0 == (renderContext = wglCreateContext(deviceContext))) throw new Exception("Контекст воспроизведения не установлен."); // контекст воспроизведения делается текущим if (!wglMakeCurrent(deviceContext, renderContext)) throw new Exception("Контекст не установлен текущим."); } /// /// Уничтожает контекст воспроизведения и освобождает контекст устройства текущего окна /// public void Dispose() { // контекст воспроизведения перестает быть текущим if (!wglMakeCurrent(0, 0)) throw new Exception("Контекст не установлен нулем."); if (renderContext > 0) // уничтожается контекст воспроизведения if (!wglDeleteContext(renderContext)) throw new Exception("Контекст воспроизведения не освобожден."); if (deviceContext > 0) // освобождается контекст устройства if (0 == ReleaseDC(controlHandle, deviceContext)) throw new Exception("Контекст устройства не освобожден."); renderContext = deviceContext = 0; } } Перенесите этот код и ознакомьтесь с комментариями. Скомпилируйте решение. К ссылкам проекта gl3D добавьте ссылку на библиотеку GL (контекстное меню над пунктом References проекта gl3D, команда Add references…, вкладка Projects). Для использования класса glPort с панелью panelGL перейдите к редактированию файла главной формы проекта f3D.cs.
#region Рабочие поля и свойства /// /// Хранит текущий порт воспроизведения команд OpenGL /// glPort port; #endregion
#region Методы воспроизведения /// /// Устанавливает воспроизводимую сцену и копирует буферы /// void RenderFrame() { if (!port.SwapBuffers()) throw new Exception("Не выполнен обмен буферов."); } #endregion
Этот вызов перенесет содержимое заднего буфера панели PanelGL в передний буфер, передав тем самым изображение на экран. Обработчик panelGL_Paint поместите в раздел "Обработчики panelGL" так, что результат редакции будет выглядеть следующим образом #region Обработчики panelGL private void panelGL_Paint(object sender, PaintEventArgs e) { RenderFrame(); } #endregion Активируйте проект. Если все сделано верно, должны увидеть черную панель. Пройдите по коду проекта шагами с помощью команды отладчика Step Into из меню Debug. Эта процедура позволит увидеть последовательность выполнения операторов проекта. Чтобы понять, как работает механизм реакции на ошибки в созданном коде, в библиотеке GL закройте комментаторскими скобками /* … */ строки загрузки библиотеки OpenGL в теле конструктора glPort. Это строки if (openGLdllHandle == 0) if (0 == (openGLdllHandle = LoadLibrary("OpenGL32.DLL"))) throw new Exception("Библиотека OPENGL32 не включена в процесс."); Активируйте проект. Результатом должно быть появление окна сообщения об ошибке типа "Контекст воспроизведения не установлен". Вновь пройдите по шагам код проекта командой Step Into. Уберите комментаторские скобки и вернитесь к работающей версии проекта.
жүктеу/скачать 1.07 Mb. Достарыңызбен бөлісу:
|