Window (vuo.window)

Nodes for working with the graphics windows displayed by a composition — changing their size, position, and other properties, and getting information about them.

Nodes in other node sets — Render Image to Window, Render Layers to Window, and Render Scene to Window — can display a window in a composition. Each of those nodes has two ports that are important to the vuo.window node set:

Window description

A window description is a group of settings that specify the appearance of a window or the way that a user can interact with it. For example, the “title” setting specifies the text displayed in the window’s title bar. The “resizable” setting decides whether the window should change size when the user drags the window’s corner.

You can chain multiple vuo.window nodes together, connecting the Changed Window Description output port of one to the Set Window Description input port of the next, to build a window description with multiple settings.

You can feed a window description into the Set Window Description input port of a Render Scene/Layers/Image to Window node.

Parts of a window

A window is divided into the content area and the title bar, as illustrated below. When the window is fullscreen, the title bar is hidden. Many nodes in this node set work specifically with the content area, for example changing its size or aspect ratio.

Parts of a window

Windows and screens

The Get Window Screen node outputs the current screen a window appears on, and the Change Window Screen node moves it to another screen or toggles its fullscreen status.

You can use the Get Screen Values node to examine the properties of a screen.

Example compositions: