score Namespace Reference

Base toolkit upon which the software is built. More...

Detailed Description

Base toolkit upon which the software is built.

TODO. list in src/plugins/score-plugin-avnd/Crousti/Concepts.hpp#L139.

This namespace contains only non-domain specific classes and utilities : serialization, model-view, documents, etc.

It is split in two folders :

• core is the internal mechanic to set-up the software : the actual widget classes, the plug-in loading code, etc.
• score is the "public" part of the score API : this code can be used by plug-ins.

This file contains facilities to serialize an object into a QJsonObject.

This file contains base types for the events and transitions of the state machines in score.

See the documentation for explanation of the general pattern

Namespaces
namespace	gfx
	Graphics rendering pipeline for ossia score.

Classes
class	AboutDialog
class	Action
	The Action class. More...
struct	ActionCondition
	The ActionCondition struct. More...
struct	ActionContainer
	The ActionContainer struct. More...
class	ActionGroup
	The ActionGroup class A semantic group of actions : for instance, all the actions related to audio recording, etc. This is to be used for documentation purposes, for instance on a potential keyboard shortcut widget. More...
class	ActionManager
	The ActionManager class. More...
struct	Addon
	The Addon struct. More...
class	AddRemoveList
class	AggregateCommand
	Allows for grouping of multiple commands in a single one. More...
struct	any_serializer
struct	any_serializer_t
class	ApplicationComponents
struct	ApplicationComponentsData
struct	ApplicationContext
	Used to access all the application-wide state and structures. More...
class	ApplicationInterface
	The ApplicationInterface class. More...
class	ApplicationPlugin
class	ApplicationPlugin_QtInterface
class	ApplicationRegistrar
	Registers the plug-in elements. More...
struct	ApplicationServices
struct	ApplicationSettings
	Load-time settings. More...
class	ArrowButton
class	ArrowDialog
class	BackgroundItem
struct	BarSpinBox
class	BottomToolbarWidget
struct	Brush
struct	BrushSet
class	ColorBang
struct	ColorRef
	A reference to a color. Used for skinning. More...
class	ComboBox
struct	ComboSlider
class	Command
	The Command class. More...
class	CommandBackupFile
	Abstraction over the backup of commands. More...
struct	CommandData
	Utility class for the serialization and deserialization of commands. More...
class	CommandFactory_QtInterface
struct	CommandKeyHash
struct	CommandSpinbox
	CommandSpinbox Will update a value of the model according to the spinbox. More...
class	CommandStack
struct	CommandStackBackup
	Serialized command stack data for backup / restore. More...
class	CommandStackFacade
	A small abstraction layer over the score::CommandStack. More...
struct	CommandStore
class	Component
	A component adds custom data to an Entity. More...
class	ComponentHierarchyManager
	Manages simple hierarchies of components. More...
struct	Components
class	CoreApplicationPlugin
	Base actions for the score software. More...
struct	CustomActionCondition
	The CustomActionCondition struct. More...
struct	DefaultComboImpl
struct	DefaultControlImpl
class	DefaultedGenericComponentFactoryList
struct	DefaultGraphicsKnobImpl
struct	DefaultGraphicsSliderImpl
struct	DefaultGraphicsSpinboxImpl
struct	delete_later
struct	Dispatcher
struct	Dispatcher_T
class	Document
	The Document class is the central part of the software. More...
struct	DocumentActionCondition
	The DocumentActionCondition struct. More...
class	DocumentBackupManager
	Handles document backup to allow restoring if there is a crash. More...
struct	DocumentBackups
	Manages the list of documents that can be restored after a crash. More...
class	DocumentBuilder
	Methods to set-up documents. More...
struct	DocumentContext
class	DocumentDelegateFactory
	Used to provide custom document types. More...
class	DocumentDelegateList
class	DocumentDelegateModel
class	DocumentDelegatePresenter
class	DocumentDelegateView
struct	DocumentList
class	DocumentManager
	Owns the documents. More...
struct	DocumentMetadata
	Document-wide metadata. More...
class	DocumentModel
	Model part of a document. More...
class	DocumentPlugin
	Extend a document with custom data and systems. More...
