├── .gitignore
├── examples
    ├── 2d_scene.rs
    └── 3d_scene.rs
├── Cargo.toml
├── LICENSE-MIT
├── .github
    └── workflows
    │   └── main.yml
├── README.md
├── src
    └── lib.rs
└── LICENSE-APACHE


/.gitignore:
--------------------------------------------------------------------------------
1 | /target
2 | /Cargo.lock
3 | 


--------------------------------------------------------------------------------
/examples/2d_scene.rs:
--------------------------------------------------------------------------------
 1 | //! A simple 2D scene using orthographic controls.
 2 | 
 3 | use bevy::prelude::*;
 4 | use bevy_spectator::*;
 5 | 
 6 | fn main() {
 7 |     App::new()
 8 |         .insert_resource(SpectatorSettings {
 9 |             base_speed: 100.0,
10 |             alt_speed: 350.0,
11 |             orthographic: true,
12 |             ..default()
13 |         })
14 |         .add_plugins((DefaultPlugins, SpectatorPlugin))
15 |         .add_systems(Startup, setup)
16 |         .run();
17 | }
18 | 
19 | fn setup(mut commands: Commands) {
20 |     commands.spawn((Camera2d, Spectator));
21 |     commands.spawn((
22 |         Sprite::default(),
23 |         Transform::from_scale(Vec3::new(10.0, 10.0, 1.0)),
24 |     ));
25 | }
26 | 


--------------------------------------------------------------------------------
/Cargo.toml:
--------------------------------------------------------------------------------
 1 | [package]
 2 | name = "bevy_spectator"
 3 | description = "A spectator camera plugin for Bevy"
 4 | version = "0.8.0"
 5 | edition = "2021"
 6 | authors = ["JonahPlusPlus <33059163+JonahPlusPlus@users.noreply.github.com>"]
 7 | license = "MIT OR Apache-2.0"
 8 | documentation = "https://docs.rs/bevy_spectator"
 9 | homepage = "https://github.com/JonahPlusPlus/bevy_spectator"
10 | repository = "https://github.com/JonahPlusPlus/bevy_spectator"
11 | include = ["/src", "/examples", "/LICENSE*"]
12 | 
13 | [dependencies]
14 | bevy = { version = "0.16", default-features = false, features = [
15 |   "bevy_window",
16 |   "bevy_log",
17 | ] }
18 | 
19 | [dev-dependencies]
20 | bevy = { version = "0.16", default-features = false, features = [
21 |   "bevy_asset",
22 |   "bevy_core_pipeline",
23 |   "bevy_pbr",
24 |   "bevy_render",
25 |   "bevy_sprite",
26 |   "bevy_window",
27 |   "bevy_log",
28 |   "x11",
29 |   "ktx2",
30 |   "zstd",
31 |   "tonemapping_luts",
32 | ] }
33 | 
34 | [features]
35 | default = ["init"]
36 | init = []          # Enables automatically choosing a camera
37 | 


--------------------------------------------------------------------------------
/LICENSE-MIT:
--------------------------------------------------------------------------------
 1 | MIT License
 2 | 
 3 | Copyright (c) 2021 JonahPlusPlus (Jonah Henriksson)
 4 | 
 5 | Permission is hereby granted, free of charge, to any person obtaining a copy
 6 | of this software and associated documentation files (the "Software"), to deal
 7 | in the Software without restriction, including without limitation the rights
 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 | 
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 | 
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.


