Skip to content

Add \degree explanation - #7713

Open
prko wants to merge 7 commits into
supercollider:developfrom
prko:topic/add_degee_examples_in_Pbind
Open

Add \degree explanation#7713
prko wants to merge 7 commits into
supercollider:developfrom
prko:topic/add_degee_examples_in_Pbind

Conversation

@prko

@prko prko commented Sep 18, 2026

Copy link
Copy Markdown
Contributor

closes #7712

Purpose and Motivation

\degree in Pbind seems not to be kindly documented. This PR adds example code with a link to Literals documentation.

Types of changes

  • Documentation

To-do list

  • Code is tested
  • All tests are passing
  • Updated documentation
  • This PR is ready for review

@JordanHendersonMusic

JordanHendersonMusic commented Sep 18, 2026

Copy link
Copy Markdown
Contributor

Aren't these documented in the event type page?

@prko

prko commented Sep 18, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor Author

Aren't these documented in the event type page?

Do you mean https://docs.supercollider.online/Overviews/Event_types.html?
I couldn't find any corresponding explanation there.

The closest part I could find is in the following section:

supercollider/HelpSource/Tutorials/A-Practical-Guide/PG_07_Value_Conversions.schelp

Lines 39 to 44 in a332bbb

definitionList::
## \degree || represents a scale degree. Fractional scale degrees support accidentals: adding code::0.1:: to an integer scale degree raises the corresponding chromatic note number by a semitone, and subtracting code::0.1:: lowers the chromatic note number. code::0.2:: raises or lowers by two semitones, and so on.
## \note || is a chromatic note index, calculated from code::\degree:: based on a code::\scale:: and modal transposition (code::\mtranspose::, scale degrees to raise or lower the note). code::\note:: is in equal-tempered units of any number of steps to the octave ( code::\stepsPerOctave:: ).
## \midinote || is a 12ET conversion of code::\note::, transposed into the right code::\octave:: and applying gamut transposition (code::\gtranspose::, given in stepsPerOctave units). If code::\stepsPerOctave:: is anything other than code::12::, the non-12ET units are scaled into 12 code::\midinote:: units per octave.
## \freq || is calculated from code::\midinote:: by code::midicps::. A chromatic transposition in 12ET units ( code::\ctranspose:: ) is added.
::

The rendered html: https://docs.supercollider.online/Tutorials/A-Practical-Guide/PG_07_Value_Conversions.html#Pitch%20conversions
See More

@prko

prko commented Sep 18, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor Author

@chromamorph
Hi, are you satisfied with this PR? If you think the "More Examples" section is too extensive, I can remove it. That said, I feel that providing several concrete examples is beneficial, as it helps clarify usage in a variety of situations.

I would also be glad to have you contribute changes directly to this PR as a co-author.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Pitch goes down when it should go up!

2 participants

@prko @JordanHendersonMusic