Визуализация примитивов

// Пример Examples\Ch02\Ex01
// Стандартные директивы C#
using	System;
using	System.Collections.Generic;
using	System.ComponentModel;
using	System.Data;
using	System.Drawing;
using	System.Text;
using	System.Windows.Forms;
// При обработке исключений, связанных с 
открытием файла эффекта, нам понадобится 
// пространство имен System.IO 
using System.IO;
// Включаем в приложение пространства имен XNA Framework
using Microsoft.Xna.Framework;
using Microsoft.Xna.Framework.Graphics;
using XnaGraphics = Microsoft.Xna.Framework.Graphics;
namespace GSP.XNA.Book.Ch02.Ex01 
{
public partial class MainForm : Form 
{ 
// Устройство XNA Framework
GraphicsDevice device = null; 
// Параметры представления данных на экране
PresentationParameters presentParams; 
// Графический буфер для хранения вершин 
(то есть координат нашей точки)
VertexPositionColor[] vertices = null; 
// Декларация формата вершины
VertexDeclaration decl = null; 
// Эффект, используемый при визуализации точки
Effect effect = null;
// Флаг, устанавливаемый в true при подготовке 
к завершении работы приложения 
bool closing = false;
public MainForm() 
{
InitializeComponent();
}
private void MainFormLoad(object sender, EventArgs e)
{
 // Стандартная процедура настройки параметров 
 формы и создание графического устройства 
SetStyle(ControlStyles.Opaque | ControlStyles.ResizeRedraw, true); 
MinimumSize = SizeFromClientSize(new Size(1, 1));
presentParams = new PresentationParameters(); 
presentParams.IsFullScreen = false; 
presentParams.BackBufferCount = 1; 
presentParams.SwapEffect = SwapEffect.Discard;
 presentParams.BackBufferWidth = ClientSize.
 Width; presentParams.BackBufferHeight = ClientSize.Height;
device = new GraphicsDevice(GraphicsAdapter.
DefaultAdapter, DeviceType.Hardware, 
this.Handle, CreateOptions.SoftwareVertexProcessing |
 CreateOptions.SingleThreaded, 
presentParams);
// Создаем массив, предназначенный для хранения 
координат одной точки
vertices = new VertexPositionColor[1]; 
// Создаем декларацию формата вершины
decl = new VertexDeclaration(device,
 VertexPositionColor.VertexElements); 
// Задаем координаты точки (вершины) 
таким образом, чтобы она всегда была в центре экрана. 
// Цвет точки устанавливаем в морской волны, но 
в действительности он не влияет на цвет 
// точки, так как используемый эффект игнорирует 
информацию о цвете вершины
vertices[0] = new VertexPositionColor
(new Vector3(0.0f, 0.0f, 0.0f), 
XnaGraphics.Color.Aqua);
// Структура для хранения кода откомпилированного эффекта 
CompiledEffect compiledEffect; try 
{ 
// Пытаемся загрузить эффект из файла и
 откомпилировать его в промежуточный байт-код
compiledEffect = Effect.CompileEffectFromFile
(effectFileName, null, null, CompilerOptions.None, TargetPlatform.Windows);
} 
// Если файл с эффектом не был найден catch (IOException ex) 
{
// Выводим сообщение об ошибке и завершаем работу приложения
MessageBox.Show(ex.Message, "Критическая 
ошибка", MessageBoxButtons.OK, MessageBoxIcon.Error);
closing = true;
Application.Idle += new EventHandler(ApplicationIdle);
return; }
// Если эффект не был удачно откомпилирован if 
(!compiledEffect.Success) 
{
 // Выводим сообщение об ошибках и предупреждениях
  из свойства ErrorsAndWarnings и завершаем 
// работу приложения
MessageBox.Show(String.Format("Ошибка при компиляции
 эффекта: \r\n{0}", compiledEffect.ErrorsAndWarnings), 
"Критическая ошибка", MessageBoxButtons.OK, MessageBoxIcon.Error);
closing = true;
Application.Idle += new EventHandler(ApplicationIdle); return;
 }
// Создаем эффект на базе скомпилированного
 байт-кода. Обратите на использование флага 
// CompilerOptions.NotCloneable,который позволяет 
ощутимо сократить объем оперативной 
// памяти, используемой эффектом
effect = new Effect(device, compiledEffect.GetEffectCode(), CompilerOptions.NotCloneable, null);
// Выполняем валидацию текущей техники (проверяем,
 может ли текущая техника выполнится на 
// данном GPU)
if (!effect.CurrentTechnique.Validate()) 
{
 // Если функциональность текущего GPU недостаточна,
  выводим сообщение об ошибке
MessageBox.Show(String.Format("Ошибка при валидации 
техники \"{0}\" эффекта 
 \"{1}\"\n\r" + "Скорее всего, функциональность
 шейдера превышает возможности GPU", 
 effect.CurrentTechnique.Name, effectFileName),
 "Критическая ошибка", MessageBoxButtons.OK, 
> MessageBoxIcon.Error);
closing = true;
Application.Idle += new EventHandler(ApplicationIdle); 
return; 
}
}
private void MainFormPaint(object sender, PaintEventArgs e) 
{
// Если приложение завершает работу из-за проблем в 
обработчике события Load, выходим из 
// обработчика события Paint (эффект effect может 
быть не корректно инициализирован, поэтому 
// попытка визуализации сцены может спровоцировать исключение) 
if (closing) 
return;
try 
{
 // Проверяем, не потеряно ли устройство
if (device.GraphicsDeviceStatus == GraphicsDeviceStatus.Lost) 
throw new DeviceLostException();
if (device.GraphicsDeviceStatus == GraphicsDeviceStatus.NotReset) 
device.Reset(presentParams);
// Очищаем форму
device.Clear(XnaGraphics.Color.CornflowerBlue);
// Устанавливаем формат вершины
device.VertexDeclaration = decl;
// Начинаем визуализацию эффекта.
effect.Begin(); 
// Перебираем все проходы эффекта
foreach (EffectPass pass in effect.CurrentTechnique.Passes)
{ 
// Начинаем визуализацию текущего прохода
pass.Begin() ; 
// Рисуем точку
device.DrawUserPrimitives(PrimitiveType.PointList, vertices, 0, 
Ч> vertices.Length); 
// Заканчиваем визуализацию прохода
pass.End(); 
}
// Оканчиваем визуализацию эффекта
effect.End(); 
// Завершаем визуализацию примитивов
// Выводим полученное изображение на экран device.Present(); } 
// Обработка потери устройства
catch (DeviceNotResetException) 
{
Invalidate(); 
}
catch (DeviceLostException) 
{ 
}
}
// Обработчик события Idle. Завершает работу приложения.
void Application_Idle(object sender, EventArgs e) 
{
Close(); 
}
// Сброс устройства при изменении размеров окна
private void MainForm_Resize(object sender, EventArgs e) 
{
if (WindowState != FormWindowState.Minimized) 
{
presentParams.BackBufferWidth = ClientSize.Width; 
presentParams.BackBufferHeight = ClientSize.Height; 
device.Reset(presentParams); 
}
}
// Удаление устройства при завершении программы
private void MainForm_FormClosed(object sender, 
FormClosedEventArgs e) 
{
if (device != null) 
{
device.Dispose(); device = null; 
	 } 
	} 
    } 
}

VertexPositionColor[] vertices = null;
VertexDeclaration decl = null;

Effect effect = null;

vertices = new VertexPositionColor[1];
vertices[0] = new VertexPositionColor(new Vector3
(0.0f, 0.0f, 0.0f), XnaGraphics.Color. Aqua);
// Описание формата вершины берется из поля VertexPositionColor
decl = new VertexDeclaration(device, 
VertexPositionColor.VertexElements);

// Для сокращения объема кода из него исключена 
обработка исключительных ситуаций. В реальных
// приложениях так поступать категорически не 
рекомендуется, так как это значительно снизит
// "дуракоустойчивость" вашего 
приложения. Поэтому настоятельно рекомендую ознакомится с
// полной версией кода из листинга 2.7.
CompiledEffect compiledEffect;
// Компилируем fx-файл в байт код
compiledEffect = Effect.CompileEffectFromFile
(effectFileName, null, null,
 CompilerOptions.None, TargetPlatform.Windows);
// Используем полученный байт-код для создания 
объекта эффекта.
effect = new Effect(device, compiledEffect.
GetEffectCode(), CompilerOptions.NotCloneable,
null);

effect.Begin();
foreach (EffectPass pass in effect.CurrentTechnique.Passes) 
{
pass.Begin();
device.DrawUserPrimitives(PrimitiveType.PointList,
 vertices, 0, vertices.Length);
pass.End() ; 
}
effect.End();

// Некоторые фрагменты определения класса 
GraphicsDeviceCapabilities
public sealed class GraphicsDeviceCapabilities : IDisposable
{
// Группа свойств, описывающих возможности
 графического устройства по визуализации примитивов
public GraphicsDeviceCapabilities.Primitive
Caps PrimitiveCapabilities { get; } 
// Группа свойств с информацией о возможностях декларации вершин
public GraphicsDeviceCapabilities.
DeclarationTypeCaps DeclarationTypeCapabilities { ^ get; } 
// Группа свойств с информацией о вершинных шейдерах
public GraphicsDeviceCapabilities.
VertexShaderCaps VertexShaderCapabilities { get; } 
// Группа свойств с информацией о пиксельных шейдерах
public GraphicsDeviceCapabilities.
PixelShaderCaps PixelShaderCapabilities { get; } 
// Группа свойств с информацией о драйвере устройства
public GraphicsDeviceCapabilities.DriverCaps DriverCapabilities { get; } 
// Группа свойств с информацией об устройстве, 
которая может пригодится при создании 
// устройства
public GraphicsDeviceCapabilities.DeviceCaps 
DeviceCapabilities { get; }3 
...
// Свойства без подсвойств:
// Максимальная версия языка Vertex Shader, 
поддерживаемая графическим устройством
public Version VertexShaderVersion { get; } 
// Максимальная версия языка Pixel Shader, 
поддерживаемая графическим устройством
public Version PixelShaderVersion { get; } 
// Максимальный размер точки, которую способно 
отображать графическое устройство
public float MaxPointSize { get; } 
// Максимальное количество примитивов,
 которое способно отобразить графическое устройство за 
// один вызов метода DrawUserPrimitives
public int MaxPrimitiveCount { get; } 
// Остальные свойства 
... 
}

// Некоторые фрагменты определения структуры 
DeviceCaps public struct DeviceCaps 
{ 
// Поддерживает ли графическое устройство 
метод DrawUserPrimitives на аппаратном уровне
public bool SupportsDrawPrimitives2Ex { get; } 
// Поддерживает ли графическое устройство 
аппаратную растеризацию примитивов (при отсутствии 
// подобной поддержки визуализация будет 
выполняться с неприемлемо низкой 
// производительностью)
public bool SupportsHardwareRasterization { get; }
// Имеет ли графическое устройство аппаратные вершинные процессоры
public bool SupportsHardwareTransformAndLight { get; } 
... 
}

public GraphicsDeviceCapabilities GraphicsDeviceCapabilities { get; }

// Создаем графическое устройство без 
 аппаратной поддержки вершинных шейдеров.
device = new GraphicsDevice(GraphicsAdapter.
DefaultAdapter, DeviceType.Hardware, this.Handle,
 CreateOptions.SoftwareVertexProcessing |
  CreateOptions.SingleThreaded, presentParams);
// Если GPU имеет аппаратные вершинные процессоры
if (device.GraphicsDeviceCapabilities.DeviceCapabilities.
SupportsHardwareTransformAndLight) 
{
// Уничтожаем устройство device.Dispose();
// Снова создаем устройство, но уже с аппаратной 
поддержкой вершинных шейдеров
device = new GraphicsDevice(GraphicsAdapter.DefaultAdapter, 
DeviceType.Hardware, this.Handle,
CreateOptions.HardwareVertexProcessing | 
CreateOptions.SingleThreaded, presentParams); 
}

public GraphicsDeviceCapabilities 
GetCapabilities(DeviceType deviceType);

GraphicsDeviceCapabilities caps =
GraphicsAdapter.DefaultAdapter.GetCapabilities(DeviceType.Hardware);
CreateOptions options = CreateOptions.SingleThreaded;
if (caps.DeviceCapabilities.SupportsHardwareTransformAndLight)
options |= CreateOptions.HardwareVertexProcessing; else
options |= CreateOptions.SoftwareVertexProcessing;
device = new GraphicsDevice(GraphicsAdapter.
DefaultAdapter, DeviceType.Hardware, this.Handle,
options, presentParams)