class	DocumentPluginFactory
	Reimplement to instantiate document plug-ins. More...
class	DocumentPluginFactory_T
class	DocumentPluginFactoryList
class	DocumentPresenter
	Interface between the DocumentModel and the DocumentView. More...
class	DocumentValidator
	Checks that a document is valid according to a list of checks to run. More...
class	DocumentView
	The DocumentView class shows a document. More...
class	DoubleSlider
	The DoubleSlider class. More...
struct	DoubleSpinboxWithEnter
struct	DragOverToolButton
class	dynarray_impl
class	dynvector_impl
class	EmptyItem
class	EmptyRectItem
struct	EnableActionIfDocument
	The EnableActionIfDocument struct. More...
class	EnableWhenDocumentIs
class	EnableWhenFocusedObjectIs
class	EnableWhenSelectionContains
class	Entity
	Base for complex model objects. More...
class	EntityList
class	EntityMap
	The EntityMap class. More...
class	EntityMapInserter
class	EntityMapInserter< score::Entity< T >, Ordered >
struct	EventVisitor
class	FactoryInterface_QtInterface
class	FactoryList_QtInterface
class	FileDownloader
struct	FilePath
class	FileWatch
class	FixedTabWidget
struct	FlicksSpinBox
struct	FocusActionCondition
	The FocusActionCondition struct. More...
struct	FocusFacade
struct	FocusManager
class	FormLayout
class	FormWidget
class	GenericComponent
	A component that has a reference to a specific context object. More...
class	GenericComponentFactory
class	GenericComponentFactoryImpl
class	GenericComponentFactoryList
struct	GLCapabilities
class	GraphicsDefaultInletLayout
class	GraphicsDefaultLayout
class	GraphicsDefaultOutletLayout
class	GraphicsGridColumnsLayout
class	GraphicsGridRowsLayout
class	GraphicsHBoxLayout
class	GraphicsIORootLayout
class	GraphicsLayout
class	GraphicsSplitLayout
class	GraphicsTabLayout
class	GraphicsVBoxLayout
struct	GridWidget
struct	GUIApplicationContext
	Specializes ApplicationContext with the QMainWindow. More...
class	GUIApplicationInterface
class	GUIApplicationPlugin
	Used to extend the software with application-wide data. More...
class	GUIApplicationRegistrar
struct	GUIElements
class	HelperPanelDelegate
struct	HierarchicalMember
struct	HierarchicModel
struct	HierarchicModel< Model, Arg >
struct	HierarchicModel< Model, Arg, Args... >
class	HSeparator
class	IconProvider
struct	IdGen
struct	indirect_cast_map_iterator
struct	indirect_iterator
struct	indirect_map_iterator
struct	indirect_ptr_iterator
class	IndirectArray
class	IndirectContainer
class	IndirectContainerWrapper
class	IndirectMap
class	IndirectUnorderedMap
struct	InfiniteScroller
class	InteractiveLabel
class	InterfaceBase
	Base class for plug-in interfaces. More...
class	InterfaceList
	InterfaceList Default implementation of InterfaceListBase. More...
class	InterfaceListBase
	InterfaceListBase Interface to access factories. More...
class	InterfaceListMain
class	IntSlider
class	ItemBounder
struct	lazy_init_t
struct	linear_id_generator
	Generates identifiers for new objects, starting from 1. More...
struct	LoadedPluginVersions
class	LockHelper
	The LockHelper class. More...
struct	LogMessage
class	LogMessagesItemModel
class	MarginLess
	The MarginLess class. More...
class	MatchedTransition
class	MatchingFactory
	Utility class for making a factory interface list. More...
class	MaxRangeSpinBox
	The MaxRangeSpinBox class. More...
class	Menu
	Represents a menu in the software. More...
class	MenuManager
	The MenuManager class. More...
struct	Menus
class	MessagesPanelDelegate
class	MessagesPanelDelegateFactory
struct	MetaAction
class	MinimalApplication
class	MinimalGUIApplication
class	MissingCommandException
	The MissingCommandException class. More...
class	ModelMetadata
	The ModelMetadata class. More...
