The ReferenceGeometry class gives you access to define airbag reference geometry 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 |
| aid | integer | ReferenceGeometry number. Also see the label property which is an alternative name for this. |
| birth | logical | Turns _BIRTH on or off |
| birth_time | real | Birth time |
| exists (read only) | logical | true if airbag reference geometry exists, false if referred to but not defined. |
| id | logical | Turns _ID on or OFF |
| include | integer | The Include file number that the airbag reference geometry is in. |
| iout | integer | Flag for outputting the current reference node coordinates |
| label | integer | ReferenceGeometry number. Also see the aid property which is an alternative name for this. |
| model (read only) | integer | The Model number that the airbag reference geometry is in. |
| nido | integer | Node number for origin |
| rdt | logical | Turns _RDT on or OFF |
| sx | real | Scale factor in X direction |
| sy | real | Scale factor in Y direction |
| sz | real | Scale factor in Z direction |
Detailed DescriptionThe ReferenceGeometry class allows you to create, modify, edit and manipulate airbag reference geometry cards. See the documentation below for more details. |
Constructornew ReferenceGeometry(Model[Model], aid (optional)[integer])DescriptionCreate a new ReferenceGeometry object. |
Model that ReferenceGeometry will be created in
ReferenceGeometry number to set _ID suffix
ReturnsReferenceGeometry object Return typeReferenceGeometry |
ExampleTo create a new ReferenceGeometry in model m var a = new ReferenceGeometry(m);
|
Details of functionsAssociateComment(Comment[Comment])DescriptionAssociates a comment with a airbag reference geometry. |
Comment that will be attached to the airbag reference geometry
ReturnsNo return value |
ExampleTo associate comment c to the airbag reference geometry a: a.AssociateComment(c);
|
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 airbag reference geometry a: a.Browse();
|
ClearFlag(flag[Flag])DescriptionClears a flag on the airbag reference geometry. |
Flag to clear on the airbag reference geometry
ReturnsNo return value |
ExampleTo clear flag f for airbag reference geometry a: a.ClearFlag(f);
|
Copy(range (optional)[boolean])DescriptionCopies the airbag reference geometry. The target include of the copied airbag reference geometry 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().
ReturnsReferenceGeometry object Return typeReferenceGeometry |
ExampleTo copy airbag reference geometry a into airbag reference geometry z: var z = a.Copy();
|
Create(Model[Model], modal (optional)[boolean]) [static]DescriptionStarts an interactive editing panel to create a airbag reference geometry |
Model that the airbag reference geometry 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.
ReturnsReferenceGeometry object (or null if not made). Return typeReferenceGeometry |
ExampleTo start creating a airbag reference geometry in model m: var a = ReferenceGeometry.Create(m);
|
DetachComment(Comment[Comment])DescriptionDetaches a comment from a airbag reference geometry. |
Comment that will be detached from the airbag reference geometry
ReturnsNo return value |
ExampleTo detach comment c from the airbag reference geometry a: a.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 airbag reference geometry a: a.Edit();
|
Error(message[string], details (optional)[string])DescriptionAdds an error for airbag reference geometry. 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 airbag reference geometry a: a.Error("My custom error");
|
First(Model[Model]) [static]DescriptionReturns the first airbag reference geometry in the model. |
Model to get first airbag reference geometry in
ReturnsReferenceGeometry object (or null if there are no airbag reference geometrys in the model). Return typeReferenceGeometry |
ExampleTo get the first airbag reference geometry in model m: var a = ReferenceGeometry.First(m);
|
FirstFreeLabel(Model[Model], layer (optional)[Include number]) [static]DescriptionReturns the first free airbag reference geometry label in the model. Also see ReferenceGeometry.LastFreeLabel(), ReferenceGeometry.NextFreeLabel() and Model.FirstFreeItemLabel(). |
Model to get first free airbag reference geometry 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).
ReturnsReferenceGeometry label. Return typeNumber |
ExampleTo get the first free airbag reference geometry label in model m: var label = ReferenceGeometry.FirstFreeLabel(m);
|
FlagAll(Model[Model], flag[Flag]) [static]DescriptionFlags all of the airbag reference geometrys in the model with a defined flag. |
Model that all airbag reference geometrys will be flagged in
Flag to set on the airbag reference geometrys
ReturnsNo return value |
ExampleTo flag all of the airbag reference geometrys with flag f in model m: ReferenceGeometry.FlagAll(m, f);
|
Flagged(flag[Flag])DescriptionChecks if the airbag reference geometry is flagged or not. |
Flag to test on the airbag reference geometry
Returnstrue if flagged, false if not. Return typeBoolean |
ExampleTo check if airbag reference geometry a has flag f set on it: if (a.Flagged(f) ) do_something...
|
ForEach(Model[Model], func[function], extra (optional)[any]) [static]DescriptionCalls a function for each airbag reference geometry in the model. |
Model that all airbag reference geometrys are in
Function to call for each airbag reference geometry
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 ReferenceGeometry objects or properties for all of the airbag reference geometrys in a model in PRIMER. If the optional property argument is not given then an array of ReferenceGeometry objects is returned. If the property argument is given, that property value for each airbag reference geometry is returned in the array instead of a ReferenceGeometry object |
Model to get airbag reference geometrys from
Name for property to get for all airbag reference geometrys in the model
ReturnsArray of ReferenceGeometry objects or properties Return typeArray |
GetComments()DescriptionExtracts the comments associated to a airbag reference geometry. |
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 airbag reference geometry a: var comm_array = a.GetComments();
|
GetFlagged(Model[Model], flag[Flag], property (optional)[string]) [static]DescriptionReturns an array of ReferenceGeometry objects for all of the flagged airbag reference geometrys in a model in PRIMER If the optional property argument is not given then an array of ReferenceGeometry objects is returned. If the property argument is given, then that property value for each airbag reference geometry is returned in the array instead of a ReferenceGeometry object |
Model to get airbag reference geometrys from
Flag set on the airbag reference geometrys that you want to retrieve
Name for property to get for all flagged airbag reference geometrys in the model
ReturnsArray of ReferenceGeometry objects or properties Return typeArray |
GetFromID(Model[Model], number[integer]) [static]DescriptionReturns the ReferenceGeometry object for a airbag reference geometry ID. |
Model to find the airbag reference geometry in
number of the airbag reference geometry you want the ReferenceGeometry object for
ReturnsReferenceGeometry object (or null if airbag reference geometry does not exist). Return typeReferenceGeometry |
ExampleTo get the ReferenceGeometry object for airbag reference geometry 100 in model m var a = ReferenceGeometry.GetFromID(m, 100);
|
GetNode(nid[integer])DescriptionReturns the reference geometry coordinates for the node |
Node ID
ReturnsAn array containing the three reference coordinates (or null if the node is not on the reference geometry) Return typeArray |
ExampleTo get the reference coordinates of node number nid on reference geometry a var coords = a.GetNode(nid);
|
GetParameter(prop[string])DescriptionChecks if a ReferenceGeometry 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 ReferenceGeometry.ViewParameters() method and 'method chaining' (see the examples below). |
airbag reference geometry property to get parameter for
ReturnsParameter object if property is a parameter, null if not. Return typeParameter |
Keyword()DescriptionReturns the keyword for this reference_geometry (*AIRBAG_REFERENCE_GEOMETRY). Note that a carriage return is not added. See also ReferenceGeometry.KeywordCards() |
No arguments
Returnsstring containing the keyword. Return typeString |
ExampleTo get the keyword for reference_geometry m: var key = m.Keyword();
|
KeywordCards()DescriptionReturns the keyword cards for the reference_geometry. Note that a carriage return is not added. See also ReferenceGeometry.Keyword() |
No arguments
Returnsstring containing the cards. Return typeString |
ExampleTo get the cards for airbag reference geometry a: var cards = b.KeywordCards();
|
Last(Model[Model]) [static]DescriptionReturns the last airbag reference geometry in the model. |
Model to get last airbag reference geometry in
ReturnsReferenceGeometry object (or null if there are no airbag reference geometrys in the model). Return typeReferenceGeometry |
ExampleTo get the last airbag reference geometry in model m: var a = ReferenceGeometry.Last(m);
|
LastFreeLabel(Model[Model], layer (optional)[Include number]) [static]DescriptionReturns the last free airbag reference geometry label in the model. Also see ReferenceGeometry.FirstFreeLabel(), ReferenceGeometry.NextFreeLabel() and see Model.LastFreeItemLabel() |
Model to get last free airbag reference geometry 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.
ReturnsReferenceGeometry label. Return typeNumber |
ExampleTo get the last free airbag reference geometry label in model m: var label = ReferenceGeometry.LastFreeLabel(m);
|
Next()DescriptionReturns the next airbag reference geometry in the model. |
No arguments
ReturnsReferenceGeometry object (or null if there are no more airbag reference geometrys in the model). Return typeReferenceGeometry |
ExampleTo get the airbag reference geometry in model m after airbag reference geometry a: var a = a.Next();
|
NextFreeLabel(Model[Model], layer (optional)[Include number]) [static]DescriptionReturns the next free (highest+1) airbag reference geometry label in the model. Also see ReferenceGeometry.FirstFreeLabel(), ReferenceGeometry.LastFreeLabel() and Model.NextFreeItemLabel() |
Model to get next free airbag reference geometry 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).
ReturnsReferenceGeometry label. Return typeNumber |
ExampleTo get the next free airbag reference geometry label in model m: var label = ReferenceGeometry.NextFreeLabel(m);
|
Pick(prompt[string], limit (optional)[Model or Flag], modal (optional)[boolean], button text (optional)[string]) [static]DescriptionAllows the user to pick a airbag reference geometry. |
Text to display as a prompt to the user
If the argument is a Model then only airbag reference geometrys from that model can be picked. If the argument is a Flag then only airbag reference geometrys that are flagged with limit can be selected. If omitted, or null, any airbag reference geometrys 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.
ReturnsReferenceGeometry object (or null if not picked) Return typeReferenceGeometry |
Previous()DescriptionReturns the previous airbag reference geometry in the model. |
No arguments
ReturnsReferenceGeometry object (or null if there are no more airbag reference geometrys in the model). Return typeReferenceGeometry |
ExampleTo get the airbag reference geometry in model m before airbag reference geometry a: var a = a.Previous();
|
RemoveNode(nid[integer])DescriptionRemoves a node from the reference geometry if it is on it |
Node ID
ReturnsNo return value. |
ExampleTo remove node 11 from reference geometry a: a.RemoveNode(11);
|
RenumberAll(Model[Model], start[integer]) [static]DescriptionRenumbers all of the airbag reference geometrys in the model. |
Model that all airbag reference geometrys will be renumbered in
Start point for renumbering
ReturnsNo return value |
ExampleTo renumber all of the airbag reference geometrys in model m, from 1000000: ReferenceGeometry.RenumberAll(m, 1000000);
|
RenumberFlagged(Model[Model], flag[Flag], start[integer]) [static]DescriptionRenumbers all of the flagged airbag reference geometrys in the model. |
Model that all the flagged airbag reference geometrys will be renumbered in
Flag set on the airbag reference geometrys that you want to renumber
Start point for renumbering
ReturnsNo return value |
ExampleTo renumber all of the airbag reference geometrys in model m flagged with f, from 1000000: ReferenceGeometry.RenumberFlagged(m, f, 1000000);
|
Select(flag[Flag], prompt[string], limit (optional)[Model or Flag], modal (optional)[boolean]) [static]DescriptionAllows the user to select airbag reference geometrys using standard PRIMER object menus. |
Flag to use when selecting airbag reference geometrys
Text to display as a prompt to the user
If the argument is a Model then only airbag reference geometrys from that model can be selected. If the argument is a Flag then only airbag reference geometrys that are flagged with limit can be selected (limit should be different to flag). If omitted, or null, any airbag reference geometrys 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 airbag reference geometrys selected or null if menu cancelled Return typeNumber |
SetFlag(flag[Flag])DescriptionSets a flag on the airbag reference geometry. |
Flag to set on the airbag reference geometry
ReturnsNo return value |
ExampleTo set flag f for airbag reference geometry a: a.SetFlag(f);
|
SetNode(nid[integer], x[real], y[real], z[real])DescriptionAdds a node to the reference geometry if not already there, otherwise just changes the coordinates |
Node ID
X reference coordinate
Y reference coordinate
Z reference coordinate
ReturnsNo return value. |
ExampleTo add node 11 to reference geometry a with coordinates 12.0, 13.0, 14.0 a.SetNode(11, 12.0, 13.0, 14.0);
|
Sketch(redraw (optional)[boolean])DescriptionSketches the airbag reference geometry. The airbag reference geometry will be sketched until you either call ReferenceGeometry.Unsketch(), ReferenceGeometry.UnsketchAll(), Model.UnsketchAll(), or delete the model |
If model should be redrawn or not after the airbag reference geometry is sketched. If omitted redraw is true. If you want to sketch several airbag reference geometrys and only redraw after the last one then use false for redraw and call View.Redraw().
ReturnsNo return value |
ExampleTo sketch airbag reference geometry a: a.Sketch();
|
SketchFlagged(Model[Model], flag[Flag], redraw (optional)[boolean]) [static]DescriptionSketches all of the flagged airbag reference geometrys in the model. The airbag reference geometrys will be sketched until you either call ReferenceGeometry.Unsketch(), ReferenceGeometry.UnsketchFlagged(), Model.UnsketchAll(), or delete the model |
Model that all the flagged airbag reference geometrys will be sketched in
Flag set on the airbag reference geometrys that you want to sketch
If model should be redrawn or not after the airbag reference geometrys are sketched. If omitted redraw is true. If you want to sketch flagged airbag reference geometrys several times and only redraw after the last one then use false for redraw and call View.Redraw().
ReturnsNo return value |
ExampleTo sketch all airbag reference geometrys flagged with flag in model m: ReferenceGeometry.SketchFlagged(m, flag);
|
Spool()DescriptionSpools a reference geometry, entry by entry. See also ReferenceGeometry.StartSpool |
No arguments
ReturnsAn array containing the node ID and the three coordinates. Returns 0 if no more items Return typeArray |
ExampleTo spool reference geometry a: var array;
a.StartSpool();
while (array = a.Spool())
{
do something...
}
|
StartSpool()DescriptionStarts a reference geometry spooling operation. See also ReferenceGeometry.Spool |
No arguments
ReturnsNo return value |
ExampleTo start spooling reference geometry a: a.StartSpool();
|
Total(Model[Model], exists (optional)[boolean]) [static]DescriptionReturns the total number of airbag reference geometrys in the model. |
Model to get total for
true if only existing airbag reference geometrys should be counted. If false or omitted referenced but undefined airbag reference geometrys will also be included in the total.
Returnsnumber of airbag reference geometrys Return typeNumber |
ExampleTo get the total number of airbag reference geometrys in model m: var total = ReferenceGeometry.Total(m);
|
UnflagAll(Model[Model], flag[Flag]) [static]DescriptionUnsets a defined flag on all of the airbag reference geometrys in the model. |
Model that the defined flag for all airbag reference geometrys will be unset in
Flag to unset on the airbag reference geometrys
ReturnsNo return value |
ExampleTo unset the flag f on all the airbag reference geometrys in model m: ReferenceGeometry.UnflagAll(m, f);
|
Unsketch(redraw (optional)[boolean])DescriptionUnsketches the airbag reference geometry. |
If model should be redrawn or not after the airbag reference geometry is unsketched. If omitted redraw is true. If you want to unsketch several airbag reference geometrys and only redraw after the last one then use false for redraw and call View.Redraw().
ReturnsNo return value |
ExampleTo unsketch airbag reference geometry a: a.Unsketch();
|
UnsketchAll(Model[Model], redraw (optional)[boolean]) [static]DescriptionUnsketches all airbag reference geometrys. |
Model that all airbag reference geometrys will be unblanked in
If model should be redrawn or not after the airbag reference geometrys 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 airbag reference geometrys in model m: ReferenceGeometry.UnsketchAll(m);
|
UnsketchFlagged(Model[Model], flag[Flag], redraw (optional)[boolean]) [static]DescriptionUnsketches all flagged airbag reference geometrys in the model. |
Model that all airbag reference geometrys will be unsketched in
Flag set on the airbag reference geometrys that you want to unsketch
If model should be redrawn or not after the airbag reference geometrys 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 airbag reference geometrys flagged with flag in model m: ReferenceGeometry.UnsketchAll(m, flag);
|
No arguments
ReturnsReferenceGeometry object. Return typeReferenceGeometry |
ExampleTo check if ReferenceGeometry property a.example is a parameter by using the ReferenceGeometry.GetParameter() method: if (a.ViewParameters().GetParameter(a.example) ) do_something...
|
Warning(message[string], details (optional)[string])DescriptionAdds a warning for airbag reference geometry. 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 airbag reference geometry a: a.Warning("My custom warning");
|
Xrefs()DescriptionReturns the cross references for this airbag reference geometry. |
No arguments
ReturnsXrefs object. Return typeXrefs |
ExampleTo get the cross references for airbag reference geometry a: var xrefs = a.Xrefs();
|
toString()DescriptionCreates a string containing the ReferenceGeometry data in keyword format. Note that this contains the keyword header and the keyword cards. See also ReferenceGeometry.Keyword() and ReferenceGeometry.KeywordCards(). |
No arguments
Returnsstring Return typeString |
ExampleTo get data for ReferenceGeometry rdt in keyword format var s = rdt.toString();
|