vexflow.d.ts 11 KB

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