This shows you the differences between two versions of the page.
labs:panelingcommands [2016/03/18] |
labs:panelingcommands [2020/08/14] (current) |
||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ======PanelingTools Commands====== | ||
+ | |||
+ | > **Summary: | ||
+ | \\ | ||
+ | |||
+ | |||
+ | =====Background===== | ||
+ | |||
+ | |||
+ | Panels are repeated patterns on surfaces, polysurfaces, | ||
+ | |||
+ | |||
+ | PanelingTools use some geometry concepts such as NURBS curves and surfaces, the U and V direction of a NURBS surface, trimmed vs untrimmed surfaces and polysurfaces. | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **Paneling by ordered grid of points** | ||
+ | |||
+ | * Step one: Create an ordered grid of points | ||
+ | Points must be ordered in rows and columns. | ||
+ | |||
+ | //Syntax is: Name(intRow)(intColumn)// | ||
+ | |||
+ | {{: | ||
+ | |||
+ | While PanelingTools offers many commands to create the ordered grid, you can create your own, through scripting for example. | ||
+ | |||
+ | Another advantage of separating grid generation from paneling is that you can edit the grid before paneling. | ||
+ | |||
+ | * //Step two: Create panels// | ||
+ | Select an ordered point grid, a reference object (optional), pattern, and the kind of output you like to get. Custom paneling and quads is also possible. | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **Paneling surfaces and polysurfaces directly** | ||
+ | |||
+ | These are tools to panel directly using a reference surface or polysurface. | ||
+ | |||
+ | It is also possible to combine grid generation commands with paneling by grid commands using macros. | ||
+ | |||
+ | // | ||
+ | |||
+ | \\ | ||
+ | |||
+ | |||
+ | |||
+ | ---- | ||
+ | =====Command descriptions===== | ||
+ | \\ | ||
+ | |||
+ | ====Toolbars==== | ||
+ | [[labs: | ||
+ | |||
+ | {{: | ||
+ | \\ | ||
+ | \\ | ||
+ | |||
+ | ====Menu==== | ||
+ | Note that the PanelingTools drop-down menu shows only after PanelingTools is loaded (usually after calling one of the plug-in commands for the first time in a session). | ||
+ | |||
+ | \\ | ||
+ | |||
+ | ====Available commands==== | ||
+ | |||
+ | |Grid Creation|Grid Editing|Paneling|Others| | ||
+ | | {{: | ||
+ | | {{: | ||
+ | | {{: | ||
+ | | {{: | ||
+ | | {{: | ||
+ | | {{: | ||
+ | | {{: | ||
+ | | {{: | ||
+ | | {{: | ||
+ | | {{: | ||
+ | | {{: | ||
+ | | {{: | ||
+ | | {{: | ||
+ | | {{: | ||
+ | | | |{{: | ||
+ | | | | {{: | ||
+ | | | | {{: | ||
+ | | | | {{: | ||
+ | \\ | ||
+ | |||
+ | |||
+ | |||
+ | ---- | ||
+ | |||
+ | **ptDivideCurveSpan** | ||
+ | |||
+ | |||
+ | Find curve division points by number or distance on curve. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Command options: | ||
+ | |||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | \\ | ||
+ | |||
+ | ---- | ||
+ | |||
+ | **ptDivideCurveByDirectDistance** | ||
+ | |||
+ | |||
+ | Find curve divide points by direct distance | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Command options: | ||
+ | |||
+ | | ||
+ | | ||
+ | | ||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | |||
+ | **ptPanelSurface** | ||
+ | |||
+ | |||
+ | Using a base surface, the command generates the paneling grid and panels. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Command options: | ||
+ | |||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | |||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | Name: Name of panels | ||
+ | \\ | ||
+ | |||
+ | ---- | ||
+ | |||
+ | **ptPanelCurve** | ||
+ | |||
+ | |||
+ | Generate panels for a surface or polysurface using direction curve. | ||
+ | |||
+ | {{: | ||
+ | Command options: | ||
+ | |||
+ | Line: Option to define direction curve with two points | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | |||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | Name: Name of panels | ||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | |||
+ | **ptManage3dPatterns** | ||
+ | |||
+ | |||
+ | Create new 3D patterns that connect grid points, save, delete, or edit them. These patterns are saved to document and are listed in commands like ptPanel3D with other built-in patterns. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Command options: | ||
+ | |||
+ | New: For creating new pattern | ||
+ | Edit: To edit existing patterns | ||
+ | | ||
+ | \\ | ||
+ | |||
+ | ---- | ||
+ | |||
+ | **ptPanel3D** | ||
+ | |||
+ | |||
+ | Panel with two grids. There are a few predefined patterns to select from. There is also the option to create a new pattern that connects grid points. Panels are added in the form of edges, faces, and polysurfaces. Spacing of unit patterns depends on grid spacing. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Command options: | ||
+ | |||
+ | | ||
+ | |||
+ | | ||
+ | Name: Name of panels | ||
+ | |||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | |||
+ | **ptPanel3DCustom** | ||
+ | |||
+ | |||
+ | Morphes 3D patterns between two bounding grids. | ||
+ | |||
+ | {{: | ||
+ | Command options: | ||
+ | |||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | |||
+ | \\ | ||
+ | |||
+ | ---- | ||
+ | |||
+ | **ptOrientToGrid** | ||
+ | |||
+ | |||
+ | Allows selecting any number of objects, then orient (flow) them along paneling grid. It is possible to select a base surface. | ||
+ | |||
+ | {{: | ||
+ | Command options: | ||
+ | |||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | Flip: to change normal direction. | ||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | |||
+ | **ptManage2dPatterns** | ||
+ | |||
+ | |||
+ | Create new patterns that connect grid points, save, delete, or edit them. These patterns are saved to the document and are listed in commands like ptPanelGrid with other built-in patterns. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Command options: | ||
+ | |||
+ | New: For creating new pattern | ||
+ | Edit: To edit existing patterns | ||
+ | | ||
+ | \\ | ||
+ | |||
+ | ---- | ||
+ | |||
+ | **ptPanelGrid** | ||
+ | |||
+ | |||
+ | Panel with ordered grid of points. Reference object (surface or polysurface) is optional. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Command options: | ||
+ | |||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | Name: Name of panels | ||
+ | |||
+ | \\ | ||
+ | |||
+ | ---- | ||
+ | |||
+ | **ptPanelGridCustom** | ||
+ | |||
+ | |||
+ | Panel grid with user-defined pattern curves and points. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Command options: | ||
+ | |||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | Name: Name of panels | ||
+ | |||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | |||
+ | **ptPanelGridQuads** | ||
+ | |||
+ | |||
+ | Adjust paneling grid to create maximum number of quads within tolerance. | ||
+ | |||
+ | One way to have better quads coverage is by increasing **MaxDeviation**, | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Command options: | ||
+ | |||
+ | | ||
+ | | ||
+ | | ||
+ | Name: Name of panels | ||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | |||
+ | **ptAnalyzeFlatFaces** | ||
+ | |||
+ | |||
+ | Color panels or faces (perviously created with FlatFaces option in paneling commands) from red to blue based on their deviation from base point grid or surface (red=furthest). | ||
+ | |||
+ | {{: | ||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | |||
+ | **ptPanelRandomPoints** | ||
+ | |||
+ | |||
+ | Select base surface, any number of points on surface, or have the command generate points. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Command options: | ||
+ | |||
+ | | ||
+ | | ||
+ | | ||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | |||
+ | **ptPanelSubDivide** | ||
+ | |||
+ | |||
+ | Select base surface, any number of closed polylines with end points on surface. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Command options: | ||
+ | |||
+ | | ||
+ | | ||
+ | | ||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | |||
+ | **ptTriangulatePoints** | ||
+ | |||
+ | |||
+ | Use Delauney triangulation to create a mesh from points. | ||
+ | |||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | |||
+ | **ptGroupSimilarPanels** | ||
+ | |||
+ | |||
+ | Group similar curves together within given tolerance. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | \\ | ||
+ | |||
+ | ---- | ||
+ | |||
+ | **ptGridArray** | ||
+ | |||
+ | |||
+ | Create an array of ordered points. You define the first and second directions. (These need not be orthogonal.) | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Command options: | ||
+ | |||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | |||
+ | **ptGridArrayPolar** | ||
+ | |||
+ | |||
+ | Array need not be flat. You select rotation center and axis, then set base point and direction of the polar array. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Command options: | ||
+ | |||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | |||
+ | **ptGridExtrude1** | ||
+ | |||
+ | |||
+ | Select a direction curve and create a parallel or polar grid. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Command options: | ||
+ | |||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | |||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | |||
+ | | ||
+ | | ||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | |||
+ | **ptGridExtrude2** | ||
+ | |||
+ | |||
+ | Sort of like extrude along a curve. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Command options: | ||
+ | |||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | |||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | |||
+ | | ||
+ | | ||
+ | | ||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | |||
+ | **ptGridUCurves** | ||
+ | |||
+ | |||
+ | Divide parallel curves (or usually non-intersecting). | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Command options: | ||
+ | |||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | |||
+ | | ||
+ | | ||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | |||
+ | **ptGridUVCurves** | ||
+ | |||
+ | |||
+ | This is for those who have all curves in both directions and would like to make a grid out of curves intersections. | ||
+ | |||
+ | Command prompts to select curves in each of the two directions to make the grid. Selection order defines order of rows and columns in the grid. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Command options: | ||
+ | |||
+ | | ||
+ | | ||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | |||
+ | **ptGridPoints** | ||
+ | |||
+ | |||
+ | Input grid u and v directions, base point, and u and v spacing. | ||
+ | |||
+ | If align option is set to //Yes//, points will shift location slightly to align with the defined spacing. | ||
+ | |||
+ | {{: | ||
+ | Command options: | ||
+ | |||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | |||
+ | **ptGridPointsOnSurface** | ||
+ | |||
+ | |||
+ | Use this command to order existing points on a surface by that surface' | ||
+ | |||
+ | > **Algorithm: | ||
+ | |||
+ | {{: | ||
+ | Command options: | ||
+ | |||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | |||
+ | **ptGridSurfaceUV** | ||
+ | |||
+ | |||
+ | Divides a surface following its U and V directions. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Command options: | ||
+ | |||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | **ptGridSurfaceDistance** | ||
+ | |||
+ | |||
+ | Select a surface, divide by direct (spatial) distances. This command uses an algorithm where points are calculated incrementally (every new point depends on previously created points). | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Command options: | ||
+ | |||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | **ptGridCurve** | ||
+ | |||
+ | |||
+ | Generate a grid based on an object and direction curve. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Command options: | ||
+ | |||
+ | Line: Option to define direction curve with two points | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | |||
+ | | ||
+ | | ||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | **ptGridCurve2** | ||
+ | |||
+ | Generate a grid based on an object and two direction curves. | ||
+ | |||
+ | {{: | ||
+ | Command options: | ||
+ | |||
+ | Line: Option to define direction curve with two points | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | |||
+ | | ||
+ | | ||
+ | \\ | ||
+ | |||
+ | ---- | ||
+ | **ptDirection** | ||
+ | |||
+ | |||
+ | Flip U and V directions of the grid. This changes the names of point in the grid. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Command options: | ||
+ | |||
+ | | ||
+ | | ||
+ | | ||
+ | \\ | ||
+ | |||
+ | ---- | ||
+ | **ptRowsDirection** | ||
+ | |||
+ | |||
+ | Reverse row directions in a grid. | ||
+ | |||
+ | {{: | ||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | **ptCompactGrid** | ||
+ | |||
+ | |||
+ | Remove holes in the selected grid. | ||
+ | |||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | **ptCloseGrid** | ||
+ | |||
+ | |||
+ | Close selected grid in U or V direction. | ||
+ | |||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | **ptGridSeam** | ||
+ | |||
+ | |||
+ | Change grid seam. The selected grid must be closed. | ||
+ | |||
+ | {{: | ||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | **ptCleanOverlap** | ||
+ | |||
+ | |||
+ | Remove overlapped points in a grid or merge them within tolerance: | ||
+ | |||
+ | a: Delete grid points that are within tolerance in the u direction. | ||
+ | b: Move points within tolerance in v direction to overlap. | ||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | **ptShiftGrid** | ||
+ | |||
+ | |||
+ | Shift the index of selected grid pointed by specified amount. Helps space out a grid and create holes. | ||
+ | |||
+ | Command options: | ||
+ | |||
+ | | ||
+ | | ||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | **ptOffsetPoints** | ||
+ | |||
+ | |||
+ | Offset points on surface or polysurface by specified amount. | ||
+ | |||
+ | Command options: | ||
+ | |||
+ | | ||
+ | | ||
+ | | ||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | **ptTagObjects** | ||
+ | |||
+ | |||
+ | Tag objects with thier names. | ||
+ | |||
+ | {{: | ||
+ | Command Options: | ||
+ | |||
+ | | ||
+ | | ||
+ | |||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | **ptSerializeObjects** | ||
+ | |||
+ | |||
+ | Adds serializing to objects (points, curves, surfaces) relative to: | ||
+ | |||
+ | a. Selection order | ||
+ | b. World coordinate | ||
+ | c. User-defined direction | ||
+ | d. Reference surface | ||
+ | |||
+ | Command options: | ||
+ | |||
+ | | ||
+ | | ||
+ | | ||
+ | |||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | **ptUnifyCurvesDirection** | ||
+ | |||
+ | |||
+ | Unify the direction of curves to point in the same general direction. | ||
+ | |||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | **ptSurfaceFromGridOfEditPoints** | ||
+ | |||
+ | |||
+ | Create a [[rhino: | ||
+ | |||
+ | {{: | ||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | **ptSurfaceFromGridOfControlPoints** | ||
+ | |||
+ | |||
+ | Create a NURBS surface using a point grid as surface control points. | ||
+ | |||
+ | {{: | ||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | **ptExtrudeEdges** | ||
+ | |||
+ | |||
+ | Extrude paneling edges normal to a base surface or by a user-defined direction | ||
+ | |||
+ | Command options: | ||
+ | |||
+ | | ||
+ | | ||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | **ptOffsetEdges** | ||
+ | |||
+ | |||
+ | Offset paneling edges uing base surface. | ||
+ | |||
+ | Command options: | ||
+ | |||
+ | | ||
+ | | ||
+ | \\ | ||
+ | |||
+ | |||
+ | ---- | ||
+ | **ptFinEdges** | ||
+ | |||
+ | |||
+ | Fin paneling edges using pase surface. | ||
+ | |||
+ | Command options: | ||
+ | |||
+ | | ||
+ | | ||
+ | \\ | ||
+ | |||