# 資源庫

資源庫包含所有載入的節點，其中包括 10 個安裝隨附的預設品類節點，以及已載入的其他所有自訂節點或套件。資源庫中的節點在資源庫、品類和子品類 (如果有) 內以階層方式組織。

!

* 基本節點：預設安裝隨附。
* 自訂節點：將常用常式或特殊圖表儲存為自訂節點。您也可以與社群共用您的自訂節點
* Package Manager 中的節點：收集已發佈的自訂節點。

我們將瀏覽[節點品類的階層](#library-hierarchy-for-categories)，示範如何[從資源庫快速搜尋](#search-by-hierarchy)，並了解其中某些[常用節點](#frequently-used-nodes)。

### 品類的資源庫階層

透過在這些品類中進行瀏覽，能以最快方式瞭解可以加入到工作區的項目所在的階層，並以最佳方式探索尚未使用的新節點。

透過四處按一下功能表瀏覽資源庫，展開每個品類及其子品類

{% hint style="info" %}
Geometry 功能表很適合在開始探索時使用，因為它們包含最多數量的節點。
{% endhint %}

!

> 1. 資源庫
> 2. 品類
> 3. 子品類
> 4. 節點

這些項目會根據節點是**建立**資料、執行**動作**或**查詢**資料，進一步分類成有相同子品類的節點。

* ! **建立**：從頭開始建立或建構幾何圖形。例如圓。
* ! **動作**：對物件執行動作。例如，調整圓的比例。
* ! **查詢**：取得已存在物件的性質。例如，取得圓的半徑。

將滑鼠懸停在節點上，可顯示名稱和圖示之外更詳細的資訊。我們由此可以快速了解節點的功能、所需的輸入及其提供的輸出。

!

> 1. 描述 - 節點的普通語言描述
> 2. 圖示 -「資源庫」功能表中更大版本的圖示
> 3. 輸入 - 名稱、資料類型與資料結構
> 4. 輸出 - 資料類型與結構

### 在資源庫中快速搜尋

如果您知道希望加入至工作區的節點相關特性，在 **「搜尋」** 欄位中鍵入可查詢所有相符的節點。

選擇按一下要加入的節點，或按 Enter 將亮顯的節點加入工作區的中心。

!

#### 依階層搜尋

除了使用關鍵字嘗試尋找節點，我們還可以在「搜尋欄位」中鍵入以句點分隔的階層，或使用程式碼區塊 (使用 *Dynamo 文字語言*)。

每個資源庫的階層都會反映在加入工作區的節點名稱中。

在資源庫階層中以 `library.category.nodeName` 格式鍵入節點位置的不同部分，會傳回不同的結果

* `library.category.nodeName`

!

* `category.nodeName`

!

* `nodeName` 或 `keyword`

!

通常，工作區中節點的名稱將以 `category.nodeName` 格式呈現，但在「Input」與「View」品類中有一些明顯的例外。

請注意名稱相似的節點，並注意品類差異：

* 大多數資源庫中的節點將包括品類格式

!

* `Point.ByCoordinates` 和 `UV.ByCoordinates` 的名稱相同，但來自不同品類

!

* 明顯的例外包括內建函數、Core.Input、Core.View 及運算子

!

### 常用的節點

Dynamo 的基本安裝中包括數百個節點，哪些節點對於開發視覺程式非常重要？接下來我們著重了解定義程式參數 (**Input**)、查看節點動作結果 (**Watch**) 以及透過捷徑 (**Code Block**) 定義輸入或功能所使用的節點。

#### 輸入節點

輸入節點是視覺程式的使用者 (不論是您自己還是他人) 與關鍵參數結合的主要方式。以下是核心資源庫中一些可用的項目：

| 節點             |   | 節點             |   |
| -------------- | - | -------------- | - |
| 布林運算           | ! | 編號             | ! |
| 字串             | ! | Number Slider  | ! |
| Directory Path | ! | Integer Slider | ! |
| File Path      | ! |                |   |

#### Watch 與 Watch3D

Watch 節點對於管理流經視覺程式的資料非常重要。您可以透過**節點資料預覽**，將滑鼠懸停在節點上，來檢視節點的結果。

!

在 **Watch** 節點中保持顯示會很有用

!

或透過 **Watch3D** 節點查看幾何圖形結果。

!

這兩個節點都位於核心資源庫內的 View 品類中。

{% hint style="info" %}
秘訣：若視覺程式包含許多節點，3D 預覽有時可能會分散您的注意力。請考慮不勾選「設定」功能表中的「展示背景預覽」選項，並使用 Watch3D 節點預覽幾何圖形。
{% endhint %}

#### Code Block

Code Block 節點可以用於定義一塊程式碼 (以分號分隔各行)。這可以像 `X/Y` 一樣簡單。

我們也可以使用 Code Block 做為捷徑定義數字輸入或呼叫其他節點的功能。執行此作業的語法遵循 Dynamo 文字語言 [DesignScript](/zh-tw/8_coding_in_dynamo/8-1_code-blocks-and-design-script/2-design-script-syntax.md) 的命名慣例。

以下是在指令碼中使用 Code Block 的簡單示範 (含指示)。

1. 按兩下以建立 Code Block 節點
2. 鍵入 `Circle.ByCenterPointRadius(x,y);`
3. 按一下工作區以清除選取，這會自動加入 `x` 和 `y` 輸入。
4. 建立 Point.ByCoordinates 節點與 Number Slider，然後將其連接至 Code Block 的輸入。
5. 執行視覺程式的結果如 3D 預覽中顯示為圓


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://primer2.dynamobim.org/zh-tw/3_user_interface/2-library.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.