--------------------------------------------------------------------------------
/examples/3d_scene.rs:
--------------------------------------------------------------------------------
 1 | //! A simple scene (based off Bevy's 3d_scene example).
 2 | 
 3 | use bevy::prelude::*;
 4 | use bevy_spectator::*;
 5 | 
 6 | fn main() {
 7 |     App::new()
 8 |         .insert_resource(SpectatorSettings {
 9 |             base_speed: 5.0,
10 |             alt_speed: 15.0,
11 |             sensitivity: 0.0015,
12 |             ..default()
13 |         })
14 |         .add_plugins((DefaultPlugins, SpectatorPlugin))
15 |         .add_systems(Startup, setup)
16 |         .run();
17 | }
18 | 
19 | fn setup(
20 |     mut commands: Commands,
21 |     mut meshes: ResMut<Assets<Mesh>>,
22 |     mut materials: ResMut<Assets<StandardMaterial>>,
23 | ) {
24 |     commands.spawn((
25 |         Camera3d::default(),
26 |         Transform::from_xyz(-3.0, 1.5, 3.0).looking_at(Vec3::ZERO, Vec3::Y),
27 |         Spectator,
28 |     ));
29 |     commands.spawn((
30 |         PointLight {
31 |             shadows_enabled: true,
32 |             ..default()
33 |         },
34 |         Transform::from_xyz(4.0, 8.0, 4.0),
35 |     ));
36 | 
37 |     commands.spawn((
38 |         Mesh3d(meshes.add(Plane3d::default().mesh().size(5.0, 5.0))),
39 |         MeshMaterial3d(materials.add(Color::srgb(0.3, 0.5, 0.3))),
40 |     ));
41 |     commands.spawn((
42 |         Mesh3d(meshes.add(Cuboid::default())),
43 |         MeshMaterial3d(materials.add(Color::srgb(0.8, 0.7, 0.6))),
44 |         Transform::from_xyz(0.0, 0.5, 0.0),
45 |     ));
46 | }
47 | 


--------------------------------------------------------------------------------
/.github/workflows/main.yml:
--------------------------------------------------------------------------------
 1 | name: Main
 2 | on:
 3 |   push:
 4 |     branches:
 5 |       - master
 6 |     paths-ignore:
 7 |       - ".gitignore"
 8 |   pull_request:
 9 |     paths-ignore:
