Partially fix 1702760: stop compiler warning about trgt_png.cpp.
[synfig.git] / synfig-core / trunk / src / synfig / paramdesc.h
1 /* === S Y N F I G ========================================================= */
2 /*!     \file paramdesc.h
3 **      \brief ParamDesc Class Implementation
4 **
5 **      $Id$
6 **
7 **      \legal
8 **      Copyright (c) 2002-2005 Robert B. Quattlebaum Jr., Adrian Bentley
9 **
10 **      This package is free software; you can redistribute it and/or
11 **      modify it under the terms of the GNU General Public License as
12 **      published by the Free Software Foundation; either version 2 of
13 **      the License, or (at your option) any later version.
14 **
15 **      This package is distributed in the hope that it will be useful,
16 **      but WITHOUT ANY WARRANTY; without even the implied warranty of
17 **      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18 **      General Public License for more details.
19 **      \endlegal
20 */
21 /* ========================================================================= */
22
23 /* === S T A R T =========================================================== */
24
25 #ifndef __SYNFIG_PARAMDESC_H
26 #define __SYNFIG_PARAMDESC_H
27
28 /* === H E A D E R S ======================================================= */
29
30 #include "string.h"
31 #include "real.h"
32 #include "color.h"
33 #include <list>
34
35 /* === M A C R O S ========================================================= */
36
37 /* === T Y P E D E F S ===================================================== */
38
39 /* === C L A S S E S & S T R U C T S ======================================= */
40
41 namespace synfig {
42
43 class ValueBase;
44
45 /*!     \class ParamDesc
46 **      \brief Parameter Description Class
47 **      \todo writeme
48 */
49 class ParamDesc
50 {
51 public:
52
53         //! \writeme
54         struct EnumData
55         {
56                 int value;
57                 String name;
58                 String local_name;
59                 EnumData(int value, const String &name, const String &local_name):
60                         value(value),
61                         name(name),
62                         local_name(local_name)
63                 {
64                 }
65         };
66
67         /*
68  --     ** -- D A T A -------------------------------------------------------------
69         */
70
71 private:
72         String name_;                   //! The actual parameter name
73         String local_name_;     //! Localized name
74         String desc_;                   //! Short description of parameter (Think tooltops)
75         String group_;                  //! Which group this parameter is a member of (optional)
76         String hint_;                   //! Parameter hint
77         String origin_;                 //! Parameter origin
78         String connect_;
79         String box_;
80         Real scalar_;                   //! Scalar value for visual editing
81         bool critical_;
82         bool hidden_;
83         bool invisible_duck_;
84         bool is_distance_;
85         bool animation_only_;
86
87         std::list<EnumData> enum_list_;
88
89         /*
90  --     ** -- C O N S T R U C T O R S ---------------------------------------------
91         */
92
93 public:
94
95         ParamDesc(const String &a="IM_A_BUG_SO_REPORT_ME"):
96                 name_                   (a),
97                 local_name_             (a),
98                 scalar_                 (1.0),
99                 critical_               (true),
100                 hidden_                 (false),
101                 invisible_duck_ (false),
102                 is_distance_    (false),
103                 animation_only_ (false)
104         { }
105
106         ParamDesc(const ValueBase&, const String &a);
107
108         ParamDesc(synfig::Color::BlendMethod, const String &a);
109
110
111         /*
112  --     ** -- M E M B E R   F U N C T I O N S -------------------------------------
113         */
114
115 public:
116
117         //! \writeme
118         const std::list<EnumData> &get_enum_list()const { return enum_list_; }
119
120         //! Sets the localized name of the parameter.
121         ParamDesc &set_local_name(const String &n) { local_name_=n; return *this; }
122
123         //! Sets the localized description of the parameter.
124         ParamDesc &set_description(const String &d) { desc_=d; return *this; }
125
126         //! Sets the group that this parameter is a member of
127         ParamDesc &set_group(const String &n) { group_=n; return *this; }
128
129         //! Sets a "hint" for the parameter.
130         ParamDesc &set_hint(const String &h) { hint_=h; return *this; }
131
132         //! \writeme
133         ParamDesc &set_connect(const String &h) { connect_=h; return *this; }
134
135         //! \writeme
136         ParamDesc &set_box(const String &h) { box_=h; return *this; }
137
138         //! Sets a flag regarding the duck visibility
139         ParamDesc &set_invisible_duck(bool x=true) { invisible_duck_=x; return *this; }
140
141         //! Returns the flag regarding duck visibility
142         bool get_invisible_duck() { return invisible_duck_; }
143
144
145         //! \writeme
146         ParamDesc &set_animation_only(bool x=true) { animation_only_=x; return *this; }
147
148         //! \writeme
149         bool get_animation_only() { return animation_only_; }
150
151
152         //! Sets which parameter is to be used as the origin when the user edits visually.
153         ParamDesc &set_origin(const String &h) { origin_=h; return *this; }
154
155         //! Sets the scalar value for the parameter
156         /*! This value determines how the value is to be presented
157         **      to the user when editing visually. */
158         ParamDesc &set_scalar(const Real &n) { scalar_=n; return *this; }
159         ParamDesc &set_scalar(const String &h) { hint_=h; return *this; }
160
161         //!     Marks the parameter as not necessary for saving or copying
162         ParamDesc &not_critical() { critical_=false; return *this; }
163
164         //!     \writeme
165         ParamDesc &hidden() { hidden_=true; return *this; }
166
167         //!     Marks the parameter as only readable. Implies not_critical()
168         /*!     \todo This function needs to be written, as it is only a stub */
169         ParamDesc &read_only() { return *this; }
170
171         //!     Marks the parameter as only writable. Implies not_critical()
172         /*!     \todo This function needs to be written, as it is only a stub */
173         ParamDesc &write_only() { return *this; }
174
175         //! Adds a description of a possible enumeration value
176         /*!     Only relevant if the parameter is of an integer type and hint set to \c "enum" . */
177         ParamDesc &add_enum_value(int val, const String &enum_name,const String &enum_local_name)
178                 { enum_list_.push_back(EnumData(val,enum_name,enum_local_name)); return *this; }
179
180         //! Returns the localized name of the parameter
181         const String &get_local_name()const { return local_name_; }
182
183         //! Returns the name of the parameter
184         const String &get_name()const { return name_; }
185
186         //! Returns the localized description of the parameter
187         const String &get_description()const { return desc_; }
188
189         //! Returns the paramater's group
190         const String &get_group()const { return group_; }
191
192         //! Returns a "hint" about the parameter, regarding how it is to be displayed to the user
193         const String &get_hint()const { return hint_; }
194
195         //! Returns the name of the parameter that is defined as the "origin". Used for visual editing.
196         const String &get_origin()const { return origin_; }
197
198         //! \writeme
199         const String &get_connect()const { return connect_; }
200
201                 //! \writeme
202         const String &get_box()const { return box_; }
203
204         //! Returns the scalar value for the parameter. Used for visual editing.
205         const Real &get_scalar()const { return scalar_; }
206
207         //! Returns \c true if the layer is critical, \c false otherwise.
208         bool get_critical()const { return critical_; }
209
210         //! Returns \c true if the layer is hidden, \c false otherwise.
211         bool get_hidden()const { return hidden_; }
212
213
214
215         ParamDesc& set_is_distance(bool x=true) { is_distance_=x; return *this;}
216         bool get_is_distance()const { return is_distance_; }
217 }; // END of class ParamDesc
218
219 class ParamVocab : public std::list< ParamDesc >
220 {
221 };
222
223 }; // END of namespace synfig
224
225 /* === E N D =============================================================== */
226
227 #endif