Browse Source

doc/notes.txt : Added performance editor design notes.

master
Kevin Larke 9 years ago
parent
commit
9f6611d293
1 changed files with 97 additions and 0 deletions
  1. 97
    0
      doc/notes.txt

+ 97
- 0
doc/notes.txt View File

@@ -597,6 +597,103 @@ E5,G33,A#2,C#1 212-218 Marker 36
597 597
 E3             185     Marker 37
598 598
 F5,C#4,G#5     986     Marker-Down 204     
599 599
 
600
+=============================================================================
601
+Sequence Editor Design
602
+
603
+1) Performance pre-processing:
604
+  For each annotated performance section align the performance to the score.
605
+  and fill in the 
606
+   sectionArray :
607
+   [
608
+     section :
609
+     {
610
+       seq    : 1           // time-line this section resides in   
611
+       marker : 12          // time-line id of this sections begin marker 
612
+     
613
+       eventArray :
614
+       [
615
+         event : 
616
+         {
617
+
618
+	   // score tracking status
619
+	   // aligned   = event matches a score location (scloc is valid)
620
+	   // inserted  = inserted note that does not match the score (scloc is not valid)
621
+	   // pitch_err = matches score with the wrong pitch (scloc is valid)
622
+	   // order_err = matches score but not is out of order (scloc is valid)
623
+	   status: aligned | inserted | pitch_err | order_err
624
+
625
+	   // score location this event is associated with
626
+	   // or -1 if the note does not match a score event
627
+           scloc:    154      
628
+
629
+	   // performance sample index as an offset into the time-line sequence
630
+	   smpIdx:   134689   
631
+
632
+	   // performance event duration
633
+	   durtn:    234567  
634
+	   
635
+	   // optional note event information
636
+	   note : 
637
+	   {
638
+	     pitch: 60
639
+	     vel:   110
640
+	   }
641
+
642
+	   // optional pedal event information
643
+	   pedal :
644
+	   {
645
+	     label: quiet, sust, damp
646
+	     down : true
647
+	   }
648
+         }      
649
+       ]
650
+     }
651
+   ]
652
+ 
653
+2) Create a new sequence by combining sections:
654
+
655
+  a. Load the section array file created in step 1).
656
+  b. Select a set of sections to form the basis of the new sequence.
657
+  c. Resolve overlapping notes by disabling extra notes that share the
658
+     same score location.
659
+  d. Insert missing notes by selecting a note(s) from the score.
660
+  e. Increase or decrease the inter-onset interval between two notes.
661
+     (this will adjust the absolute time offset of all subsequent notes)
662
+  f. Edit the velocity of a note.
663
+  g. Shift the position of a pedal down or up event.
664
+  h. Insert a pedal event.
665
+  i. Write the sequence to a file.
666
+  j. Load a sequence from a file.
667
+
668
+3) User Interface:
669
+  Two Views:
670
+  a. Single Frame View: 
671
+     Display score bars and sections (same as score window) and overlay 
672
+     section boxes. Select sections to include in a new sequence.
673
+     Select Edit | Create Sequence.
674
+
675
+  b. Single Frame View: 
676
+     The begin marker of each frame includes the section label.
677
+     Selecting the begin section marker selects all events in the section.  
678
+       (this does not have to be done explicitely)
679
+     Each note in each section is displayed piano-roll style.
680
+        The notes are colored according to their 'status'.
681
+	Overlapping notes are shown in red.
682
+	Disabled notes are shown as hollow boxes.
683
+     A strip at the bottom shows the pedal state.
684
+     
685
+
686
+     Menu:
687
+       Show/Hide selected events / sections.
688
+       Enable/Disable selected events.
689
+        
690
+     
691
+ 
692
+
693
+
694
+
695
+=============================================================================
696
+
600 697
 -------------------------------------------------------------------------------
601 698
 OSX - Install Notes
602 699
 -------------------------------------------------------------------------------

Loading…
Cancel
Save