MovingForms (BandM signal & music)

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

public class MovingForms
extends SvgSource

Simple example application of tscore and svg generation which maked geometrical shapes wander over a browser screen.
The main example score is sig/examples/tscore/simple.moving.

The score format is as follows:

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

    P  form  3          
   // param form is 0(circle), 3(triangle) or 4(square)
    P  size  3/                           5                10
   // size is diameter/side length, same units as position
    P  color 0,0,99/                      0,99,0-/
   // color is integer RGB, 99 is full, 0 is not present
    P  alpha 0-/
   // alpha is transparency, 0 is opaque, 99 is invisible
   // all values are integer.

The sequential source order of voices defines the (decreasing) visbility z-stacking.
The viewport will be defined when rendering x1, x2, y1, y2, size to (0..width) and (0..height).
All y-coordinates (in user space and in generated svg) grow downwards, as usual in svg, see See https://www.w3.org/TR/SVG11/coords.html#InitialCoordinateSystem
(For more info about "dynamic svg" see docu of superclass)

The fundamental code generation scheme for one single moving form (circle or polygon) is:

    [g]
      [circle r=".." transform="scale(..)" fill=".."]
        [set attributeType='XML' attributeName='opacity'  to='1.0' begin='SWITCH_ON_TIME' /]
        [animateTransform attributeType='XML' attributeName='transform'
          type='scale' from=".." to=".." begin=".." dur=".." /]
      [/circle]
      [animateTransform attributeType='XML' attributeName='transform'
        type='translate' from=".." to=".." begin=".." dur=".." /]
    [/g]
    [g]
      [polygon r=".." points=".. .. .." transform="scale(..)" fill=".."]
        ...
      [/polygon]
    [/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` Maps some events to the transparent value (called "alpha")
`(package private) Map<Event,String>`	`event2alpha_ipol` Maps some events to the interpolation mode to apply to the transparency.
`(package private) Map<Event,Color_rgb_8>`	`event2color` Evident
`(package private) Map<Event,String>`	`event2color_ipol` Maps some events to the interpolation mode to apply to the color.
`(package private) Map<Event,Integer>`	`event2form` Evident
`(package private) Map<Event,String>`	`event2pos_ipol` Maps some events to the interpolation mode to apply to the position.
`(package private) Map<Event,Integer>`	`event2size` Evident
`(package private) Map<Event,String>`	`event2size_ipol` Maps some events to the interpolation mode to apply to the size.
`(package private) Map<Event,Integer>`	`event2xpos` Evident
`(package private) Map<Event,Integer>`	`event2ypos` Evident
`(package private) Translet.Parser<?>`	`parse_alpha` Parser for the transparency, plus an optional interpolation sign, see `parse_ipol`.
`(package private) Translet.Parser<?>`	`parse_color` Parser for the color, as defined by `Color_rgb_8.parser(String)`, plus an optional interpolation sign, see `parse_ipol`.
`(package private) Translet.Parser<?>`	`parse_form` Parser for the geometric form.
`(package private) Translet.Parser<String>`	`parse_ipol` Parser for the interpolation indication.
`(package private) Translet.Parser<?>`	`parse_pos` Parser for the main parameter value, which is x-pos and y-pos (both as non-negative integers) plus an optional interpolation sign, see `parse_ipol`.
`(package private) Translet.Parser<?>`	`parse_size` Parser for the size (non-negative integer), plus an optional interpolation sign, see `parse_ipol`.
`static String`	`TRACKNAME_alpha` Evident
`static String`	`TRACKNAME_color` Evident
`static String`	`TRACKNAME_form` Evident
`static String`	`TRACKNAME_pos` Evident
`static String`	`TRACKNAME_size` Evident

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
`MovingForms(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()` Must be overridden by the sub-class which realizes the specific conversion.
`protected void`	`convertVoice(Vox v)` Generate the complete svg/smil target text for one voice.
`protected String`	`polyPoints(int n)` Create a polygon with radius = 100 .
`protected String`	`posString(Event e)` Deliver the target svg text of the form's position, in svg coordinates.
`protected String`	`size2transformstring(int user)` Deliver the target svg text of the form's size, as a "scale()" svg command.
`protected String`	`sizeString(Event e)` Deliver the target svg text of the form's size.
`void`	`update()` Translate untyped tscore data into semantically sensible "MovingForm" data, and verify that all constraints are met.

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
```
    Evident
    
    See Also:
    
    Constant Field Values
  - TRACKNAME_form
```
public static final String TRACKNAME_form
```
    Evident
    
    See Also:
    
    Constant Field Values
  - TRACKNAME_size
```
public static final String TRACKNAME_size
```
    Evident
    
    See Also:
    
    Constant Field Values
  - TRACKNAME_color
```
public static final String TRACKNAME_color
```
    Evident
    
    See Also:
    
    Constant Field Values
  - TRACKNAME_alpha
```
public static final String TRACKNAME_alpha
```
    Evident
    
    See Also:
    
    Constant Field Values
  - parse_ipol
```
final Translet.Parser<String> parse_ipol
```
    Parser for the interpolation indication. Occurs always wrapped in an OPT.
  - event2xpos
```
final Map<Event,Integer> event2xpos
```
    Evident
  - event2ypos
```
final Map<Event,Integer> event2ypos
```
    Evident
  - event2form
```
final Map<Event,Integer> event2form
```
    Evident
  - event2size
```
final Map<Event,Integer> event2size
```
    Evident
  - event2alpha
```
final Map<Event,Integer> event2alpha
```
    Maps some events to the transparent value (called "alpha")
  - event2color
```
final Map<Event,Color_rgb_8> event2color
```
    Evident
  - event2pos_ipol
```
final Map<Event,String> event2pos_ipol
```
    Maps some events to the interpolation mode to apply to the position.
  - event2size_ipol
```
final Map<Event,String> event2size_ipol
```
    Maps some events to the interpolation mode to apply to the size.
  - event2color_ipol
```
final Map<Event,String> event2color_ipol
```
    Maps some events to the interpolation mode to apply to the color.
  - event2alpha_ipol
```
final Map<Event,String> event2alpha_ipol
```
    Maps some events to the interpolation mode to apply to the transparency.
  - parse_pos
```
final Translet.Parser<?> parse_pos
```
    Parser for the main parameter value, which is x-pos and y-pos (both as non-negative integers) plus an optional interpolation sign, see parse_ipol.
  - parse_form
```
final Translet.Parser<?> parse_form
```
    Parser for the geometric form. This may be the integer 0(zero) for a circle, or 3 to 8 for a polygon. (Is currently evaluated only once, with the very first event, -- changes of the form are not supported.)
  - parse_size
```
final Translet.Parser<?> parse_size
```
    Parser for the size (non-negative integer), plus an optional interpolation sign, see parse_ipol.
  - parse_color
```
final Translet.Parser<?> parse_color
```
    Parser for the color, as defined by Color_rgb_8.parser(String), plus an optional interpolation sign, see parse_ipol.
  - parse_alpha
```
final Translet.Parser<?> parse_alpha
```
    Parser for the transparency, plus an optional interpolation sign, see parse_ipol. Transparency is encoded from 0=totally transparent=invisible to 100=totally opaque.
- Constructor Detail
  - MovingForms
```
public MovingForms(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 "MovingForm" data, and verify that all constraints are met. 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
  - posString
```
protected String posString(Event e)
```
    Deliver the target svg text of the form's position, in svg coordinates.
  - sizeString
```
protected String sizeString(Event e)
```
    Deliver the target svg text of the form's size. The created drawing has a size of 100 physical units, so a factor of magnification is calculated accordingly.
  - size2transformstring
```
protected String size2transformstring(int user)
```
    Deliver the target svg text of the form's size, as a "scale()" svg command. The created drawing has a size of 100 physical units, so a factor of magnification is calculated accordingly.
  - polyPoints
```
protected String polyPoints(int n)
```
    Create a polygon with radius = 100 .
    
    Parameters:
    
    n - number of edges
  - convertVoice
```
protected void convertVoice(Vox v)
```
    Generate the complete svg/smil target text for one voice. One voice corresponds to one moving geometrical form, with number of edges, position, size, color, and opacity.
  - convertData
```
protected void convertData()
```
    Must be overridden by the sub-class which realizes the specific conversion. This may use all parameters in local registers and the auxiliary write-out methods.. Here: convert one by one all tscore "voice" objects into an Svg/Smil source text.
    
    Specified by:
    
    convertData in class SvgSource

Class MovingForms

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_form

TRACKNAME_size

TRACKNAME_color

TRACKNAME_alpha

parse_ipol

event2xpos

event2ypos

event2form

event2size

event2alpha

event2color

event2pos_ipol

event2size_ipol

event2color_ipol

event2alpha_ipol

parse_pos

parse_form

parse_size

parse_color

parse_alpha

Constructor Detail

MovingForms

Method Detail

update

posString

sizeString

size2transformstring

polyPoints

convertVoice

convertData