X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fsnippets%2Fdisplaying-grob-ancestry.ly;h=1ff068dbb36d8896b61b80472135d53e84ee09fb;hb=f22c889b1389cb7d761580762fe77973780f2f86;hp=e34cbe2f119f898e582ee5bcf111c04a62906e2d;hpb=22d889f4d27469864c31db81445e9de49774ae23;p=lilypond.git diff --git a/Documentation/snippets/displaying-grob-ancestry.ly b/Documentation/snippets/displaying-grob-ancestry.ly index e34cbe2f11..1ff068dbb3 100644 --- a/Documentation/snippets/displaying-grob-ancestry.ly +++ b/Documentation/snippets/displaying-grob-ancestry.ly @@ -1,109 +1,29 @@ -% Do not edit this file; it is automatically -% generated from Documentation/snippets/new -% This file is in the public domain. -%% Note: this file works from version 2.13.10 -\version "2.13.18" +%% DO NOT EDIT this file manually; it is automatically +%% generated from LSR http://lsr.dsi.unimi.it +%% Make any changes in LSR itself, or in Documentation/snippets/new/ , +%% and then run scripts/auxiliar/makelsr.py +%% +%% This file is in the public domain. +\version "2.14.2" \header { -%% Translation of GIT committish: d2119a9e5e951c6ae850322f41444ac98d1ed492 - - texidoces = " -Al trabajar con los callbacks de un grob, puede ser de mucha ayuda -entender el @qq{árbol genealógico} de un grob. La mayor parte de los -grobs tienen @qq{padres} que influyen en el posicionamiento del grob. -los padres X e Y influyen en las posiciones horizontal y vertical del -grob, respectivamente. Además, cada pade puede tener padres a su vez. - - -Por desgracia, existen varios aspectos de la genealogía de un grob que -pueden llevar a confusión: - - -@itemize - -@item Los tipos de padre que tiene un grob pueden depender del -contexto. - -@item Para ciertos grobs, los padres X e Y son el mismo. - -@item Un @qq{ancestro} concreto puede estar relacionado con un grob de -mas de una manera. - -@item El concepto de @qq{generaciones} es engañoso. - -@end itemize - - -Por ejemplo, el grob @code{System} puede ser tanto un padre (sobre el -lado Y) como un abuelo (dos veces en el lado X) de un grob -@code{VerticalAlignment}. - - -Este macro imprime, en la consola, una representación textual de la -genealogía de un grob. - - -Cuando se llama de esta forma - -@example -@{ - \\once \\override NoteHead #'before-line-breaking = #display-ancestry - c4 -@} -@end example - - -Se genera la siguiente salida: - - -@example ------------------------------------- - -NoteHead X,Y: NoteColumn - X: PaperColumn - X,Y: System - Y: VerticalAxisGroup - X: NonMusicalPaperColumn - X,Y: System - Y: VerticalAlignment - X: NonMusicalPaperColumn - X,Y: System - Y: System -@end example - -" - - doctitlees = "Imprimir el árbol genealógico de un grob" - - lsrtags = "tweaks-and-overrides" + lsrtags = "scheme-language, tweaks-and-overrides, devel" texidoc = " When working with grob callbacks, it can be helpful to understand a -grob's @qq{ancestry}. Most grobs have @qq{parents} which influence the -positioning of the grob. X- and Y-parents influence the horizontal and -vertical positions for the grob, respectively. Additionally, each +grob's @qq{ancestry}. Most grobs have @qq{parents} which influence the +positioning of the grob. X- and Y-parents influence the horizontal and +vertical positions for the grob, respectively. Additionally, each parent may have parents of its own. Unfortunately, there are several aspects of a grob's ancestry that can lead to confusion: - -@itemize - -@item -The types of parents a grob has may depend on context. - -@item -For some grobs, the X- and Y-parents are the same. - -@item -A particular @qq{ancestor} may be related to a grob in multiple ways. - -@item -The concept of @qq{generations} is misleading. - -@end itemize +* The types of parents a grob has may depend on context. * For some +grobs, the X- and Y-parents are the same. * A particular @qq{ancestor} +may be related to a grob in multiple ways. * The concept of +@qq{generations} is misleading. For example, the @code{System} grob can be both parent (on the Y-side) @@ -117,18 +37,15 @@ ancestry. When called this way -@example + @{ - \\once \\override NoteHead #'before-line-breaking = #display-ancestry - c4 -@} -@end example + \\once \\override NoteHead #'before-line-breaking = #display-ancestry + c @} The following output is generated: -@example ------------------------------------ NoteHead X,Y: NoteColumn @@ -141,14 +58,13 @@ NoteHead X,Y: NoteColumn X: NonMusicalPaperColumn X,Y: System Y: System -@end example + " doctitle = "Displaying grob ancestry" } % begin verbatim - #(define (grob-name grob) (if (ly:grob? grob) (assoc-ref (ly:grob-property grob 'meta) 'name) @@ -192,11 +108,10 @@ NoteHead X,Y: NoteColumn (format #f "~&"))) #(define (display-ancestry grob) - (display - (string-append - (format #f "~3&~a~2%" (make-string 36 #\-)) - (format-ancestry (get-ancestry grob) 0) - (format #f "~2&")))) + (format (current-error-port) + "~3&~a~2%~a~&" + (make-string 36 #\-) + (format-ancestry (get-ancestry grob) 0))) \relative c' { \once \override NoteHead #'before-line-breaking = #display-ancestry