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