1 -*-outline-layout:(2 (-1 -1 0 :) 0);outline-stylish-prefixes:nil -*-
4 Features you cannot find in the doco as working, should be
5 mentioned here. This is an assorted collection of stuff that will be
6 done, might be done, or is an idea that I want to think about
8 Most of the items are marked in the code as well
9 Grep for TODO and ugh/ugr/urg.
12 . * rewrite context defs using Scheme
14 . * header for PS enteredby = "bla <bla@bar.com>"
15 . * ps/lily.ps see comments.
16 . * devise standard for functioning of Vertical_align_element.
17 . * staff size for post/prebreaks
19 . * input/star-spangled-banner
20 . * m=\notes\relative c'''{
23 R2*4 | c2 | c2 | c2 | c2 | c2 | c2 | c2 | c2 | c2 | \break
24 <{R2*10}{s2 \mark "A"; }> | % Too narrow space for the first rest in
27 [ ) g8-. fis16 ( g ][ ) fis8-. f16 ( g ] |
28 [ ) f8-. e16 ( f ][ ) e8-. es16 ( f ] |
29 [ ) es8 \f c16 ( d][es8 d16 c ] |
30 ) d4 r8 [g16 \p ( a ] |
31 [ ) g8-. fis16 ( g ][ ) fis8-. f16 ( g ] | \break
32 ) c2 | c2 | c2 | c2 | c2 | c2 | c2 | c2 | c2 |
43 \OrchestralPartStaffContext
48 . * P.P.S. It can be cool in mudela-book to distinguish in
49 pre,postMudelaExample, whether MudelaExample is epsed or not: ( if
50 this fragment is floating eps, than 1, otherwise 2). say
51 preMudelaExample[eps]{}, and change it in document body sometimes.
52 . * fix singleStaffBracket
53 . * declare performers in \midi
55 . * \shape 1st dim skipped?
56 . * turn slope-damping on/off
58 . * fix height of / collisions with lyrics (chords),
59 see input/test/vertical-text.ly; input/test/repeat.ly
60 . * We need feta-din*.mf files for more sizes than 10.
61 . * fix dynamics decently, ie. use kerning & ligatures.
62 . * dots & rest collisions?
64 . * fix \mudelafile{} to have decent functionality
66 . * support_l_arr_ empty in staff-margin's G_staff_side_item
67 . * slurs colllide with lyrics.
68 . * Is there any reasonable way to do this: I would like to have one file
69 that can generate the same tune in two different modes without having
70 to go through and rewrite all the music in the other mode.
72 Long lyrics don't get a space at the end. They just run right up
73 against the next lyric. (I don't think this used to be the case.)
75 Lyrics and scripts collide.
77 \key b; \time 4/4; looks bad. The clef and time signature are too close.
79 I noticed that ledger lines in the previewer looked like they had a
80 double line (of different lengths). On printed output, I think I can
81 see a slight thickening of the ledger lines in the middle. Is this
84 restStyle=mensural doesn't seem to work (lots of characters not found
86 . * Phrasing: Indicating the textual underlay of a piece, or
87 otherwise dividing a piece into phrases.
89 There are distinct ways of specifying the first two (although at
90 present, they're not properly distinguished) but no distinct way to
91 specify the third. Should there be?
92 . * spacing of mmrests.
93 . * rest collision minimum dist.
95 . * spacing for prefatory matter
96 . * The line length is 7.5 inch (19.05
97 > cm) and the height of normal size is equivalent to the traditional raster 1
98 > size. (The Schott company sells Letraset sheets of musical symbols which are
99 > measured in raster sizes). It is agreed among most engravers I know that the
100 > standard size for adult readers in solo music should 70% of raster 1. Jeff's
101 > example was 75%, so I had to modify my file to match.
103 So that makes for a staff space of 4 2/3 point. I'll add the
104 dimensions to the TODO file.
105 . * accidentals closer to note head
113 . * Rhythmic_grouping
115 . * Spring generation
120 . * \selectmusic to cut pieces from music.
121 . * Morally pure LilyPond.
122 . * Remove mutopia ramblings.
123 . * Remove non-free software links.
124 . * Remove meta article LilyPond.
125 . * generic rest ledgers
126 . * TODO: merge atom & molecule; make tree from molecule.
127 . * break priority setting from SCM.
129 . * remove [] in favour of auto-beamer
130 . * The minimum distance between different staffs works only within
131 StaffGroups, not between StaffGroups. The Gade Score looks quite
132 strange on the pages where the Timpani and/or Brass sections don't
133 play. I've set the minimum distance with:
135 \OrchestralScoreContext
136 minVerticalAlign = 2.5*\staffheight;
138 . * hangOnClef with non-breakable clefs.
139 . * Aha, the problem is the new TeX code generation for changing fonts.
140 > (The explanation below is mostly intended for Han-Wen and Jan)
141 > Before, the font was changed with macros declared separately for
142 > pure TeX and LaTeX, but now all the fonts are declared directly in
143 > the generated code using the low-level TeX commands. This circumvents
144 > the fontencoding mechanism of LaTeX and is a potential source of
145 > problems also for us users of the Latin-1 character set.
146 > I think it still works since the inputencoding latin1 is
147 > declared by ly2dvi, but it still means that e.g. an o with
148 > umlaut is typeset as a combination of the two symbols 'o' and
149 > 'umlaut' instead of as a single character, as would be the case
150 > if fontencoding OT1 had been used. This shouldn't give any
151 > difference in layout, though. One of the main argument for using
152 > fontencoding OT1 is for the hyphenation mechanism to work, an
153 > argument that's clearly irrelevant in our application. Yet we
154 > see the problem for August.
155 . * Check gcc 2.8.1 compatibility
156 . * Abstraction for engravers:
157 . * make "in-between" engraver (Tie, Extender)
158 . * make wide_spanner_engraver (line_group_spanne,r staff_symbol)
159 . * remove Interval dim_ from Dimension_cache and rename the struct.
160 . * do scaled fonts generally
161 . * The Lilypond accidental symbols are available through the TeX macros,
162 \textflat, \textsharp and \textnatural defined in the init file
163 lilyponddefs.tex. All the symbols are defined in the files fetaXX.tex
164 where XX corresponds to the size. I don't know where (or even if) they
165 are installed but they are generated in the mf/out/ directory during the
167 . * make dependencies () a virtual function.
168 . * fix Repeated_music design
169 . * one big ly2dvi input that includes *all* tests.
170 . * store req -> element, element -> element causes for warnings
171 . * include examples in RPM.
172 . * fix partial measures in meaningful way.
173 . * add scripts to bars eg. |^"bla"
174 . * relative mode for mi2mu
175 . * uniformise recent feta contributions.
176 . * use SCM and Molecules for {accordeon stuff, }
177 . * bigger and fatter 4/4 C
178 . * sort out directory stuff.
180 . * -I option per filetype?
182 . * ly2dvi/lilypond logfile.
183 . * fractional chord durs.
184 . * hang Item on Spanner
185 . * do --safe for PS output?
186 . * convert-mudela --output
187 . * Staff_margin (with a partial measure.)
188 . * fix pletvisibility properties:
189 . * bracket on/off/no-bracket-when-beam
190 . * num on/off/no-num-when-beam
192 . * junk text{sharp,flat,etc}
193 . * fix convert-mudela manpage
194 . * decimal point in \paper {}
195 . * { \voiceone <a'4.*2/3 d''4.*2/3 fis''4.*2/3> [g''8 fis'' e''] d''4 |}
197 { \voicetwo d'4 d'2.*2/3 } spacing
198 . * tied notes for MIDI
199 . * sharp / flat on trills (in MIDI ??)
200 . * scm-ify \property values.
201 . * move class Lookup {} into scm
203 . * \breathmark TeX macro
204 . * add new glyphs to font.ly
205 . * formatting of input stuff.
206 . * \notes{ a \< b \cr } vs \notes{ a \< b \! }
207 . * space after bars?
208 . * 'hinterfleisch' before bar (e.g. wtk1-fugue2)?
209 . * Summary of minor spelling irregularities:
210 . * capitalization/use of underscores in property names
211 . * fix SkipBars -> skipBars
213 lbheel = \script { "bheel" 0 0 -1 0 0 }
214 rbheel = \script { "bheel" 0 0 1 0 0 }
215 lbtoe = \script { "btoe" 0 0 -1 0 0 }
216 rbtoe = \script { "btoe" 0 0 1 0 0 }
217 lfheel = \script { "fheel" 0 0 -1 0 0 }
218 rfheel = \script { "fheel" 0 0 1 0 0 }
219 lftoe = \script { "ftoe" 0 0 -1 0 0 }
220 rftoe = \script { "ftoe" 0 0 1 0 0 }
222 portato= \script { "portato" 0 -1 0 1 0 }
224 . * bottomnote for ly2dvi
227 . * compulsory hshift
228 . * Give # lines in linebreaking.
230 . * Align_element::padding ?
231 . * uniformise property names...
232 . * ydirection <-> yDirection
233 . * rather allow '_' in identifiers first (i.e. junk ^ and _),
235 . * typo checks on property names?
236 . * use streambufs and iostream
237 to provide IO handling for TeX stream, mudela stream, data-file.
238 . * seriously buffer TeX output (do profile of writing .5 mb TeX file.)
239 . * strip EXEs before installing
240 . * zip target for binary windows dist (JBR)
241 . * junking \skip req in lyrics
242 . * mi2mu empty staffs.
243 . * use Fourier transformation for rhythmic quantisation.
244 . * horizontal centering of dynamics
245 . * $DEPENDENCIES_OUTPUT support
246 . * Xdvi zooming ?! Try to understand GS garbage collection.
247 gs: Error: /undefined in draw_beam
249 . * fix vertical alignment and stafflines
250 . * declaring Performers
251 . * *.yo: fix pod manpage layout legacy
252 . * text-items clash with stems/beams
253 . * --include, -I option for ly2dvi (pass on to lily)
254 . * fix placement of beam-less abbrev
256 <{\voiceone cis4. cis8 cis4 | cis4 cis cis | r1 }
257 {\voicetwo cis,4 r r | r2. | r1 }> |
259 . * Musical_pitch (analogous to Duration and Rhythmic_req)
260 think about, analogous to pitch:
261 * { a4 a16 } c <-- duration of c?
262 * < a4 b8 > c <-- duration of c?
264 . * fix audio-items (don't use (input) requests, but copy data)
265 . * make sure all ex's have a mudela-version
266 . * do rest-collisions for Multi_measure_rests as well.
267 . * split error/warning in error/warning/non_fatal_error
268 . * add a Duration_convert member to Duration_iter to set parameters.
269 Junk global duration settings.
270 . * en-,discouraged linebreaking:
271 . * handle DISALLOW < penalty > FORCE
272 . * discourage breaking of slurs
273 . * fix variable define/lookup parser global<->paper
274 . * fix title/instrument placements; see input/test/title.ly
275 . * <\voiceone c4. \voicetwo c4>
276 . * add full cello suites to web site (kom op, Maarten!)
277 . * Rethink Time_description
278 \cadenza , \meter, \grouping should all be \properties
281 . * abbrev -> tremolo
282 . * abbreviation-beam -> (measured/unmeasured) tremolo
283 . * partial -> anacrouse
284 . * robustify Beam (in case of no stems, 32nd notes)
285 . * move paper vars into engraver properties
286 . * check for groff / troff/ nroff et
287 . * more intelligent file searching
288 . * disable spaces in TeX stuff
289 . * handle ^C for tmp/file creation.
290 . * make LilyPond RPM fully relocatable
291 . * dots & rest collisions.
292 . * the warning about the negative slur/tie length appears twice
294 . * better hshift (dots, distance, head dependent)
295 . * clefs (AG): The "8" should appear closer to the actual clef,
297 . * put errorlevel in Input class
298 . * junk nesting slurs
299 . * integrate midi-elts from mi2mu and lily?
302 . * the bracket is ugly (wings are too parabolic, should be more circular)
303 . * versioning for Feta
304 . * rewrite dynamic signs. They're kind of spaghetti now.
305 . * The `3' in the meter key is a one or two pixels too thin (at 600dpi)
307 . * design macro for penstroke with rounded endings
308 . * timesig C: fat yet less curved. Check out relations.
309 . * design decent macro for bulbed endings
310 . * printer dependencies.
311 . * y-refpoint for rests should be the 4th staffline (gclef: b')
312 . * clean-up eight+ rests
315 . * work out sizes of character fonts.
317 . * piano pedals: Ped/*
319 . * coda signs: Segno, O+
320 . * glissando, arpeggio
322 . * include important spacing dims in fetalog
324 . * GNU diff 2.7: diff -rN does not see a new directory with empty file
325 . * check out GCC signatures?
327 f = fopen ("/dev/null", "r")
330 . * tetex: mfplain.mem
331 .* 3RD PARTY PROJECTS:
332 . * make GCC warn about ctor that leaves member vars uninitialised.
334 . * 'double-fix' mode: ignore identical fix, rather than suggest
335 to revert patch direction when (more or less? exactly) the same
339 . * stack scripts in chords:
340 % fingering: footing:
341 < a-4 c-2 g-1 > < c-\ltoe e-\lheel >
343 . * slur parts as a script
344 . * stack parameterised scripts for fingering and footing:
347 . * automatically add a \version if not present.
350 . * convert-mudela -e empty.ly
352 . * emacs mudela-mode
353 . * should handle block comments too.
354 . * handle lexer modes (\header, \melodic, \lyric) etc.
357 . * fontlock: \melodic \melodic
359 . * use properties for:
365 . * optimal pagebreaking.
367 . * Unicode support? -> man 7 unicode
370 . * detect of 16/8 bit files
371 . * examples to go with it.
374 . * write a faster Spring_spacer (without matrices if possible)
375 . * relate energybound to linelen unitspace fontsize etc.
376 . * used fixed point fp?
379 . * output header info to MIDI too.
381 . * a musical dictionary. See Documentation/vocabulary-*, other
391 . * guitar chords (fret diagrams)
392 . * other chord name styles (american(?) style)
397 . * derive lily_stream, Dstream, texstream from ostream?
398 . * indentable stream as baseclass for TeX stream, lily stream, Dstream.
399 . * use dstream feature in mi2mu
400 . * integrate IO checking into stream class
407 . * add to MIDI output:
409 . * ornaments (and trills?)
414 > Would it be hard to add support for proper dynamics in MIDI output? I
415 > would really like to have this feature...
417 To answer this, I have to give a little background. Please say so if
420 Both audio and notation elements are created decentrally, when
421 LilyPond says "Interpreting music ... [8][16] etc." After all
422 elements are created, they are processed again to calculate all
423 parameters. After that is done, they are dumped onto the output (the
424 MIDI stream or the TeX file).
426 The audio and notation elements are created by objects called
427 performer and engraver respectively. They work by taking a chunk of
428 input (a so-called request), and using the request to create an audio
431 After some processing, the engraver sends the created elements to
432 its enclosing notation/performance context.
434 In the case of notation, engravers can also modify existing elements
435 created by sibling engravers. Eg. the beam-engraver will modify stems
436 when it creates a beam over a couple of stems. This is done in
437 Engraver::do_acknowledge_element () and
438 Engraver::do_process_acknowledged ().
440 In the case of audio, there are no mechanisms to modify existing audio
441 elements. After the audio elements are created, they are sent directly
442 to the enclosing context (an instance of Performer_group_performer),
443 through the method Performer::play ()
445 Concretely spoken, for dynamics you have to write a performer
446 (Dynamics_performer), that will take the input requests. If I
447 understand correctly, every MIDI note played must have its dynamic
448 strength set separately. That means the the Dynamics_performer must
449 set the strength of every Audio_note it finds. This means that one
450 has to modify existing Audio items. The best way of doing this is
451 with a broadcast/acknowledge process.
453 So the best way of handling this, is
455 1 supporting dynamic settings in Audio_note
457 2 mimicking the broadcast/acknowledge mechanism of the Engravers in
460 3 using that mechanism to write a Dynamics_performer that will modify
461 any notes it finds to set appropriate strengths.
463 You could also kludge this by deriving from Performer_group_performer
464 a performer that also sets dynamics within notes, but that is not the
465 elegant way to do it.
467 I'd say that the work involved is not hard, but you have to be fluent
468 with C++ and need some insight into the working of Notation Contexts
469 and friends. I guess I could do it in a day or so, but if you are not
470 so fluent with the inner workings of LilyPond, it could take you some
471 more time (A few more days?).
473 Please note, that I am *not* going to code this myself: my days are
474 valuable, and I think I have more interesting things to do than fixing
475 the MIDI output (I don't even have a soundcard). But I *do* want to help
476 you or other people with implementing this, so if you need help, don't
479 . * account for rhythmic position in measure
483 . * make separate class for Grace_*_engravers
484 (which is at Voice_gravs level)
485 . * make encapsulated spacing problems.
487 . * accidentals per Voice_group
489 . * Output class, handles : (smallish)
490 . * help text /(c) notice?
492 . * warning /errors/progress
493 . * abort on error/warning; exit status
494 . * quiet/ignore-version options
498 . * speed up PS code.
499 . * PS lines to .eps files
500 . * write custom prolog
505 . * remove links to non-free SW.
506 . * internal documentation
509 . * left/rightbeamcount
510 . * various other new properties.
515 . * Doc (C) stuff of sheet music
516 . * a better format? SGML? TeX? Info?
517 . * a better tutorial
519 . * more spanners (smallish)
523 . * Rewrite Stem, Beam and Rhythmic_grouping (hairy)
525 . * doc on Rhythmic_grouping
526 . * general shaving on Beam and Stem
527 . * use plet grouping
528 . * separate visual from rhythmic info even more
532 . * Ledger lines, should be separate item: Ledger_lines
533 . * set different line sizes / thicknesses
534 . * beam stem showthrough, inter beam sizes (french vs german style)
537 . * left/right note balls should be handled by Collision:
538 < \multi 2; { \stem 1; <b c> } { <f as b> } >
541 . * merge key{item} & localkey{item}?
542 . * spacing, national styles?
545 . * redo Notehead to allow digits as heads
546 . * add a \tablature {} lexer mode for easy entering
548 . * should adjust stemlength for flag number.
551 . * caching breakpoints
553 . * specify number of lines
556 . * \rhythms 4 16 16 16 16; c c c c c -> c4 c16 etc.
560 . * \bla {} vs \bla ;
561 . * mix engraver hacking with music ?
562 . * \once\property KEY = VAL
563 . * \addtranslator, \removetranslator
564 . * junk ^ and _ for scripts
565 . * junk _ for lyrics.
566 . * abstract grammar.
567 . * Figure out semicolons.
568 . * c4 4 4 4 for c4 c4 c4 c4?
579 . * configure pitch_byte
580 . * rest name configurable
585 . * Faulenzer sign (% repeat)
587 . * fix confusing naming in Engraver vs Engraver_group_engraver (context)
589 . * progress when creating MIDI elts.
591 . * A range for context errors (eg. mark both { and }. )
593 . * lyric in staff (sharpsharp in staff, text below)
595 . * half sharps/flats
597 . * write Dynamic_line (to group dynamics horizontally)
599 . * use Real for all y positions.
601 . * half-sharps, half-flats
603 . * adaptive accidental spacing.
605 . * handle EOF graciously in error messages.
607 . * midi esp.: use I32 iso int where 32 bits are needed (or assumed...)
609 . * stafftypes: voice names/ instrument names.
613 . * % toe to bheel four to five
619 (where "to" is a tiny bow)
621 . * auxilliary file for caching info.
628 . * Output data structures of Mudela in XML/SGML.
629 . * create libmudela, or liblily_frontend
630 . * move MIDI stuff (including Quantization) to a ANSI C libmidi library.
631 . * Spacing_request for manually adjusting spacing
632 . * caching breakpoints
633 . * used fixedpoint arithmetic for min. energy.
634 . * move towards incremental algorithms.
635 . * versioning stuff (cvt mudela, mudela, etc.)
636 . * dynamic loading of engravers?
638 Han-Wen Nienhuys <hanwen@cs.uu.nl> writes:
641 > Foo_smob *smob_ptr_;
645 > Foo_class *class_ptr_
648 Usually you can get away without having this interlinked structure.
649 One piece of information you need when exporting objects to scheme is
650 the smob tag for your class. You might store this value (a long) into
651 a class static variable, or a file static variable. I'll use a class
652 static variable in this example.
654 I typically use code that works like this (untested code ahead):
657 static long *Foo_smob_tag;
658 SCM obj; // representation as a scheme object, description comes later
661 // call this once on startup
662 void init_Foo_class {
663 static scm_smobfuns type_rec;
665 type_rec.mark = foo_mark;
666 type_rec.free = foo_free;
667 type_rec.print = foo_display;
669 Foo_class::Foo_smob_tag = new int(scm_new_smob(type_rec));
672 When you want to export an object to scheme, you put a pointer to the
673 object itself in the cdr of the cell, and the tag in the car of the
674 cell. The code looks like this:
680 return(SCM_NIMP(obj) && SCM_CAR(obj) == Foo_class::Foo_smob_tag);
683 // given a Scheme representation, return, a C++ representation
687 return((Foo_class*)SCM_CDR(obj));
690 // the SCM representation of the object is stored inside itself
691 // this will become useful when destructor gets called
693 foo_box(Foo_class *foo)
696 SCM_NEWCELL(foo->obj);
697 SCM_SETCAR(foo->obj, Foo_class::Foo_smob_tag);
698 SCM_SETCDR(foo->obj, (SCM)foo);
703 > C++ determines life time, so what is the strategy?
705 What happens now when the destructor gets called? Lets set the cdr to
706 NULL, and then check for that in all of the primitive functions that
707 use your smob. We'll call this notion 'live'; a scheme object is
708 'live' if the C++ representation still exists, it's dead if the C++
709 object is gone. You can still have references to dead objects in
710 scheme code; it's just an error to use them. This idea is stolen from
711 Emacs's handling of buffers ('buffer-live-p' and friends).
713 Add another function, foo_live_p:
718 return(foo_p(obj) && SCM_CDR(obj) != NULL);
721 In you destructor, you need to do:
725 SCM_CDR(this->obj, NULL);
728 When writing new primitives, now just check foo_live_p().
730 I hope the above helps,
736 (defvar outline-font-lock-keywords
737 '(;; Highlight headings according to the level.
738 ;; must change this to allout node layout
739 ;;("^\\(\\*+\\)[ \t]*\\(.+\\)?[ \t]*$"
740 ("^\\([.]*[ ]*[*]\\)[ \t]*\\(.*\\)$"
741 (1 font-lock-string-face)
742 (2 (let ((len (- (match-end 1) (match-beginning 1))))
743 (or (cdr (assq len '((1 . font-lock-function-name-face)
744 (2 . font-lock-keyword-face)
745 (3 . font-lock-comment-face))))
746 font-lock-variable-name-face))
748 ;; Highlight citations of the form [1] and [Mar94].
749 ("\\[\\([A-Z][A-Za-z]+\\)*[0-9]+\\]" . font-lock-type-face))
750 "Additional expressions to highlight in Outline mode.")
752 (add-hook 'outline-mode-hook
754 (setq font-lock-maximum-decoration t)
755 (setq font-lock-maximum-decoration t)
756 (make-local-variable 'font-lock-defaults)
757 (setq font-lock-defaults '(outline-font-lock-keywords t))
758 (font-lock-mode global-font-lock-mode)