功能變數

功能變數是只有文字與標註引線才有的功能，它可以使用一些代碼顯示特定的資訊，所有的功能變數的語法都是 %<功能變數與選項>%，當功能變數無法取得需要的資訊時會顯示 ####，代表發生錯誤。

支援數學運算

所有計算數字的功能變數函數 (例如: Area、BlockInstanceCount、CurveLength、NumPages、PageNumber、Volume) 都可以在數學公式中組合。

例如：

%<2*3>% 計算為 6。

如果模型中有 4 個圖紙配置，則 %<NumPages()-1>% 計算為 3。

字串格式化

支援 Python 和 .NET 字串格式。

範例：
在一個數字前面加入前導零

如果模型中有 2 個圖紙配置，則 %<'{:03}'.format(NumPages())>% 將 2 轉換為 002。

轉換字母大小寫

%<ModelUnits().upper()>% 可以轉換模型單位，例如 millimeters 轉換為 MILLIMETERS。

Python 和 .NET 中的大小寫轉換函數

Python:

upper(), lower(), and capitalize()

.NET:

ToUpper() and ToLower()

.NET 中沒有直接的字首大寫函數。

函數

面積

計算封閉曲線 (必須是平面)、剖面線、曲面、多重曲面、網格或 SubD 的面積。

語法：

使用註解型式單位。

%<Area("ObjectID")>%

設定單位。

%<Area("ObjectID","Unit")>%

屬性外掛程式文字

物件的 ID 與附加到物件的文字資訊的索引的數值。

語法：

%<UserText("ObjectID","Key")>%

外掛程式文字的鍵 (key) 是要讀取數值的索引的名稱。

選取物件

選取物件以讀取屬性外掛程式文字的鍵。

圖塊屬性文字

定義屬性外掛程式文字要包含在圖塊引例中。

語法：

%<UserText("block","Key","Prompt","Value")>%

如何使用:

  1. 使用 Text 指令建立文字物件。

  2. 在文字對話框按 fx 按鈕。

  3. 選擇左側的屬性外掛程式文字。

  4. 在鍵、提示和值輸入文字字串。

  5. 建立包含圖塊屬性文字的圖塊定義。

  6. 使用 Insert 指令將圖塊加入到作業視窗。

  7. 出現提示時，輸入值或按 fx 按鈕使用另一個文字功能變數。

在此範例中，"Data Table" 圖塊定義是從包含名稱、年齡和性別的圖塊屬性文字的表建立的。

然後將該圖塊插入到其他兩個人員下方的作業視窗， Insert 指令會提示輸入他們的訊息。

下載範例模型...

圖塊描述

透過在作業視窗中選取圖塊引例而檢索圖塊定義的描述。

語法：

%<BlockDescription("Block Instance ID")>%

圖塊引例數目

顯示指定的圖塊定義在模型裡的引例的總數。

語法：

%<BlockInstanceCount("BlockName")>%

圖塊名稱

透過在作業視窗中選取圖塊引例而檢索圖塊定義的名稱。

語法：

%<BlockName("Block Instance ID")>%

%<BlockName("Block")>% 會傳回包含文字欄位字串的圖塊定義的名稱。

曲線長度

一條曲線的長度。

語法：

使用註解型式單位。

%<CurveLength("ObjectID")>%

設定單位。

%<CurveLength("ObjectID","Unit")>%

日期

目前的日期和時間。

日期格式:

從列表中選擇日期和時間格式。

區域:

從列表中選擇一個區域及適當的語言。

語法：

%<Date("Format", "Region")>%

範例：

%<Date("M/d/yyyy", "en-US")>% = 12/17/2020

%<Date("M/d/yyyy h:mm tt", "en-US")>% = 12/17/2020 4:48 PM

%<Date("dddd, MMMM dd, yyyy", "en-US")>% = Thursday, December 17, 2020

修改日期

上次儲存此檔案的日期和時間。

日期格式:

從列表中選擇日期和時間格式。

區域:

從列表中選擇一個區域及適當的語言。

語法：

%<DateModified("Format", "Region")>%

範例：

%<DateModified("M/d/yyyy", "en-US")>% = 12/17/2020

%<DateModified("M/d/yyyy h:mm tt", "en-US")>% = 12/17/2020 4:48 PM

%<DateModified("dddd, MMMM dd, yyyy", "en-US")>% = Thursday, December 17, 2020

