When invoked over any line, arc, polygon, or via, this changes the current layer to be the layer that item is on, and changes the current sizes (thickness, clearance, etc) according to that item. +
+This changes how/whether padstacks connect to any rectangle or polygon on the current layer. The first argument can specify one object, or all selected padstacks. The second argument specifies the style of connection. +
+ Thermal styles: +
+ +
| +0 + | + no connection, + |
|---|---|
| +1 + | + 45 degree fingers with sharp edges, + |
| +2 + | + horizontal & vertical fingers with sharp edges, + |
| +3 + | + solid connection, + |
| +4 + | + 45 degree fingers with rounded corners, + |
| +5 + | + horizontal & vertical fingers with rounded corners. + |
+ Padstacks may have thermals whether or not there is a polygon available to connect with. However, they will have no visible effect until a polygon is drawn around the padstack. +
Index: trunk/doc/user/09_appendix/action_reference.html =================================================================== --- trunk/doc/user/09_appendix/action_reference.html (revision 20603) +++ trunk/doc/user/09_appendix/action_reference.html (revision 20604) @@ -12,11 +12,11 @@
| Action | Description | Syntax | Plugin | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| About | Present the about box | About() | dialogs plugin | -||||||||||||
| AddRats | Add one or more rat lines to the board. | AddRats(AllRats|SelectedRats|Close) | + | ||||||||||||
| AddRats | Add one or more rat lines to the board. | AddRats(AllRats|SelectedRats|Close) | |||||||||||||
| ApplyVendor | Applies the currently loaded vendor drill table to the current design. | ApplyVendor() | vendor drill mapping | ||||||||||||
| ArcNew | Create a pcb arc segment on a layer. For now data must be "pcb". Returns the ID of the new object or 0 on error. | ArcNew(data, layer, centx, centy, radiusx, radiusy, start_ang, delta_ang, thickness, clearance, flags) | act_draw | ||||||||||||
| Atomic | Save or restore the undo serial number. | Atomic(Save|Restore|Close|Block) | @@ -28,19 +28,19 @@ | ||||||||||||
| BoardFlip | Mirror the board over the x axis, optionally mirroring sides as well. | BoardFlip([sides]) | boardflip plugin | ||||||||||||
| Brave | Changes brave settings. | Brave() Brave(setting, on|off) | |||||||||||||
| ChangeAngle | Changes the start angle, delta angle or both angles of an arc. | ChangeAngle(Object, start|delta|both, delta) ChangeAngle(SelectedObjects|Selected, start|delta|both, delta) ChangeAngle(SelectedArcs, start|delta|both, delta) | - | ||||||||||||
| ChangeClearSize | Changes the clearance size of objects. | ChangeClearSize(Object, delta|style) ChangeClearSize(SelectedPins|SelectedPads|SelectedVias, delta|style) ChangeClearSize(SelectedLines|SelectedArcs, delta|style) ChangeClearSize(Selected|SelectedObjects, delta|style) | + | ||||||||||||
| ChangeClearSize | Changes the clearance size of objects. | ChangeClearSize(Object, delta|style) ChangeClearSize(SelectedPins|SelectedPads|SelectedVias, delta|style) ChangeClearSize(SelectedLines|SelectedArcs, delta|style) ChangeClearSize(Selected|SelectedObjects, delta|style) | |||||||||||||
| ChangeDrillSize | Changes the drilling hole size of objects. | ChangeDrillSize(Object, delta|style) ChangeDrillSize(SelectedPins|SelectedVias|Selected|SelectedObjects, delta|style) | - | ||||||||||||
| ChangeFlag | Sets or clears flags on objects. | ChangeFlag(Object|Selected|SelectedObjects, flag, value) ChangeFlag(SelectedLines|SelectedPins|SelectedVias, flag, value) ChangeFlag(SelectedPads|SelectedTexts|SelectedNames, flag, value) ChangeFlag(SelectedElements, flag, value) flag = thermal | join value = 0 | 1 | + | ||||||||||||
| ChangeFlag | Sets or clears flags on objects. | ChangeFlag(Object|Selected|SelectedObjects, flag, value) ChangeFlag(SelectedLines|SelectedPins|SelectedVias, flag, value) ChangeFlag(SelectedPads|SelectedTexts|SelectedNames, flag, value) ChangeFlag(SelectedElements, flag, value) flag = thermal | join value = 0 | 1 | |||||||||||||
| ChangeHole | oldactions plugin | ||||||||||||||
| ChangeJoin | Changes the join (clearance through polygons) of objects. | ChangeJoin(ToggleObject|SelectedLines|SelectedArcs|Selected) | - | ||||||||||||
| ChangeName | Sets the name (or pin number) of objects. | ChangeName(Object) ChangeName(Layout|Layer) | + | ||||||||||||
| ChangeName | Sets the name (or pin number) of objects. | ChangeName(Object) ChangeName(Layout|Layer) | |||||||||||||
| ChangeNonetlist | Changes the nonetlist flag of subcircuits. | ChangeNonetlist(ToggleObject) ChangeNonetlist(SelectedElements) ChangeNonetlist(Selected|SelectedObjects) | |||||||||||||
| ChangeOctagon | oldactions plugin | ||||||||||||||
| ChangePaste | oldactions plugin | -||||||||||||||
| ChangePinName | Sets the name of a specific pin on a specific subcircuit. | ChangePinName(Refdes,PinNumber,PinName) | + | ||||||||||||
| ChangePinName | Sets the name of a specific pin on a specific subcircuit. | ChangePinName(Refdes,PinNumber,PinName) | |||||||||||||
| ChangeRadius | Changes the width or height (radius) of an arc. | ChangeRadius(Object, width|x|height|y|both, delta) ChangeRadius(SelectedObjects|Selected, width|x|height|y|both, delta) ChangeRadius(SelectedArcs, width|x|height|y|both, delta) | - | ||||||||||||
| ChangeSize | Changes the size of objects. | ChangeSize(Object, delta|style) ChangeSize(SelectedObjects|Selected, delta|style) ChangeSize(SelectedLines|SelectedPins|SelectedVias, delta|style) ChangeSize(SelectedPads|SelectedTexts|SelectedNames, delta|style) ChangeSize(SelectedElements, delta|style) | - | ||||||||||||
| ChangeSizes | Changes all sizes of objects. | ChangeSizes(Object, delta|style) ChangeSizes(SelectedObjects|Selected, delta|style) ChangeSizes(SelectedLines|SelectedPins|SelectedVias, delta|style) ChangeSizes(SelectedPads|SelectedTexts|SelectedNames, delta|style) ChangeSizes(SelectedElements, delta|style) | + | ||||||||||||
| ChangeSize | Changes the size of objects. | ChangeSize(Object, delta|style) ChangeSize(SelectedObjects|Selected, delta|style) ChangeSize(SelectedLines|SelectedPins|SelectedVias, delta|style) ChangeSize(SelectedPads|SelectedTexts|SelectedNames, delta|style) ChangeSize(SelectedElements, delta|style) | + | ||||||||||||
| ChangeSizes | Changes all sizes of objects. | ChangeSizes(Object, delta|style) ChangeSizes(SelectedObjects|Selected, delta|style) ChangeSizes(SelectedLines|SelectedPins|SelectedVias, delta|style) ChangeSizes(SelectedPads|SelectedTexts|SelectedNames, delta|style) ChangeSizes(SelectedElements, delta|style) | |||||||||||||
| ChangeSquare | oldactions plugin | ||||||||||||||
| ChkBuffer | Return 1 if currently selected buffer's index matches idx | ChkBuffer(idx) | |||||||||||||
| ChkGridSize | Return 1 if the currently selected grid matches the expected_size. If argument is "none" return 1 if there is no grid. | ChkGridSize(expected_size) ChkGridSize(none) | @@ -53,12 +53,12 @@ | ||||||||||||
| ClearOctagon | oldactions plugin | ||||||||||||||
| ClearSquare | oldactions plugin | ||||||||||||||
| ClrFlag | Clears flags on objects. | ClrFlag(Object|Selected|SelectedObjects, flag) ClrFlag(SelectedLines|SelectedPins|SelectedVias, flag) ClrFlag(SelectedPads|SelectedTexts|SelectedNames, flag) ClrFlag(SelectedElements, flag) flag = thermal | join | - | ||||||||||||
| Connection | Searches connections of the object at the cursor position. | Connection(Find|ResetLinesAndPolygons|ResetPinsAndVias|Reset) | + | ||||||||||||
| Connection | Searches connections of the object at the cursor position. | Connection(Find|ResetLinesAndPolygons|ResetPinsAndVias|Reset) | |||||||||||||
| CreateMenu | Creates a new menu, popup (only path specified) or submenu (at least path and action are specified) | CreateMenu(path) CreateMenu(path, action, dummy, accel, tooltip, cookie) | |||||||||||||
| CreateText | Create a new text object | CreateText(layer, fontID, X, Y, direction, scale, text) | |||||||||||||
| Cursor | Move the cursor. | Cursor(Type,DeltaUp,DeltaRight,Units) | |||||||||||||
| CycleDrag | Cycle through which object is being dragged | CycleDrag() | - | ||||||||||||
| DRC | Invoke the DRC check. | DRC() | + | ||||||||||||
| DRC | Invoke the DRC check. | DRC() | |||||||||||||
| Debug | Debug action. | Debug(...) | oldactions plugin | ||||||||||||
| DebugXY | Debug action, with coordinates | DebugXY(...) | oldactions plugin | ||||||||||||
| DelGroup | Remove a layer group; if the first argument is not specified, the current group is removed | DelGroup([@group]) | @@ -81,7 +81,7 @@ | ||||||||||||
| EnableVendor | Enables automatic drill size mapping. | EnableVendor() | oldactions plugin | ||||||||||||
| EvalConf | Perform various operations on the configuration tree. | EvalConf(path) - evaluate a config path in different config sources to figure how it ended up in the native database | diag plugin | ||||||||||||
| ExecCommand | Run shell command | System(shell_cmd) | - | ||||||||||||
| ExecuteFile | Run actions from the given file. | ExecuteFile(filename) | + | ||||||||||||
| ExecuteFile | Run actions from the given file. | ExecuteFile(filename) | |||||||||||||
| ExpFeatTmp | Experimental Feature Template. | ExpFeatTmp(...) | experimental features plugin | ||||||||||||
| Export | Export the current layout, e.g. Export(png, --dpi, 600) | Export(exporter, [exporter-args]) | |||||||||||||
| ExportGUI | Open the export dialog. | ExportGUI() | dialogs plugin | @@ -112,7 +112,7 @@||||||||||||
| LoadFontFrom | Load PCB font from a file | LoadFontFrom([file, id]) | |||||||||||||
| LoadFootprint | Loads a single footprint by name. | pcb_load_footprint(filename[,refdes,value]) | |||||||||||||
| LoadFpcbnlFrom | Loads the specified freepcb netlist. | LoadFpcbnlFrom(filename) | fpcb_nl importer | -||||||||||||
| LoadFrom | Load layout data from a file. | LoadFrom(Layout|LayoutToBuffer|SubcToBuffer|Netlist|Revert,filename[,format]) | + | ||||||||||||
| LoadFrom | Load layout data from a file. | LoadFrom(Layout|LayoutToBuffer|SubcToBuffer|Netlist|Revert,filename[,format]) | |||||||||||||
| LoadHpglFrom | Loads the specified hpgl plot file to the current buffer | LoadHpglFrom(filename) | hpgl importer | ||||||||||||
| LoadIpc356From | Loads the specified IPC356-D netlist | LoadIpc356From(filename, [nonet], [nopad], [nosubc]) | ipcd356 importer | ||||||||||||
| LoadLtspiceFrom | Loads the specified ltspice .net and .asc file - the netlist must be mentor netlist. | LoadLtspiceFrom(filename) | ltspice importer | @@ -125,17 +125,17 @@||||||||||||
| LoadVendorFrom | Loads the specified vendor lihata file. | LoadVendorFrom(filename) | vendor drill mapping | ||||||||||||
| LoadhypFrom | Loads the specified Hyperlynx file. | LoadhypFrom(filename[, "debug"]...) | hyp importer | ||||||||||||
| ManagePlugins | Manage plugins dialog. | ManagePlugins() | - | ||||||||||||
| MarkCrosshair | Set/Reset the pcb_crosshair mark. | MarkCrosshair() MarkCrosshair(Center) | - | ||||||||||||
| Message | Writes a message to the log window. | message(message) | + | ||||||||||||
| MarkCrosshair | Set/Reset the pcb_crosshair mark. | MarkCrosshair() MarkCrosshair(Center) | + | ||||||||||||
| Message | Writes a message to the log window. | message(message) | |||||||||||||
| MinClearGap | Ensures that polygons are a minimum distance from objects. | MinClearGap(delta) MinClearGap(Selected, delta) | |||||||||||||
| MinMaskGap | oldactions plugin | -||||||||||||||
| Mode | Change or use the tool mode. | Mode(Arc|Arrow|Copy|InsertPoint|Line|Lock|Move|None|PasteBuffer) Mode(Polygon|Rectangle|Remove|Rotate|Text|Thermal|Via) Mode(Notify|Release|Cancel|Stroke) Mode(Save|Restore) | - | ||||||||||||
| MorphPolygon | Converts dead polygon islands into separate polygons. | pcb_poly_morph(Object|Selected) | + | ||||||||||||
| Mode | Change or use the tool mode. | Mode(Arc|Arrow|Copy|InsertPoint|Line|Lock|Move|None|PasteBuffer) Mode(Polygon|Rectangle|Remove|Rotate|Text|Thermal|Via) Mode(Notify|Release|Cancel|Stroke) Mode(Save|Restore) | + | ||||||||||||
| MorphPolygon | Converts dead polygon islands into separate polygons. | pcb_poly_morph(Object|Selected) | |||||||||||||
| MoveLayer | Moves/Creates/Deletes Layers. | MoveLayer(old,new) MoveLayer(lid,group,gid) | |||||||||||||
| MoveObject | Moves the object under the crosshair. | pcb_move_obj(X,Y,[units]) | |||||||||||||
| MoveToCurrentLayer | Moves objects to the current layer. | MoveToCurrentLayer(Object|SelectedObjects) | |||||||||||||
| NetlistChanged | Tells the GUI that the netlist has changed. | NetlistChanged() | oldactions plugin | -||||||||||||
| New | Starts a new layout. | New([name]) | + | ||||||||||||
| New | Starts a new layout. | New([name]) | |||||||||||||
| NewGroup | Create a new layer group with a single, positive drawn layer in it | NewGroup(type [,location [, purpose[, auto|sub]]]) | |||||||||||||
| Normalize | Move all objects within the drawing area, align the drawing to 0;0 | Normalize() | |||||||||||||
| Oneliner | Execute a script one-liner using a specific language | Oneliner(lang, script) | script plugin | @@ -156,7 +156,7 @@||||||||||||
| PolyNewPoints | Add a list of points to a polygon created by PolyNew. Returns 0 on success. | PolyNewPoints(poly, ptlist) | act_draw | ||||||||||||
| PolyOffs | replicate the outer contour of the selected polygon(s) with growing or shrinking them by offset; the new polygon is drawn on the current layer | PolyOffs(offset) | lib_polyhelp | ||||||||||||
| PolyStitch | polystitch plugin | -||||||||||||||
| Polygon | Some polygon related stuff. | Polygon(Close|CloseHole|PreviousPoint) | + | ||||||||||||
| Polygon | Some polygon related stuff. | Polygon(Close|CloseHole|PreviousPoint) | |||||||||||||
| Preferences | Present the preferences dialog, optionally opening the tab requested. | Preferences([tabname]) | dialogs plugin | ||||||||||||
| PrintActions | Print all actions available. | PrintActions() | |||||||||||||
| PrintCalibrate | Calibrate the printer. | PrintCalibrate() | @@ -168,7 +168,7 @@ | ||||||||||||
| PromptFor | Prompt for a response. | PromptFor([message[,default]]) | |||||||||||||
| PstkNew | Create a padstack. For now data must be "pcb". glob_clearance=0 turns off global clearance. Returns the ID of the new object or 0 on error. | PstkNew(data, protoID, x, y, glob_clearance, flags) | act_draw | ||||||||||||
| Puller | Pull an arc-line junction tight. | pcb_act_Puller() | puller plugin | -||||||||||||
| Quit | Quits the application after confirming. | Quit() | + | ||||||||||||
| Quit | Quits the application after confirming. | Quit() | |||||||||||||
| Redo | Redo recent "undo" operations. | redo() | |||||||||||||
| RemoveMenu | Recursively removes a new menu, popup (only path specified) or submenu. | RemoveMenu(path|cookie) | |||||||||||||
| RemoveSelected | Removes any selected objects. | pcb_remove_selected() | @@ -186,16 +186,16 @@ | ||||||||||||
| SaveFontTo | Save PCB font to a file | SaveFontTo([file, id]) | |||||||||||||
| SavePatch | Save netlist patch for back annotation. | SavePatch(filename) | |||||||||||||
| SaveTedax | Saves the specific type of data in a tEDAx file. Type can be: board-footprints | SaveTedax(board-footprints, filename) | tEDAx IO | -||||||||||||
| SaveTo | Saves data to a file. | SaveTo(Layout|LayoutAs,filename,[fmt]) SaveTo(AllConnections|AllUnusedPins|ElementConnections,filename) SaveTo(PasteBuffer,filename,[fmt]) | + | ||||||||||||
| SaveTo | Saves data to a file. | SaveTo(Layout|LayoutAs,filename,[fmt]) SaveTo(AllConnections|AllUnusedPins|ElementConnections,filename) SaveTo(PasteBuffer,filename,[fmt]) | |||||||||||||
| ScaleBuffer | Scales the buffer by multiplying all coordinates by a floating point number. If only x is given, it is also used for y and thickness too. If subc is not empty, subcircuits are also scaled | ScaleBuffer(x [,y [,thickness [,subc]]]) | - | ||||||||||||
| Select | Toggles or sets the selection. | Select(Object|ToggleObject) Select(All|Block|Connection) Select(Convert) | + | ||||||||||||
| Select | Toggles or sets the selection. | Select(Object|ToggleObject) Select(All|Block|Connection) Select(Convert) | |||||||||||||
| SelectLayer | Select which layer is the current layer. | SelectLayer(1..MAXLAYER|Silk|Rats) | |||||||||||||
| SetFlag | Sets flags on objects. | SetFlag(Object|Selected|SelectedObjects, flag) SetFlag(SelectedLines|SelectedPins|SelectedVias, flag) SetFlag(SelectedPads|SelectedTexts|SelectedNames, flag) SetFlag(SelectedElements, flag) flag = thermal | join | |||||||||||||
| SetOctagon | oldactions plugin | ||||||||||||||
| SetSame | Sets current layer and sizes to match indicated item. | SetSame() | |||||||||||||
| SetSquare | oldactions plugin | -||||||||||||||
| SetThermal | Set the thermal (on the current layer) of padstacks to the given style. Style = 0 means no thermal. Style = 1 has diagonal fingers with sharp edges. Style = 2 has horizontal and vertical fingers with sharp edges. Style = 3 is a solid connection to the plane. Style = 4 has diagonal fingers with rounded edges. Style = 5 has horizontal and vertical fingers with rounded edges. | SetThermal(Object|SelectedPins|SelectedVias|Selected, Style) | - | ||||||||||||
| SetUnits | Set the default measurement units. | SetUnits(mm|mil) | + | ||||||||||||
| SetThermal | Set the thermal (on the current layer) of padstacks to the given style. Style = 0 means no thermal. Style = 1 has diagonal fingers with sharp edges. Style = 2 has horizontal and vertical fingers with sharp edges. Style = 3 is a solid connection to the plane. Style = 4 has diagonal fingers with rounded edges. Style = 5 has horizontal and vertical fingers with rounded edges. | SetThermal(Object|SelectedPins|SelectedVias|Selected, Style) | + | ||||||||||||
| SetUnits | Set the default measurement units. | SetUnits(mm|mil) | |||||||||||||
| SetValue | Change various board-wide values and sizes. | SetValue(Grid|Line|LineSize|Text|TextScale, delta) | |||||||||||||
| SwitchHID | Switch to another HID. | SwitchHID(lesstif|gtk|batch) | |||||||||||||
| System | Run shell command | System(shell_cmd) | @@ -209,7 +209,7 @@ | ||||||||||||
| UndoDialog | Open the undo dialog. | UndoDialog() | dialogs plugin | ||||||||||||
| UnloadScript | Unload a fungw script | UnloadScript(id) | script plugin | ||||||||||||
| UnloadVendor | Unloads the current vendor drill mapping table. | UnloadVendor() | vendor drill mapping | -||||||||||||
| Unselect | Unselects the object at the pointer location or the specified objects. | Unselect(All|Block|Connection) | + | ||||||||||||
| Unselect | Unselects the object at the pointer location or the specified objects. | Unselect(All|Block|Connection) | |||||||||||||
| acompnet | Attempt to auto-complete the current network | acompnet() | acompnet plugin | ||||||||||||
| align | Align subcircuits | Align(X/Y, [Lefts/Rights/Tops/Bottoms/Centers/Marks, [First/Last/pcb_crosshair/Average[, Gridless]]]) | distalign plugin | ||||||||||||
| aligntext | Align Text Elements | AlignText(X/Y, [Lefts/Rights/Tops/Bottoms/Centers, [First/Last/pcb_crosshair/Average[, Gridless]]]) | distaligntext plugin | Index: trunk/doc/user/09_appendix/action_src/setthermal.html =================================================================== --- trunk/doc/user/09_appendix/action_src/setthermal.html (nonexistent) +++ trunk/doc/user/09_appendix/action_src/setthermal.html (revision 20604) @@ -0,0 +1,31 @@ +This changes how/whether padstacks connect to any rectangle or polygon +on the current layer. The first argument can specify one object, or all +selected padstacks. +The second argument specifies the style of connection. +
| 0 + | no connection, + + |
|---|---|
| 1 + | 45 degree fingers with sharp edges, + + |
| 2 + | horizontal & vertical fingers with sharp edges, + + |
| 3 + | solid connection, + + |
| 4 + | 45 degree fingers with rounded corners, + + |
| 5 + | horizontal & vertical fingers with rounded corners. + |
+Padstacks may have thermals whether or not there is a polygon available +to connect with. However, they will have no visible effect until a polygon +is drawn around the padstack. + Index: trunk/src/change_act.c =================================================================== --- trunk/src/change_act.c (revision 20603) +++ trunk/src/change_act.c (revision 20604) @@ -641,25 +641,7 @@ "Style = 3 is a solid connection to the plane.\n" "Style = 4 has diagonal fingers with rounded edges.\n" "Style = 5 has horizontal and vertical fingers with rounded edges.\n"; - -/* %start-doc actions SetThermal - -This changes how/whether padstacks connect to any rectangle or polygon -on the current layer. The first argument can specify one object, or all -selected padstacks. -The second argument specifies the style of connection. -There are 5 possibilities: -0 - no connection, -1 - 45 degree fingers with sharp edges, -2 - horizontal & vertical fingers with sharp edges, -3 - solid connection, -4 - 45 degree fingers with rounded corners, -5 - horizontal & vertical fingers with rounded corners. - -Padstacks may have thermals whether or not there is a polygon available -to connect with. However, they will have no effect without the polygon. -%end-doc */ - +/* DOC: setthermal.html */ static fgw_error_t pcb_act_SetThermal(fgw_arg_t *res, int argc, fgw_arg_t *argv) { const char *function;