Template:MOS gamut/doc: Difference between revisions

Ganaram inukshuk (talk | contribs)
Ganaram inukshuk (talk | contribs)
No edit summary
Line 11: Line 11:
| Bright Gens Up || No (optional) || The number of bright generators going up needed to produce the mode for which notation is applied. In [[UDP notation]], this corresponds to the value u in the UDP of u|d, or up (u times p) in the UDP of up<nowiki>|</nowiki>dp for multi-period mosses. If left blank, then the brightest mode is used by default.
| Bright Gens Up || No (optional) || The number of bright generators going up needed to produce the mode for which notation is applied. In [[UDP notation]], this corresponds to the value u in the UDP of u|d, or up (u times p) in the UDP of up<nowiki>|</nowiki>dp for multi-period mosses. If left blank, then the brightest mode is used by default.
|-
|-
| Note Symbols || No (optional) || A sequence of note symbols, such as "CDEFGAB" and "JKLMNOP", the default for standard notation and [[diamond-MOS]] respectively, if left blank.
| Note Symbols || No (optional) || A sequence of note symbols entered as a string, such as "CDEFGAB" and "JKLMNOP", the default for standard notation and [[diamond-MOS]] respectively, if left blank.
|-
|-
| Sharp Symbol || No (optional) || The symbol used to denote raising by a chroma, usually a sharp (#) or "am/amp" symbol (&), the default for standard notation and diamond-MOS respectively, if left blank.
| Sharp Symbol || No (optional) || The symbol used to denote raising by a chroma, usually a sharp (#) or "am/amp" symbol (&), the default for standard notation and diamond-MOS respectively, if left blank.
Line 20: Line 20:
== Usage ==
== Usage ==


The typical use of this template is for describing a mos's gamut, the set of named notes, with accidentals.
The typical use of this template is for describing a mos's gamut, the set of named notes.


<pre>{{MOS gamut}}</pre>
<pre>{{MOS gamut}}</pre>


A scale signature different from the page's title can be specified as shown below.
A scale signature different from the page's title can be specified as shown below. This produces a gamut using the step ratio 2/1 and the brightest mode.


<pre>{{MOS gamut|Scale Signature = 4L 3s}}</pre>
<pre>{{MOS gamut|Scale Signature = 4L 3s}}</pre>
{{MOS gamut|Scale Signature = 4L 3s}}
{{MOS gamut|Scale Signature = 4L 3s}}


This produces a gamut with a step ratio of 2:1 for the brightest mode. Since it's common to use different step ratios and to apply notation to a different mode, an example of overriding the mode and step ratio is shown below.
=== Using a different step ratio and mode ===
 
An example of using a different step ratio and mode are shown below.


<pre>{{MOS gamut|Scale Signature = 4L 3s|Bright Gens Up = 3|Step Ratio = 3/1}}</pre>
<pre>{{MOS gamut|Scale Signature = 4L 3s|Bright Gens Up = 3|Step Ratio = 3/1}}</pre>
Line 49: Line 51:
== Limitations ==
== Limitations ==


Equivalent pitch classes, such as enharmonic equivalents, are currently limited to pitches that fall at the exact midpoint of two other pitches, such as C# and Db being equivalent in standard notation, or C and B# being equivalent. This is to ensure note names have as few accidentals as possible.
Equivalent pitch classes are currently limited to pitches that fall at the exact midpoint of two other pitches, such as C# and Db being equivalent in standard notation, or C and B# being equivalent. This is to ensure note names have as few accidentals as possible.


Accidentals smaller than a chroma, such as [[ups and downs notation|ups and downs]] or half-accidentals, are currently not supported. An example of such usage is 5L 2s in 31edo, where Dbb may be notated as ^C (up-C) or Ct (C half-sharp).
Accidentals smaller than a chroma, such as [[ups and downs notation|ups and downs]] or half-accidentals, are currently not supported. An example of such usage is 5L 2s in 31edo, where Dbb may be notated as ^C (up-C) or Ct (C half-sharp).
Line 56: Line 58:
{{MOS gamut|Scale Signature = 5L 2s|Step Ratio = 5/3}}
{{MOS gamut|Scale Signature = 5L 2s|Step Ratio = 5/3}}


If a step ratio is entered without being simplified, the edo (or ed{{angbr|equave|}}) displayed will reflect that by being a larger division of the equave. An example of this is 5L 2s in 24edo, whose step ratio is 4/2. However, notation for the additional notes, which may be notated using ups and downs, are currently not added to keep the output simplified.
If a step ratio is entered without being simplified, the edo (or ed{{angbr|equave|}}) displayed will reflect that by being a larger division of the equave. An example of this is 5L 2s in 24edo, whose step ratio is 4/2. However, the notes in between are not shown to keep the output simplified.


<pre>{{MOS gamut|Scale Signature = 5L 2s|Step Ratio = 4/2}}</pre>
<pre>{{MOS gamut|Scale Signature = 5L 2s|Step Ratio = 4/2}}</pre>