mirror of
https://github.com/NationalSecurityAgency/ghidra
synced 2024-09-14 06:08:54 +00:00
1805 lines
45 KiB
HTML
1805 lines
45 KiB
HTML
<!DOCTYPE html>
|
||
|
||
<meta charset="utf-8" http-equiv="X-UA-Compatible" content="IE=Edge">
|
||
<title>Scripting</title>
|
||
|
||
<!-- Your Slides -->
|
||
<!-- One section is one slide -->
|
||
|
||
<!-- This is the first slide -->
|
||
<section>
|
||
<header>Scripting</header>
|
||
<ul>
|
||
<li>Script Manager</li>
|
||
<ul>
|
||
<li>Script Category Tree</li>
|
||
<ul>
|
||
<li>Displays dynamic tree of categories</li>
|
||
</ul>
|
||
<li>Script Table</li>
|
||
<ul>
|
||
<li>Displays name, description, key binding</li>
|
||
</ul>
|
||
<li>Filter</li>
|
||
<ul>
|
||
<li>Matches filter to name or description</li>
|
||
<li>Wildcard and case-insensitive</li>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<ul>
|
||
<br><br>
|
||
<li>Run Script</li>
|
||
<ul>
|
||
<li>Click the <i>RUN</i> button</li>
|
||
<li>Double-click on the row in the script table</li>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<ul>
|
||
<br>
|
||
<li>Edit Script</li>
|
||
<ul>
|
||
<li>Click the <i>Edit Script with basic editor</i> button</li>
|
||
<li>Make a change</li>
|
||
<li>Click the <i>SAVE</i> or <i>SAVE AS</i> button</li>
|
||
</ul>
|
||
<li>Exercise</li>
|
||
<ul>
|
||
<li>Edit the <span style="font-family:'Courier New'; font-size:30px">HelloWorldScript.java</span> to print "Hello Ghidra Student"</li>
|
||
<li>Verify the output in the console</li>
|
||
</ul>
|
||
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<ul>
|
||
<br>
|
||
<li>Assign Key Binding</li>
|
||
<ul>
|
||
<li>Allows scripts to run from anywhere in Ghidra</li>
|
||
</ul>
|
||
<li>Delete Script</li>
|
||
<ul>
|
||
<li>Deletes the selected script(s)</li>
|
||
<li>System scripts cannot be deleted</li>
|
||
</ul>
|
||
<li>Rename script</li>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<ul>
|
||
<br>
|
||
<li>Create New Script</li>
|
||
<ul>
|
||
<li>Click the <i>NEW</i> button</li>
|
||
<li>In the <i>New Script</i> dialog</li>
|
||
<ul>
|
||
<li>Select a script type (if applicable)</li>
|
||
<li>Select a directory (if applicable)</li>
|
||
<li>Enter a script name</li>
|
||
<li>Click OK button</li>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<table style="width:100%; border-spacing:0px;">
|
||
<tr>
|
||
<td>
|
||
<br><br>
|
||
<img src="Images/Scripting/scriptTemplate.png" style="vertical-align:middle" width="99%"></img>
|
||
</td>
|
||
<td style="vertical-align:top">
|
||
<ul class="medium">
|
||
<br><br>
|
||
<li>Sample script template in Java</li>
|
||
<ul>
|
||
<li>Must fill in the <span style="font-family:'Courier New'; font-size:30px">TODO</span> areas</li>
|
||
<li>Create a description</li>
|
||
<li>Fill in the <span style="font-family:'Courier New'; font-size:30px">run()</span> method</li>
|
||
</ul>
|
||
</ul>
|
||
</td>
|
||
<td>
|
||
</tr>
|
||
</table>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<ul>
|
||
<br>
|
||
<li>Refresh Script List</li>
|
||
<ul>
|
||
<li>Refreshes script manager</li>
|
||
<li>Use it when change script category</li>
|
||
<li>Needed when script development occurs outside Ghidra</li>
|
||
<ul>
|
||
<li>For example, using <span style="font-family:'Courier New'; font-size:30px">emacs</span> for script development</li>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<ul>
|
||
<br>
|
||
<li>Script Directories</li>
|
||
<ul>
|
||
<li>Allows management of script directories</li>
|
||
<li>Default directories</li>
|
||
<ul>
|
||
<li><span style="font-family:'Courier New'; font-size:30px"><HomeDirectory>/ghidra_scripts</span></li>
|
||
</ul>
|
||
<li>Useful for sharing scripts in multi-user</li>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<br>
|
||
<ul>
|
||
<li>Help</li>
|
||
<ul>
|
||
<li>Opens <span style="font-family:'Courier New'; font-size:30px">javadoc</span> for GhidraScript base class</li>
|
||
<li>Provides access to <span style="font-family:'Courier New'; font-size:30px">javadoc</span> for the entire Ghidra API</li>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<ul>
|
||
<li>Exercise</li>
|
||
<ol class="decimal medium">
|
||
<li>Create a new Java script</li>
|
||
<span style="font-family:'Courier New'; font-size:25px"> MyClassScript.java</span>
|
||
<li>Set the description</li>
|
||
<li>Change the body of the run() method to</li>
|
||
<span style="font-family:'Courier New'; font-size:25px">
|
||
public void run() {
|
||
<br>
|
||
println("hello class");
|
||
<br>
|
||
}
|
||
</span>
|
||
<li>Save it</li>
|
||
<li>Run it</li>
|
||
<li>Assign a keybinding of <span style="font-family:'Courier New'; font-size:35px">ctrl-5</span></li>
|
||
<li>Re-run the script using the key binding</li>
|
||
</ol>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<br>
|
||
<ul>
|
||
<li>Script Meta-data</li>
|
||
<ul>
|
||
<li>Special tags in header comment</li>
|
||
<li>Describe the script</li>
|
||
<li>All are optional</li>
|
||
<li>Handle all the messy Java GUI stuff (buttons, menus, etc)</li>
|
||
<li><i>Do not insert blank lines between meta-data</i></li>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<br><br>
|
||
<ul>
|
||
<li>Script Meta-data</li>
|
||
<ul>
|
||
<li><span style="font-family:'Courier New'; font-size:32px">@category</span></li>
|
||
<ul>
|
||
<li>The category path for the script</li>
|
||
<li>Levels are separated by "."</li>
|
||
<li>Example</li>
|
||
<ul>
|
||
<li><span style="font-family:'Courier New'; font-size:28px">@category A.B.C</span></li>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<br>
|
||
<ul>
|
||
<li>Script Meta-data</li>
|
||
<ul class="medium">
|
||
<li><span style="font-family:'Courier New'; font-size:32px">@keybinding</span></li>
|
||
<ul>
|
||
<li>Default key binding for a script</li>
|
||
<li>Format is <span style="font-family:'Courier New'; font-size:28px">[ctrl] [alt] [shift] [A-Z,0-9,F1-F12]</span> and is case-sensitive</li>
|
||
<li>Examples</li>
|
||
<ul>
|
||
<li><span style="font-family:'Courier New'; font-size:28px">@keybinding L</span></li>
|
||
<li><span style="font-family:'Courier New'; font-size:28px">@keybinding ctrl alt shift F1</span></li>
|
||
<li><span style="font-family:'Courier New'; font-size:28px">@keybinding ctrl shift COMMA</span></li>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<br><br>
|
||
<ul>
|
||
<li>Script Meta-data</li>
|
||
<ul class="medium">
|
||
<li><span style="font-family:'Courier New'; font-size:32px">@menupath</span></li>
|
||
<ul>
|
||
<li>Top-level menu path for a script</li>
|
||
<li>Use with caution!</li>
|
||
<ul>
|
||
<li>Overcrowded menu</li>
|
||
<li>Collide with system action</li>
|
||
</ul>
|
||
<li>Example</li>
|
||
<ul>
|
||
<li><span style="font-family:'Courier New'; font-size:28px">@menupath File.Run.My Script</span></li>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<br>
|
||
<ul class="medium">
|
||
<li>Script Meta-data</li>
|
||
<ul>
|
||
<li><span style="font-family:'Courier New'; font-size:32px">@toolbar</span></li>
|
||
<ul>
|
||
<li>Image for top-level toolbar button to launch this script</li>
|
||
<li>Searches for image in script directories and then Ghidra installation directory</li>
|
||
<li>Also use with caution! (same as <span style="font-family:'Courier New'; font-size:32px">@menupath</span>)</li>
|
||
<li>Example</li>
|
||
<ul>
|
||
<li><span style="font-family:'Courier New'; font-size:28px">@toolbar myScriptImage.gif</span></li>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<br><br>
|
||
<ul>
|
||
<li>Script Meta-data Exercise</li>
|
||
<ul class="medium">
|
||
<li>In <span style="font-family:'Courier New'; font-size:32px">MyClassScript.java</span></li>
|
||
<ul>
|
||
<li>Set category to <span style="font-family:'Courier New'; font-size:26px; color:#1E90FF"><b>Category A.Category B</b></span></li>
|
||
<li>Set key binding to <span style="font-family:'Courier New'; font-size:26px; color:#1E90FF"><b>alt shift 6</b></span></li>
|
||
<li>Set menu path to <span style="font-family:'Courier New'; font-size:26px; color:#1E90FF"><b>Script.My Class Script</b></span></li>
|
||
<li>Set toolbar button to <span style="font-family:'Courier New'; font-size:26px; color:#1E90FF"><b>Info.png</b></span></li>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<ul>
|
||
<li>Script Meta-data Exercise Solution</li>
|
||
<br>
|
||
<span style="font-size:22px">
|
||
<pre>
|
||
//This is my class script.
|
||
//It prints "hello class" to the console.
|
||
//@category Category A.Category B
|
||
//@keybinding alt shift 6
|
||
//@menupath Script.My Class Script
|
||
//@toolbar Info.png
|
||
|
||
import ghidra.app.script.GhidraScript;
|
||
|
||
public class MyClassScript extends GhidraScript {
|
||
public void run() throws Exception {
|
||
println("hello class");
|
||
}
|
||
}
|
||
</pre>
|
||
</span>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<br>
|
||
<ul>
|
||
<li>Console</li>
|
||
<ul>
|
||
<li>Provides a place to dump information</li>
|
||
<li>Any text that represents a symbol or address can be navigated by double-clicking</li>
|
||
<li>Example</li>
|
||
<ul>
|
||
<li>Run the <span style="font-family:'Courier New'; font-size:28px">PropagateExternalParameters.java</span> script</li>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<table style="width:100%; border-spacing:2px;">
|
||
<tr>
|
||
<td valign="top">
|
||
<br>
|
||
<ul class="small">
|
||
<li>Ghidra Program API</li>
|
||
<ul>
|
||
<li>Object-oriented</li>
|
||
<li>Very deep</li>
|
||
<li>Can change from version to version</li>
|
||
</ul>
|
||
</ul>
|
||
</td>
|
||
<td>
|
||
<br>
|
||
<ul class="small">
|
||
<li>Program</li>
|
||
<ul>
|
||
<li>Listing</li>
|
||
<ul>
|
||
<li>Instruction</li>
|
||
<li>Data</li>
|
||
<li>Function</li>
|
||
<li>Comments</li>
|
||
<li>...</li>
|
||
</ul>
|
||
<li>Memory</li>
|
||
<ul>
|
||
<li>Memory Blocks</li>
|
||
<li>Bytes</li>
|
||
</ul>
|
||
<li>Symbol Table</li>
|
||
<ul>
|
||
<li>Symbol</li>
|
||
</ul>
|
||
<li>Reference Manager</li>
|
||
<ul>
|
||
<li>Reference</li>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<br>
|
||
<ul>
|
||
<li>Script API</li>
|
||
<ul>
|
||
<li>Flat</li>
|
||
<li>Provides access to most common features</li>
|
||
<li>Is not complete</li>
|
||
<li>Will not change on you</li>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<br>
|
||
<ul>
|
||
<li>Script API</li>
|
||
<br>
|
||
<span style="font-size:25px">
|
||
<pre>
|
||
public abstract class GhidraScript {
|
||
ask...()
|
||
create...()
|
||
find...()
|
||
get...()
|
||
remove...()
|
||
runScript()
|
||
set...()
|
||
to...()
|
||
}
|
||
</pre>
|
||
</span>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<br>
|
||
<ul>
|
||
<li>Script State</li>
|
||
<ul class="medium">
|
||
<li><span style="font-family:'Courier New'; font-size:32px">currentProgram</span></li>
|
||
<ul>
|
||
<li>The current active open program</li>
|
||
</ul>
|
||
<li><span style="font-family:'Courier New'; font-size:32px">currentAddress</span></li>
|
||
<ul>
|
||
<li>The current address of the location of the cursor</li>
|
||
</ul>
|
||
<li><span style="font-family:'Courier New'; font-size:32px">currentLocation</span></li>
|
||
<ul>
|
||
<li>The program location of the cursor</li>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<br>
|
||
<ul>
|
||
<li>Script State (continued)</li>
|
||
<ul class="medium">
|
||
<li><span style="font-family:'Courier New'; font-size:32px">currentSelection</span></li>
|
||
<ul>
|
||
<li>The current <span style="color:#7CFC00">selection</span> or null if no selection exists</li>
|
||
</ul>
|
||
<li><span style="font-family:'Courier New'; font-size:32px">currentHighlight</span></li>
|
||
<ul>
|
||
<li>The current <span style="color:#F0E68C">highlight</span> or null if no highlight exists</li>
|
||
</ul>
|
||
<li><span style="font-family:'Courier New'; font-size:32px">state</span></li>
|
||
<ul>
|
||
<li>Encapsulates script state</li>
|
||
<li>Allows script state to be passed to other called scripts</li>
|
||
<li>Provides place to store environment variables</li>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<br>
|
||
<ul>
|
||
<li>Script State (continued)</li>
|
||
<ul class="small">
|
||
<li><span style="font-family:'Courier New'; font-size:32px">monitor</span></li>
|
||
<ul>
|
||
<li>Allows script writer to inform user</li>
|
||
<ul>
|
||
<li>messages and progress</li>
|
||
</ul>
|
||
<li>Allows user to cancel script</li>
|
||
<li>Always use inside loops</li>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
<br>
|
||
<table style="width:80%; float:inherit; border-spacing:10px;" border="1">
|
||
<tr style="padding: 8px">
|
||
<td style="padding: 8px">
|
||
<span style="font-size:12px; color:#1E90FF;">
|
||
<pre>
|
||
while (!monitor.isCancelled()) {
|
||
...
|
||
}
|
||
</pre>
|
||
</span>
|
||
</td>
|
||
<td>
|
||
<span style="font-size:12px; color:#1E90FF;">
|
||
<pre>
|
||
|
||
for (int i = 0; i < max(); ++i) {
|
||
if (monitor.isCancelled()) {
|
||
break;
|
||
}
|
||
}
|
||
</pre>
|
||
</span>
|
||
</td>
|
||
<td>
|
||
<span style="font-size:12px; color:#1E90FF;">
|
||
<pre>
|
||
inside loop:
|
||
|
||
monitor.checkCancelled();
|
||
|
||
</pre>
|
||
</span>
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<br>
|
||
<ul>
|
||
<li>Eclipse</li>
|
||
<ul>
|
||
<li>Integrated Development Environment (IDE) for Java, Python, C/C++, etc.</li>
|
||
<li>Highly recommended for Ghidra script development</li>
|
||
<ul>
|
||
<li>Officially supported by Ghidra</li>
|
||
<li>Makes development significantly faster and easier</li>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<br>
|
||
<ul>
|
||
<li>GhidraDev Eclipse plugin</li>
|
||
<ul>
|
||
<li>Provides an interface between Eclipse and Ghidra
|
||
<li>Quickly create and manage Ghidra script and module projects</li>
|
||
<li>Can be installed into Eclipse manually or automatically by Ghidra</li>
|
||
<li>Plugin and documentation found at <span style="font-family:'Courier New'; font-size:28px"><GhidraInstall>/Extensions/<br>Eclipse/GhidraDev/</span></li>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<br>
|
||
<ul class="medium">
|
||
<li>Edit Script with Eclipse</li>
|
||
<ul>
|
||
<li>Click the <i>Edit Script with Eclipse</i> button</li>
|
||
<li>Click <i>Yes</i> to point Ghidra at Eclipse</li>
|
||
<li>Enter path to pre-installed Eclipse Installation Directory</li>
|
||
<li>Remaining options can use default values</li>
|
||
<li>Click <i>OK</i> to save changes and launch Eclipse</li>
|
||
<li>Choose Eclipse workspace (default recommended)</li>
|
||
<li>GhidraDev plugin automatically starts during Eclipse initialization (more on next slide)</li>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<br>
|
||
<ul>
|
||
<li>GhidraDev New Script Project Wizard</li>
|
||
<ul>
|
||
<li>Automatically started if a Ghidra Script Project does not exist</li>
|
||
<li>Allows customization of Ghidra script project</li>
|
||
<li>Click <i>Finish</i> to use default wizard settings (recommended)</li>
|
||
<i>OR</i>
|
||
<li>Click <i>Next</i> to see advanced project customization options</li>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<table style="width:100%; border-spacing:5px;">
|
||
<tr>
|
||
<td valign="top">
|
||
<br>
|
||
<ul class="medium">
|
||
<li>Editing in Eclipse</li>
|
||
<ul>
|
||
<li><i>Package Explorer</i></li>
|
||
<ul>
|
||
<li>Projects</li>
|
||
<li>Source Folders</li>
|
||
<ul>
|
||
<li>Packages</li>
|
||
</ul>
|
||
<li>Libraries</li>
|
||
<li>Non-source folders</li>
|
||
<ul>
|
||
<li>Resources</li>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</td>
|
||
<td>
|
||
<br>
|
||
<img src="Images/Scripting/scriptEclipse.png" style="vertical-align:middle"></img>
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<table style="width:100%; border-spacing:5px;">
|
||
<tr>
|
||
<td valign="top">
|
||
<br>
|
||
<ul class="medium">
|
||
<li>Editing in Eclipse</li>
|
||
<ul>
|
||
<li><i>Outline</i></li>
|
||
<ul>
|
||
<li>Methods</li>
|
||
<ul>
|
||
<li><span style="font-size:25px">Public, Protected, Private, Default</span></li>
|
||
</ul>
|
||
<li>Fields</li>
|
||
<ul>
|
||
<li><span style="font-size:25px">Instance, Static</span></li>
|
||
</ul>
|
||
<li>Import Statements</li>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</td>
|
||
<td>
|
||
<br>
|
||
<img src="Images/Scripting/scriptEditEclipse.png" style="vertical-align:middle"></img>
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<table style="width:100%; border-spacing:5px;">
|
||
<tr>
|
||
<br>
|
||
<td valign="top">
|
||
<ul>
|
||
<li>Editing in Eclipse</li>
|
||
<ul>
|
||
<li><i>Hierarchy</i></li>
|
||
<ul>
|
||
<li>Super-class</li>
|
||
<li>Entire sub-class hierarchy</li>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</td>
|
||
<td>
|
||
<br>
|
||
<img src="Images/Scripting/scriptHierarchyEclipse.png" style="vertical-align:middle"></img>
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<ul>
|
||
<li>Editing in Eclipse</li>
|
||
<ul>
|
||
<li><i>Java Editor</i></li>
|
||
</ul>
|
||
<br>
|
||
<img src="Images/Scripting/scriptEditorEclipse.png" style="vertical-align:middle"></img>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<br>
|
||
<ul class="medium">
|
||
<li>Eclipse Java Editor Tips and Tricks</li>
|
||
<ul>
|
||
<li>Open Type (<span style="font-family:'Courier New'; font-size:30px">Control-Shift-T</span>)</li>
|
||
<ul>
|
||
<li>Allows you to find a class without knowing package</li>
|
||
</ul>
|
||
<li>Organize Imports (<span style="font-family:'Courier New'; font-size:30px">Control-Shift-O</span>)</li>
|
||
<ul>
|
||
<li>Automatically fixes import statements</li>
|
||
</ul>
|
||
<li>Navigation (<span style="font-family:'Courier New'; font-size:30px">F3</span>)</li>
|
||
<ul>
|
||
<li>Navigate to the class or method at the current cursor location</li>
|
||
</ul>
|
||
<li>Object Hierarchy (<span style="font-family:'Courier New'; font-size:30px">F4</span>)</li>
|
||
<ul>
|
||
<li>Show the object inheritance hierarchy of current object</li>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<br>
|
||
<ul class="medium">
|
||
<li>Eclipse Java Editor Tips and Tricks (continued)</li>
|
||
<ul>
|
||
<li>Find References (<span style="font-family:'Courier New'; font-size:30px">Control-Shift-G</span>)</li>
|
||
<ul>
|
||
<li>Finds all the places that reference the object at the current cursor location</li>
|
||
</ul>
|
||
<li>Toggle Comments (<span style="font-family:'Courier New'; font-size:30px">Control-/</span>)</li>
|
||
<ul>
|
||
<li>Convert selection to comments, or uncomment the selection</li>
|
||
</ul>
|
||
<li>Outline View (<span style="font-family:'Courier New'; font-size:30px">Control-O</span>)</li>
|
||
<ul>
|
||
<li>Lists methods of the class</li>
|
||
</ul>
|
||
<li>Code Completion (<span style="font-family:'Courier New'; font-size:30px">Control-SPACE</span>)</li>
|
||
<ul>
|
||
<li>Displays a list of matches to completion current expression</li>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<ul>
|
||
<li>Eclipse Java Editor Tips and Tricks (continued)</li>
|
||
<ul>
|
||
<li>Quick Fix (<span style="font-family:'Courier New'; font-size:30px">Control-1</span>)</li>
|
||
<ul>
|
||
<li>Eclipse editor can offer corrections to certain problems underline with a highlight line</li>
|
||
<br>
|
||
<img src="Images/Scripting/scriptCorrectionsEclipse.png" style="vertical-align:middle; horizontal-align:middle"></img>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<ul class="medium">
|
||
<li>Running Scripts</li>
|
||
<ul>
|
||
<li>Scripts are always run from the Ghidra Script Manager, even if they are created/edited in Eclipse</li>
|
||
<li>Any open Ghidra will be able to find and run your script
|
||
<ul>
|
||
<li>No need to launch a new instance of Ghidra</li>
|
||
<li>The Script Manager may need to be refreshed in order to discover new scripts that were created outside of the Script Manager</li>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<ul class="medium">
|
||
<li>Debugging in Eclipse</li>
|
||
<br>
|
||
<ul class="small">
|
||
<li>Launch Ghidra project in debug mode (bug icon)</li>
|
||
<ul>
|
||
<li><b>Note: </b>Any open instances of Ghidra must be closed before launching a new instance of Ghidra from Eclipse</li>
|
||
<img src="Images/Scripting/scriptDebugEclipse.png" style="vertical-align:middle; horizontal-align:middle; width:400px; height: 115px;"></img>
|
||
</ul>
|
||
<br>
|
||
<li>When debugging, scripts are still launched from the Ghidra Script Manager</li>
|
||
<li>Not only can Ghidra scripts be debugged, but so can all of Ghidra!</li>
|
||
<ul>
|
||
<li>To see this, simply "Step Into" any call you make to the Ghidra API.</li>
|
||
</ul>
|
||
<br>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<table style="width:100%; border-spacing:2px;">
|
||
<tr>
|
||
<td>
|
||
<ul class="medium">
|
||
<li>Eclipse <i>Debug</i> window allows you to control the process and threads</li>
|
||
<ul>
|
||
<li>Execution Control Commands</li>
|
||
<ul>
|
||
<li>Resume</li>
|
||
<li>Suspend</li>
|
||
<li>Terminate</li>
|
||
<li>Step Into</li>
|
||
<li>Step Over</li>
|
||
<li>Step Return</li>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</td>
|
||
<td style="vertical-align:middle">
|
||
<img src="Images/Scripting/scriptDebugWindowEclipse.png"></img>
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<ul class="medium">
|
||
<li>Eclipse <i>Breakpoints</i> window display all existing breakpoints</li>
|
||
<ul>
|
||
<li>Remove and modify breakpoints</li>
|
||
<li>All breakpoints global</li>
|
||
<ul>
|
||
<li>Across projects and processes</li>
|
||
<br>
|
||
<img src="Images/Scripting/scriptBreakpointsEclipse.png" style="vertical-align:middle; horizontal-align:middle"></img>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<ul class="medium">
|
||
<li>Breakpoints are created by right-clicking on the left margin of the Eclipse editor and selecting <i>Toggle Breakpoint</i></li>
|
||
<li><span style="font-family:'Courier New'; font-size:30px">Ctrl-Shift-B</span></li>
|
||
<br>
|
||
<img src="Images/Scripting/scriptToggleBreakpointsEclipse.png" style="vertical-align:middle"></img>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<ul class="medium">
|
||
<li>Eclipse <i>Variables</i> window displays variables within scope of the selected thread</li>
|
||
<ul>
|
||
<li>Variables can be inspected and modified from within this window</li>
|
||
<br>
|
||
<img src="Images/Scripting/scriptVariablesEclipse.png" style="vertical-align:middle"></img>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<br><br>
|
||
<ul>
|
||
<li>Script API Example</li>
|
||
<ul>
|
||
<li>Create new script that will ask for an integer and print the current program’s name that many times to the console.</li>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<br>
|
||
<ul>
|
||
<li>Script API Example Solution</li>
|
||
<span style="font-size:20px">
|
||
<br>
|
||
<pre>
|
||
public class PrintProgramScript extends GhidraScript {
|
||
public void run() {
|
||
int n = askInt( "How many times?" , "N" );
|
||
for ( int i = 0 ; i < n ; ++i ) {
|
||
if ( monitor.isCancelled() ) {
|
||
break;
|
||
}
|
||
println( i + ")" + currentProgram.getName() );
|
||
Thread.sleep( 1000 );
|
||
}
|
||
}
|
||
}
|
||
</pre>
|
||
</span>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<br><br>
|
||
<ul>
|
||
<li>Eclipse Exercise</li>
|
||
<ul>
|
||
<li>Debug <span style="font-family:'Courier New'; font-size:32px">PrintProgramScript</span></li>
|
||
<ul>
|
||
<li>Use breakpoints</li>
|
||
<li>Inspect and modify variables</li>
|
||
<li>Use execution control commands</li>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<br>
|
||
<ul class="medium">
|
||
<li>Python support in Ghidra</li>
|
||
<ul>
|
||
<li>Based on Jython, a Java-based Python implementation</li>
|
||
<ul>
|
||
<li>Jython 2.7.1</li>
|
||
<li>Full generic Java API access from Python</li>
|
||
<li>Full access to Ghidra's Java API</li>
|
||
</ul>
|
||
<li>Eclipse support with GhidraDev + PyDev plugins</li>
|
||
<ul>
|
||
<li>PyDev must be independently acquired and installed. See <span style="font-family:'Courier New'; font-size:28px">GhidraDev_README.html</span> for more info.</li>
|
||
</ul>
|
||
<li>Ghidra Python Interpreter plugin</li>
|
||
<ul>
|
||
<li>Click <i>Window -> Python</i></li>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<br>
|
||
<ul class="medium">
|
||
<li>Python Interpreter plugin</li>
|
||
<ul>
|
||
<li>Tightly tied to tool's currently open program</li>
|
||
<li>Issue commands one at a time</li>
|
||
<li>Excellent way to experiment with scripting API</li>
|
||
<li>Ghidra scripting API automatically imported</li>
|
||
<ul>
|
||
<li>Must manually import other Ghidra classes not contained in scripting API</li>
|
||
</ul>
|
||
<li>Type help(<i>item_name</i>) to see API help for a particular script class or method</li>
|
||
<li>Press TAB for code completion on partially typed variable/function</li>
|
||
<li>Hit F1 in interpreter window for more tips and help</li>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<br>
|
||
<ul class="small">
|
||
<li>Python Interpreter Example</li>
|
||
<ul>
|
||
<li>Print memory block information</li>
|
||
</ul>
|
||
<span style="font-size:20px">
|
||
<pre>
|
||
|
||
Python Interpreter for Ghidra
|
||
Based on Jython version 2.7.1 (default:0df7adb1b397, Jun 30 2017, 19:02:43)
|
||
[Java HotSpot(TM) 64-Bit Server VM (Oracle Corporation)]
|
||
Press 'F1' for usage instructions
|
||
>>>
|
||
>>> mem = currentProgram.getMemory()
|
||
>>> for block in mem.getBlocks():
|
||
... print block.getName() + ", " + hex(block.getSize())
|
||
...
|
||
Headers, 0x400L
|
||
.textbss, 0x10000L
|
||
.text, 0x4b57L
|
||
.rdata, 0x1ed6L
|
||
.data, 0x200L
|
||
.data, 0x384L
|
||
.idata, 0x8b7L
|
||
.rsrc, 0x1b4L
|
||
.reloc, 0x48fL
|
||
</pre>
|
||
</span>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<br>
|
||
<ul class="small">
|
||
<li>Python Interpreter Exercise</li>
|
||
<br>
|
||
<ol class="decimal medium">
|
||
<li>Make a selection in your program with your mouse</li>
|
||
<li>Ask the user for an address using the GhidraScript API</li>
|
||
<li>Determine if the current selection contains the address entered by the user</li>
|
||
</ol>
|
||
<br>
|
||
<ul>
|
||
<li>Hints:
|
||
<ul>
|
||
<li>Use TAB-completion to figure out how to <b>ask</b> the user for an address</li>
|
||
<li>Use the help() command on <i>currentSelection</i> to find and use a function that checks if a program selection contains an address</li>
|
||
</ul>
|
||
</ul>
|
||
</ul>
|
||
</section>
|
||
|
||
<section>
|
||
<header>Scripting</header>
|
||
<ul>
|
||
<li>Python Interpreter Exercise Solution</li>
|
||
<span style="font-size:20px">
|
||
<pre>
|
||
|
||
Python Interpreter for Ghidra
|
||
Based on Jython version 2.7.1 (default:0df7adb1b397, Jun 30 2017, 19:02:43)
|
||
[Java HotSpot(TM) 64-Bit Server VM (Oracle Corporation)]
|
||
Press 'F1' for usage instructions
|
||
>>>
|
||
>>> currentSelection
|
||
ProgramSelection: [[01022362, 01022379] ]
|
||
>>> addr = askAddress("Address", "Enter an address")
|
||
>>> addr
|
||
0102236b
|
||
>>> currentSelection.contains(addr)
|
||
True
|
||
>>> addr = askAddress("Address", "Enter an address")
|
||
>>> addr
|
||
00000000
|
||
>>> currentSelection.contains(addr)
|
||
False
|
||
</pre>
|
||
</span>
|
||
</ul>
|
||
</section>
|
||
|
||
|
||
<!-- COPY THE TEXT BELOW TO START A NEW SLIDE
|
||
<section>
|
||
<header>Insert Title of Slide Here</header>
|
||
<ul class="small" comment="NOTE: remove the class attribute for regular size, adjust the name if you want big, small, or tiny">
|
||
<li>Bullet text here</li>
|
||
<ul>
|
||
<li>Nested bullet here</li>
|
||
</ul>
|
||
</ul>
|
||
<div role="note">
|
||
<p>Insert notes here</p>
|
||
<p>And here, too</p>
|
||
</div>
|
||
</section>
|
||
END COPY -->
|
||
|
||
<!-- Your Style -->
|
||
<!-- Define the style of your presentation -->
|
||
|
||
<!-- Maybe a font from http://www.google.com/webfonts ? -->
|
||
<!--link href='http://fonts.googleapis.com/css?family=Oswald' rel='stylesheet'-->
|
||
|
||
<style>
|
||
html, .view body { background-color: black; counter-reset: slideidx; }
|
||
body, .view section { background-color: black; border-radius: 12px; color: white; }
|
||
/* A section is a slide. It's size is 800x600, and this will never change */
|
||
section, .view head > title {
|
||
font-family: arial, serif;
|
||
font-size: 35px;
|
||
}
|
||
|
||
.view section:after {
|
||
counter-increment: slideidx;
|
||
content: counter(slideidx, decimal-leading-zero);
|
||
position: absolute; bottom: -80px; right: 100px;
|
||
color: black;
|
||
}
|
||
|
||
.view head > title {
|
||
color: black;
|
||
text-align: center;
|
||
margin: 1em 0 1em 0;
|
||
}
|
||
|
||
h1, h2 {
|
||
margin-top: 200px;
|
||
text-align: center;
|
||
font-size: 80px;
|
||
font-family: 'Times New Roman'
|
||
}
|
||
|
||
h3 {
|
||
margin: 100px 0 50px 100px;
|
||
}
|
||
|
||
/* My custom list sizes */
|
||
|
||
.big ul {
|
||
font-size: 45px;
|
||
}
|
||
|
||
.big ol {
|
||
font-size: 45px;
|
||
}
|
||
|
||
.big li {
|
||
font-size: 45px;
|
||
}
|
||
|
||
.big li:before {
|
||
font-size: 200px;
|
||
}
|
||
|
||
.medium ul {
|
||
margin: 0px 0px;
|
||
font-size: 30px;
|
||
}
|
||
|
||
.medium ol {
|
||
margin: 0px 0px;
|
||
font-size: 30px;
|
||
}
|
||
|
||
.medium li {
|
||
margin: 0px 0px;
|
||
font-size: 30px;
|
||
}
|
||
|
||
.medium li:before {
|
||
font-size: 120px;
|
||
}
|
||
|
||
.small ul {
|
||
margin: 0px 0px;
|
||
font-size: 25px;
|
||
}
|
||
|
||
.small ol {
|
||
margin: 0px 0px;
|
||
font-size: 25px;
|
||
}
|
||
|
||
.small li {
|
||
margin: 0px 0px;
|
||
font-size: 25px;
|
||
}
|
||
|
||
.small li:before {
|
||
font-size: 80px;
|
||
}
|
||
|
||
.tiny ul {
|
||
margin: 0px 0px;
|
||
font-size: 20px;
|
||
}
|
||
|
||
.tiny ol {
|
||
margin: 0px 0px;
|
||
font-size: 20px;
|
||
}
|
||
|
||
.tiny li {
|
||
margin: 0px 0px;
|
||
font-size: 20px;
|
||
}
|
||
|
||
.tiny li:before {
|
||
font-size: 70px;
|
||
}
|
||
/* end custom list sizes */
|
||
|
||
/* Standard list size */
|
||
ul {
|
||
margin: 10px 50px;
|
||
font-size: 35px;
|
||
list-style-type: none;
|
||
margin-left: 0;
|
||
padding-left: 1em;
|
||
text-indent: -1em;
|
||
}
|
||
|
||
ol {
|
||
margin: 10px 50px;
|
||
font-size: 35px;
|
||
list-style-type: none;
|
||
margin-left: 0;
|
||
padding-left: 1em;
|
||
text-indent: -1em;
|
||
}
|
||
|
||
ol.decimal {
|
||
list-style-position: inside;
|
||
list-style-type: decimal;
|
||
}
|
||
|
||
li {
|
||
margin: 10px 10px;
|
||
font-size: 35px;
|
||
}
|
||
|
||
ul > li:before {
|
||
content:"·";
|
||
font-size:160px;
|
||
vertical-align:middle;
|
||
line-height: 20px;
|
||
color: red;
|
||
}
|
||
|
||
|
||
/* end custom list sizes */
|
||
|
||
p {
|
||
margin: 75px;
|
||
font-size: 100px;
|
||
}
|
||
|
||
blockquote {
|
||
height: 100%;
|
||
background-color: black;
|
||
color: white;
|
||
font-size: 60px;
|
||
padding: 50px;
|
||
}
|
||
blockquote:before {
|
||
content: open-quote;
|
||
}
|
||
blockquote:after {
|
||
content: close-quote;
|
||
}
|
||
|
||
/* Figures are displayed full-page, with the caption
|
||
on top of the image/video */
|
||
figure {
|
||
background-color: black;
|
||
width: 100%;
|
||
height: 100%;
|
||
}
|
||
figure > * {
|
||
position: absolute;
|
||
}
|
||
figure > img, figure > video {
|
||
width: 100%; height: 100%;
|
||
}
|
||
figcaption {
|
||
margin: 70px;
|
||
font-size: 50px;
|
||
}
|
||
|
||
footer {
|
||
position: absolute;
|
||
bottom: 0;
|
||
width: 100%;
|
||
padding: 40px;
|
||
text-align: right;
|
||
background-color: black;
|
||
border-top: 1px solid #CCC;
|
||
}
|
||
|
||
header {
|
||
font-family: 'Times New Roman';
|
||
position: relative;
|
||
top: 0px;
|
||
width: 100%;
|
||
padding: 0px;
|
||
text-align: center;
|
||
background-image: url(Images/GhidraLogo64.png), url(Images/GhidraLogo64.png);
|
||
background-repeat: no-repeat, no-repeat;
|
||
background-position: left top, right top;
|
||
background-size: contain, contain;
|
||
border-bottom: 1px solid red;
|
||
font-size: 50px;
|
||
}
|
||
|
||
/* Transition effect */
|
||
/* Feel free to change the transition effect for original
|
||
animations. See here:
|
||
https://developer.mozilla.org/en/CSS/CSS_transitions
|
||
How to use CSS3 Transitions: */
|
||
section {
|
||
-moz-transition: left 400ms linear 0s;
|
||
-webkit-transition: left 400ms linear 0s;
|
||
-ms-transition: left 400ms linear 0s;
|
||
transition: left 400ms linear 0s;
|
||
}
|
||
.view section {
|
||
-moz-transition: none;
|
||
-webkit-transition: none;
|
||
-ms-transition: none;
|
||
transition: none;
|
||
}
|
||
|
||
.view section[aria-selected] {
|
||
border: 5px red solid;
|
||
}
|
||
|
||
/* Before */
|
||
section { left: -150%; }
|
||
/* Now */
|
||
section[aria-selected] { left: 0; }
|
||
/* After */
|
||
section[aria-selected] ~ section { left: +150%; }
|
||
|
||
/* Incremental elements */
|
||
|
||
/* By default, visible */
|
||
.incremental > * { opacity: 1; }
|
||
|
||
/* The current item */
|
||
.incremental > *[aria-selected] { opacity: 1; }
|
||
|
||
/* The items to-be-selected */
|
||
.incremental > *[aria-selected] ~ * { opacity: 0; }
|
||
|
||
/* The progressbar, at the bottom of the slides, show the global
|
||
progress of the presentation. */
|
||
#progress-bar {
|
||
height: 2px;
|
||
background: #AAA;
|
||
}
|
||
</style>
|
||
|
||
<!-- {{{{ dzslides core
|
||
#
|
||
#
|
||
# __ __ __ . __ ___ __
|
||
# | \ / /__` | | | \ |__ /__`
|
||
# |__/ /_ .__/ |___ | |__/ |___ .__/ core :€
|
||
#
|
||
#
|
||
# The following block of code is not supposed to be edited.
|
||
# But if you want to change the behavior of these slides,
|
||
# feel free to hack it!
|
||
#
|
||
-->
|
||
|
||
<div id="progress-bar"></div>
|
||
|
||
<!-- Default Style -->
|
||
<style>
|
||
* { margin: 0; padding: 0; -moz-box-sizing: border-box; -webkit-box-sizing: border-box; box-sizing: border-box; }
|
||
[role="note"] { display: none; }
|
||
body {
|
||
width: 800px; height: 600px;
|
||
margin-left: -400px; margin-top: -300px;
|
||
position: absolute; top: 50%; left: 50%;
|
||
overflow: hidden;
|
||
display: none;
|
||
}
|
||
.view body {
|
||
position: static;
|
||
margin: 0; padding: 0;
|
||
width: 100%; height: 100%;
|
||
display: inline-block;
|
||
overflow: visible; overflow-x: hidden;
|
||
/* undo Dz.onresize */
|
||
transform: none !important;
|
||
-moz-transform: none !important;
|
||
-webkit-transform: none !important;
|
||
-o-transform: none !important;
|
||
-ms-transform: none !important;
|
||
}
|
||
.view head, .view head > title { display: block }
|
||
section {
|
||
position: absolute;
|
||
pointer-events: none;
|
||
width: 100%; height: 100%;
|
||
}
|
||
.view section {
|
||
pointer-events: auto;
|
||
position: static;
|
||
width: 800px; height: 600px;
|
||
margin: -150px -200px;
|
||
float: left;
|
||
|
||
transform: scale(.4);
|
||
-moz-transform: scale(.4);
|
||
-webkit-transform: scale(.4);
|
||
-o-transform: scale(.4);
|
||
-ms-transform: scale(.4);
|
||
}
|
||
.view section > * { pointer-events: none; }
|
||
section[aria-selected] { pointer-events: auto; }
|
||
html { overflow: hidden; }
|
||
html.view { overflow: visible; }
|
||
body.loaded { display: block; }
|
||
.incremental {visibility: hidden; }
|
||
.incremental[active] {visibility: visible; }
|
||
#progress-bar{
|
||
bottom: 0;
|
||
position: absolute;
|
||
-moz-transition: width 400ms linear 0s;
|
||
-webkit-transition: width 400ms linear 0s;
|
||
-ms-transition: width 400ms linear 0s;
|
||
transition: width 400ms linear 0s;
|
||
}
|
||
.view #progress-bar {
|
||
display: none;
|
||
}
|
||
</style>
|
||
|
||
<script>
|
||
var Dz = {
|
||
remoteWindows: [],
|
||
idx: -1,
|
||
step: 0,
|
||
html: null,
|
||
slides: null,
|
||
progressBar : null,
|
||
params: {
|
||
autoplay: "1"
|
||
}
|
||
};
|
||
|
||
Dz.init = function() {
|
||
document.body.className = "loaded";
|
||
this.slides = Array.prototype.slice.call($$("body > section"));
|
||
this.progressBar = $("#progress-bar");
|
||
this.html = document.body.parentNode;
|
||
this.setupParams();
|
||
this.onhashchange();
|
||
this.setupTouchEvents();
|
||
this.onresize();
|
||
this.setupView();
|
||
}
|
||
|
||
Dz.setupParams = function() {
|
||
var p = window.location.search.substr(1).split('&');
|
||
p.forEach(function(e, i, a) {
|
||
var keyVal = e.split('=');
|
||
Dz.params[keyVal[0]] = decodeURIComponent(keyVal[1]);
|
||
});
|
||
// Specific params handling
|
||
if (!+this.params.autoplay)
|
||
$$.forEach($$("video"), function(v){ v.controls = true });
|
||
}
|
||
|
||
Dz.onkeydown = function(aEvent) {
|
||
// Don't intercept keyboard shortcuts
|
||
if (aEvent.altKey
|
||
|| aEvent.ctrlKey
|
||
|| aEvent.metaKey
|
||
|| aEvent.shiftKey) {
|
||
return;
|
||
}
|
||
if ( aEvent.keyCode == 37 // left arrow
|
||
|| aEvent.keyCode == 38 // up arrow
|
||
|| aEvent.keyCode == 33 // page up
|
||
) {
|
||
aEvent.preventDefault();
|
||
this.back();
|
||
}
|
||
if ( aEvent.keyCode == 39 // right arrow
|
||
|| aEvent.keyCode == 40 // down arrow
|
||
|| aEvent.keyCode == 34 // page down
|
||
) {
|
||
aEvent.preventDefault();
|
||
this.forward();
|
||
}
|
||
if (aEvent.keyCode == 35) { // end
|
||
aEvent.preventDefault();
|
||
this.goEnd();
|
||
}
|
||
if (aEvent.keyCode == 36) { // home
|
||
aEvent.preventDefault();
|
||
this.goStart();
|
||
}
|
||
if (aEvent.keyCode == 32) { // space
|
||
aEvent.preventDefault();
|
||
this.toggleContent();
|
||
}
|
||
if (aEvent.keyCode == 70) { // f
|
||
aEvent.preventDefault();
|
||
this.goFullscreen();
|
||
}
|
||
if (aEvent.keyCode == 79) { // o
|
||
aEvent.preventDefault();
|
||
this.toggleView();
|
||
}
|
||
}
|
||
|
||
/* Touch Events */
|
||
|
||
Dz.setupTouchEvents = function() {
|
||
var orgX, newX;
|
||
var tracking = false;
|
||
|
||
var db = document.body;
|
||
db.addEventListener("touchstart", start.bind(this), false);
|
||
db.addEventListener("touchmove", move.bind(this), false);
|
||
|
||
function start(aEvent) {
|
||
aEvent.preventDefault();
|
||
tracking = true;
|
||
orgX = aEvent.changedTouches[0].pageX;
|
||
}
|
||
|
||
function move(aEvent) {
|
||
if (!tracking) return;
|
||
newX = aEvent.changedTouches[0].pageX;
|
||
if (orgX - newX > 100) {
|
||
tracking = false;
|
||
this.forward();
|
||
} else {
|
||
if (orgX - newX < -100) {
|
||
tracking = false;
|
||
this.back();
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
Dz.setupView = function() {
|
||
document.body.addEventListener("click", function ( e ) {
|
||
if (!Dz.html.classList.contains("view")) return;
|
||
if (!e.target || e.target.nodeName != "SECTION") return;
|
||
|
||
Dz.html.classList.remove("view");
|
||
Dz.setCursor(Dz.slides.indexOf(e.target) + 1);
|
||
}, false);
|
||
}
|
||
|
||
/* Adapt the size of the slides to the window */
|
||
|
||
Dz.onresize = function() {
|
||
var db = document.body;
|
||
var sx = db.clientWidth / window.innerWidth;
|
||
var sy = db.clientHeight / window.innerHeight;
|
||
var transform = "scale(" + (1/Math.max(sx, sy)) + ")";
|
||
|
||
db.style.MozTransform = transform;
|
||
db.style.WebkitTransform = transform;
|
||
db.style.OTransform = transform;
|
||
db.style.msTransform = transform;
|
||
db.style.transform = transform;
|
||
}
|
||
|
||
|
||
Dz.getNotes = function(aIdx) {
|
||
var s = $("section:nth-of-type(" + aIdx + ")");
|
||
var d = s.$("[role='note']");
|
||
return d ? d.innerHTML : "";
|
||
}
|
||
|
||
Dz.onmessage = function(aEvent) {
|
||
var argv = aEvent.data.split(" "), argc = argv.length;
|
||
argv.forEach(function(e, i, a) { a[i] = decodeURIComponent(e) });
|
||
var win = aEvent.source;
|
||
if (argv[0] === "REGISTER" && argc === 1) {
|
||
this.remoteWindows.push(win);
|
||
this.postMsg(win, "REGISTERED", document.title, this.slides.length);
|
||
this.postMsg(win, "CURSOR", this.idx + "." + this.step);
|
||
return;
|
||
}
|
||
if (argv[0] === "BACK" && argc === 1)
|
||
this.back();
|
||
if (argv[0] === "FORWARD" && argc === 1)
|
||
this.forward();
|
||
if (argv[0] === "START" && argc === 1)
|
||
this.goStart();
|
||
if (argv[0] === "END" && argc === 1)
|
||
this.goEnd();
|
||
if (argv[0] === "TOGGLE_CONTENT" && argc === 1)
|
||
this.toggleContent();
|
||
if (argv[0] === "SET_CURSOR" && argc === 2)
|
||
window.location.hash = "#" + argv[1];
|
||
if (argv[0] === "GET_CURSOR" && argc === 1)
|
||
this.postMsg(win, "CURSOR", this.idx + "." + this.step);
|
||
if (argv[0] === "GET_NOTES" && argc === 1)
|
||
this.postMsg(win, "NOTES", this.getNotes(this.idx));
|
||
}
|
||
|
||
Dz.toggleContent = function() {
|
||
// If a Video is present in this new slide, play it.
|
||
// If a Video is present in the previous slide, stop it.
|
||
var s = $("section[aria-selected]");
|
||
if (s) {
|
||
var video = s.$("video");
|
||
if (video) {
|
||
if (video.ended || video.paused) {
|
||
video.play();
|
||
} else {
|
||
video.pause();
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
Dz.setCursor = function(aIdx, aStep) {
|
||
// If the user change the slide number in the URL bar, jump
|
||
// to this slide.
|
||
aStep = (aStep != 0 && typeof aStep !== "undefined") ? "." + aStep : ".0";
|
||
window.location.hash = "#" + aIdx + aStep;
|
||
}
|
||
|
||
Dz.onhashchange = function() {
|
||
var cursor = window.location.hash.split("#"),
|
||
newidx = 1,
|
||
newstep = 0;
|
||
if (cursor.length == 2) {
|
||
newidx = ~~cursor[1].split(".")[0];
|
||
newstep = ~~cursor[1].split(".")[1];
|
||
if (newstep > Dz.slides[newidx - 1].$$('.incremental > *').length) {
|
||
newstep = 0;
|
||
newidx++;
|
||
}
|
||
}
|
||
this.setProgress(newidx, newstep);
|
||
if (newidx != this.idx) {
|
||
this.setSlide(newidx);
|
||
}
|
||
if (newstep != this.step) {
|
||
this.setIncremental(newstep);
|
||
}
|
||
for (var i = 0; i < this.remoteWindows.length; i++) {
|
||
this.postMsg(this.remoteWindows[i], "CURSOR", this.idx + "." + this.step);
|
||
}
|
||
}
|
||
|
||
Dz.back = function() {
|
||
if (this.idx == 1 && this.step == 0) {
|
||
return;
|
||
}
|
||
if (this.step == 0) {
|
||
this.setCursor(this.idx - 1,
|
||
this.slides[this.idx - 2].$$('.incremental > *').length);
|
||
} else {
|
||
this.setCursor(this.idx, this.step - 1);
|
||
}
|
||
}
|
||
|
||
Dz.forward = function() {
|
||
if (this.idx >= this.slides.length &&
|
||
this.step >= this.slides[this.idx - 1].$$('.incremental > *').length) {
|
||
return;
|
||
}
|
||
if (this.step >= this.slides[this.idx - 1].$$('.incremental > *').length) {
|
||
this.setCursor(this.idx + 1, 0);
|
||
} else {
|
||
this.setCursor(this.idx, this.step + 1);
|
||
}
|
||
}
|
||
|
||
Dz.goStart = function() {
|
||
this.setCursor(1, 0);
|
||
}
|
||
|
||
Dz.goEnd = function() {
|
||
var lastIdx = this.slides.length;
|
||
var lastStep = this.slides[lastIdx - 1].$$('.incremental > *').length;
|
||
this.setCursor(lastIdx, lastStep);
|
||
}
|
||
|
||
Dz.toggleView = function() {
|
||
this.html.classList.toggle("view");
|
||
|
||
if (this.html.classList.contains("view")) {
|
||
$("section[aria-selected]").scrollIntoView(true);
|
||
}
|
||
}
|
||
|
||
Dz.setSlide = function(aIdx) {
|
||
this.idx = aIdx;
|
||
var old = $("section[aria-selected]");
|
||
var next = $("section:nth-of-type("+ this.idx +")");
|
||
if (old) {
|
||
old.removeAttribute("aria-selected");
|
||
var video = old.$("video");
|
||
if (video) {
|
||
video.pause();
|
||
}
|
||
}
|
||
if (next) {
|
||
next.setAttribute("aria-selected", "true");
|
||
if (this.html.classList.contains("view")) {
|
||
next.scrollIntoView();
|
||
}
|
||
var video = next.$("video");
|
||
if (video && !!+this.params.autoplay) {
|
||
video.play();
|
||
}
|
||
} else {
|
||
// That should not happen
|
||
this.idx = -1;
|
||
// console.warn("Slide doesn't exist.");
|
||
}
|
||
}
|
||
|
||
Dz.setIncremental = function(aStep) {
|
||
this.step = aStep;
|
||
var old = this.slides[this.idx - 1].$('.incremental > *[aria-selected]');
|
||
if (old) {
|
||
old.removeAttribute('aria-selected');
|
||
}
|
||
var incrementals = $$('.incremental');
|
||
if (this.step <= 0) {
|
||
$$.forEach(incrementals, function(aNode) {
|
||
aNode.removeAttribute('active');
|
||
});
|
||
return;
|
||
}
|
||
var next = this.slides[this.idx - 1].$$('.incremental > *')[this.step - 1];
|
||
if (next) {
|
||
next.setAttribute('aria-selected', true);
|
||
next.parentNode.setAttribute('active', true);
|
||
var found = false;
|
||
$$.forEach(incrementals, function(aNode) {
|
||
if (aNode != next.parentNode)
|
||
if (found)
|
||
aNode.removeAttribute('active');
|
||
else
|
||
aNode.setAttribute('active', true);
|
||
else
|
||
found = true;
|
||
});
|
||
} else {
|
||
setCursor(this.idx, 0);
|
||
}
|
||
return next;
|
||
}
|
||
|
||
Dz.goFullscreen = function() {
|
||
var html = $('html'),
|
||
requestFullscreen = html.requestFullscreen || html.requestFullScreen || html.mozRequestFullScreen || html.webkitRequestFullScreen;
|
||
if (requestFullscreen) {
|
||
requestFullscreen.apply(html);
|
||
}
|
||
}
|
||
|
||
Dz.setProgress = function(aIdx, aStep) {
|
||
var slide = $("section:nth-of-type("+ aIdx +")");
|
||
if (!slide)
|
||
return;
|
||
var steps = slide.$$('.incremental > *').length + 1,
|
||
slideSize = 100 / (this.slides.length - 1),
|
||
stepSize = slideSize / steps;
|
||
this.progressBar.style.width = ((aIdx - 1) * slideSize + aStep * stepSize) + '%';
|
||
}
|
||
|
||
Dz.postMsg = function(aWin, aMsg) { // [arg0, [arg1...]]
|
||
aMsg = [aMsg];
|
||
for (var i = 2; i < arguments.length; i++)
|
||
aMsg.push(encodeURIComponent(arguments[i]));
|
||
aWin.postMessage(aMsg.join(" "), "*");
|
||
}
|
||
|
||
function init() {
|
||
Dz.init();
|
||
window.onkeydown = Dz.onkeydown.bind(Dz);
|
||
window.onresize = Dz.onresize.bind(Dz);
|
||
window.onhashchange = Dz.onhashchange.bind(Dz);
|
||
window.onmessage = Dz.onmessage.bind(Dz);
|
||
}
|
||
|
||
window.onload = init;
|
||
</script>
|
||
|
||
|
||
<script> // Helpers
|
||
if (!Function.prototype.bind) {
|
||
Function.prototype.bind = function (oThis) {
|
||
|
||
// closest thing possible to the ECMAScript 5 internal IsCallable
|
||
// function
|
||
if (typeof this !== "function")
|
||
throw new TypeError(
|
||
"Function.prototype.bind - what is trying to be fBound is not callable"
|
||
);
|
||
|
||
var aArgs = Array.prototype.slice.call(arguments, 1),
|
||
fToBind = this,
|
||
fNOP = function () {},
|
||
fBound = function () {
|
||
return fToBind.apply( this instanceof fNOP ? this : oThis || window,
|
||
aArgs.concat(Array.prototype.slice.call(arguments)));
|
||
};
|
||
|
||
fNOP.prototype = this.prototype;
|
||
fBound.prototype = new fNOP();
|
||
|
||
return fBound;
|
||
};
|
||
}
|
||
|
||
var $ = (HTMLElement.prototype.$ = function(aQuery) {
|
||
return this.querySelector(aQuery);
|
||
}).bind(document);
|
||
|
||
var $$ = (HTMLElement.prototype.$$ = function(aQuery) {
|
||
return this.querySelectorAll(aQuery);
|
||
}).bind(document);
|
||
|
||
$$.forEach = function(nodeList, fun) {
|
||
Array.prototype.forEach.call(nodeList, fun);
|
||
}
|
||
|
||
</script>
|
||
<!-- vim: set fdm=marker: }}} -->
|