Celestia/Celx 指令碼/問答/使用 CELX 賦值自定義鍵功能

使用 CELX，可以輕鬆建立自定義鍵功能，並將它們分配到鍵盤上的不同鍵位。以下是操作方法。

首先，使用 CELX 建立一個 Lua 函式來實現自定義功能。在本例中，我們將建立一個新的鍵功能，它可以縮放活動檢視，使當前選定的物件充滿檢視。

 zoomToFit= function()
    obs = celestia:getobserver()
    obsPos = obs:getposition()
    sel = celestia:getselection()
    if sel == nil or sel:name() == "?" then return end
    selPos = sel:getposition()
    dist = obsPos:distanceto(selPos)
    rad = sel:radius()
    appDia = 2*math.atan(rad/dist)
    obs:setfov(appDia*1.20)
    celestia:flash("Zoom to fit "..sel:name(), 2) 
   end

接下來，建立一個表，將選定的鍵對映到新的函式。在本例中，我們將使用“z”鍵。

 keymap = {
    z = zoomToFit
 }

然後，建立一個鍵處理函式，當按下所需的鍵時，呼叫新的 Lua 函式，並將其作為 Celestia 鍵盤迴調。

   celestia_keyboard_callback = function(key) 
       f = keymap[key]
       if f then 
          f() 
          return true
       end
          return false
   end

請注意，當輸入鍵存在自定義鍵定義時，回撥將返回 true，以指示 Celestia 不需要進一步處理該鍵。否則，它將返回 false，Celesta 將根據內建鍵功能分配來處理該鍵。

最後，告訴 Celestia，您希望在按下鍵時呼叫回撥，然後等待輸入。

   celestia:requestkeyboard(true)
   repeat
       wait(10)
   until false

請注意，該指令碼有一個無限迴圈，因此您需要使用 Esc 鍵來終止它。

一旦您獲得了基本指令碼，就可以透過定義 Lua 函式來實現它們，並將它們新增到鍵對映表中，從而輕鬆地分配其他新的鍵功能。

試試看！

下載指令碼

您可以在下面找到整個指令碼（無註釋）在一個文字塊中。將灰色框中的所有內容複製並貼上到您喜歡的文字編輯器的文字檔案中，並將該檔案儲存在您的指令碼目錄中，命名為 zoomtofit.celx。然後在 Celestia 中開啟它（檔案/開啟指令碼）以檢視指令碼的執行效果。

-- Zoom To Fit function script
syntaxhighlight lang="text"
zoomToFit= function()
  obs = celestia:getobserver()
  obsPos = obs:getposition()
  sel = celestia:getselection()
  if sel == nil or sel:name() == "?" then return end
  selPos = sel:getposition()
  dist = obsPos:distanceto(selPos)
  rad = sel:radius()
  appDia = 2*math.atan(rad/dist)
  obs:setfov(appDia*1.20)
  celestia:flash("Zoom to fit "..sel:name(), 2) 
 end

keymap = { z = zoomToFit }

celestia_keyboard_callback = function(key) 
     f = keymap[key]
     if f then 
        f() 
        return true
     end
        return false
 end

celestia:requestkeyboard(true)
repeat
     wait(10)
until false

</syntaxhighlight>

---

區分大小寫

不幸的是，上面的示例沒有區分輸入大寫字母和小寫字母。

當 Celestia 呼叫函式 celestia_keyboard_callback 時，函式的引數（在本例中為“key”）包含所輸入的字母。一個簡單的 IF 語句字串可以區分它們。

 celestia_keyboard_callback = function(key) 
      if key == "F" then 
         zoomToFit() 
         return true
      end
         return false
  end

這種形式的回撥將在輸入大寫 F 時呼叫函式 zoomToFit，但讓 Celestia 處理所有其他字母，包括小寫 f。

---