struct	NumberedEvent
struct	NumberedWithPath_Event
struct	NumStringTables
struct	ObjectEditor
class	ObjectEditorList
class	ObjectLocker
	The ObjectLocker class. More...
struct	OpenDocumentsFile
	File used for crash restore. More...
struct	PaintVisitor
class	PanelDelegate
	The PanelDelegate class. More...
class	PanelDelegateFactory
	Reimplement this interface to register new panels. More...
class	PanelDelegateFactoryList
	All the panels are registered in this interface list. More...
struct	PanelStatus
	The PanelStatus struct. More...
struct	PathInfo
struct	Plugin
class	Plugin_QtInterface
class	PluginWindow
class	PolymorphicComponentHierarchyManager
	Manages polymorphic hierarchies of components. More...
struct	PositionedEvent
struct	PositionedEvent< Scenario::Point >
class	Presenter
	The Presenter class. More...
class	ProjectSettings
class	ProjectSettingsDelegateFactory_T
class	ProjectSettingsFactory
	The ProjectSettingsFactory class. More...
class	ProjectSettingsModel
class	PromptLineEdit
	PromptLineEdit - A QLineEdit with readline-like features. More...
class	PropertyCommand
	The PropertyCommand class. More...
class	PropertyCommand_T
class	QGraphicsButton
class	QGraphicsCheckBox
class	QGraphicsCombo
class	QGraphicsDraggablePixmap
class	QGraphicsEnum
class	QGraphicsHSVChooser
class	QGraphicsIntSlider
class	QGraphicsIntSpinbox
class	QGraphicsIntXYSpinboxChooser
class	QGraphicsKnob
struct	QGraphicsLineEdit
class	QGraphicsLogKnob
class	QGraphicsLogSlider
class	QGraphicsMultiSlider
class	QGraphicsMultiSliderXY
class	QGraphicsNoteChooser
class	QGraphicsPathGeneratorXY
class	QGraphicsPixmapButton
class	QGraphicsPixmapEnum
class	QGraphicsPixmapToggle
class	QGraphicsRangeSlider
class	QGraphicsSelectablePixmapToggle
class	QGraphicsSlider
struct	QGraphicsSliderBase
class	QGraphicsSpinbox
class	QGraphicsTextButton
class	QGraphicsTimeChooser
class	QGraphicsToggle
class	QGraphicsWaveformButton
class	QGraphicsXYChooser
class	QGraphicsXYSpinboxChooser
class	QGraphicsXYZChooser
class	QGraphicsXYZSpinboxChooser
class	QuantificationWidget
struct	random_id_generator
	Generates random identifiers for new objects. More...
class	ReactiveLabel
class	RectItem
class	RectSplitter
class	RectWidget
class	RecursiveWatch
class	ResizeableItem
struct	RestorableDocument
struct	RightClickImpl
class	SearchLineEdit
struct	SecondSpinBox
struct	SelectionActionCondition
	The SelectionActionCondition struct. More...
class	SelectionDispatcher
	The SelectionDispatcher class. More...
class	SelectionStack
	The SelectionStack class. More...
class	SerializableDocumentPlugin
	Document plug-in with serializable data. More...
class	SerializableInterface
	Generic serialization method for abstract classes. More...
class	Settings
	Application-wide user settings registering and handling. More...
class	SettingsCommand
	A Command class that modifies a parameter given its trait class. More...
class	SettingsCommandBase
	Base class for commands to be used with the Settings system. More...
class	SettingsCommandDispatcher
class	SettingsDelegateFactory
	The SettingsDelegateFactory class. More...
class	SettingsDelegateFactory_T
class	SettingsDelegateModel
class	SettingsDelegatePresenter
class	SettingsDelegateView
struct	SettingsParameterMetadata
class	SettingsPresenter
class	SettingsView
class	SimpleTextItem
struct	SizeVisitor
class	Skin
struct	SliderWrapper
struct	SpeedSlider
class	SpinBox
	The SpinBox class. More...
