Documentation/nl/notation/input.itely

   1 \input texinfo @c -*- coding: utf-8; mode: texinfo; documentlanguage: nl -*-
   2 @c This file is part of notation.tely
   3 @ignore
   4     Translation of GIT committish: 1b3da70d81938d19a2b107382bbe25a267cf130b
   5
   6     When revising a translation, copy the HEAD committish of the
   7     version that you are working on.  See TRANSLATION for details.
   8 @end ignore
   9
  10
  11 @c -*- coding: utf-8; mode: texinfo; -*-
  12 @c \version "2.12.0"
  13 @node General input and output
  14 @chapter General input and output
  15
  16 @untranslated
  17
  18
  19 @menu
  20 * Input structure::
  21 * Titles and headers::
  22 * Working with input files::
  23 * Controlling output::
  24 * MIDI output::
  25 @end menu
  26
  27 @node Input structure
  28 @section Input structure
  29
  30 @untranslated
  31
  32
  33 @menu
  34 * Structure of a score::
  35 * Multiple scores in a book::
  36 * File structure::
  37 @end menu
  38
  39 @node Structure of a score
  40 @subsection Structure of a score
  41
  42 @untranslated
  43
  44
  45 @ref{File structure}.)  Both single-line comments and comments
  46 @c ode{\score} block.
  47 @node Multiple scores in a book
  48 @subsection Multiple scores in a book
  49
  50 @untranslated
  51
  52
  53 @c index movements, multiple
  54 @c ode{\book} block will result in a separate output.  If you do not
  55 @c ode{\book}, but if it is not present, the @code{\header} which is at
  56 @node File structure
  57 @subsection File structure
  58
  59 @untranslated
  60
  61
  62 @c ode{\layout}.  Such a definition at the toplevel changes the default
  63 @c ode{#(set-default-paper-size "a7" 'landscape)} or
  64 @c ode{#(ly:set-option 'point-and-click #f)}.
  65 @c ode{toplevel-score-handler} at toplevel.  The default handler is
  66 @c ode{\book} blocks in a @code{.ly} file is if you wish to create
  67 @c ode{toplevel-music-handler} at toplevel.  The default handler is
  68 @c index variables
  69 @c index whitespace
  70 @c ode{\override} and @code{\set} commands.  In particular, spaces
  71 @c ode{\override Score . LyricText #'font-size = #5} and before and
  72 @node Titles and headers
  73 @section Titles and headers
  74
  75 @untranslated
  76
  77
  78 @menu
  79 * Creating titles::
  80 * Custom titles::
  81 * Reference to page numbers::
  82 * Table of contents::
  83 @end menu
  84
  85 @node Creating titles
  86 @subsection Creating titles
  87
  88 @untranslated
  89
  90
  91 @c ode{\bookpart} blocks).
  92 @c index page breaks, forcing
  93 @c ode{\header} inside @code{\score}) by using
  94 @c index copyright
  95 @c index tagline
  96 @c ode{copyright} field from @code{\header} is inserted, and the last
  97 @node Custom titles
  98 @subsection Custom titles
  99
 100 @untranslated
 101
 102
 103 @c index \paper
 104 @c index header
 105 @c index footer
 106 @c index page layout
 107 @c index titles
 108 @node Reference to page numbers
 109 @subsection Reference to page numbers
 110
 111 @untranslated
 112
 113
 114 @c ode{\label},
 115 @c ode{\page-ref}.
 116 @node Table of contents
 117 @subsection Table of contents
 118
 119 @untranslated
 120
 121
 122 @c ode{\table-of-contents},
 123 @c ode{\tocItem}.
 124 @node Working with input files
 125 @section Working with input files
 126
 127 @untranslated
 128
 129
 130 @menu
 131 * Including LilyPond files::
 132 * Different editions from one source::
 133 * Text encoding::
 134 * Displaying LilyPond notation::
 135 @end menu
 136
 137 @node Including LilyPond files
 138 @subsection Including LilyPond files
 139
 140 @untranslated
 141
 142
 143 @c index including files
 144 @c ode{\include} statements are not interpreted until they have
 145 @c ode{-drelative-includes} option at the command line
 146 @node Different editions from one source
 147 @subsection Different editions from one source
 148
 149 @untranslated
 150
 151
 152 @menu
 153 * Using variables::
 154 * Using tags::
 155 @end menu
 156
 157 @node Using variables
 158 @unnumberedsubsubsec Using variables
 159
 160 @untranslated
 161
 162
 163 @c index variables, use of
 164 @node Using tags
 165 @unnumberedsubsubsec Using tags
 166
 167 @untranslated
 168
 169
 170 @c index tag
 171 @c index keep tagged music
 172 @c index remove tagged music
 173 @c ode{\removeWithTag #'@var{name}}.  The result of applying these filters
 174 @c ode{\removeWithTag}
 175 @c ode{\removeWithTag} commands should be a symbol
 176 @c ode{\tag} entries:
 177 @ref{Automatic part combining},
 178 @ref{Including LilyPond files}.
 179 @c This warning is more general than this placement implies.
 180 @c Rests are not merged whether or not they come from tagged sections.
 181 @c Should be deleted?  -td
 182 @node Text encoding
 183 @subsection Text encoding
 184
 185 @untranslated
 186
 187
 188 @c index Unicode
 189 @c index UTF-8
 190 @c index non-ASCII characters
 191 @c ode{\markup} block, where @code{hhhh} is the hexadecimal code for
 192 @c index copyright sign
 193 @node Displaying LilyPond notation
 194 @subsection Displaying LilyPond notation
 195
 196 @untranslated
 197
 198
 199 @c TODO What happens under Windows?
 200 @node Controlling output
 201 @section Controlling output
 202
 203 @untranslated
 204
 205
 206 @menu
 207 * Extracting fragments of music::
 208 * Skipping corrected music::
 209 * Alternative output formats::
 210 @end menu
 211
 212 @node Extracting fragments of music
 213 @subsection Extracting fragments of music
 214
 215 @untranslated
 216
 217
 218 @c ode{-dclip-systems}.  The clips are output as EPS files, and are
 219 @node Skipping corrected music
 220 @subsection Skipping corrected music
 221
 222 @untranslated
 223
 224
 225 @node Alternative output formats
 226 @subsection Alternative output formats
 227
 228 @untranslated
 229
 230
 231 @c index scalable vector graphics output
 232 @c index SVG output
 233 @c index encapsulated postscript output
 234 @c index EPS output
 235 @node MIDI output
 236 @section MIDI output
 237
 238 @untranslated
 239
 240
 241 @c index Sound
 242 @c index MIDI
 243 @c TODO Check this
 244 @menu
 245 * Creating MIDI files::
 246 * MIDI block::
 247 * What goes into the MIDI output?::
 248 * Repeats in MIDI::
 249 * Controlling MIDI dynamics::
 250 * Percussion in MIDI::
 251 @end menu
 252
 253 @node Creating MIDI files
 254 @subsection Creating MIDI files
 255
 256 @untranslated
 257
 258
 259 @c ode{\midi} block to a score, for example,
 260 @c ode{\layout} block, only MIDI output will be produced.  When
 261 @c ode{.midi}.
 262 @unnumberedsubsubsec Instrument names
 263 @c index instrument names
 264 @c ode{Staff.midiInstrument} property to the instrument name.
 265 @c In 2.11 the following no longer seems to be a problem -td
 266 @node MIDI block
 267 @subsection MIDI block
 268
 269 @untranslated
 270
 271
 272 @c index MIDI block
 273 @c index MIDI context definitions
 274 @c ode{\midi@{ @}} block.
 275 @node What goes into the MIDI output?
 276 @subsection What goes into the MIDI output?
 277
 278 @untranslated
 279
 280
 281 @c TODO Check grace notes - timing is suspect?
 282 @unnumberedsubsubsec Supported in MIDI
 283 @c index Pitches in MIDI
 284 @c index MIDI, Pitches
 285 @c index Quarter tones in MIDI
 286 @c index MIDI, quarter tones
 287 @c index Microtones in MIDI
 288 @c index MIDI, microtones
 289 @c index Chord names in MIDI
 290 @c index MIDI, chord names
 291 @c index Rhythms in MIDI
 292 @c index MIDI, Rhythms
 293 @c TODO etc
 294 @unnumberedsubsubsec Unsupported in MIDI
 295 @c TODO index as above
 296 @node Repeats in MIDI
 297 @subsection Repeats in MIDI
 298
 299 @untranslated
 300
 301
 302 @c index repeats in MIDI
 303 @c ode{\unfoldRepeats} music function.  This function changes all
 304 @node Controlling MIDI dynamics
 305 @subsection Controlling MIDI dynamics
 306
 307 @untranslated
 308
 309
 310 @unnumberedsubsubsec Dynamic marks
 311 @c ode{Score.dynamicAbsoluteVolumeFunction} to this function.
 312 @c ode{\rfz}, is required, this will not by default
 313 @unnumberedsubsubsec Overall MIDI volume
 314 @c ode{midiMaximumVolume} at the @code{Score} level.  These
 315 @unnumberedsubsubsec Equalizing different instruments (i)
 316 @unnumberedsubsubsec Equalizing different instruments (ii)
 317 @c ode{instrumentEqualizer} in the @code{Score} context to a new
 318 @c ode{dynamicAbsoluteVolumeFunction} at the start of this section.
 319 @c Delete when satisfied this is adequately covered elsewhere -td
 320 @c index microtones in MIDI
 321 @node Percussion in MIDI
 322 @subsection Percussion in MIDI
 323
 324 @untranslated
 325
 326
 327 @c ode{DrumStaff} context, to obtain the correct MIDI output.
 328 @c TODO Expand with examples, and any other issues
 329
 330 @c -- SKELETON FILE --