GraphartScharen (BandM signal & music)

java.lang.Object
- eu.bandm.music.top.SvgSource
- - eu.bandm.music.top.GraphartScharen

public class GraphartScharen
extends SvgSource

Renders graphical art according to a dynamic score, based on a project by DKR and ML from 1980, called "Graphart Scharen".
The main example score is sig/examples/tscore/scharen0.tscore.

Score format is as follows:

   SCORE x PARS y 
      T      0              20            1'20             2'10
   VOX a     0,0/           %,99          /                99,0
   // main param is position, integer from 0 to 99
   // rendering makes viewport interpretation, eg. 20--70      -> 0 --1024
   //                                              scoreCoord  -> physCoord
             "-" means: hold value until next explicit value (is default)
             "/" means: start linear interpolation


    P  orient 
    // orientation: CURRENTLY only 0 or 90.

    P  num  3          
    // number of lines >=2, NOT INTERPOLATING

    P  dist
    // distance 0.0 to 99.9999, same scale as position, etc.

    P  width
    // linewidth, scale=position*100 
    P  len  20          
    // same units as position

    P  color 0,0,99/                      0,99,0-/
    // color is integer RGB, 99 is full, 0 is not present
    // Defaults to naive complement of background color.

    P  alpha 0-/
   // alpha is transparency, 0 is opaque, 99 is invisible

   sequential source order of voices defines the (decreasing) visibility z-stacking 
   viewport will be defined when rendering
        TO <0, width, 0, height>

Sensible extension would be:

arbitrary rotation, dynamic
selectable background color

(for comments on dynamic svg see docu of superclass)

Coordinate System is the usual peculiar one:

     (0,0)------------------>
      |
      |       (x,y)========  \
      |       =============  / dist
      |       =============
      |       \____len____/
      V

