//-----------------------------------------------------------------------------
// file: CreateDevice.cs
// 創建設備
// Desc: This is the first tutorial for using Direct3D. In this tutorial, all
//       we are doing is creating a Direct3D device and using it to clear the
//       window.
// 注釋：這是第一個使用D3D的教學例子，在這個例子中，我們要作的僅僅是創建以個D3D“設備”和刷新窗口
// Copyright (c) Microsoft Corporation. All rights reserved.
//-----------------------------------------------------------------------------
using System;
using System.Drawing;
using System.Windows.Forms;
using Microsoft.DirectX;
using Microsoft.DirectX.Direct3D;

namespace DeviceTutorial
{
public class CreateDevice : Form
{
// Our global variables for this project
Device device = null; // Our rendering device
                              //我們的繪圖設備
public CreateDevice()
{
// Set the initial size of our form
//設置窗體的初始值
this.ClientSize = new System.Drawing.Size(400,300);
// And it's caption
//設置窗體標題
this.Text = "D3D Tutorial 01: CreateDevice";
}

public bool InitializeGraphics()
{
try
{
// Now let's setup our D3D stuff
//現在我們設置D3D的一些選項
PresentParameters presentParams = new PresentParameters();
presentParams.Windowed=true;//標志著程序運行時窗口模式
presentParams.SwapEffect = SwapEffect.Discard;//返回或設置交換區選項????
device = new Device(0, DeviceType.Hardware, this, CreateFlags.SoftwareVertexProcessing, presentParams);
//?,設備的類型(這里選擇了硬件),創建圖形設備的窗體，創建類型,創建實體）；
//創建設備實例
return true;
}
catch (DirectXException)//捕捉DX異常
            { 
                return false; 
            }
}
private void Render()//刷新模塊
{
if (device == null) 
return;

//Clear the backbuffer to a blue color 
//將設備窗口刷成綠色
device.Clear(ClearFlags.Target, System.Drawing.Color.Blue, 1.0f, 0);
//clear(刷屏的參數這里選的是目標，使用的顏色，深度(可能用于模板)，模板（0）因為沒有使用模板）
//Begin the scene
//開始渲染場景，（因為沒有場景所以一下句是空的就直接結束了場景的渲染）
device.BeginScene();

// Rendering of scene objects can happen here
//可以在這里渲染場景
    
//End the scene
//結束場景的渲染
device.EndScene();
device.Present();
}      
protected override void OnPaint(System.Windows.Forms.PaintEventArgs e)  //重寫OnPaint方法
{
//this.Render(); // Render on painting
//循環的刷新窗口
}
protected override void onKeyPress(System.Windows.Forms.KeyPressEventArgs e)//重寫onKeyPress方法
{
if ((int)(byte)e.KeyChar == (int)System.Windows.Forms.Keys.Escape)
this.Close(); // Esc was pressed
//如果按下了ESC則退出程序
}

/// <summary>
/// The main entry point for the application.
/// 程序的主函數，入口點
/// </summary>
static void Main() 
{
            //使用USING語句創建對象保證對象的銷毀
            using (CreateDevice frm = new CreateDevice())
            {
                if (!frm.InitializeGraphics()) // Initialize Direct3D
                {
                    MessageBox.Show("Could not initialize Direct3D.  This tutorial will exit.");
                    return;
                }
                frm.Show();

                // While the form is still valid, render and process messages
//消息循環
                while(frm.Created)
                {
                    frm.Render();
                    Application.DoEvents();
                }
            }
}
}
}