DetailScale (僅適用於平行的子視圖)

顯示選取的子視圖的格式縮放比。

語法：

%<DetailScale("DetailID","Format")>%

格式範例

無格式 = 0.1

#:1 = 0.1:1

1:# = 1:10

1=# = 1" = 10'

#=1 = 1/8" = 1'

#=1-0 = 1/8" = 1'-0"

使用子視圖屬性名稱

使用在其物件內容中設定的名稱引用子視圖，而非 GUID。

文件外掛程式文字

模型的文件外掛程式文字。

語法：

%<DocumentText("Key")>%

文件外掛程式文字 (DocumentText) 的鍵 (key) 是要讀取數值的索引的名稱。

檔案名稱

這個檔案的路徑。

語法：

%<FileName>%

%<FileName>% - 模型檔案的完整路徑與檔案名稱 (包含副檔名)

%<FileName("0")>% - 模型檔案的完整路徑與檔案名稱 (包含副檔名)

%<FileName("1")>% - 模型檔案的名稱 (包含副檔名)

%<FileName("2")>% - 模型檔案的完整路徑與檔案名稱 (不包含副檔名)

%<FileName("3")>% - 模型檔案的名稱 (不包含副檔名)

數字代表的意義：

1 = 不包含路徑的檔案名稱

2 = 不包含副檔名

1+2 = 3 = 不包含路徑的檔案名稱 + 不包含副檔名

圖層名稱

返回選取圖層的名稱。

語法：

%<LayerName("LayerID")>%

圖紙配置外掛程式文字

從儲存在圖紙配置中的外掛文字鍵返回值。

語法：

目前圖紙配置中的圖紙配置外掛程式文字鍵的值。

%<LayoutUserText("Key")>%

特定圖紙配置中的圖紙配置外掛程式文字鍵的值。

%<LayoutUserText("LayoutID","Key")>%

模型單位

目前模型的單位。

語法：

%<ModelUnits()>%

附註

附註的內容。

語法：

%<Notes()>%

總頁數

檔案裡圖紙配置的總頁數。

語法：

%<NumPages()>%

物件圖層

返回選取物件的圖層名稱。

語法：

%<ObjectLayer("ObjectID")>%

物件名稱

顯示物件或圖塊的名稱。

語法：

%<ObjectName("ObjectID")>%

物件頁面名稱

傳回所選物件所在圖紙配置的名稱。

如果物件不在圖紙配置中，則傳回 ####。

語法：

%<ObjectPageName("ObjectID")>%

物件頁碼

傳回所選物件所在圖紙配置的頁碼。

如果物件不在圖紙配置中，則傳回 ####。

語法：

%<ObjectPageNumber("ObjectID")>%

圖紙高度

此文字功能變數所在的圖紙配置頁面的高度。

語法：

%<PageHeight()>%

頁面名稱

目前或選取的圖紙配置頁面的名稱。

選取的頁面

顯示選取的圖紙配置頁面的名稱。

語法：

圖紙配置的名稱。

%<PageName()>%

選取的圖紙配置頁面的名稱。

%<PageName("PageID")>%

頁碼

目前的圖紙配置的編號。

語法：

%<PageNumber()>%

%<PageNumber() + OffsetNumber>%

圖紙寬度

此文字功能變數所在的圖紙配置頁面的寬度。

語法：

%<PageWidth()>%

圖紙名稱

所選紙張尺寸的名稱。

語法：

%<PaperName()>%

點座標

顯示所選點物件的世界 XYZ 座標。

XYZ 軸可以分別啟用。

語法：

%<PointCoordinate("ObjectID","Axes")>%

體積

讀取擠出物件、曲面、多重曲面、網格或 SubD 的體積。

允許開放的物件

啟用以返回開放物件的體積。

語法：

使用註解型式單位。

%<Volume("ObjectID")>%

設定單位。

%<Volume("ObjectID","Unit")>%

允許開放的物件。

%<Volume("ObjectID","True")>%

炸開 (Explode) vs. 炸開圖塊 (ExplodeBlock)

炸開有包含文字功能變數的圖塊引例時，Explode 和 ExplodeBlock 指令會產生不同的結果。

在使用 ExplodeBlock 指令分解圖塊引例後，日期文字功能變數仍會傳回系統日期。

 

 

 

Rhinoceros 8 © 2010-2024 Robert McNeel & Associates. 14-三月-2024