class	SpinBox< double >
class	SpinBox< float >
struct	SpinboxWithEnter
class	StartScreen
struct	StartScreenLink
class	StateAwareTransition
struct	StaticPropertyCommand
struct	StaticPropertyCommand< AvndJit::Model::p_script >
struct	StaticPropertyCommand< Faust::FaustEffectModel::p_script >
struct	StaticPropertyCommand< Gfx::CSF::Model::p_compute >
struct	StaticPropertyCommand< Gfx::Filter::Model::p_program >
struct	StaticPropertyCommand< Gfx::GeometryFilter::Model::p_script >
struct	StaticPropertyCommand< Gfx::VSA::Model::p_vertex >
struct	StaticPropertyCommand< Jit::BytebeatModel::p_script >
struct	StaticPropertyCommand< Jit::JitEffectModel::p_script >
struct	StaticPropertyCommand< JS::ProcessModel::p_script >
struct	StringConstants
class	SubtypeVariant
	Tools to build a variant type from classes in a same hierarchy. More...
class	TaskPool
struct	TemplatedSpinBox
	The TemplatedSpinBox class. More...
struct	TemplatedSpinBox< double >
struct	TemplatedSpinBox< float >
struct	TemplatedSpinBox< int >
class	TextItem
class	ThreadPool
class	TimeSignatureWidget
class	TimeSpinBox
class	TitleBar
struct	ToggleButton
class	Toolbar
class	ToolbarManager
	The ToolbarManager class. More...
struct	TreeViewExpandState
class	UndoApplicationPlugin
	The UndoApplicationPlugin class. More...
class	UndoListWidget
class	UndoPanelDelegate
class	UndoPanelDelegateFactory
class	ValidityChecker
	Implement validation checks on the document. More...
class	ValidityCheckerList
struct	ValueAssigner
struct	ValueAssigner< float >
struct	ValueAssigner< int >
struct	ValueAssigner< ossia::value >
struct	ValueDoubleSlider
struct	ValueLogDoubleSlider
struct	ValueSlider
class	VariantBasedNode
	The VariantBasedNode class. More...
class	Version
	Represents the version of a plug-in. More...
class	View
	The main display of the application. More...
class	VisibilityNotifying
struct	VolumeSlider
class	VSeparator
class	ZoomItem

Typedefs
using	JsonWriter = ossia::json_writer
using	GlobalSettingsPresenter = SettingsDelegatePresenter< SettingsDelegateModel >
using	ActionGroupKey = StringKey< ActionGroup >
using	ActionKey = StringKey< Action >
using	ActionConditionKey = StringKey< score::ActionCondition >
template<typename T1 , typename T2 >
using	enable_if_base_of = std::enable_if< std::is_base_of< T1, T2 >::value, void * >
using	FindCommandKey = std::pair< CommandGroupKey, CommandKey >
using	MaybeDocument = const score::DocumentContext *
template<typename Component >
using	ComponentHierarchy = ComponentHierarchyManager< Component, typename Component::model_t, typename Component::component_t >
template<typename Component , bool HasOwnership = true>
using	PolymorphicComponentHierarchy = PolymorphicComponentHierarchyManager< Component, typename Component::model_t, typename Component::component_t, typename Component::component_factory_list_t, HasOwnership >
template<typename Model >
using	HierarchicalComponents = HierarchicalMember< Model, score::Components, &Model::components >
using	InterfaceKey = UuidKey< InterfaceBase >
using	ProjectSettingsPresenter = SettingsDelegatePresenter< ProjectSettingsModel >
using	ProjectSettingsView = SettingsDelegateView< ProjectSettingsModel >
using	PluginKey = UuidKey< Plugin >
using	SettingsDelegateFactoryList = InterfaceList< score::SettingsDelegateFactory >
template<typename T >
using	sp = SettingsParameterMetadata< T >
using	GlobalSettingsView = SettingsDelegateView< SettingsDelegateModel >
using	uuid_t = uuids::uuid
using	any_map = ossia::any_map
using	any_serializer_map = score::hash_map< std::string, std::unique_ptr< any_serializer > >
using	Press_Event = NumberedEvent< 1 >
using	Move_Event = NumberedEvent< 2 >
using	Release_Event = NumberedEvent< 3 >
using	Cancel_Event = NumberedEvent< 4 >
using	Shift_Event = NumberedEvent< 5 >
using	Press_Transition = MatchedTransition< Press_Event >
using	Move_Transition = MatchedTransition< Move_Event >
using	Release_Transition = MatchedTransition< Release_Event >
using	Cancel_Transition = MatchedTransition< Cancel_Event >
using	ShiftTransition = MatchedTransition< Shift_Event >
using	comparable_function = std::shared_ptr< std::function< void()> >
using	id_generator = score::linear_id_generator
template<class Key , class T >
using	hash_map = ossia::hash_map< Key, T >

