Glyph Version 7.22.2 |
pw:: CutPlanePersistent cut plane type Derives FromSummary
create
This action creates a new cut plane object. ParametersThis action has no parameters. ReturnsThis actions returns a new pw::CutPlane object. ExampleThis examples shows how to create a persistent cut plane through two blocks at X=5. Code set cut [pw::CutPlane create] getAll
This action returns all of the currently defined cut planes. Cut planes from all framework paths are returned. ParametersThis action has no parameters. Returns; This action returns a list of pw::CutPlane objects. isValidMetric
This action checks to see if the specified examine function is valid for use with the cut planes. In order to be valid, an examine function has to support either structured, unstructured, or extruded blocks and not be voxel-based. Parameters
Returns; This function returns a boolean value indicating whether or not the metric function is valid for use with cut planes. NotesThis function does not check to see if the function works with the specific block types currently cut by the cut planes. For example, BlockLengthI is a valid metric even if no structured blocks are cut (or even present). applyMetric
This action applies a block metric function name to the cuts. Parameters
ReturnsThis action returns nothing. getMetric
This function returns the current block metric used by pw::CutPlane objects. ParametersNone ReturnsThis action returns a string value representing the metric function used by pw::CutPlane objects. refresh
This action runs the default metric function on any blocks cut by pw::CutPlane objects and updates the display of the cut planes. The default metric function is specified by pw::CutPlane.applyMetric. Parameters
ReturnsThis action has no return value. getByName
This action returns returns a pw::CutPlane using the name. Parameters
ReturnsThis actions returns a pw::CutPlane object. delete
This action deletes this cut plane. The cut plane’s pw::Cut objects will be deleted as well. ParametersNone. ReturnsThis action returns nothing. getPlaneType
This action returns whether the cutting plane type is a physical or computational type. ParametersNone. ReturnsThis function returns a string result of either “Physical” or “Computational”. setPointNormal
This action defines the cut plane as a plane centered on the given point with the specified normal. This is categorized as a physical cut. Parameters
ReturnsThis action does not return anything. setConstant
This action defines the cut plane as either a constant X, Y, Z, I, J, or K value. The first three types are categorized as physical cuts while the latter three are computational cuts. Parameters
ReturnsThis function returns nothing. setCoefficients
This function specifies the cutting plane via the coefficients of the plane equation Ax + By + Cz + D = 0. This plane type is categorized as a physical cut. Parameters
ReturnsThis action returns nothing. setPoints
This action sets the cutting plane by giving three points that plane will pass through. This plane type is categorized as a physical cut. Parameters
ReturnsThis action returns nothing. setPlane
This action defines the cutting plane via the result of any of the pwu::Plane definition methods. Parameters
ReturnsThis action returns nothing. getPlaneNormal
For physical cutting planes, this returns the plane normal. This action raises an error if the cutting plane type is computational. ParametersNone. ReturnsThis action returns the plane normal as a vector value if the plane is categorized as a physical plane. It raises an error otherwise. getPlaneDistance
For physical cutting planes, this returns the signed distance from the origin to the plane (the value of D in the plane equation Ax + By + Cz = D). This action raises an error if the cutting plane type is computational. ParametersNone. ReturnsThis action returns the signed distance from the origin to the plane as a float value if the plane is categorized as a physical plane. It raises an error if the plane is a computational plane. getPlaneCenterThis routine gets the center point on the plane if a physical plane is defined. An error is raised if this is a computational plane. ParametersNone. ReturnsThis action returns the center value as a vector. getPlane
This action gets the plane coefficients if the plane is a physical plane. It raises an error if the plane is a computational plane. Parameters
ReturnsThis action returns the plane as list of 4 coefficients. If the -D option is specified, the result can be treated as a pwu::Plane object. setComputationalPlane
This method defines the cutting plane as a computational plane at a specified constant computational axis. Parameters
ReturnsThis action returns nothing. getComputationalPlaneDirection
If the plane is defined as a computational plane, this returns the const computational direction (either “I”, “J”, or “K”). If this is a physical cutting plane, an error is raised. ParametersNone. ReturnsThis function returns the constant computational axis: “I”, “J”, or “K”. getComputationalPlaneIndex
This action gets the constant index of the computational plane. An error is raised if this is a physical plane. ParametersNone. ReturnsThis action returns the computational plane index as an integer value. getCuts
This action returns the individual cut objects associated with this cut plane. Each cut will correspond to a different block. ParametersNone. ReturnsThis actions returns a list of pw::Cut objects. getCut
This function returns the cut object corresponding to the intersection of this cut plane through the specified block. Parameters
ReturnsThis action returns a pw::Cut object. setForm
This action sets the cutting form for physical cuts. Parameters
NotesThis routine has no effect for computational cutting planes. ReturnsThis action returns nothing. getForm
This action returns the cutting form of the cutting plane. ParametersNone. ReturnsThis routine returns a string value representing the cutting plane form. The value with either be “Cells”, “Crinkle”, or “Flat”. For computational cutting planes, the form will always be “Flat”. getFrameworkPath
This function returns the path to the framework instance in which the cutting plane resides. ParametersNone. ReturnsThis action returns list of pw::Framework objects defining the framework path to the cutting plane. setRenderAttribute
This action sets the fill and line render attributes for the cutting plane’s cut objects. Parameters
ReturnsThis action returns nothing. See AlsogetRenderAttribute
This action gets the cut plane’s fill and line render attributes. Note that the cut plane’s individual cuts may have different attributes. Parameters
ReturnsThis action returns a string representing the value of the queried attribute. See AlsosetShrinkFactorThis action specifies the shrink factor to use for each displayed element in the cut plane’s cut objects. This value is applied to all cut objects belonging to the cut plane. Parameters
ReturnsThis action returns nothing. getShrinkFactor
This action returns the shrink factor specified for the cut plane. Note that individual cut objects may have been overridden with different shrink factors. ParametersNone. ReturnsThis action returns the shrink factor as a float value. setName
This function sets the cut plane name. Parameters
ReturnsThis action returns the new name (which may have been modified to make it unique). getNameThis function returns the name of the cutting plane. ParametersNone. ReturnsThis action returns the cutting plane’s name as a string value. */ static Gci::Status obj_getName(GciParser &parser, GlyphCutPlane *glyph) { if (Gci::OK != parser.endOfArgs()) { parser.usageError(1, “”); return Gci::Error; } parser.setResultGgString(glyph->getGgCutPlaneGroup()->getName()); return Gci::OK; } setEnabled
This function controls whether or not the cutting plane is displayed. Parameters
ReturnsThis action returns nothing. addBlock
This action specifies a block or list of blocks to be intersected by the cutting plane. If the cutting plane intersects a block, a new pw::Cut object will be generated. Parameters
ReturnsThis action returns nothing. getBlocks
This method returns a list of the blocks the cutting plane is monitoring. ParametersNone. ReturnsThis action returns a list of pw::Block objects the cutting plane is potentially cutting. setExtremaMode
This action controls whether or not the cutting plane repositions its cut objects in each block such that they intersect the minimum or maximum value. Parameters
ReturnsThis action returns nothing. NotesIf the extrema mode is enabled, physical cuts will retain the specified normal value, but will be moved to intersect the given extrema value. For computational cuts, the index will be modified to have the cut include the extrema value. If the extrema mode is “None” or no metric has been specified, the cuts will fallback to the specified plane definition. getExtremaMode
This method returns the current extrema setting for the cut plane group. ParametersNone. ReturnsThis action returns a string value indicating whether the cut plane group is set to move individual cuts to the minimum (“Minimum”) or maximum (“Maximum”) extrema of a block or the cut plane group will not modify the position of the cuts (“None”). setTransparency
This action sets the transparency level for the cut plane’s current and future cuts. Parameters
ReturnsThis action returns nothing. getTransparency
This action returns the transparency setting for the cut plane group. ParametersNone. ReturnsThis action returns a float value between 0 and 1 inclusive. A value of 0 means the cut plane group is set to fully opaque, while a value of 1 indicates the cut plane group is set to fully transparent. NoteThe transparency level can be set on individual cuts, so the value returned by this action does not necessarily reflect the value on each individual cut. setOversetRenderAttribute
This action sets the overset render attributes for the cutting plane’s cut objects. Parameters
ReturnsThis action returns nothing. See AlsoFringeOption, ShowHoleGrid, ShowHoleSymbol, ShowOrphans, ShowOrphanDonorCandidates getOversetRenderAttribute
This action returns the overset render attributes for the cutting plane. Parameters
ReturnsThis action returns a string representing the value of the specified attribute. See AlsoFringeOption, ShowHoleGrid, ShowHoleSymbol, ShowOrphans, ShowOrphanDonorCandidates resetRenderAttributes
This action resets the various display settings of a cut to their default values. This includes the FillMode, the LineMode, the transparency, the shrink factor, and the overset render attributes. ParametersNone. ReturnsThis action returns nothing. See AlsosetRenderAttribute, setOversetRenderAttribute, setShrinkFactor, setTransparency FillMode
This attribute is the fill mode for rendering a cut object. Typestring; < None | Flat | Shaded | HiddenLine > Information
See AlsoLineMode
This attribute is the line mode for rendering a cut object. This setting only applies when the fill mode is set to Flat or Shaded. Typestring; < All | None > Information
See AlsoFringeOption
This attribute controls how fringe information is displayed. Typestring; < Off | FringeOnly | FringeDonors > Information
See AlsoShowHoleGrid, ShowHoleSymbol, ShowOrphans, ShowOrphanDonorCandidates, setOversetRenderAttribute, getOversetRenderAttribute ShowHoleGrid
This attribute controls whether cells identified as holes by the IBLANK array are displayed. Typeboolean; < false | true > Information
See AlsoFringeOption, ShowHoleSymbol, ShowOrphans, ShowOrphanDonorCandidates, setOversetRenderAttribute, getOversetRenderAttribute ShowHoleSymbol
This attribute determines if a dot is drawn at the center of each cell identified as a hole by the IBLANK array. Typeboolean; < false | true > Information
See AlsoFringeOption, ShowHoleGrid, ShowOrphans, ShowOrphanDonorCandidates, setOversetRenderAttribute, getOversetRenderAttribute ShowOrphans
This attribute controls if orphan objects are rendered for the cut plane group. Typeboolean; < false | true > Information
See AlsoFringeOption, ShowHoleGrid, ShowHoleSymbol, ShowOrphanDonorCandidates, setOversetRenderAttribute, getOversetRenderAttribute ShowOrphanDonorCandidates
This attribute controls if orphan donor objects are displayed for the cut plane group. Typeboolean; < false | true > Information
See AlsoFringeOption, ShowHoleGrid, ShowHoleSymbol, ShowOrphans, setOversetRenderAttribute, getOversetRenderAttribute |
This action creates a new cut plane object.
pw::CutPlane create
This action returns all of the currently defined cut planes.
pw::CutPlane getAll
This action checks to see if the specified examine function is valid for use with the cut planes.
pw::CutPlane isValidMetric metric
This action applies a block metric function name to the cuts.
pw::CutPlane applyMetric
This function returns the current block metric used by pw::CutPlane objects.
pw::CutPlane getMetric
This action runs the default metric function on any blocks cut by pw::CutPlane objects and updates the display of the cut planes.
pw::CutPlane refresh ? -force ?
This action returns returns a pw::CutPlane using the name.
pw::CutPlane getByName name
This action deletes this cut plane.
$cutPlane delete
This action returns whether the cutting plane type is a physical or computational type.
$cutPlane getPlaneType
This action defines the cut plane as a plane centered on the given point with the specified normal.
$cutPlane setPointNormal $point $normal
This action defines the cut plane as either a constant X, Y, Z, I, J, or K value.
$cutPlane setConstant < -X | -Y | -Z | -I | -J | -K > value
This function specifies the cutting plane via the coefficients of the plane equation Ax + By + Cz + D = 0.
$cutPlane setCoefficients A B C D
This action sets the cutting plane by giving three points that plane will pass through.
$cutPlane setPoints point1 point2 point3
This action defines the cutting plane via the result of any of the pwu::Plane definition methods.
$cutPlane setPlane $plane_coeffs
For physical cutting planes, this returns the plane normal.
$cutPlane getPlaneNormal
For physical cutting planes, this returns the signed distance from the origin to the plane (the value of D in the plane equation Ax + By + Cz = D).
$cutPlane getPlaneDistance
This action gets the plane coefficients if the plane is a physical plane.
$cutPlane getPlane ?-D?
This method defines the cutting plane as a computational plane at a specified constant computational axis.
$cutPlane setComputationalPlane computational_direction index
If the plane is defined as a computational plane, this returns the const computational direction (either “I”, “J”, or “K”).
$cutPlane getComputationalPlaneDirection
This action gets the constant index of the computational plane.
$cutPlane getComputationalPlaneIndex
This action returns the individual cut objects associated with this cut plane.
$cutPlane getCuts
This function returns the cut object corresponding to the intersection of this cut plane through the specified block.
$cutPlane getCut $block
This action sets the cutting form for physical cuts.
$cut setForm < Cells | Crinkle | Flat >
This action returns the cutting form of the cutting plane.
$cutPlane getForm
This function returns the path to the framework instance in which the cutting plane resides.
$cutPlane getFrameworkPath
This action sets the fill and line render attributes for the cutting plane’s cut objects.
$cutPlane setRenderAttribute < FillMode | LineMode > value
This action gets the cut plane’s fill and line render attributes.
$cutPlane getRenderAttribute < FillMode | LineMode >
This action returns the shrink factor specified for the cut plane.
$cutPlane getShrinkFactor
This function sets the cut plane name.
$cutPlane setName name
This function controls whether or not the cutting plane is displayed.
$cutPlane setEnabled boolean
This function returns whether or not the cutting plane is enabled.
$cutPlane getEnabled
This action specifies a block or list of blocks to be intersected by the cutting plane.
$cutPlane addBlock $block
This action removes a block from the cutting plane and deletes the corresponding pw::Cut object.
$cutPlane removeBlock $block
This method returns a list of the blocks the cutting plane is monitoring.
$cutPlane getBlocks
This action controls whether or not the cutting plane repositions its cut objects in each block such that they intersect the minimum or maximum value.
$cutPlane setExtremaMode < None | Minimum | Maximum >
This method returns the current extrema setting for the cut plane group.
$cutPlane getExtremaMode
This action sets the transparency level for the cut plane’s current and future cuts.
$cutPlane setTransparency transparency
This action returns the transparency setting for the cut plane group.
$cutPlane getTransparency
This action sets the overset render attributes for the cutting plane’s cut objects.
$cutPlane setOversetRenderAttribute < FringeOption | ShowHoleGrid | ShowHoleSymbol | ShowOrphans | ShowOrphanDonorCandidates > value
This action returns the overset render attributes for the cutting plane.
$cutPlane getOversetRenderAttribute < FringeOption | ShowHoleGrid | ShowHoleSymbol | ShowOrphans | ShowOrphanDonorCandidates >
This action resets the various display settings of a cut to their default values.
$cut resetRenderAttributes
This attribute is the fill mode for rendering a cut object.
$cutPlane get/setRenderAttribute FillMode mode
This attribute is the line mode for rendering a cut object.
$cutPlane get/setRenderAttribute LineMode mode
This attribute controls how fringe information is displayed.
$cutPlane get/setOversetRenderAttribute FringeOption mode
This attribute controls whether cells identified as holes by the IBLANK array are displayed.
$cutPlane get/setOversetRenderAttribute ShowHoleGrid mode
This attribute determines if a dot is drawn at the center of each cell identified as a hole by the IBLANK array.
$cutPlane get/setOversetRenderAttribute ShowHoleSymbol mode
This attribute controls if orphan objects are rendered for the cut plane group.
$cutPlane get/setOversetRenderAttribute ShowOrphans mode
This attribute controls if orphan donor objects are displayed for the cut plane group.
$cutPlane get/setOversetRenderAttribute ShowOrphanDonorCandidates mode
This action creates an examine object.
pw::Examine create type