summaryrefslogtreecommitdiff
path: root/graphics/epix/screen_data.h
blob: 582ec1d55524d53dfe705436fd0ef253fa81a79d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
/* 
 * screen_data.h -- ePiX::screen class implementation
 *
 * This file is part of ePiX, a C++ library for creating high-quality 
 * figures in LaTeX 
 *
 * Version 1.1.18
 * Last Change: September 16, 2007
 */

/* 
 * Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007
 * Andrew D. Hwang <rot 13 nujnat at zngupf dot ubylpebff dot rqh>
 * Department of Mathematics and Computer Science
 * College of the Holy Cross
 * Worcester, MA, 01610-2395, USA
 */

/*
 * ePiX is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * ePiX is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
 * or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public
 * License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with ePiX; if not, write to the Free Software Foundation, Inc.,
 * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 */

/*
 * This file implements the screen class, a Cartesian rectangle into
 * which objects are drawn. This file is not part of epix.h.
 */
#ifndef EPIX_SCREEN_DATA
#define EPIX_SCREEN_DATA

#include <string>
#include <list>

#include "pairs.h"

namespace ePiX {

  class affine;
  class Color;
  class format;
  class length;
  class pen_fill;
  class pen_line;
  class screen_mask;
  class tile;

  class screen_data {
  public:
    screen_data(const pair&, const pair&);

    screen_data(const screen_data&);
    screen_data& operator= (const screen_data&);
    ~screen_data();

    screen_data* clone() const;

    screen_data& crop_to(const screen_mask&);
    screen_data& crop();


    screen_data& set_mask(const screen_mask&);
    screen_data& set_crop(bool);

    // cut out and return a region
    screen_data extract(const pair&, const pair&) const;
    screen_data extract_diamond(const pair&, const pair&) const;
    screen_data extract_ellipse(const pair&, const pair&) const;

    // inset and import
    screen_data& paste(const screen_data& child, const screen_mask& inset);
    screen_data& paste(const screen_data& child);

    screen_data& clear();

    screen_data& border(const Color&, const std::string&);
    screen_data& backing(const Color&);

    screen_data& border();
    screen_data& backing();

    void add_tile(const tile&);
    void add_tile(tile*);

    // wrap=true -> encapsulate in a picture, for legends
    std::string print_to(const format&, const length&, bool wrap=false) const;

    // affine operations on contents (not border, backing)
    void   apply(const affine& af);
    void   shift(const pair& arg);

    // rotate by theta about ctr
    void  rotate(double theta, const pair& ctr = pair(0,0));

    // reflect in angle-theta line through ctr
    void reflect(double theta, const pair& ctr = pair(0,0));

    // scale coord direction(s) fixing ctr
    void h_scale(double, const pair& ctr=pair(0,0));
    void v_scale(double, const pair& ctr=pair(0,0));
    void   scale(double, const pair& ctr=pair(0,0));

    // shear, fixing ctr, e.g. h_shear(sc) : (x,y) -> (x+sc*y, y)
    void h_shear(double sc, const pair& ctr=pair(0,0));
    void v_shear(double sc, const pair& ctr=pair(0,0));

    pair tr() const;
    pair tl() const;
    pair bl() const;
    pair br() const;

    pair  t() const;
    pair  b() const;
    pair  l() const;
    pair  r() const;
    pair  c() const;

    double h_min()  const;
    double h_max()  const;
    double h_size() const;
    double h_avg()  const;

    double v_min()  const;
    double v_max()  const;
    double v_size() const;
    double v_avg()  const;

  private:
    pair m_bl;
    pair m_tr;

    screen_mask* m_mask;
    pen_line* m_border;
    pen_fill* m_backing;

    bool m_crop;

    std::list<tile*> m_tiles;
  }; // end of class screen_data

} // end of namespace

#endif /* EPIX_SCREEN_DATA */