Package eu.bandm.music.top

Class Formplan_fuge

java.lang.Object
eu.bandm.music.top.Formplan_fuge
public class Formplan_fuge extends Object

  • Field Details

    • msg

      final MessageReceiver<SimpleMessage<XMLDocumentIdentifier>> msg
      Evident.

    • thForm

      protected Map<Event,Formplan_fuge.ThForm> thForm
      Recognized theme forms, by the starting event.

    • inverse

      protected Map<Event,String> inverse
      Whether the theme starting at the event is an inverse.

    • MINIMUM_COMPLETUM

      public static final String MINIMUM_COMPLETUM
      See Also:

    • incomplete

      protected Map<Event,String> incomplete
      Whether the theme starting at the event is incomplete.

    • retro

      protected Map<Event,String> retro
      Whether the theme starting at the event runs in retrograde.

    • freemat

      protected Map<Event,String> freemat
      Whether the theme starting at this event is free counterpoint material. This is indicated by an "X" in the tscore source, and rendered by the line type "0".

    • cpEinsatz

      protected Map<Event,Integer> cpEinsatz
      Whether the theme starting at this event is numbered counterpoint material. This is indicated by a "1" to "9" in the tscore source, and rendered by the line type of this number.

    • factor

      protected Map<Event,Rational> factor
      A time stretch factor assigned to the theme starting at this event.

    • prolongate

      protected Map<Event,String> prolongate
      Input-side representation of a continuing event.

    • pause

      protected Map<Event,String> pause
      Input-side representation of a pause event.

    • divMul

      public final Translet.Parser<?> divMul
      Parser for the time stretch factor.

    • kpEinsatz

      public final Translet.Parser<?> kpEinsatz
      Parser for contrapunctal material.

    • themenEinsatzForm

      public final Translet.Parser<?> themenEinsatzForm
      Parser which accepts capital roman numbers for theme numbers, "D" and "C" for dux and comes, or a combination of both.
      (Currently all this information is only partially reflected in the graphical rendering!)

    • themenEinsatz

      public final Translet.Parser<?> themenEinsatz
      Parser which accepts additional modifiers: "u" for inverse, "r" for retrograde, "1/n" or "n/1" for time stretching, and ">" for incompleteness.
      (Currently all this information is only partially reflected in the graphical rendering!)

    • einsatz_parser

      public final Translet.Parser<?> einsatz_parser
      Topmost parser which accepts themes, counterpoints, pauses, and prolongations.

    • part

      final Part part
      The tscore input data.

    • voicename_tonal_key

      @Opt final @Opt String voicename_tonal_key
      The name of the global voice which give the current tonal key. (This info is currently not represented in the graphical rendering, but used only to ignore this voice.)

    • modifiers

      static final Modifiers modifiers
      Modifiers for the different phases of the parsing process.

    • tp2barnum

      final Map<TpTop,BigInteger> tp2barnum
      Maps the top elements in the score's "T" line to measure numbers = bar numbers. These are (normally) one-based.

    • barnum2tp

      final SortedMap<BigInteger,TpTop> barnum2tp
      Evident

    • lastTp

      Tp lastTp
      The very last time point in the score input data: no event starts here, but all last events end.

    • tp2rat

      protected final Map<Tp,Rational> tp2rat
      Evident

    • rat2tp

      final SortedMap<Rational,Tp> rat2tp
      Evident

    • event2endTp

      final Map<Event,Tp> event2endTp
      Evident

    • soundVoices

      public final List<Vox> soundVoices
      List of all voices, in source order, without the "global current tonal key" voice.

    • factorList

      List<Rational> factorList
      Maps the factors to the code number of the representation.

    • themen

      int themen
      Number of appearing themes (= highest number + 1, no check for gaps!)

    • hasComes

      boolean hasComes
      Whether at least one theme entry is specified as »comes«. (All entries without specification are »dux« by default.)

    • directions

      final Multimap<Integer,SeriesTransformation> directions
      Analysis of subjects and dodecaid directions. In larger contexts (like "Die Kunst der Fuge") one particular subject may be called "inverse" at ALL its entries, which is not suffiecient to make ThMode.direction sensible.

    • hasMultiDirections

      boolean hasMultiDirections
      Indicates that at least one subject appears in more than one dedecaid directions (O, I, R, RI).

    • themesRepresentationPriority_auditive

      public static final List<Formplan_fuge.ThMode> themesRepresentationPriority_auditive

    • themesRepresentationPriority_visual

      public static final List<Formplan_fuge.ThMode> themesRepresentationPriority_visual

  • Constructor Details

    • Formplan_fuge

      public Formplan_fuge(Part part, MessageReceiver<SimpleMessage<XMLDocumentIdentifier>> msg, @Opt @Opt String voicename_tonal_key)
      Only constructor.
      Parameters:
      part - the tscore data
      msg - drain for all messages
      voicename_tonal_key - the name of the voice which contains the current tonal key, changing along the time axis

  • Method Details

    • voiceIsGlobal

      protected boolean voiceIsGlobal(Vox v)
      Whether this voice is the global "current tonal key" voice.

    • getLastTpFloat

      public float getLastTpFloat()
      Evident.

    • getFactor

      final Rational getFactor(Event e)
      Reads the factor and substitutes a 1.0 when missing.

    • getDodecaid

      protected SeriesTransformation getDodecaid(Event e)
      Get the invers/retrograde form of a theme entry.

    • update

      public void update()
      Translate untyped tscore data into semantically sensible "fugue form plan" attribute collection. This method reads the event lists contained in TimeScape->voices->events, ordered by time point, and writes to all the local Map and Set output data declared locally.

    • makeRoutingPlan

      public Formplan_fuge.RoutingPlan makeRoutingPlan(Formplan_fuge.ThMode representation)

    • defaultThemesRepresentationMode_visual

      public Formplan_fuge.ThMode defaultThemesRepresentationMode_visual()

    • defaultThemesRepresentationMode_auditive

      public Formplan_fuge.ThMode defaultThemesRepresentationMode_auditive()

    • toGraphics

      public void toGraphics(Print_Plan_3d printer_th, Print_Plan_3d printer_kp, Formplan_fuge.ThMode thMode, float xfactor, int shift)
      Construct a graphic representation from the score data.

    • addEvent

      protected void addEvent(Event e, int shift, float xfactor, Print_Plan_3d printer, int kind, boolean merge)
      Add one event to the Print_Plan_3d list of graphical representations.
      Parameters:
      e - the event, its start and its end time are needed
      shift - a global correction value for the rational time point values. Needed in case that the data to render is an excerpt, starting later than the piece.
      xfactor - evident
      printer - the graphical object
      kind - currently only relevant for counterpoint material, selects the graphical appearance of the line, see Print_Plan_3d.
      merge - whether adjacent segments of same kind shall be merged.

    • showGraphic

      @Deprecated protected void showGraphic()
      Deprecated.
      Construct and show a Swing graphic representation of the score data. The x factor can be given be the timeless meta data in the part object. Then the graphic is shown in a popping up Swing window.

    • main

      public static void main(String[] args)
      Test method, translates input file "arg[0]" to a graphical form plan of a fugue, or sim. Then it is shown in a popping up Swing window.

      ZZt demo aufrufe : // sig/examples/tscore make testplan1 /kdf_vii.formplan // make testplan0 .../schubert_messe_Es_gloria.formplan