1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73
|
There are a number of paste buffers; the actual limit is a
compile-time constant <i>PCB_MAX_BUFFER</i>. It
is normally <i>5</i>. One of these is the "current" paste buffer,
often referred to as "the" paste buffer.
Arguments:
<p>
<table border=1 cellspacing=0>
<tr><th> AddSelected
<td> Copies the selected objects to the current paste buffer.
<tr><th> Clear
<td> Remove all objects from the current paste buffer.
<tr><th> Convert
<td> Convert the current paste buffer to an subcircuit.
<tr><th> Restore
<td> Convert any subcircuit in the paste buffer back to plain objects.
<tr><th> Mirror
<td> Flip all objects in the paste buffer vertically (up/down flip). To mirror
horizontally, combine this with rotations.
<tr><th> Rotate
<td> Rotates the current buffer. The number to pass is 1..3, where 1 means
90 degrees counter clockwise, 2 means 180 degrees, and 3 means 90
degrees clockwise (270 CCW).
<tr><th> Normalize
<td> Set the buffer origin to the center of the paste buffer bounding box.
This is useful especially if an import plugin loaded objects in the buffer
with a large offset.
<tr><th> Save
<td> Saves subcircuits in the current buffer to the indicated file. If
format is specified, try to use that file format, else use the default.
If force is specified, overwrite target, don't ask.
<tr><th> SaveAll
<td> Saves all content of the current buffer to the indicated file. If
format is specified, try to use that file format, else use the default.
<tr><th> LoadAll
<td> Loads a previously saved paste buffer into the current buffer from the
indicated file.
<tr><th> ToLayout
<td> Pastes objects in the current buffer to the indicated X, Y
coordinates in the layout. The <arg>X</arg> and <arg>Y</arg> are treated like
<arg>delta</arg> is for many other objects. For each, if it's prefixed by
+ or -, then that amount is relative to the last
location. Otherwise, it's absolute. If units is unspecified, units are PCB's internal
units, currently nanometer. If "crosshair" is used instead of coordinates,
the paste happens at the current crosshair coords.
<tr><th> 1..PCB_MAX_BUFFER
<td> Selects the given buffer to be the current paste buffer.
<tr><th> GetSource
<td> Returns the source file path the buffer is loaded from or nil if there
is none. The return value is a string, usable from user scripts.
<tr><th> Push
<td> Push the index of the currently active paste buffer into an internal
stack. The stack is not board-specifiec.
<tr><th> Pop
<td> Pop an index from the internal stack and set currently active paste
buffer index accordingly.
</table>
|