Módulo : xyax.h

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

Classe abstrata que define as características de um eixo. Um eixo representa a escala de um tipo de coordenada. A sua representação visual é composta de uma linha reta podendo ter ou não terminador (seta), textos próximo a reta indicando a escala e por último um título para o eixo.

class XYAxis : public XYObject

Construtores e Destrutor

Construtor A

   XYAxis (
        double mn,      // valor mínimo que o eixo representa (assume)
        double mx,      // valor máximo que o eixo representa (assume)
        XYCoordinate x, // referência para a coordenada x
        XYCoordinate y, // referência para a coordenada y
        long color,     // cor do eixo
        double size,    // tamanho normalizado do eixo
        double rot,     // ângulo, em graus, no sentido anti-horário
        double step,    // passo normalizado dos ticks da escala
        XYScaleDecorator* decor, // decorador da escala
        XYText* title,           // texto a ser desenhado com o eixo
        bool arrow = true,       // seta terminadora (true or false)
        bool visible = true);    // visibilidade

Construtor B

   XYAxis (
        double mn,      // valor mínimo que o eixo representa (assume)
        double mx,      // valor máximo que o eixo representa (assume)
        XYCoordinate x, // referência para a coordenada x
        XYCoordinate y, // referência para a coordenada y
        long color,     // cor do eixo
        double size,    // tamanho normalizado do eixo
        double rot,     // ângulo, em graus, no sentido anti-horário
        bool arrow = true,    // seta terminadora (true or false)
        bool visible = true); // visibilidade

Construtor C

   XYAxis (
        double mn,      // valor mínimo que o eixo representa (assume)
        double mx,      // valor máximo que o eixo representa (assume)
        XYCoordinate x, // referência para a coordenada x
        XYCoordinate y, // referência para a coordenada y
        long color,     // cor do eixo
        double size,    // tamanho normalizado do eixo
        double rot,     // ângulo, em graus, no sentido anti-horário
        double step,    // passo normalizado dos ticks da escala
        bool arrow = true,    // seta terminadora (true or false)
        bool visible = true); // visibilidade

Destrutor da classe XYAxis

   virtual ~XYAxis (void) {};

Calcula valores melhores para mínimos, máximos e passos dos eixos

   virtual void calcMinMax (double *min, double* max, double* step) const;

Define valor mínimo que o eixo representa (assume)

   virtual void   min (double m);

Consulta valor mínimo que o eixo representa (assume)

   virtual double min (void) const;

Define valor máximo que o eixo representa (assume)

   virtual void   max (double m);

Consulta valor máximo que o eixo representa (assume)

   virtual double max (void) const;

Método que calcula o valor mínimo do eixo quando um determinado valor sobre ele, anteriormente numa determinada posição, é deslocado para a nova posição (x0, y0)

   virtual double defineMinPoint(double value, int x0, int y0) const;

Método que calcula o valor máximo do eixo quando um determinado valor sobre ele, anteriormente numa determinada posição, é deslocado para a nova posição (x0, y0)

   virtual double defineMaxPoint(double value, int x0, int y0) const;

Define a cor do eixo

   virtual void color (long c);

Consulta a cor do eixo

   virtual long color (void) const;

Define a posição de desenho do tick: true (default) tick é desenhado a esquerda do eixo; false tick é desenhado a direita

   virtual void leftTick (bool left);

Retorna true se tick é desenhado a esquerda do eixo, false a direita

   virtual bool leftTick (void) const;

Define o tamanho do eixo entre [0.0, 1.0], onde 1.0 significa tamanho da área de visualização

   virtual void size (double sz);

Consulta o tamanho do eixo entre [0.0, 1.0], onde 1.0 significa tamanho da área de visualização

   virtual double size (void) const;

Define a rotação do eixo

   virtual void rotation (double rot);

Consulta a rotação do eixo

   virtual double rotation (void) const;

Define o valor normalizado do passo dos ticks da escala

   virtual void step (double s);

Consulta o valor normalizado do passo dos ticks da escala

   virtual double step (void) const;

Define a posição de referência para o desenho dos ticks

   virtual void referenceTick (double f);

Consulta a posição de referência para o desenho dos ticks

   virtual double referenceTick (void) const;

Consulta a primeira posição para desenho dos ticks da escala entre os valores mínimo e máximo que o eixo representa é o primeiro tick após o valor mínimo do eixo

   virtual double first (void) const;

Define o decorador da escala

   virtual void scaleDecorator(XYScaleDecorator* decor);

Consulta o decorador da escala

   virtual XYScaleDecorator* scaleDecorator(void) const;

Define presença de seta terminadora

   virtual void arrow (bool a);

Consulta presença de seta terminadora

   virtual bool arrow (void) const;

Define título de um eixo

   virtual void title (XYText* t);

Consulta título de um eixo

   virtual XYText* title (void) const;

Ajusta tamanho do eixo para evitar erros na aplicação da função scroll, através do aumento ou redução no valor desse atributo de modo a permitir o casamento dos ticks sobre o eixo qualquer que seja o deslocamento definido pelo usuário para essa função

   virtual void adjustSize (void);

Retorna a coordenada do primeiro tick do eixo

   virtual void firstTick (double& tx1, double& ty1, double& tx2, double& ty2) const;

Retorna true se o ponto estiver sobre o eixo

   virtual bool pick (int px, int py);

Retorna true se o eixo estiver interior a região de "fence"

   virtual bool fence (int x0, int y0, int x1, int y1);

Desenha seta do eixo

   virtual void drawArrow (double x0, double y0, double x1, double y1) const;

Retorna menor retângulo que contém a seta do eixo

   virtual void boxArrow(double x0, double y0, double x1, double y1, double&
   		                xmin, double& ymin, double& xmax, double& ymax) const;

Transforma coordenada de acordo com o tipo do eixo envolvido

   virtual double transform (double e) const;

Método que retorna o valor sobre o eixo no ponto dado

   virtual double valueInPoint(int x0, int y0) const;

Método que retorna o valor sobre o eixo no ponto dado

   virtual double valueInPoint(double x0, double y0) const;

Método que retorna o ponto sobre o eixo no valor dado

   virtual void pointInValue(double , int& , int&) const {};

Método que retorna o ponto sobre o eixo no valor dado

   virtual void pointInValue(double, double&, double&) const {};