Text fields

Text fields are a feature for text and leaders. Text fields are formulas that are evaluated while Rhino is running and the result is displayed in the text. All text fields are in the syntax of %<field and options>%. When a formula cannot be evaluated an error string of #### is displayed.

Area

Area of a closed curve, hatch, surface, or mesh.

Syntax:

%<area("id")>%

id is the guid of an existing object in the document.

BlockInstanceCount

Displays the number of blocks of the specified name.

Syntax:

%<blockinstancecount("apple")>%

displays the number of blocks named "apple" in the model.

CurveLength

Length of a curve.

Syntax:

%<curvelength("id")>%

id is the guid of an existing curve in the document.

Date

Current date.

Syntax:

%<date>%

%<date("format")>%

Text string examples

The date format can be any of the following strings:

%<date("d")>% = 08/17/2000

%<date("D")>% = Thursday, August 17, 2000

%<date("f")>% = Thursday, August 17, 2000 16:32

%<date("F")>% = Thursday, August 17, 2000 16:32:32

%<date("g")>% = 08/17/2000 16:32

%<date("G")>% = 08/17/2000 16:32:32

%<date("m")>% = August 17

%<date("r")>% = Thu, 17 Aug 2000 23:32:32 GMT

%<date("s")>% = 2000-08-17T16:32:32

%<date("t")>% = 16:32

%<date("T")>% = 16:32:32

%<date("dddd, MMMM dd yyyy")>% = Thursday, August 17 2000

%<date("ddd, MMM d 'yy")>% = Thu, Aug 17 '00

%<date("dddd, MMMM dd")>% = Thursday, August 17

%<date("M/yy")>% = 8/00

%<date("dd-MM-yy")>% = 17-08-00

DateModified

Date this file was last saved.

Syntax:

Same as date.

DocumentText

Document text from the document.

Syntax:

%<documenttext("key")>%

key is the key for the DocumentText value to retrieve.

FileName

Path to the file.

Syntax:

%<filename>%

%<filename>% - creates the full path to the model

%<filename("0")>% - creates the full path to the model

%<filename("1")>% - short filename (includes file extension)

%<filename("2")>% - full path to model without file extension

%<filename("3")>% - short filename without extension

The number parameter is a mask to turn on certain features:

1 = short file name

2 = no extension

1+2 = 3 = short filename + no extension

ModelUnits

Active model units.

Syntax:

%<modelunits>%

Notes

Contents of the Notes.

Syntax:

%<notes>%

NumPages

Number of layout pages in the document.

Syntax:

%<numpages>%

ObjectName

Displays the object or block name if there is one.

Syntax:

%<objectname>%

PageName

Current layout name.

Syntax:

%<pagename>%

PageNumber

Current layout number.

Syntax:

%<pagenumber>%

UserText

Usertext for a given object / key combination.

Syntax:

%<usertext("id","key")>%

id is the guid of an existing object in the document.

key if the key of the UserText for the value to retrieve.