Index: 09_appendix/action_details.html =================================================================== --- 09_appendix/action_details.html (revision 9941) +++ 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. + +
+
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. +
RND: this action comes from librnd and is common to all ringdove applications.