VuoScreenCommon.h File Reference

Description

VuoScreenCommon interface.

Copyright

Copyright © 2012–2021 Kosada Incorporated. This code may be modified and distributed under the terms of the MIT License. For more information, see https://vuo.org/license.

Definition in file VuoScreenCommon.h.

Go to the source code of this file.

Functions
void *	VuoScreen_getNSScreen (VuoScreen screen)
	Returns a platform screen (NSScreen) matching screen. More...
VuoScreen	VuoScreen_makeFromNSScreen (void *screen)
	Fills in a VuoScreen structure describing an NSScreen. More...
VuoList_VuoScreen	VuoScreen_getList (void)
	Returns a list of the currently-active screens. More...
VuoScreen	VuoScreen_getActive (void)
	Returns the screen with the window that has keyboard focus. More...
VuoScreen	VuoScreen_getPrimary (void)
	Returns the primary screen. More...
VuoScreen	VuoScreen_getSecondary (void)
	Returns a secondary (non-primary) screen if present, or a null screen otherwise. More...
void	VuoScreen_use (void)
	Indicates that the caller needs to get notifications about screens. More...
void	VuoScreen_disuse (void)
	Indicates that the caller no longer needs notifications about screens. More...
void	VuoScreen_addDevicesChangedTriggers (VuoOutputTrigger(screens, VuoList_VuoScreen))
	Adds a trigger callback, to be invoked whenever the list of known screens changes. More...
void	VuoScreen_removeDevicesChangedTriggers (VuoOutputTrigger(screens, VuoList_VuoScreen))
	Removes a trigger callback previously added by VuoScreen_addDevicesChangedTriggers. More...

Function Documentation

VuoScreen_addDevicesChangedTriggers()

void VuoScreen_addDevicesChangedTriggers

(

VuoOutputTrigger(screens, VuoList_VuoScreen)

)

Adds a trigger callback, to be invoked whenever the list of known screens changes.

Call VuoScreen_use() before calling this.

This function may be called from any thread.

Changed in Vuo 2.0.0:

New.

Definition at line 364 of file VuoScreenCommon.mm.

VuoScreen_disuse()

void VuoScreen_disuse

(

void

)

Indicates that the caller no longer needs notifications about screens.

This function may be called from any thread.

Changed in Vuo 2.0.0:

New.

Definition at line 344 of file VuoScreenCommon.mm.

VuoScreen_getActive()

VuoScreen VuoScreen_getActive

(

void

)

Returns the screen with the window that has keyboard focus.

Definition at line 226 of file VuoScreenCommon.mm.

VuoScreen_getList()

VuoList_VuoScreen VuoScreen_getList

(

void

)

Returns a list of the currently-active screens.

Definition at line 200 of file VuoScreenCommon.mm.

VuoScreen_getNSScreen()

void* VuoScreen_getNSScreen

(

VuoScreen

screen

)

Returns a platform screen (NSScreen) matching screen.

Definition at line 142 of file VuoScreenCommon.mm.

VuoScreen_getPrimary()

VuoScreen VuoScreen_getPrimary

(

void

)

Returns the primary screen.

(In System Preferences > Displays > Arrangement, the primary screen is the one with the menu bar.)

Definition at line 240 of file VuoScreenCommon.mm.

VuoScreen_getSecondary()

VuoScreen VuoScreen_getSecondary

(

void

)

Returns a secondary (non-primary) screen if present, or a null screen otherwise.

Changed in Vuo 2.0.0:

Now returns a null screen if there is no secondary screen (instead of returning the primary screen.

Definition at line 250 of file VuoScreenCommon.mm.

VuoScreen_makeFromNSScreen()

VuoScreen VuoScreen_makeFromNSScreen

(

void *

screen

)

Fills in a VuoScreen structure describing an NSScreen.

Definition at line 191 of file VuoScreenCommon.mm.

VuoScreen_removeDevicesChangedTriggers()

void VuoScreen_removeDevicesChangedTriggers

(

VuoOutputTrigger(screens, VuoList_VuoScreen)

)

Removes a trigger callback previously added by VuoScreen_addDevicesChangedTriggers.

This function may be called from any thread.

Changed in Vuo 2.0.0:

New.

Definition at line 376 of file VuoScreenCommon.mm.

VuoScreen_use()

void VuoScreen_use

(

void

)

Indicates that the caller needs to get notifications about screens.

This function may be called from any thread.

Changed in Vuo 2.0.0:

New.

Definition at line 327 of file VuoScreenCommon.mm.