You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

1511 lines
73KB

  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="UTF-8">
  5. <meta http-equiv="X-UA-Compatible" content="IE=edge">
  6. <meta name="viewport" content="width=device-width, initial-scale=1.0">
  7. <meta name="generator" content="Asciidoctor 2.0.12">
  8. <meta name="author" content="Laborejo Software Suite">
  9. <title>Vico</title>
  10. <style>
  11. /* Asciidoctor default stylesheet | MIT License | https://asciidoctor.org */
  12. /* Uncomment @import statement to use as custom stylesheet */
  13. /*@import "https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400,700";*/
  14. article,aside,details,figcaption,figure,footer,header,hgroup,main,nav,section{display:block}
  15. audio,video{display:inline-block}
  16. audio:not([controls]){display:none;height:0}
  17. html{font-family:sans-serif;-ms-text-size-adjust:100%;-webkit-text-size-adjust:100%}
  18. a{background:none}
  19. a:focus{outline:thin dotted}
  20. a:active,a:hover{outline:0}
  21. h1{font-size:2em;margin:.67em 0}
  22. abbr[title]{border-bottom:1px dotted}
  23. b,strong{font-weight:bold}
  24. dfn{font-style:italic}
  25. hr{-moz-box-sizing:content-box;box-sizing:content-box;height:0}
  26. mark{background:#ff0;color:#000}
  27. code,kbd,pre,samp{font-family:monospace;font-size:1em}
  28. pre{white-space:pre-wrap}
  29. q{quotes:"\201C" "\201D" "\2018" "\2019"}
  30. small{font-size:80%}
  31. sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}
  32. sup{top:-.5em}
  33. sub{bottom:-.25em}
  34. img{border:0}
  35. svg:not(:root){overflow:hidden}
  36. figure{margin:0}
  37. fieldset{border:1px solid silver;margin:0 2px;padding:.35em .625em .75em}
  38. legend{border:0;padding:0}
  39. button,input,select,textarea{font-family:inherit;font-size:100%;margin:0}
  40. button,input{line-height:normal}
  41. button,select{text-transform:none}
  42. button,html input[type="button"],input[type="reset"],input[type="submit"]{-webkit-appearance:button;cursor:pointer}
  43. button[disabled],html input[disabled]{cursor:default}
  44. input[type="checkbox"],input[type="radio"]{box-sizing:border-box;padding:0}
  45. button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}
  46. textarea{overflow:auto;vertical-align:top}
  47. table{border-collapse:collapse;border-spacing:0}
  48. *,*::before,*::after{-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box}
  49. html,body{font-size:100%}
  50. body{background:#fff;color:rgba(0,0,0,.8);padding:0;margin:0;font-family:"Noto Serif","DejaVu Serif",serif;font-weight:400;font-style:normal;line-height:1;position:relative;cursor:auto;tab-size:4;word-wrap:anywhere;-moz-osx-font-smoothing:grayscale;-webkit-font-smoothing:antialiased}
  51. a:hover{cursor:pointer}
  52. img,object,embed{max-width:100%;height:auto}
  53. object,embed{height:100%}
  54. img{-ms-interpolation-mode:bicubic}
  55. .left{float:left!important}
  56. .right{float:right!important}
  57. .text-left{text-align:left!important}
  58. .text-right{text-align:right!important}
  59. .text-center{text-align:center!important}
  60. .text-justify{text-align:justify!important}
  61. .hide{display:none}
  62. img,object,svg{display:inline-block;vertical-align:middle}
  63. textarea{height:auto;min-height:50px}
  64. select{width:100%}
  65. .subheader,.admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{line-height:1.45;color:#7a2518;font-weight:400;margin-top:0;margin-bottom:.25em}
  66. div,dl,dt,dd,ul,ol,li,h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6,pre,form,p,blockquote,th,td{margin:0;padding:0}
  67. a{color:#2156a5;text-decoration:underline;line-height:inherit}
  68. a:hover,a:focus{color:#1d4b8f}
  69. a img{border:0}
  70. p{font-family:inherit;font-weight:400;font-size:1em;line-height:1.6;margin-bottom:1.25em;text-rendering:optimizeLegibility}
  71. p aside{font-size:.875em;line-height:1.35;font-style:italic}
  72. h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{font-family:"Open Sans","DejaVu Sans",sans-serif;font-weight:300;font-style:normal;color:#ba3925;text-rendering:optimizeLegibility;margin-top:1em;margin-bottom:.5em;line-height:1.0125em}
  73. h1 small,h2 small,h3 small,#toctitle small,.sidebarblock>.content>.title small,h4 small,h5 small,h6 small{font-size:60%;color:#e99b8f;line-height:0}
  74. h1{font-size:2.125em}
  75. h2{font-size:1.6875em}
  76. h3,#toctitle,.sidebarblock>.content>.title{font-size:1.375em}
  77. h4,h5{font-size:1.125em}
  78. h6{font-size:1em}
  79. hr{border:solid #dddddf;border-width:1px 0 0;clear:both;margin:1.25em 0 1.1875em;height:0}
  80. em,i{font-style:italic;line-height:inherit}
  81. strong,b{font-weight:bold;line-height:inherit}
  82. small{font-size:60%;line-height:inherit}
  83. code{font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;font-weight:400;color:rgba(0,0,0,.9)}
  84. ul,ol,dl{font-size:1em;line-height:1.6;margin-bottom:1.25em;list-style-position:outside;font-family:inherit}
  85. ul,ol{margin-left:1.5em}
  86. ul li ul,ul li ol{margin-left:1.25em;margin-bottom:0;font-size:1em}
  87. ul.square li ul,ul.circle li ul,ul.disc li ul{list-style:inherit}
  88. ul.square{list-style-type:square}
  89. ul.circle{list-style-type:circle}
  90. ul.disc{list-style-type:disc}
  91. ol li ul,ol li ol{margin-left:1.25em;margin-bottom:0}
  92. dl dt{margin-bottom:.3125em;font-weight:bold}
  93. dl dd{margin-bottom:1.25em}
  94. abbr,acronym{text-transform:uppercase;font-size:90%;color:rgba(0,0,0,.8);border-bottom:1px dotted #ddd;cursor:help}
  95. abbr{text-transform:none}
  96. blockquote{margin:0 0 1.25em;padding:.5625em 1.25em 0 1.1875em;border-left:1px solid #ddd}
  97. blockquote cite{display:block;font-size:.9375em;color:rgba(0,0,0,.6)}
  98. blockquote cite::before{content:"\2014 \0020"}
  99. blockquote cite a,blockquote cite a:visited{color:rgba(0,0,0,.6)}
  100. blockquote,blockquote p{line-height:1.6;color:rgba(0,0,0,.85)}
  101. @media screen and (min-width:768px){h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2}
  102. h1{font-size:2.75em}
  103. h2{font-size:2.3125em}
  104. h3,#toctitle,.sidebarblock>.content>.title{font-size:1.6875em}
  105. h4{font-size:1.4375em}}
  106. table{background:#fff;margin-bottom:1.25em;border:solid 1px #dedede;word-wrap:normal}
  107. table thead,table tfoot{background:#f7f8f7}
  108. table thead tr th,table thead tr td,table tfoot tr th,table tfoot tr td{padding:.5em .625em .625em;font-size:inherit;color:rgba(0,0,0,.8);text-align:left}
  109. table tr th,table tr td{padding:.5625em .625em;font-size:inherit;color:rgba(0,0,0,.8)}
  110. table tr.even,table tr.alt{background:#f8f8f7}
  111. table thead tr th,table tfoot tr th,table tbody tr td,table tr td,table tfoot tr td{line-height:1.6}
  112. h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2;word-spacing:-.05em}
  113. h1 strong,h2 strong,h3 strong,#toctitle strong,.sidebarblock>.content>.title strong,h4 strong,h5 strong,h6 strong{font-weight:400}
  114. .center{margin-left:auto;margin-right:auto}
  115. .stretch{width:100%}
  116. .clearfix::before,.clearfix::after,.float-group::before,.float-group::after{content:" ";display:table}
  117. .clearfix::after,.float-group::after{clear:both}
  118. :not(pre).nobreak{word-wrap:normal}
  119. :not(pre).nowrap{white-space:nowrap}
  120. :not(pre).pre-wrap{white-space:pre-wrap}
  121. :not(pre):not([class^=L])>code{font-size:.9375em;font-style:normal!important;letter-spacing:0;padding:.1em .5ex;word-spacing:-.15em;background:#f7f7f8;-webkit-border-radius:4px;border-radius:4px;line-height:1.45;text-rendering:optimizeSpeed}
  122. pre{color:rgba(0,0,0,.9);font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;line-height:1.45;text-rendering:optimizeSpeed}
  123. pre code,pre pre{color:inherit;font-size:inherit;line-height:inherit}
  124. pre>code{display:block}
  125. pre.nowrap,pre.nowrap pre{white-space:pre;word-wrap:normal}
  126. em em{font-style:normal}
  127. strong strong{font-weight:400}
  128. .keyseq{color:rgba(51,51,51,.8)}
  129. kbd{font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;display:inline-block;color:rgba(0,0,0,.8);font-size:.65em;line-height:1.45;background:#f7f7f7;border:1px solid #ccc;-webkit-border-radius:3px;border-radius:3px;-webkit-box-shadow:0 1px 0 rgba(0,0,0,.2),0 0 0 .1em white inset;box-shadow:0 1px 0 rgba(0,0,0,.2),0 0 0 .1em #fff inset;margin:0 .15em;padding:.2em .5em;vertical-align:middle;position:relative;top:-.1em;white-space:nowrap}
  130. .keyseq kbd:first-child{margin-left:0}
  131. .keyseq kbd:last-child{margin-right:0}
  132. .menuseq,.menuref{color:#000}
  133. .menuseq b:not(.caret),.menuref{font-weight:inherit}
  134. .menuseq{word-spacing:-.02em}
  135. .menuseq b.caret{font-size:1.25em;line-height:.8}
  136. .menuseq i.caret{font-weight:bold;text-align:center;width:.45em}
  137. b.button::before,b.button::after{position:relative;top:-1px;font-weight:400}
  138. b.button::before{content:"[";padding:0 3px 0 2px}
  139. b.button::after{content:"]";padding:0 2px 0 3px}
  140. p a>code:hover{color:rgba(0,0,0,.9)}
  141. #header,#content,#footnotes,#footer{width:100%;margin-left:auto;margin-right:auto;margin-top:0;margin-bottom:0;max-width:62.5em;*zoom:1;position:relative;padding-left:.9375em;padding-right:.9375em}
  142. #header::before,#header::after,#content::before,#content::after,#footnotes::before,#footnotes::after,#footer::before,#footer::after{content:" ";display:table}
  143. #header::after,#content::after,#footnotes::after,#footer::after{clear:both}
  144. #content{margin-top:1.25em}
  145. #content::before{content:none}
  146. #header>h1:first-child{color:rgba(0,0,0,.85);margin-top:2.25rem;margin-bottom:0}
  147. #header>h1:first-child+#toc{margin-top:8px;border-top:1px solid #dddddf}
  148. #header>h1:only-child,body.toc2 #header>h1:nth-last-child(2){border-bottom:1px solid #dddddf;padding-bottom:8px}
  149. #header .details{border-bottom:1px solid #dddddf;line-height:1.45;padding-top:.25em;padding-bottom:.25em;padding-left:.25em;color:rgba(0,0,0,.6);display:-ms-flexbox;display:-webkit-flex;display:flex;-ms-flex-flow:row wrap;-webkit-flex-flow:row wrap;flex-flow:row wrap}
  150. #header .details span:first-child{margin-left:-.125em}
  151. #header .details span.email a{color:rgba(0,0,0,.85)}
  152. #header .details br{display:none}
  153. #header .details br+span::before{content:"\00a0\2013\00a0"}
  154. #header .details br+span.author::before{content:"\00a0\22c5\00a0";color:rgba(0,0,0,.85)}
  155. #header .details br+span#revremark::before{content:"\00a0|\00a0"}
  156. #header #revnumber{text-transform:capitalize}
  157. #header #revnumber::after{content:"\00a0"}
  158. #content>h1:first-child:not([class]){color:rgba(0,0,0,.85);border-bottom:1px solid #dddddf;padding-bottom:8px;margin-top:0;padding-top:1rem;margin-bottom:1.25rem}
  159. #toc{border-bottom:1px solid #e7e7e9;padding-bottom:.5em}
  160. #toc>ul{margin-left:.125em}
  161. #toc ul.sectlevel0>li>a{font-style:italic}
  162. #toc ul.sectlevel0 ul.sectlevel1{margin:.5em 0}
  163. #toc ul{font-family:"Open Sans","DejaVu Sans",sans-serif;list-style-type:none}
  164. #toc li{line-height:1.3334;margin-top:.3334em}
  165. #toc a{text-decoration:none}
  166. #toc a:active{text-decoration:underline}
  167. #toctitle{color:#7a2518;font-size:1.2em}
  168. @media screen and (min-width:768px){#toctitle{font-size:1.375em}
  169. body.toc2{padding-left:15em;padding-right:0}
  170. #toc.toc2{margin-top:0!important;background:#f8f8f7;position:fixed;width:15em;left:0;top:0;border-right:1px solid #e7e7e9;border-top-width:0!important;border-bottom-width:0!important;z-index:1000;padding:1.25em 1em;height:100%;overflow:auto}
  171. #toc.toc2 #toctitle{margin-top:0;margin-bottom:.8rem;font-size:1.2em}
  172. #toc.toc2>ul{font-size:.9em;margin-bottom:0}
  173. #toc.toc2 ul ul{margin-left:0;padding-left:1em}
  174. #toc.toc2 ul.sectlevel0 ul.sectlevel1{padding-left:0;margin-top:.5em;margin-bottom:.5em}
  175. body.toc2.toc-right{padding-left:0;padding-right:15em}
  176. body.toc2.toc-right #toc.toc2{border-right-width:0;border-left:1px solid #e7e7e9;left:auto;right:0}}
  177. @media screen and (min-width:1280px){body.toc2{padding-left:20em;padding-right:0}
  178. #toc.toc2{width:20em}
  179. #toc.toc2 #toctitle{font-size:1.375em}
  180. #toc.toc2>ul{font-size:.95em}
  181. #toc.toc2 ul ul{padding-left:1.25em}
  182. body.toc2.toc-right{padding-left:0;padding-right:20em}}
  183. #content #toc{border-style:solid;border-width:1px;border-color:#e0e0dc;margin-bottom:1.25em;padding:1.25em;background:#f8f8f7;-webkit-border-radius:4px;border-radius:4px}
  184. #content #toc>:first-child{margin-top:0}
  185. #content #toc>:last-child{margin-bottom:0}
  186. #footer{max-width:none;background:rgba(0,0,0,.8);padding:1.25em}
  187. #footer-text{color:rgba(255,255,255,.8);line-height:1.44}
  188. #content{margin-bottom:.625em}
  189. .sect1{padding-bottom:.625em}
  190. @media screen and (min-width:768px){#content{margin-bottom:1.25em}
  191. .sect1{padding-bottom:1.25em}}
  192. .sect1:last-child{padding-bottom:0}
  193. .sect1+.sect1{border-top:1px solid #e7e7e9}
  194. #content h1>a.anchor,h2>a.anchor,h3>a.anchor,#toctitle>a.anchor,.sidebarblock>.content>.title>a.anchor,h4>a.anchor,h5>a.anchor,h6>a.anchor{position:absolute;z-index:1001;width:1.5ex;margin-left:-1.5ex;display:block;text-decoration:none!important;visibility:hidden;text-align:center;font-weight:400}
  195. #content h1>a.anchor::before,h2>a.anchor::before,h3>a.anchor::before,#toctitle>a.anchor::before,.sidebarblock>.content>.title>a.anchor::before,h4>a.anchor::before,h5>a.anchor::before,h6>a.anchor::before{content:"\00A7";font-size:.85em;display:block;padding-top:.1em}
  196. #content h1:hover>a.anchor,#content h1>a.anchor:hover,h2:hover>a.anchor,h2>a.anchor:hover,h3:hover>a.anchor,#toctitle:hover>a.anchor,.sidebarblock>.content>.title:hover>a.anchor,h3>a.anchor:hover,#toctitle>a.anchor:hover,.sidebarblock>.content>.title>a.anchor:hover,h4:hover>a.anchor,h4>a.anchor:hover,h5:hover>a.anchor,h5>a.anchor:hover,h6:hover>a.anchor,h6>a.anchor:hover{visibility:visible}
  197. #content h1>a.link,h2>a.link,h3>a.link,#toctitle>a.link,.sidebarblock>.content>.title>a.link,h4>a.link,h5>a.link,h6>a.link{color:#ba3925;text-decoration:none}
  198. #content h1>a.link:hover,h2>a.link:hover,h3>a.link:hover,#toctitle>a.link:hover,.sidebarblock>.content>.title>a.link:hover,h4>a.link:hover,h5>a.link:hover,h6>a.link:hover{color:#a53221}
  199. details,.audioblock,.imageblock,.literalblock,.listingblock,.stemblock,.videoblock{margin-bottom:1.25em}
  200. details>summary:first-of-type{cursor:pointer;display:list-item;outline:none;margin-bottom:.75em}
  201. .admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{text-rendering:optimizeLegibility;text-align:left;font-family:"Noto Serif","DejaVu Serif",serif;font-size:1rem;font-style:italic}
  202. table.tableblock.fit-content>caption.title{white-space:nowrap;width:0}
  203. .paragraph.lead>p,#preamble>.sectionbody>[class="paragraph"]:first-of-type p{font-size:1.21875em;line-height:1.6;color:rgba(0,0,0,.85)}
  204. table.tableblock #preamble>.sectionbody>[class="paragraph"]:first-of-type p{font-size:inherit}
  205. .admonitionblock>table{border-collapse:separate;border:0;background:none;width:100%}
  206. .admonitionblock>table td.icon{text-align:center;width:80px}
  207. .admonitionblock>table td.icon img{max-width:none}
  208. .admonitionblock>table td.icon .title{font-weight:bold;font-family:"Open Sans","DejaVu Sans",sans-serif;text-transform:uppercase}
  209. .admonitionblock>table td.content{padding-left:1.125em;padding-right:1.25em;border-left:1px solid #dddddf;color:rgba(0,0,0,.6);word-wrap:anywhere}
  210. .admonitionblock>table td.content>:last-child>:last-child{margin-bottom:0}
  211. .exampleblock>.content{border-style:solid;border-width:1px;border-color:#e6e6e6;margin-bottom:1.25em;padding:1.25em;background:#fff;-webkit-border-radius:4px;border-radius:4px}
  212. .exampleblock>.content>:first-child{margin-top:0}
  213. .exampleblock>.content>:last-child{margin-bottom:0}
  214. .sidebarblock{border-style:solid;border-width:1px;border-color:#dbdbd6;margin-bottom:1.25em;padding:1.25em;background:#f3f3f2;-webkit-border-radius:4px;border-radius:4px}
  215. .sidebarblock>:first-child{margin-top:0}
  216. .sidebarblock>:last-child{margin-bottom:0}
  217. .sidebarblock>.content>.title{color:#7a2518;margin-top:0;text-align:center}
  218. .exampleblock>.content>:last-child>:last-child,.exampleblock>.content .olist>ol>li:last-child>:last-child,.exampleblock>.content .ulist>ul>li:last-child>:last-child,.exampleblock>.content .qlist>ol>li:last-child>:last-child,.sidebarblock>.content>:last-child>:last-child,.sidebarblock>.content .olist>ol>li:last-child>:last-child,.sidebarblock>.content .ulist>ul>li:last-child>:last-child,.sidebarblock>.content .qlist>ol>li:last-child>:last-child{margin-bottom:0}
  219. .literalblock pre,.listingblock>.content>pre{-webkit-border-radius:4px;border-radius:4px;overflow-x:auto;padding:1em;font-size:.8125em}
  220. @media screen and (min-width:768px){.literalblock pre,.listingblock>.content>pre{font-size:.90625em}}
  221. @media screen and (min-width:1280px){.literalblock pre,.listingblock>.content>pre{font-size:1em}}
  222. .literalblock pre,.listingblock>.content>pre:not(.highlight),.listingblock>.content>pre[class="highlight"],.listingblock>.content>pre[class^="highlight "]{background:#f7f7f8}
  223. .literalblock.output pre{color:#f7f7f8;background:rgba(0,0,0,.9)}
  224. .listingblock>.content{position:relative}
  225. .listingblock code[data-lang]::before{display:none;content:attr(data-lang);position:absolute;font-size:.75em;top:.425rem;right:.5rem;line-height:1;text-transform:uppercase;color:inherit;opacity:.5}
  226. .listingblock:hover code[data-lang]::before{display:block}
  227. .listingblock.terminal pre .command::before{content:attr(data-prompt);padding-right:.5em;color:inherit;opacity:.5}
  228. .listingblock.terminal pre .command:not([data-prompt])::before{content:"$"}
  229. .listingblock pre.highlightjs{padding:0}
  230. .listingblock pre.highlightjs>code{padding:1em;-webkit-border-radius:4px;border-radius:4px}
  231. .listingblock pre.prettyprint{border-width:0}
  232. .prettyprint{background:#f7f7f8}
  233. pre.prettyprint .linenums{line-height:1.45;margin-left:2em}
  234. pre.prettyprint li{background:none;list-style-type:inherit;padding-left:0}
  235. pre.prettyprint li code[data-lang]::before{opacity:1}
  236. pre.prettyprint li:not(:first-child) code[data-lang]::before{display:none}
  237. table.linenotable{border-collapse:separate;border:0;margin-bottom:0;background:none}
  238. table.linenotable td[class]{color:inherit;vertical-align:top;padding:0;line-height:inherit;white-space:normal}
  239. table.linenotable td.code{padding-left:.75em}
  240. table.linenotable td.linenos{border-right:1px solid currentColor;opacity:.35;padding-right:.5em}
  241. pre.pygments .lineno{border-right:1px solid currentColor;opacity:.35;display:inline-block;margin-right:.75em}
  242. pre.pygments .lineno::before{content:"";margin-right:-.125em}
  243. .quoteblock{margin:0 1em 1.25em 1.5em;display:table}
  244. .quoteblock:not(.excerpt)>.title{margin-left:-1.5em;margin-bottom:.75em}
  245. .quoteblock blockquote,.quoteblock p{color:rgba(0,0,0,.85);font-size:1.15rem;line-height:1.75;word-spacing:.1em;letter-spacing:0;font-style:italic;text-align:justify}
  246. .quoteblock blockquote{margin:0;padding:0;border:0}
  247. .quoteblock blockquote::before{content:"\201c";float:left;font-size:2.75em;font-weight:bold;line-height:.6em;margin-left:-.6em;color:#7a2518;text-shadow:0 1px 2px rgba(0,0,0,.1)}
  248. .quoteblock blockquote>.paragraph:last-child p{margin-bottom:0}
  249. .quoteblock .attribution{margin-top:.75em;margin-right:.5ex;text-align:right}
  250. .verseblock{margin:0 1em 1.25em}
  251. .verseblock pre{font-family:"Open Sans","DejaVu Sans",sans;font-size:1.15rem;color:rgba(0,0,0,.85);font-weight:300;text-rendering:optimizeLegibility}
  252. .verseblock pre strong{font-weight:400}
  253. .verseblock .attribution{margin-top:1.25rem;margin-left:.5ex}
  254. .quoteblock .attribution,.verseblock .attribution{font-size:.9375em;line-height:1.45;font-style:italic}
  255. .quoteblock .attribution br,.verseblock .attribution br{display:none}
  256. .quoteblock .attribution cite,.verseblock .attribution cite{display:block;letter-spacing:-.025em;color:rgba(0,0,0,.6)}
  257. .quoteblock.abstract blockquote::before,.quoteblock.excerpt blockquote::before,.quoteblock .quoteblock blockquote::before{display:none}
  258. .quoteblock.abstract blockquote,.quoteblock.abstract p,.quoteblock.excerpt blockquote,.quoteblock.excerpt p,.quoteblock .quoteblock blockquote,.quoteblock .quoteblock p{line-height:1.6;word-spacing:0}
  259. .quoteblock.abstract{margin:0 1em 1.25em;display:block}
  260. .quoteblock.abstract>.title{margin:0 0 .375em;font-size:1.15em;text-align:center}
  261. .quoteblock.excerpt>blockquote,.quoteblock .quoteblock{padding:0 0 .25em 1em;border-left:.25em solid #dddddf}
  262. .quoteblock.excerpt,.quoteblock .quoteblock{margin-left:0}
  263. .quoteblock.excerpt blockquote,.quoteblock.excerpt p,.quoteblock .quoteblock blockquote,.quoteblock .quoteblock p{color:inherit;font-size:1.0625rem}
  264. .quoteblock.excerpt .attribution,.quoteblock .quoteblock .attribution{color:inherit;text-align:left;margin-right:0}
  265. p.tableblock:last-child{margin-bottom:0}
  266. td.tableblock>.content{margin-bottom:1.25em;word-wrap:anywhere}
  267. td.tableblock>.content>:last-child{margin-bottom:-1.25em}
  268. table.tableblock,th.tableblock,td.tableblock{border:0 solid #dedede}
  269. table.grid-all>*>tr>*{border-width:1px}
  270. table.grid-cols>*>tr>*{border-width:0 1px}
  271. table.grid-rows>*>tr>*{border-width:1px 0}
  272. table.frame-all{border-width:1px}
  273. table.frame-ends{border-width:1px 0}
  274. table.frame-sides{border-width:0 1px}
  275. table.frame-none>colgroup+*>:first-child>*,table.frame-sides>colgroup+*>:first-child>*{border-top-width:0}
  276. table.frame-none>:last-child>:last-child>*,table.frame-sides>:last-child>:last-child>*{border-bottom-width:0}
  277. table.frame-none>*>tr>:first-child,table.frame-ends>*>tr>:first-child{border-left-width:0}
  278. table.frame-none>*>tr>:last-child,table.frame-ends>*>tr>:last-child{border-right-width:0}
  279. table.stripes-all tr,table.stripes-odd tr:nth-of-type(odd),table.stripes-even tr:nth-of-type(even),table.stripes-hover tr:hover{background:#f8f8f7}
  280. th.halign-left,td.halign-left{text-align:left}
  281. th.halign-right,td.halign-right{text-align:right}
  282. th.halign-center,td.halign-center{text-align:center}
  283. th.valign-top,td.valign-top{vertical-align:top}
  284. th.valign-bottom,td.valign-bottom{vertical-align:bottom}
  285. th.valign-middle,td.valign-middle{vertical-align:middle}
  286. table thead th,table tfoot th{font-weight:bold}
  287. tbody tr th{background:#f7f8f7}
  288. tbody tr th,tbody tr th p,tfoot tr th,tfoot tr th p{color:rgba(0,0,0,.8);font-weight:bold}
  289. p.tableblock>code:only-child{background:none;padding:0}
  290. p.tableblock{font-size:1em}
  291. ol{margin-left:1.75em}
  292. ul li ol{margin-left:1.5em}
  293. dl dd{margin-left:1.125em}
  294. dl dd:last-child,dl dd:last-child>:last-child{margin-bottom:0}
  295. ol>li p,ul>li p,ul dd,ol dd,.olist .olist,.ulist .ulist,.ulist .olist,.olist .ulist{margin-bottom:.625em}
  296. ul.checklist,ul.none,ol.none,ul.no-bullet,ol.no-bullet,ol.unnumbered,ul.unstyled,ol.unstyled{list-style-type:none}
  297. ul.no-bullet,ol.no-bullet,ol.unnumbered{margin-left:.625em}
  298. ul.unstyled,ol.unstyled{margin-left:0}
  299. ul.checklist{margin-left:.625em}
  300. ul.checklist li>p:first-child>.fa-square-o:first-child,ul.checklist li>p:first-child>.fa-check-square-o:first-child{width:1.25em;font-size:.8em;position:relative;bottom:.125em}
  301. ul.checklist li>p:first-child>input[type="checkbox"]:first-child{margin-right:.25em}
  302. ul.inline{display:-ms-flexbox;display:-webkit-box;display:flex;-ms-flex-flow:row wrap;-webkit-flex-flow:row wrap;flex-flow:row wrap;list-style:none;margin:0 0 .625em -1.25em}
  303. ul.inline>li{margin-left:1.25em}
  304. .unstyled dl dt{font-weight:400;font-style:normal}
  305. ol.arabic{list-style-type:decimal}
  306. ol.decimal{list-style-type:decimal-leading-zero}
  307. ol.loweralpha{list-style-type:lower-alpha}
  308. ol.upperalpha{list-style-type:upper-alpha}
  309. ol.lowerroman{list-style-type:lower-roman}
  310. ol.upperroman{list-style-type:upper-roman}
  311. ol.lowergreek{list-style-type:lower-greek}
  312. .hdlist>table,.colist>table{border:0;background:none}
  313. .hdlist>table>tbody>tr,.colist>table>tbody>tr{background:none}
  314. td.hdlist1,td.hdlist2{vertical-align:top;padding:0 .625em}
  315. td.hdlist1{font-weight:bold;padding-bottom:1.25em}
  316. td.hdlist2{word-wrap:anywhere}
  317. .literalblock+.colist,.listingblock+.colist{margin-top:-.5em}
  318. .colist td:not([class]):first-child{padding:.4em .75em 0;line-height:1;vertical-align:top}
  319. .colist td:not([class]):first-child img{max-width:none}
  320. .colist td:not([class]):last-child{padding:.25em 0}
  321. .thumb,.th{line-height:0;display:inline-block;border:solid 4px #fff;-webkit-box-shadow:0 0 0 1px #ddd;box-shadow:0 0 0 1px #ddd}
  322. .imageblock.left{margin:.25em .625em 1.25em 0}
  323. .imageblock.right{margin:.25em 0 1.25em .625em}
  324. .imageblock>.title{margin-bottom:0}
  325. .imageblock.thumb,.imageblock.th{border-width:6px}
  326. .imageblock.thumb>.title,.imageblock.th>.title{padding:0 .125em}
  327. .image.left,.image.right{margin-top:.25em;margin-bottom:.25em;display:inline-block;line-height:0}
  328. .image.left{margin-right:.625em}
  329. .image.right{margin-left:.625em}
  330. a.image{text-decoration:none;display:inline-block}
  331. a.image object{pointer-events:none}
  332. sup.footnote,sup.footnoteref{font-size:.875em;position:static;vertical-align:super}
  333. sup.footnote a,sup.footnoteref a{text-decoration:none}
  334. sup.footnote a:active,sup.footnoteref a:active{text-decoration:underline}
  335. #footnotes{padding-top:.75em;padding-bottom:.75em;margin-bottom:.625em}
  336. #footnotes hr{width:20%;min-width:6.25em;margin:-.25em 0 .75em;border-width:1px 0 0}
  337. #footnotes .footnote{padding:0 .375em 0 .225em;line-height:1.3334;font-size:.875em;margin-left:1.2em;margin-bottom:.2em}
  338. #footnotes .footnote a:first-of-type{font-weight:bold;text-decoration:none;margin-left:-1.05em}
  339. #footnotes .footnote:last-of-type{margin-bottom:0}
  340. #content #footnotes{margin-top:-.625em;margin-bottom:0;padding:.75em 0}
  341. .gist .file-data>table{border:0;background:#fff;width:100%;margin-bottom:0}
  342. .gist .file-data>table td.line-data{width:99%}
  343. div.unbreakable{page-break-inside:avoid}
  344. .big{font-size:larger}
  345. .small{font-size:smaller}
  346. .underline{text-decoration:underline}
  347. .overline{text-decoration:overline}
  348. .line-through{text-decoration:line-through}
  349. .aqua{color:#00bfbf}
  350. .aqua-background{background:#00fafa}
  351. .black{color:#000}
  352. .black-background{background:#000}
  353. .blue{color:#0000bf}
  354. .blue-background{background:#0000fa}
  355. .fuchsia{color:#bf00bf}
  356. .fuchsia-background{background:#fa00fa}
  357. .gray{color:#606060}
  358. .gray-background{background:#7d7d7d}
  359. .green{color:#006000}
  360. .green-background{background:#007d00}
  361. .lime{color:#00bf00}
  362. .lime-background{background:#00fa00}
  363. .maroon{color:#600000}
  364. .maroon-background{background:#7d0000}
  365. .navy{color:#000060}
  366. .navy-background{background:#00007d}
  367. .olive{color:#606000}
  368. .olive-background{background:#7d7d00}
  369. .purple{color:#600060}
  370. .purple-background{background:#7d007d}
  371. .red{color:#bf0000}
  372. .red-background{background:#fa0000}
  373. .silver{color:#909090}
  374. .silver-background{background:#bcbcbc}
  375. .teal{color:#006060}
  376. .teal-background{background:#007d7d}
  377. .white{color:#bfbfbf}
  378. .white-background{background:#fafafa}
  379. .yellow{color:#bfbf00}
  380. .yellow-background{background:#fafa00}
  381. span.icon>.fa{cursor:default}
  382. a span.icon>.fa{cursor:inherit}
  383. .admonitionblock td.icon [class^="fa icon-"]{font-size:2.5em;text-shadow:1px 1px 2px rgba(0,0,0,.5);cursor:default}
  384. .admonitionblock td.icon .icon-note::before{content:"\f05a";color:#19407c}
  385. .admonitionblock td.icon .icon-tip::before{content:"\f0eb";text-shadow:1px 1px 2px rgba(155,155,0,.8);color:#111}
  386. .admonitionblock td.icon .icon-warning::before{content:"\f071";color:#bf6900}
  387. .admonitionblock td.icon .icon-caution::before{content:"\f06d";color:#bf3400}
  388. .admonitionblock td.icon .icon-important::before{content:"\f06a";color:#bf0000}
  389. .conum[data-value]{display:inline-block;color:#fff!important;background:rgba(0,0,0,.8);-webkit-border-radius:50%;border-radius:50%;text-align:center;font-size:.75em;width:1.67em;height:1.67em;line-height:1.67em;font-family:"Open Sans","DejaVu Sans",sans-serif;font-style:normal;font-weight:bold}
  390. .conum[data-value] *{color:#fff!important}
  391. .conum[data-value]+b{display:none}
  392. .conum[data-value]::after{content:attr(data-value)}
  393. pre .conum[data-value]{position:relative;top:-.125em}
  394. b.conum *{color:inherit!important}
  395. .conum:not([data-value]):empty{display:none}
  396. dt,th.tableblock,td.content,div.footnote{text-rendering:optimizeLegibility}
  397. h1,h2,p,td.content,span.alt{letter-spacing:-.01em}
  398. p strong,td.content strong,div.footnote strong{letter-spacing:-.005em}
  399. p,blockquote,dt,td.content,span.alt{font-size:1.0625rem}
  400. p{margin-bottom:1.25rem}
  401. .sidebarblock p,.sidebarblock dt,.sidebarblock td.content,p.tableblock{font-size:1em}
  402. .exampleblock>.content{background:#fffef7;border-color:#e0e0dc;-webkit-box-shadow:0 1px 4px #e0e0dc;box-shadow:0 1px 4px #e0e0dc}
  403. .print-only{display:none!important}
  404. @page{margin:1.25cm .75cm}
  405. @media print{*{-webkit-box-shadow:none!important;box-shadow:none!important;text-shadow:none!important}
  406. html{font-size:80%}
  407. a{color:inherit!important;text-decoration:underline!important}
  408. a.bare,a[href^="#"],a[href^="mailto:"]{text-decoration:none!important}
  409. a[href^="http:"]:not(.bare)::after,a[href^="https:"]:not(.bare)::after{content:"(" attr(href) ")";display:inline-block;font-size:.875em;padding-left:.25em}
  410. abbr[title]::after{content:" (" attr(title) ")"}
  411. pre,blockquote,tr,img,object,svg{page-break-inside:avoid}
  412. thead{display:table-header-group}
  413. svg{max-width:100%}
  414. p,blockquote,dt,td.content{font-size:1em;orphans:3;widows:3}
  415. h2,h3,#toctitle,.sidebarblock>.content>.title{page-break-after:avoid}
  416. #header,#content,#footnotes,#footer{max-width:none}
  417. #toc,.sidebarblock,.exampleblock>.content{background:none!important}
  418. #toc{border-bottom:1px solid #dddddf!important;padding-bottom:0!important}
  419. body.book #header{text-align:center}
  420. body.book #header>h1:first-child{border:0!important;margin:2.5em 0 1em}
  421. body.book #header .details{border:0!important;display:block;padding:0!important}
  422. body.book #header .details span:first-child{margin-left:0!important}
  423. body.book #header .details br{display:block}
  424. body.book #header .details br+span::before{content:none!important}
  425. body.book #toc{border:0!important;text-align:left!important;padding:0!important;margin:0!important}
  426. body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-break-before:always}
  427. .listingblock code[data-lang]::before{display:block}
  428. #footer{padding:0 .9375em}
  429. .hide-on-print{display:none!important}
  430. .print-only{display:block!important}
  431. .hide-for-print{display:none!important}
  432. .show-for-print{display:inherit!important}}
  433. @media print,amzn-kf8{#header>h1:first-child{margin-top:1.25rem}
  434. .sect1{padding:0!important}
  435. .sect1+.sect1{border:0}
  436. #footer{background:none}
  437. #footer-text{color:rgba(0,0,0,.6);font-size:.9em}}
  438. @media amzn-kf8{#header,#content,#footnotes,#footer{padding:0}}
  439. </style>
  440. </head>
  441. <body class="article toc2 toc-left">
  442. <div id="header">
  443. <h1>Vico</h1>
  444. <div class="details">
  445. <span id="author" class="author">Laborejo Software Suite</span><br>
  446. </div>
  447. <div id="toc" class="toc2">
  448. <div id="toctitle">Inhaltsverzeichnis</div>
  449. <ul class="sectlevel1">
  450. <li><a href="#_bedienung">1. Bedienung</a>
  451. <ul class="sectlevel2">
  452. <li><a href="#_anwendungszweck_und_zielgruppe">1.1. Anwendungszweck und Zielgruppe</a></li>
  453. <li><a href="#_grundlagen">1.2. Grundlagen</a></li>
  454. <li><a href="#_midi_unterstützung">1.3. MIDI-Unterstützung</a></li>
  455. <li><a href="#_maus_und_tastaturkürzel">1.4. Maus und Tastaturkürzel</a></li>
  456. </ul>
  457. </li>
  458. <li><a href="#_beschreibung_der_grafischen_oberfläche_und_ihrer_funktionen">2. Beschreibung der grafischen Oberfläche und ihrer Funktionen</a></li>
  459. <li><a href="#_klavier_am_linken_rand">3. Klavier am linken Rand</a></li>
  460. <li><a href="#_hauptansicht">4. Hauptansicht</a>
  461. <ul class="sectlevel2">
  462. <li><a href="#_bewegen_und_navigation">4.1. Bewegen und Navigation</a></li>
  463. <li><a href="#_zoom_und_skalierung">4.2. Zoom und Skalierung</a></li>
  464. <li><a href="#_ebenen">4.3. Ebenen</a>
  465. <ul class="sectlevel3">
  466. <li><a href="#_schatten">4.3.1. Schatten</a></li>
  467. <li><a href="#_farben">4.3.2. Farben</a></li>
  468. <li><a href="#_midi_kanal">4.3.3. Midi-Kanal</a></li>
  469. </ul>
  470. </li>
  471. </ul>
  472. </li>
  473. <li><a href="#_live_aufnahmen">5. Live Aufnahmen</a>
  474. <ul class="sectlevel2">
  475. <li><a href="#_ebenen_filter">5.1. Ebenen-Filter</a></li>
  476. <li><a href="#_jack_transport_und_timebase_taktstriche">5.2. JACK Transport und Timebase: Taktstriche</a></li>
  477. </ul>
  478. </li>
  479. <li><a href="#_noten_und_events">6. Noten und Events</a>
  480. <ul class="sectlevel2">
  481. <li><a href="#_events_löschen">6.1. Events löschen</a></li>
  482. <li><a href="#_noten">6.2. Noten</a></li>
  483. <li><a href="#_weitere_events">6.3. Weitere Events</a>
  484. <ul class="sectlevel3">
  485. <li><a href="#_control_changes_0xb0">6.3.1. Control Changes (0xB0)</a></li>
  486. <li><a href="#_program_change_0xc0">6.3.2. Program Change (0xC0)</a></li>
  487. <li><a href="#_channel_pressure_monophonic_aftertouch_0xd0">6.3.3. Channel Pressure / "Monophonic Aftertouch" (0xD0)</a></li>
  488. <li><a href="#_pitch_bend_0xe0_nur_7bit_msb">6.3.4. Pitch Bend (0xE0 - nur 7bit MSB)</a></li>
  489. <li><a href="#_polyphonic_aftertouch_0xa0">6.3.5. Polyphonic Aftertouch (0xA0)</a></li>
  490. </ul>
  491. </li>
  492. </ul>
  493. </li>
  494. <li><a href="#_events_bearbeiten_und_verschieben">7. Events bearbeiten und verschieben</a>
  495. <ul class="sectlevel2">
  496. <li><a href="#_textanmerkung">7.1. Textanmerkung</a></li>
  497. <li><a href="#_auswahl">7.2. Auswahl</a>
  498. <ul class="sectlevel3">
  499. <li><a href="#_auswahl_umkehren">7.2.1. Auswahl umkehren</a></li>
  500. </ul>
  501. </li>
  502. <li><a href="#_event_position_verändern">7.3. Event-Position verändern</a></li>
  503. <li><a href="#_notenlängen_verändern">7.4. Notenlängen verändern</a></li>
  504. <li><a href="#_raster_und_positionen_einrasten">7.5. Raster und Positionen einrasten</a></li>
  505. <li><a href="#_notenlautstärke_velocity_verändern">7.6. Notenlautstärke / Velocity verändern</a></li>
  506. <li><a href="#_kopieren_ausschneiden_einfügen">7.7. Kopieren, Ausschneiden, Einfügen</a></li>
  507. <li><a href="#_änderungen_rückgängig_machen_undo_redo">7.8. Änderungen rückgängig machen / Undo &amp; Redo</a></li>
  508. </ul>
  509. </li>
  510. <li><a href="#_velocityansicht">8. Velocityansicht</a></li>
  511. <li><a href="#_verschiedenes_für_fortgeschrittene_benutzer">9. Verschiedenes für fortgeschrittene Benutzer</a>
  512. <ul class="sectlevel2">
  513. <li><a href="#_parameter_und_einstellungen_am_anfang_des_stückes">9.1. Parameter und Einstellungen am Anfang des Stückes</a></li>
  514. <li><a href="#_midi_parameter_mit_hoher_auflösung_msb_und_lsb">9.2. MIDI Parameter mit hoher Auflösung (MSB und LSB)</a></li>
  515. <li><a href="#_überlappende_noten">9.3. Überlappende Noten</a></li>
  516. <li><a href="#_control_changes_sind_falsch_herum_in_vico">9.4. "Control Changes sind falsch herum in Vico!"</a></li>
  517. <li><a href="#_rundungsfehler_meine_noten_sind_an_der_falschen_stelle">9.5. Rundungsfehler: Meine Noten sind an der Falschen Stelle</a></li>
  518. </ul>
  519. </li>
  520. <li><a href="#_installation_und_start">10. Installation und Start</a></li>
  521. <li><a href="#_helfen_und_entwicklung">11. Helfen und Entwicklung</a>
  522. <ul class="sectlevel2">
  523. <li><a href="#_testen_und_programmfehler">11.1. Testen und Programmfehler</a></li>
  524. </ul>
  525. </li>
  526. <li><a href="#_entwicklung">12. Entwicklung</a>
  527. <ul class="sectlevel2">
  528. <li><a href="#_übersetzungen">12.1. Übersetzungen</a></li>
  529. </ul>
  530. </li>
  531. </ul>
  532. </div>
  533. </div>
  534. <div id="content">
  535. <div id="preamble">
  536. <div class="sectionbody">
  537. <div class="paragraph">
  538. <p>Für Programmversion 1.2.2</p>
  539. </div>
  540. </div>
  541. </div>
  542. <div class="sect1">
  543. <h2 id="_bedienung">1. Bedienung</h2>
  544. <div class="sectionbody">
  545. <div class="paragraph">
  546. <p>Schön, dass Sie sich für Vico entschieden hast. Es handelt sich um einen minimalistischen
  547. Midi-Sequencer, der parallel zu anderer Software eingesetzt werden soll.</p>
  548. </div>
  549. <div class="paragraph">
  550. <p>"Vico" (mit c als 'z'/'ts' wie in Zirkel) heißt Reihenfolge auf Esperanto, da es sich um einen
  551. "Sequencer" handelt.</p>
  552. </div>
  553. <div class="sect2">
  554. <h3 id="_anwendungszweck_und_zielgruppe">1.1. Anwendungszweck und Zielgruppe</h3>
  555. <div class="paragraph">
  556. <p>In einer loop- oder patternbasierten Umgebung möchte man oft einen 'freien' Track habe, um etwa ein
  557. Instrumentalsolo umzusetzen.
  558. Manchmal möchte man auch nur schnell eine Skizze oder Idee aufnehmen und dazu nicht gleich ein
  559. ganzes DAW-Projekt öffnen oder erstellen.</p>
  560. </div>
  561. <div class="paragraph">
  562. <p>Vico erfüllt diese Bedingungen indem es genau eine Aufnahmequelle mit einer Ausgabe verbindet und
  563. dazwischen aufnehmen und bearbeiten kann. Oder anders gesagt: man bekommt nur einen Track, gedacht
  564. für ein Instrument (dafür aber mit nützlichen Ebenen)</p>
  565. </div>
  566. <div class="paragraph">
  567. <p>Vico ist in erster Linie für Benutzer von Patroneo geschrieben worden, hat dazu aber keine engere
  568. technische Bindung. Patroneo ist ein Programm geprägt von strengen Wiederholungen und ständiger
  569. Wiederverwendung von sehr kurzen Mustern. Damit kann man schnell ganze Arrangements für Schlagzeug,
  570. Bass und Begleitakkorde aufbauen, aber eine schöne, lange Melodie ist extrem umständlich. Daher
  571. hier das Programm für genau diesen Zweck.</p>
  572. </div>
  573. <div class="paragraph">
  574. <p>Alle Programme, die als JACK-Transport-Master oder JACK-Timebase-Master laufen können Vico
  575. fernsteuern.</p>
  576. </div>
  577. </div>
  578. <div class="sect2">
  579. <h3 id="_grundlagen">1.2. Grundlagen</h3>
  580. <div class="paragraph">
  581. <p>Vico erzeugt selbst keine Klänge und bietet nur einen einzigen Ausgang für JACK-Midi und ordnet alle
  582. Events auf bis zu zehn Ebenen, ähnlich wie in Grafikprogrammen.</p>
  583. </div>
  584. <div class="paragraph">
  585. <p>Es gibt einen Eingang für JACK-Midi, an dem man MIDI-Instrumente oder andere Programme anschließen
  586. kann.</p>
  587. </div>
  588. <div class="paragraph">
  589. <p>Beim Start sieht man einen leeren Track. Der Playhead befindet sich immer an der Stelle, an der
  590. JACK Transport sich befindet.
  591. Die Taktstriche werden ebenfalls im Metrum des JACK Masters gezeigt. Falls nicht vorhanden gibt es
  592. keine.
  593. Ein roter Playhead zeigt an, dass man sich im Aufnahmemodus befindet; Läuft Transport wird
  594. aufgenommen, etwa von einen Midikeyboard.</p>
  595. </div>
  596. <div class="paragraph">
  597. <p>Mit Maus und Tastatur können außerdem alle Events von Hand gesetzt und nachträglich verändert
  598. werden (s.u.). Bis auf Velocity werden alle Events im Haupttrack dargestellt.</p>
  599. </div>
  600. <div class="paragraph">
  601. <p>Zur Vereinfachung kann man ein Rhythmusraster ein- und ausschalten sowie einstellen in welchem
  602. Raster Events erzeugt oder verschoben werden sollen.</p>
  603. </div>
  604. <div class="paragraph">
  605. <p>Alles Bearbeiten erfordert das Erstellen einer Auswahl ("Selection") indem man mit Umschalten und
  606. der linken Maustaste einen Rahmen zieht. Ein Klick mit der rechten Maustaste beendet die Auswahl.</p>
  607. </div>
  608. <div class="paragraph">
  609. <p>Starten, speichern, laden und schließen ihres Projektes wird am besten durch den New Session
  610. Manager (Agordejo) erledigt.</p>
  611. </div>
  612. </div>
  613. <div class="sect2">
  614. <h3 id="_midi_unterstützung">1.3. MIDI-Unterstützung</h3>
  615. <div class="paragraph">
  616. <p>Vico unterstützt alle MIDI Channel-Nachrichten:</p>
  617. </div>
  618. <div class="ulist">
  619. <ul>
  620. <li>
  621. <p>Noten (ON 0x80 und OFF 0x90 sind als Rechtecknote zusammengefasst)</p>
  622. </li>
  623. <li>
  624. <p>Control Changes (0xB0)</p>
  625. </li>
  626. <li>
  627. <p>Program Change (0xC0)</p>
  628. </li>
  629. <li>
  630. <p>Channel Pressure / "Monophonic Aftertouch" (0xD0)</p>
  631. </li>
  632. <li>
  633. <p>Pitch Bend (0xE0 - nur 7bit MSB)</p>
  634. </li>
  635. <li>
  636. <p>Polyphonic Aftertouch (0xA0)</p>
  637. </li>
  638. </ul>
  639. </div>
  640. <div class="paragraph">
  641. <p>Alle Nachrichten können entweder live aufgenommen werden oder mit der Hand eingetragen werden.
  642. Nachbearbeitung ist für alle Channel-Nachrichten möglich.</p>
  643. </div>
  644. <div class="paragraph">
  645. <p>Der Midikanal wird bei der Aufnahme verworfen. Statt dessen hat jede Ebene die Möglichkeit einen
  646. Kanal einzustellen, auf dem gesendet wird.</p>
  647. </div>
  648. <div class="paragraph">
  649. <p>Alle nichtmusikalischen Events (0xF&#8230;&#8203;) werden ignoriert, inkl. aller Nachrichten zu MIDI-Transport
  650. (nicht JACK-Transport), Tune-Request usw. Gleiches gilt für SystemExclusive Events.</p>
  651. </div>
  652. </div>
  653. <div class="sect2">
  654. <h3 id="_maus_und_tastaturkürzel">1.4. Maus und Tastaturkürzel</h3>
  655. <div class="paragraph">
  656. <p>Alle Tastaturkürzel ("Shortcuts") sind in den Menüs zu finden, es gibt keine "geheimen" Tasten.</p>
  657. </div>
  658. <div class="paragraph">
  659. <p>Im Gegensatz dazu sind Mausbefehle überhaupt nicht in der grafischen Oberfläche einzusehen und
  660. müssen hier gelernt werden:</p>
  661. </div>
  662. <div class="paragraph">
  663. <p>(LM = Linke Maustaste, RM = Rechte Maustaste, Rad = Mausrad bewegen, MM = Mittlere Maustaste, meistens das Rad selbst drücken)</p>
  664. </div>
  665. <div class="ulist">
  666. <ul>
  667. <li>
  668. <p>Umschalten + LM gedrückt halten, Maus bewegen: Zieht einen Rahmen um Events auszuwählen.</p>
  669. </li>
  670. <li>
  671. <p>RM auf den Hintergrund: Löst die Auswahl wieder auf.</p>
  672. </li>
  673. <li>
  674. <p>LM auf ein ausgewähltes Event, dann Maus bewegen: Verschiebt die ausgewählten Events nach oben/unten oder links/rechts</p>
  675. </li>
  676. <li>
  677. <p>Steuerung (Strg) dabei gedrückt halten: Bewegt nur nach links / rechts</p>
  678. </li>
  679. <li>
  680. <p>Alt dabei gedrückt halten: Bewegt nur nach oben / unten</p>
  681. </li>
  682. <li>
  683. <p>MM: Spielt die Note unter dem Mauszeiger ab. Es muss keine tatsächliche Note dort sein, die Position alleine reicht. Dies geht auch auf dem Klavier am linken Rand.</p>
  684. </li>
  685. <li>
  686. <p>RM auf ein Event: Öffnet ein Menü mit weiteren Funktionen.</p>
  687. </li>
  688. <li>
  689. <p>Rad: Scrollt den Notenbereich hoch und runter</p>
  690. </li>
  691. <li>
  692. <p>Rad, dabei Alt gedrückt halten: Scrollt den Notenbereich links und rechts</p>
  693. </li>
  694. <li>
  695. <p>Rad auf Velocities im unteren Bereich: Ändert die Lautstärke der einzelnen Note, unabhängig der momentanen Auswahl</p>
  696. </li>
  697. <li>
  698. <p>Strg + Leertaste: Startet Playback an der Mauszeigerposition</p>
  699. </li>
  700. </ul>
  701. </div>
  702. </div>
  703. </div>
  704. </div>
  705. <div class="sect1">
  706. <h2 id="_beschreibung_der_grafischen_oberfläche_und_ihrer_funktionen">2. Beschreibung der grafischen Oberfläche und ihrer Funktionen</h2>
  707. <div class="sectionbody">
  708. <div class="imageblock">
  709. <div class="content">
  710. <a class="image" href="overview-german.png"><img src="overview-german.png" alt="Screenshot mit Beschriftung"></a>
  711. </div>
  712. </div>
  713. <div class="paragraph">
  714. <p>Alle Punkte, und mehr, werden weiter unten ausführlich besprochen.</p>
  715. </div>
  716. <div class="ulist">
  717. <ul>
  718. <li>
  719. <p><strong>[A]</strong> Menüleiste</p>
  720. </li>
  721. <li>
  722. <p><strong>[B]</strong> Hauptansicht (Noten und Events)</p>
  723. </li>
  724. <li>
  725. <p><strong>[C]</strong> Klavier am linken Rand</p>
  726. </li>
  727. <li>
  728. <p><strong>[D]</strong> Velocityansicht</p>
  729. </li>
  730. <li>
  731. <p><strong>[E]</strong> Einige Noten</p>
  732. </li>
  733. <li>
  734. <p><strong>[F]</strong> Ein weiteres Event, als Beispiel</p>
  735. </li>
  736. <li>
  737. <p><strong>[G]</strong> Statusleiste mit aktueller Ebene und Ebenen-MIDI-Kanal</p>
  738. </li>
  739. </ul>
  740. </div>
  741. <div class="paragraph">
  742. <p>Im Normalfall, wenn Vico im New-Session-Manager läuft, gibt keine interne Möglichkeit das Programm
  743. zu <strong>beenden</strong>. Benutzt man die Funktion seinen Fenstermanagers wie [X], Alt+F4 etc. wird die
  744. grafische Oberfläche lediglich versteckt.</p>
  745. </div>
  746. <div class="paragraph">
  747. <p>Um Vico wirklich zu schließen kann man in Agordejo (New Session Manager) stoppen. Hier
  748. kann man auch die Sichtbarkeit wieder herstellen.</p>
  749. </div>
  750. <div class="paragraph">
  751. <p>Die momentane Sichtbarkeitseinstellung wird gespeichert.</p>
  752. </div>
  753. </div>
  754. </div>
  755. <div class="sect1">
  756. <h2 id="_klavier_am_linken_rand">3. Klavier am linken Rand</h2>
  757. <div class="sectionbody">
  758. <div class="paragraph">
  759. <p>Am linken Rand des Programmfensters befindet sich eine gedrehte Klaviatur. Sie dient ausschließlich
  760. als Orientierungshilfe.</p>
  761. </div>
  762. <div class="paragraph">
  763. <p>Die Zahlen zwischen 0 und 127 in den Tasten sind MIDI-Tonhöhen. 60 ist in diesem System das mittlere
  764. C.</p>
  765. </div>
  766. <div class="paragraph">
  767. <p>Hält man die mittlere Maustaste gedrückt und fährt über die Tastatur erklingt der Ton über das
  768. verbundene Instrument.</p>
  769. </div>
  770. </div>
  771. </div>
  772. <div class="sect1">
  773. <h2 id="_hauptansicht">4. Hauptansicht</h2>
  774. <div class="sectionbody">
  775. <div class="paragraph">
  776. <p>Die Hauptansicht nutzt Rhythmus als lineare Ausdehnung (technisch: Midi-Ticks).
  777. Das bedeutet, dass eine Note mit gleicher Dauer immer gleich lang aussieht.
  778. Verändert sich das Tempo (BPM) dann bewegt sich der Playhead schneller oder langsamer.
  779. Im Umkehrschluss bedeutet das, dass es keine Zeitleiste geben kann, an der man sieht bei welcher
  780. Sekunde ein Event stattfindet.</p>
  781. </div>
  782. <div class="sect2">
  783. <h3 id="_bewegen_und_navigation">4.1. Bewegen und Navigation</h3>
  784. <div class="paragraph">
  785. <p>Mit dem Mausrad scrollt man die Hauptansicht nach oben und unten. Mit gedrückter Alt-Taste scrollt
  786. man stattdessen nach vorne oder hinten (links / rechts)</p>
  787. </div>
  788. <div class="paragraph">
  789. <p>Das "Navigation"-Menü bietet weitere Möglichkeiten.</p>
  790. </div>
  791. </div>
  792. <div class="sect2">
  793. <h3 id="_zoom_und_skalierung">4.2. Zoom und Skalierung</h3>
  794. <div class="paragraph">
  795. <p>Hält man Strg gedrückt und dreht das Mausrad wird die Ansicht größer oder kleiner.</p>
  796. </div>
  797. <div class="paragraph">
  798. <p>Hält man zusätzlich noch Umschalten gedrück wird nur die Zeitachse skaliert. Noten werden
  799. zusammengedrückt oder auseinandergezogen, so dass man entweder mehr auf einmal sehen kann oder
  800. genauere Anfangs- und Endpositionen setzen kann.</p>
  801. </div>
  802. <div class="paragraph">
  803. <p>Zoom und Skalierung ist rein grafisch und hat keinerlei Auswirkung auf die Musik selbst.</p>
  804. </div>
  805. </div>
  806. <div class="sect2">
  807. <h3 id="_ebenen">4.3. Ebenen</h3>
  808. <div class="paragraph">
  809. <p>Noten werden nicht in Tracks, sondern in Ebenen organisiert. Es gibt derer zehn.
  810. Im "Ebenen"-Menü, oder mit den Funktionstasten F1 bis F10, kann die momentane Ebene ausgewählt werden.</p>
  811. </div>
  812. <div class="sect3">
  813. <h4 id="_schatten">4.3.1. Schatten</h4>
  814. <div class="paragraph">
  815. <p>Ebenen liegen hintereinander und verdecken sich gegenseitig. Man kann allerdings sogenannte Schatten
  816. aktivieren,
  817. die eine andere Ebene auf die momentane projizieren. Schatten können nicht bearbeitet werden.
  818. Alle Schatten verschwinden,sobald man die aktive Ebene verändert.</p>
  819. </div>
  820. <div class="paragraph">
  821. <p>Umschalten+Funktionstaste, z.B. F3, zeigt die dritte Ebene als Schatten. F12 zeigt alle als Schatten.</p>
  822. </div>
  823. </div>
  824. <div class="sect3">
  825. <h4 id="_farben">4.3.2. Farben</h4>
  826. <div class="paragraph">
  827. <p>Jede Ebene kann eine Farbe haben, diese ist im Ebenenmenü auswählbar. Hauptsächlich sind Noten und
  828. Events in dieser Farbe. Der Mauszeiger ist immer in der gegenteiligen Farbe.</p>
  829. </div>
  830. </div>
  831. <div class="sect3">
  832. <h4 id="_midi_kanal">4.3.3. Midi-Kanal</h4>
  833. <div class="paragraph">
  834. <p>Kanäle sind keine Eigenschaften der Events. Jede Ebene hat einen eigenen Midikanal,
  835. zwischen 1 und 16, auf dem gesendet wird. Bei einem neuen Projekt ist das immer Kanal 1.</p>
  836. </div>
  837. <div class="paragraph">
  838. <p>Bei der Aufnahme wird zwar auf allen eigehenden Midikanälen zugehört, allerdings wird der Kanal
  839. sofort verworfen und auf den jeweiligen Ebenenkanal geändert.</p>
  840. </div>
  841. </div>
  842. </div>
  843. </div>
  844. </div>
  845. <div class="sect1">
  846. <h2 id="_live_aufnahmen">5. Live Aufnahmen</h2>
  847. <div class="sectionbody">
  848. <div class="paragraph">
  849. <p>Vico hat einen MIDI-in Jackport, an dem man beliebige Programme oder Hardwareinstrumente anschließen
  850. kann.</p>
  851. </div>
  852. <div class="paragraph">
  853. <p>Der Eingangsport leitet, unabhängig von der Verarbeitung in Vico selbst (Aufnahme oder nicht), alles
  854. sofort an den Ausgangsport durch, allerdings mit dem Kanal der jeweils aktuellen Ebene. Die
  855. Weiterleitung geschieht in Echtzeit (Realtime).</p>
  856. </div>
  857. <div class="paragraph">
  858. <p>Um etwas aufzunehmen muss der Aufnahmemodus aktiviert sein (Bearbeiten&#8594;"Aufnahmemodus
  859. umschalten"). Dies ist bei Programmstart bereits der Fall. Ein roter Playhead zeigt
  860. Aufnahmebereitschaft, ein schwarzer ist reines Abspielen. Zusätzlich muss Transport laufen. Ist
  861. beides nicht der Fall reagiert Vico, z.B. auf Noten, indem es die Tonhöhe farbig markiert.</p>
  862. </div>
  863. <div class="paragraph">
  864. <p>Da Vico immer der JACK Timebase folgt (s.u.) geschieht die Aufnahme auch an dieser Position.
  865. Man kann also in einem anderen Programm genau an die Stelle springen zu der man etwa ein Solo
  866. aufnehmen möchte und in diesem Programm auch auf Play drücken. Im Prinzip kann Vico wie ein im
  867. Hintergrund laufendes Programm benutzt werden (was mit NSMs GUI-verstecken auch tatsächlich geht).</p>
  868. </div>
  869. <div class="sect2">
  870. <h3 id="_ebenen_filter">5.1. Ebenen-Filter</h3>
  871. <div class="paragraph">
  872. <p>Es passiert schnell, dass man eine Fülle von Events aufzeichnet, die das weitere Bearbeiten extrem
  873. erschweren können. Man stelle sich vor, dass zu einer Melodie auch noch MIDI Aftertouch auf jeder
  874. Note aufgezeichnet wird und darüber hinaus das Modwheel (CC) benutzt wird. Schon ist der ganze
  875. Bildschirm voller Symbole.</p>
  876. </div>
  877. <div class="paragraph">
  878. <p>Im Menü "Filter" befinden sich mehrere Möglichkeiten um Events auf Ebenen umzusortieren.</p>
  879. </div>
  880. <div class="paragraph">
  881. <p>Die einfachste Anwendung ist einen Filter für alle Ebenen zu benutzen und dort lediglich den
  882. Event-Typ einzustellen, z.B. Aftertouch. Nun werden alle Aftertouch-Events auf die aktuelle Ebene
  883. verschoben.</p>
  884. </div>
  885. <div class="paragraph">
  886. <p>Darüber hinaus kann man die Zielebene natürlich selbst einstellen. Auch ist es möglich die jeweiligen
  887. MIDI Bytes als Ober- und Untergrenze zu definieren.</p>
  888. </div>
  889. <div class="paragraph">
  890. <p>Beispiel: Event-Typ "Note" mit Byte1 Minimum 0 und Maximum 59 verschiebt alle tiefen Noten, z.B.
  891. die Begleitung eines Klavierstückes, auf die Zielebene aber lässt alle hohen Noten stehen.</p>
  892. </div>
  893. <div class="paragraph">
  894. <p>Die weiteren Menübefehle in "Filter" bieten Variation, funktionieren aber nach dem gleichen Muster.</p>
  895. </div>
  896. </div>
  897. <div class="sect2">
  898. <h3 id="_jack_transport_und_timebase_taktstriche">5.2. JACK Transport und Timebase: Taktstriche</h3>
  899. <div class="paragraph">
  900. <p>Vico wurde mit dem erklärten Ziel konstruiert, untergeordnet in einer Session zu laufen.
  901. Startet man es alleine kann man natürlich aufnehmen und alle Funktionen benutzen, aber man sieht
  902. keine Taktstriche und es ist ein bischen schwieriger die richtige Stelle zu finden.</p>
  903. </div>
  904. <div class="paragraph">
  905. <p>Gibt es hingegen ein Programm, dass als JACK Timebase "Master" fungiert folgt Vico dessen Taktart
  906. und Position.</p>
  907. </div>
  908. <div class="paragraph">
  909. <p>Mit "Bearbeiten"&#8594;"Zeige Rhythmus Raster" (Taste L) kann man Taktstriche auch komplett ausschalten.</p>
  910. </div>
  911. <div class="paragraph">
  912. <p>Vico hat keine festgesetzte Länge. Die Hauptansicht hat praktisch unendliche Länge, und man arbeitet
  913. stets an der Stelle, an der sich alle anderen Programme auch befinden.</p>
  914. </div>
  915. <div class="paragraph">
  916. <p>Sobald Transport läuft springt die Hauptansicht zum Playhead, es sei denn
  917. Bearbeiten&#8594;"Playhead stets zentrieren" ist ausgeschaltet.</p>
  918. </div>
  919. <div class="paragraph">
  920. <p>Starten und Stoppen des Transports ist von jedem laufenden JACK-Programm möglich, inkl. Vico selbst.
  921. (Leertaste)</p>
  922. </div>
  923. </div>
  924. </div>
  925. </div>
  926. <div class="sect1">
  927. <h2 id="_noten_und_events">6. Noten und Events</h2>
  928. <div class="sectionbody">
  929. <div class="paragraph">
  930. <p>Möchte man Noten und Events mit Maus und Tastatur einfügen, und nicht per MIDI Instrument aufnehmen,
  931. stehen in den Menüs "Eingabe" und "Raster" zahlreiche Möglichkeiten zur Verfügung.</p>
  932. </div>
  933. <div class="paragraph">
  934. <p>Alle Events werden immer auf dem Midi-Kanal ihrer Ebene gesendet.</p>
  935. </div>
  936. <div class="sect2">
  937. <h3 id="_events_löschen">6.1. Events löschen</h3>
  938. <div class="paragraph">
  939. <p>Momentan ausgewählte Events (s.u.), inkl. Noten, können mit der Entfernen Taste gelöscht werden.
  940. Alternativ kann man im "Bearbeiten"-Menü löschen.</p>
  941. </div>
  942. </div>
  943. <div class="sect2">
  944. <h3 id="_noten">6.2. Noten</h3>
  945. <div class="paragraph">
  946. <p>Bei Programmstart ist der Mauszeiger ein kleines Rechteck mit einem Text zur Tonhöhe. Dies ist der
  947. Modus zum eingeben von Noten mit beliebiger Länge. Durch gedrückt halten und ziehen der linken
  948. Maustaste können Noten gezeichnet werden. Man muss zuerst den Mauszeiger auf die richtige Tonhöhe
  949. bringen, dann anfangen zu zeichnen.</p>
  950. </div>
  951. <div class="paragraph">
  952. <p>Im Eingabemenü stehen feste Tondauern zur Verfügung. Diese können durch die Zahlentasten ausgewählt
  953. werden. Nach Taste "1" fügt ein Klick mit der linken Maustaste eine Ganze Note ein, mit "2" eine
  954. Halbe Note usw. "0" wählt wieder den freien Modus aus.</p>
  955. </div>
  956. <div class="paragraph">
  957. <p>Punktierte Notenlängen können hier für alle festen Dauern an und ausgeschaltet werden.</p>
  958. </div>
  959. <div class="paragraph">
  960. <p>Eingefügte Noten haben eine Durchschnitts-Velocity (Median) aus allen bisherigen Noten.</p>
  961. </div>
  962. </div>
  963. <div class="sect2">
  964. <h3 id="_weitere_events">6.3. Weitere Events</h3>
  965. <div class="paragraph">
  966. <p>Alle anderen Events können ebenfalls mit der Maus eingefügt werden. Das ist aufgrund großer
  967. Datenmengen evtl. nicht sehr bequem oder schnell, aber immerhin möglich. Eine Liveaufnahme ist
  968. wahrscheinlich vorzuziehen.</p>
  969. </div>
  970. <div class="sect3">
  971. <h4 id="_control_changes_0xb0">6.3.1. Control Changes (0xB0)</h4>
  972. <div class="paragraph">
  973. <p>Zunächst muss man in einem Submenü den CC Typ auswählen, etwa "Volume (CC7)".
  974. Die Höhe in der Hauptansicht bestimmt nun die Intensität von 0 bis 127.</p>
  975. </div>
  976. <div class="paragraph">
  977. <p>Möchte man Control Changes eines anderen Typs setzen muss man den Menüeintrag erneut auswählen
  978. (oder das Tastenkürzel drücken).</p>
  979. </div>
  980. <div class="paragraph">
  981. <p>Control Changes können nicht nachträglich ihren Typ ändern, z.B. von Modwheel zu Volume. Man müsste
  982. sie löschen und neu erstellen.</p>
  983. </div>
  984. </div>
  985. <div class="sect3">
  986. <h4 id="_program_change_0xc0">6.3.2. Program Change (0xC0)</h4>
  987. <div class="paragraph">
  988. <p>Um das Programm zu wechseln, um ein anderes Instrument auszuwählen, muss man lediglich das
  989. Event auf eine Position setzen. Die Beschriftung zeigt an um welche Programmnummer und
  990. General-Midi-Instrument es sich handelt. Folgt das verbundene JACK-Intrument nicht der MIDI-Benennung
  991. kann man die Namen natürlich ignorieren.</p>
  992. </div>
  993. </div>
  994. <div class="sect3">
  995. <h4 id="_channel_pressure_monophonic_aftertouch_0xd0">6.3.3. Channel Pressure / "Monophonic Aftertouch" (0xD0)</h4>
  996. <div class="paragraph">
  997. <p>Channel Pressure präsentiert sich als ein simples X ohne weitere Beschriftung oder Auswahlmöglichkeit.
  998. Je "höher" die Position, desto intensiver.</p>
  999. </div>
  1000. </div>
  1001. <div class="sect3">
  1002. <h4 id="_pitch_bend_0xe0_nur_7bit_msb">6.3.4. Pitch Bend (0xE0 - nur 7bit MSB)</h4>
  1003. <div class="paragraph">
  1004. <p>Pitch Bend präsentiert sich als kleiner Kreis ohne weitere Beschriftung
  1005. oder Auswahlmöglichkeit. Je "höher", desto intensiver.</p>
  1006. </div>
  1007. </div>
  1008. <div class="sect3">
  1009. <h4 id="_polyphonic_aftertouch_0xa0">6.3.5. Polyphonic Aftertouch (0xA0)</h4>
  1010. <div class="paragraph">
  1011. <p>Zunächst muss man in einem Submenü die Note auswählen, für die Aftertouch gelten
  1012. soll. Anschließend kann man das Event einfügen. Intensität ist auch hier wieder die "Tonhöhe".
  1013. Möchte man Polyphonic Aftertouch für eine andere Note setzen muss man den Menüeintrag erneut
  1014. auswählen (oder das Tastenkürzel drücken).</p>
  1015. </div>
  1016. <div class="paragraph">
  1017. <p>Polyphonic Aftertouch können nicht nachträglich ihren Bezug zur Tonhöhe ändern.
  1018. Man müsste sie löschen und neu erstellen.</p>
  1019. </div>
  1020. </div>
  1021. </div>
  1022. </div>
  1023. </div>
  1024. <div class="sect1">
  1025. <h2 id="_events_bearbeiten_und_verschieben">7. Events bearbeiten und verschieben</h2>
  1026. <div class="sectionbody">
  1027. <div class="paragraph">
  1028. <p>Alle Events lassen sich nachträglich bearbeiten. Hat man Ordnung durch Ebenen hergestellt, etwa
  1029. durch Filter, gestaltet sich dies umso einfacher.</p>
  1030. </div>
  1031. <div class="paragraph">
  1032. <p>Schreiben von Textanmerkungung ist die einzige Funktion in der Hauptansicht,
  1033. die keine Auswahl benötigt.</p>
  1034. </div>
  1035. <div class="paragraph">
  1036. <p>Alles weitere benötigt zwingend ausgewählte Events, selbst wenn es nur ein einziges ist.</p>
  1037. </div>
  1038. <div class="sect2">
  1039. <h3 id="_textanmerkung">7.1. Textanmerkung</h3>
  1040. <div class="paragraph">
  1041. <p>Existiert gerade keine Auswahl ermöglicht es die rechte Maustaste auf ein Event eine Textanmerkung
  1042. zu schreiben. Sie hat keine Auswirkung auf die Musik.</p>
  1043. </div>
  1044. </div>
  1045. <div class="sect2">
  1046. <h3 id="_auswahl">7.2. Auswahl</h3>
  1047. <div class="paragraph">
  1048. <p>Das wichtigste zuerst: Ein Klick mit der rechten Maustaste ist die beste Möglichkeit die Auswahl
  1049. aufzuheben.</p>
  1050. </div>
  1051. <div class="paragraph">
  1052. <p>Hält man die Umschalten-Taste gedrückt verschwinden die Event-Symbole am Mauszeiger. Statt dessen
  1053. erhält man den normalen Zeiger und kann durch drücken, halten und ziehen ein Rechteck ziehen um
  1054. Events auszuwählen.</p>
  1055. </div>
  1056. <div class="paragraph">
  1057. <p>Zusätzliche markierte Events werden zur bestehenden Auswahl hinzugefügt.</p>
  1058. </div>
  1059. <div class="paragraph">
  1060. <p>Die Auswahl kann sich über mehrere Ebenen ausdehnen.</p>
  1061. </div>
  1062. <div class="paragraph">
  1063. <p>Die Hauptansicht scrollt automatisch wenn man mit dem Mauszeiger an den linken bzw. rechten Rand
  1064. kommt. Oft ist aber rauszoomen die bessere Methode um viele Events auf einmal zu markieren.</p>
  1065. </div>
  1066. <div class="paragraph">
  1067. <p>Das "Bearbeiten"-Menü bietet die Möglichkeit die ganze Ebene zu wählen (Strg+A) oder sogar alle
  1068. Ebenen (Strg+Umschalten+A)</p>
  1069. </div>
  1070. <div class="sect3">
  1071. <h4 id="_auswahl_umkehren">7.2.1. Auswahl umkehren</h4>
  1072. <div class="paragraph">
  1073. <p>Benutzt man die Strg-Taste, anstatt Umschalten, kehrt sich die Auswahl um: Ausgewählte Noten werden
  1074. aufgehoben, alle anderen werden markiert.</p>
  1075. </div>
  1076. <div class="paragraph">
  1077. <p>Das ist besonders nützlich wenn man einzelne Noten aus einer Auswahl herausnehmen möchte, etwa
  1078. nach Strg+A.</p>
  1079. </div>
  1080. </div>
  1081. </div>
  1082. <div class="sect2">
  1083. <h3 id="_event_position_verändern">7.3. Event-Position verändern</h3>
  1084. <div class="paragraph">
  1085. <p>Durch Drück/Halten/Ziehen mit der linken Maustaste können alle Events sowohl in ihrer zeitlichen
  1086. Position (links/rechts) als auch in ihrer Tonhöhe bzw. Event-Intensität (hoch/runter) verändert
  1087. werden.</p>
  1088. </div>
  1089. <div class="paragraph">
  1090. <p>Hält man dabei die Alt-Taste gedrückt bewegen sich Events nur noch nach links/rechts, egal ob die
  1091. Maus auch hoch und runter fährt. Das erhöht die Kontrolle und vermeidet Ausrutscher in der Tonhöhe.</p>
  1092. </div>
  1093. <div class="paragraph">
  1094. <p>Hält man dabei die Strg-Taste gedrückt bewegen sich Events nur noch nach oben/unten, egal ob die
  1095. Maus auch nach links oder rechts fährt. Das erhöht die Kontrolle und vermeidet Ausrutscher in der
  1096. Position in der Zeit.</p>
  1097. </div>
  1098. <div class="paragraph">
  1099. <p>Man kann auch die Pfeiltasten benutzen um Events Schrittweise in alle Richtungen zu verschieben.
  1100. Diese Methode ist mitunter am schnellsten und genauesten.</p>
  1101. </div>
  1102. </div>
  1103. <div class="sect2">
  1104. <h3 id="_notenlängen_verändern">7.4. Notenlängen verändern</h3>
  1105. <div class="paragraph">
  1106. <p>Noten in der Auswahl können sowohl in ihrer Dauer nach vorne, wie auch nach hinten verändert werden.
  1107. Dazu kann man mit der Maus am linken oder rechten Rand einer Note mit der linken Maustaste
  1108. drücken/halten/ziehen. Alle markierten Noten werden um das gleiche Maß verändert.</p>
  1109. </div>
  1110. <div class="paragraph">
  1111. <p>Es gibt eine Mindestdauer, die nicht unterschritten werden kann. Dabei muss nur eine der
  1112. ausgewählten Noten an diese Mindestdauer stoßen, damit der gesamte Prozess gestoppt wird.</p>
  1113. </div>
  1114. <div class="paragraph">
  1115. <p>Sind gleichzeitig Nicht-Noten markiert werden diese bei der Aktion ignoriert.</p>
  1116. </div>
  1117. </div>
  1118. <div class="sect2">
  1119. <h3 id="_raster_und_positionen_einrasten">7.5. Raster und Positionen einrasten</h3>
  1120. <div class="paragraph">
  1121. <p>Das "Raster"-Menü ermöglicht es Events auf feste Position zu setzen. Bei Programmstart ist das
  1122. Raster zunächst ausgeschaltet: freie Positionierung auf jeder Zeitposition ist möglich.</p>
  1123. </div>
  1124. <div class="paragraph">
  1125. <p>Wie die Zifferntasten Tondauern, so stellen Umschalten+Ziffern das Rhythmusraster ein.
  1126. Ein Viertelnotenraster lässt nur noch Events und Tonanfänge auf Viertelnotenpositionen zu.</p>
  1127. </div>
  1128. <div class="paragraph">
  1129. <p>Das Raster auf Achtel- oder Sechzehntelnoten zu stellen ist meistens ein guter Kompromiss zwischen
  1130. robuster Eingabe und rhythmischer Flexibilität.</p>
  1131. </div>
  1132. <div class="paragraph">
  1133. <p>Bei freier Notenlänge (Umschalten+0) ist der Anfang ans Raster gebunden, das Ende ist jedoch frei.</p>
  1134. </div>
  1135. <div class="paragraph">
  1136. <p>Beim Verändern von Notenlängen ist das Raster aktiv.</p>
  1137. </div>
  1138. </div>
  1139. <div class="sect2">
  1140. <h3 id="_notenlautstärke_velocity_verändern">7.6. Notenlautstärke / Velocity verändern</h3>
  1141. <div class="paragraph">
  1142. <p>In der Hauptansicht kann man die Lautstärken von Noten nur durch Menübefehle verändern. Eine weitere
  1143. Möglichkeit bietet die Velocityansicht (s.u.).</p>
  1144. </div>
  1145. <div class="paragraph">
  1146. <p>Das "Bearbeiten"-Menü bietet mehrere Optionen:
  1147. Man kann Velocities schrittweise erhöhen oder ernierigen. Die Tastenkürzel sind + und -.</p>
  1148. </div>
  1149. <div class="paragraph">
  1150. <p>Dazu gibt es einen Befehl, der es ermöglicht entweder relativ alle Noten zu verändern oder absolute
  1151. alle auf einen festen Wert zu setzen. Schreibt man ein "+" oder "-" vor den Wert in der Eingabezeile
  1152. wird die Änderung als relativ angesehen.</p>
  1153. </div>
  1154. <div class="paragraph">
  1155. <p>Beispiel: "+23" erhöht alle Velocities um 23. "23" setzt alle auf 23, "-42" verringert alles um
  1156. 42.</p>
  1157. </div>
  1158. <div class="paragraph">
  1159. <p>Achtung! Es wird technisch zugelassen Velocities kleiner als 0 und größer als 127 zu haben. Das ist
  1160. musikalisch nicht möglich und muss von Hand beachtet und korrigiert werden.</p>
  1161. </div>
  1162. <div class="paragraph">
  1163. <p>Ein weiterer Befehl ist es Velocities zu "komprimieren". Hierbei werden alle proportional in einen
  1164. neuen Rahmen gepresst. Zum Beispiel: Velocities 0 (niedrigster), 64 (mitte) und 127 (höchster)
  1165. werden komprimiert in den Rahmen zwischen 70 und 90. Dann bekommen wir: 70 (niedrigster), 80 (mitte),
  1166. und 90 (höchster).</p>
  1167. </div>
  1168. <div class="paragraph">
  1169. <p>Bei all diesen Befehlen werden Nicht-Noten ignoriert.</p>
  1170. </div>
  1171. </div>
  1172. <div class="sect2">
  1173. <h3 id="_kopieren_ausschneiden_einfügen">7.7. Kopieren, Ausschneiden, Einfügen</h3>
  1174. <div class="paragraph">
  1175. <p>Wie in fast allen Programmen gibt es Kopieren, Ausschneiden und Einfügen bzw. Copy, Cut, Paste.
  1176. Die üblichen Tastenkürzel werden benutzt: Strg+C, Strg+X, Strg+V.</p>
  1177. </div>
  1178. <div class="paragraph">
  1179. <p>Ausgewählten Noten werden mit Strg+C in einen Hintergrundspeicher kopiert; mit Strg+X wird die
  1180. Originalauswahl zusätzlich gelöscht. Da die Auswahl mehrere Ebenen überspannen kann, kann man auch
  1181. von mehreren Ebenen kopieren.</p>
  1182. </div>
  1183. <div class="paragraph">
  1184. <p>Mit Strg+V wird nun <strong>an der selben Stelle</strong> eine Kopie eingefügt.
  1185. Es ist möglich die Ebene zu wechseln um dort eine Kopie einzufügen.</p>
  1186. </div>
  1187. <div class="paragraph">
  1188. <p>Fügt man auf der selben Ebene ein überlagern sich die Noten zunächst, sind also "unsichtbar"!
  1189. Es ist aber nur ein Satz an Noten ausgewählt! Das heißt man kann sofort verschieben.</p>
  1190. </div>
  1191. </div>
  1192. <div class="sect2">
  1193. <h3 id="_änderungen_rückgängig_machen_undo_redo">7.8. Änderungen rückgängig machen / Undo &amp; Redo</h3>
  1194. <div class="paragraph">
  1195. <p>Strg+Z ("Undo") macht die jeweils letzte Änderung rückgängig.</p>
  1196. </div>
  1197. <div class="paragraph">
  1198. <p>Strg+Umschalten+Z ("Redo") widerruft das letzte Undo, geht also wieder einen Schritt zurück
  1199. (&#8230;&#8203;nach vorne?). Hat man inzwischen selber wieder etwas geändert ist Redo nicht mehr möglich.</p>
  1200. </div>
  1201. <div class="paragraph">
  1202. <p>Undo ist nur bis zum Zustand des Programmstarts möglich.</p>
  1203. </div>
  1204. </div>
  1205. </div>
  1206. </div>
  1207. <div class="sect1">
  1208. <h2 id="_velocityansicht">8. Velocityansicht</h2>
  1209. <div class="sectionbody">
  1210. <div class="paragraph">
  1211. <p>Am unteren Rand des Programmfensters befindet sich die Velocityansicht. Sie dient als Übersicht über
  1212. Lautstärken und ermöglicht außerdem das Verändern von Einzelnoten.</p>
  1213. </div>
  1214. <div class="paragraph">
  1215. <p>Das besondere an dieser Ansicht ist, dass sie erstens nur Noten anzeigt, und keine anderen Events,
  1216. und zweitens nur die ausgewählten Noten anzeigt. So können selbst Einzelnoten aus Akkorden genau
  1217. angesehen werden.</p>
  1218. </div>
  1219. <div class="paragraph">
  1220. <p>Die Velocityansicht zeigt alle Noten unterhalb ihrer Anfangsposition in der Hauptansicht, scrollt also mit.
  1221. Jeder Balken ist eine Note. Der Rhythmus wird nicht dargestellt; alle Balken sind gleich breit.</p>
  1222. </div>
  1223. <div class="paragraph">
  1224. <p>Zeigt der Mauszeiger auf einen Balken ändert das Mausrad die Velocity in Zweierschritten von genau
  1225. dieser einen Note.
  1226. Um Velocities aller ausgewählten Noten auf einmal zu veränden muss man jedoch die Menübefehle im
  1227. "Bearbeiten"-Menü benutzen (s.o.)</p>
  1228. </div>
  1229. </div>
  1230. </div>
  1231. <div class="sect1">
  1232. <h2 id="_verschiedenes_für_fortgeschrittene_benutzer">9. Verschiedenes für fortgeschrittene Benutzer</h2>
  1233. <div class="sectionbody">
  1234. <div class="sect2">
  1235. <h3 id="_parameter_und_einstellungen_am_anfang_des_stückes">9.1. Parameter und Einstellungen am Anfang des Stückes</h3>
  1236. <div class="paragraph">
  1237. <p>Es gibt keine verstecken Daten oder Einstellungen. Alles, was Vico sendet ist auch für den
  1238. Benutzer zu sehen. Das bedeutet vor allem, dass es keine Starteinstellungen gibt.</p>
  1239. </div>
  1240. <div class="paragraph">
  1241. <p>Zum Beispiel: Ändert man am Ende eines Stücks für z.B Geige das Instrument auf eine Bratsche
  1242. (Program Change) und spielt dann von vorne ab wird es immer noch die Bratsche sein, da das
  1243. verbundene JACK-Instrument keine Nachricht bekommen hat auf die Geige zu wechseln. Man muss also
  1244. ganz am Anfang die Geige explizit setzen. Ähnliches gilt für Pitchbend oder Control Changes wie
  1245. Klavierpedal, Modwheel, Expression etc.</p>
  1246. </div>
  1247. </div>
  1248. <div class="sect2">
  1249. <h3 id="_midi_parameter_mit_hoher_auflösung_msb_und_lsb">9.2. MIDI Parameter mit hoher Auflösung (MSB und LSB)</h3>
  1250. <div class="paragraph">
  1251. <p>Manche MIDI Parameter sind 14bit, statt der üblichen 7bit. Sie werden aus zwei Werten
  1252. zusammengesetzt. Das ist standard Midipraxis und muss an anderer Stelle gelernt werden.
  1253. Für Vico gilt, dass diese Werte auch als zwei getrennte 7bit-Einträge gesetzt werden müssen.</p>
  1254. </div>
  1255. </div>
  1256. <div class="sect2">
  1257. <h3 id="_überlappende_noten">9.3. Überlappende Noten</h3>
  1258. <div class="paragraph">
  1259. <p>Das MIDI Format verbietet nicht, dass auf ein Note-On ein weiteres Note-On der gleichen Tonhöhe
  1260. folgt, ohne dass vorher ein Note-Off kam. Ach wenn es das in den meisten Fällen wenig musikalischen
  1261. Sinn macht ist es erlaubt und von daher von Vico unterstützt. Im Allgemeinen sollte man versuchen
  1262. sich überlappende Noten der gleichen Tonhöe zu vermeiden (auch auf mehreren Ebenen, wenn diese den
  1263. selben Midikanal teilen).</p>
  1264. </div>
  1265. </div>
  1266. <div class="sect2">
  1267. <h3 id="_control_changes_sind_falsch_herum_in_vico">9.4. "Control Changes sind falsch herum in Vico!"</h3>
  1268. <div class="paragraph">
  1269. <p>Schlaue MIDI-Füchse wissen: MIDI Nachrichten haben zwei Parameter (Byte1 und Byte2). Bei Noten ist
  1270. Byte1 die Tonhöhe und Byte2 die Velocity. Bei Control Changes ist Byte1 der Typ (z.B. Volume) und
  1271. Byte2 die Intensität. Aber in Vico wird bei CCs Byte2 als Tonhöhe dargestellt, damit man diese
  1272. hoch und runter schieben kann.</p>
  1273. </div>
  1274. </div>
  1275. <div class="sect2">
  1276. <h3 id="_rundungsfehler_meine_noten_sind_an_der_falschen_stelle">9.5. Rundungsfehler: Meine Noten sind an der Falschen Stelle</h3>
  1277. <div class="paragraph">
  1278. <p>Mathematik und Computer lassen sich irgendwann nicht mehr austricksen.
  1279. Wenn bei extremer Skalierung (Strg+Umschalten+Mausrad), wenn Noten sehr stark zusammen gepresst
  1280. werden, 64tel Noten auf ein 64tel Raster gesetzt werden wollen kommt es evtl. zu Rundungsfehlern
  1281. und damit zu Fehlpositionierung um einige Pixel bzw. Midi-Ticks. Lösung: Skalierung verändern,
  1282. Noten "länger" darstellen lassen.</p>
  1283. </div>
  1284. </div>
  1285. </div>
  1286. </div>
  1287. <div class="sect1">
  1288. <h2 id="_installation_und_start">10. Installation und Start</h2>
  1289. <div class="sectionbody">
  1290. <div class="paragraph">
  1291. <p>Vico ist exklusiv für Linux. Am besten installieren Sie Vico über deinen Paketmanager.
  1292. Falls es dort nicht vorhanden ist, oder nur in einer veralteten Version, bitten sie ihre
  1293. Linuxdistribution Vico bereitzustellen.</p>
  1294. </div>
  1295. <div class="paragraph">
  1296. <p>Falls in den Paketquellen vorhanden bitte direkt bei "vico in Agordejo (New Session Manager)" weiterlesen.
  1297. Falls nicht kann man Vico auch selbst "bauen".</p>
  1298. </div>
  1299. <div class="ulist">
  1300. <div class="title">Abhängigkeiten*</div>
  1301. <ul>
  1302. <li>
  1303. <p>Eine Liste der Abhängigkeit befindet sich in der README.md</p>
  1304. </li>
  1305. <li>
  1306. <p>Kompilieren und Installieren geht entweder mit einem Releasedownload oder mit der Git-Version:</p>
  1307. <div class="ulist">
  1308. <ul>
  1309. <li>
  1310. <p>Laden Sie von <a href="https://www.laborejo.org/downloads" class="bare">https://www.laborejo.org/downloads</a> die aktuelle Version herunter und entpacken Sie sie.</p>
  1311. </li>
  1312. <li>
  1313. <p><code>git clone <a href="https://git.laborejo.org/lss/vico.git" class="bare">https://git.laborejo.org/lss/vico.git</a></code></p>
  1314. </li>
  1315. </ul>
  1316. </div>
  1317. </li>
  1318. <li>
  1319. <p>Wechseln Sie in das neue Verzeichnis und benutzen diese Befehle:
  1320. *<code>./configure --prefix=/usr</code></p>
  1321. <div class="ulist">
  1322. <ul>
  1323. <li>
  1324. <p>Das Standardprefix is /usr/local</p>
  1325. </li>
  1326. </ul>
  1327. </div>
  1328. </li>
  1329. <li>
  1330. <p><code>make</code></p>
  1331. </li>
  1332. <li>
  1333. <p><code>sudo make install</code></p>
  1334. </li>
  1335. </ul>
  1336. </div>
  1337. <div class="ulist">
  1338. <div class="title">vico im Agordejo (New Session Manager, NSM) starten</div>
  1339. <ul>
  1340. <li>
  1341. <p>Starten Sie <code>agordejo</code></p>
  1342. </li>
  1343. <li>
  1344. <p>Erstellen Sie eine neue Session, geben Sie einen Namen für das Musikstück ein.</p>
  1345. </li>
  1346. <li>
  1347. <p>Benutzen Sie den Launcher um <code>vico</code> hinzuzufügen.</p>
  1348. </li>
  1349. <li>
  1350. <p>Fügen Sie beliebige kompatible Programme hinzu, z.B. Synthesizer.</p>
  1351. </li>
  1352. </ul>
  1353. </div>
  1354. <div class="paragraph">
  1355. <p>In der Datei README.md befinden sich weitere Möglichkeiten vico zu starten. Diese sind zum
  1356. Musikmachen nicht praktikabel, aber nützlich für Tests und Entwicklung.</p>
  1357. </div>
  1358. </div>
  1359. </div>
  1360. <div class="sect1">
  1361. <h2 id="_helfen_und_entwicklung">11. Helfen und Entwicklung</h2>
  1362. <div class="sectionbody">
  1363. <div class="paragraph">
  1364. <p>Sie können Vico auf viele Arten und Weisen helfen: Testen und Fehler melden, übersetzen, marketing,
  1365. anderen Nutzern helfen und schließlich programmieren.</p>
  1366. </div>
  1367. <div class="sect2">
  1368. <h3 id="_testen_und_programmfehler">11.1. Testen und Programmfehler</h3>
  1369. <div class="paragraph">
  1370. <p>Falls Sie einen Fehler im Programm entdecken (oder es zu langsam läuft) melden Sie diese bitte auf
  1371. eine Art und Weise, die ihnen am besten passt.</p>
  1372. </div>
  1373. <div class="ulist">
  1374. <div class="title">Kontaktmöglichkeiten</div>
  1375. <ul>
  1376. <li>
  1377. <p>Bugs und Probleme melden: <a href="https://www.laborejo.org/bugs" class="bare">https://www.laborejo.org/bugs</a></p>
  1378. </li>
  1379. <li>
  1380. <p>Webseite: <a href="https://www.laborejo.org" class="bare">https://www.laborejo.org</a></p>
  1381. </li>
  1382. <li>
  1383. <p>E-Mail: <a href="mailto:info@laborejo.org">info@laborejo.org</a></p>
  1384. </li>
  1385. <li>
  1386. <p>Wenn Sie die Gelegenheiten sehen und wissen, dass ein Entwickler es lesen wird sind auch Foren, Socialmedia etc. möglich.</p>
  1387. </li>
  1388. </ul>
  1389. </div>
  1390. </div>
  1391. </div>
  1392. </div>
  1393. <div class="sect1">
  1394. <h2 id="_entwicklung">12. Entwicklung</h2>
  1395. <div class="sectionbody">
  1396. <div class="paragraph">
  1397. <p>Falls Sie an der Entwicklung interessiert sind, melden Sie sich am besten direkt bei uns (s.o.)
  1398. Kurzversion: clone git, programmieren, einen git-patch erstellen oder uns eine git URL zukommen lassen.</p>
  1399. </div>
  1400. <div class="sect2">
  1401. <h3 id="_übersetzungen">12.1. Übersetzungen</h3>
  1402. <div class="paragraph">
  1403. <p>Vico ist mit Hilfe der Qt-Toolchain sehr einfach zu übersetzen, ohne, dass man dafür Programmieren muss.
  1404. Die einfachste Variante ist es einfach die Entwickler anzusprechen und sie werden die neue Sprache einrichten.</p>
  1405. </div>
  1406. <div class="paragraph">
  1407. <p>Hier ist dennoch die komplette Anleitung, um eine Übersetzung komplett alleine anzufertigen und in
  1408. das Programm einzubinden. Das Programm ist in zwei Teile aufgeteilt: Ein gemeinsames "Template"
  1409. (für alle Laborejo Software Suit Programme) sowie das eigentliche Programm.</p>
  1410. </div>
  1411. <div class="paragraph">
  1412. <p>Der Übersetzungsprozess ist der gleiche für beide Teile, man muss ihn jedoch in unterschiedlichen
  1413. Verzeichnissen durchführen:
  1414. <code>template/qtgui</code> und nur <code>/qtgui</code>, relativ zum Stammverzeichnis, wo sich die ausführbare Datei
  1415. vico befindet.</p>
  1416. </div>
  1417. <div class="paragraph">
  1418. <p>Jedes "template/qtgui" hier kann durch nur "qtgui" ersetzt werden um den zweiten Teil zu übersetzen.</p>
  1419. </div>
  1420. <div class="paragraph">
  1421. <p>So fügt man eine neue Sprache hinzu:</p>
  1422. </div>
  1423. <div class="ulist">
  1424. <ul>
  1425. <li>
  1426. <p>Öffnen Sie ein Terminal und navigieren zu template/qtgui/resources/translations</p>
  1427. </li>
  1428. <li>
  1429. <p>Bearbeiten Sie die Datei <code>config.pro</code> in einem Texteditor.</p>
  1430. <div class="ulist">
  1431. <ul>
  1432. <li>
  1433. <p>Hängem Sie in der letzten Zeile den Namen der neuen Sprache an, in der Form <code>XY.ts</code>, wobei XY der Sprachcode ist.</p>
  1434. </li>
  1435. <li>
  1436. <p>Achten Sie bitte darauf ein Leerzeichen zwischen den einzelnen Sprachen zu lassen</p>
  1437. </li>
  1438. </ul>
  1439. </div>
  1440. </li>
  1441. <li>
  1442. <p>Führen Sie <code>sh update.sh</code> im selben Verzeichnis aus.</p>
  1443. <div class="ulist">
  1444. <ul>
  1445. <li>
  1446. <p>Das Programm hat nun eine neue <code>.ts</code>-Datei im Verzeichnis erstellt.</p>
  1447. </li>
  1448. </ul>
  1449. </div>
  1450. </li>
  1451. <li>
  1452. <p>Starten Sie Qt Linguist mit <code>linguist-qt5</code> (kann evtl. anders heißen) und öffnen von dort die neu generierte Datei.</p>
  1453. </li>
  1454. <li>
  1455. <p>Wählen Sie die "Target Language", also Zielsprache, aus und benutzen das Programm um eine Übersetzung anzufertigen.</p>
  1456. </li>
  1457. <li>
  1458. <p>Senden Sie uns bitte die .ts Datei, z.B. per E-Mail an <a href="mailto:info@laborejo.org">info@laborejo.org</a> (s.u bei Bugs und Programmfehler für mehr Kontaktmöglichkeiten)</p>
  1459. </li>
  1460. </ul>
  1461. </div>
  1462. <div class="paragraph">
  1463. <p>Die Übersetzung können Sie auch selbst, zum Testen, einbinden. Dafür sind rudimentäre
  1464. Python Kentnisse nötig.</p>
  1465. </div>
  1466. <div class="ulist">
  1467. <ul>
  1468. <li>
  1469. <p>Im Qt Linguist "Datei" Menü ist eine "Release" Option. Das erstellt eine <code>.qm</code> Datei im gleichen Verzeichnis wie die <code>.ts</code> Datei.* Bearbeiten Sie <code>template/qtgui/resources/resources.qrc</code> und kopieren die Zeile <code>&lt;file&gt;translations/de.qm&lt;/file&gt;</code> . Dabei das Länderkürzel zum Neuen ändern.</p>
  1470. </li>
  1471. <li>
  1472. <p>Führen Sie <code>sh buildresources.sh</code> aus</p>
  1473. </li>
  1474. <li>
  1475. <p>Bearbeiten Sie <code>engine/config.py</code>: Die neue Sprache hinzufügen. z.B. <code>{"German":"de.qm", "Esperanto:"eo.qm"}</code></p>
  1476. <div class="ulist">
  1477. <ul>
  1478. <li>
  1479. <p>Um den Sprachstring herauszufinden öffnen Sie den <code>python3</code>-Interpreter im Terminal und führen aus:</p>
  1480. </li>
  1481. <li>
  1482. <p><code>from PyQt5 import QtCore;QtCore.QLocale().languageToString(QtCore.QLocale().language())</code></p>
  1483. </li>
  1484. </ul>
  1485. </div>
  1486. </li>
  1487. </ul>
  1488. </div>
  1489. <div class="paragraph">
  1490. <p>Um die neue Übersetzung zu testen starten Sie das Programm, falls ihr System bereits auf diese
  1491. Sprache eingstellt ist.
  1492. Ansonsten starten Sie vico mit diesem Befehl, Sprachcode ändern, vom Terminal aus:</p>
  1493. </div>
  1494. <div class="ulist">
  1495. <ul>
  1496. <li>
  1497. <p><code>LANGUAGE=de_DE.UTF-8 ./vico -V</code></p>
  1498. </li>
  1499. </ul>
  1500. </div>
  1501. </div>
  1502. </div>
  1503. </div>
  1504. </div>
  1505. <div id="footer">
  1506. <div id="footer-text">
  1507. Last updated 2021-01-18 00:43:11 +0100
  1508. </div>
  1509. </div>
  1510. </body>
  1511. </html>