Difference between revisions of "MGED CMD nmg"
From BRL-CAD
Bhollister (talk | contribs) (→Proposed subcommands) |
Bhollister (talk | contribs) (→Proposed subcommands) |
||
| Line 23: | Line 23: | ||
==Proposed subcommands== | ==Proposed subcommands== | ||
| − | : ''' | + | : ''' make V ''' ''vertex-list'' |
:: Creates vertices in first encountered region and shell, using the ''vertex-list''. For example: nmg myobject create V 0 0 0 0 1 0 1 1 0 1 0 0 1 0 1 0 0 1 0 1 1 1 1 1 | :: Creates vertices in first encountered region and shell, using the ''vertex-list''. For example: nmg myobject create V 0 0 0 0 1 0 1 1 0 1 0 0 1 0 1 0 0 1 0 1 1 1 1 1 | ||
| − | : ''' | + | : ''' make F ''' |
:: Creates faces in first encountered region and shell. First, assigns a distinct color to each vertex in the model and assigns a corresponding enumeration. Command returns lines for each vertex. The line format is: vertex # (selectable by user), and vertex color. The output line text color is the vertex color for that line. The geometry viewer labels all vertices in their colors, until a ''face-list'' is entered at the subsequent prompt for input. | :: Creates faces in first encountered region and shell. First, assigns a distinct color to each vertex in the model and assigns a corresponding enumeration. Command returns lines for each vertex. The line format is: vertex # (selectable by user), and vertex color. The output line text color is the vertex color for that line. The geometry viewer labels all vertices in their colors, until a ''face-list'' is entered at the subsequent prompt for input. | ||
Revision as of 19:03, 20 July 2015
nmg design
Contents
Syntax
- nmg subcommand object [suffix]
Arguments
- object
- Name for the primitive that you want to operate on.
- subcommand
- Command specified to alter an NMG object. Each has it's own set of arguments.
Subcommands
- mm
- Creates a new NMG model structure and fills the appropriate fields. The result is an empty model.
- cmface
- Generates a manifold face in the first encountered shell of the NMG object. Vertices are listed as the suffix and define the winding-order of the face. Faces require at least three specified vertices, each specified by three coordinates. In addition to creating a face, the subcommand will join edges of the new face with dangling edges of other faces in the same shell. This makes it easier for the application to generate topologically correct, closed, manifold objects.
Proposed subcommands
- make V vertex-list
- Creates vertices in first encountered region and shell, using the vertex-list. For example: nmg myobject create V 0 0 0 0 1 0 1 1 0 1 0 0 1 0 1 0 0 1 0 1 1 1 1 1
- make F
- Creates faces in first encountered region and shell. First, assigns a distinct color to each vertex in the model and assigns a corresponding enumeration. Command returns lines for each vertex. The line format is: vertex # (selectable by user), and vertex color. The output line text color is the vertex color for that line. The geometry viewer labels all vertices in their colors, until a face-list is entered at the subsequent prompt for input.
- For example:
- mged> nmg myobject create F
- mged> F 4 5 6 7 F 0 1 6 5 F 1 2 7 6 F 2 3 4 7 F 0 5 4 3
- For example:
- kill R
- Removes the region and its geometry for the selected region. First, assigns a distinct color to each region in the model and assigns a corresponding enumeration. Command returns lines for each region. The line format is: region # (selectable by user), and region color. The output line text color is the region color for that line. The geometry viewer labels all regions in their colors, until the region is selected for removal at the subsequent prompt for input.
- kill S
- Removes the shell and its geometry for the selected shell. First, assigns a distinct color to each shell in the model and assigns a corresponding enumeration. Command returns lines for each shell. The line format is: shell # (selectable by user), and shell color. The output line text color is the shell color for that line. The geometry viewer labels all shells in their colors, until the shell is selected for removal at the subsequent prompt for input.
- kill F
- Removes the faceuse and face geometry of the selected face. First, assigns a distinct color to each face in the model and assigns a corresponding enumeration. Command returns lines for each face. The line format is: face # (selectable by user), and face color. The output line text color is the face color for that line. The geometry viewer labels all faces in their colors, until the face is selected for removal at the subsequent prompt for input.
- kill V
- Removes the vertexuse and vertex geometry of the selected vertex. First, assigns a distinct color to each vertex in the model and assigns a corresponding enumeration. Command returns lines for each vertex. The line format is: vertex # (selectable by user), and vertex color. The output line text color is the vertex color for that line. The geometry viewer labels all vertices in their colors, until the vertex is selected for removal at the subsequent prompt for input.
Return Value(s)
- No Return Values for this command.
Description
- The "nmg" command is a command for creating, adding geometry, and manipulating NMG objects in BRL-CAD. All operations are result in the addition of manifold geometry to the object.
Example(s)
- mged> nmg mm cube
- Creates an empty NMG object.
- mged> nmg cmface cube 0 0 0 0 1 0 1 1 0 1 0 0
- Creates 1st face of a six-sided cube.
- mged> nmg cmface cube 1 0 1 0 0 1 0 1 1 1 1 1
- Creates 2nd face of a six-sided cube.
- mged> nmg cmface cube 0 0 0 0 1 0 0 1 1 0 0 1
- Creates 3rd face of a six-sided cube.
- mged> nmg cmface cube 0 1 0 1 1 0 1 1 1 0 1 1
- Creates 4th face of a six-sided cube.
- mged> nmg cmface cube 1 1 0 1 0 0 1 0 1 1 1 1
- Creates 5th face of a six-sided cube.
- mged> nmg cmface cube 0 0 0 0 0 1 1 0 1 1 0 0
- Creates 6th face of a six-sided cube.
See Also
- NMG Editing project idea page
- put for use with NMG objects
- brep command
- Wikipedia article on polygon mesh
