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: | ||
| + | |||
| + | | ||
| + | | ||
| + | \\ | ||
| + | |||