Módulo : xygra.h

Desc : Declara classe XYGraph.
Autores : Carlos Henrique Levy e Jaudênia Cavalcante.
Data : 26 fev 96.

Classe abstrata que manipula de forma única um conjunto de eixos, (XYAxis), marcadores (XYMarker), regiões (XYSlice), curvas (XYMask), legenda (XYLegend) e títulos (XYText) numa área de um canvas do CD.
O layout básico de um gráfico é os títulos, um embaixo do outro começando pelo topo da área gerenciada pelo gráfico, a legenda e os eixos limitando uma região (mask area) onde curvas, marcadores e regiões são desenhados.

class XYGraph : public XYObject

Construtores e Destrutor

Construtor da classe XYGraph que recebe canvas IUP

   XYGraph (
        Ihandle* canvas,  // indica o canvas IUP onde o canvas CD será
                          // mapeado
        // as coordenadas a seguir são normalizadas em relação ao canvas do CD
        XYCoordinate x,   // referência para a coordenada x
        XYCoordinate y,   // referência para a coordenada y
        double width,     // largura da região ocupada pelo gráfico
        double height,    // altura da região ocupada pelo gráfico
        bool visible = true);  // visibilidade

Construtor da classe XYGraph que recebe canvas CD

   XYGraph (
        cdCanvas* cdcanvas, // define o canvas CD onde o gráfico será
                            // desenhado
        // as coordenadas a seguir são normalizadas em relação ao canvas do CD
        XYCoordinate x,     // referência para a coordenada x
        XYCoordinate y,     // referência para a coordenada y
        double width,       // largura da região ocupada pelo gráfico
        double height,      // altura da região ocupada pelo gráfico
        bool visible = true);  // visibilidade

Destrutor da classe XYGraph

   virtual ~XYGraph (void);

Define a posição do objeto

   virtual void position (double x, double y);
   virtual void position (int xp, int yp);

Consulta a posição do objeto

   virtual void position (double* x, double* y) const;
   virtual void position (int* xp, int* yp) const;
   virtual XYCoordinate* position (void);

Define canvas CD onde o gráfico será desenhado

   virtual void setCdCanvas (cdCanvas* c);

Consulta canvas CD onde o gráfico será desenhado

   virtual cdCanvas* getCdCanvas (void) const;

Define canvas para imagem e retorna canvas anterior

   virtual cdCanvas* canvasImage (cdCanvas*);

Consulta canvas da imagem

   virtual cdCanvas* canvasImage (void);

Define imagem com largura e altura dados

   virtual void createImage (int w, int h);

Insere um texto na lista de títulos

   virtual void insert (XYText* text);

Insere um eixo na lista de eixos

   virtual void insert (XYAxis* axis);

Insere uma máscara na lista de máscaras

   virtual void insert (XYMask* mask);

Insere um marcador na lista de marcadores

   virtual void insert (XYMarker* marker);

Insere um "slice" na lista de regiões

   virtual void insert (XYSlice* slice);

Remove um texto da lista de títulos

   virtual void remove (XYText* text);

Remove um eixo da lista de eixos

   virtual void remove (XYAxis* axis);

Remove uma máscara da lista de máscaras

   virtual void remove (XYMask* mask);

Remove um marcador da lista de marcadores

   virtual void remove (XYMarker* marker);

Remove um "slice" na lista de regiões

   virtual void remove (XYSlice* slice);

Consulta lista de títulos

   virtual XYList<XYText>& text (void);

Consulta lista de eixos

   virtual XYList<XYAxis>& axis (void);

Consulta lista de máscaras

   virtual XYList<XYMask>& mask (void);

Consulta lista de marcadores

   virtual XYList<XYMarker>& marker (void);

Consulta lista de "slices"

   virtual XYList<XYSlice>& slice (void);

Retorna máscara da lista que está na posição indicada

   virtual XYMask& mask(unsigned m);

Define a legenda do gráfico

   virtual void legend (XYLegend* leg);

Consulta a legenda do gráfico

   virtual XYLegend* legend (void) const;

