File: Rep.h

package info (click to toggle)
pymol 2.5.0%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 42,288 kB
  • sloc: cpp: 476,472; python: 76,538; ansic: 29,510; javascript: 6,792; sh: 47; makefile: 24
file content (252 lines) | stat: -rw-r--r-- 6,810 bytes parent folder | download
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
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252

/* 
A* -------------------------------------------------------------------
B* This file contains source code for the PyMOL computer program
C* copyright 1998-2000 by Warren Lyford Delano of DeLano Scientific. 
D* -------------------------------------------------------------------
E* It is unlawful to modify or remove this copyright notice.
F* -------------------------------------------------------------------
G* Please see the accompanying LICENSE file for further information. 
H* -------------------------------------------------------------------
I* Additional authors of this source file include:
-* 
-* 
-*
Z* -------------------------------------------------------------------
*/
#ifndef _H_Rep
#define _H_Rep

#include"Base.h"
#include"Ray.h"

#define cCartoon_skip_helix -2
#define cCartoon_skip -1
#define cCartoon_auto 0
#define cCartoon_loop 1
#define cCartoon_rect 2
#define cCartoon_oval 3
#define cCartoon_tube 4
#define cCartoon_arrow 5
#define cCartoon_dumbbell 6
#define cCartoon_putty 7
#define cCartoon_dash 8
#define cCartoon_cylinder 9

// show/hide/... codes
enum {
  cVis_HIDE,            // 0
  cVis_SHOW,            // 1
  cVis_AS,              // 2
  cVis_TOGGLE,          // 3
};

/* WARNING: don't change these -- you'll break sessions!
   (you can add to them however, I think) */

enum cRep_t {
  cRepNone = -2,
  cRepAll = -1,
  cRepCyl = 0,         // 0
  cRepSphere,          // 1
  cRepSurface,         // 2
  cRepLabel,           // 3
  cRepNonbondedSphere, // 4
  cRepCartoon,         // 5
  cRepRibbon,          // 6
  cRepLine,            // 7
  cRepMesh,            // 8
  cRepDot,             // 9
  cRepDash,            // 10
  cRepNonbonded,       // 11
  cRepCell,            // 12
  cRepCGO,             // 13
  cRepCallback,        // 14
  cRepExtent,          // 15
  cRepSlice,           // 16
  cRepAngle,           // 17
  cRepDihedral,        // 18
  cRepEllipsoid,       // 19
  cRepVolume,          // 20
  // rep count
  cRepCnt
};

inline cRep_t& operator++(cRep_t& rep)
{
  assert(0 <= rep && rep < cRepCnt);
  return (rep = cRep_t(rep + 1));
}

using cRepBitmask_t = int;

#define cRepCylBit             (1 << 0)
#define cRepSphereBit          (1 << 1)
#define cRepSurfaceBit         (1 << 2)
#define cRepLabelBit           (1 << 3)
#define cRepNonbondedSphereBit (1 << 4)
#define cRepCartoonBit         (1 << 5)
#define cRepRibbonBit          (1 << 6)
#define cRepLineBit            (1 << 7)
#define cRepMeshBit            (1 << 8)
#define cRepDotBit             (1 << 9)
#define cRepDashBit            (1 << 10)
#define cRepNonbondedBit       (1 << 11)
#define cRepCellBit            (1 << 12)
#define cRepCGOBit             (1 << 13)
#define cRepCallbackBit        (1 << 14)
#define cRepExtentBit          (1 << 15)
#define cRepSliceBit           (1 << 16)
#define cRepAngleBit           (1 << 17)
#define cRepDihedralBit        (1 << 18)
#define cRepEllipsoidBit       (1 << 19)
#define cRepVolumeBit          (1 << 20)

/* Add other reps here.  Don't forget to
 * update modules/constants.py::repres{}
 * update modules/constants.py::fb_module, if needed
 * update modules/viewing.py::rep_list
 * create your RepXYZ.h and RepXYZ.c
 */

#define cRepBitmask        ((1 << cRepCnt) - 1)

