The Seatbelt2D class gives you access to 4 noded (2D) element seatbelt cards in PRIMER. More...
The PRIMER JavaScript API provides many class constants, properties and methods. For Arup to
be able to extend and enhance the API in the future any constant, property or method names beginning with a lowercase
or uppercase letter are reserved.
If you need to add your own properties or methods to one of the existing classes then to avoid any potential future conflict you
should ensure that the name begins with either an underscore (_) or a dollar sign ($) or the name is prefixed with your
own unique identifier.
For example if company 'ABC' need to add a property called 'example' then to avoid any potential future conflict use one of:
| Name | Type | Description |
| colour | Colour | The colour of the seatbelt |
| eid | integer | Seatbelt2D number. Also see the label property which is an alternative name for this. |
| exists (read only) | logical | true if seatbelt exists, false if referred to but not defined. |
| include | integer | The Include file number that the seatbelt is in. |
| label | integer | Seatbelt2D number. Also see the eid property which is an alternative name for this. |
| model (read only) | integer | The Model number that the seatbelt is in. |
| n1 | integer | Node 1 ID |
| n2 | integer | Node 2 ID |
| n3 | integer | Node 3 ID |
| n4 | integer | Node 4 ID |
| pid | integer | Part ID |
| sbrid | integer | Retractor ID |
| slen | real | Initial slack length |
| transparency | integer | The transparency of the seatbelt (0-100) 0% is opaque, 100% is transparent. |
Detailed DescriptionThe Seatbelt2D class allows you to create, modify, edit and manipulate 4 noded element seatbelt cards. See the documentation below for more details. |
Constructornew Seatbelt2D(Model[Model], eid[integer], pid[integer], n1[integer], n2[integer], n3[integer], n4[integer])DescriptionCreate a new Seatbelt2D object. |
Model that seatbelt will be created in
Seatbelt ID.
Part number.
Node 1 ID
Node 2 ID
Node 3 ID
Node 4 ID
ReturnsSeatbelt2D object Return typeSeatbelt2D |
ExampleTo create a new 4 noded element seatbelt in model m with label 100, part 10 and nodes 20, 21, 22, 23: var a = new Seatbelt2D(m, 100, 10, 20, 21, 22, 23);
|
Details of functionsAssociateComment(Comment[Comment])DescriptionAssociates a comment with a seatbelt. |
Comment that will be attached to the seatbelt
ReturnsNo return value |
ExampleTo associate comment c to the seatbelt s: s.AssociateComment(c);
|
Blank()DescriptionBlanks the seatbelt |
No arguments
ReturnsNo return value |
ExampleTo blank seatbelt s: s.Blank();
|
BlankAll(Model[Model], redraw (optional)[boolean]) [static]DescriptionBlanks all of the seatbelts in the model. |
Model that all seatbelts will be blanked in
If model should be redrawn or not. If omitted redraw is false. If you want to do several (un)blanks and only redraw after the last one then use false for all redraws apart from the last one. Alternatively you can redraw using View.Redraw().
ReturnsNo return value |
ExampleTo blank all of the seatbelts in model m: Seatbelt2D.BlankAll(m);
|
BlankFlagged(Model[Model], flag[Flag], redraw (optional)[boolean]) [static]DescriptionBlanks all of the flagged seatbelts in the model. |
Model that all the flagged seatbelts will be blanked in
Flag set on the seatbelts that you want to blank
If model should be redrawn or not. If omitted redraw is false. If you want to do several (un)blanks and only redraw after the last one then use false for all redraws apart from the last one. Alternatively you can redraw using View.Redraw().
ReturnsNo return value |
ExampleTo blank all of the seatbelts in model m flagged with f: Seatbelt2D.BlankFlagged(m, f);
|
Blanked()DescriptionChecks if the seatbelt is blanked or not. |
No arguments
Returnstrue if blanked, false if not. Return typeBoolean |
ExampleTo check if seatbelt s is blanked: if (s.Blanked() ) do_something...
|
Browse(modal (optional)[boolean])DescriptionStarts an edit panel in Browse mode. |
If this window is modal (blocks the user from doing anything else in PRIMER until this window is dismissed). If omitted the window will be modal.
Returnsno return value |
ExampleTo Browse seatbelt s: s.Browse();
|
ClearFlag(flag[Flag])DescriptionClears a flag on the seatbelt. |
Flag to clear on the seatbelt
ReturnsNo return value |
ExampleTo clear flag f for seatbelt s: s.ClearFlag(f);
|
Copy(range (optional)[boolean])DescriptionCopies the seatbelt. The target include of the copied seatbelt can be set using Options.copy_target_include. |
If you want to keep the copied item in the range specified for the current include. Default value is false. To set current include, use Include.MakeCurrentLayer().
ReturnsSeatbelt2D object Return typeSeatbelt2D |
ExampleTo copy seatbelt s into seatbelt z: var z = s.Copy();
|
Create(Model[Model], modal (optional)[boolean]) [static]DescriptionStarts an interactive editing panel to create a seatbelt |
Model that the seatbelt will be created in.
If this window is modal (blocks the user from doing anything else in PRIMER until this window is dismissed). If omitted the window will be modal.
ReturnsSeatbelt2D object (or null if not made). Return typeSeatbelt2D |
ExampleTo start creating a seatbelt in model m: var s = Seatbelt2D.Create(m);
|
DetachComment(Comment[Comment])DescriptionDetaches a comment from a seatbelt. |
Comment that will be detached from the seatbelt
ReturnsNo return value |
ExampleTo detach comment c from the seatbelt s: s.DetachComment(c);
|
Edit(modal (optional)[boolean])DescriptionStarts an interactive editing panel. |
If this window is modal (blocks the user from doing anything else in PRIMER until this window is dismissed). If omitted the window will be modal.
Returnsno return value |
ExampleTo Edit seatbelt s: s.Edit();
|
Error(message[string], details (optional)[string])DescriptionAdds an error for seatbelt. For more details on checking see the Check class. |
The error message to give
An optional detailed error message
ReturnsNo return value |
ExampleTo add an error message "My custom error" for seatbelt s: s.Error("My custom error");
|
ExtractColour()DescriptionExtracts the actual colour used for seatbelt. |
No arguments
Returnscolour value (integer) Return typeNumber |
ExampleTo return the colour used for drawing seatbelt s: var colour = s.ExtractColour();
|
First(Model[Model]) [static]DescriptionReturns the first seatbelt in the model. |
Model to get first seatbelt in
ReturnsSeatbelt2D object (or null if there are no seatbelts in the model). Return typeSeatbelt2D |
ExampleTo get the first seatbelt in model m: var s = Seatbelt2D.First(m);
|
FirstFreeLabel(Model[Model], layer (optional)[Include number]) [static]DescriptionReturns the first free seatbelt label in the model. Also see Seatbelt2D.LastFreeLabel(), Seatbelt2D.NextFreeLabel() and Model.FirstFreeItemLabel(). |
Model to get first free seatbelt label in
Include file (0 for the main file) to search for labels in (Equivalent to First free in layer in editing panels). If omitted the whole model will be used (Equivalent to First free in editing panels).
ReturnsSeatbelt2D label. Return typeNumber |
ExampleTo get the first free seatbelt label in model m: var label = Seatbelt2D.FirstFreeLabel(m);
|
FlagAll(Model[Model], flag[Flag]) [static]DescriptionFlags all of the seatbelts in the model with a defined flag. |
Model that all seatbelts will be flagged in
Flag to set on the seatbelts
ReturnsNo return value |
ExampleTo flag all of the seatbelts with flag f in model m: Seatbelt2D.FlagAll(m, f);
|
Flagged(flag[Flag])DescriptionChecks if the seatbelt is flagged or not. |
Flag to test on the seatbelt
Returnstrue if flagged, false if not. Return typeBoolean |
ExampleTo check if seatbelt s has flag f set on it: if (s.Flagged(f) ) do_something...
|
ForEach(Model[Model], func[function], extra (optional)[any]) [static]DescriptionCalls a function for each seatbelt in the model. |
Model that all seatbelts are in
Function to call for each seatbelt
An optional extra object/array/string etc that will appended to arguments when calling the function
ReturnsNo return value |
GetAll(Model[Model], property (optional)[string]) [static]DescriptionReturns an array of Seatbelt2D objects or properties for all of the seatbelts in a model in PRIMER. If the optional property argument is not given then an array of Seatbelt2D objects is returned. If the property argument is given, that property value for each seatbelt is returned in the array instead of a Seatbelt2D object |
Model to get seatbelts from
Name for property to get for all seatbelts in the model
ReturnsArray of Seatbelt2D objects or properties Return typeArray |
GetComments()DescriptionExtracts the comments associated to a seatbelt. |
No arguments
ReturnsArray of Comment objects (or null if there are no comments associated to the node). Return typeArray |
ExampleTo get the array of comments associated to the seatbelt s: var comm_array = s.GetComments();
|
GetFlagged(Model[Model], flag[Flag], property (optional)[string]) [static]DescriptionReturns an array of Seatbelt2D objects for all of the flagged seatbelts in a model in PRIMER If the optional property argument is not given then an array of Seatbelt2D objects is returned. If the property argument is given, then that property value for each seatbelt is returned in the array instead of a Seatbelt2D object |
Model to get seatbelts from
Flag set on the seatbelts that you want to retrieve
Name for property to get for all flagged seatbelts in the model
ReturnsArray of Seatbelt2D objects or properties Return typeArray |
GetFromID(Model[Model], number[integer]) [static]DescriptionReturns the Seatbelt2D object for a seatbelt ID. |
Model to find the seatbelt in
number of the seatbelt you want the Seatbelt2D object for
ReturnsSeatbelt2D object (or null if seatbelt does not exist). Return typeSeatbelt2D |
ExampleTo get the Seatbelt2D object for seatbelt 100 in model m var s = Seatbelt2D.GetFromID(m, 100);
|
GetParameter(prop[string])DescriptionChecks if a Seatbelt2D property is a parameter or not. Note that object properties that are parameters are normally returned as the integer or float parameter values as that is virtually always what the user would want. For this function to work the JavaScript interpreter must use the parameter name instead of the value. This can be done by setting the Options.property_parameter_names option to true before calling the function and then resetting it to false afterwards.. This behaviour can also temporarily be switched by using the Seatbelt2D.ViewParameters() method and 'method chaining' (see the examples below). |
seatbelt property to get parameter for
ReturnsParameter object if property is a parameter, null if not. Return typeParameter |
Keyword()DescriptionReturns the keyword for this seatbelt (*ELEMENT_SEATBELT) Note that a carriage return is not added. See also Seatbelt2D.KeywordCards() |
No arguments
Returnsstring containing the keyword. Return typeString |
ExampleTo get the keyword for seatbelt s: var key = s.Keyword();
|
KeywordCards()DescriptionReturns the keyword cards for the seatbelt. Note that a carriage return is not added. See also Seatbelt2D.Keyword() |
No arguments
Returnsstring containing the cards. Return typeString |
ExampleTo get the cards for seatbelt s: var cards = s.KeywordCards();
|
Last(Model[Model]) [static]DescriptionReturns the last seatbelt in the model. |
Model to get last seatbelt in
ReturnsSeatbelt2D object (or null if there are no seatbelts in the model). Return typeSeatbelt2D |
ExampleTo get the last seatbelt in model m: var s = Seatbelt2D.Last(m);
|
LastFreeLabel(Model[Model], layer (optional)[Include number]) [static]DescriptionReturns the last free seatbelt label in the model. Also see Seatbelt2D.FirstFreeLabel(), Seatbelt2D.NextFreeLabel() and see Model.LastFreeItemLabel() |
Model to get last free seatbelt label in
Include file (0 for the main file) to search for labels in (Equivalent to Highest free in layer in editing panels). If omitted the whole model will be used.
ReturnsSeatbelt2D label. Return typeNumber |
ExampleTo get the last free seatbelt label in model m: var label = Seatbelt2D.LastFreeLabel(m);
|
Next()DescriptionReturns the next seatbelt in the model. |
No arguments
ReturnsSeatbelt2D object (or null if there are no more seatbelts in the model). Return typeSeatbelt2D |
ExampleTo get the seatbelt in model m after seatbelt s: var s = s.Next();
|
NextFreeLabel(Model[Model], layer (optional)[Include number]) [static]DescriptionReturns the next free (highest+1) seatbelt label in the model. Also see Seatbelt2D.FirstFreeLabel(), Seatbelt2D.LastFreeLabel() and Model.NextFreeItemLabel() |
Model to get next free seatbelt label in
Include file (0 for the main file) to search for labels in (Equivalent to Highest+1 in layer in editing panels). If omitted the whole model will be used (Equivalent to Highest+1 in editing panels).
ReturnsSeatbelt2D label. Return typeNumber |
ExampleTo get the next free seatbelt label in model m: var label = Seatbelt2D.NextFreeLabel(m);
|
Pick(prompt[string], limit (optional)[Model or Flag], modal (optional)[boolean], button text (optional)[string]) [static]DescriptionAllows the user to pick a seatbelt. |
Text to display as a prompt to the user
If the argument is a Model then only seatbelts from that model can be picked. If the argument is a Flag then only seatbelts that are flagged with limit can be selected. If omitted, or null, any seatbelts from any model can be selected. from any model.
If picking is modal (blocks the user from doing anything else in PRIMER until this window is dismissed). If omitted the pick will be modal.
By default the window with the prompt will have a button labelled 'Cancel' which if pressed will cancel the pick and return null. If you want to change the text on the button use this argument. If omitted 'Cancel' will be used.
ReturnsSeatbelt2D object (or null if not picked) Return typeSeatbelt2D |
ExampleTo pick a seatbelt from model m giving the prompt 'Pick seatbelt from screen': var s = Seatbelt2D.Pick('Pick seatbelt from screen', m);
|
Previous()DescriptionReturns the previous seatbelt in the model. |
No arguments
ReturnsSeatbelt2D object (or null if there are no more seatbelts in the model). Return typeSeatbelt2D |
ExampleTo get the seatbelt in model m before seatbelt s: var s = s.Previous();
|
Select(flag[Flag], prompt[string], limit (optional)[Model or Flag], modal (optional)[boolean]) [static]DescriptionAllows the user to select seatbelts using standard PRIMER object menus. |
Flag to use when selecting seatbelts
Text to display as a prompt to the user
If the argument is a Model then only seatbelts from that model can be selected. If the argument is a Flag then only seatbelts that are flagged with limit can be selected (limit should be different to flag). If omitted, or null, any seatbelts can be selected. from any model.
If selection is modal (blocks the user from doing anything else in PRIMER until this window is dismissed). If omitted the selection will be modal.
ReturnsNumber of seatbelts selected or null if menu cancelled Return typeNumber |
SetFlag(flag[Flag])DescriptionSets a flag on the seatbelt. |
Flag to set on the seatbelt
ReturnsNo return value |
ExampleTo set flag f for seatbelt s: s.SetFlag(f);
|
Sketch(redraw (optional)[boolean])DescriptionSketches the seatbelt. The seatbelt will be sketched until you either call Seatbelt2D.Unsketch(), Seatbelt2D.UnsketchAll(), Model.UnsketchAll(), or delete the model |
If model should be redrawn or not after the seatbelt is sketched. If omitted redraw is true. If you want to sketch several seatbelts and only redraw after the last one then use false for redraw and call View.Redraw().
ReturnsNo return value |
ExampleTo sketch seatbelt s: s.Sketch();
|
SketchFlagged(Model[Model], flag[Flag], redraw (optional)[boolean]) [static]DescriptionSketches all of the flagged seatbelts in the model. The seatbelts will be sketched until you either call Seatbelt2D.Unsketch(), Seatbelt2D.UnsketchFlagged(), Model.UnsketchAll(), or delete the model |
Model that all the flagged seatbelts will be sketched in
Flag set on the seatbelts that you want to sketch
If model should be redrawn or not after the seatbelts are sketched. If omitted redraw is true. If you want to sketch flagged seatbelts several times and only redraw after the last one then use false for redraw and call View.Redraw().
ReturnsNo return value |
ExampleTo sketch all seatbelts flagged with flag in model m: Seatbelt2D.SketchFlagged(m, flag);
|
Total(Model[Model], exists (optional)[boolean]) [static]DescriptionReturns the total number of seatbelts in the model. |
Model to get total for
true if only existing seatbelts should be counted. If false or omitted referenced but undefined seatbelts will also be included in the total.
Returnsnumber of seatbelts Return typeNumber |
ExampleTo get the total number of seatbelts in model m: var total = Seatbelt2D.Total(m);
|
Unblank()DescriptionUnblanks the seatbelt |
No arguments
ReturnsNo return value |
ExampleTo unblank seatbelt s: s.Unblank();
|
UnblankAll(Model[Model], redraw (optional)[boolean]) [static]DescriptionUnblanks all of the seatbelts in the model. |
Model that all seatbelts will be unblanked in
If model should be redrawn or not. If omitted redraw is false. If you want to do several (un)blanks and only redraw after the last one then use false for all redraws apart from the last one. Alternatively you can redraw using View.Redraw().
ReturnsNo return value |
ExampleTo unblank all of the seatbelts in model m: Seatbelt2D.UnblankAll(m);
|
UnblankFlagged(Model[Model], flag[Flag], redraw (optional)[boolean]) [static]DescriptionUnblanks all of the flagged seatbelts in the model. |
Model that the flagged seatbelts will be unblanked in
Flag set on the seatbelts that you want to unblank
If model should be redrawn or not. If omitted redraw is false. If you want to do several (un)blanks and only redraw after the last one then use false for all redraws apart from the last one. Alternatively you can redraw using View.Redraw().
ReturnsNo return value |
ExampleTo unblank all of the seatbelts in model m flagged with f: Seatbelt2D.UnblankFlagged(m, f);
|
UnflagAll(Model[Model], flag[Flag]) [static]DescriptionUnsets a defined flag on all of the seatbelts in the model. |
Model that the defined flag for all seatbelts will be unset in
Flag to unset on the seatbelts
ReturnsNo return value |
ExampleTo unset the flag f on all the seatbelts in model m: Seatbelt2D.UnflagAll(m, f);
|
Unsketch(redraw (optional)[boolean])DescriptionUnsketches the seatbelt. |
If model should be redrawn or not after the seatbelt is unsketched. If omitted redraw is true. If you want to unsketch several seatbelts and only redraw after the last one then use false for redraw and call View.Redraw().
ReturnsNo return value |
ExampleTo unsketch seatbelt s: s.Unsketch();
|
UnsketchAll(Model[Model], redraw (optional)[boolean]) [static]DescriptionUnsketches all seatbelts. |
Model that all seatbelts will be unblanked in
If model should be redrawn or not after the seatbelts are unsketched. If omitted redraw is true. If you want to unsketch several things and only redraw after the last one then use false for redraw and call View.Redraw().
ReturnsNo return value |
ExampleTo unsketch all seatbelts in model m: Seatbelt2D.UnsketchAll(m);
|
UnsketchFlagged(Model[Model], flag[Flag], redraw (optional)[boolean]) [static]DescriptionUnsketches all flagged seatbelts in the model. |
Model that all seatbelts will be unsketched in
Flag set on the seatbelts that you want to unsketch
If model should be redrawn or not after the seatbelts are unsketched. If omitted redraw is true. If you want to unsketch several things and only redraw after the last one then use false for redraw and call View.Redraw().
ReturnsNo return value |
ExampleTo unsketch all seatbelts flagged with flag in model m: Seatbelt2D.UnsketchAll(m, flag);
|
No arguments
ReturnsSeatbelt2D object. Return typeSeatbelt2D |
ExampleTo check if Seatbelt2D property s.example is a parameter by using the Seatbelt2D.GetParameter() method: if (s.ViewParameters().GetParameter(s.example) ) do_something...
|
Warning(message[string], details (optional)[string])DescriptionAdds a warning for seatbelt. For more details on checking see the Check class. |
The warning message to give
An optional detailed warning message
ReturnsNo return value |
ExampleTo add a warning message "My custom warning" for seatbelt s: s.Warning("My custom warning");
|
Xrefs()DescriptionReturns the cross references for this seatbelt. |
No arguments
ReturnsXrefs object. Return typeXrefs |
ExampleTo get the cross references for seatbelt s: var xrefs = s.Xrefs();
|
toString()DescriptionCreates a string containing the seatbelt data in keyword format. Note that this contains the keyword header and the keyword cards. See also Seatbelt2D.Keyword() and Seatbelt2D.KeywordCards(). |
No arguments
Returnsstring Return typeString |
ExampleTo get data for seatbelt s in keyword format var str = s.toString();
|