Cria um marcador como novo elemento pertencente ao gráfico

   virtual XYObject* markerCreate(int x0, int y0, const XYAxis* master) = 0;

Define cor de fundo para o gráfico

   virtual void backgroundColor(long color);

Consulta cor de fundo para o gráfico

   virtual long backgroundColor(void) const;

Define largura da região ocupada pelo gráfico

   virtual void width (double w);

Consulta largura da região ocupada pelo gráfico

   virtual double width (void) const;

Define altura da região ocupada pelo gráfico

   virtual void height (double h);

Consulta altura da região ocupada pelo gráfico

   virtual double height (void) const;

Define se distorce a área gráfica ou não

   virtual void distortion (bool d);

Consulta se distorce a área gráfica ou não

   virtual bool distortion (void) const;

Define se existe "doublebuferring" ou não, retorna status anterior

   virtual bool doubleBuffering (bool on);

Consulta se existe "doublebuferring" ou não

   virtual bool doubleBuffering (void) const;

Define cor da região de desenho das máscaras

   virtual void maskAreaColor(long color);

Consulta cor da região de desenho das máscaras

   virtual long maskAreaColor(void) const;

Define região para desenho das máscaras com coordenadas normalizadas em relação a área do gráfico

   virtual void setMaskArea (double xmin, double ymin, double xmax,
                             double ymax);

Consulta região de desenho das máscaras

   virtual void getMaskArea (double& xmn, double& ymn, double& xmx,
                             double& ymx) const;
   virtual void getMaskArea (int& xmn, int& ymn, int& xmx, int& ymx) const;

Calcula região para desenho das máscaras

   virtual void calcMaskArea (void) = 0;

Retorna "true" se o gráfico passivo contém o objeto especificado

   virtual bool contains(const XYObject* obj);

Verifica se o ponto (x, y) está sobre um elemento do gráfico

   virtual XYObject* pick (int x, int y);

Verifica se o ponto (x, y) está sobre um títulos

   virtual XYText* pickText (int x, int y);

Verifica se o ponto (x, y) está sobre um eixo

   virtual XYAxis* pickAxis (int x, int y);

Verifica se o ponto (x, y) está sobre uma máscara

   virtual XYMask* pickMask (int x, int y);

Verifica se o ponto (x, y) está sobre um marcador

   virtual XYMarker* pickMarker (int x, int y);

Verifica se o ponto (x, y) está sobre um "slice"

   virtual XYSlice* pickSlice (int x, int y);

Verifica se o ponto (x, y) está sobre a legenda

   virtual XYLegend* pickLegend (int x, int y);

Retorna lista de elementos do gráfico que estão totalmente dentro da região de "fence"

   virtual XYList<XYObject>* fence (int x0, int y0, int x1, int y1);

Imprime

   virtual void print (void);

Se houver "doublebuffering" troca buffer

   virtual void flush (void) const;

Move o conteúdo da região de desenho das máscaras: direção positiva será esquerda/baixo

   virtual void scroll (int dx, int dy);

Limpa região ocupada pelo gráfico

   virtual void clear (void);

Limpa uma região

   virtual void clear (int xmin, int ymin, int xmax, int ymax) const;

Limpa a região do gráfico onde as máscaras são desenhadas

   virtual void maskAreaClear (void) const;

Desenha

   virtual void draw (void);

Desenha numa região

   virtual void draw (int xmin, int ymin, int xmax, int ymax) const;

Desenha a "mask area"

   virtual void drawMaskArea (void) const = 0;
   virtual void drawMaskArea (int xmin, int ymin, int xmax, int ymax) const;

Verifica existência de canvas: ativa se ele já existe e cria-o, caso não exista, antes de ativá-lo tambem define a viewport, chamando o metodo defineViewport

   virtual int activateCanvas (void) const;

Retorna menor retângulo que contém o gráfico, suas coordenadas são dadas em pixel

   virtual void boundingBox (int& /*bxmin*/, int& /*bymin*/, int& /*bxmax*/,
                             int& /*bymax*/) const {};