vexflow.d.ts 12 KB

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