// all reps which can be shown for atoms
constexpr cRepBitmask_t cRepsAtomMask = (cRepCylBit | cRepSphereBit | cRepSurfaceBit |
    cRepLabelBit | cRepNonbondedSphereBit | cRepCartoonBit | cRepRibbonBit | \
    cRepLineBit | cRepMeshBit | cRepDotBit | cRepNonbondedBit | cRepEllipsoidBit);

// all reps which can be shown for objects
constexpr cRepBitmask_t cRepsObjectMask = (cRepSurfaceBit | cRepMeshBit | cRepDotBit |
    cRepCellBit | cRepCGOBit | cRepCallbackBit | cRepExtentBit | cRepSliceBit | \
    cRepAngleBit | cRepDihedralBit | cRepVolumeBit | cRepDashBit);

/* Hierarchical invalidation scheme - 
 * each higher level event implies all of the lower levels 
 * These used to be used just for graphics, but are now
 * used by the molecular editor as well */


/* invalite display (list) */

enum cRepInv_t {
  cRepInvNone = 0,
  cRepInvDisplay = 1,

/* precomputed extents (can change if matrix changes) */
  cRepInvExtents = 5,

/* invalidate pickable atoms */
  cRepInvPick = 9,

/* invalidate external atom colors */
  cRepInvExtColor = 10,

/* invalidate atom colors */
  cRepInvColor = 15,

/* invalidate label text */
  cRepInvText = 16,

/* invalidate visible atoms */
  cRepInvVisib = 20,
  cRepInvVisib2 = 21,

/* invalidate atomic properties */
  cRepInvProp = 22,

/* invalidate coordinates */
  cRepInvCoord = 30,

/* invalidate graphic representation */
  cRepInvRep = 35,

/* don't call ObjectMoleculeUpdateNonbonded */
  cRepInvBondsNoNonbonded = 38,

/* invalidate bond structure */
  cRepInvBonds = 40,

/* invalidate atomic structure */
  cRepInvAtoms = 50,

/* invalidate everything about a structure */
  cRepInvAll = 100,

/* invalidate and furthermore, purge existing representations */
  cRepInvPurgeMask = 0x80,
  cRepInvPurgeRep = cRepInvRep | cRepInvPurgeMask,
  cRepInvPurgeAll = cRepInvAll | cRepInvPurgeMask,

/* (alias) */
  cRepInvPurge = cRepInvPurgeRep,
};

struct CoordSet;
struct Object;

struct Rep {
  PyMOLGlobals *G;

  virtual cRep_t type() const = 0;
  virtual void render(RenderInfo* info);
  virtual void invalidate(cRepInv_t level);

  virtual ~Rep();

  pymol::CObject* obj = nullptr; // TODO redundant, use getObj()
  CoordSet* cs = nullptr;

  Pickable* P = nullptr; //!< only used by labels
  PickContext context{};

  //! Object state (>=0, 0-indexed) for picking and ramp colors
  int getState() const { return context.state; }
  pymol::CObject* getObj() const { return context.object; }

  //! True if this rep should be rendered in RenderPass::Transparent. Default is
  //! false, change the flag with setHasTransparency().
  bool hasTransparency() const { return m_has_transparency; }
  //! Sets the hasTransparency() flag.
  void setHasTransparency(bool has = true) { m_has_transparency = has; }

protected:
  cRepInv_t MaxInvalid = cRepInvNone;

private:
  Rep* rebuild();
  virtual Rep* recolor() { return rebuild(); }
  virtual bool sameVis() const { return false; }
  virtual bool sameColor() const { return false; }

  bool m_has_transparency = false;

public:
  Rep* update();

  /** Pointer to static factory function (Only used with molecular
   * representations, DistSet e.g. doesn't use it)
   * @param state Object state for picking and ramp colors
   */
  Rep* (*fNew)(CoordSet* cs, int state) = nullptr;

  Rep(pymol::CObject*, int state);
  Rep(CoordSet*, int state);
};

cRepBitmask_t RepGetAutoShowMask(PyMOLGlobals * G);

class RepIterator {
  int end;

public:
  int rep;

  RepIterator(PyMOLGlobals * G, int rep_);

  bool next() {
    return (++rep < end);
  };
};

#endif