vexflow.d.ts 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429
  1. declare namespace Vex {
  2. export module Flow {
  3. const RESOLUTION: any;
  4. const DEFAULT_NOTATION_FONT_SCALE: number;
  5. export class Formatter {
  6. constructor();
  7. public hasMinTotalWidth: boolean;
  8. public minTotalWidth: number;
  9. public joinVoices(voices: Voice[]): void;
  10. public format(voices: Voice[], width: number, options?: any): void;
  11. public preCalculateMinTotalWidth(voices: Voice[]): number;
  12. }
  13. export class BoundingBox {
  14. constructor(x: number, y: number, w: number, h: number);
  15. public mergeWith(bb: BoundingBox): BoundingBox;
  16. public x: number;
  17. public y: number;
  18. public w: number;
  19. public h: number;
  20. public draw(ctx: Vex.Flow.RenderContext): void;
  21. }
  22. export class Tickable {
  23. public reset(): void;
  24. public setStave(stave: Stave);
  25. public getBoundingBox(): BoundingBox;
  26. public getAttribute(arg: string): string;
  27. }
  28. export class Voice {
  29. constructor(time: any);
  30. public static Mode: any;
  31. public context: RenderContext;
  32. public tickables: Tickable[];
  33. public getBoundingBox(): BoundingBox;
  34. public setStave(stave: Stave): Voice;
  35. public addTickables(tickables: Tickable[]): Voice;
  36. public addTickable(tickable: Tickable): Voice;
  37. public setMode(mode: any): Voice;
  38. public draw(ctx: any, stave: Stave): void;
  39. }
  40. export class Note extends Tickable {
  41. public addStroke(index: number, stroke: Stroke): void;
  42. }
  43. class NoteHead extends Note {
  44. constructor(head_options: Object);
  45. static CATEGORY(): string;
  46. }
  47. export class TextBracket {
  48. constructor(note_struct: any);
  49. public setContext(ctx: RenderContext): TextBracket;
  50. public draw(): void;
  51. }
  52. export class TextNote extends Note {
  53. constructor(note_struct: any);
  54. public setContext(ctx: RenderContext): TextBracket;
  55. public draw(): void;
  56. }
  57. export class Stem {
  58. public static UP: number;
  59. public static DOWN: number;
  60. }
  61. export class StemmableNote extends Note {
  62. public getStemDirection(): number;
  63. public setStemDirection(direction: number): StemmableNote;
  64. public x_shift: number;
  65. public getAbsoluteX(): number;
  66. public addModifier(index: number, modifier: Modifier): StemmableNote;
  67. public preFormatted: boolean;
  68. }
  69. export class GhostNote extends StemmableNote {
  70. constructor(note_struct: any);
  71. public setStave(stave): void;
  72. }
  73. export class StaveNote extends StemmableNote {
  74. constructor(note_struct: any);
  75. public getNoteHeadBounds(): any;
  76. public getNoteHeadBeginX(): number;
  77. public getNoteHeadEndX(): number;
  78. public getGlyphWidth(): number;
  79. public addAccidental(index: number, accidental: Accidental): StaveNote;
  80. public addAnnotation(index: number, annotation: Annotation): StaveNote;
  81. public addDotToAll(): void;
  82. public addModifier(index: number, modifier: Modifier): StaveNote;
  83. public setStyle(style: any): void;
  84. public setStemStyle(style: any): void;
  85. public setFlagStyle(style: any): void;
  86. public getKeyProps(): Object[];
  87. // temp solution until noteheadStyles PR is through
  88. public note_heads: any; // NoteHead[];
  89. public flag: Element;
  90. public beam: Beam;
  91. }
  92. export class GraceNote extends StaveNote {
  93. static SCALE: number;
  94. static LEDGER_LINE_OFFSET: number;
  95. constructor(note_struct: any);
  96. }
  97. export class GraceNoteGroup extends Modifier {
  98. constructor(grace_notes: GraceNote[], show_slur: boolean);
  99. public beamNotes(): GraceNoteGroup;
  100. }
  101. export class StaveTie {
  102. constructor(notes_struct: any);
  103. public setContext(ctx: RenderContext): StaveTie;
  104. public draw(): void;
  105. }
  106. export class Stave {
  107. constructor(x: number, y: number, width: number, options: any);
  108. public setX(x: number): Stave;
  109. public setY(y: number): Stave;
  110. public getX(): number;
  111. public setBegBarType(type: any): Stave;
  112. public setEndBarType(type: any): Stave;
  113. public addClef(clefSpec: string, size: any, annotation: any, position: any): void;
  114. public setEndClef(clefSpec: string, size: any, annotation: any): void;
  115. public getModifiers(): StaveModifier[];
  116. public getYForGlyphs(): number;
  117. public getWidth(): number;
  118. public setWidth(width: number): Stave;
  119. public getNoteStartX(): number;
  120. public getModifierXShift(): number;
  121. public getNoteEndX(): number;
  122. public setNoteStartX(x: number): Stave;
  123. public setKeySignature(keySpec: any, cancelKeySpec: any, position: any): Stave;
  124. public setText(text: string, position: number, options: any): void;
  125. public format(): void;
  126. public getSpacingBetweenLines(): number;
  127. public getNumLines(): number;
  128. public getLineForY(y: number): number;
  129. public getYForLine(y: number): number;
  130. public getModifiers(pos: any, cat: any): Clef[]; // FIXME
  131. public setContext(ctx: RenderContext): Stave;
  132. public addModifier(mod: any, pos: any): void;
  133. public draw(): void;
  134. public addTimeSignature(sig: string): void;
  135. public setVoltaType(type: number, number_t: number, y: number): void;
  136. public setTempo(tempo: Object, y: number): Stave;
  137. public setShiftX(x: number): Stave;
  138. }
  139. export class StaveTempo extends StaveModifier { // needs Vexflow PR to be exported/usable
  140. constructor(tempo: Object, x: number, shift_y: number);
  141. }
  142. export class Volta extends StaveModifier {
  143. public static type: any;
  144. }
  145. export class Modifier {
  146. public static Position: any;
  147. public getCategory(): string;
  148. public getWidth(): number;
  149. public getPadding(index: number): number;
  150. public getPosition(): number;
  151. public setPosition(position: number): Modifier;
  152. public setIndex(index: number): void;
  153. }
  154. export class FretHandFinger extends Modifier {
  155. constructor(finger: string);
  156. }
  157. export class StringNumber extends Modifier {
  158. constructor(string: string);
  159. setOffsetY(value: number);
  160. }
  161. export class Stroke extends Modifier {
  162. constructor(type: number);
  163. public static Type: any; // unreliable values, use Arpeggio.ArpeggioType instead
  164. }
  165. export class NoteSubGroup extends Modifier {
  166. constructor(notes: Object);
  167. }
  168. export class StaveModifier extends Modifier {
  169. public getPosition(): number;
  170. }
  171. export class Repetition extends StaveModifier {
  172. constructor(type: any, x: number, y_shift: number);
  173. }
  174. export class Clef extends StaveModifier {
  175. constructor(type: string, size: string, annotation: string);
  176. public static category: string;
  177. public static types: { [type: string]: any; };
  178. public glyph: any;
  179. public x: number;
  180. public stave: Stave;
  181. public getBoundingBox(): BoundingBox;
  182. public setStave(stave: Stave): void;
  183. }
  184. export class ClefNote extends Note {
  185. constructor(type: string, size: string, annotation: string);
  186. public type: string;
  187. }
  188. export class Renderer {
  189. constructor(canvas: HTMLElement, backend: number);
  190. public static Backends: {
  191. CANVAS: number,
  192. RAPHAEL: number,
  193. SVG: number,
  194. VML: number
  195. };
  196. public resize(a: number, b: number): void;
  197. public getContext(): CanvasContext | SVGContext;
  198. }
  199. export class TimeSignature extends StaveModifier {
  200. constructor(timeSpec: string, customPadding?: any);
  201. }
  202. export class KeySignature extends StaveModifier {
  203. constructor(keySpec: string, cancelKeySpec: string, alterKeySpec?: string);
  204. }
  205. export class Accidental {
  206. constructor(type: string);
  207. }
  208. export class Annotation {
  209. constructor(type: string);
  210. }
  211. export class Articulation extends Modifier {
  212. constructor(type: string);
  213. }
  214. export class Ornament extends Modifier {
  215. constructor(type: string);
  216. setDelayed(delayed: boolean): void;
  217. setUpperAccidental(acc: string): void;
  218. setLowerAccidental(acc: string): void;
  219. }
  220. export class Tremolo extends Modifier {
  221. constructor(numberOfSlashes: number);
  222. }
  223. export class Beam {
  224. constructor(notes: StaveNote[], auto_stem: boolean);
  225. public setContext(ctx: RenderContext): Beam;
  226. public draw(): void;
  227. public static generateBeams(notes: Vex.Flow.StemmableNote[], optionsObject?: any): Beam[];
  228. public setStyle(style: any): void;
  229. }
  230. export class Fraction { // Vex.Flow.Fraction, used for generateBeams
  231. constructor(nominator: number, denominator: number);
  232. }
  233. export class Tuplet {
  234. constructor(notes: StaveNote[], options: any);
  235. public setContext(ctx: RenderContext): Tuplet;
  236. public draw(): void;
  237. }
  238. // interface for class Curve to draw slurs. The options are set to undefined
  239. export class Curve {
  240. constructor(from: StemmableNote, to: StemmableNote, options: any);
  241. public setContext(ctx: RenderContext): Curve;
  242. public draw(): void;
  243. }
  244. export class RenderContext {
  245. public scale(x: number, y: number): RenderContext;
  246. public fillRect(x: number, y: number, width: number, height: number): RenderContext
  247. public fillText(text: string, x: number, y: number): RenderContext;
  248. public setFont(family: string, size: number, weight: string): RenderContext;
  249. public beginPath(): RenderContext;
  250. public moveTo(x, y): RenderContext;
  251. public lineTo(x, y): RenderContext;
  252. public bezierCurveTo(cp1_x: number, cp1_y: number, cp2_x: number, cp2_y: number, end_x: number, end_y: number): RenderContext;
  253. public closePath(): RenderContext;
  254. public stroke(): RenderContext;
  255. public fill(): RenderContext;
  256. public save(): RenderContext;
  257. public restore(): RenderContext;
  258. public lineWidth: number;
  259. }
  260. export class CanvasContext extends RenderContext {
  261. public vexFlowCanvasContext: CanvasRenderingContext2D;
  262. }
  263. export class SVGContext extends RenderContext {
  264. public svg: SVGElement;
  265. public attributes: any;
  266. public state: any;
  267. }
  268. export class StaveConnector {
  269. constructor(top: Stave, bottom: Stave);
  270. public static type: any;
  271. public setType(type: any): StaveConnector;
  272. public setContext(ctx: RenderContext): StaveConnector;
  273. public setXShift(shift: number): StaveConnector;
  274. public top_stave: Stave;
  275. public bottom_stave: Stave;
  276. public thickness: number;
  277. public width: number;
  278. public x_shift: number;
  279. public draw(): void;
  280. }
  281. }
  282. }
  283. declare module "vexflow" {
  284. export = Vex;
  285. }