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.

566 lines
17KB

  1. /* SpiralPlugin
  2. * Copyleft (C) 2000 David Griffiths <dave@pawfal.org>
  3. *
  4. * This program is free software; you can redistribute it and/or modify
  5. * it under the terms of the GNU General Public License as published by
  6. * the Free Software Foundation; either version 2 of the License, or
  7. * (at your option) any later version.
  8. *
  9. * This program is distributed in the hope that it will be useful,
  10. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  12. * GNU General Public License for more details.
  13. *
  14. * You should have received a copy of the GNU General Public License
  15. * along with this program; if not, write to the Free Software
  16. * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  17. */
  18. #include "MatrixPluginGUI.h"
  19. #include <FL/fl_draw.h>
  20. #include <FL/fl_draw.H>
  21. //#include <FL/fl_file_chooser.h>
  22. static const char NoteText[12][3] = {"C","C#","D","D#","E","F","F#","G","G#","A","A#","B"};
  23. ////////////////////////////////////////////
  24. Fl_MatrixButton::Fl_MatrixButton(int x, int y, int w, int h, char* n) :
  25. Fl_Button(x,y,w,h,n),
  26. m_Volume(NULL),
  27. m_SelCol(FL_BLUE),
  28. cb_VolChange(NULL),
  29. cb_context(NULL)
  30. {
  31. m_SliderHidden=true;
  32. m_VolVal=255;
  33. }
  34. int Fl_MatrixButton::handle(int event)
  35. {
  36. if (value()==true && event==FL_PUSH && Fl::event_button()==3)
  37. {
  38. if (m_SliderHidden)
  39. {
  40. m_Volume = new Fl_Slider(x(),y()+h(),w(),50,"");
  41. m_Volume->type(4);
  42. m_Volume->selection_color(m_SelCol);
  43. m_Volume->maximum(255);
  44. m_Volume->step(1);
  45. m_Volume->value(255-m_VolVal);
  46. m_Volume->user_data((void*)this);
  47. m_Volume->callback((Fl_Callback*)cb_Vol);
  48. m_Volume->show();
  49. parent()->add(m_Volume);
  50. parent()->redraw();
  51. m_SliderHidden=false;
  52. }
  53. else
  54. {
  55. m_Volume->hide();
  56. m_VolVal=255-m_Volume->value();
  57. parent()->remove(m_Volume);
  58. parent()->redraw();
  59. m_Volume=NULL;
  60. m_SliderHidden=true;
  61. }
  62. return 1;
  63. }
  64. if (event==FL_PUSH && Fl::event_button()==1 && !m_SliderHidden)
  65. {
  66. m_Volume->hide();
  67. m_VolVal=255-m_Volume->value();
  68. parent()->remove(m_Volume);
  69. parent()->redraw();
  70. m_Volume=NULL;
  71. m_SliderHidden=true;
  72. }
  73. if (Fl::event_button()!=3) return Fl_Button::handle(event);
  74. return 1;
  75. }
  76. inline void Fl_MatrixButton::cb_Vol_i(Fl_Slider* o, void* v)
  77. {
  78. m_VolVal=255-m_Volume->value();
  79. fl_color((char)m_VolVal,(char)m_VolVal,255);
  80. selection_color(fl_color());
  81. if (cb_VolChange) cb_VolChange(this,cb_context);
  82. redraw();
  83. }
  84. void Fl_MatrixButton::cb_Vol(Fl_Slider* o, void* v)
  85. { ((Fl_MatrixButton*)(o->user_data()))->cb_Vol_i(o,v);}
  86. ////////////////////////////////////////////
  87. MatrixPluginGUI::MatrixPluginGUI(int w, int h,MatrixPlugin *o,ChannelHandler *ch,const HostInfo *Info) :
  88. SpiralPluginGUI(w,h,o,ch),
  89. m_LastLight(0),
  90. m_LastPatSeqLight(0)
  91. {
  92. //size_range(10,10);
  93. m_Pattern = new Fl_Counter (5, 20, 40, 20, "View");
  94. m_Pattern->labelsize (10);
  95. m_Pattern->type (FL_SIMPLE_COUNTER);
  96. m_Pattern->box (FL_PLASTIC_UP_BOX);
  97. m_Pattern->color (Info->GUI_COLOUR);
  98. m_Pattern->step (1);
  99. m_Pattern->minimum (0);
  100. m_Pattern->maximum (NUM_PATTERNS-1);
  101. m_Pattern->value (0);
  102. m_Pattern->callback ((Fl_Callback*)cb_Pattern);
  103. add (m_Pattern);
  104. m_PlayPattern = new Fl_Counter (50, 20, 40, 20, "Play");
  105. m_PlayPattern->labelsize (10);
  106. m_PlayPattern->type (FL_SIMPLE_COUNTER);
  107. m_PlayPattern->box (FL_PLASTIC_UP_BOX);
  108. m_PlayPattern->color (Info->GUI_COLOUR);
  109. m_PlayPattern->step (1);
  110. m_PlayPattern->minimum (0);
  111. m_PlayPattern->maximum (NUM_PATTERNS-1);
  112. m_PlayPattern->value (0);
  113. m_PlayPattern->callback ((Fl_Callback*)cb_PlayPattern);
  114. add (m_PlayPattern);
  115. m_Length = new Fl_Counter (5, 55, 40, 20, "Length");
  116. m_Length->labelsize (10);
  117. m_Length->type (FL_SIMPLE_COUNTER);
  118. m_Length->box (FL_PLASTIC_UP_BOX);
  119. m_Length->color (Info->GUI_COLOUR);
  120. m_Length->step (1);
  121. m_Length->value (64);
  122. m_Length->minimum (1);
  123. m_Length->maximum (64);
  124. m_Length->callback ((Fl_Callback*)cb_Length);
  125. add (m_Length);
  126. m_Octave = new Fl_Counter(5, 90, 40, 20, "Octave");
  127. m_Octave->labelsize(10);
  128. m_Octave->type (FL_SIMPLE_COUNTER);
  129. m_Octave->box (FL_PLASTIC_UP_BOX);
  130. m_Octave->color (Info->GUI_COLOUR);
  131. m_Octave->minimum (0);
  132. m_Octave->maximum (6);
  133. m_Octave->step (1);
  134. m_Octave->value (0);
  135. m_Octave->callback((Fl_Callback*)cb_Octave);
  136. add (m_Octave);
  137. m_Speed = new Fl_Knob (50, 60, 40, 40, "Speed");
  138. m_Speed->color (Info->GUI_COLOUR);
  139. m_Speed->type (Fl_Knob::DOTLIN);
  140. m_Speed->labelsize (10);
  141. m_Speed->minimum (0);
  142. m_Speed->maximum (200);
  143. m_Speed->step (0.01);
  144. m_Speed->value (8);
  145. m_Speed->callback ((Fl_Callback*)cb_Speed);
  146. add (m_Speed);
  147. m_SpeedVal = new Fl_Counter (5, 125, 85, 20, "");
  148. m_SpeedVal->labelsize (10);
  149. m_SpeedVal->value (10);
  150. m_SpeedVal->type (FL_SIMPLE_COUNTER);
  151. m_SpeedVal->box (FL_PLASTIC_UP_BOX);
  152. m_SpeedVal->color (Info->GUI_COLOUR);
  153. m_SpeedVal->step (1);
  154. m_SpeedVal->maximum (200);
  155. m_SpeedVal->minimum (0);
  156. m_SpeedVal->value (8);
  157. m_SpeedVal->callback ((Fl_Callback*)cb_SpeedVal);
  158. add (m_SpeedVal);
  159. m_CopyBtn = new Fl_Button (5, 150, 40, 20, "Copy");
  160. m_CopyBtn->labelsize (10);
  161. m_CopyBtn->box (FL_PLASTIC_UP_BOX);
  162. m_CopyBtn->color (Info->GUI_COLOUR);
  163. m_CopyBtn->selection_color (Info->GUI_COLOUR);
  164. m_CopyBtn->callback ((Fl_Callback*)cb_CopyBtn);
  165. add (m_CopyBtn);
  166. m_PasteBtn = new Fl_Button (50, 150, 40, 20, "Paste");
  167. m_PasteBtn->labelsize (10);
  168. m_PasteBtn->box (FL_PLASTIC_UP_BOX);
  169. m_PasteBtn->color (Info->GUI_COLOUR);
  170. m_PasteBtn->selection_color (Info->GUI_COLOUR);
  171. m_PasteBtn->deactivate();
  172. m_PasteBtn->callback ((Fl_Callback*)cb_PasteBtn);
  173. add (m_PasteBtn);
  174. m_ClearBtn = new Fl_Button (5, 175, 85, 20, "Clear");
  175. m_ClearBtn->labelsize (10);
  176. m_ClearBtn->box (FL_PLASTIC_UP_BOX);
  177. m_ClearBtn->color (Info->GUI_COLOUR);
  178. m_ClearBtn->selection_color (Info->GUI_COLOUR);
  179. m_ClearBtn->callback ((Fl_Callback*)cb_ClearBtn);
  180. add (m_ClearBtn);
  181. m_TransUpBtn = new Fl_Button (5, 200, 40, 20, "Up");
  182. m_TransUpBtn->labelsize (10);
  183. m_TransUpBtn->box (FL_PLASTIC_UP_BOX);
  184. m_TransUpBtn->color (Info->GUI_COLOUR);
  185. m_TransUpBtn->selection_color (Info->GUI_COLOUR);
  186. m_TransUpBtn->callback ((Fl_Callback*)cb_TransUpBtn);
  187. add (m_TransUpBtn);
  188. m_TransDnBtn = new Fl_Button (50, 200, 40, 20, "Down");
  189. m_TransDnBtn->labelsize (10);
  190. m_TransDnBtn->box (FL_PLASTIC_UP_BOX);
  191. m_TransDnBtn->color (Info->GUI_COLOUR);
  192. m_TransDnBtn->selection_color (Info->GUI_COLOUR);
  193. m_TransDnBtn->callback ((Fl_Callback*)cb_TransDnBtn);
  194. add (m_TransDnBtn);
  195. m_TransLbl = new Fl_Box (5, 216, 85, 20, "Transpose");
  196. m_TransLbl->labelsize(10);
  197. add (m_TransLbl);
  198. m_NoteCut = new Fl_Button (5, h-30, 85, 20, "NoteCut");
  199. m_NoteCut->type (FL_TOGGLE_BUTTON);
  200. m_NoteCut->box (FL_PLASTIC_UP_BOX);
  201. m_NoteCut->color (Info->GUI_COLOUR);
  202. m_NoteCut->selection_color (Info->GUI_COLOUR);
  203. m_NoteCut->labelsize (10);
  204. m_NoteCut->value (0);
  205. m_NoteCut->callback ((Fl_Callback*)cb_NoteCut);
  206. add (m_NoteCut);
  207. int xoff=105;
  208. int yoff=40;
  209. int butsize=7;
  210. int n=0;
  211. fl_color(150,150,150);
  212. int markercol=fl_color();
  213. fl_color(170,170,170);
  214. int blcolour=fl_color();
  215. for(int x=0; x<MATX; x++)
  216. for(int y=0; y<MATY; y++)
  217. {
  218. Numbers[n]=n;
  219. m_Matrix[x][y] = new Fl_MatrixButton(xoff+x*butsize,yoff+((MATY-1)*butsize)-(y*butsize),butsize+1,butsize+1,"");
  220. m_Matrix[x][y]->type(1);
  221. m_Matrix[x][y]->box(FL_BORDER_BOX);
  222. m_Matrix[x][y]->SetSelColour (Info->GUI_COLOUR);
  223. if ((x%8)==0) m_Matrix[x][y]->color(markercol);
  224. else if ((y%12)==1 || (y%12)==3 || (y%12)==6 || (y%12)==8 || (y%12)==10) m_Matrix[x][y]->color(blcolour);
  225. else m_Matrix[x][y]->color(FL_GRAY);
  226. m_Matrix[x][y]->selection_color(FL_WHITE);
  227. m_Matrix[x][y]->callback((Fl_Callback*)cb_Matrix,(void*)&Numbers[n]);
  228. m_Matrix[x][y]->SetVolCallback((Fl_Callback*)cb_MatVol,(void*)&Numbers[n]);
  229. add(m_Matrix[x][y]);
  230. n++;
  231. }
  232. yoff=37;
  233. for(int y=0; y<MATY; y++)
  234. {
  235. Fl_Box *box = new Fl_Box(90,yoff+((MATY-1)*butsize)-(y*butsize),15,15,NoteText[y%12]);
  236. box->align(FL_ALIGN_INSIDE|FL_ALIGN_LEFT);
  237. box->labelsize(8);
  238. }
  239. xoff=103;
  240. for(int x=0; x<MATX; x++)
  241. {
  242. m_Flash[x] = new Fl_LED_Button(xoff+x*butsize,20,15,15,"");
  243. m_Flash[x]->selection_color(FL_WHITE);
  244. add(m_Flash[x]);
  245. }
  246. xoff=560;
  247. yoff=40;
  248. int height=12,gap=2;
  249. Fl_Box *patseqlabel = new Fl_Box(xoff,yoff-15,30,10,"Pat Seq");
  250. patseqlabel->labelsize(10);
  251. add(patseqlabel);
  252. for(int y=0; y<NUM_PATSEQ; y++)
  253. {
  254. m_PatSeq[y]= new Fl_Counter(xoff,yoff+y*(height+gap),25,height);
  255. m_PatSeq[y]->type(FL_SIMPLE_COUNTER);
  256. m_PatSeq[y]->step(1);
  257. m_PatSeq[y]->textsize(8);
  258. m_PatSeq[y]->minimum (-1);
  259. m_PatSeq[y]->maximum (NUM_PATTERNS-1);
  260. m_PatSeq[y]->callback((Fl_Callback*)cb_PatSeq,(void*)&Numbers[y]);
  261. add(m_PatSeq[y]);
  262. m_PatSeqFlash[y] = new Fl_LED_Button(xoff+25,yoff+y*(height+gap),15,15,"");
  263. m_PatSeqFlash[y]->selection_color(FL_WHITE);
  264. add(m_PatSeqFlash[y]);
  265. }
  266. end();
  267. }
  268. void MatrixPluginGUI::Update()
  269. {
  270. int Light=m_GUICH->GetInt("Step");
  271. if (Light!=m_LastLight)
  272. {
  273. m_Flash[Light]->value(1);
  274. m_Flash[m_LastLight]->value(0);
  275. m_LastLight=Light;
  276. m_PlayPattern->value (m_GUICH->GetInt("EchoCur"));
  277. int PatSeqLight=m_GUICH->GetInt("PatSeqStep");
  278. if (PatSeqLight!=m_LastPatSeqLight)
  279. {
  280. m_PatSeqFlash[PatSeqLight]->value(1);
  281. m_PatSeqFlash[m_LastPatSeqLight]->value(0);
  282. m_LastPatSeqLight=PatSeqLight;
  283. }
  284. }
  285. }
  286. void MatrixPluginGUI::UpdateValues(SpiralPlugin *o)
  287. {
  288. MatrixPlugin *Plugin = (MatrixPlugin*)o;
  289. m_Pattern->value(Plugin->GetCurrent());
  290. m_Length->value(Plugin->GetPattern()->Length);
  291. m_Speed->value(Plugin->GetPattern()->Speed*8);
  292. m_SpeedVal->value((int)m_Speed->value());
  293. m_Octave->value(Plugin->GetPattern()->Octave);
  294. for(int x=0; x<MATX; x++)
  295. for(int y=0; y<MATY; y++)
  296. {
  297. m_Matrix[x][y]->value(Plugin->GetPattern()->Matrix[x][y]);
  298. m_Matrix[x][y]->SetVolume(Plugin->GetPattern()->Volume[x][y]);
  299. }
  300. for(int n=0; n<NUM_PATSEQ; n++)
  301. {
  302. m_PatSeq[n]->value(Plugin->GetPatSeq(n));
  303. }
  304. }
  305. void MatrixPluginGUI::UpdateMatrix()
  306. {
  307. m_GUICH->Wait();
  308. m_GUICH->RequestChannelAndWait("Matrix");
  309. m_GUICH->GetData("Matrix",(void*)m_GUIMatrix);
  310. Pattern *p=&m_GUIMatrix[(int)m_Pattern->value()];
  311. m_Length->value(p->Length);
  312. m_Speed->value(p->Speed*8);
  313. m_SpeedVal->value((int)m_Speed->value());
  314. m_Octave->value(p->Octave);
  315. for(int x=0; x<MATX; x++)
  316. for(int y=0; y<MATY; y++)
  317. {
  318. m_Matrix[x][y]->value(p->Matrix[x][y]);
  319. m_Matrix[x][y]->SetVolume(p->Volume[x][y]);
  320. }
  321. }
  322. // Callbacks - Side Panel - Top Section
  323. inline void MatrixPluginGUI::cb_Pattern_i (Fl_Counter* o, void* v) {
  324. m_GUICH->Set ("Current", (int)o->value());
  325. UpdateMatrix();
  326. }
  327. void MatrixPluginGUI::cb_Pattern (Fl_Counter* o, void* v) {
  328. ((MatrixPluginGUI*)(o->parent()))->cb_Pattern_i (o, v);
  329. }
  330. inline void MatrixPluginGUI::cb_PlayPattern_i (Fl_Counter* o, void* v) {
  331. m_GUICH->Set ("Num", (int)o->value());
  332. m_GUICH->SetCommand (MatrixPlugin::SET_CURRENT);
  333. }
  334. void MatrixPluginGUI::cb_PlayPattern(Fl_Counter* o, void* v) {
  335. ((MatrixPluginGUI*)(o->parent()))->cb_PlayPattern_i (o, v);
  336. }
  337. inline void MatrixPluginGUI::cb_Length_i (Fl_Counter* o, void* v)
  338. {
  339. m_GUICH->Set ("Length", (int)o->value());
  340. m_GUICH->SetCommand (MatrixPlugin::MAT_LENGTH);
  341. }
  342. void MatrixPluginGUI::cb_Length (Fl_Counter* o, void* v) {
  343. ((MatrixPluginGUI*)(o->parent()))->cb_Length_i (o, v);
  344. }
  345. inline void MatrixPluginGUI::cb_Octave_i (Fl_Counter* o, void* v) {
  346. m_GUICH->Set ("Octave", (int)o->value());
  347. m_GUICH->SetCommand (MatrixPlugin::MAT_OCTAVE);
  348. }
  349. void MatrixPluginGUI::cb_Octave (Fl_Counter* o, void* v) {
  350. ((MatrixPluginGUI*)(o->parent()))->cb_Octave_i (o, v);
  351. }
  352. inline void MatrixPluginGUI::cb_Speed_i (Fl_Knob* o, void* v)
  353. {
  354. // Round off value, but it should be a float for tweaking
  355. float value = o->value() + ((int)o->value() - o->value());
  356. m_SpeedVal->value (value);
  357. m_GUICH->Set ("Speed", (float)value / 8.0f);
  358. m_GUICH->SetCommand (MatrixPlugin::MAT_SPEED);
  359. }
  360. void MatrixPluginGUI::cb_Speed (Fl_Knob* o, void* v) {
  361. ((MatrixPluginGUI*)(o->parent()))->cb_Speed_i (o, v);
  362. }
  363. inline void MatrixPluginGUI::cb_SpeedVal_i (Fl_Counter* o, void* v)
  364. {
  365. float value = o->value();
  366. m_Speed->value (value);
  367. m_GUICH->Set ("Speed", (float)value / 8.0f);
  368. m_GUICH->SetCommand (MatrixPlugin::MAT_SPEED);
  369. }
  370. void MatrixPluginGUI::cb_SpeedVal (Fl_Counter* o, void* v) {
  371. ((MatrixPluginGUI*)(o->parent()))->cb_SpeedVal_i (o, v);
  372. }
  373. // Callbacks - Side Panel - Editing Section
  374. inline void MatrixPluginGUI::cb_CopyBtn_i (Fl_Button* o, void* v) {
  375. m_PasteBtn->activate();
  376. m_GUICH->SetCommand (MatrixPlugin::COPY);
  377. UpdateMatrix();
  378. }
  379. void MatrixPluginGUI::cb_CopyBtn (Fl_Button* o, void* v) {
  380. ((MatrixPluginGUI*)(o->parent())) -> cb_CopyBtn_i (o, v);
  381. }
  382. inline void MatrixPluginGUI::cb_PasteBtn_i (Fl_Button* o, void* v) {
  383. m_GUICH->SetCommand (MatrixPlugin::PASTE);
  384. UpdateMatrix();
  385. }
  386. void MatrixPluginGUI::cb_PasteBtn (Fl_Button* o, void* v) {
  387. ((MatrixPluginGUI*)(o->parent())) -> cb_PasteBtn_i (o, v);
  388. }
  389. inline void MatrixPluginGUI::cb_ClearBtn_i (Fl_Button* o, void* v) {
  390. m_GUICH->SetCommand (MatrixPlugin::CLEAR);
  391. UpdateMatrix();
  392. }
  393. void MatrixPluginGUI::cb_ClearBtn (Fl_Button* o, void* v) {
  394. ((MatrixPluginGUI*)(o->parent())) -> cb_ClearBtn_i (o, v);
  395. }
  396. // Callbacks - Side Panel - Transpose Section
  397. inline void MatrixPluginGUI::cb_TransUpBtn_i (Fl_Button* o, void* v) {
  398. m_GUICH->SetCommand(MatrixPlugin::TUP);
  399. UpdateMatrix();
  400. }
  401. void MatrixPluginGUI::cb_TransUpBtn (Fl_Button* o, void* v) {
  402. ((MatrixPluginGUI*)(o->parent())) -> cb_TransUpBtn_i (o, v);
  403. }
  404. inline void MatrixPluginGUI::cb_TransDnBtn_i (Fl_Button* o, void* v) {
  405. m_GUICH->SetCommand(MatrixPlugin::TDOWN);
  406. UpdateMatrix();
  407. }
  408. void MatrixPluginGUI::cb_TransDnBtn (Fl_Button* o, void* v) {
  409. ((MatrixPluginGUI*)(o->parent())) -> cb_TransDnBtn_i (o, v);
  410. }
  411. // Callbacks - Side Panel - Bottom Section
  412. inline void MatrixPluginGUI::cb_NoteCut_i (Fl_Button* o, void* v) {
  413. m_GUICH->Set ("NoteCut",o->value());
  414. }
  415. void MatrixPluginGUI::cb_NoteCut (Fl_Button* o, void* v) {
  416. ((MatrixPluginGUI*)(o->parent()))->cb_NoteCut_i (o,v);
  417. }
  418. // Callbacks - Matrix
  419. inline void MatrixPluginGUI::cb_Matrix_i (Fl_Button* o, void* v) {
  420. m_GUICH->Set ("X", *(int*)v/MATY);
  421. m_GUICH->Set ("Y", *(int*)v%MATY);
  422. if (o->value()) m_GUICH->SetCommand (MatrixPlugin::MAT_ACTIVATE);
  423. else m_GUICH->SetCommand (MatrixPlugin::MAT_DEACTIVATE);
  424. m_GUICH->Wait();
  425. }
  426. void MatrixPluginGUI::cb_Matrix (Fl_Button* o, void* v) {
  427. ((MatrixPluginGUI*)(o->parent()))->cb_Matrix_i (o, v);
  428. }
  429. inline void MatrixPluginGUI::cb_MatVol_i (Fl_Button* o, void* v) {
  430. m_GUICH->Set ("X", *(int*)v/MATY);
  431. m_GUICH->Set ("Y", *(int*)v%MATY);
  432. m_GUICH->Set ("Volume", ((Fl_MatrixButton*)o)->GetVolume());
  433. m_GUICH->SetCommand (MatrixPlugin::MAT_VOLUME);
  434. }
  435. void MatrixPluginGUI::cb_MatVol (Fl_Button* o, void* v) {
  436. ((MatrixPluginGUI*)(o->parent()))->cb_MatVol_i (o, v);
  437. }
  438. // Callbacks - Pattern Sequencer
  439. inline void MatrixPluginGUI::cb_PatSeq_i (Fl_Counter* o, void* v) {
  440. m_GUICH->Set("Num", (int)o->value());
  441. m_GUICH->Set("Y", *(int*)v);
  442. m_GUICH->SetCommand (MatrixPlugin::SET_PATSEQ);
  443. }
  444. void MatrixPluginGUI::cb_PatSeq (Fl_Counter* o, void* v) {
  445. ((MatrixPluginGUI*)(o->parent()))->cb_PatSeq_i (o, v);
  446. }
  447. // Help text
  448. const string MatrixPluginGUI::GetHelpText(const string &loc){
  449. return string("")
  450. + "This is a matrix style step sequencer for techno purists. Great for\n"
  451. + "drum programming, but also capable of robotic bass and melodies.\n\n"
  452. + "Note events are turned on and off by activating the 64*32 grid of\n"
  453. + "toggle buttons on the GUI. The speed and octave of the notes can be\n"
  454. + "set. The length of the pattern in notes and note cut are also\n"
  455. + "present. The current play position is indicated by the row of LED's\n"
  456. + "along the top of the plugin window. You can copy and paste between\n"
  457. + "different patterns and transpose the notes\n\n"
  458. + "16 triggers are supplied for simultaneous triggering of samples in the\n"
  459. + "sampler plugin (for instance).\n\n"
  460. + "Each Matrix plugin can contain up to 16 different patterns, these are\n"
  461. + "selectable on the plugin GUI, and triggerable by the play trigger CV.\n"
  462. + "This CV input takes a note frequency CV rather than just a trigger,\n"
  463. + "and the bottom 16 notes on the midi scale trigger the 16 patterns.\n"
  464. + "This means that a matrix can trigger another matrix, if set to a much\n"
  465. + "lower speed, and (set to octave 0) the notes trigger the differnt\n"
  466. + "patterns in the slave matrix.\n\n"
  467. + "The external clock input is an important alternative to the matrixes\n"
  468. + "internal clock, it allows you to have multiple matrixes powered from one\n"
  469. + "oscillator clock. To allow you to sync these matrixes, the matrix is\n"
  470. + "provided with a Reset Trigger, which when plugged into the Play Trigger\n"
  471. + "of another matrix, will synch the two so they start at the same clock\n"
  472. + "pulse.\n\n"
  473. + "On the right hand side of the matrix you will find the pattern sequencer\n"
  474. + "this will advance each time a full pattern is played, and you can use it\n"
  475. + "to select which pattern will be played next. There are a maximum of 16\n"
  476. + "patterns to the sequence, but you can use less by setting a slot to -1\n"
  477. + "this will cause the sequence to loop back to zero";
  478. }