= Tutorial
== Creating a scenario
The following is to be used as an example tutorial for creating a scenario from scratch.

=== Opening the program
To run the !ScriptBuilder application, download the application from the DownloadPage, and unzip the given folder. The program can be run by opening the command line at this location and (needs windows cross-check) typing {java -jar ScriptBuilder.jar}

=== Adding your first Incident to the Scenario
For the first Incident, we're going to add both the Media Log and the Tomato Truck !Spill/Fire incidents from the pre-existing incident pool. To do this, navigate to the incidents menu, and select the "Load Incident..." option. This should bring up the [[ScriptBuilder_ReferenceManual#incidentPalette|Incident Pool Window]], similar to the one below:
(Insert Photo of the incident palette window)[[BR]]

Press the large "Add" button to the right of the incident you would like to add, in this case the Media Log and Tomato Truck !Spill/Fire. When completed, press the "Done" button, which will return you back to the Scenario Overview Window. You should see the two added incidents in the window, as shown below:
(Insert photo of the overview window with both of the events added.)[[BR]]

Take note that the Media Log does not have any tick marks on its timeline, as it does not contain any events. On the other hand, the Tomato Truck !Spill/Fire incident has a long line of tickmarks, which each indicate a time at which an incident occurs (could be more than one). 
=== Modifying the incident properties
To see the properties of the incident, right-click on the timeline and select the properties option as shown below:[[BR]]

(insert photo of dropdown menu)
A window titled "Incident Properties" should open and the property values will be filled with whatever was saved with the incident itself. Change the incident's color by selecting the dropdown menu and selecting "red" instead.[[BR]]

(Insert image of the properties window with the color change)[[BR]]

Upon completion, click "OK" to save the changes, and observe the change in color of the incident in the Scenario Overview Window.[[BR]]

=== Creating a new incident

Open the incident menu, and select the "New Incident..." option. An Incident Properties window should appear, which will already have the next available incident number filled in, which in this case is 101. Change the color to Yellow, name it "An accident", and set the start time to 10 minutes. [[BR]]
(insert image of incident properties with the correct values as said above)[[BR]]
The Incident Editor window will appear without any incidents. Add a Witness event to the incident timeline by selecting the button names "Witness" and click anywhere to add the event to the timeline. A popup notifying that the event will be added to the beginning of the incident will appear, and after confirming, the [[ScriptBuilder_ReferenceManual#EventEditorWindow|Event Editor Window]] will appear. Fill it in to match the image below:[[BR]]
(add image of the Incident Editor with the Witness event added)[[BR]]
Before closing the window, add another event a CHP Radio Event to the incident by clicking on the dropdown menu in the [[ScriptBuilder_ReferenceManual#EventEditorWindow|Event Editor Window]] named automated events, and click on the CHP Radio button to add it. Fill in the information as below and save and close the [[ScriptBuilder_ReferenceManual#EventEditorWindow|Event Editor Window]]. [[BR]]
(add image of event editor with chp radio)[[BR]]
The Incident overview window appears as follows:[[br]]
(Add image of the incident window.)[[br]]
Add in a unit event at 5 minutes by selecting Unit and mousing over to where the tooltip on the mouse reads 5 minutes. Place the event and a new [[ScriptBuilder_ReferenceManual#EventEditorWindow|Event Editor]] 
 should open. Select unit 9-9 from the dropdown and save and close the [[ScriptBuilder_ReferenceManual#EventEditorWindow|Event Editor Window]]. Add 15 minutes to the end of the script by going to the top-right corner of the [[ScriptBuilder_ReferenceManual#IncidentEditorWindow|Incident Editor Window]] and ensuring the "to end" is selected, and clicking on the +15 button. This will add 15 minutes to the end of the script and allow you to add events further along. Add a Tow event at 17:40 and fill it with dummy values. Oh no! It looks like we accidentally put the unit event at 5:00 instead of 5:40 and selected the wrong unit! That's no problem to move... Just click on the unit event and, on the bottom of the window, change the seconds dropdown to be 40 instead of 0. Change the unit to 14-9 in the Unit selector dropdown, save and close the window, and the Unit event will move to the correct position. From time 0 with the zoom all the way out, the [[ScriptBuilder_ReferenceManual#IncidentEditorWindow|Incident Editor Window]] should look like this:[[br]]
(insert image of the incident editor window with the unit event shifted.)[[br]]



{{{
Script Builder tutorial
OUTLINE
THIS IS FOR TUTORIAL - REFERENCE GUIDE IS FOR LATER

Background
  Prerequisites: What the Simulation Manager does.
  How an incident script is structured.
  Major script builder features.

Overview Window

Stage 1|

Creating a new Incident
  Incident Properties Dialog
  Incident Editor Window
  The Timeline 
  Adding the first event

Stage 1.5|

  Event Editor Window
  Adding more events
  Revising an Event
  Changing an event's time

Stage 2|

  Modifying an Incident's timeline
        Add time to start or end
        Add or remove time from middle

Saving a Scenario
Opening an existing Scenario

Incident Pool Concept
Loading an Incident from the Incident Pool
Incident Pool Window

Stage 3|

Saving a single Incident
  This saves WITHOUT units, is that correct? (YES) Explain implication: won't run properly in Sim Mgr.

Loading Additional Units
  How default units are used.
  Why additional units may be needed.

Stage 4|
}}}