Index: trunk/doc/user/09_appendix/action_details.html =================================================================== --- trunk/doc/user/09_appendix/action_details.html (revision 9941) +++ trunk/doc/user/09_appendix/action_details.html (revision 9942) @@ -109,6 +109,118 @@

If coordinates of a box is give, smaller coords first, the search is performed only within that box and any object that has overlapping bounding box (on the given layer) is returned. Otherwise the search is performed on the whole rtree, returning all objects on the layer. + +

Zoom

+
+

+ +
Syntax summary: +Zoom() +Zoom([+|-|=]factor) +Zoom(x1, y1, x2, y2) +Zoom(?) +Zoom(get) +Zoom(selected) +
Help text: +GUI zoom +
Registered by: +sch_rnd_gui +
+

+Changes the zoom (magnification) of the view of the sheet. If no arguments are passed, the view is scaled such that the sheet just fits inside the visible window (i.e. "view all"). Otherwise, +factor + specifies a change in zoom factor. It may be prefixed by + ++ + +, + +- + +, + += + + to change how the zoom factor is modified (relative or absolute). The +factor + is a floating point number, such as + +1.5 + + or + +0.75 + +. +

+ Alternatively a box can be specified with 4 coordinates and +zoom + will set the zoom level (and modifies pan) so that the given box of the design is visible and as large as possible in the current window. +

+ Arguments: +

+ + + + + + + + + + + + + + + + + + + +
+ (no argument) + + Without argments: zoom to sheet extents. +
+ +factor + + Values greater than 1.0 cause the sheet to be drawn smaller; more of the sheet will be visible. Values between 0.0 and 1.0 cause the sheet to be drawn bigger; less of the sheet will be visible. +
+ -factor + + Values greater than 1.0 cause the sheet to be drawn bigger; less of the sheet will be visible. Values between 0.0 and 1.0 cause the sheet to be drawn smaller; more of the sheet will be visible. +
+ =factor + + The @var{factor} is an absolute zoom factor; the unit for this value is "PCB units per screen pixel". Since PCB units are nanometer, a +factor + of 1000 means 1 micrometer per pixel (TODO: test this). +
+ x1, y1, x2, y2 + + Zoom to the specified portion of the design, described as a rectangle (using sheet space coordinates) +
+ selected + + Zoom and pan so that all + +selected + + objects are on the screen. +
+ ? + + Print the current zoom level in the message log (as an info line). +
+ get + + Return the zoom level as an FGW_DOUBLE (useful for scripts). +
+ +

+ Note that zoom factors of zero are silently ignored. +

librnd actions (common to Ringdove)

Index: trunk/doc/user/09_appendix/action_reference.html =================================================================== --- trunk/doc/user/09_appendix/action_reference.html (revision 9941) +++ trunk/doc/user/09_appendix/action_reference.html (revision 9942) @@ -76,11 +76,13 @@ EvalConfPerform 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 databasediag_rnd ExecActionFileRun actions from the given file.ExecActionFile(filename) ExecCommandRun shell commandSystem(shell_cmd) +ExportExport the current layout, e.g. Export(png, --dpi, 600)Export(exporter, [exporter-args]) ExportDialogOpen the export dialog.ExportDialog()lib_hid_common plugin ExportProjectDialogOpen the export dialog for exporting the project (all sheets of the project).ExportDialog()sch_rnd_gui fawkExecute a script one-liner using a specific languageOneliner(lang, script)script plugin fbasExecute a script one-liner using a specific languageOneliner(lang, script)script plugin FontFindFinds a font by the same name:style combo pens useFontFind(name, style)diag plugin +FontInfoTest-render str and return width or height.FontInfo(TextWidth|TextHeight, str, [penname]) fpasExecute a script one-liner using a specific languageOneliner(lang, script)script plugin FsdSimpleFile selection dialog, simplified API; for meaning of the arguments, see the HID API doc.FsdSimple(title, descr, default_file, default_ext, history_tag, [read])lib_hid_common plugin FsdTestCentral, DAD based File Selection Dialog demoFsdTest()lib_hid_common plugin @@ -279,8 +281,8 @@ UnloadScript (RND)Unload a fungw scriptUnloadScript(id)script plugin UnSelectUnselect all objects. When first argument is omitted or is All, the action operates on the current sheet. When the first argument is AllProject, it operates on all sheets of the current project.UnSelect([All|AllProject]) ViewDialogBring up a modal dialog for selecting the current view or editing views of the current project.ViewDialog()sch_dialogs -ZoomGUI zoomZoom()
Zoom([+|-|=]factor)
Zoom(x1, y1, x2, y2)
Zoom(?)
Zoom(get)sch_rnd_gui -ZoomToGUI zoomZoom()
Zoom([+|-|=]factor)
Zoom(x1, y1, x2, y2)
Zoom(?)
Zoom(get)sch_rnd_gui +ZoomGUI zoomZoom()
Zoom([+|-|=]factor)
Zoom(x1, y1, x2, y2)
Zoom(?)
Zoom(get)
Zoom(selected)sch_rnd_gui +ZoomToGUI zoomZoom()
Zoom([+|-|=]factor)
Zoom(x1, y1, x2, y2)
Zoom(?)
Zoom(get)
Zoom(selected)sch_rnd_gui

RND: this action comes from librnd and is common to all ringdove applications.