The IGAFaceXYZ class gives you access to IGA face xyz 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 | Description |
| IGAFaceXYZ.BASIS_TRANSFORM | BASIS_TRANSFORM is *IGA_FACE_XYZ_BASIS_TRANSFORM. |
| IGAFaceXYZ.NONE | NONE is *IGA_FACE_XYZ. |
| Name | Type | Description |
| entries (read only) | integer | Number of Boundary representation IDs (brid) or Element IDs (elid) added in IGA_FACE_XYZ. Can be used as index to add a new entry. |
| esid | integer | Parametric edge set ID. *SET_IGA_EDGE_UVW. |
| exists (read only) | logical | true if IGA Face XYZ exists, false if referred to but not defined. |
| fid | integer | IGAFaceXYZ number. Also see the label property which is an alternative name for this. |
| include | integer | The Include file number that the IGA Face XYZ is in. |
| label | integer | IGAFaceXYZ number. Also see the fid property which is an alternative name for this. |
| model (read only) | integer | The Model number that the IGA Face XYZ is in. |
| option | constant | IGA Face XYZ option. |
| ori | integer | Orientation with respect to the physical bivariate NURBS. |
| patchid | integer | Physical bivariate NURBS patch ID or a bivariate Basis Transform patch ID. |
| psid | integer | Parametric point set ID. *SET_IGA_POINT_UVW. |
Detailed DescriptionThe IGAFaceXYZ class allows you to create, modify, edit and manipulate IGA face xyz cards. See the documentation below for more details. |
Constructornew IGAFaceXYZ(Model[Model], details[object])DescriptionCreate a new IGAFaceXYZ object. |
Model that IGA face xyz will be created in
Details for creating the IGAFaceXYZ
Object has the following properties:
| Name | Type | Description |
| esid (optional) | integer | Parametric edge set ID. *SET_IGA_EDGE_UVW. |
| fid | integer | ID of the IGA Face XYZ. |
| option | constant | IGA Face XYZ option. IGAFaceXYZ.NONE or IGAFaceXYZ.BASIS_TRANSFORM |
| ori (optional) | integer | Orientation with respect to the physical bivariate NURBS. |
| patchid (optional) | integer | Physical bivariate NURBS patch ID or a bivariate basis transform patch ID. |
| psid (optional) | integer | Parametric point set ID. *SET_IGA_POINT_UVW. |
ReturnsIGAFaceXYZ object Return typeIGAFaceXYZ |
Details of functionsAssociateComment(Comment[Comment])DescriptionAssociates a comment with a IGA Face XYZ. |
Comment that will be attached to the IGA Face XYZ
ReturnsNo return value |
ExampleTo associate comment c to the IGA Face XYZ igfx: igfx.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 IGA Face XYZ igfx: igfx.Browse();
|
ClearFlag(flag[Flag])DescriptionClears a flag on the IGA Face XYZ. |
Flag to clear on the IGA Face XYZ
ReturnsNo return value |
ExampleTo clear flag f for IGA Face XYZ igfx: igfx.ClearFlag(f);
|
Copy(range (optional)[boolean])DescriptionCopies the IGA Face XYZ. The target include of the copied IGA Face XYZ 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().
ReturnsIGAFaceXYZ object Return typeIGAFaceXYZ |
ExampleTo copy IGA Face XYZ igfx into IGA Face XYZ z: var z = igfx.Copy();
|
Create(Model[Model], modal (optional)[boolean]) [static]DescriptionStarts an interactive editing panel to create a IGA Face XYZ |
Model that the IGA Face XYZ 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.
ReturnsIGAFaceXYZ object (or null if not made). Return typeIGAFaceXYZ |
ExampleTo start creating a IGA Face XYZ in model m: var igfx = IGAFaceXYZ.Create(m);
|
DetachComment(Comment[Comment])DescriptionDetaches a comment from a IGA Face XYZ. |
Comment that will be detached from the IGA Face XYZ
ReturnsNo return value |
ExampleTo detach comment c from the IGA Face XYZ igfx: igfx.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 IGA Face XYZ igfx: igfx.Edit();
|
Error(message[string], details (optional)[string])DescriptionAdds an error for IGA Face XYZ. 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 IGA Face XYZ igfx: igfx.Error("My custom error");
|
First(Model[Model]) [static]DescriptionReturns the first IGA Face XYZ in the model. |
Model to get first IGA Face XYZ in
ReturnsIGAFaceXYZ object (or null if there are no IGA Face XYZs in the model). Return typeIGAFaceXYZ |
ExampleTo get the first IGA Face XYZ in model m: var igfx = IGAFaceXYZ.First(m);
|
FirstFreeLabel(Model[Model], layer (optional)[Include number]) [static]DescriptionReturns the first free IGA Face XYZ label in the model. Also see IGAFaceXYZ.LastFreeLabel(), IGAFaceXYZ.NextFreeLabel() and Model.FirstFreeItemLabel(). |
Model to get first free IGA Face XYZ 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).
ReturnsIGAFaceXYZ label. Return typeNumber |
ExampleTo get the first free IGA Face XYZ label in model m: var label = IGAFaceXYZ.FirstFreeLabel(m);
|
FlagAll(Model[Model], flag[Flag]) [static]DescriptionFlags all of the IGA Face XYZs in the model with a defined flag. |
Model that all IGA Face XYZs will be flagged in
Flag to set on the IGA Face XYZs
ReturnsNo return value |
ExampleTo flag all of the IGA Face XYZs with flag f in model m: IGAFaceXYZ.FlagAll(m, f);
|
Flagged(flag[Flag])DescriptionChecks if the IGA Face XYZ is flagged or not. |
Flag to test on the IGA Face XYZ
Returnstrue if flagged, false if not. Return typeBoolean |
ExampleTo check if IGA Face XYZ igfx has flag f set on it: if (igfx.Flagged(f) ) do_something...
|
ForEach(Model[Model], func[function], extra (optional)[any]) [static]DescriptionCalls a function for each IGA Face XYZ in the model. |
Model that all IGA Face XYZs are in
Function to call for each IGA Face XYZ
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 IGAFaceXYZ objects or properties for all of the IGA Face XYZs in a model in PRIMER. If the optional property argument is not given then an array of IGAFaceXYZ objects is returned. If the property argument is given, that property value for each IGA Face XYZ is returned in the array instead of a IGAFaceXYZ object |
Model to get IGA Face XYZs from
Name for property to get for all IGA Face XYZs in the model
ReturnsArray of IGAFaceXYZ objects or properties Return typeArray |
GetComments()DescriptionExtracts the comments associated to a IGA Face XYZ. |
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 IGA Face XYZ igfx: var comm_array = igfx.GetComments();
|
GetData(index[integer])DescriptionReturns the data for brid/elid based on option in *IGA_FACE_XYZ. |
Index you want the data for. Note that indices start at 0.
ReturnsThe ID of boundary representation or basis transform element depending on option. Return typeNumber |
ExampleTo get the 3rd data entry in IGA face xyz igfx: var data = igfx.GetData(2);
|
GetFlagged(Model[Model], flag[Flag], property (optional)[string]) [static]DescriptionReturns an array of IGAFaceXYZ objects for all of the flagged IGA Face XYZs in a model in PRIMER If the optional property argument is not given then an array of IGAFaceXYZ objects is returned. If the property argument is given, then that property value for each IGA Face XYZ is returned in the array instead of a IGAFaceXYZ object |
Model to get IGA Face XYZs from
Flag set on the IGA Face XYZs that you want to retrieve
Name for property to get for all flagged IGA Face XYZs in the model
ReturnsArray of IGAFaceXYZ objects or properties Return typeArray |
GetFromID(Model[Model], number[integer]) [static]DescriptionReturns the IGAFaceXYZ object for a IGA Face XYZ ID. |
Model to find the IGA Face XYZ in
number of the IGA Face XYZ you want the IGAFaceXYZ object for
ReturnsIGAFaceXYZ object (or null if IGA Face XYZ does not exist). Return typeIGAFaceXYZ |
ExampleTo get the IGAFaceXYZ object for IGA Face XYZ 100 in model m var igfx = IGAFaceXYZ.GetFromID(m, 100);
|
GetParameter(prop[string])DescriptionChecks if a IGAFaceXYZ 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 IGAFaceXYZ.ViewParameters() method and 'method chaining' (see the examples below). |
IGA Face XYZ property to get parameter for
ReturnsParameter object if property is a parameter, null if not. Return typeParameter |
Keyword()DescriptionReturns the keyword for this IGA face xyz (*IGA_FACE_XYZ). Note that a carriage return is not added. See also IGAFaceXYZ.KeywordCards() |
No arguments
Returnsstring containing the keyword. Return typeString |
ExampleTo get the keyword for IGA face xyz igfx: var key = igfx.Keyword();
|
KeywordCards()DescriptionReturns the keyword cards for the IGA face xyz. Note that a carriage return is not added. See also IGAFaceXYZ.Keyword() |
No arguments
Returnsstring containing the cards. Return typeString |
ExampleTo get the cards for IGA face xyz igfx: var cards = igfx.KeywordCards();
|
Last(Model[Model]) [static]DescriptionReturns the last IGA Face XYZ in the model. |
Model to get last IGA Face XYZ in
ReturnsIGAFaceXYZ object (or null if there are no IGA Face XYZs in the model). Return typeIGAFaceXYZ |
ExampleTo get the last IGA Face XYZ in model m: var igfx = IGAFaceXYZ.Last(m);
|
LastFreeLabel(Model[Model], layer (optional)[Include number]) [static]DescriptionReturns the last free IGA Face XYZ label in the model. Also see IGAFaceXYZ.FirstFreeLabel(), IGAFaceXYZ.NextFreeLabel() and see Model.LastFreeItemLabel() |
Model to get last free IGA Face XYZ 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.
ReturnsIGAFaceXYZ label. Return typeNumber |
ExampleTo get the last free IGA Face XYZ label in model m: var label = IGAFaceXYZ.LastFreeLabel(m);
|
Next()DescriptionReturns the next IGA Face XYZ in the model. |
No arguments
ReturnsIGAFaceXYZ object (or null if there are no more IGA Face XYZs in the model). Return typeIGAFaceXYZ |
ExampleTo get the IGA Face XYZ in model m after IGA Face XYZ igfx: var igfx = igfx.Next();
|
NextFreeLabel(Model[Model], layer (optional)[Include number]) [static]DescriptionReturns the next free (highest+1) IGA Face XYZ label in the model. Also see IGAFaceXYZ.FirstFreeLabel(), IGAFaceXYZ.LastFreeLabel() and Model.NextFreeItemLabel() |
Model to get next free IGA Face XYZ 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).
ReturnsIGAFaceXYZ label. Return typeNumber |
ExampleTo get the next free IGA Face XYZ label in model m: var label = IGAFaceXYZ.NextFreeLabel(m);
|
Previous()DescriptionReturns the previous IGA Face XYZ in the model. |
No arguments
ReturnsIGAFaceXYZ object (or null if there are no more IGA Face XYZs in the model). Return typeIGAFaceXYZ |
ExampleTo get the IGA Face XYZ in model m before IGA Face XYZ igfx: var igfx = igfx.Previous();
|
RemoveData(index[integer])DescriptionRemoves brid/elid for an index in *IGA_FACE_XYZ. |
The index you want to delete brid/elid for. Note that indices start at 0, not 1.
ReturnsNo return value. |
ExampleTo delete the brid/elid for the 3rd index for *IGA_FACE_XYZ in model m: if (igfx.entries >= 3)
{
igfx.RemoveData(2);
}
|
RenumberAll(Model[Model], start[integer]) [static]DescriptionRenumbers all of the IGA Face XYZs in the model. |
Model that all IGA Face XYZs will be renumbered in
Start point for renumbering
ReturnsNo return value |
ExampleTo renumber all of the IGA Face XYZs in model m, from 1000000: IGAFaceXYZ.RenumberAll(m, 1000000);
|
RenumberFlagged(Model[Model], flag[Flag], start[integer]) [static]DescriptionRenumbers all of the flagged IGA Face XYZs in the model. |
Model that all the flagged IGA Face XYZs will be renumbered in
Flag set on the IGA Face XYZs that you want to renumber
Start point for renumbering
ReturnsNo return value |
ExampleTo renumber all of the IGA Face XYZs in model m flagged with f, from 1000000: IGAFaceXYZ.RenumberFlagged(m, f, 1000000);
|
Select(flag[Flag], prompt[string], limit (optional)[Model or Flag], modal (optional)[boolean]) [static]DescriptionAllows the user to select IGA Face XYZs using standard PRIMER object menus. |
Flag to use when selecting IGA Face XYZs
Text to display as a prompt to the user
If the argument is a Model then only IGA Face XYZs from that model can be selected. If the argument is a Flag then only IGA Face XYZs that are flagged with limit can be selected (limit should be different to flag). If omitted, or null, any IGA Face XYZs 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 IGA Face XYZs selected or null if menu cancelled Return typeNumber |
SetData(index[integer], brid[integer])DescriptionSets brid/elid based on option for an *IGA_FACE_XYZ. |
Index you want to set the brid/elid for. Note that indices start at 0.
The ID of boundary representation or basis transform element depending on option.
ReturnsNo return value. |
SetFlag(flag[Flag])DescriptionSets a flag on the IGA Face XYZ. |
Flag to set on the IGA Face XYZ
ReturnsNo return value |
ExampleTo set flag f for IGA Face XYZ igfx: igfx.SetFlag(f);
|
Sketch(redraw (optional)[boolean])DescriptionSketches the IGA Face XYZ. The IGA Face XYZ will be sketched until you either call IGAFaceXYZ.Unsketch(), IGAFaceXYZ.UnsketchAll(), Model.UnsketchAll(), or delete the model |
If model should be redrawn or not after the IGA Face XYZ is sketched. If omitted redraw is true. If you want to sketch several IGA Face XYZs and only redraw after the last one then use false for redraw and call View.Redraw().
ReturnsNo return value |
ExampleTo sketch IGA Face XYZ igfx: igfx.Sketch();
|
SketchFlagged(Model[Model], flag[Flag], redraw (optional)[boolean]) [static]DescriptionSketches all of the flagged IGA Face XYZs in the model. The IGA Face XYZs will be sketched until you either call IGAFaceXYZ.Unsketch(), IGAFaceXYZ.UnsketchFlagged(), Model.UnsketchAll(), or delete the model |
Model that all the flagged IGA Face XYZs will be sketched in
Flag set on the IGA Face XYZs that you want to sketch
If model should be redrawn or not after the IGA Face XYZs are sketched. If omitted redraw is true. If you want to sketch flagged IGA Face XYZs several times and only redraw after the last one then use false for redraw and call View.Redraw().
ReturnsNo return value |
ExampleTo sketch all IGA Face XYZs flagged with flag in model m: IGAFaceXYZ.SketchFlagged(m, flag);
|
Total(Model[Model], exists (optional)[boolean]) [static]DescriptionReturns the total number of IGA Face XYZs in the model. |
Model to get total for
true if only existing IGA Face XYZs should be counted. If false or omitted referenced but undefined IGA Face XYZs will also be included in the total.
Returnsnumber of IGA Face XYZs Return typeNumber |
ExampleTo get the total number of IGA Face XYZs in model m: var total = IGAFaceXYZ.Total(m);
|
UnflagAll(Model[Model], flag[Flag]) [static]DescriptionUnsets a defined flag on all of the IGA Face XYZs in the model. |
Model that the defined flag for all IGA Face XYZs will be unset in
Flag to unset on the IGA Face XYZs
ReturnsNo return value |
ExampleTo unset the flag f on all the IGA Face XYZs in model m: IGAFaceXYZ.UnflagAll(m, f);
|
Unsketch(redraw (optional)[boolean])DescriptionUnsketches the IGA Face XYZ. |
If model should be redrawn or not after the IGA Face XYZ is unsketched. If omitted redraw is true. If you want to unsketch several IGA Face XYZs and only redraw after the last one then use false for redraw and call View.Redraw().
ReturnsNo return value |
ExampleTo unsketch IGA Face XYZ igfx: igfx.Unsketch();
|
UnsketchAll(Model[Model], redraw (optional)[boolean]) [static]DescriptionUnsketches all IGA Face XYZs. |
Model that all IGA Face XYZs will be unblanked in
If model should be redrawn or not after the IGA Face XYZs 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 IGA Face XYZs in model m: IGAFaceXYZ.UnsketchAll(m);
|
UnsketchFlagged(Model[Model], flag[Flag], redraw (optional)[boolean]) [static]DescriptionUnsketches all flagged IGA Face XYZs in the model. |
Model that all IGA Face XYZs will be unsketched in
Flag set on the IGA Face XYZs that you want to unsketch
If model should be redrawn or not after the IGA Face XYZs 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 IGA Face XYZs flagged with flag in model m: IGAFaceXYZ.UnsketchAll(m, flag);
|
No arguments
ReturnsIGAFaceXYZ object. Return typeIGAFaceXYZ |
ExampleTo check if IGAFaceXYZ property igfx.example is a parameter by using the IGAFaceXYZ.GetParameter() method: if (igfx.ViewParameters().GetParameter(igfx.example) ) do_something...
|
Warning(message[string], details (optional)[string])DescriptionAdds a warning for IGA Face XYZ. 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 IGA Face XYZ igfx: igfx.Warning("My custom warning");
|
Xrefs()DescriptionReturns the cross references for this IGA Face XYZ. |
No arguments
ReturnsXrefs object. Return typeXrefs |
ExampleTo get the cross references for IGA Face XYZ igfx: var xrefs = igfx.Xrefs();
|
toString()DescriptionCreates a string containing the IGA face xyz data in keyword format. Note that this contains the keyword header and the keyword cards. See also IGAFaceXYZ.Keyword() and IGAFaceXYZ.KeywordCards(). |
No arguments
Returnsstring Return typeString |
ExampleTo get data for IGA face xyz igfx in keyword format var s = igfx.toString();
|