Enumerations
enum	Modifier_tagme { Click = 100 , Move = 200 , Release = 300 }
enum	TimeMode { Bars , Seconds , Flicks }

Functions
const ApplicationContext &	AppContext ()
const GUIApplicationContext &	GUIAppContext ()
const ApplicationComponents &	AppComponents ()
void	setQApplicationMetadata ()
template<typename RedoFun >
void	loadCommandStack (const score::ApplicationComponents &components, DataStreamWriter &writer, score::CommandStack &stack, RedoFun redo_fun)
QString	newProcessedFilePath (const QString &sourceFile, const QDir &destination)
	Obtains a new file name in the project folder to save a processed file.
Id< score::DocumentModel >	getStrongId (const std::vector< score::Document * > &v)
ApplicationServices &	AppServices () noexcept
QString	toNumber (double v) noexcept
QString	toNumber (int v) noexcept
template<typename T >
double	operator* (double lhs, const ValueAssigner< T > &rhs) noexcept
template<typename T >
T &	component (const score::Components &c)
	component Fetch a Component from Components by type
template<typename T >
T *	findComponent (const score::Components &c) noexcept
	findComponent Tryies to fetch a Component from Components by type.
template<typename T >
auto	id (const Path< T > &path)
SCORE_LIB_BASE_EXPORT QString	addonArchitecture ()
	addonArchitecture
template<typename DocPlugin >
auto &	addDocumentPlugin (score::Document &doc)
void	debug_types (const InterfaceBase *orig, const InterfaceBase *repl) noexcept
std::vector< Plugin_QtInterface * > &	staticPlugins ()
template<typename T , typename Model >
void	setupDefaultSettings (QSettings &set, const T &tuple, Model &model)
score::hash_map< std::string, std::unique_ptr< any_serializer > > &	anySerializers ()
	The serializers for types that go in ossia::any should fit in here.
template<typename Object >
auto	unmarshall (const JSONReader &obj)
const StringConstants &	StringConstant ()
template<typename T >
void	serialize_dyn_impl (DataStream::Serializer &v, const T &t)
template<typename T >
void	serialize_dyn_impl (JSONObject::Serializer &v, const T &t)
template<typename TheClass >
void	serialize_dyn (const VisitorVariant &vis, const TheClass &s)
template<typename TheClass >
TheClass &	deserialize_dyn (const VisitorVariant &vis, TheClass &s)
template<typename TheClass >
TheClass	deserialize_dyn (const VisitorVariant &vis)
template<typename Functor >
auto	deserialize_dyn (const VisitorVariant &vis, Functor &&fun)
template<typename Type , typename Object >
auto	marshall (const Object &obj)
	marshall Serializes a single object
