The T-BLOCK menu gives you access to the TITLE BLOCK functions of CoCreate/DMS. These functions allow you to relate drawings title block entries to entries in the database.
-->--(Tablet_defaults_auto_dyn_off)--> -->--(Tablet_defaults_auto_dyn_on)--> -->--(Tablet_defaults_auto_dyn_on_knobs)-->
These macros define how the window functions that are picked on the tablet in the WINDOW block, operate.
With "Tablet_defaults_auto_dyn_off" the window functions picked on the tablet will operate without dynamic feedback of the drawing (except the rubber or moving window box).
With "Tablet_defaults_auto_dyn_on" the window functions picked on the tablet will operate with dynamic feedback of the drawing. It will show dynamically the result of the window operation. This option should be used with "Display List On" and a hardware accelerator.
With "Tablet_defaults_auto_dyn_on_knobs" the window functions picked on the tablet will operate with dynamic feedback of the drawing. When the user rotate the appropriate knob on the knob-box the window functions operate dynamically. This option should be used with "Display List On" and hardware accelerator. If this option is selected, a submenu will pop up when a window function is picked, which shows the which window function is performed by which knob.
-->--(Tablet_defaults_curr_view)-->
-->--(Tablet_defaults_sel_view)-->
These macros define on which viewport the window functions that are picked on the tablet in the WINDOW block, operate.
With "Tablet_defaults_curr_view" the window functions picked on the tablet will operate within the current viewport.
With "Tablet_defaults_sel_view" the window functions picked on the tablet will ask for a viewport on which they should operate.
---->(TABLET_RESET)---->
TABLET_RESET asks the system to re-establish contact with the tablet. This is required if the tablet is accidentally turned off (turn it back on first), or when an interface failure occurs.
--(TABLE_COLUMN)-|table_id|-+
|
+---------------+
|
| +-------------------<-------------------------+
| | |
| | +---------<---------------+
| | | |
+---+-(COLUMN)-|COLNUM|-+----------+-|DISP COLOR|-+--(END)->
| | | |
| +-(DITHER)-+ |
| |
+-|BACKG COLOR|-------------------------------+
| |
+-(FORMAT)-+-|FORMATPRECISION|----------------+
| | |
| +--|FORMATSTRING|------------------+
| |
+-(CENTER)------------------------------------+
| |
+-(LEFT)--------------------------------------+
| |
+-(RIGHT)-------------------------------------+
| |
+-|ACTIONTEXT|--------------------------------+
| |
+-|LOGICAL TABLE COLUMN|----------------------+
TABLE_COLUMN sets the attributes of the cells in data columns of an existing unsecured table. Trying to change a secured table will give an error.
The string must contain either a '.' or a ',', signifying a decimal point or decimal comma. If there are no digits to the left of the point or comma, or value is equal 0, left zero suppression is selected. Right zero suppression will be selected, if the last digit after the point or comma is not equal to '0' or no digit is present. The number of digits after the point or comma gives the decimal place.
Examples:
Ex. If action text is 'Units = @s3' and logical table's extra string number 3
is 'Meters' then the actual action text will be 'Units = meters'.
Special meaning is also attached to @v# characters in action string. They are replaced by data in the logical table column whose number is given by the characters but in same logical table row as the cell picked.
Ex. If action text is 'Units = @v3' and logical table's data in column 3 same
row as picked cell is SI then actual text will be 'Units = SI'.
EXAMPLE
TABLE_COLUMN 'newTab' COLUMN 1 RED GREEN 3 'LINE' LEFT FORMAT 2 END
TABLE_COLUMN 'newTab' COLUMN 2 'LINE @s1 @v2' END
-(TABLE_LAYOUT)-|TABLE_NAME|-+
|
+-----------------------+
|
|
| +------------------------<------------------------+
| | |
----+-|DISP COLOR|------------------------------------+->{layout}->
| |
+-|BACKG COLOR|-----------------------------------+
| |
+-(WIDTH)------|WIDTH_VAL|------------------------+
| |
+-(HEIGHT)------|HEIGHT_VAL|----------------------+
| |
+-(ROWS)------|ROW_VAL|---------------------------+
| |
+-(FRAME_WIDTH)------|FRAME_WIDTH_VAL|------------+
| |
| +------<------+ |
| | | |
+-(HORIZONTAL)----+-(OFF)-------+-----------------+
| | | |
| +-|LINE COLOR|+ |
| | | |
| +-|LINE TYPE|-+ |
| | | |
| +-------------+ |
| |
| +------<------+ |
| | | |
+-(VERTICAL)----+-(OFF)-------+-------------------+
| | | |
| +-|LINE COLOR|+ |
| | | |
| +-|LINE TYPE|-+ |
| | | |
| +-------------+ |
| |
| +------<-------+ |
| | | |
+-(SCROLL_BAR)----+-|DISP COLOR|-+--+-|WIDTH_VAL|-+
| | | | |
| +-|BACKG COLOR|+ +-------------+
| | | |
| +--------------+ |
| |
+-|POINT1|----+-|POINT2|-+------------------------+
| | | |
| +----------+ |
| |
+-|LOGICAL_TABLE_NAME|----------------------------+
| |
+-------------------->----------------------------+
{layout}
+------------------------------<----------------------------+ | | | +---------------<---------------+ | | | | | ->---------+-(TITLE_LAYOUT)----+-|HEIGHT_VAL|-+--|LAYOUT_STR|--+--(END)+-(END)-> | | | | | | +--------------+ | | | | | | | +-------------------------------+ | | | +-(COLUMN_LAYOUT)----+-|HEIGHT_VAL|+-----|LAYOUT_STR|-------+ | | | | | +-------------+ | | | +-----------------------------------------------------------+
This command allows you to create a new table with given shape and location.
EXAMPLE
TABLE_LAYOUT 'newTab' 100,100 400,400 TITLE_LAYOUT ' | | ' 30 ' | ' END COLUMN_LAYOUT ' | | ' END
TABLE_LAYOUT 'newTab' 100,100 width 30.0 height 28.5 TITLE_LAYOUT ' | | ' 30 ' | ' END COLUMN_LAYOUT ' | | ' END
TABLE_LAYOUT 'newTab' RED GREEN SCROLL_BAR BLUE WHITE 10 HORIZONTAL GREEN DASHED VERTICAL OFF ROWS 20.2 SCROLL BAR TITLE_LAYOUT ' | | ' 30 ' | ' END COLUMN_LAYOUT ' | | ' END
--(TABLE_SCROLL_STEP)--+->|table_id|-+--+-(DEFAULT)+ | | | | +-->(ALL)---->+ +-|NUM|----+
This function allows you to set the scroll step of a display table while using the scroll bar gadget boxes.
-->(TABLE_STATUS)-+-|'table_name'|-+--+-->(MOVE)->|point|->+->
| | | |
+---->(FIRST)----+ +-->(MAP)----------->+
| |
+-->(UNMAP)--------->+
| |
+-->(FIX)----------->+
| |
+-->(UNFIX)--------->+
| |
+-->(FIX_UNIFX)----->+
The TABLE_STATUS function can be used to change the status of the specified table:
MOVE moves the table to the new position 'point'.
MAP causes the table to appear on the screen. If the identified
table is already on the screen, it will be shuffled up to be
fully visible.
UNMAP causes the table to disappear from the screen.
FIX fixes the identified table at its current position. Every
time the table is mapped, it will appear at this position.
UNFIX resets the map position to the home position.
FIX_UNFIX switches the table from fixed to unfixed or from unfixed to fixed dependent on the current state.
-(TABLE_TITLE)-|table_id|-+
|
+----------------------+
| +--------------------------------------<------------------------+
| | |
+---+-|DISP COLOR|--------------------------------------------------+>(END)->
| |
+-|BACKG COLOR|-------------------------------------------------+
| |
+-(DITHER)------------------------------------------------------+
| |
+-|DISPLAYTEXT|-+-|ACTIONTEXT|+-+-(BOX)-|ROW|-|COL|-|ROW|-|COL|-+
| | | | |
| +-----------+ +-|ROW|-|COL|------------------>+
| | |
+-----------------------------+ |
| |
+-(LEFT)---------------------->---------------------------------+
| |
+-(CENTER)-------------------->---------------------------------+
| |
+-(RIGHT)--------------------->---------------------------------+
| |
+----------------------------->---------------------------------+
This function allows you to set the attributes of title slots of an existing table which is not secured by the program for changes in title.
Ex. If display text is 'Units = @s3' and logical table's extra string
number 3 is 'Meters' then the actual display text will be 'Units =
meters'.
EXAMPLE
TABLE_TITLE 'newTab' RED GREEN 'LINE' 'LINE_CMD' 2 3 END
TABLE_TITLE 'newTab' GREEN WHITE 'UNITS' '@s1' BOX 1 1 4 3 END
Returns the tangent of the argument. As always, the current angle units are used.
(TB_CURRENT_DRAWING)-->|drawing name|--+------>--------+-+-------->-------+-> v | v | +->|rev string|-+ +->|vers number|-+
TB_CURRENT_DRAWING allows the user to change the drawing element to which the current drawing is referencing. A table will be displayed for the user to pick the drawing to be made current if NAME, REVISION, and/or VERSION are not supplied. The current drawing will be highlighted on the screen.
Revision string and version number have to be specified if the class 'drawings' is defined with REVISIONING and VERSIONING. Otherwise only one of them or none has to be specified, depending on how the class 'drawings' was defined.
(TB_GET_DRAW_VALUES)->
TB_GET_DRAW_VALUES retrieves the attribute values for the current drawing. They are placed in the title block logical table.
(TB_SETUP_TABLE)--|ltab_name|->
TB_SETUP_TABLE defines Title Block text references (TR) for all drawing class attributes. It also creates the title block logical table.
---->(TECHO)---->+------------------>+---->+---->|filename|--->+---->
| | | |
+---->(DEL_OLD)---->+ +------>(OFF)------>+
| |
+---->(APPEND)----->+
TECHO opens or closes the TECHO file. If a TECHO file is open, all points digitized on the tablet or read with TINPUT are written to the named file. The points are specified in the tablet coordinate system (units millimeters, origin lower left), just as in TINPUT or TMENU. The format is readable by TINPUT.
With OFF, the current TECHO file is closed. With a filename, the current TECHO file is closed and a new one with the given name is opened. The filename may specify a disk file or a device file.
,-----------------------------------,
| ,-------------, ,--------------, |
v v | v | |
-->(TEXT)--+-+-->|string|--+-+---->|point|--+--+-->
| v ^ |
| `->(SCREEN)---' |
| |
`-(ASSIST)--------------------------'
TEXT creates texts.
The text can be entered as a string, or by saying SCREEN, which puts you in the built-in editor (see EDITOR). You can define multi-line text blocks, either with the SCREEN option, or by entering the lines as consecutive strings. A string must contain at least one character. You then indicate one or more points where the text is to go; it is the text origin that is placed at these points (see TEXT_ADJUST).
The appearance of the text is affected by TEXT_ANGLE, TEXT_FILL, TEXT_FRAME, TEXT_LINESPACE (multi-line texts only), TEXT_RATIO, TEXT_SIZE, and TEXT_SLANT, not to mention by the text fonts themselves, which are definable with DEFINE_FONT and CHAR_LAYOUT.
A new text font "hp_symbols" has been introduced that contains some special text symbols like diameter sign, plus/minus sign, degree sign, minute sign and second sign. Characters from this text font have to be preceded by an ASCII 14 (shift out) character and have to be followed by an ASCII 15 (shift in) character when used in a text string. The characters 32 to 96 are reserved for future use and should be not customized. For example, an angle of 30 degrees, 0 minutes, 0 seconds can be written as:
"30"#14"0"#15 "0"#14"3"#15 "0"#14"4"#15
The current contents of "hp_symbols" are:
The ASSIST qualifier switches on user assistance (COPILOT command). Additional graphical feedback and creation methods are then available. See the COPILOT command for more information.
The text menu enables the user to add, delete, change and modify text on drawings. The text font may also be changed.
-->(TEXT_ADJUST)-->|number|-->
TEXT_ADJUST specifies the position of the text origin for new texts. The origin is a vertex point, visible and catchable with SHOW VERTEX ON, which can be useful for alignment.
The number gives the location point according to the following pattern:
7 8 9
4 5 6
1 2 3
For example, if the text is a capital letter:
1 lower left corner of letter
5 center of letter
9 upper right corner of letter
The default adjust value is 1.
Adjust points 1, 2, and 3 are always on the text baseline, below which, in a conventional font, letters like 'g' and 'j' extend. Adjust points 7, 8, and 9 are determined by the height of the characters in the text, and not by the default height of the font (see DEFINE_FONT).
-->(TEXT_ANGLE)-+->|angle|-------------+-->
| ^
'-->|point|-->|point|--'
TEXT_ANGLE specifies the current text angle, which is measured between the X axis and the text baseline. The angle can also be specified with two points. This angle is used for all new texts.
---->(TEXTDOMAIN)---->|domain_name|---->
TEXTDOMAIN function sets the current domain to 'domain_name'. GETTEXT arithmetic function retrieves the localized message from current domain.
-->(TEXT_FEEDBACK)--+--(TF_BOX)---+--> | | +--(TF_TEXT)--+ | | +----(ALL)----+
TEXT_FEEDBACK specifies the current feedback mode during text creation.
TF_BOX: Show old-style box feedback during text creation. TF_TEXT: Show the resulting text as it would appear attached to the cursor. This reflects all current text settings, but not color. ALL: Show both kinds of feedback (TF_BOX and TF_TEXT) together.
Default is TF_BOX.
-->(TEXT_FILL)--+-->(ON)---+-->
| ^
'-->(OFF)--'
TEXT_FILL turns the filling of characters ON (drawn solid) or OFF (outline only). The default is OFF. This affects new texts, but only those in fillable fonts. A font is fillable if every character in it consists only of closed polygons.
If you define a character with a zero-area polygon, this character is not correctly displayed and plotted.
-->(TEXT_FRAME)-+-->(OFF)---------+-->
| ^
|-->(BOX)-------->|
| |
+-->(BALLOON)---->+
| |
+-->(FLAG)------->+
TEXT_FRAME sets the current text frame type. This is the frame type used for new texts. OFF is no frame at all, BOX a rectangular frame, BALLOON a frame with rounded corners, and FLAG a flag shaped frame. If the text is a single character, BALLOON is a circle. BALLOON can also be a circle with more than one text character but this depends on the width-to-height Ratio value. For example, if the ratio is 1, the characters 11 need less space than the characters 88. Therefore, the number 11 will be enclosed in a circle, whereas the number 88 will be enclosed in a frame with rounded corners. The default is OFF.
-->(TEXT_HOLE_INSERTION)----+--(ON)---+---->
| |
+--(OFF)--+
This switch is important if a new text is created inside a hatched area. If TEXT_HOLE_INSERTION is ON, a hole will be automatically created, i.e. the text will become an inner contour of the hatch. If you do not want creation of holes, switch TEXT_HOLE_INSERTION to OFF. The default value of TEXT_HOLE_INSERTION is ON.
-->(TEXT_LINESPACE)-->|number|--->
TEXT_LINESPACE sets the current linespacing, which is used for new texts. The distance between baselines of a multi-line text is linespace * text_size. The default is 2.2.
-->(TEXT_RATIO)-->|number|-->
TEXT_RATIO sets the current ratio of character width to height. This is the ratio used for new texts. The default is 1. The text height is determined by TEXT_SIZE.
-->(TEXT_SIZE)-->|number|-->
TEXT_SIZE sets the current text height, which is used for new texts. As usual, this number is in user units. The text size is normally the height of a capital letter (see DEFINE_FONT). The default is 3.5 mm.
-->(TEXT_SLANT)-->|number|-->
-->(TEXT_TO_GEO)------->+--->|select|--->+--->
| |
+----------------+
TEXT_TO_GEO converts text entity into geometry.
All the text attributes (color, size, slant, ratio, angle, fill, linespace (multi-line texts only) ) of the text are transferred / maintained in the converted geometry. The original appearance of the text is retained. If the text entity was filled the converted geometry image will be hatched (HATCH_DIST 0). Info text if attached to the text will be lost during conversion. Text reference points of converted texts will be deleted. Reference lines attached to the text will be converted into leader lines. Dimensions attached to the reference point of the text entity are transferred to a new point element, created at the location of the reference point of the text.
Text frames and HATCH holes of text are kept during conversion.
Text to geometry conversion cannot be done if the font of the text is not loaded, ie if the text is displayed through default font.
Returns the number of seconds since midnight.
---->(TINPUT)---->+----------------->+---->|filename|---->
| |
+---->|number|---->+
TINPUT switches cursor tracking from the tablet to the file specified by string. Points specified in the file are interpreted just as though they had been digitized on the tablet. Normally the file is the output of a previous TECHO (see TECHO for format information).
Number (default is 1, range from 1 to 1000) specifies a relative factor that is a measure of the number of points to be interpolated between two digitized points. This affects the cursor feedback only. TINPUT files may not be nested. The TINPUT function should not be used inside macros. If TECHO is active, then all points read from the TINPUT file will also be written to the TECHO file.
---->(TMENU)---->+---->(TRACKING)---->|point|---->|point|-------------->+->
| |
+---->|point|---->+---------------->+---->|string|---->+
| |
+---->|point|---->+
TMENU defines the tablet menu.
TMENU TRACKING redefines the tracking area on the tablet. After execution, the screen is mapped onto this area.
To define a new tablet menu field, you enter opposite corners of the field, then give the action text.
To redefine an existing field, you enter a point anywhere in the field, then give the action text.
Points may be specified in the tablet coordinate system (units millimeters, origin lower left), or may be picked with the stylus on the tablet.
-->--(Tm_port_large_slash_small)-->
This macro allows the user to use the full screen as drawing area. The screen menus are temporarily switched off. The main purpose of this macro is to get a better view of the current drawing.
To switch back to the former viewport layout the user must pick this macro again.
Attention: A large viewport created with this macro must not be resized or deleted except with this macro.
-->-+-->|command|------->+-->
| |
|-->|option|-------->|
| |
|-->|arithm funct|-->|
| |
|-->|symbol|-------->|
| |
|-->|identifier|---->|
| |
|-->|string|-------->|
| |
|-->|number|-------->|
| |
|-->|point|--------->|
| |
|-->|point_3d|------>|
| |
|-->|name|---------->|
| |
'-->|expression|-----'
-->(TONE)-->+-->|frequency|-->|duration|-->|amplitude|-->+-->(END)-->
^ |
| v
+<-------------------------------------------+
The TONE function generates one or more audible tones with specific parameters. Frequency is in Hz, duration in seconds, and amplitude in the range from 0 to 1.
+----(CREATE)-----+
+----(DEL_OLD)----+->-+-(unique_name)-+
| | |
-->(TOOLBAR)-----+---------------------+---------------+--+
|
+<---------------------------------------+
|
+-->(DESTROY)------------------>(CONFIRM)--------------->+--->
| |
+<-------------------------------------------------------+
+-->(EDIT)---------------------------------------------->+
+-->(REMOVE_ITEM)------------->|position|--------------->+
+-->(CAPTION)------------------>|caption|--------------->+
+-->(RENAME)------------->|new unique name|------------->+
+-->(SHOW_AS_POPUP)------------------------------------->|
+-->(FLOAT)->|left|->|top|->|number of columns|--------->+
+-->(DOCK)-+->(TOP)----+>|row|->|column|->|from_edge|--->+
| | | |
| +->(LEFT)---+ |
| | | |
| +->(RIGHT)--+ |
| | | |
| +->(BOTTOM)-+ |
+-->(ON_RIGHT_CLICK)--->|action_text|------------------->+
+-->(VISIBLE)-----------+-->(ON)---+-------------------->+
| | | |
| +-->(OFF)--+ |
+-->(PINED)-------------+-->(ON)---+-------------------->+
| | | |
| +-->(OFF)--+ |
+-->(LOCKED)------------+-->(ON)---+-------------------->+
| | | |
| +-->(OFF)--+ |
+-->(PERSISTENT)--------+-->(ON)---+-------------------->+
| | | |
| +-->(OFF)--+ |
+-->(DESTROY_ON_CLOSE)--+-->(ON)---+-------------------->+
| |
+-->(OFF)--+
The TOOLBAR function can be used to change the toolbar status. Once the 'unique name' is entered, the Toolbar is treated as current until no different 'unique name' is used in TOOLBAR command.
NOTE: Suggested naming convention is to use a 'tlb_' prefix for Toolbar unique names.
CREATE A new Toolbar is created. If a Toolbar with same
'unique name' already exists the operation fails and
a warning message appears.
DEL_OLD A new Toolbar is created. If a Toolbar with same
'unique name' already exists it is overwritten with
a new one without any warning message.
DESTROY Destroys the current Toolbar. However, the Toolbar
Items contained in the Toolbar are not destroyed.
EDIT Opens a dialog in which Toolbar's properties
can be edited.
REMOVE_ITEM Removes an item from the current Toolbar. "Position"
indicates the item's sequence position in the
toolbar. Note, that a toolbar item can be removed
only by position; that's because one toolbar item
can be inserted more than once (multiple copies) in
a single toolbar.
CAPTION Sets the caption of the current Toolbar. Caption is
the text shown in the Toolbar's title bar.
RENAME Sets the Toolbar's new unique name. If a Toolbar
with the same unique name already exists, a warning
message box appears and the operation fails.
SHOW_AS_POPUP Shows the current Toolbar as a popup at the mouse
pointer position. The Toolbar is hidden when clicked
somewhere out of it.
FLOAT Causes the current Toolbar to become floating and
move to the (left, top) screen position; number of
columns is the desired number of Toolbar columns.
DOCK Docks the current Toolbar to desired dock-bar's row
and column. "From edge" indicates the distance of
the Toolbar (in pixels) from the dock-bar upper left
corner.
ON_RIGHT_CLICK Indicates the action which is executed after user
clicks the Toolbar empty area (where no Toolbar Item
lies) with the right mouse button. Default action is
"Wui_show_toolbar_context_menu".
VISIBLE Indicates if the current Toolbar is visible. The
default value is ON.
PINED Indicates if the current Toolbar is pined (the pin
box is checked).
LOCKED Indicates if the current Toolbar's content can be
modified.
PERSISTENT Indicates if the Toolbar is saved in "user_layout.m"
at exit. The default value is ON.
DESTROY_ON_CLOSE Indicates the behaviour of current Toolbar on
closing. The Toolbar can be hidden or
destroyed. The default value is OFF (do not
destroy). Tearoff Toolbars have the ON value set
until an Toolbar Item is moved from or to them.
NOTE: This qualifier is intented only for internal
usage, and it is not supported.
Examples:
TOOLBAR CREATE 'tlb_Draw' CAPTION 'My Drawing Toolbar' ENDNOTE: Although created, the Toolbar is not visible, yet. Use DOCK or FLOAT qualifiers to phisically create and show the Toolbar.
TOOLBAR 'tlb_Draw' DOCK LEFT 1 1 50 END
TOOLBAR_ITEM 'pob_Geo' ADD_TO_TOOLBAR 'tlb_Draw' 1 END
TOOLBAR 'tlb_Draw' FLOAT 300 200 1 ENDNOTE: 1 stands for the desired number of columns in floating Toolbar.
TOOLBAR 'tlb_Draw' CAPTION (DGETTEXT 'me10lt' 'Geometry') ENDUse CHANGE_LOCALE to change the ME10 localization language to see that the title of Toolbar 'tlb_Draw' is localized. The word 'Geometry' is contained in the 'me10lt' domain.
-->(TOOLBAR_CASCADE_TIME)---|number|--->
Use TOOLBAR_CASCADE_TIME function to set the delay used for auto opening of Toolbars submenus. The time can be any number of milliseconds between 0 and 1000. The default is 150.
+-----(CREATE)----+
+---(OVER_WRITE)--+ +-|unique name-+
| | | |
-->(TOOLBAR_ITEM)---+-----------------+--+--------------+--+
|
+-----------------------------------------+
|
+-->(DESTROY)------------------>(CONFIRM)------>+---------+---->
| |
+<--------------------------------------------------------+
+-->(EDIT)----------------------------------------------->+
+-->(CAPTION)------------------>|caption|---------------->+
+-->(RENAME)-------------->|new unique name|------------->+
+-->(ENABLED)--------+-->(ON)---+------------------------>+
| | | |
| +-->(OFF)--+ |
| |
| +-|toolbar uniq name|-+ |
+-->(ADD_TO_TOOLBAR)-+---------------------+->|position|->+
+->(ITEM_TYPE)-+-->(PUSH_BUTTON)-------------------+----->+
| | | |
| +-->(POPUP_BUTTON)->|unique_name|---+ |
| | | |
| +-->(CHECK_BOX)---------------------+ |
| | | |
| +-->(RADIO_BUTTON)------------------+ |
| | | |
| +-->(COMBO_EDIT)--------------------+ |
| | | |
| +-->(COMBO_LIST)--------------------+ |
| | | |
| +-->(STATIC_TEXT)-------------------+ |
+-->(SUBTYPE)----------->|-1..15|------------------------>+
+-->(TOOLTIP)------------>|string|----------------------->+
+-->(ON_ACTION)-------->|action_text|-------------------->+
+-->(ON_RIGHT_CLICK)--->|action_text|-------------------->+
| +--------------------------+ |
| | | |
+-->(IMAGE)--+--+-->|ascii_enqoded_data|---+------------->+
| | |
| +->(FROM_FILE)--|file name|----------------->+
| +----------->(NEW)-------------------------->+
| +----------->(EDIT)------------------------->+
| +---------->(DESTROY)----------------------->+
+-->(CATEGORY)-------->|string|-------------------------->+
+-->(PERSISTENT)-----+-->(ON)---+------------------------>+
| | | |
| +-->(OFF)--+ |
+-->(SET_VALUE)----+---->|string|-----+------------------>+
| +---->|number|-----+ |
| |
| +----------------------------+ |
| | ^ |
+-->(LIST_ADD)----+--+-------------+->|string|-+--------->+
| | | |
| | | |
| +->|position|-+ |
+-->(LIST_REMOVE)-- -+->|position|-+--------------------->+
| |
+--->(ALL)----+
The TOOLBAR_ITEM function can be used to create, edit and delete components that can be
inserted into Toolbars. Once the 'unique name' is entered the Toolbar Item is treated as
current until no different 'unique name' is used in TOOLBAR_ITEM command.
NOTE: A naming convention ussing the following prefixes for Toolbar Items unique names is suggested:
CREATE A new Toolbar Item is created. If a Toolbar Item
with the same 'unique name' already exists the
operation fails and a warning message appears.
OVER_WRITE If a Toolbar Item with 'unique name' already exists
it becomes the current Toolbar Item. If a Toolbar
with 'unique name' doesn't exist a new Toolbar Item
is created.
EDIT Opens a dialog in which Toolbar Item's properties
can be edited.
DESTROY Destroys the current Toolbar Item. It is removed
from all Toolbars to which it was added.
CAPTION Sets the caption of a toolbar item. For Command Button
this is the text displayed on it.
RENAME Sets the toolbar item new unique name. If a toolbar
item with the same unique name already exists the
operation fails.
ENABLED Sets the Toolbar Item enable state. The default
value is ON.
ADD_TO_TOOLBAR Add the Toolbar Item to current Toolbar. "Position"
indicates the Item's sequence position in
Toolbar. If position smaller or equal to one, then
the Item is inserted at the beginning of Toolbar. If
position is equal to the number of Toolbar Items,
then the Item is inserted at the end.
ITEM_TYPE Sets the type of Toolbar Item. The default type is
PUSH_BUTTON. Note: type can be dynamically changed.
PUSH_BUTTON Item type is Push Button.
POPUP_BUTTON Toolbar Item is Popup Button. When clicked the
Toolbar with the 'toolbar unique name' shows as a
submenu.
CHECK_BOX Toolbar Item is a check box. It can have two values:
0 - not checked, and 1 - checked (SET_VALUE).
RADIO_BUTTON Toolbar Item is radio button. Radio Button Items are
added with LIST_ADD and removed with LIST_REMOVE. Only
the first 16 items from the list are shown as Radio
Button Items. If a value different than 1..n is set
(SET_VALUE), where n is the number of items in list,
then no radio button is selected. Radio buttons can
also be selected by string from List (non localized).
COMBO_EDIT Toolbar Item is a editable combo box.
COMBO_LIST Toolbar Item is a non-editable combo box. If a value
different than 1..n is set (SET_VALUE), where n is
the number of items in list, then no combo list item
is selected. Items from Combo list can also be selected
by string from List (non localized).
STATIC_TEXT Toolbar Item is static text.
SUBTYPE Used by ME10 to recognize the special ME10 Toolbar
Items, like Color Combo Box. The default value is -1.
NOTE: This qualifier is intented only for internal
usage, and it is not supported.
TOOLTIP Sets the tooltip text. If "" then the tooltip is
also treated as ON_ACTION text.
ON_ACTION Indicates the action that is executed after: Push
Button is clicked, a list item is chosen from Combo
List, enter is pressed in Combo Edit, Radio Button
or a Check Box is clicked.
ON_RIGHT_CLICK Indicates the action executed after user clicks
Toolbar Item with the right mouse button. The
default action is
"Wui_show_toolbar_item_context_menu".
IMAGE Sets the image data. This data can be coded and
encoded just with the internal ME10 image
editor. The image is always stored to .mac file,
even if it was loaded from a .ico or .bmp file.
CATEGORY Sets the Toolbar Item's category. Used for grouping
Toolbar Items in Customize dialog window.
PERSISTENT Indicates if the Toolbar Item is saved in
"user_layout.m" at exit. The default value is ON.
SET_VALUE sets the Toolbar Item value. Numbers can be used for
CHECK BOX, RADIO BUTTON and COMBO LIST.
LIST_ADD Adds an entry to the Combo Box list. If Toolbar Item
type is RADIO_BUTTON the list holds information
about radio button items.
LIST_REMOVE Remove an entry from the Combo Box list.
Example:
TOOLBAR CREATE 'tlb_Colors' CAPTION 'My Colors' FLOAT 200 100 1 END
TOOLBAR_ITEM CREATE 'com_Colors' ITEM_TYPE COMBO_LIST ON_ACTION 'On_my_color_change'
LIST_ADD 'Red' 'Blue' 'Yellow' ADD_TO_TOOLBAR 'tlb_Colors' 1 END
DEFINE On_my_color_change
INQ_TOOLBAR_ITEM 'com_Colors'
LET RESULT (INQ 307) { string value of 'com_Colors' }
IF (RESULT = 'Red')
COLOR RED
END_IF
IF (RESULT = 'Blue')
COLOR BLUE
END_IF
IF (RESULT = 'Yellow')
COLOR YELLOW
END_IF
END_DEFINE
Add a Check Box from which the Combo List can be enabled or dissabled.
TOOLBAR_ITEM CREATE 'che_Colors' ITEM_TYPE CHECK_BOX
CAPTION 'Disable Color Selection' SET_VALUE 1 ON_ACTION 'On_my_colors_enable_disable'
ADD_TO_TOOLBAR 'tlb_Colors' 1 END
DEFINE On_my_colors_enable_disable
INQ_TOOLBAR_ITEM 'che_Colors'
LET RESULT (INQ 15) { number value of 'che_Colors' }
IF (RESULT = 1)
TOOLBAR_ITEM 'com_Colors' ENABLED ON END
TOOLBAR_ITEM 'che_Colors' CAPTION 'Disable Color Selection' END
END_IF
IF (RESULT = 0)
TOOLBAR_ITEM 'com_Colors' ENABLED OFF END
TOOLBAR_ITEM 'che_Colors' CAPTION 'Enable Color Selection' END
END_IF
END_DEFINE
Change the Combo List 'com_Colors' to Radio Button.
TOOLBAR_ITEM 'com_Colors' ITEM_TYPE RADIO_BUTTON END
---->(TOOLBAR_ITEMS_LIST)----|output_spec|---->
TOOLBAR_ITEMS_LIST outputs the names of all currently defined Toolbar Items to the specified destination.
-->(TOOLBAR_LAYOUT)--->-+--(RESET)----+---(CONFIRM)--+---->
+--(DESTROY)--+ +
+--(REFRESH)-----------------+
Use TOOLBAR_LAYOUT RESET to reset user interface to its default state.
Use TOOLBAR_LAYOUT DESTROY to destroy all Toolbars and Toolbar Items.
Use TOOLBAR_LAYOUT REFRESH to refresh the Toolbars and reload the content of Combo Box lists.
-->(TOOLBARS_LIST)----|output_spec|---->
TOOLBARS_LIST outputs the unique names of all currently defined Toolbars to the specified destination.
-->(TOOLBAR_LOAD)---+--(DEL_OLD)--+-----|file name|--->
| ^
+-------------+
TOOLBAR_LOAD includes Toolbars from file into current user interface layout. If DEL_OLD is used the current user intarface is deleted before new toolbars are loaded.
-->(TOOLBAR_SAVE)---+------(ALL)-----------------------------+--|file name|--->
| |
+-+-|toolbar unique name|--+--(TO_FILE)--+
^ |
+------------------------+
TOOLBAR_SAVE ALL stores the layout of the current user intarface to a file.
TOOLBAR_SAVE 'toolbar unique name' ... TO_FILE stores selected Toolbars to a file.
Note: When saving the toolbar layout no macros called as actions are saved. These macros should be handled separately by the user.
-->(TOOLBAR_TOOLTIPS)----+-->(ON)---+------>
| |
+-->(OFF)--+
The TOOLBAR_TOOLTIPS command switches the tooltip showing on or off. The default value is ON.
The screen-only version uses a mouse as the pointing device instead of a tablet and pen. All command menus, options, and interrupts can be found on the right side of the display.
Using the Toolbox:
The screen-only version provides a special window from which you can run, view, and administer macros. Up to 24 macros can be assigned to the Toolbox window and you can define any number of macro-sets that can be called into Toolbox.
The Toolbox window can also be repositioned. This is particularly useful when recording macros because you need to make all Toolbox commands visible.
To display the Toolbox window, click TOOLBOX (in the interrupt-function block).
Recording a Macro:
To start recording a macro:
The system stops recording the macro and displays the macro name in the box you assigned to it.
Running a Macro:
To run a macro, pick the macro name from the Toolbox window.
Renaming Macros:
To rename a macro:
Deleting Macros:
To delete a macro:
Editing Macros:
Once you have created a macro, you can modify its contents using the EDIT command. Type over the old values with the new and press RETURN/ENTER.
Loading Macro-Sets:
Although Toolbox lets you display a maximum of 24 macros, you can group macros together into a file. Each file can contain up to 24 macros that can be loaded by Toolbox. Pick INPUT and then specify a filename.
Moving Toolbox:
Repositioning the Toolbox window is particularly useful when working with other windows occupying the same position, for example, the CONSTRUCT window.
To reposition the Toolbox window:
Using the Toolbox with Viewports:
If you reposition the Toolbox into the current viewport, that viewport is 'blocked'. This means, for example, if you draw a rectangle in that viewport, the system does not display it (although it is still drawn). To prevent this effect, create a third and fourth viewport and position the Toolbox in either of these.
The additional viewports are available in the WINDOW menu.
Closing and Pinning Toolbox:
To close the Toolbox window, click [X].
To pin the Toolbox window to a fixed position, click the cross-arrows (the adjacent symbol changes to point horizontally to indicate that it is pinned). The next time you open the window, the window is displayed in the same position.
The Toolbox window is a fixed size. Although you can reposition it around the screen, you cannot change its size.
If you interrupt a command sequence, you must recall Toolbox from the main menu in order to get the original Toolbox menu back again.
---->(TRACE)---->+------------------>+---->+---->|string|---->+---->
| | | |
+---->(DEL_OLD)---->+ +------>(OFF)----->+
| |
+---->(APPEND)----->+
TRACE opens or closes the TRACE file. If a TRACE file is open, a copy of all tokens processed by the system (including macro bodies and expression results) is written there.
With OFF, the current TRACE file is closed. With a filename, the current TRACE file is closed and a new one with the given name is opened. The filename may specify a disk file or a device file.
TRACE files are useful for debugging macros or menus (send the output to your alpha screen, if you have one). Although they are text files, they are rarely readable by INPUT, since macro bodies appear directly after the macro name, and expression results directly after the expression.
---->(TRAP_ERROR)---->
Returns a string formed by stripping all leading and trailing blanks from the argument.
-->(TRIMMING)--+---(ON)----+--------->
| |
'---(OFF)---'
The "trimming flag" indicates how splines are to be split.
If TRIMMING is switched on, two totally new splines with separate mathematical behavior are computed. If you use STRETCH to modify both splines, you will obtain a sharp kink at the split point. Curve points beyond the visibility range are deleted.
---->(TRIM_ONE)-----+-----------+--->
| |
+---CHAIN---+
This command lets you trim or extend an element to intersect precisely with another element. The option CHAIN takes the last intersection element as the new intersection element.
Enter TRIM_ONE and identify the first element. Identify the intersecting element.
---->(TRIM_TWO)-----+-----------+--->
| |
+---CHAIN---+
This command lets you trim or extend two elements to intersect with each other. The option CHAIN takes the last second element as the new first element.
Enter TRIM_TWO and identify the first element. Then identify the next element.
Returns 1.
Drawings can be plotted (printed) to color output devices that are capable of producing color rastering. This feature is available on PostScript Level 2 printers and HPGL/2 printers. This means, for example, if you have access to an HP DesignJet 650C color printer you can print any number of colors up to the capability of the printer.
Truecolor plotting can be switched on or off with the command:
TRUE_COLOR_PLOTTING
You can change colors with the `rgb_color' command and then specify the intensities you want.
If you plot to a pen-plotter, switch off truecolor plotting. This is because the pen-plotter cannot correctly assign colors (rastered) to pens.
Returns the argument value truncated to its integer part. TRUNC -3.7 is -3.
+->-(CURRENT_PART)-+
| |
(TR_ASSIGN)-|ltab_name|-+->-|TR_name|-+->-----|point|----+---->
| | |
+-<--(UNDO)---+-<----------------+
| |
+-<------------------------------+
Assign a test reference (INFO attribute) to a text string on the current drawing.
You use the ASSIGN command typically when you are creating a template for a standard title block.
This command does NOT retrieve any data from DMS, it simply assigns a text reference to a selected text in the drawing.
This command is often followed by the TR_UPDATE command to update the assigned texts in the drawing with the data in the database referenced by the text references.
You must specify a logical table where you want your text references to be placed.
Enter the name of the text reference or choose it from the table and then identify the selected text in the drawing.
Use UNDO to undo the last selection.
(TR_CHANGE_CASE_CONV)---+->-|UPPER|---+---+->-|point|--+--->
| | | |
+->-|LOWER|---+ +-<-(UNDO)---+
| | | |
+->--|OFF|----+ +-<----------+
This command changes the character case-convention rule for an existing text reference (TR).
You are first prompted to select one of three settings, UPPER, LOWER, or OFF. Choosing UPPER means the data referenced by a TR is to be converted to upper case. Choosing LOWER would do the opposite. OFF means no case-conversion is done.
You are then prompted for the assigned text whose case-conversion rule you want to change.
(TR_CHANGE_LINES)------|number|-------+->-|point|--+--->
| |
+-<-(UNDO)---+
| |
+-<----------+
This command changes the maximum number of lines to be displayed for an existing text reference (TR).
You are first prompted to input a number for the maximum number of lines to be displayed.
If you specify 0, no lines will be dislayed.
If your data is longer than the space available (width plus the number of lines) then the data is truncated when it is displayed.
The way to wrap data to subsequent lines is specified by the setting of WORD_WRAP (see the TR_WORD_WRAP command).
You are then prompted for the assigned text whose number of lines you would like to change.
(TR_CHANGE_PRECISION)---|number|------+->-|point|--+--->
| |
+-<-(UNDO)---+
| |
+-<----------+
This command changes the maximum number of decimal places allowed in an existing text reference (TR).
You are first prompted to input a number for the maximum number of decimal places allowed.
This command is only valid for TRs with numeric data.
If a numeric value has less decimal places than specified by 'number', then additional "0"s are appended to the end.
You are then prompted to select the assigned text for this change.
(TR_CHANGE_WIDTH)--+->-|number|--+----+->-|point|--+--->
| | | |
+->--(ALL)----+ +-<-(UNDO)---+
| |
+-<----------+
This command changes the maximum number of characters allowed per line of an existing text reference (TR).
You are first prompted for a number to specify the maximum number of characters in each line of a TR.
If you specify ALL, then all the data is displayed on one line.
The new width specified, along with the values specified for the LINES and PRECISION options, determine the actual number of characters displayed.
You are then prompted for the assigned text whose width you want to change.
->(TR_CHANGE_WORD_WRAP)---+->--(ON)-----+---+->-|point|--+--->
| | | |
+->--(OFF)----+ +-<-(UNDO)---+
This command changes the word wrap rule for an existing text reference (TR).
You are first prompted to input either ON or OFF for the word wrap rule.
If you specify ON, the data reference by the TR is wrapped to the following lines when the data exceeds the width value. Wrapping is done in whole-word increments.
If you specify OFF, no word wrapping is done and the data displayed will be exactly the WIDTH value long.
You are then prompted for the assigned text whose word-wrap rule you want to change.
TR_EXTRACT_VALUE extracts the value of all the text elements which reference the source logical table and places the results in the destination logical table. The first column of the logical table contains the text reference from the INFO, the second contains the actual text string visible in ME 10/30.
TR_EXTRACT_VALUE will be used by the BOM Formatter to extract position numbers from the drawing and place them in a logical table for manipulation.
If the first column of the destination table already contains the text reference from the INFO string, then the ME 10 text with that INFO is placed in the second column of that row. If more than one reference to the INFO string is made, only one of the text values will be copied into the logical table. If more than one copy of the INFO string is in the destination logical table, all the copies will have the text value attached to them. If the text reference from the INFO string is not in the table, it is appended to the table.
->(TR_SET_CASE_CONV)---+->-(UPPER)---+--->
| |
+->-(LOWER)---+
| |
+->--(OFF)----+
This command sets the character case-convention rule for all subsequebtly assigned text references (TRs).
You are prompted to select one of three settings, UPPER, LOWER, or OFF. Choosing UPPER means the data referenced by a TR is to be converted to upper case. Choosing LOWER would do the opposite. OFF means no case-conversion is done.
Case conversion defaults to OFF when you first start the system.
->(TR_SET_LINES)--------|number|------>
This command sets the maximum number of lines to be displayed for all subsequently assigned text references (TRs).
You are prompted to input a number for the maximum number of lines to be displayed.
If you specify 0, no lines will be dislayed.
If your data is longer than the space available (width plus the number of lines) then the data is truncated when it is displayed.
The way to wrap data to subsequent lines is specified by the setting of WORD_WRAP (see the TR_WORD_WRAP command).
Lines is defaulted to 1 when you first start the system.
->(TR_SET_PRECISION)-----|number|----->
This command sets the maximum number of decimal places allowed in all subsequently assigned text references (TRs).
You are prompted to input a number for the maximum number of decimal places allowed.
This command is only valid for TRs with numeric data.
If a numeric value has less decimal places than specified by 'number', then additional "0"s are appended to the end.
->(TR_SET_WIDTH)----+->-|number|--+--->
| |
+->--(ALL)----+
This command sets the maximum number of characters allowed per line of all subsequently assigned text references (TRs).
You are prompted for a number to specify the maximum number of characters in each line of a TR.
If you specify ALL, then all the data is displayed on one line.
The new width specified, along with the values specified for the LINES and PRECISION options, determine the actual number of characters displayed.
Width defaults to ALL when you first start the system.
->(TR_SET_WORD_WRAP)---+->-(ON)----+--->
| |
+->-(OFF)---+
This command sets the word wrap rule for all subsequently assigned text references (TRs).
You are prompted to input either ON or OFF for the word wrap rule.
If you specify ON, the data reference by the TR is wrapped to the following lines when the data exceeds the width value. Wrapping is done in whole-word increments.
If you specify OFF, no word wrapping is done and the data displayed will be exactly the WIDTH value long.
The word wrap rule defaults to ON when you first start the system.
->(TR_SHOW)---|display table|---+----------->|logical table|---------+->
| |
+->-(SELECT)-+->|point|-+->(CONFIRM)-+
| |
+----<-----+
This command displays the information about text references (TRs) in the current drawing in the specified display table so that you can check if the data is exactly as required.
Enter the name of a referenced logical table to show all TRs to that table.
Use the SELECT option to show information about a specific TR.
The information displayed in the table will include the name of the text references and their formats (case-conversions, lines, precision, width and word wrap).
+--->-(CURRENT_PART)---+
| |
(TR_UNASSIGN)--+--->-|point|----------+---->
| |
+---<-(UNDO)----<------+
| |
+---<-----------<------+
This command does the opposite of the TR_ASSIGN comamnd. You can use the TR_UNASSIGN command to remove a text reference from a referenced text in the current drawing.
+-<--------------+
| |
->(TR_UPDATE)--+->--------------+---+->-|ltab_name|--+--->
| | | |
+->---|point|----+ +->--------------+
| |
+->-|column #|---+
| |
+->--(CURRENT)---+
This command updates Title Block text references in the current drawing.
Returns the type of the token specified. The possible return values are:
COMMAND
FUNCTION
QUALIFIER
PSEUDO_COMMAND
SYMBOL
STRING
NUMBER
PNT
PNT3
ILLEGAL
Example:
DEFINE A 1,1 END_DEFINE
or
LET A 1,1
define exactly the same A
DISPLAY (TYPE A) returns PNT in both cases because the macro A will be evaluated. If the macro A contains more than one "value", TYPE A will return the wrong result because the system evaluates the macro and produces a sequence of items.
Example :
DEFINE A LINE 0,0 10,10 END_DEFINE
Whenever A is typed, it is evaluated to "LINE 0,0 10,10" as expected , but in the case of DISPLAY (TYPE A) the macro A will also be evaluated and will produce a DISPLAY (TYPE LINE 0,0 10,10) sequence that, of course, will fail because the system expects a closing bracket after the LINE command. As the macro language does NOT supply a mechanism to suppress macro evaluation, every macro will always be evaluated as mentioned above. Therefore the TYPE function only makes sense if it is applied to macros that represent a single value (e.g. a point, a string etc.)