編譯者：sosei
歡迎
歡迎來到BlitzMax-NG用戶指南。
本文將向您介紹BlitzMax（也就是BlitzMax-ng）背後的一些概念，以及如何實際使用它。
BlitzMax是一種基於流行的BASIC編程語言的計算機編程語言。BASIC代表初學者通用符號指令代碼。正如它的名字所暗示的那樣，BASIC的設計是易於使用的，但它在很多方面都很有用。
BlitzMax是一個編譯器。它將包含源代碼的文本文件作爲程序的輸入，並將其作爲可運行的程序的輸出。最後的程序由由CPU解釋的低級機器碼語句組成。
Blitzmax還包括在更現代的編程語言中發現的一些高級特性。特別是，BlitzMax支持稱爲繼承和多態性的面向對象編程技術。然而，BlitzMax的設計讓你在準備好之前不必學習這些技術（如果有的話！）
BlitzMax是如何工作的
BlitzMax獲取您程序的源代碼並將其轉換爲可執行代碼。這一過程包括兩個主要步驟：
編譯源代碼：此步驟涉及將項目中的每個源代碼文件轉換爲相應的目標代碼文件。目標代碼文件包含實際的機器碼，但不能單獨運行。它必須首先與其他對象文件鏈接…
鏈接目標代碼：這一步涉及到將所有目標代碼文件鏈接在一起，以產生一個可以實際運行的程序。此步驟是必要的，因爲目標文件通常需要在其他目標文件中找到的信息。有效地將目標代碼文件相互連接起來。
編譯和鏈接項目的這個過程稱爲構建項目，每當您編輯項目中的源文件或其他資源時，都必須這樣做。
構建項目有兩種主要方法：使用MaxIDE或使用BMK實用程序。
MaxIDE是一個集成開發環境。它允許您修改源代碼文件和構建項目。
BMK是一個較低級別的命令行實用工具，也用於構建項目。事實上，BlitzMax IDE使用BMK在幕後來建造項目。
BlitzMax IDE
BlitzMax IDE是一個用於編輯源代碼文件和構建項目的應用程序。IDE代表“集成開發環境”。
BlitzMax IDE操作起來非常像文本編輯器或文字處理器。
開始
好了，是時候編譯並運行您的第一個程序了！
首先，從文件菜單或工具欄中選擇New。這將創建一個新的、空的源文件供您使用。
接下來，輸入以下小程序：
'
'My first BlitzMax program
'
Print "Hello World!"
現在，到了構建和運行的時候了：從程序菜單中選擇build和run。你應該看到以下輸出：
Building untitled1
Compiling:untitled1.bmx
flat assembler version 1.51
3 passes, 2417 bytes.
Linking:untitled1.debug.exe
Executing:untitled1.debug.exe
Hello World!
Process complete
恭喜您！您剛剛創建了您的第一個程序！
BlitzMax入門指南
概述
我爲那些剛接觸BlitzMax，有一點編程基礎的人寫了這本指南，特別推薦給那些想在BlitzMax中邁出OOP第一步的人。如果您正在從其他任何編程語言(包括Blitz3D/Plus)轉換到BlitzMax，那麼這篇介紹應該是有用的。它不是作爲一個BlitzMax基礎→BlitzMax教程編寫的。我的目標是讓每個人都有機會在學習神奇的BlitzMax中有一個好的開始。如果你是從Blitz3D/Plus中轉換過來，你將會受到衝擊，因爲有很多新東西。方式改變了，但我向你保證，一切都會好起來的。當你已經邁出了第一步，並瞭解了周圍的路，沒有其他地方像BlitzMax一樣;)
一個好的學習方法是做。閱讀我的例子，但試着自己寫。它提供了良好的編碼實踐。如果您想使用本指南中的任何代碼，請這樣做，代碼是公開的。
變量
您可能知道：變量是存儲數字或文本的地方。根據不同的使用，有不同的變量“類型”。以下是最基本的類型：存儲數字的整數、存儲文本的字符串和存儲小數的浮點數。我們也有對象-“類型”，其中包括這些基本類型，如數組，列表和您自己的自定義類型(稍後更多關於這些)。如果您想了解更多關於BlitzMax變量的信息，請參閱語言參考。
如果你想增加一個變量，比如說速度。你可以寫 speed = speed + acceleration，或者用更短的方式寫 speed:+acceleration。兩者是一樣的，但後者較短。在使用之前必須聲明變量。
Local speed: Float=0 , acceleration:Int , name:String = "Name"
Local speed#= 0 , acceleration , name$ = "Name"
這兩行兩種寫法等價的。（譯者推薦用第一種，可讀性更好。）
注：Local是聲明變量的一種方式。
注：在BlitzMax NG中變量定義的編譯檢查嚴格程度有兩個等級。可在程序源文件開頭（只能在文件開頭）分別用Strict和SuperStrict關鍵字設置。如果不設置，那默認是Strict等級。（譯者推薦都設成SuperStrict等級）
Strict等級下整型變量的聲明可從 Local/Global VarName:Int 省略掉“:Int”部分，也就是 Local/Global VarName 就可以了。
SuperStrict等級下你必須聲明所有的類型，包括Int變量。
沒有返回類型的函數/方法不能返回任何東西。
例子：
'
'My first BlitzMax program
'
Strict
Local speed = 10
Print speed
注意：BlitzMax認爲“Speed”、“speed”和“sPeEd”是相同的變量。因爲BlitzMax裏不區分大小寫，任何關鍵字也是。（譯者推薦：關鍵字、函數名、方法名和類型名的每個單詞首字母大寫；常量名的所有單詞都大寫並“_”分隔單詞；變量名的所有單詞都小寫並“_”分隔單詞）
Global或Local
變量可以是全局的，也可以是局部的。全局變量可以從整個程序中訪問。另一方面，局部變量更加複雜，因爲它們的存在取決於它們在哪裏聲明。這稱爲局部作用域。若要聲明局部變量，請在變量名前面使用關鍵字local。如果你在一個函數中聲明一個局部變量，它將只存在於那個函數中。如果它是在一個循環中聲明的，那麼它將只在您處於該循環中時存在。如果一個局部變量在一個If語句中，那麼它只存在於那個If語句中。
常量
您還可以聲明常量。一個常量將具有您在第一次聲明它時所賦予的值。常數的值永遠不會改變，它將永遠保持不變。如果你試圖改變一個常量的值，編譯器會在編譯時警告你。常量對於始終保持不變的值非常有用。
例子：
Rem
Const defines the preceeding variable declaration as constant.
EndRem
SuperStrict
Const ON:Int=True
Const OFF:Int=False
Const TWO_PI:Float=2*Pi
Print TWO_PI
註釋
註釋是解釋代碼的文本。您的程序不需要註釋就可以工作，但是註釋是您生活中不可缺少的東西之一！
下面是註釋一例：
Local speed: Float=0 'Sets speed to zero
單引號“'”表示該行的其餘部分將是註釋。
你也可以使用：
Rem
If you want to comment out several lines
Useless line 1
Useless line 2
EndRem
來完成多行註釋。
If指令
If語句用於檢查是否滿足了某個條件，然後根據該條件採取行動。
例子：
Local a=-1,b=2,r=0
If a > 10 Then
a = 10
ElseIf a < 0 and b => 2 Then
r:-10
Else
a:+b
EndIf
Print r
'Read: If a is greater than 10
'Read: Set a to 10
'Read: if a less than 0 and b is equal or greater than 2
'Read: Decrease r with 10. E.g. if r was 100 it is now 90
'Read: if none of above conditions is met do this
'Read: Add b to a. Or Increase A with b. That is: a = a + b
這個例子沒有什麼特別的，它只是向您展示瞭如何使用If、ElseIf、Else和EndIf。(a,b,r是變量)
注：“ElseIf”、“EndIf”也可以寫成“Else If”、“End If”。（譯者推薦用ElseIf、EndIf）
源程序中關鍵字Then可以省略。
If A = 1 Then B = 2 等價於 If A = 1 B = 2 。
但是從可讀性考慮，不要這麼做。
注：邏輯判斷中數值0就等於False，非零就等於True。如果一個對象是“null”（不存在），它就是false，否則就是true
“<>”是“不等於”運算符。If a <> 10 等價於 If Not a = 10
循環
循環是告訴Blitz重複做一件事。
例子：
For Local i:Int = 10 To 0 Step -1
Print i
Next
這個輸出就是10，9，……0。輸出了11個數，循環包括開頭與結尾的數。
例子：
Local a:Int[]=[0,5,12,13,20]
For Local b:Int = EachIn a
Print b
Next
關鍵字EachIn表示遍歷數組或集合。
例子：
Local i:Int = 0
While i<=5
Print i
i:+1
Wend
關鍵字While表示直到條件爲假終止循環。
注：Wend位置也可用EndWhile，兩個關鍵字等價的。（譯者推薦用Wend）
例子：
Local i:Int = 0
Repeat
Print i
i:+1
Until i=5
關鍵字Until表示直到條件爲真終止循環。
例子：
Local i:Int = 0
Repeat
Print i+" Ctrl-C to End!"
i:+1
Forever
關鍵字Forever表示是個死循環。
輸入
輸入是BlitzMax的一個簡單的部分。(我們說的是鍵盤和鼠標輸入，而不是輸入命令)
例子：
Graphics 800,600,0
Local x=500, y=500 '<- - - - - - - start location
'- - - - - - - - - - Loop Start - - - - - - - - - -
While Not KeyDown(Key_Escape) ' This loop is equal to repeat except the condition is at the top.
Cls
'DRAW___________________________________
DrawOval x,y,8,8 'Draw an Oval at x,y with a width and height of 8
DrawText "Press Arrow Keys to go around, Space to Center",20,20
'INPUT___________________________________
If KeyDown(Key_Left) Then x:-1 'Decrease x <-- go left
If KeyDown(Key_Right) Then x:+1 'increase x go right -->
If KeyDown(Key_Down) Then y:+1 'Increase y Go Down \/
If KeyDown(Key_Up) Then y:-1 'Decrease y Go Up /\
If KeyHit(Key_Space) Then 'Set position
x=400
y=300
EndIf
Flip
Wend
'- - - - - - - - - - Loop End - - - - - - - - - -
注：所有鍵的名稱都是以Key_開頭的，鍵A是Key_A，以此類推，表示所有字母和數字。有關鍵碼的完整列表，請參閱手冊的掃描代碼部分。
Functions
函數是重用代碼的一種方式。它還可以將代碼分割成更容易管理的部分。
一個函數例子：
Function Collectdata$( name$, id, age ) ' $ means String, nothing means Int
Local total_data$ = "Name: " +name+ ", id: "+id+", Age: " +age
Return total_data
EndFunction
Local test_data$ = Collectdata("Blast" , 8, 30)
函數可以返回任何類型的數據，包括對象。它返回的類型是在函數名後面指定的，跟“$”就表示返回一個字符串型值。如果要返回整型，就寫成 Function CollectData:Int 或 Function CollectData%
注：如上函數類型改整型，Return 一個字符串類型，那麼編譯階段就會報錯通不過。
下面是另一個簡單函數的例子：
'--------------------- A D D ----------------------
' Parameters: a,b,c ; numbers to add
' Returns: The sum of these numbers
' Note: Only accepts integers
'_______________________________
Function Add:Int( a% , b% , c% = 0 )
Return a + b + c
EndFunction
'-------------------------------------------------
Number = Add(2,2,3) 'Will set Number to 7
Number = Add(2,2) 'Will set Number to 4
注：註釋函數是很重要的。寫出參數是什麼，它返回什麼，它做什麼。
隨機
一個最有用的命令是Rand(A, B)，它在A和B之間創建一個隨機值。
例子：
Local test = Rand(1,3)
這將把test設置爲1、2或3。如果只使用一個參數調用Rand(A)，因爲參數B缺省值是1，函數將返回一個介於A到1之間的值。這意味着Rand(-1)應該是-1、0或1。
數組
數組是在一個地方存儲多個值的一種方式。數組中的所有元素必然具有相同的類型！
例子：
Local name_list$[] = [ "Dawn" , "Trac" , "Fire" ,"Nitro" ,"Nex"]
這將創建一個包含5個字符串的數組。所有元素都是字符串。
例子：
NameList[0] = "None"
Local Text$ = NameList[2]
存取數組元素。數組下標從0開始。
NameList[2] refers to element 2 of Array NameList. Arrays start at 0, so this would give us "Fire"
多維數組
例子：
Local my_array[3,3]
For Local x = 0 To 2
For Local y = 0 To 2
Print my_array[x, y]
Next
Next
聲明瞭一個3x3，9個元素的2維數組。
如果我們想遍歷2維數組中的所有元素，就必須使用雙重For-Next循環。
數組的數組
例子：
Local grid[][] = [[1,1,1,2],[7,7],[5,5,5]]
這將創建三個一維數組，第一個長度爲4，第二個長度爲2，第三個長度爲3。這些數組用作較大數組中的行。爲了得到一個元素，我們使用grid[WhichArray][PlaceInThisArray]。如果想得到第一個子數組，那就grid[0]。
獲得數組長度和排序
例子：
Local test[] = [7,39,1,24,5,6,3,8,19,5,3,3,2,5,18,8,2,221,3,4,5,63,87,12,92]
Print "Length "+test.Length
test.Sort()
For Local n = EachIn test
Print n
Next
.Sort()是升序排序，而.Sort(False)是降序排序。
數組切片
切片是數組的一部分的拷貝。格式是StringOrArray [ StartIndex .. EndIndex ]
StartIndex是切片的起始下標，EndIndex表示切片的截止下標（不包括本下標）。
省略StartIndex那麼默認從0開始，省略EndIndex那麼默認取開始下標後所有元素。
如果EndIndex <= StartIndex，那麼拷貝爲空。
例子：
Local test[] = [0,1,2,3,4,5,6,7,8,9,10,11,12,13]
For Local n = EachIn test[2..4]
Print n
Next
這將複製下標2、下標3的元素。