UDAR

*UDAR, udar_name, b_opt, body_nr, mat_nr, layer_nr, x, y, orient_ang;

User defined area for primitives of mass bodies and anchors

User defined areas are defined within an *UDAR and *ENDUDAR command sequence.
The *UDAR command defines primitive settings, the start point coordinate and the orientation angle.
It follows a series of commands for the outer lines which are either:
a) Straight lines (see LINE command)
b) Circular arcs (see CARC command) or
c) Bezier curves (see BCUR command).
User defined areas are closed by the *ENDUDAR command. The command creates a straight line to the starting point unless the end point of the last line is identical to the start point.
*FOR-loops and *IF-conditions are supported as shown in the following example.

Input Data⚓︎

Parameter	Description
`udar_name`	Reference name of the primitive (can be empty) → Alphanumeric name, has to start with a letter
`b_opt`	Type of the Boolean operation `add` → Add a primitive to the mass body or anchor `sub` → Subtract a primitive from a mass body or anchor
`body_nr`	Reference number of related mass body or anchor → If 0, the primitive is related to anchors → If > 0, the primitive is related to the specified mass body
`mat_nr`	Reference number of the material properties → Use existing material properties only (see MATP command)
`layer_nr`	Layer number (the current version supports only one layer) → If empty, the primitive is part of the first layer
`x`	X-coordinate of the connecting point (starting point) of the user defined area
`y`	Y-coordinate of the connecting point (starting point) of the user defined area
`orient_ang`	Orientation angle in degrees at the connecting point: 0 ≤ `orient_ang` < 360

LINE, x, y;

Parameter	Description
`x`	X-coordinate of the end point of a straight line
`y`	Y-coordinate of the end point of a straight line

CARC, xm, ym, phi;

Parameter	Description
`xm`	X-coordinate of the center point of a circular arc
`ym`	Y-coordinate of the center point of a circular arc
`phi`	Span angle of the circular arc, -360 < `phi` < +360 → > 0, counter clockwise arc → < 0, clockwise arc

CARC, x, y, xt, yt;

Parameter	Description
`x`	X-coordinate of the end point of a circular arc
`y`	Y-coordinate of the end point of a circular arc
`xt`	X-coordinate of the tangent point of a circular arc
`yt`	Y-coordinate of the tangent point of a circular arc

BCUR, x, y, x_cp1, y_cp1, x_cp2, y_cp2;

Parameter	Description
`x`	X-coordinate of the end point of the Bezier curve
`y`	Y-coordinate of the end point of the Bezier curve
`x_cp1`	X-coordinate of the first control point → If empty, default values will be used
`y_cp1`	Y-coordinate of the first control point → If empty, default values will be used
`x_cp2`	X-coordinate of the second control point → If empty, default values will be used
`y_cp2`	Y-coordinate of the second control point → If empty, default values will be used

*ENDUDAR

Example of a user defined area with *FOR-loops:

PARA, numb= 4;
PARA, ampl =10; 
*UDAR,,add,1,1,1,-100,150,0           % Start point 
    LINE, -50,150;                       % Straight line
    CARC, -50,130,-90;                   % Circular arc
    BCUR,   0,120,-10,130,-20,120;       % Bezier curve
    LINE,  30,130; 
    LINE,  30,100;
    *FOR,lines,1,numb                    % Bezier curves
        BCUR, 30-(100+30)*lines/numb,100+ampl*sin(2*pi*lines/numb);
    *ENDFOR
*ENDUDAR                              % Close the area

The same example without *FOR-loops:

*UDAR,, add,1,1,1,-100,150,0       % Start point    
    LINE,  -50,150;                   % Straight line
    CARC,  -50,130,-90;               % Circular arc
    BCUR,    0,120,-10,130,-20,120;   % Bezier curve with
    LINE,   30,130;                   % control points
    LINE,   30,100;
    BCUR, -2.5,110;                   % Bezier curves 
    BCUR,  -35,100;                   % no control points
    BCUR,-67.5, 90;   
    BCUR, -100,100;                        
*ENDUDAR

Figure 1. Example of a user defined area in the SKETCHER Interface

Figure 2. Example of a user defined area in the MODELBUILDER