Code generation scheme of one(1) sheaf:

 [g]
   [g]
     [g]
       [line x="0" .." /]
       [line x="1*dist" .." ]
          [animate "x" from "1*dist" to "1*dist'" fill="freeze" .. /]  // <---DIST
       [/line]
       [line x="2*dist" .." ]
          [animate attributeName="x" from="2*dist" to="2*dist'" begin=".." end=".."  .. /]
          [set attributeName="len" to="0" begin=".."/]      // <-- NUM. when it decreases
          [set attributeName="len" to="100" begin=".."/]    //     .. increases
       [/line]
       [animateTransform attributeName="transform"
         type="scale" from="1 len/100" to="1 len'/100" .. /]     // <-- LEN 
     [/g]
     [animateTransform attributeName="transform"
       type="translate" from="x 0" to="x' 0" .. /]             // <-- X
   [/g]
   [animateTransform attributeName="transform"
     type="translate" from="0 y" to="0 y'" .. /]             // <-- Y
   [animate attributeType="CSS" attributeName="stroke-width"
     from="x 0" to="x' 0" begin=".." dur=".." /]             // <-- WIDTH
   [animate attributeType="CSS" attributeName="stroke"
     from="x 0" to="x' 0" .. /]                              // <-- COLOR
   [animate attributeType="CSS" attributeName="stroke-opacity"
     from="1.0" to="0.01" .. /]                              // <-- ALPHA
 [/g]

Nested Class Summary
- Nested classes/interfaces inherited from class eu.bandm.music.top.SvgSource
  SvgSource.ParamTranslate, SvgSource.Process

Field Summary

Fields
Modifier and Type	Field and Description
`(package private) Map<Event,Integer>`	`event2alpha`
`(package private) Map<Event,String>`	`event2alpha_ipol`
`(package private) Map<Event,Color_rgb_8>`	`event2color`
`(package private) Map<Event,String>`	`event2color_ipol`
`(package private) Map<Event,Integer>`	`event2dist`
`(package private) Map<Event,String>`	`event2dist_ipol`
`(package private) Map<Event,Integer>`	`event2len`
`(package private) Map<Event,String>`	`event2len_ipol`
`(package private) Map<Event,Integer>`	`event2num`
`(package private) Map<Event,Integer>`	`event2orient`
`(package private) Map<Event,String>`	`event2pos_ipol`
`(package private) Map<Event,Integer>`	`event2width`
`(package private) Map<Event,String>`	`event2width_ipol`
`(package private) Map<Event,Integer>`	`event2xpos`
`(package private) Map<Event,Integer>`	`event2ypos`
`(package private) Translet.Parser<?>`	`parse_alpha`
`(package private) Translet.Parser<?>`	`parse_color`
`(package private) Translet.Parser<?>`	`parse_dist`
`(package private) Translet.Parser<String>`	`parse_ipol`
`(package private) Translet.Parser<?>`	`parse_len`
`(package private) Translet.Parser<?>`	`parse_num`
`(package private) Translet.Parser<?>`	`parse_orient`
`(package private) Translet.Parser<?>`	`parse_pos` Parser for the position, which is the main parameter of each voice.
`(package private) Translet.Parser<?>`	`parse_width`
`static String`	`TRACKNAME_alpha`
`static String`	`TRACKNAME_color`
`static String`	`TRACKNAME_dist`
`static String`	`TRACKNAME_len`
`static String`	`TRACKNAME_num`
`static String`	`TRACKNAME_orient`
`static String`	`TRACKNAME_pos` The position parameter is the "main" parameter of each voice, i.e.
`static String`	`TRACKNAME_width`

Fields inherited from class eu.bandm.music.top.SvgSource
caldur2tp, defaultModifiers, firstTp, hiX, hiY, lastTp, lowX, lowY, msg, msgr, part, physHiX, physHiY, punit, pw, rat2tp, timeFactor, tp2caldur, tp2rat, xFact, yFact

Constructor Summary

Constructors
Constructor and Description
`GraphartScharen(Part part, MessageReceiver<SimpleMessage<XMLDocumentIdentifier>> msg)` Only constructor for this tscore data processors, found and instantiated by `MfMain` by reflection.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected void`	`convertData()` Global entry point for output generation, called by superclass.
`protected void`	`convertVoice(Vox v)` Writes the complete SVG source of one(1) voice to the output printwriter.
`void`	`update()` Translate untyped tscore data into semantically sensible "GraphartScharen" data.

Methods inherited from class eu.bandm.music.top.SvgSource
alpha2string, animateString_tp, animateString, animateTransformString, check_init_def, color2string, convertToSvg, height2device, height2device, printAlpha, printColor, setString, tp2device, when2device, width2device, width2device, x2device, y2device

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - TRACKNAME_pos
```
public static final String TRACKNAME_pos
```
    The position parameter is the "main" parameter of each voice, i.e. the "event defining" parameter, so the parameter track has no particular visible name, but appears as "VOX [voicename]" and is thus set to Event.main_parameter_name.
    
    See Also:
    
    Constant Field Values
  - TRACKNAME_orient
```
public static final String TRACKNAME_orient
```
    See Also:
    
    Constant Field Values
  - TRACKNAME_num
```
public static final String TRACKNAME_num
```
    See Also:
    
    Constant Field Values
  - TRACKNAME_dist
```
public static final String TRACKNAME_dist
```
    See Also:
    
    Constant Field Values
  - TRACKNAME_width
```
public static final String TRACKNAME_width
```
    See Also:
    
    Constant Field Values
  - TRACKNAME_len
```
public static final String TRACKNAME_len
```
    See Also:
    
    Constant Field Values
  - TRACKNAME_color
```
public static final String TRACKNAME_color
```
    See Also:
    
    Constant Field Values
  - TRACKNAME_alpha
```
public static final String TRACKNAME_alpha
```
    See Also:
    
    Constant Field Values
  - event2xpos
```
final Map<Event,Integer> event2xpos
```
  - event2ypos
```
final Map<Event,Integer> event2ypos
```
  - event2orient
```
final Map<Event,Integer> event2orient
```
  - event2num
```
final Map<Event,Integer> event2num
```
  - event2dist
```
final Map<Event,Integer> event2dist
```
  - event2width
```
final Map<Event,Integer> event2width
```
  - event2len
```
final Map<Event,Integer> event2len
```
  - event2alpha
```
final Map<Event,Integer> event2alpha
```
  - event2color
```
final Map<Event,Color_rgb_8> event2color
```
  - event2pos_ipol
```
final Map<Event,String> event2pos_ipol
```
  - event2len_ipol
```
final Map<Event,String> event2len_ipol
```
  - event2dist_ipol
```
final Map<Event,String> event2dist_ipol
```
  - event2width_ipol
```
final Map<Event,String> event2width_ipol
```
  - event2color_ipol
```
final Map<Event,String> event2color_ipol
```
  - event2alpha_ipol
```
final Map<Event,String> event2alpha_ipol
```
  - parse_ipol
```
final Translet.Parser<String> parse_ipol
```
  - parse_pos
```
final Translet.Parser<?> parse_pos
```
    Parser for the position, which is the main parameter of each voice. x and y position are given independently, as in
```
     1,11    %,12/    2,%-     3,13     
  
```
  - parse_orient
```
final Translet.Parser<?> parse_orient
```
  - parse_num
```
final Translet.Parser<?> parse_num
```
  - parse_dist
```
final Translet.Parser<?> parse_dist
```
  - parse_width
```
final Translet.Parser<?> parse_width
```
  - parse_len
```
final Translet.Parser<?> parse_len
```
  - parse_color
```
final Translet.Parser<?> parse_color
```
  - parse_alpha
```
final Translet.Parser<?> parse_alpha
```
- Constructor Detail
  - GraphartScharen
```
public GraphartScharen(Part part,
                       MessageReceiver<SimpleMessage<XMLDocumentIdentifier>> msg)
```
    Only constructor for this tscore data processors, found and instantiated by MfMain by reflection.
- Method Detail
  - update
```
public void update()
```
    Translate untyped tscore data into semantically sensible "GraphartScharen" data. This method reads the event lists contained in TimeScape->voices->bySourceOrder and writes to all the local Map and Set output data declared locally.
    
    Overrides:
    
    update in class SvgSource
  - convertVoice
```
protected void convertVoice(Vox v)
```
    Writes the complete SVG source of one(1) voice to the output printwriter. Before, some important consistency constraints are checked, e.g. definedness of initial values.
  - convertData
```
protected void convertData()
```
    Global entry point for output generation, called by superclass. Glo out SvgSource.pw. Visits voices in source text order.
    
    Specified by:
    
    convertData in class SvgSource

Class GraphartScharen

Nested Class Summary

Nested classes/interfaces inherited from class eu.bandm.music.top.SvgSource

Field Summary

Fields inherited from class eu.bandm.music.top.SvgSource

Constructor Summary

Method Summary

Methods inherited from class eu.bandm.music.top.SvgSource

Methods inherited from class java.lang.Object

Field Detail

TRACKNAME_pos

TRACKNAME_orient

TRACKNAME_num

TRACKNAME_dist

TRACKNAME_width

TRACKNAME_len

TRACKNAME_color

TRACKNAME_alpha

event2xpos

event2ypos

event2orient

event2num

event2dist

event2width

event2len

event2alpha

event2color

event2pos_ipol

event2len_ipol

event2dist_ipol

event2width_ipol

event2color_ipol

event2alpha_ipol

parse_ipol

parse_pos

parse_orient

parse_num

parse_dist

parse_width

parse_len

parse_color

parse_alpha

Constructor Detail

GraphartScharen

Method Detail

update

convertVoice

convertData