Bhollister (Talk | contribs) (→Proposed subcommands) |
Bhollister (Talk | contribs) m |
||
(16 intermediate revisions by one user not shown) | |||
Line 1: | Line 1: | ||
+ | {{DesignDocument}} | ||
+ | |||
=nmg ''design'' = | =nmg ''design'' = | ||
__TOC__ | __TOC__ | ||
==Syntax== | ==Syntax== | ||
− | :nmg | + | :nmg object subcommand [suffix] |
==Arguments== | ==Arguments== | ||
Line 21: | Line 23: | ||
:: 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. | :: 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. | ||
− | + | : '''kill V''' | |
+ | :: Removes the vertexuse and vertex geometry of the selected vertex (via its coordinates). When specifying vertex to be removed, user generally will display vertex coordinates in object via the MGED command [http://brlcad.org/wiki/MGED_CMD_labelvert labelvert]. '''Note: vertex selection via their index number is not currently supported.''' | ||
− | : ''' | + | ::For example: |
− | :: Creates | + | ::: '''mged>''' labelvert myobj |
− | : ''' | + | ::: '''mged>''' nmg myobj kill V 0.0 2.537 1.289 |
− | :: Creates | + | |
+ | : '''kill F''' | ||
+ | :: Removes the faceuse and face geometry of the selected face (via its index). When specifying the face to be removed, user generally will display face indices in object via the MGED command [http://brlcad.org/wiki/MGED_CMD_labelvert labelface]. | ||
+ | |||
+ | ::For example: | ||
+ | ::: '''mged>''' labelface myobj | ||
+ | ::: '''mged>''' nmg myobj kill F 14 | ||
+ | |||
+ | : ''' move V ''' ''x_initial y_initial z_initial x_final y_final z_final'' | ||
+ | :: Moves an existing vertex specified by the coordinates ''x_initial y_initial z_initial'' to the position with coordinates ''x_final y_final z_final''. | ||
+ | |||
+ | ::For example: | ||
+ | ::: '''mged>''' nmg myobject move V 1.0 1.0 1.0 2.0 2.0 2.0 | ||
+ | |||
+ | : ''' make V ''' ''vertex-list'' | ||
+ | :: Creates a new vertex and shell for all vertices, using the ''vertex-list''. | ||
+ | |||
+ | ::For example: | ||
+ | ::: '''mged>''' nmg myobject make 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 ''' ''face-list'' | ||
+ | :: Creates face(s) in first encountered region and shell. General usage is to first label vertices with their index number using [[MGED_CMD_labelvert#Proposed_Argument.28s.29 | labelvert -i]]. | ||
::For example: | ::For example: | ||
− | ::: '''mged>''' | + | ::: '''mged>''' labelvert -i myobject |
− | ::: '''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 | + | ::: '''mged>''' nmg myobject make 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 |
− | + | ||
− | + | '''Note: index numbers may change after 'make F' command. Thus, execute labelvert witht the -i option before each use of 'make F'.''' | |
− | : '' | + | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
==Return Value(s)== | ==Return Value(s)== | ||
Line 52: | Line 70: | ||
--> | --> | ||
− | : '''mged>''' nmg | + | : '''mged>''' nmg cube mm |
:: Creates an empty NMG object. | :: Creates an empty NMG object. | ||
− | : '''mged>''' nmg | + | : '''mged>''' nmg cube cmface 0 0 0 0 1 0 1 1 0 1 0 0 |
:: Creates 1st face of a six-sided cube. | :: Creates 1st face of a six-sided cube. | ||
− | : '''mged>''' nmg | + | : '''mged>''' nmg cube cmface 1 0 1 0 0 1 0 1 1 1 1 1 |
:: Creates 2nd face of a six-sided cube. | :: Creates 2nd face of a six-sided cube. | ||
− | : '''mged>''' nmg | + | : '''mged>''' nmg cube cmface 0 0 0 0 1 0 0 1 1 0 0 1 |
:: Creates 3rd face of a six-sided cube. | :: Creates 3rd face of a six-sided cube. | ||
− | : '''mged>''' nmg | + | : '''mged>''' nmg cube cmface 0 1 0 1 1 0 1 1 1 0 1 1 |
:: Creates 4th face of a six-sided cube. | :: Creates 4th face of a six-sided cube. | ||
− | : '''mged>''' nmg | + | : '''mged>''' nmg cube cmface 1 1 0 1 0 0 1 0 1 1 1 1 |
:: Creates 5th face of a six-sided cube. | :: Creates 5th face of a six-sided cube. | ||
− | : '''mged>''' nmg | + | : '''mged>''' nmg cube cmface 0 0 0 0 0 1 1 0 1 1 0 0 |
:: Creates 6th face of a six-sided cube. | :: Creates 6th face of a six-sided cube. | ||
Note: index numbers may change after 'make F' command. Thus, execute labelvert witht the -i option before each use of 'make F'.