10 |       - ".gitignore"
11 | env:
12 |   CARGO_TERM_COLOR: always
13 | jobs:
14 |   format:
15 |     name: Format
16 |     runs-on: ubuntu-latest
17 |     steps:
18 |       - name: Clone repo
19 |         uses: actions/checkout@v3
20 | 
21 |       - name: Cache crates
22 |         uses: Swatinem/rust-cache@v2
23 | 
24 |       - name: Install Taplo
25 |         run: cargo install taplo-cli
26 | 
27 |       - name: Format
28 |         run: |
29 |           cargo fmt --check
30 |           taplo fmt --check
31 | 
32 |   lint:
33 |     name: Lint
34 |     runs-on: ubuntu-latest
35 |     steps:
36 |       - name: Clone repo
37 |         uses: actions/checkout@v3
38 | 
39 |       - name: Instal stable toolchain
40 |         uses: dtolnay/rust-toolchain@stable
41 | 
42 |       - name: Cache crates
43 |         uses: Swatinem/rust-cache@v2
44 | 
45 |       - name: Clippy
46 |         run: cargo clippy --no-deps --tests --examples -- -D warnings
47 | 
48 |       - name: Rustdoc
49 |         run: cargo rustdoc -- -D warnings
50 | 
51 |   test:
52 |     name: Test
53 |     runs-on: ubuntu-latest
54 |     steps:
55 |       - name: Clone repo
56 |         uses: actions/checkout@v3
57 | 
58 |       - name: Instal stable toolchain
59 |         uses: dtolnay/rust-toolchain@stable
60 | 
61 |       - name: Cache crates
62 |         uses: Swatinem/rust-cache@v2
63 | 
64 |       - name: Test
65 |         run: cargo test
66 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # Bevy Spectator
 2 | 
 3 | [![crates.io](https://img.shields.io/crates/v/bevy_spectator)](https://crates.io/crates/bevy_spectator)
 4 | [![crates.io](https://img.shields.io/crates/d/bevy_spectator)](https://crates.io/crates/bevy_spectator)
 5 | [![docs.rs](https://docs.rs/bevy_spectator/badge.svg)](https://docs.rs/bevy_spectator)
 6 | 
 7 | A spectator camera plugin for the [Bevy game engine](https://bevyengine.org/).
 8 | 
 9 | ## Controls
10 | 
11 | | Action            | Key           |
12 | |-------------------|---------------|
13 | | Forward           | `W`           |
14 | | Left              | `A`           |
15 | | Backward          | `S`           |
16 | | Right             | `D`           |
17 | | Up                | `Space`       |
18 | | Down              | `ControlLeft` |
19 | | Alternative Speed | `ShiftLeft`   |
20 | | Release Cursor    | `Escape`      |
21 | 
22 | Movement is constrained to the appropriate axes. (`WASD` to X & Z axes, `Space` & `ShiftLeft` to the Y axis)
23 | 
24 | When in orthographic mode, only `WASD` is used.
25 | 
26 | ## Basic example
27 | 
28 | ```rust,no_run
29 | use bevy::prelude::*;
30 | use bevy_spectator::*;
31 | 
32 | fn main() {
33 |     App::new()
34 |         .add_plugins((DefaultPlugins, SpectatorPlugin))
35 |         .add_systems(Startup, setup)
36 |         .run();
37 | }
38 | 
39 | fn setup(mut commands: Commands) {
40 |     commands.spawn((
41 |         Camera3d::default(), Spectator
42 |     ));
43 | }
44 | ```
45 | 
46 | ## Bevy compatibility
47 | 
48 | | bevy | bevy_spectator |
49 | |------|----------------|
50 | | 0.16 | 0.8            |
51 | | 0.15 | 0.7            |
52 | | 0.14 | 0.6            |
53 | | 0.13 | 0.5            |
54 | | 0.12 | 0.4            |
55 | | 0.11 | 0.3            |
56 | | 0.10 | 0.2            |
57 | | 0.9  | 0.1            |
58 | 


--------------------------------------------------------------------------------
/src/lib.rs:
--------------------------------------------------------------------------------
  1 | #![doc = include_str!("../README.md")]
  2 | 
  3 | use bevy::{
  4 |     input::mouse::MouseMotion,
  5 |     log::{error, warn},
  6 |     prelude::*,
  7 |     window::{CursorGrabMode, PrimaryWindow},
  8 | };
  9 | 
 10 | /// A marker `Component` for spectating cameras.
 11 | ///
 12 | /// ## Usage
 13 | /// With the `init` feature:
 14 | /// - Add it to a single entity to mark it as a spectator.
 15 | /// - `init` will then find that entity and mark it as the active spectator in [`SpectatorSettings`].
 16 | ///
 17 | /// (If there isn't a single [`Spectator`] (none or multiple, instead of one), there won't be an active spectator selected by the `init` feature.)
 18 | ///
 19 | /// Without the `init` feature:
 20 | /// - Add it to entities to mark spectators.
 21 | /// - Manually alter [`SpectatorSettings`] to set the active spectator.
 22 | #[derive(Component)]
 23 | pub struct Spectator;
 24 | 
 25 | /// A `Plugin` for spectating your scene.
 26 | pub struct SpectatorPlugin;
 27 | 
 28 | impl Plugin for SpectatorPlugin {
 29 |     fn build(&self, app: &mut App) {
 30 |         app.init_resource::<SpectatorSettings>();
 31 | 
 32 |         #[cfg(feature = "init")]
 33 |         app.add_systems(PostStartup, spectator_init);
 34 | 
 35 |         app.add_systems(Update, spectator_update);
 36 |     }
 37 | }
 38 | 
 39 | #[cfg(feature = "init")]
 40 | fn spectator_init(
 41 |     cameras: Query<Entity, With<Spectator>>,
 42 |     mut settings: ResMut<SpectatorSettings>,
 43 | ) {
 44 |     use bevy::ecs::query::QuerySingleError;
 45 | 
 46 |     if settings.active_spectator.is_none() {
 47 |         settings.active_spectator = match cameras.single() {
 48 |             Ok(a) => Some(a),
 49 |             Err(QuerySingleError::NoEntities(_)) => {
 50 |                 warn!("Failed to find a Spectator; Active camera will remain unset.");
 51 |                 None
 52 |             }
 53 |             Err(QuerySingleError::MultipleEntities(_)) => {
 54 |                 warn!("Found more than one Spectator; Active camera will remain unset.");
 55 |                 None
 56 |             }
 57 |         };
 58 |     }
 59 | }
 60 | 
 61 | #[allow(clippy::too_many_arguments)]
 62 | fn spectator_update(
 63 |     time: Res<Time>,
 64 |     keys: Res<ButtonInput<KeyCode>>,
 65 |     buttons: Res<ButtonInput<MouseButton>>,
 66 |     mut motion: EventReader<MouseMotion>,
 67 |     mut settings: ResMut<SpectatorSettings>,
 68 |     mut windows: Query<(&mut Window, Option<&PrimaryWindow>)>,
 69 |     mut camera_transforms: Query<&mut Transform, With<Spectator>>,
 70 |     mut focus: Local<bool>,
 71 | ) {
 72 |     let Some(camera_id) = settings.active_spectator else {
 73 |         motion.clear();
 74 |         return;
 75 |     };
 76 | 
 77 |     let Ok(mut camera_transform) = camera_transforms.get_mut(camera_id) else {
 78 |         error!("Failed to find camera for active camera entity ({camera_id:?})");
 79 |         settings.active_spectator = None;
 80 |         motion.clear();
 81 |         return;
 82 |     };
 83 | 
 84 |     let mut window = match settings.active_window {
 85 |         Some(active) => {
 86 |             let Ok((window, _)) = windows.get_mut(active) else {
 87 |                 error!("Failed to find active window ({active:?})");
 88 |                 settings.active_window = None;
 89 |                 motion.clear();
 90 |                 return;
 91 |             };
 92 | 
 93 |             window
 94 |         }
 95 |         None => {
 96 |             let Some((window, _)) = windows.iter_mut().find(|(_, primary)| primary.is_some())
 97 |             else {
 98 |                 panic!("No primary window found!");
 99 |             };
100 | 
101 |             window
102 |         }
103 |     };
104 | 
105 |     let mut set_focus = |focused: bool| {
106 |         *focus = focused;
107 |         if !settings.orthographic {
108 |             let grab_mode = match focused {
109 |                 true => CursorGrabMode::Confined,
110 |                 false => CursorGrabMode::None,
111 |             };
112 |             window.cursor_options.grab_mode = grab_mode;
113 |             window.cursor_options.visible = !focused;
114 |         }
115 |     };
116 | 
117 |     if keys.just_pressed(KeyCode::Escape) {
118 |         set_focus(false);
119 |     } else if buttons.just_pressed(MouseButton::Left) {
120 |         set_focus(true);
121 |     }
122 | 
123 |     // When in orthographic mode, mouse capturing is disabled. Movement should therefore always be enabled.
124 |     if *focus || settings.orthographic {
125 |         // rotation
126 |         if !settings.orthographic {
127 |             let mouse_delta = {
128 |                 let mut total = Vec2::ZERO;
129 |                 for d in motion.read() {
130 |                     total += d.delta;
131 |                 }
132 |                 total
133 |             };
134 | 
135 |             let mouse_x = -mouse_delta.x * settings.sensitivity;
136 |             let mouse_y = -mouse_delta.y * settings.sensitivity;
137 | 
138 |             let mut dof: Vec3 = camera_transform.rotation.to_euler(EulerRot::YXZ).into();
139 | 
140 |             dof.x += mouse_x;
141 |             // At 90 degrees, yaw gets misinterpreted as roll. Making 89 the limit fixes that.
142 |             dof.y = (dof.y + mouse_y).clamp(-89f32.to_radians(), 89f32.to_radians());
143 |             dof.z = 0f32;
144 | 
145 |             camera_transform.rotation = Quat::from_euler(EulerRot::YXZ, dof.x, dof.y, dof.z);
146 |         }
147 | 
148 |         // translation
149 |         {
150 |             let forward = if keys.pressed(KeyCode::KeyW) {
151 |                 1f32
152 |             } else {
153 |                 0f32
154 |             };
155 | 
156 |             let backward = if keys.pressed(KeyCode::KeyS) {
157 |                 1f32
158 |             } else {
159 |                 0f32
160 |             };
161 | 
162 |             let right = if keys.pressed(KeyCode::KeyD) {
163 |                 1f32
164 |             } else {
165 |                 0f32
166 |             };
167 | 
168 |             let left = if keys.pressed(KeyCode::KeyA) {
169 |                 1f32
170 |             } else {
171 |                 0f32
172 |             };
173 | 
174 |             let up_cond = if !settings.orthographic {
175 |                 keys.pressed(KeyCode::Space)
176 |             } else {
177 |                 keys.pressed(KeyCode::KeyW)
178 |             };
179 |             let up = if up_cond { 1f32 } else { 0f32 };
180 | 
181 |             let down_cond = if !settings.orthographic {
182 |                 keys.pressed(KeyCode::ControlLeft)
183 |             } else {
184 |                 keys.pressed(KeyCode::KeyS)
185 |             };
186 |             let down = if down_cond { 1f32 } else { 0f32 };
187 | 
188 |             let speed = if keys.pressed(KeyCode::ShiftLeft) {
189 |                 settings.alt_speed
190 |             } else {
191 |                 settings.base_speed
192 |             };
193 | 
194 |             let delta_axial = if settings.orthographic {
195 |                 0.0
196 |             } else {
197 |                 (forward - backward) * speed
198 |             };
199 |             let delta_lateral = (right - left) * speed;
200 |             let delta_vertical = (up - down) * speed;
201 | 
202 |             let mut forward = *camera_transform.forward();
203 |             forward.y = 0f32;
204 |             forward = forward.normalize_or_zero(); // fly fast even when look down/up
205 | 
206 |             let mut right = *camera_transform.right();
207 |             right.y = 0f32; // more of a sanity check
208 |             let up = Vec3::Y;
209 | 
210 |             let result = forward * delta_axial + right * delta_lateral + up * delta_vertical;
211 | 
212 |             camera_transform.translation += result * time.delta_secs();
213 |         }
214 |     }
215 | 
216 |     motion.clear();
217 | }
218 | 
219 | /// A `Resource` for controlling [`Spectator`]s.
220 | #[derive(Resource)]
221 | pub struct SpectatorSettings {
222 |     /// The `Entity` of the active [`Spectator`]. (Default: `None`)
223 |     ///
224 |     /// Use this to control which [`Spectator`] you are using.
225 |     ///
226 |     /// If the `init` feature is enabled, `None` will update to a single, marked camera.
227 |     ///
228 |     /// Setting to `None` will disable the spectator mode.
229 |     pub active_spectator: Option<Entity>,
230 |     /// The `Entity` of the active `Window`. (Default: `None`)
231 |     ///
232 |     /// Use this to control which `Window` will grab your mouse/hide the cursor.
233 |     ///
234 |     /// If `None`, the primary window will be used.
235 |     pub active_window: Option<Entity>,
236 |     /// The base speed of the active [`Spectator`]. (Default: `10.0`)
237 |     ///
238 |     /// Use this to control how fast the [`Spectator`] normally moves.
239 |     pub base_speed: f32,
240 |     /// The alternate speed of the active [`Spectator`]. (Default: `50.0`)
241 |     ///
242 |     /// Use this to control how fast the [`Spectator`] moves when you hold `Shift`.
243 |     pub alt_speed: f32,
244 |     /// The camera sensitivity of the active [`Spectator`]. (Default: `0.001`)
245 |     ///
246 |     /// Use this to control how fast the [`Spectator`] turns when you move the mouse.
247 |     pub sensitivity: f32,
248 |     /// Use a control scheme more fit for orthographic (2D) rendering
249 |     ///
250 |     /// Disables mouse capturing and hiding, prevents moving along z-axis and uses W and S for y-axis movement
251 |     pub orthographic: bool,
252 | }
253 | 
254 | impl Default for SpectatorSettings {
255 |     fn default() -> Self {
256 |         Self {
257 |             active_spectator: None,
258 |             active_window: None,
259 |             base_speed: 10.0,
260 |             alt_speed: 50.0,
261 |             sensitivity: 0.001,
262 |             orthographic: false,
263 |         }
264 |     }
265 | }
266 | 


--------------------------------------------------------------------------------
/LICENSE-APACHE:
--------------------------------------------------------------------------------
  1 |                                  Apache License
  2 |                            Version 2.0, January 2004
  3 |                         http://www.apache.org/licenses/
  4 | 
  5 |    TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
  6 | 
  7 |    1. Definitions.
  8 | 
  9 |       "License" shall mean the terms and conditions for use, reproduction,
 10 |       and distribution as defined by Sections 1 through 9 of this document.
 11 | 
 12 |       "Licensor" shall mean the copyright owner or entity authorized by
 13 |       the copyright owner that is granting the License.
 14 | 
 15 |       "Legal Entity" shall mean the union of the acting entity and all
 16 |       other entities that control, are controlled by, or are under common
 17 |       control with that entity. For the purposes of this definition,
 18 |       "control" means (i) the power, direct or indirect, to cause the
 19 |       direction or management of such entity, whether by contract or
 20 |       otherwise, or (ii) ownership of fifty percent (50%) or more of the
 21 |       outstanding shares, or (iii) beneficial ownership of such entity.
 22 | 
 23 |       "You" (or "Your") shall mean an individual or Legal Entity
 24 |       exercising permissions granted by this License.
 25 | 
 26 |       "Source" form shall mean the preferred form for making modifications,
 27 |       including but not limited to software source code, documentation
 28 |       source, and configuration files.
 29 | 
 30 |       "Object" form shall mean any form resulting from mechanical
 31 |       transformation or translation of a Source form, including but
 32 |       not limited to compiled object code, generated documentation,
 33 |       and conversions to other media types.
 34 | 
 35 |       "Work" shall mean the work of authorship, whether in Source or
 36 |       Object form, made available under the License, as indicated by a
 37 |       copyright notice that is included in or attached to the work
 38 |       (an example is provided in the Appendix below).
 39 | 
 40 |       "Derivative Works" shall mean any work, whether in Source or Object
 41 |       form, that is based on (or derived from) the Work and for which the
 42 |       editorial revisions, annotations, elaborations, or other modifications
 43 |       represent, as a whole, an original work of authorship. For the purposes
 44 |       of this License, Derivative Works shall not include works that remain
 45 |       separable from, or merely link (or bind by name) to the interfaces of,
 46 |       the Work and Derivative Works thereof.
 47 | 
 48 |       "Contribution" shall mean any work of authorship, including
 49 |       the original version of the Work and any modifications or additions
 50 |       to that Work or Derivative Works thereof, that is intentionally
 51 |       submitted to Licensor for inclusion in the Work by the copyright owner
 52 |       or by an individual or Legal Entity authorized to submit on behalf of
 53 |       the copyright owner. For the purposes of this definition, "submitted"
 54 |       means any form of electronic, verbal, or written communication sent
 55 |       to the Licensor or its representatives, including but not limited to
 56 |       communication on electronic mailing lists, source code control systems,
 57 |       and issue tracking systems that are managed by, or on behalf of, the
 58 |       Licensor for the purpose of discussing and improving the Work, but
 59 |       excluding communication that is conspicuously marked or otherwise
 60 |       designated in writing by the copyright owner as "Not a Contribution."
 61 | 
 62 |       "Contributor" shall mean Licensor and any individual or Legal Entity
 63 |       on behalf of whom a Contribution has been received by Licensor and
 64 |       subsequently incorporated within the Work.
 65 | 
 66 |    2. Grant of Copyright License. Subject to the terms and conditions of
 67 |       this License, each Contributor hereby grants to You a perpetual,
 68 |       worldwide, non-exclusive, no-charge, royalty-free, irrevocable
 69 |       copyright license to reproduce, prepare Derivative Works of,
 70 |       publicly display, publicly perform, sublicense, and distribute the
 71 |       Work and such Derivative Works in Source or Object form.
 72 | 
 73 |    3. Grant of Patent License. Subject to the terms and conditions of
 74 |       this License, each Contributor hereby grants to You a perpetual,
 75 |       worldwide, non-exclusive, no-charge, royalty-free, irrevocable
 76 |       (except as stated in this section) patent license to make, have made,
 77 |       use, offer to sell, sell, import, and otherwise transfer the Work,
 78 |       where such license applies only to those patent claims licensable
 79 |       by such Contributor that are necessarily infringed by their
 80 |       Contribution(s) alone or by combination of their Contribution(s)
 81 |       with the Work to which such Contribution(s) was submitted. If You
 82 |       institute patent litigation against any entity (including a
 83 |       cross-claim or counterclaim in a lawsuit) alleging that the Work
 84 |       or a Contribution incorporated within the Work constitutes direct
 85 |       or contributory patent infringement, then any patent licenses
 86 |       granted to You under this License for that Work shall terminate
 87 |       as of the date such litigation is filed.
 88 | 
 89 |    4. Redistribution. You may reproduce and distribute copies of the
 90 |       Work or Derivative Works thereof in any medium, with or without
 91 |       modifications, and in Source or Object form, provided that You
 92 |       meet the following conditions:
 93 | 
 94 |       (a) You must give any other recipients of the Work or
 95 |           Derivative Works a copy of this License; and
 96 | 
 97 |       (b) You must cause any modified files to carry prominent notices
 98 |           stating that You changed the files; and
 99 | 
100 |       (c) You must retain, in the Source form of any Derivative Works
101 |           that You distribute, all copyright, patent, trademark, and
102 |           attribution notices from the Source form of the Work,
103 |           excluding those notices that do not pertain to any part of
104 |           the Derivative Works; and
105 | 
106 |       (d) If the Work includes a "NOTICE" text file as part of its
107 |           distribution, then any Derivative Works that You distribute must
108 |           include a readable copy of the attribution notices contained
109 |           within such NOTICE file, excluding those notices that do not
110 |           pertain to any part of the Derivative Works, in at least one
111 |           of the following places: within a NOTICE text file distributed
112 |           as part of the Derivative Works; within the Source form or
113 |           documentation, if provided along with the Derivative Works; or,
114 |           within a display generated by the Derivative Works, if and
115 |           wherever such third-party notices normally appear. The contents
116 |           of the NOTICE file are for informational purposes only and
117 |           do not modify the License. You may add Your own attribution
118 |           notices within Derivative Works that You distribute, alongside
119 |           or as an addendum to the NOTICE text from the Work, provided
120 |           that such additional attribution notices cannot be construed
121 |           as modifying the License.
122 | 
123 |       You may add Your own copyright statement to Your modifications and
124 |       may provide additional or different license terms and conditions
125 |       for use, reproduction, or distribution of Your modifications, or
126 |       for any such Derivative Works as a whole, provided Your use,
127 |       reproduction, and distribution of the Work otherwise complies with
128 |       the conditions stated in this License.
129 | 
130 |    5. Submission of Contributions. Unless You explicitly state otherwise,
131 |       any Contribution intentionally submitted for inclusion in the Work
132 |       by You to the Licensor shall be under the terms and conditions of
133 |       this License, without any additional terms or conditions.
134 |       Notwithstanding the above, nothing herein shall supersede or modify
135 |       the terms of any separate license agreement you may have executed
136 |       with Licensor regarding such Contributions.
137 | 
138 |    6. Trademarks. This License does not grant permission to use the trade
139 |       names, trademarks, service marks, or product names of the Licensor,
140 |       except as required for reasonable and customary use in describing the
141 |       origin of the Work and reproducing the content of the NOTICE file.
142 | 
143 |    7. Disclaimer of Warranty. Unless required by applicable law or
144 |       agreed to in writing, Licensor provides the Work (and each
145 |       Contributor provides its Contributions) on an "AS IS" BASIS,
146 |       WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147 |       implied, including, without limitation, any warranties or conditions
148 |       of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149 |       PARTICULAR PURPOSE. You are solely responsible for determining the
150 |       appropriateness of using or redistributing the Work and assume any
151 |       risks associated with Your exercise of permissions under this License.
152 | 
153 |    8. Limitation of Liability. In no event and under no legal theory,
154 |       whether in tort (including negligence), contract, or otherwise,
155 |       unless required by applicable law (such as deliberate and grossly
156 |       negligent acts) or agreed to in writing, shall any Contributor be
157 |       liable to You for damages, including any direct, indirect, special,
158 |       incidental, or consequential damages of any character arising as a
159 |       result of this License or out of the use or inability to use the
160 |       Work (including but not limited to damages for loss of goodwill,
161 |       work stoppage, computer failure or malfunction, or any and all
162 |       other commercial damages or losses), even if such Contributor
163 |       has been advised of the possibility of such damages.
164 | 
165 |    9. Accepting Warranty or Additional Liability. While redistributing
166 |       the Work or Derivative Works thereof, You may choose to offer,
167 |       and charge a fee for, acceptance of support, warranty, indemnity,
168 |       or other liability obligations and/or rights consistent with this
169 |       License. However, in accepting such obligations, You may act only
170 |       on Your own behalf and on Your sole responsibility, not on behalf
171 |       of any other Contributor, and only if You agree to indemnify,
172 |       defend, and hold each Contributor harmless for any liability
173 |       incurred by, or claims asserted against, such Contributor by reason
174 |       of your accepting any such warranty or additional liability.
175 | 
176 |    END OF TERMS AND CONDITIONS
177 | 


--------------------------------------------------------------------------------