The Seatbelt1D class gives you access to 2 noded (1D) 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 | Seatbelt1D 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 | Seatbelt1D 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 |
| 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 Seatbelt1D class allows you to create, modify, edit and manipulate 2 noded (1D) element seatbelt cards. See the documentation below for more details. |
Constructornew Seatbelt1D(Model[Model], eid[integer], pid[integer], n1[integer], n2[integer])DescriptionCreate a new Seatbelt1D object. |
Model that seatbelt will be created in
Seatbelt ID.
Part number.
Node 1 ID
Node 2 ID
ReturnsSeatbelt1D object Return typeSeatbelt1D |
ExampleTo create a new 2 noded element seatbelt in model m with label 100, part 10 and nodes 20, 21: var a = new Seatbelt1D(m, 100, 10, 20, 21);
|
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: Seatbelt1D.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: Seatbelt1D.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().
ReturnsSeatbelt1D object Return typeSeatbelt1D |
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.
ReturnsSeatbelt1D object (or null if not made). Return typeSeatbelt1D |
ExampleTo start creating a seatbelt in model m: var s = Seatbelt1D.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
ReturnsSeatbelt1D object (or null if there are no seatbelts in the model). Return typeSeatbelt1D |
ExampleTo get the first seatbelt in model m: var s = Seatbelt1D.First(m);
|
FirstFreeLabel(Model[Model], layer (optional)[Include number]) [static]DescriptionReturns the first free seatbelt label in the model. Also see Seatbelt1D.LastFreeLabel(), Seatbelt1D.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).
ReturnsSeatbelt1D label. Return typeNumber |
ExampleTo get the first free seatbelt label in model m: var label = Seatbelt1D.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: Seatbelt1D.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 Seatbelt1D 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 Seatbelt1D objects is returned. If the property argument is given, that property value for each seatbelt is returned in the array instead of a Seatbelt1D object |
Model to get seatbelts from
Name for property to get for all seatbelts in the model
ReturnsArray of Seatbelt1D 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 Seatbelt1D objects for all of the flagged seatbelts in a model in PRIMER If the optional property argument is not given then an array of Seatbelt1D objects is returned. If the property argument is given, then that property value for each seatbelt is returned in the array instead of a Seatbelt1D 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 Seatbelt1D objects or properties Return typeArray |
GetFromID(Model[Model], number[integer]) [static]DescriptionReturns the Seatbelt1D object for a seatbelt ID. |
Model to find the seatbelt in
number of the seatbelt you want the Seatbelt1D object for
ReturnsSeatbelt1D object (or null if seatbelt does not exist). Return typeSeatbelt1D |
ExampleTo get the Seatbelt1D object for seatbelt 100 in model m var s = Seatbelt1D.GetFromID(m, 100);
|
GetParameter(prop[string])DescriptionChecks if a Seatbelt1D 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 Seatbelt1D.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 Seatbelt1D.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 Seatbelt1D.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
ReturnsSeatbelt1D object (or null if there are no seatbelts in the model). Return typeSeatbelt1D |
ExampleTo get the last seatbelt in model m: var s = Seatbelt1D.Last(m);
|
LastFreeLabel(Model[Model], layer (optional)[Include number]) [static]DescriptionReturns the last free seatbelt label in the model. Also see Seatbelt1D.FirstFreeLabel(), Seatbelt1D.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.
ReturnsSeatbelt1D label. Return typeNumber |
ExampleTo get the last free seatbelt label in model m: var label = Seatbelt1D.LastFreeLabel(m);
|
Next()DescriptionReturns the next seatbelt in the model. |
No arguments
ReturnsSeatbelt1D object (or null if there are no more seatbelts in the model). Return typeSeatbelt1D |
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 Seatbelt1D.FirstFreeLabel(), Seatbelt1D.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).
ReturnsSeatbelt1D label. Return typeNumber |
ExampleTo get the next free seatbelt label in model m: var label = Seatbelt1D.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.
ReturnsSeatbelt1D object (or null if not picked) Return typeSeatbelt1D |
ExampleTo pick a seatbelt from model m giving the prompt 'Pick seatbelt from screen': var s = Seatbelt1D.Pick('Pick seatbelt from screen', m);
|
Previous()DescriptionReturns the previous seatbelt in the model. |
No arguments
ReturnsSeatbelt1D object (or null if there are no more seatbelts in the model). Return typeSeatbelt1D |
ExampleTo get the seatbelt in model m before seatbelt s: var s = s.Previous();
|
RenumberAll(Model[Model], start[integer]) [static]DescriptionRenumbers all of the seatbelts in the model. |
Model that all seatbelts will be renumbered in
Start point for renumbering
ReturnsNo return value |
ExampleTo renumber all of the seatbelts in model m, from 1000000: Seatbelt1D.RenumberAll(m, 1000000);
|
RenumberFlagged(Model[Model], flag[Flag], start[integer]) [static]DescriptionRenumbers all of the flagged seatbelts in the model. |
Model that all the flagged seatbelts will be renumbered in
Flag set on the seatbelts that you want to renumber
Start point for renumbering
ReturnsNo return value |
ExampleTo renumber all of the seatbelts in model m flagged with f, from 1000000: Seatbelt1D.RenumberFlagged(m, f, 1000000);
|
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 Seatbelt1D.Unsketch(), Seatbelt1D.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 Seatbelt1D.Unsketch(), Seatbelt1D.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: Seatbelt1D.SketchFlagged(m, flag);
|
Timestep()DescriptionCalculates the timestep for the seatbelt |
No arguments
Returnsreal Return typeNumber |
ExampleTo calculate the timestep for seatbelt s: var timestep = s.Timestep();
|
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 = Seatbelt1D.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: Seatbelt1D.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: Seatbelt1D.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: Seatbelt1D.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: Seatbelt1D.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: Seatbelt1D.UnsketchAll(m, flag);
|
No arguments
ReturnsSeatbelt1D object. Return typeSeatbelt1D |
ExampleTo check if Seatbelt1D property s.example is a parameter by using the Seatbelt1D.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 Seatbelt1D.Keyword() and Seatbelt1D.KeywordCards(). |
No arguments
Returnsstring Return typeString |
ExampleTo get data for seatbelt s in keyword format var str = s.toString();
|