[][src]Crate nannou

An open-source creative-coding toolkit for Rust.

Nannou is a collection of code aimed at making it easy for artists to express themselves with simple, fast, reliable, portable code. Whether working on a 12-month laser installation or a 5 minute sketch, this framework aims to give artists easy access to the tools they need.

If you're new to nannou, we recommend checking out the examples to get an idea of how nannou applications are structured and how the API works.

Re-exports

pub use conrod_core;
pub use conrod_vulkano;
pub use conrod_winit;
pub use daggy;
pub use find_folder;
pub use vulkano;
pub use vulkano_shaders;
pub use vulkano_win;
pub use winit;
pub use self::event::Event;
pub use self::frame::Frame;
pub use self::ui::Ui;
pub use crate::app::App;
pub use crate::app::LoopMode;
pub use crate::draw::Draw;

Modules

app

Items related to the App type and the application context in general.

audio

The nannou audio API and implementation.

color

Color items, including everything from rgb, hsb/l/v, lap, alpha, luma and more, provided by the palette crate. See the palette docs for more details or see the named module for a set of provided color constants.

draw

A simple API for drawing 2D and 3D graphics. See the Draw type for more details.

ease

A suite of common interpolation functions often referred to as "easing" and "tweening" functions. This API is provided by the pennereq crate.

event

Application, event loop and window event definitions and implementations.

frame

Items related to the Frame type, describing a single frame of graphics for a single window.

geom

Types, functions and other items related to geometry. This module is the source of all graphics and lazer primitives and aids work in 2D and 3D space.

image

Items related to working with images. Currently, this module simply re-exports the renown image crate which supports reading and writing PNG, JPEG, GIF, WEBP, BMP and more.

io

An extension of the std::io module. Includes functions for safely saving and loading files from any serializable types, along with functions specifically for working with JSON and TOML.

math

A mathematical foundation for nannou including point and vector types and a range of helper/utility functions.

mesh

An API for composing Meshs. Meshs may be composed of different sets of channels including position, color, texture-coordinate and normals. Note that this is quite a low-level representation. For a higher-level, graphics-related mesh API, see the draw module.

noise

Items related to noise generation, API offered via the noise-rs crate.

osc

Tools for working with OSC. sender() creates an OSC sender, receiver(port) creates an OSC receiver.

prelude

A collection of commonly used items that we recommend importing for ease of use.

rand

Items related to randomness and random number generators. Also provides some high-level helper functions including random_f32(), random_f64() and random_range(min, max).

state

Small tracked parts of the application state. Includes window, keys, mouse, time - each of which are stored in the App.

time

Extensions and utilities for working with time.

ui

The User Interface API. Instantiate a Ui via app.new_ui().

vk

Items related to Vulkan and the Rust API used by Nannou called Vulkano.

window

The nannou Window API. Create a new window via .app.new_window(). This produces a Builder which can be used to build a window.

Functions

app

Begin building the App.

sketch

Shorthand for building a simple app that has no model, handles no events and simply draws to a single window.