The Slipring class gives you access to seatbelt slipring 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 slipring |
| dc | real | Optional decay constant to allow a smooth transition between the static and dynamic friction coefficients. |
| direct | integer | Direction of belt movement |
| exists (read only) | logical | true if slipring exists, false if referred to but not defined. |
| fc | real | Coulomb dynamic friction coefficient |
| fcs | real | Coulomb static friction coefficient |
| funcid | integer | Function ID to determine friction coefficient |
| include | integer | The Include file number that the slipring is in. |
| k | real | Optional coefficient for determining the Coulomb friction coefficient related to angle alpha |
| label | integer | Slipring number. Also see the sbsrid property which is an alternative name for this. |
| lcnffd | integer | Loadcurve for Coulomb dynamic friction |
| lcnffs | integer | Loadcurve for Coulomb static friction |
| ltime | real | Slipring lockup time |
| model (read only) | integer | The Model number that the slipring is in. |
| onid | integer | Orientation Node number |
| sbid1 | integer | Seatbelt number 1 (or Set Shell number if sbrnid is negative). |
| sbid2 | integer | Seatbelt number 2 (or Set Shell number if sbrnid is negative). |
| sbrnid | integer | Node number (or Set Node number if negative) |
| sbsrid | integer | Slipring number. Also see the label property which is an alternative name for this. |
| shell_seatbelt (read only) | logical | true if slipring is used for shell (2D) seatbelt elements. |
| transparency | integer | The transparency of the slipring (0-100) 0% is opaque, 100% is transparent. |
Detailed DescriptionThe Slipring class allows you to create, modify, edit and manipulate seatbelt slipring cards. See the documentation below for more details. |
Constructornew Slipring(Model[Model], sbsrid[integer], sbid1[integer], sbid2[integer], sbrnid[integer])DescriptionCreate a new Seatbelt Slipring object. |
Model that slipring will be created in
Slipring number.
Seatbelt number 1
Seatbelt number 2
Slipring Node number
ReturnsSlipring object Return typeSlipring |
ExampleTo create a new seatbelt slipring in model m with label 100, seatbelts 10, 11 and node 20: var a = new Slipring(m, 100, 10, 11, 20);
|
Details of functionsAssociateComment(Comment[Comment])DescriptionAssociates a comment with a slipring. |
Comment that will be attached to the slipring
ReturnsNo return value |
ExampleTo associate comment c to the slipring s: s.AssociateComment(c);
|
Blank()DescriptionBlanks the slipring |
No arguments
ReturnsNo return value |
ExampleTo blank slipring s: s.Blank();
|
BlankAll(Model[Model], redraw (optional)[boolean]) [static]DescriptionBlanks all of the sliprings in the model. |
Model that all sliprings 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 sliprings in model m: Slipring.BlankAll(m);
|
BlankFlagged(Model[Model], flag[Flag], redraw (optional)[boolean]) [static]DescriptionBlanks all of the flagged sliprings in the model. |
Model that all the flagged sliprings will be blanked in
Flag set on the sliprings 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 sliprings in model m flagged with f: Slipring.BlankFlagged(m, f);
|
Blanked()DescriptionChecks if the slipring is blanked or not. |
No arguments
Returnstrue if blanked, false if not. Return typeBoolean |
ExampleTo check if slipring 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 slipring s: s.Browse();
|
ClearFlag(flag[Flag])DescriptionClears a flag on the slipring. |
Flag to clear on the slipring
ReturnsNo return value |
ExampleTo clear flag f for slipring s: s.ClearFlag(f);
|
Copy(range (optional)[boolean])DescriptionCopies the slipring. The target include of the copied slipring 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().
ReturnsSlipring object Return typeSlipring |
ExampleTo copy slipring s into slipring z: var z = s.Copy();
|
Create(Model[Model], modal (optional)[boolean]) [static]DescriptionStarts an interactive editing panel to create a slipring |
Model that the slipring 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.
ReturnsSlipring object (or null if not made). Return typeSlipring |
ExampleTo start creating a slipring in model m: var s = Slipring.Create(m);
|
DetachComment(Comment[Comment])DescriptionDetaches a comment from a slipring. |
Comment that will be detached from the slipring
ReturnsNo return value |
ExampleTo detach comment c from the slipring 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 slipring s: s.Edit();
|
Error(message[string], details (optional)[string])DescriptionAdds an error for slipring. 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 slipring s: s.Error("My custom error");
|
ExtractColour()DescriptionExtracts the actual colour used for slipring. |
No arguments
Returnscolour value (integer) Return typeNumber |
ExampleTo return the colour used for drawing slipring s: var colour = s.ExtractColour();
|
First(Model[Model]) [static]DescriptionReturns the first slipring in the model. |
Model to get first slipring in
ReturnsSlipring object (or null if there are no sliprings in the model). Return typeSlipring |
ExampleTo get the first slipring in model m: var s = Slipring.First(m);
|
FirstFreeLabel(Model[Model], layer (optional)[Include number]) [static]DescriptionReturns the first free slipring label in the model. Also see Slipring.LastFreeLabel(), Slipring.NextFreeLabel() and Model.FirstFreeItemLabel(). |
Model to get first free slipring 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).
ReturnsSlipring label. Return typeNumber |
ExampleTo get the first free slipring label in model m: var label = Slipring.FirstFreeLabel(m);
|
FlagAll(Model[Model], flag[Flag]) [static]DescriptionFlags all of the sliprings in the model with a defined flag. |
Model that all sliprings will be flagged in
Flag to set on the sliprings
ReturnsNo return value |
ExampleTo flag all of the sliprings with flag f in model m: Slipring.FlagAll(m, f);
|
Flagged(flag[Flag])DescriptionChecks if the slipring is flagged or not. |
Flag to test on the slipring
Returnstrue if flagged, false if not. Return typeBoolean |
ExampleTo check if slipring 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 slipring in the model. |
Model that all sliprings are in
Function to call for each slipring
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 Slipring objects or properties for all of the sliprings in a model in PRIMER. If the optional property argument is not given then an array of Slipring objects is returned. If the property argument is given, that property value for each slipring is returned in the array instead of a Slipring object |
Model to get sliprings from
Name for property to get for all sliprings in the model
ReturnsArray of Slipring objects or properties Return typeArray |
GetComments()DescriptionExtracts the comments associated to a slipring. |
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 slipring s: var comm_array = s.GetComments();
|
GetFlagged(Model[Model], flag[Flag], property (optional)[string]) [static]DescriptionReturns an array of Slipring objects for all of the flagged sliprings in a model in PRIMER If the optional property argument is not given then an array of Slipring objects is returned. If the property argument is given, then that property value for each slipring is returned in the array instead of a Slipring object |
Model to get sliprings from
Flag set on the sliprings that you want to retrieve
Name for property to get for all flagged sliprings in the model
ReturnsArray of Slipring objects or properties Return typeArray |
GetFromID(Model[Model], number[integer]) [static]DescriptionReturns the Slipring object for a slipring ID. |
Model to find the slipring in
number of the slipring you want the Slipring object for
ReturnsSlipring object (or null if slipring does not exist). Return typeSlipring |
ExampleTo get the Slipring object for slipring 100 in model m var s = Slipring.GetFromID(m, 100);
|
GetParameter(prop[string])DescriptionChecks if a Slipring 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 Slipring.ViewParameters() method and 'method chaining' (see the examples below). |
slipring property to get parameter for
ReturnsParameter object if property is a parameter, null if not. Return typeParameter |
Keyword()DescriptionReturns the keyword for this slipring (*ELEMENT_SEATBELT_SLIPEROMETER) Note that a carriage return is not added. See also Slipring.KeywordCards() |
No arguments
Returnsstring containing the keyword. Return typeString |
ExampleTo get the keyword for slipring s: var key = s.Keyword();
|
KeywordCards()DescriptionReturns the keyword cards for the slipring. Note that a carriage return is not added. See also Slipring.Keyword() |
No arguments
Returnsstring containing the cards. Return typeString |
ExampleTo get the cards for slipring s: var cards = s.KeywordCards();
|
Last(Model[Model]) [static]DescriptionReturns the last slipring in the model. |
Model to get last slipring in
ReturnsSlipring object (or null if there are no sliprings in the model). Return typeSlipring |
ExampleTo get the last slipring in model m: var s = Slipring.Last(m);
|
LastFreeLabel(Model[Model], layer (optional)[Include number]) [static]DescriptionReturns the last free slipring label in the model. Also see Slipring.FirstFreeLabel(), Slipring.NextFreeLabel() and see Model.LastFreeItemLabel() |
Model to get last free slipring 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.
ReturnsSlipring label. Return typeNumber |
ExampleTo get the last free slipring label in model m: var label = Slipring.LastFreeLabel(m);
|
Next()DescriptionReturns the next slipring in the model. |
No arguments
ReturnsSlipring object (or null if there are no more sliprings in the model). Return typeSlipring |
ExampleTo get the slipring in model m after slipring s: var s = s.Next();
|
NextFreeLabel(Model[Model], layer (optional)[Include number]) [static]DescriptionReturns the next free (highest+1) slipring label in the model. Also see Slipring.FirstFreeLabel(), Slipring.LastFreeLabel() and Model.NextFreeItemLabel() |
Model to get next free slipring 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).
ReturnsSlipring label. Return typeNumber |
ExampleTo get the next free slipring label in model m: var label = Slipring.NextFreeLabel(m);
|
Pick(prompt[string], limit (optional)[Model or Flag], modal (optional)[boolean], button text (optional)[string]) [static]DescriptionAllows the user to pick a slipring. |
Text to display as a prompt to the user
If the argument is a Model then only sliprings from that model can be picked. If the argument is a Flag then only sliprings that are flagged with limit can be selected. If omitted, or null, any sliprings 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.
ReturnsSlipring object (or null if not picked) Return typeSlipring |
ExampleTo pick a slipring from model m giving the prompt 'Pick slipring from screen': var s = Slipring.Pick('Pick slipring from screen', m);
|
Previous()DescriptionReturns the previous slipring in the model. |
No arguments
ReturnsSlipring object (or null if there are no more sliprings in the model). Return typeSlipring |
ExampleTo get the slipring in model m before slipring s: var s = s.Previous();
|
RenumberAll(Model[Model], start[integer]) [static]DescriptionRenumbers all of the sliprings in the model. |
Model that all sliprings will be renumbered in
Start point for renumbering
ReturnsNo return value |
ExampleTo renumber all of the sliprings in model m, from 1000000: Slipring.RenumberAll(m, 1000000);
|
RenumberFlagged(Model[Model], flag[Flag], start[integer]) [static]DescriptionRenumbers all of the flagged sliprings in the model. |
Model that all the flagged sliprings will be renumbered in
Flag set on the sliprings that you want to renumber
Start point for renumbering
ReturnsNo return value |
ExampleTo renumber all of the sliprings in model m flagged with f, from 1000000: Slipring.RenumberFlagged(m, f, 1000000);
|
Select(flag[Flag], prompt[string], limit (optional)[Model or Flag], modal (optional)[boolean]) [static]DescriptionAllows the user to select sliprings using standard PRIMER object menus. |
Flag to use when selecting sliprings
Text to display as a prompt to the user
If the argument is a Model then only sliprings from that model can be selected. If the argument is a Flag then only sliprings that are flagged with limit can be selected (limit should be different to flag). If omitted, or null, any sliprings 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 sliprings selected or null if menu cancelled Return typeNumber |
SetFlag(flag[Flag])DescriptionSets a flag on the slipring. |
Flag to set on the slipring
ReturnsNo return value |
ExampleTo set flag f for slipring s: s.SetFlag(f);
|
Sketch(redraw (optional)[boolean])DescriptionSketches the slipring. The slipring will be sketched until you either call Slipring.Unsketch(), Slipring.UnsketchAll(), Model.UnsketchAll(), or delete the model |
If model should be redrawn or not after the slipring is sketched. If omitted redraw is true. If you want to sketch several sliprings and only redraw after the last one then use false for redraw and call View.Redraw().
ReturnsNo return value |
ExampleTo sketch slipring s: s.Sketch();
|
SketchFlagged(Model[Model], flag[Flag], redraw (optional)[boolean]) [static]DescriptionSketches all of the flagged sliprings in the model. The sliprings will be sketched until you either call Slipring.Unsketch(), Slipring.UnsketchFlagged(), Model.UnsketchAll(), or delete the model |
Model that all the flagged sliprings will be sketched in
Flag set on the sliprings that you want to sketch
If model should be redrawn or not after the sliprings are sketched. If omitted redraw is true. If you want to sketch flagged sliprings several times and only redraw after the last one then use false for redraw and call View.Redraw().
ReturnsNo return value |
ExampleTo sketch all sliprings flagged with flag in model m: Slipring.SketchFlagged(m, flag);
|
Total(Model[Model], exists (optional)[boolean]) [static]DescriptionReturns the total number of sliprings in the model. |
Model to get total for
true if only existing sliprings should be counted. If false or omitted referenced but undefined sliprings will also be included in the total.
Returnsnumber of sliprings Return typeNumber |
ExampleTo get the total number of sliprings in model m: var total = Slipring.Total(m);
|
Unblank()DescriptionUnblanks the slipring |
No arguments
ReturnsNo return value |
ExampleTo unblank slipring s: s.Unblank();
|
UnblankAll(Model[Model], redraw (optional)[boolean]) [static]DescriptionUnblanks all of the sliprings in the model. |
Model that all sliprings 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 sliprings in model m: Slipring.UnblankAll(m);
|
UnblankFlagged(Model[Model], flag[Flag], redraw (optional)[boolean]) [static]DescriptionUnblanks all of the flagged sliprings in the model. |
Model that the flagged sliprings will be unblanked in
Flag set on the sliprings 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 sliprings in model m flagged with f: Slipring.UnblankFlagged(m, f);
|
UnflagAll(Model[Model], flag[Flag]) [static]DescriptionUnsets a defined flag on all of the sliprings in the model. |
Model that the defined flag for all sliprings will be unset in
Flag to unset on the sliprings
ReturnsNo return value |
ExampleTo unset the flag f on all the sliprings in model m: Slipring.UnflagAll(m, f);
|
Unsketch(redraw (optional)[boolean])DescriptionUnsketches the slipring. |
If model should be redrawn or not after the slipring is unsketched. If omitted redraw is true. If you want to unsketch several sliprings and only redraw after the last one then use false for redraw and call View.Redraw().
ReturnsNo return value |
ExampleTo unsketch slipring s: s.Unsketch();
|
UnsketchAll(Model[Model], redraw (optional)[boolean]) [static]DescriptionUnsketches all sliprings. |
Model that all sliprings will be unblanked in
If model should be redrawn or not after the sliprings 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 sliprings in model m: Slipring.UnsketchAll(m);
|
UnsketchFlagged(Model[Model], flag[Flag], redraw (optional)[boolean]) [static]DescriptionUnsketches all flagged sliprings in the model. |
Model that all sliprings will be unsketched in
Flag set on the sliprings that you want to unsketch
If model should be redrawn or not after the sliprings 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 sliprings flagged with flag in model m: Slipring.UnsketchAll(m, flag);
|
No arguments
ReturnsSlipring object. Return typeSlipring |
ExampleTo check if Slipring property s.example is a parameter by using the Slipring.GetParameter() method: if (s.ViewParameters().GetParameter(s.example) ) do_something...
|
Warning(message[string], details (optional)[string])DescriptionAdds a warning for slipring. 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 slipring s: s.Warning("My custom warning");
|
Xrefs()DescriptionReturns the cross references for this slipring. |
No arguments
ReturnsXrefs object. Return typeXrefs |
ExampleTo get the cross references for slipring s: var xrefs = s.Xrefs();
|
toString()DescriptionCreates a string containing the slipring data in keyword format. Note that this contains the keyword header and the keyword cards. See also Slipring.Keyword() and Slipring.KeywordCards(). |
No arguments
Returnsstring Return typeString |
ExampleTo get data for slipring s in keyword format var str = s.toString();
|