EditObject

Create an edit object feature in 2D.

Syntax

model.geom(<tag>).create(<ftag>,"EditObject");

model.geom(<tag>).feature(<ftag>).set(property,<value>);

model.geom(<tag>).feature(<ftag>).getType(property);

model.geom(<tag>).feature(<ftag>).vertexNew();

model.geom(<tag>).feature(<ftag>).vertexDelete(<vertex>);

model.geom(<tag>).feature(<ftag>).vertexSnap(<vertex>);

model.geom(<tag>).feature(<ftag>).startVertexDisconnect(<edge>);

model.geom(<tag>).feature(<ftag>).endVertexDisconnect(<edge>);

model.geom(<tag>).feature(<ftag>).edgeNew();

model.geom(<tag>).feature(<ftag>).edgeDelete(<edge>);

Description

Use model.geom(<tag>).create(<ftag>,"EditObject") to create an edit object feature.

Use model.geom(<tag>).feature(<ftag>).vertexNew() to add a new vertex to the object.

Use model.geom(<tag>).feature(<ftag>).vertexDelete(<vertex>) to delete <vertex> from the object.

Use model.geom(<tag>).feature(<ftag>).vertexSnap(<vertex>) to delete <vertex> from the object, and move any adjacent edges to the closest remaining vertex.

Use model.geom(<tag>).feature(<ftag>).startVertexDisconnect(<edge>) to create a new vertex and use this vertex as the start vertex for <edge>.

Use model.geom(<tag>).feature(<ftag>).endVertexDisconnect(<edge>) to create a new vertex and use this vertex as the end vertex for <edge>.

Use model.geom(<tag>).feature(<ftag>).edgeNew() to add a new edge to the object.

Use model.geom(<tag>).feature(<ftag>).edgeDelete(<edge>) to delete <edge> from the object.

The following properties are available:

Table 3-47: Valid Property/Value Pairs

Property	Value	Default	Description
input	Selection		Geometry object to edit.
vertex	integer|""		Vertex to edit.
xvertex	double	0	x-coordinate of vertex being edited.
yvertex	double	0	y-coordinate of vertex being edited.
edge	integer | ""		Edge to edit.
x	double[]		x-coordinates of control points of edge being edited.
y	double[]		y-coordinates of control points of edge being edited.
weights	double[]		Weights of control points of edge being edited.
knots	double[]		Knots of NURBS curve for edge being edited.
degree	1 | 2 | 3		Degree of edge being edited.
start	integer | ""		Start vertex of edge being edited.
end	integer | ""		End vertex of edge being edited.
selresult	on | off	off	Create selections of all resulting objects.
selresultshow	all | obj | dom | bnd | pnt | off	dom	Show selections, if selresult is on, in physics, materials, and so on; in part instances; or in 3D from a plane geometry. obj is not available in a component’s geometry. dom, bnd, and edg are not available in all features.
contributeto	String	none	Tag of cumulative selection to contribute to.

For information about the selresult and contributeto properties, see Selections of Geometric Entities.

Example

The following sequence edits a circle, setting the degree of one edge to one to create a straight edge:

Code for use with Java

Model model = ModelUtil.create("Model");

GeomSequence g = model.geom().create("geom1", 2);

g.create("c1", "Circle");

g.run("c1");

g.create("edo1", "EditObject");

g.feature("edo1").selection("input").set(new String[]{"c1"});

g.feature("edo1").set("edge", "1");

g.feature("edo1").set("degree", "1");

g.run("edo1");

Code for use with MATLAB

model = ModelUtil.create('Model');

g = model.geom.create('geom1', 2);

g.create('c1', 'Circle');

g.run('c1');

g.create('edo1', 'EditObject');

g.feature('edo1').selection('input').set({'c1'});

g.feature('edo1').set('edge', '1');

g.feature('edo1').set('degree', '1');

g.run('edo1');

See Also

 BezierPolygon