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