Differences

This shows you the differences between two versions of the page.

--- planning:userguide:tutorials:apertures [2017/02/15 16:38] – [Manual Edits] kerhart
+++ planning:userguide:tutorials:apertures [2021/07/29 18:28] (current) – external edit 127.0.0.1
@@ Line 5: / Line 5: @@
 ===== Adding an Aperture =====
-  * From within the PBS Beam Task you may add an aperture to a beam by clicking the "Add One" button from within the //Aperture Task Block// . {{ :planning:userguide:tutorials:aperture_add.png?250 |}}
+==== PBS ====
+  * From within the PBS Beam Task you may add an aperture to a beam by clicking the "Add One" button from within the //Aperture Task Block//. {{ :planning:userguide:tutorials:aperture_add.png?250 |}}
+==== SOBP ====
+  * From within the SOBP Beam Task, an initial aperture is automatically created (note: the "Create New Hardware" option is selected from within the //Aperture Task Block//) based on your site configuration default margins and the selected beam target. Changes to the default aperture can be made according to the instructions and descriptions below if needed. Alternatively, you can re-use an existing aperture by clicking the "Re-Use Existing Hardware" button. Selecting the "Re-Use Existing Hardware" option ensures that the current beam will use the exact same device used in an another beam within the plan. {{ :planning:userguide:tutorials:re-using_existing_hardware_-_aperture.png? 300 |}}
 ===== Target =====
@@ Line 28: / Line 34: @@
 ===== Manual Edits =====
-  * Manual edits allow you to draw on the BEV in order to manually edit the aperture shape. To begin editing simply click the //Enable// link. {{ :planning:userguide:tutorials:aperture_manual_edit.png?300 |}}
+  * Manual edits allow you to draw on the BEV in order to manually edit the aperture shape. To begin editing simply click the //Enable// link.
   * First, set the radius of the editing tool to the desired size (you can directly type a size or use the -/+ on either side to increment the size) {{ :planning:userguide:tutorials:aperture_brush_size.png?300 |}}
   * You are now free to draw manual override regions directly on the BEV. You draw by simply clicking and dragging the mouse at the desired positions.
@@ Line 36: / Line 42: @@
       * When outside the aperture, you edit the aperture by pushing in/subtracting and your edit regions are drawn in a blue color. The hashed red line denotes the original placement of the aperture. {{ :planning:userguide:tutorials:aperture_outside_edit.png?200 |}}
       * When inside the aperture, you edit the aperture by pushing out/adding and your edit regions are drawn as the color of your target. {{ :planning:userguide:tutorials:aperture_inside_edit.png?200 |}}
-    * Once done with manually editing, click the "Disable Editing" button to end the process. {{ :planning:userguide:tutorials:aperture_disable.png?300 |}}
+    * <WRAP center round tip 85%>
+The manual edits contain an "undo" feature, so that the user can successively remove the last manual edit step by pressing Ctrl+Z. Please note that the undo functionality only tracks edits performed in the active session, so as soon as you leave this block or disable manual edits, you will be unable to use the undo functionality on those changes when returning to this task. </WRAP>
+    * Once done with manually editing, click the "Disable Editing" button to end the process.
     * Note that your edits and the resulting aperture shape will still show on the BEV and your edits will remain as-drawn even when changing other options.
 ==== Removing Edits ====
-    * The edits performed in the aperture task can be undone by pressing Ctrl+Z. The undo functionality only tracks edits performed while in the same instance of the task. So as soon as you leave this instance of the task, the history of changes made will be lost and you will be unable to use the undo functionality on those changes in that instance of the aperture task.
     * If you need to remove the manual edits for any reason, you may do so by pressing the "Clear Edits" button. Pressing this button will remove __ALL__ manual edits for this aperture.
 ===== Removing an Aperture =====
-   * If you wish to remove the aperture from this beam, simply press the "Remove Aperture" button at the bottom of the Aperture Task Block
+   * If you wish to remove the aperture from this beam, simply press the "Remove Aperture" button at the bottom of the Aperture Task Block to completely remove it.