These commands help you handle 2D groups. A 2D group is a set of 2D drawing elements (lines, dimensions, hatches, texts etc.) which are not independent but they form an unchangeable constellation. Groups can be embedded into each other hierarchically. There are a lot of pre-defined 2D groups and you can create your owns, too. The 2D groups, similar to other objects, are stored in files with the extension .oli which are referenced in this chapter as .oli files. These command also let you create new hatch patterns and line types.
POSITION GROUP
POSITION GROUP path <coord> ENTER
It places the selected 2D group on the drawing. The desired group can be selected with its file path which has the following format: "the file path of the group containing .oli" \ "the name of the group".
path (str): the path of the group
coord (point): the location of the group's reference point
e.g.: #POSITION GROUP C:\ArchLine.XP2023\Oli\Group\Cars\Car.oli\Porsche_911_DS 0 0;
-It places the pre-defined 2D group 'Porsche 911 DS' on the drawing's origin. (If the program is installed into the directory C:\ArchLine.XP2007.)
NOTE: The name of custom created groups can be arbitrary but the name of pre-defined objects is usually not identically to what's displayed in the program. (The displayed name is dependent on the installing language.)
ROTATE
POSITION GROUP path ROTATE <coord {coord2 | XANGLE ang}> ENTER
It places the selected 2D group on the drawing then rotates it around the reference point. The angle of the rotation can be defined by a point or numerically, by using the keyword XANGLE. The desired group can be selected with its file path which has the following format: "the file path of the group containing .oli" \ "the name of the group".
path (str): the path of the group
coord (point): the location of the group's reference point
coord2 (point): a point to define the rotation. 0 degree is always in the horizontal right direction and the angle of the rotation will be the angle between 0 degree and the line connecting coord and coord2.
ang (real): the angle of the rotation.
e.g.: #POSITION GROUP C:\ArchLine.XP2007\Oli\Group\Cars\Car.oli\Porsche_911_DS 0 0;
-It places the pre-defined 2D group 'Porsche 911 DS' on the drawing's origin. (If the program is installed into the directory C:\ArchLine.XP2007.)
NOTE: The name of custom created groups can be arbitrary but the name of pre-defined objects is usually not identically to what's displayed in the program. (The displayed name is dependent on the installing language.)
GROUPDEF
GROUPDEF <obj> ENTER <ref_point> ENTER
It creates a 2D group from the selected objects and saves it for latter use. You can add arbitrary number of possible reference points but the default will be which was selected first. After selecting the objects and pointing on the reference points you have to give the name of the group and select the containing .oli file. This can be done via two dialogboxes.
obj (obj): object which will be a part of the 2D group
ref_point (point): a reference point of the 2D group
e.g.: #LINE 10 10 10 15 12.5 19 15 15 10 15 15 10 15 15 10 10 15 10;; #GROUPDEF 10 11 11 16 14 16 12.5 15 11 11 14 11 12.5 10 15 11; 10 10 12.5 12.5;
-It creates a group from the newly created lines which form a small 'house'. The reference points will be the bottom left corner and the intersection point of the diagonal. After executing the command you have to give the name and the storing .oli of the group.
USERPATTERN
GROUPDEF USERPATTERN <obj> ENTER <ref_point> ENTER
This command creates a new hatch pattern which can be used later in hatchings. The group can be defined in the same way as a normal 2D group – first select the objects building up the group then locate the reference points – but after naming the group you don't have to define the storing place but in an other dialogwindow you have to give a name to the pattern, too.
obj (obj): the objects making up the group
ref_point (point): reference points of the group
CLINE
GROUPDEF CLINE <obj> ENTER <ref_point> ENTER
It creates a new line type from a 2D group. The group can be defined as usual: first select the objects of the group then locate the reference points. The naming of the new line type and the defining of the other settings can be done in a dialogwindow.
obj (obj): the objects making up the group
ref_point (point): reference points of the group
GROUP
GROUP name <obj> [ADDHOTSPOT <hotspot>]ENTER
It creates a group from the selected object with the given name. You can add reference points to your group with the ADDHOTSPOT keyword. The difference between GROUPDEF and GROUP is that the groups created with GROUP cannot be inserted later into the drawing with the POSITION GROUP command.
name (str): the name of the group
obj (obj): the elements of the group
hotspot (point): a reference point of the group.
DUPLICATE
GROUP DUPLICATE {coord1 coord2 | SPOLYGON $polyline_def$} ref_point
It creates a group from the items found in the selection window (defined by the two opposite corner of the rectangle, or with a polygon). The group will be placed on the clipboard and can be inserted later. The selected items remain independent.
coord1, coord2 (point): corners of the selecting rectangle
$polyline_def$: definition of a polyline. See it in the chapter Definitions.
ref_point (point): the reference point of the newly created group
EXPLODE
EXPLODE <group> ENTER
This command is used for exploding groups. This means it creates 2D objects (lines, hatches etc.) from a group. Since groups can be embedded into each other, this command doesn't create always primitives but it disjoints only the top level. This has no effect on the saved group pattern only on the selected instance.
group (obj): the group to be exploded
MOVEOBJECT
MOVEOBJECT [{TOP | [<BACKWARD>] source ENTER}] <obj> ENTER coord [{TOP | [<BACKWARD>] dest}] coord2
This command is used for moving a part of a group into another group. TOP and BACKWARD keywords are used for navigating between embedded groups. TOP jumps to the top level, BACKWARD steps one level up. If you are on the top level no source or destination group should be selected because it’s the drawing itself. The command has no effect on the saved group pattern, only on the selected instance.
source (obj): the source group
obj (obj): the parts to be moved
coord (point): the origin of the selected parts (this will be the reference point when locating the new place)
dest (obj): the destination group
coord2 (point): the place of the moved parts
SENT
SENT [{TOP | [<BACKWARD>] source ENTER}] <obj> ENTER coord [{TOP | [<BACKWARD>] dest}] coord2
This command is used for copying a part of a group into another group. TOP and BACKWARD keywords are used for navigating between embedded groups. TOP jumps to the top level, BACKWARD steps one level up. If you are on the top level no source or destination group should be selected because it’s the drawing itself. The command has no effect on the saved group pattern, only on the selected instance.
source (obj): the source group
obj (obj): the parts to be copied
coord (point): the origin of the selected parts (this will be the reference point when locating the new place)
dest (obj): the destination group
coord2 (point): the place of the copy
ACTGROUP
ACTGROUP group
It selects the actual group level. (In the hierarchically embedded scheme.)
group (obj): a group which will be the actual level
TOP
ACTGROUP TOP
This command sets the drawing as the actual group level.
BACKWARD
ACTGROUP BACKWARD
This command steps one level upper in the group hierarchy scheme.
ADDINTEGER
ADDINTEGER <param_name value group ENTER> ENTER
It adds a new integer type parameter to the group. Parameters can be displayed by placing a text into the group. The text should consist of the $ character and the name of the parameter. Parameters and displaying texts are independent: the added parameter lives when it's not displayed and texts beginning with $ can be added without a parameter behind it. The parameters of the group can be viewed with the 'query item' button.
param_name (str): the name of the parameter (not including the $ character!)
value (int): the value of the parameter
group (obj): the group the parameter will be added to
ADDREAL
ADDREAL <param_name value group ENTER> ENTER
It adds a new real type parameter to the group. Parameters can be displayed by placing a text into the group. The text should consist of the $ character and the name of the parameter. Parameters and displaying texts are independent: the added parameter lives when it's not displayed and texts beginning with $ can be added without a parameter behind it. The parameters of the group can be viewed with the 'query item' button.
param_name (str): the name of the parameter (not including the $ character!)
value (int): the value of the parameter
group (obj): the group the parameter will be added to
ADDSTRING
ADDSTRING <param_name value group ENTER> ENTER
It adds a new string type parameter to the group. Parameters can be displayed by placing a text into the group. The text should consist of the $ character and the name of the parameter. Parameters and displaying texts are independent: the added parameter lives when it's not displayed and texts beginning with $ can be added without a parameter behind it. The parameters of the group can be viewed with the 'query item' button.
param_name (str): the name of the parameter (not including the $ character!)
value (int): the value of the parameter
group (obj): the group the parameter will be added to
MODPARAMETER
MODPARAMETER <param_name group ENTER value> ENTER
It modifies the selected parameter's value. The type of the parameter and the type of the entered value is not compared, if it's necessary an automatic conversion happens.
param_name (str): the name of the parameter
group (obj): the group of which parameter is modified
value (str | int | real): the new value of the parameter
DELETEPAR
DELETEPAR <param_name group ENTER> ENTER
It deletes the selected parameter from a group.
param_name (str): the name of the parameter
group (obj): the group the parameter will be deleted from
NOTE: In the group parameter handling commands the selection of the group doesn’t work with giving a nearby point!
e.g.: #LINE 10 10 20 10;; #TEXT LOOP "$name" 12 10.5 "$val" 18 10.5; #GROUP "example" 5 15 25 5; #ADDREAL val 10 5 15 25 5;; #ADDSTRING name "Length:" 5 15 25 5;;
-Now in the drawing the group contains a line, and the text: Length: 10.00. Type the following command:
#MODPARAMETER name 5 15 25 5; "Width:" val 5 15 25 5; 0.01;;
-The display changes and now the label of the line will be Width: 0.010.
e.g.: #LINE 10 10 20 10;; #TEXT LOOP "$length" 12 10.5 "$val" 18 10.5; #GROUP "example" 5 15 25 5; #ADDREAL val 10 5 15 25 5;; #ADDSTRING length "Length:" 5 15 25 5;; #ADDSTRING width "Width:" 5 15 25 5;;
-Now in the drawing the group contains a line, and the text: Length: 10.00.
Step into the group (#ACTGROUP 15 10;), change the text to $width (right click and modify), return to top level (#ACTGROUP TOP) and type: #MODPARAMETER val 5 15 25 5; 0.01;
-The label changes as in the previous example.
GROUPPARAMETER
GROUPPARAMETER {ON | OFF | FORMAL}
This command switches between the group parameter display modes. ON means the value of each parameter will be displayed. FORMAL displays the names of the parameters (the one beginning with $) and OFF turns off any displaying.
Comments
0 comments
Article is closed for comments.