template<typename Object >
auto	unmarshall (const rapidjson::Value &obj)
template<typename Object >
auto	unmarshall (const QByteArray &arr)
template<typename Transition , typename SourceState , typename TargetState , typename... Args>
Transition *	make_transition (SourceState source, TargetState dest, Args &&... args)
void	setCursorPos (QPointF pos) noexcept
void	moveCursorPos (QPointF pos) noexcept
QPoint	globalPos (QMouseEvent *event)
QPointF	globalPos (QWidget *viewport, QGraphicsSceneMouseEvent *event)
void	hideCursor (bool hasCursor)
void	showCursor ()
template<typename T >
void	clearAndDeleteLater (T &container, delete_later< T > &storage) noexcept
template<typename T >
auto	clearAndDeleteLater (T &container) noexcept
QString	addUniqueSuffix (const QString &fileName)
QString	locateFilePath (const QString &filename, const score::DocumentContext &ctx) noexcept
QString	relativizeFilePath (const QString &filename, const score::DocumentContext &ctx) noexcept
QByteArray	mapAsByteArray (QFile &f) noexcept
std::string_view	mapAsStringView (QFile &f) noexcept
std::string	readFileAsString (QFile &f) noexcept
QString	readFileAsQString (QFile &f) noexcept
QStringList	list_ipv4_for_connecting () noexcept
QStringList	list_ipv4_for_listening () noexcept
void	for_all_files (std::string_view root, std::function< void(std::string_view)> f)
template<typename Map >
void	optimize_hash_map (Map &map)
template<typename T >
indirect_iterator< T >	make_indirect_iterator (const T &it) noexcept
template<typename T >
indirect_ptr_iterator< T >	make_indirect_ptr_iterator (const T &it)
template<typename T >
indirect_map_iterator< T >	make_indirect_map_iterator (const T &it)
template<typename CastTo , typename T >
indirect_cast_map_iterator< T, CastTo >	make_indirect_cast_map_iterator (const T &it)
template<typename T >
auto	wrap_indirect (T &container)
void	setCursor (Qt::CursorShape c)
	setCursor sets the cursor safely.
SCORE_LIB_BASE_EXPORT const QPalette &	transparentPalette ()
void	setHelp (QWidget *widg, const QString &shorttxt, const QString &txt)
void	setHelp (QAction *widg, const QString &shorttxt, const QString &txt)
void	setHelp (QWidget *widg, const QString &txt)
void	setHelp (QAction *widg, const QString &txt)
int	question (QWidget *parent, const QString &title, const QString &text)
int	information (QWidget *parent, const QString &title, const QString &text)
int	warning (QWidget *parent, const QString &title, const QString &text)
QImage	get_image (QString str)
QPixmap	get_pixmap (QString str)
void	setGlobalTimeMode (TimeMode mode)

Variables
std::array< QString, 5 >	arrow_name
TimeMode	globalTimeMode = TimeMode::Bars

Function Documentation

addonArchitecture()

SCORE_LIB_BASE_EXPORT QString score::addonArchitecture

(

)

addonArchitecture

Returns

Architecture for the system score is compiled for.

component()

template<typename T >

T & score::component

(

const score::Components &

c

)

component Fetch a Component from Components by type

Returns

The component.

The component must have a member static const constexpr bool is_unique = true in order to use this function.

This guarantees that there will be a single component of a given type in the Components.

findComponent()

template<typename T >

T * score::findComponent ( const score::Components &  c )

noexcept

findComponent Tryies to fetch a Component from Components by type.

This works similarly to components ; instead of aborting, it returns a null pointer if the component does not exist.

See also

components

locateFilePath()

SCORE_LIB_BASE_EXPORT QString score::locateFilePath ( const QString &  filename, const score::DocumentContext &  ctx  )

noexcept

Will also look where the save file is located. TODO in the future also look in a "common" library folder.

marshall()

template<typename Type , typename Object >

auto score::marshall

(

const Object &

obj

)

marshall Serializes a single object

Parameters

obj	The object to serialize.

This will create the relevant serialization datatype for Type. For instance, a QByteArray if it is DataStream and a QJSonObject if it is JSONObject

newProcessedFilePath()

QString score::newProcessedFilePath	(	const QString &	sourceFile,
		const QDir &	destination
	)

Obtains a new file name in the project folder to save a processed file.

e.g. if the source file is /tmp/foo.wav, the output may be

/home/myself/Documents/My score project/Processed/foo-0003.wav

relativizeFilePath()

SCORE_LIB_BASE_EXPORT QString score::relativizeFilePath ( const QString &  filename, const score::DocumentContext &  ctx  )

noexcept

Will try to convert an absolute path in a relative path from the document's point of view

Variable Documentation

arrow_name

std::array<QString, 5> score::arrow_name

Initial value:

= {
    "",     
    "up",   
    "down", 
    "left", 
    "right" 
}