Share

GraphicsNode Object


Description

The GraphicsNode object provides a logical grouping of Client graphics. It is the lowest level of detail the user will see when selecting objects.

Methods

Name Description
AddComponentGraphics Method that creates a new ComponentGraphics object based on the input ComponentDefinition.
AddCurveGraphics Method that creates a new CurveGraphics graphic primitive.
AddLineGraphics Method that creates a new LineGraphics graphic primitive.
AddLineStripGraphics Method that creates a new LineStripGraphics graphic primitive.
AddPointGraphics Method that creates a new PointGraphics graphic primitive.
AddScalableTextGraphics Method that creates a new (scalable) TextGraphics graphic primitive.
AddSurfaceGraphics Method that creates a new SurfaceGraphics object based on the input surface(s).
AddTextGraphics Method that creates a new TextGraphics graphic primitive.
AddTriangleFanGraphics Method that creates a new TriangleFanGraphics graphic primitive.
AddTriangleGraphics Method that creates a new TriangleGraphics graphic primitive.
AddTriangleStripGraphics Method that creates a new TriangleStripGraphics graphic primitive.
ClearSlice Method that clears all the slicing applied to the graphics node.
Copy Method that creates a copy of this . The copy has the same property values as the original, a duplicate of all of the graphics primitives, and the CustomRenderStyle has the same values. A new ID is generated for the copy.
Delete Method that deletes the GraphicsNode. This also deletes all associated graphic primitives.

Properties

Name Description
AllowSliceCapping Specifies that whether this graphics node will display a cap or not when sliced.
AllowSlicing Specifies that the node participates in slicing of client graphics.
Appearance Gets and sets the appearance asset associated with the graphics node.
Application Returns the top-level parent application object. When used the context of Inventor, an Application object is returned. When used in the context of Apprentice, an ApprenticeServer object is returned.
Count Property that returns the number of graphic primitive objects associated with this GraphicsNode object.
DisplayName Read-write Property that gets and sets display name of this graphics node.
ExcludedFromViewAll Specifies that the node is not considered when doing a view all.
Id Property that returns the Id of the GraphicsNode.
IsTransparentInPlaceEdit Read-write Property that gets and sets transparency behavior of this graphics node in inactive mode.
Item Returns the specified graphic entity from the collection.
ItemById Returns the specified GraphicsPrimitive from the collection using its Id as index.
OverrideOpacity Override Opacity that controls the transparencty of the node.
Parent Property that returns the object this graphics node belongs to.
RangeBox Property that returns a Box object which contains the opposing points of a rectangular box that is guaranteed to enclose this object.
Selectable Property that specifies whether the GraphicsNode object can be selected when the Select command is running in Inventor.
Transformation Property that gets and sets the transformation of the GraphicsNode.
Type Returns an ObjectTypeEnum indicating this object's type.
Visible Read-write property that gets and sets whether the GraphicsNode is visible or not.
VisibleInActiveEditObject Read-write property that gets and sets whether this graphics node is visible when the containing object is not the active edit object. A value of True indicates that this node is visible only when the containing object is activated. The value of this property is ignored if the Visible property on GraphicsNode is False.
VisibleInViews Property that returns a object containing the Views that this graphics node is visible in. If there are no views in the list, the node is visible in all views. Views may be added or removed from the list. This property is ignored if the Visible property on GraphicsNode is False.

Accessed From

ClientGraphics.AddNode, ClientGraphics.Item, ClientGraphics.ItemById, ComponentGraphics.Parent, CurveGraphics.Parent, FeatureGraphics.Parent, GraphicsNode.Copy, GraphicsNodeProxy.Copy, GraphicsNodeProxy.NativeObject, GraphicsPrimitive.Parent, LineGraphics.Parent, LineStripGraphics.Parent, PointGraphics.Parent, SurfaceGraphics.Parent, SweepGraphics.Parent, TextGraphics.Parent, TriangleFanGraphics.Parent, TriangleGraphics.Parent, TriangleStripGraphics.Parent

Derived Classes

GraphicsNodeProxy

Samples

Name Description
Client Graphics - Draw Range Box This sample demonstrates the use of client graphics to draw the range box of selected entities.
Client graphics texture-based color mapping This test applies texture coordinates expressing distance from the origin to 'the triangle mesh of whatever Part you have open. It then creates either a discrete-band or continuous color mapper and allows you to adjust the values of the mapper to change the range of values that map to various colors.
Client Graphics - Vertex Color by Z Height This sample demonstrates using client graphics and some other functions that help to support display control. It uses the currently active part and replaces the part display with a display where the part's color varies from blue to red where blue is assigned to the lowest Z portion of the part and red is assigned to the highest Z portion of the part. Areas in between are represented by a smooth blend of color from blue to red.
Client Graphics - Line This sample demonstrates the creation of custom graphics using LineGraphics and LineStripGraphics. The same set of coordinate data is used for both types of graphics. Line graphics use two coordinates to define a line, and then the next two coordinates to define the next line, and so on through the defined coordinates. For the data provided, this results in gaps in the drawn curve. Line strips use the first two coordinates to define the first line and then the last point of the first line becomes the first point of the second line and the next coordinate is used as the end point of the second line. This results in the set of points being connected by a continuous set of lines, drawing a continuous curve. This sample also demonstrates two methods of defining the color for client graphics. In one case it uses an existing appearance asset, and in the other, it explicitly defines a color and assigns it. To use the sample you need to have an assembly or part document open. The program has two behaviors: the first time it is run it will draw the graphics. The second time it is run it deletes the previously drawn graphics.
Client graphics from SAT file body The following sample demonstrates how to display client graphics based on bodies read in from a SAT file.
Client Graphics - Triangle This sample demonstrates the creation of client graphics triangles using triange fans and strips. It does this by drawing a cylinder. The end caps are triangle fans and the cylinder is made from a triangle strip.
3D Curve from Parametric Curve Demonstrates the conversion of a 2d parameteric space curve into the equivalent 3d model space curve. To use this sample you must have a part open. You can select any face and 3D curves will be drawn on the face using client graphics.
Client graphics - image in point graphics The following sample demonstrates creation of point client graphics with a custom image.
Selection of Surface Graphics Primitives This demonstrates the ability to select client graphic primitives, by creating SurfaceGraphics and showing how you can select B-Rep entities within the graphics. You must have a part or assembly open and select a part of sat file which will be read in and displayed as client graphics. Depending on our responses to the program it will create the graphics so that only the node is selectable (which is all that was supported before), so that all of the primitives are selected, or so that only certain primitives are selectable (every other face in this case).
Transient solid body creation The following sample demonstrates the creation of a transient solid block body. The newly created body is then displayed using client graphics in a part.
Client graphics creation of 3D primitives This sample demonstrates the creation of 3D primitives (cylinder, cone, etc.) using client graphics.
Create curve primitives This sample demonstrates the creation of curve primitives (lines, arcs, circles, etc.) using client graphics.
OnDrag Event - dragging a WorkPoint This sample demonstrates the use of the OnDrag event to drag fixed work points when no command is active. This sample only allows drags parallel to the X-Y plane. This sample is dependent on events and VB only supports events within a class module.

Version

Introduced in version 5

Was this information helpful?