[#34013] [video sequence editor] Offset and crop of strips are wrong
[blender.git] / source / blender / blenkernel / BKE_cdderivedmesh.h
1 /*
2  * ***** BEGIN GPL LICENSE BLOCK *****
3  *
4  * This program is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU General Public License
6  * as published by the Free Software Foundation; either version 2
7  * of the License, or (at your option) any later version.
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software  Foundation,
16  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
17  *
18  * The Original Code is Copyright (C) 2006 Blender Foundation.
19  * All rights reserved.
20  *
21  * The Original Code is: all of this file.
22  *
23  * Contributor(s): Ben Batt <benbatt@gmail.com>
24  *
25  * ***** END GPL LICENSE BLOCK *****
26  */
27
28 /** \file BKE_cdderivedmesh.h
29  *  \ingroup bke
30  *  \section aboutcdderivedmesh CDDerivedMesh interface
31  *   CDDerivedMesh (CD = Custom Data) is a DerivedMesh backend which stores
32  *   mesh elements (vertices, edges and faces) as layers of custom element data.
33  */
34
35 #ifndef __BKE_CDDERIVEDMESH_H__
36 #define __BKE_CDDERIVEDMESH_H__
37
38 #include "BKE_DerivedMesh.h"
39
40 struct DerivedMesh;
41 struct BMEditMesh;
42 struct Mesh;
43 struct Object;
44
45 /* creates a new CDDerivedMesh */
46 struct DerivedMesh *CDDM_new(int numVerts, int numEdges, int numFaces,
47                              int numLoops, int numPolys);
48
49 /*tests if a given DerivedMesh is a CDDM*/
50 int CDDM_Check(struct DerivedMesh *dm);
51
52 /* creates a CDDerivedMesh from the given Mesh, this will reference the
53  * original data in Mesh, but it is safe to apply vertex coordinates or
54  * calculate normals as those functions will automatically create new
55  * data to not overwrite the original */
56 struct DerivedMesh *CDDM_from_mesh(struct Mesh *mesh, struct Object *ob);
57
58 struct DerivedMesh *CDDM_from_bmesh(struct BMesh *bm, int use_mdisps);
59
60 /* creates a CDDerivedMesh from the given BMEditMesh */
61 DerivedMesh *CDDM_from_editbmesh(struct BMEditMesh *em, int use_mdisps, int use_tessface);
62
63 /* merge verts  */
64 DerivedMesh *CDDM_merge_verts(DerivedMesh *dm, const int *vtargetmap);
65
66 /* creates a CDDerivedMesh from the given curve object */
67 struct DerivedMesh *CDDM_from_curve(struct Object *ob);
68
69 /* creates a CDDerivedMesh from the given curve object and specified dispbase */
70 /* useful for OrcoDM creation for curves with constructive modifiers */
71 DerivedMesh *CDDM_from_curve_displist(struct Object *ob, struct ListBase *dispbase);
72
73 /* Copies the given DerivedMesh with verts, faces & edges stored as
74  * custom element data.
75  */
76 struct DerivedMesh *CDDM_copy(struct DerivedMesh *dm);
77 struct DerivedMesh *CDDM_copy_from_tessface(struct DerivedMesh *dm);
78
79 /* creates a CDDerivedMesh with the same layer stack configuration as the
80  * given DerivedMesh and containing the requested numbers of elements.
81  * elements are initialized to all zeros
82  */
83 struct DerivedMesh *CDDM_from_template(struct DerivedMesh *source,
84                                        int numVerts, int numEdges, int numFaces,
85                                        int numLoops, int numPolys);
86
87 /* converts mfaces to mpolys.  note things may break if there are not valid
88  * medges surrounding each mface.
89  */
90 void CDDM_tessfaces_to_faces(struct DerivedMesh *dm);
91
92 /* applies vertex coordinates or normals to a CDDerivedMesh. if the MVert
93  * layer is a referenced layer, it will be duplicate to not overwrite the
94  * original
95  */
96 void CDDM_apply_vert_coords(struct DerivedMesh *cddm, float (*vertCoords)[3]);
97 void CDDM_apply_vert_normals(struct DerivedMesh *cddm, short (*vertNormals)[3]);
98
99 /* recalculates vertex and face normals for a CDDerivedMesh
100  */
101 void CDDM_calc_normals_mapping_ex(struct DerivedMesh *dm, const short only_face_normals);
102 void CDDM_calc_normals_mapping(struct DerivedMesh *dm);
103 void CDDM_calc_normals(struct DerivedMesh *dm);
104 void CDDM_calc_normals_tessface(struct DerivedMesh *dm);
105
106 /* calculates edges for a CDDerivedMesh (from face data)
107  * this completely replaces the current edge data in the DerivedMesh
108  * builds edges from the tessellated face data.
109  */
110 void CDDM_calc_edges_tessface(struct DerivedMesh *dm);
111
112 /* same as CDDM_calc_edges_tessface only makes edges from ngon faces instead of tessellation
113  * faces*/
114 void CDDM_calc_edges(struct DerivedMesh *dm);
115
116 /* reconstitute face triangulation */
117 void CDDM_recalc_tessellation(struct DerivedMesh *dm);
118 void CDDM_recalc_tessellation_ex(struct DerivedMesh *dm, const int do_face_nor_cpy);
119
120 /* lowers the number of vertices/edges/faces in a CDDerivedMesh
121  * the layer data stays the same size
122  */
123 void CDDM_lower_num_verts(struct DerivedMesh *dm, int numVerts);
124 void CDDM_lower_num_edges(struct DerivedMesh *dm, int numEdges);
125 void CDDM_lower_num_polys(struct DerivedMesh *dm, int numPolys);
126 void CDDM_lower_num_tessfaces(DerivedMesh *dm, int numTessFaces);
127
128 /* vertex/edge/face access functions
129  * should always succeed if index is within bounds
130  * note these return pointers - any change modifies the internals of the mesh
131  */
132 struct MVert *CDDM_get_vert(struct DerivedMesh *dm, int index);
133 struct MEdge *CDDM_get_edge(struct DerivedMesh *dm, int index);
134 struct MFace *CDDM_get_tessface(struct DerivedMesh *dm, int index);
135 struct MLoop *CDDM_get_loop(struct DerivedMesh *dm, int index);
136 struct MPoly *CDDM_get_poly(struct DerivedMesh *dm, int index);
137
138 /* vertex/edge/face array access functions - return the array holding the
139  * desired data
140  * should always succeed
141  * note these return pointers - any change modifies the internals of the mesh
142  */
143 struct MVert *CDDM_get_verts(struct DerivedMesh *dm);
144 struct MEdge *CDDM_get_edges(struct DerivedMesh *dm);
145 struct MFace *CDDM_get_tessfaces(struct DerivedMesh *dm);
146 struct MLoop *CDDM_get_loops(struct DerivedMesh *dm);
147 struct MPoly *CDDM_get_polys(struct DerivedMesh *dm);
148
149 /* Assigns news m*** layers to the cddm.  Note that you must handle
150  * freeing the old ones yourself.  Also you must ensure dm->num****Data
151  * is correct.*/
152 void CDDM_set_mvert(struct DerivedMesh *dm, struct MVert *mvert);
153 void CDDM_set_medge(struct DerivedMesh *dm, struct MEdge *medge);
154 void CDDM_set_mface(struct DerivedMesh *dm, struct MFace *mface);
155 void CDDM_set_mloop(struct DerivedMesh *dm, struct MLoop *mloop);
156 void CDDM_set_mpoly(struct DerivedMesh *dm, struct MPoly *mpoly);
157
158 #endif
159