vexflow.d.ts 12 KB

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