nRadii_sawOsc

nRadii_sawOsc
- description
  - presentation view
    - user can set
      - the number of equidistant pitch-class radii to place upon the spiral
      - an offset in cents to adjust the angle of the first radius
      - snap to pitch-class radii (toggle on/off)
      - amplitude envelope (ADSR)
        
        Atack time
        
        Decay time
        
        Sustain level
        
        Release time
    - spirial
      - moving the mouse over the spiral sets the frequency of the oscillator
      - mouse button acts as the attack and release trigger for the ADSR envelope
    - values at pointer
      - displaying value in three units of measurement
        
        Theta angle (degrees)
        
        Midi Pitch
        
        Frequency (Hertz)
- configuration
  - user set parameters are connected both to [p "put equidistant radii"] and to individual [pv ] objects so that the values can be shared with sub-pathers
    - [pv numRadii]
    - [pv radiusOffsetPhase]
    - [pv snapPitchClass]
    - [pv snapOctaves]
      - is always 1 in this version
  - [p "put equidistant radii"]
    - inlets for 'number of radii' and 'first radius offset (cents)'
    - using [mousefilter] so radii to prevent re calculating to often
    - put operation has two stages:
      - store cent values for base of each radius
        
        clear [coll radiiCents] and clear the 'radii' layer of the gui
        
        reset [counter] to zero, output _int
        
        start loop
        
        if [counter]_int != 'number of radii' then
        
        cent = _int * ( 1200 / 'number of radii')
        
        cent = (cent + 'first radius offset')
        
        if cent is now > 1200 then
        
        cent -= 1200
        
        store cent in [coll radiiCent] at index _int
        
        _int++
        
        goto start loop
        
        else
        
        dump [coll ] data
        
        break loop
      - draw the radial lines
        
        for each _value in [coll ]
        
        convert _value fron cents to radian
        
        polar-to-cartesean using _value theta and an amplitude/alpha greater than the radius of the display
        
        offset cartesean coordinates to centre the polar origin
        
        output message to draw line from origin to the coordinates on 'radii' layer of the gui
  - [p drawUI]
    - inlet for 'messages for jit.lcd with name of destination matrix prepended'
    - [p Archimedes]
      - draws a spirial onto to the 'bg' layer of the UI
      - bang when complete opens the gate for messages from the inlet
    - the first element of input message used to set the name of the [jit.matrix] which receives output of [jit.lcd]
    - after drawing messages are executed by [jit.lcd], all of the layers (named marices) are mixed output to the [pvar UIpwindow 2] in the main patcher
  - the second outlet [pvar UIpwindow 2] gives mouse-interaction messages from the main gui
    - connected to both [p synthUnit] and [p mouse_interaction]
  - [p mouse_interaction]
    - inlet for 'from UIpwindow dump'
      - messages are [route]'d:
        
        mouseidleout
        
        triggers 'pointer' layer of gui to be cleared
        
        mouse and mouseidle messages treated the same
        
        mousing coordinates are scaled so '0 to 600 becomes -1. to 1.'
        
        coord's undergo car-to-pol convertion
        
        theta_value from [cartopol] converted from radian_angle (-pi to pi) to pitch_class_phase (0. to 1.)
        
        if ( [snapPitchClass]==1 && [pv numRadii]>0 ) then
        
        set pitch_class_phase to nearest radius
        
        convert to degrees
        
        pitch_class_phase *= 360.
        
        add octave-level offset derived from alpha_value of [cartopol] to get theta_position on the spiral