Skip to content

A SuperCollider quark which lets you create customizable UI views associated with values and assignable actions.

License

Notifications You must be signed in to change notification settings

mtmccrea/ValueView.quark

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

68 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

The ValueView Quark

A library of customizable views associated with one or more values for designing your own UI and/or for data visualization.

A ValueView stores a value and will draw a representation of that value in whatever way you choose. Similarly, for a view that interacts with multiple values, there is ValuesView. The Quark includes functional examples classes: RotaryView, a rotary encoder style widget (like a more flexible version of Knob), and XYScaleView, an X/Y plotter controller.

RotaryView example RotaryView: an example of a widget made with ValueView.

Highlights

The view:

  • will automatically update when its values change
  • will notify dependents of changed values
  • can optionally be made interactive, so you can change its value through mouse/key/scroll interaction
  • can limit its update rate and suppress repeated actions
  • uses ControlSpecs internally for un/mapping values for easy setting of ranges and warp factors

Composing your own view

These classes aren't quite plug-and-play: ValueView is meant to be subclassed to author a new view/value representation. You'll also subclass ValueViewLayers which define drawing layers with user-assignable properties. Drawing happens through Qt's Pen methods (used within a UserView internally).

There's a guide to get you up and running, Guides>Subclassing ValueView, as well as two fully functional classes to use and reference: RotaryView and XYScaleView.

XYScaleView example

XYScaleView: a simple example of a widget made with ValuesView. (Represents two independently scaled values: X an Y)

Installing

Install via SuperCollider's command line:

Quarks.install("https://github.com/mtmccrea/ValueView")

Feedback and Bug Reports

Known issues are logged at GitHub.

Change log

0.1.0

  • Published as a Quark.

Credits

The development of the ValueView Quark for SuperCollider3 is supported by The University of Washington's Center for Digital Arts and Experimental Media (DXARTS).  

Copyright the ATK Community, Joseph Anderson, and Michael McCrea, 2018.

Contributors

  • Michael McCrea (@mtmccrea)

About

A SuperCollider quark which lets you create customizable UI views associated with values and assignable actions.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published