功能變數

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

支援數學運算

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

例如:

%<2*3>% 計算為 6

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

字串格式化

支援 Python 和 .NET 數字格式。

例如:

如果模型中有 2 個圖紙配置,則 %<'{:03}'.format(NumPages())>% 計算為 002

函數

Area

計算封閉曲線 (必須是平面)、剖面線、曲面、多重曲面、網格或 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 指令會提示輸入他們的訊息。

下載範例模型...

BlockInstanceCount

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

語法:

%<BlockInstanceCount("BlockName")>%

CurveLength

一條曲線的長度。

語法:

使用註解型式單位。

%<CurveLength("ObjectID")>%

設定單位。

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

Date

目前的日期和時間。

日期格式:

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

區域:

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

語法:

%<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

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

日期格式:

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

區域:

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

語法:

%<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。

DocumentUserText

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

語法:

%<DocumentText("Key")>%

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

FileName

這個檔案的路徑。

語法:

%<FileName>%

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

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

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

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

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

數字代表的意義:

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

2 = 不包含副檔名

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

LayerName

返回選取圖層的名稱。

語法:

%<LayerName("LayerID")>%

LayoutUserText

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

語法:

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

%<LayoutUserText("Key")>%

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

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

ModelUnits

目前模型的單位

語法:

%<ModelUnits()>%

Notes

附註的內容。

語法:

%<Notes()>%

NumPages

檔案裡的圖紙配置數目。

語法:

%<NumPages()>%

ObjectLayer

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

語法:

%<ObjectLayer("ObjectID")>%

ObjectName

顯示物件或圖塊的名稱。

語法:

%<ObjectName("ObjectID")>%

PageHeight

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

語法:

%<PageHeight()>%

PageName

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

選取的頁面

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

語法:

圖紙配置的名稱。

%<PageName()>%

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

%<PageName("PageID")>%

 

PageNumber

目前的圖紙配置的編號。

語法:

%<PageNumber()>%

%<PageNumber() + OffsetNumber>%

PageWidth

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

語法:

%<PageWidth()>%

PaperName

所選紙張尺寸的名稱。

語法:

%<PaperName()>%

PointCoordinate

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

XYZ 軸可以分別啟用。

語法:

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

Volume

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

允許開放的物件

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

語法:

使用註解型式單位。

%<Volume("ObjectID")>%

設定單位。

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

允許開放的物件。

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

 

 

 

Rhinoceros 7 © 2010-2022 Robert McNeel & Associates. 06-七月-2022