cIntBMP - libreria per la creazione di immagini in formato BMP - libreria per MetaTrader 5

La classe è destinata alla creazione programmatica di immagini BMP.

Esempio:

Triangoli. Metodo DrawTriangle()

Rettangoli. Metodo DrawRectangle()

Settori. Metodo DrawCircle()

Riempimento. Metodo Fill()

Installazione e utilizzo:

Copiare il file cIntBMP.mqh nella cartella MQL5/Include. Oltre al file contenente la classe, in allegato è presente il file eBMP con una dimostrazione del funzionamento della classe. Il file deve essere copiato nella cartella MQL5/Experts, aperto nell’editor, ricompilato ed eseguito sul grafico.

Per utilizzare la classe nel proprio programma:

1. Collegare il file contenente la classe:

#include <cIntBMP.mqh>

2. Dichiarare la classe, ad esempio con il nome "bmp":

cIntBMP bmp;

3. Impostare le dimensioni e il colore di sfondo (metodo Create(...), descrizione dettagliata dei metodi più avanti).

4. Disegnare.

5. Salvare (metodo Save(...)).

6. Visualizzare (metodo Show(...));

Al termine del lavoro:

1. Nascondere l’oggetto grafico (Hide(...)).

2. Eliminare il file (Delete(...)).

Metodi e parametri:

• Create(int aSizeX, int aSizeY, int aBGColor) - imposta le dimensioni dell'immagine e il colore di sfondo.
  aSizeX - larghezza in pixel;
  aSizeY - altezza in pixel;
  aBGColor - colore di sfondo;

• SetDrawWidth(int aWidth) - imposta lo spessore del tratto.
  aWidth - spessore.

• DrawDot(int aX, int aY, int aColor) - disegno di un punto.
  aX - coordinata X;
  aY - coordinata Y;
  aColor - colore;

• DrawLine(int aX1, int aY1, int aX2, int aY2, int aColor) - disegna una linea.
  aX1, aY1 - coordinate di un'estremità della linea;
  aX2, aY2 - coordinate dell'altra estremità della linea;
  aColor - colore;

• DrawRectangle(int aX1, int aY1, int aX2, int aY2, int aColor, bool aSolid=false) - disegno di un rettangolo.
  aX1, aY1 - coordinate di un angolo del rettangolo;
  aX2, aY2 - coordinate dell'altro vertice, opposto in diagonale;
  aColor - colore;
  aSolid - true - pieno, false - contorno.

• DrawTriangle(int aX1, int aY1, int aX2, int aY2, int aX3, int aY3, int aColor, bool aSolid=false) - disegno di un triangolo.
  aX1, aY1, aX2, aY2, aX3, aY3 - coordinate dei vertici;
  aColor - colore;
  aSolid - true - pieno, false - contorno.

• DrawCircle(int aX, int aY, int aRadius1, int aRadius2, int aColor, double aRatio=1.0, double aAngleFrom=0.0, double aAngleTo, bool aSolid=false) - disegno di un cerchio.
  aX - coordinata X del centro del cerchio;
  aY - coordinata Y del centro del cerchio;
  aRadius1 - raggio di un cerchio;
  aRadius2 - raggio del secondo cerchio;
  aColor - colore;
  aRatio - proporzione. Se il valore è 1, si tratta di un cerchio; se è maggiore di 1, si tratta di un'ellisse allungata verso l'alto; se è minore di 1, si tratta di un'ellisse allungata lateralmente.
  aAngleFrom - angolo a partire dal quale inizia il disegno del settore;
  aAngleTo - angolo fino al quale viene disegnato il settore. Se aAngleFrom è uguale a aAngleTo, viene disegnato un cerchio;
  aSolid - true - cerchio pieno, false - contorno.

• Fill(int aX, int aY, int aColor) - riempimento di un'area con un unico colore.
  aX, aY - coordinate del punto da cui inizia il riempimento;
  aColor - colore di riempimento.

• TypeText(int aX, int aY, int aColor) - inserisce del testo sull'immagine.
  aX, aY - coordinate del punto da cui inizia il testo (angolo superiore sinistro del testo);
  aColor - colore del testo.

• Save(string aFileName, bool aToImages=true) - salva l'immagine creata in un file.
  aFileName - nome del file. Non è necessario specificare l'estensione;
  aToImages - il file viene salvato nella cartella Images; se impostato su false, nella cartella Files.

• Show(int aX, int aY, string aBMPFileName, string aObjectName) - visualizza l'immagine sul grafico.
  aX, aY - coordinate di posizione dell'immagine sul grafico;
  aBMPFileName - nome del file BMP da visualizzare;
  aObjectName - nome dell'oggetto grafico OBJ_BITMAP_LABEL in cui verrà visualizzata l'immagine.

• Hide(string aObjectName) - Rimuove l'oggetto grafico con il nome specificato.
  aObjectName - Nome dell'oggetto da rimuovere.

• Delete(string aFileName, bool aFromImages=true);
  Eliminazione del file.
  aFileName - nome del file BMP da eliminare. Si specifica solo il nome dell’immagine senza percorso. Non è necessario specificare l’estensione;
  aFromImages - se true, il file viene eliminato dalla cartella Images, se false - dalla cartella Files.