<!DOCTYPE html><htmllang="en"><head><metacharset="utf-8"><metaname="viewport"content="width=device-width, initial-scale=1.0"><metaname="generator"content="rustdoc"><metaname="description"content="A widgetry application splits its state into two pieces: global shared state that lasts for the entire lifetime of the application, and a stack of smaller states, only one of which is active at a time. For example, imagine an application to view a map. The shared state would include the map and pre-rendered geometry for it. The individual states might start with a splash screen or menu to choose a map, then a map viewer, then maybe a state to drill down into pieces of the map."><metaname="keywords"content="rust, rustlang, rust-lang, app_state"><title>widgetry::app_state - Rust</title><linkrel="stylesheet"type="text/css"href="../../normalize.css"><linkrel="stylesheet"type="text/css"href="../../rustdoc.css"id="mainThemeStyle"><linkrel="stylesheet"type="text/css"href="../../light.css"id="themeStyle"><linkrel="stylesheet"type="text/css"href="../../dark.css"disabled><linkrel="stylesheet"type="text/css"href="../../ayu.css"disabled><scriptid="default-settings"></script><scriptsrc="../../storage.js"></script><scriptsrc="../../crates.js"></script><noscript><linkrel="stylesheet"href="../../noscript.css"></noscript><linkrel="alternate icon"type="image/png"href="../../favicon-16x16.png"><linkrel="alternate icon"type="image/png"href="../../favicon-32x32.png"><linkrel="icon"type="image/svg+xml"href="../../favicon.svg"><styletype="text/css">#crate-search{background-image:url("../../down-arrow.svg");}</style></head><bodyclass="rustdoc mod"><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><navclass="sidebar"><divclass="sidebar-menu"role="button">☰</div><ahref='../../widgetry/index.html'><divclass='logo-container rust-logo'><imgsrc='../../rust-logo.png'alt='logo'></div></a><h2class="location">Module app_state</h2><divclass="sidebar-elems"><divclass="block items"><ul><li><ahref="#structs">Structs</a></li><li><ahref="#enums">Enums</a></li><li><ahref="#traits">Traits</a></li></ul></div><divid="sidebar-vars"data-name="app_state"data-ty="mod"data-relpath="./"></div><scriptdefersrc="./sidebar-items.js"></script></div></nav><divclass="theme-picker"><buttonid="theme-picker"aria-label="Pick another theme!"aria-haspopup="menu"title="themes"><imgwidth="18"height="18"alt="Pick another theme!"src="../../brush.svg"></button><divid="theme-choices"role="menu"></div></div><navclass="sub"><formclass="search-form"><divclass="search-container"><div><selectid="crate-search"><optionvalue="All crates">All crates</option></select><inputclass="search-input"name="search"disabledautocomplete="off"spellcheck="false"placeholder="Click or press ‘S’ to search, ‘?’ for more options…"type="search"></div><buttontype="button"id="help-button"title="help">?</button><aid="settings-menu"href="../../settings.html"title="settings"><imgwidth="18"height="18"alt="Change settings"src="../../wheel.svg"></a></div></form></nav><sectionid="main"class="content"><h1class="fqn"><spanclass="in-band">Module <ahref="../index.html">widgetry</a>::<wbr><aclass="mod"href="#">app_state</a><buttonid="copy-path"onclick="copy_path(this)"title="Copy item path to clipboard"><imgsrc="../../clipboard.svg"width="19"height="18"alt="Copy item path"></button></span><spanclass="out-of-band"><spanid="render-detail"><aid="toggle-all-docs"href="javascript:void(0)"title="collapse all docs">[<spanclass="inner">−</span>]</a></span><aclass="srclink"href="../../src/widgetry/app_state.rs.html#1-299"title="goto source code">[src]</a></span></h1><detailsclass="rustdoc-toggle top-doc"open><summaryclass="hideme"><span>Expand description</span></summary><divclass="docblock"><p>A widgetry application splits its state into two pieces: global shared state that lasts for the
<divclass="item-table"><divclass="item-row"><divclass="item-left module-item"><aclass="enum"href="enum.DrawBaselayer.html"title="widgetry::app_state::DrawBaselayer enum">DrawBaselayer</a></div><divclass="item-right docblock-short"><p>Before <code>State::draw</code> is called, draw something else.</p>
</div></div><divclass="item-row"><divclass="item-left module-item"><aclass="enum"href="enum.Transition.html"title="widgetry::app_state::Transition enum">Transition</a></div><divclass="item-right docblock-short"><p>When a state responds to an event, it can specify some way to manipulate the stack of states.</p>
<divclass="item-table"><divclass="item-row"><divclass="item-left module-item"><aclass="trait"href="trait.SharedAppState.html"title="widgetry::app_state::SharedAppState trait">SharedAppState</a></div><divclass="item-right docblock-short"><p>Any data that should last the entire lifetime of the application should be stored in the struct
</div></div><divclass="item-row"><divclass="item-left module-item"><aclass="trait"href="trait.SimpleState.html"title="widgetry::app_state::SimpleState trait">SimpleState</a></div><divclass="item-right docblock-short"><p>Many states fit a pattern of managing a single panel, handling mouseover events, and other
</div></div><divclass="item-row"><divclass="item-left module-item"><aclass="trait"href="trait.State.html"title="widgetry::app_state::State trait">State</a></div><divclass="item-right docblock-short"><p>A temporary state of an application. There’s a stack of these, with the most recent being the
