Cleanup: deduplicate image user initialization, make consistent.
[blender.git] / source / blender / blenkernel / intern / texture.c
1 /*
2  * This program is free software; you can redistribute it and/or
3  * modify it under the terms of the GNU General Public License
4  * as published by the Free Software Foundation; either version 2
5  * of the License, or (at your option) any later version.
6  *
7  * This program is distributed in the hope that it will be useful,
8  * but WITHOUT ANY WARRANTY; without even the implied warranty of
9  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
10  * GNU General Public License for more details.
11  *
12  * You should have received a copy of the GNU General Public License
13  * along with this program; if not, write to the Free Software Foundation,
14  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
15  *
16  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
17  * All rights reserved.
18  */
19
20 /** \file
21  * \ingroup bke
22  */
23
24 #include <stdio.h>
25 #include <stdlib.h>
26 #include <string.h>
27 #include <math.h>
28
29 #include "MEM_guardedalloc.h"
30
31 #include "BLI_math.h"
32 #include "BLI_kdopbvh.h"
33 #include "BLI_utildefines.h"
34 #include "BLI_math_color.h"
35
36 #include "DNA_key_types.h"
37 #include "DNA_object_types.h"
38 #include "DNA_material_types.h"
39 #include "DNA_brush_types.h"
40 #include "DNA_node_types.h"
41 #include "DNA_color_types.h"
42 #include "DNA_particle_types.h"
43 #include "DNA_linestyle_types.h"
44
45 #include "IMB_imbuf.h"
46
47 #include "BKE_main.h"
48
49 #include "BKE_colorband.h"
50 #include "BKE_library.h"
51 #include "BKE_image.h"
52 #include "BKE_material.h"
53 #include "BKE_texture.h"
54 #include "BKE_key.h"
55 #include "BKE_icons.h"
56 #include "BKE_node.h"
57 #include "BKE_animsys.h"
58 #include "BKE_colortools.h"
59 #include "BKE_scene.h"
60
61 #include "RE_shader_ext.h"
62
63 /* ****************** Mapping ******************* */
64
65 TexMapping *BKE_texture_mapping_add(int type)
66 {
67   TexMapping *texmap = MEM_callocN(sizeof(TexMapping), "TexMapping");
68
69   BKE_texture_mapping_default(texmap, type);
70
71   return texmap;
72 }
73
74 void BKE_texture_mapping_default(TexMapping *texmap, int type)
75 {
76   memset(texmap, 0, sizeof(TexMapping));
77
78   texmap->size[0] = texmap->size[1] = texmap->size[2] = 1.0f;
79   texmap->max[0] = texmap->max[1] = texmap->max[2] = 1.0f;
80   unit_m4(texmap->mat);
81
82   texmap->projx = PROJ_X;
83   texmap->projy = PROJ_Y;
84   texmap->projz = PROJ_Z;
85   texmap->mapping = MTEX_FLAT;
86   texmap->type = type;
87 }
88
89 void BKE_texture_mapping_init(TexMapping *texmap)
90 {
91   float smat[4][4], rmat[4][4], tmat[4][4], proj[4][4], size[3];
92
93   if (texmap->projx == PROJ_X && texmap->projy == PROJ_Y && texmap->projz == PROJ_Z &&
94       is_zero_v3(texmap->loc) && is_zero_v3(texmap->rot) && is_one_v3(texmap->size)) {
95     unit_m4(texmap->mat);
96
97     texmap->flag |= TEXMAP_UNIT_MATRIX;
98   }
99   else {
100     /* axis projection */
101     zero_m4(proj);
102     proj[3][3] = 1.0f;
103
104     if (texmap->projx != PROJ_N)
105       proj[texmap->projx - 1][0] = 1.0f;
106     if (texmap->projy != PROJ_N)
107       proj[texmap->projy - 1][1] = 1.0f;
108     if (texmap->projz != PROJ_N)
109       proj[texmap->projz - 1][2] = 1.0f;
110
111     /* scale */
112     copy_v3_v3(size, texmap->size);
113
114     if (ELEM(texmap->type, TEXMAP_TYPE_TEXTURE, TEXMAP_TYPE_NORMAL)) {
115       /* keep matrix invertible */
116       if (fabsf(size[0]) < 1e-5f)
117         size[0] = signf(size[0]) * 1e-5f;
118       if (fabsf(size[1]) < 1e-5f)
119         size[1] = signf(size[1]) * 1e-5f;
120       if (fabsf(size[2]) < 1e-5f)
121         size[2] = signf(size[2]) * 1e-5f;
122     }
123
124     size_to_mat4(smat, texmap->size);
125
126     /* rotation */
127     eul_to_mat4(rmat, texmap->rot);
128
129     /* translation */
130     unit_m4(tmat);
131     copy_v3_v3(tmat[3], texmap->loc);
132
133     if (texmap->type == TEXMAP_TYPE_TEXTURE) {
134       /* to transform a texture, the inverse transform needs
135        * to be applied to the texture coordinate */
136       mul_m4_series(texmap->mat, tmat, rmat, smat);
137       invert_m4(texmap->mat);
138     }
139     else if (texmap->type == TEXMAP_TYPE_POINT) {
140       /* forward transform */
141       mul_m4_series(texmap->mat, tmat, rmat, smat);
142     }
143     else if (texmap->type == TEXMAP_TYPE_VECTOR) {
144       /* no translation for vectors */
145       mul_m4_m4m4(texmap->mat, rmat, smat);
146     }
147     else if (texmap->type == TEXMAP_TYPE_NORMAL) {
148       /* no translation for normals, and inverse transpose */
149       mul_m4_m4m4(texmap->mat, rmat, smat);
150       invert_m4(texmap->mat);
151       transpose_m4(texmap->mat);
152     }
153
154     /* projection last */
155     mul_m4_m4m4(texmap->mat, texmap->mat, proj);
156
157     texmap->flag &= ~TEXMAP_UNIT_MATRIX;
158   }
159 }
160
161 ColorMapping *BKE_texture_colormapping_add(void)
162 {
163   ColorMapping *colormap = MEM_callocN(sizeof(ColorMapping), "ColorMapping");
164
165   BKE_texture_colormapping_default(colormap);
166
167   return colormap;
168 }
169
170 void BKE_texture_colormapping_default(ColorMapping *colormap)
171 {
172   memset(colormap, 0, sizeof(ColorMapping));
173
174   BKE_colorband_init(&colormap->coba, true);
175
176   colormap->bright = 1.0;
177   colormap->contrast = 1.0;
178   colormap->saturation = 1.0;
179
180   colormap->blend_color[0] = 0.8f;
181   colormap->blend_color[1] = 0.8f;
182   colormap->blend_color[2] = 0.8f;
183   colormap->blend_type = MA_RAMP_BLEND;
184   colormap->blend_factor = 0.0f;
185 }
186
187 /* ******************* TEX ************************ */
188
189 /** Free (or release) any data used by this texture (does not free the texure itself). */
190 void BKE_texture_free(Tex *tex)
191 {
192   BKE_animdata_free((ID *)tex, false);
193
194   /* is no lib link block, but texture extension */
195   if (tex->nodetree) {
196     ntreeFreeNestedTree(tex->nodetree);
197     MEM_freeN(tex->nodetree);
198     tex->nodetree = NULL;
199   }
200
201   MEM_SAFE_FREE(tex->coba);
202
203   BKE_icon_id_delete((ID *)tex);
204   BKE_previewimg_free(&tex->preview);
205 }
206
207 /* ------------------------------------------------------------------------- */
208
209 void BKE_texture_default(Tex *tex)
210 {
211   /* BLI_assert(MEMCMP_STRUCT_AFTER_IS_ZERO(tex, id)); */ /* Not here, can be called with some pointers set. :/ */
212
213   tex->type = TEX_IMAGE;
214   tex->ima = NULL;
215   tex->stype = 0;
216   tex->flag = TEX_CHECKER_ODD;
217   tex->imaflag = TEX_INTERPOL | TEX_MIPMAP | TEX_USEALPHA;
218   tex->extend = TEX_REPEAT;
219   tex->cropxmin = tex->cropymin = 0.0;
220   tex->cropxmax = tex->cropymax = 1.0;
221   tex->texfilter = TXF_EWA;
222   tex->afmax = 8;
223   tex->xrepeat = tex->yrepeat = 1;
224   tex->sfra = 1;
225   tex->frames = 0;
226   tex->offset = 0;
227   tex->noisesize = 0.25;
228   tex->noisedepth = 2;
229   tex->turbul = 5.0;
230   tex->nabla = 0.025;  // also in do_versions
231   tex->bright = 1.0;
232   tex->contrast = 1.0;
233   tex->saturation = 1.0;
234   tex->filtersize = 1.0;
235   tex->rfac = 1.0;
236   tex->gfac = 1.0;
237   tex->bfac = 1.0;
238   /* newnoise: init. */
239   tex->noisebasis = 0;
240   tex->noisebasis2 = 0;
241   /* musgrave */
242   tex->mg_H = 1.0;
243   tex->mg_lacunarity = 2.0;
244   tex->mg_octaves = 2.0;
245   tex->mg_offset = 1.0;
246   tex->mg_gain = 1.0;
247   tex->ns_outscale = 1.0;
248   /* distnoise */
249   tex->dist_amount = 1.0;
250   /* voronoi */
251   tex->vn_w1 = 1.0;
252   tex->vn_w2 = tex->vn_w3 = tex->vn_w4 = 0.0;
253   tex->vn_mexp = 2.5;
254   tex->vn_distm = 0;
255   tex->vn_coltype = 0;
256
257   BKE_imageuser_default(&tex->iuser);
258
259   tex->preview = NULL;
260 }
261
262 void BKE_texture_type_set(Tex *tex, int type)
263 {
264   tex->type = type;
265 }
266
267 /* ------------------------------------------------------------------------- */
268
269 Tex *BKE_texture_add(Main *bmain, const char *name)
270 {
271   Tex *tex;
272
273   tex = BKE_libblock_alloc(bmain, ID_TE, name, 0);
274
275   BKE_texture_default(tex);
276
277   return tex;
278 }
279
280 /* ------------------------------------------------------------------------- */
281
282 void BKE_texture_mtex_default(MTex *mtex)
283 {
284   mtex->texco = TEXCO_UV;
285   mtex->mapto = MAP_COL;
286   mtex->object = NULL;
287   mtex->projx = PROJ_X;
288   mtex->projy = PROJ_Y;
289   mtex->projz = PROJ_Z;
290   mtex->mapping = MTEX_FLAT;
291   mtex->ofs[0] = 0.0;
292   mtex->ofs[1] = 0.0;
293   mtex->ofs[2] = 0.0;
294   mtex->size[0] = 1.0;
295   mtex->size[1] = 1.0;
296   mtex->size[2] = 1.0;
297   mtex->tex = NULL;
298   mtex->colormodel = 0;
299   mtex->r = 1.0;
300   mtex->g = 0.0;
301   mtex->b = 1.0;
302   mtex->k = 1.0;
303   mtex->def_var = 1.0;
304   mtex->blendtype = MTEX_BLEND;
305   mtex->colfac = 1.0;
306   mtex->norfac = 1.0;
307   mtex->varfac = 1.0;
308   mtex->dispfac = 0.2;
309   mtex->colspecfac = 1.0f;
310   mtex->mirrfac = 1.0f;
311   mtex->alphafac = 1.0f;
312   mtex->difffac = 1.0f;
313   mtex->specfac = 1.0f;
314   mtex->emitfac = 1.0f;
315   mtex->hardfac = 1.0f;
316   mtex->raymirrfac = 1.0f;
317   mtex->translfac = 1.0f;
318   mtex->ambfac = 1.0f;
319   mtex->colemitfac = 1.0f;
320   mtex->colreflfac = 1.0f;
321   mtex->coltransfac = 1.0f;
322   mtex->densfac = 1.0f;
323   mtex->scatterfac = 1.0f;
324   mtex->reflfac = 1.0f;
325   mtex->shadowfac = 1.0f;
326   mtex->zenupfac = 1.0f;
327   mtex->zendownfac = 1.0f;
328   mtex->blendfac = 1.0f;
329   mtex->timefac = 1.0f;
330   mtex->lengthfac = 1.0f;
331   mtex->clumpfac = 1.0f;
332   mtex->kinkfac = 1.0f;
333   mtex->kinkampfac = 1.0f;
334   mtex->roughfac = 1.0f;
335   mtex->twistfac = 1.0f;
336   mtex->padensfac = 1.0f;
337   mtex->lifefac = 1.0f;
338   mtex->sizefac = 1.0f;
339   mtex->ivelfac = 1.0f;
340   mtex->dampfac = 1.0f;
341   mtex->gravityfac = 1.0f;
342   mtex->fieldfac = 1.0f;
343   mtex->normapspace = MTEX_NSPACE_TANGENT;
344   mtex->brush_map_mode = MTEX_MAP_MODE_TILED;
345   mtex->random_angle = 2.0f * (float)M_PI;
346   mtex->brush_angle_mode = 0;
347 }
348
349 /* ------------------------------------------------------------------------- */
350
351 MTex *BKE_texture_mtex_add(void)
352 {
353   MTex *mtex;
354
355   mtex = MEM_callocN(sizeof(MTex), "BKE_texture_mtex_add");
356
357   BKE_texture_mtex_default(mtex);
358
359   return mtex;
360 }
361
362 /* slot -1 for first free ID */
363 MTex *BKE_texture_mtex_add_id(ID *id, int slot)
364 {
365   MTex **mtex_ar;
366   short act;
367
368   give_active_mtex(id, &mtex_ar, &act);
369
370   if (mtex_ar == NULL) {
371     return NULL;
372   }
373
374   if (slot == -1) {
375     /* find first free */
376     int i;
377     for (i = 0; i < MAX_MTEX; i++) {
378       if (!mtex_ar[i]) {
379         slot = i;
380         break;
381       }
382     }
383     if (slot == -1) {
384       return NULL;
385     }
386   }
387   else {
388     /* make sure slot is valid */
389     if (slot < 0 || slot >= MAX_MTEX) {
390       return NULL;
391     }
392   }
393
394   if (mtex_ar[slot]) {
395     id_us_min((ID *)mtex_ar[slot]->tex);
396     MEM_freeN(mtex_ar[slot]);
397     mtex_ar[slot] = NULL;
398   }
399
400   mtex_ar[slot] = BKE_texture_mtex_add();
401
402   return mtex_ar[slot];
403 }
404
405 /* ------------------------------------------------------------------------- */
406
407 /**
408  * Only copy internal data of Texture ID from source to already allocated/initialized destination.
409  * You probably never want to use that directly, use BKE_id_copy or BKE_id_copy_ex for typical needs.
410  *
411  * WARNING! This function will not handle ID user count!
412  *
413  * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more).
414  */
415 void BKE_texture_copy_data(Main *bmain, Tex *tex_dst, const Tex *tex_src, const int flag)
416 {
417   if (!BKE_texture_is_image_user(tex_src)) {
418     tex_dst->ima = NULL;
419   }
420
421   if (tex_dst->coba) {
422     tex_dst->coba = MEM_dupallocN(tex_dst->coba);
423   }
424   if (tex_src->nodetree) {
425     if (tex_src->nodetree->execdata) {
426       ntreeTexEndExecTree(tex_src->nodetree->execdata);
427     }
428     /* Note: nodetree is *not* in bmain, however this specific case is handled at lower level
429      *       (see BKE_libblock_copy_ex()). */
430     BKE_id_copy_ex(bmain, (ID *)tex_src->nodetree, (ID **)&tex_dst->nodetree, flag);
431   }
432
433   if ((flag & LIB_ID_COPY_NO_PREVIEW) == 0) {
434     BKE_previewimg_id_copy(&tex_dst->id, &tex_src->id);
435   }
436   else {
437     tex_dst->preview = NULL;
438   }
439 }
440
441 Tex *BKE_texture_copy(Main *bmain, const Tex *tex)
442 {
443   Tex *tex_copy;
444   BKE_id_copy(bmain, &tex->id, (ID **)&tex_copy);
445   return tex_copy;
446 }
447
448 /* texture copy without adding to main dbase */
449 Tex *BKE_texture_localize(Tex *tex)
450 {
451   /* TODO(bastien): Replace with something like:
452    *
453    *   Tex *tex_copy;
454    *   BKE_id_copy_ex(bmain, &tex->id, (ID **)&tex_copy,
455    *                  LIB_ID_COPY_NO_MAIN | LIB_ID_COPY_NO_PREVIEW | LIB_ID_COPY_NO_USER_REFCOUNT,
456    *                  false);
457    *   return tex_copy;
458    *
459    * NOTE: Only possible once nested node trees are fully converted to that too. */
460
461   Tex *texn;
462
463   texn = BKE_libblock_copy_for_localize(&tex->id);
464
465   /* image texture: BKE_texture_free also doesn't decrease */
466
467   if (texn->coba)
468     texn->coba = MEM_dupallocN(texn->coba);
469
470   texn->preview = NULL;
471
472   if (tex->nodetree) {
473     texn->nodetree = ntreeLocalize(tex->nodetree);
474   }
475
476   texn->id.tag |= LIB_TAG_LOCALIZED;
477
478   return texn;
479 }
480
481 /* ------------------------------------------------------------------------- */
482
483 void BKE_texture_make_local(Main *bmain, Tex *tex, const bool lib_local)
484 {
485   BKE_id_make_local_generic(bmain, &tex->id, true, lib_local);
486 }
487
488 Tex *give_current_linestyle_texture(FreestyleLineStyle *linestyle)
489 {
490   MTex *mtex = NULL;
491   Tex *tex = NULL;
492
493   if (linestyle) {
494     mtex = linestyle->mtex[(int)(linestyle->texact)];
495     if (mtex)
496       tex = mtex->tex;
497   }
498
499   return tex;
500 }
501
502 void set_current_linestyle_texture(FreestyleLineStyle *linestyle, Tex *newtex)
503 {
504   int act = linestyle->texact;
505
506   if (linestyle->mtex[act] && linestyle->mtex[act]->tex)
507     id_us_min(&linestyle->mtex[act]->tex->id);
508
509   if (newtex) {
510     if (!linestyle->mtex[act]) {
511       linestyle->mtex[act] = BKE_texture_mtex_add();
512       linestyle->mtex[act]->texco = TEXCO_STROKE;
513     }
514
515     linestyle->mtex[act]->tex = newtex;
516     id_us_plus(&newtex->id);
517   }
518   else if (linestyle->mtex[act]) {
519     MEM_freeN(linestyle->mtex[act]);
520     linestyle->mtex[act] = NULL;
521   }
522 }
523
524 bool give_active_mtex(ID *id, MTex ***mtex_ar, short *act)
525 {
526   switch (GS(id->name)) {
527     case ID_LS:
528       *mtex_ar = ((FreestyleLineStyle *)id)->mtex;
529       if (act)
530         *act = (((FreestyleLineStyle *)id)->texact);
531       break;
532     case ID_PA:
533       *mtex_ar = ((ParticleSettings *)id)->mtex;
534       if (act)
535         *act = (((ParticleSettings *)id)->texact);
536       break;
537     default:
538       *mtex_ar = NULL;
539       if (act)
540         *act = 0;
541       return false;
542   }
543
544   return true;
545 }
546
547 void set_active_mtex(ID *id, short act)
548 {
549   if (act < 0)
550     act = 0;
551   else if (act >= MAX_MTEX)
552     act = MAX_MTEX - 1;
553
554   switch (GS(id->name)) {
555     case ID_LS:
556       ((FreestyleLineStyle *)id)->texact = act;
557       break;
558     case ID_PA:
559       ((ParticleSettings *)id)->texact = act;
560       break;
561     default:
562       break;
563   }
564 }
565
566 Tex *give_current_brush_texture(Brush *br)
567 {
568   return br->mtex.tex;
569 }
570
571 void set_current_brush_texture(Brush *br, Tex *newtex)
572 {
573   if (br->mtex.tex)
574     id_us_min(&br->mtex.tex->id);
575
576   if (newtex) {
577     br->mtex.tex = newtex;
578     id_us_plus(&newtex->id);
579   }
580 }
581
582 Tex *give_current_particle_texture(ParticleSettings *part)
583 {
584   MTex *mtex = NULL;
585   Tex *tex = NULL;
586
587   if (!part)
588     return NULL;
589
590   mtex = part->mtex[(int)(part->texact)];
591   if (mtex)
592     tex = mtex->tex;
593
594   return tex;
595 }
596
597 void set_current_particle_texture(ParticleSettings *part, Tex *newtex)
598 {
599   int act = part->texact;
600
601   if (part->mtex[act] && part->mtex[act]->tex)
602     id_us_min(&part->mtex[act]->tex->id);
603
604   if (newtex) {
605     if (!part->mtex[act]) {
606       part->mtex[act] = BKE_texture_mtex_add();
607       part->mtex[act]->texco = TEXCO_ORCO;
608       part->mtex[act]->blendtype = MTEX_MUL;
609     }
610
611     part->mtex[act]->tex = newtex;
612     id_us_plus(&newtex->id);
613   }
614   else if (part->mtex[act]) {
615     MEM_freeN(part->mtex[act]);
616     part->mtex[act] = NULL;
617   }
618 }
619
620 /* ------------------------------------------------------------------------- */
621
622 void BKE_texture_pointdensity_init_data(PointDensity *pd)
623 {
624   pd->flag = 0;
625   pd->radius = 0.3f;
626   pd->falloff_type = TEX_PD_FALLOFF_STD;
627   pd->falloff_softness = 2.0;
628   pd->source = TEX_PD_PSYS;
629   pd->point_tree = NULL;
630   pd->point_data = NULL;
631   pd->noise_size = 0.5f;
632   pd->noise_depth = 1;
633   pd->noise_fac = 1.0f;
634   pd->noise_influence = TEX_PD_NOISE_STATIC;
635   pd->coba = BKE_colorband_add(true);
636   pd->speed_scale = 1.0f;
637   pd->totpoints = 0;
638   pd->object = NULL;
639   pd->psys = 0;
640   pd->psys_cache_space = TEX_PD_WORLDSPACE;
641   pd->falloff_curve = curvemapping_add(1, 0, 0, 1, 1);
642
643   pd->falloff_curve->preset = CURVE_PRESET_LINE;
644   pd->falloff_curve->cm->flag &= ~CUMA_EXTEND_EXTRAPOLATE;
645   curvemap_reset(pd->falloff_curve->cm,
646                  &pd->falloff_curve->clipr,
647                  pd->falloff_curve->preset,
648                  CURVEMAP_SLOPE_POSITIVE);
649   curvemapping_changed(pd->falloff_curve, false);
650 }
651
652 PointDensity *BKE_texture_pointdensity_add(void)
653 {
654   PointDensity *pd = MEM_callocN(sizeof(PointDensity), "pointdensity");
655   BKE_texture_pointdensity_init_data(pd);
656   return pd;
657 }
658
659 PointDensity *BKE_texture_pointdensity_copy(const PointDensity *pd, const int UNUSED(flag))
660 {
661   PointDensity *pdn;
662
663   pdn = MEM_dupallocN(pd);
664   pdn->point_tree = NULL;
665   pdn->point_data = NULL;
666   if (pdn->coba) {
667     pdn->coba = MEM_dupallocN(pdn->coba);
668   }
669   pdn->falloff_curve = curvemapping_copy(pdn->falloff_curve); /* can be NULL */
670   return pdn;
671 }
672
673 void BKE_texture_pointdensity_free_data(PointDensity *pd)
674 {
675   if (pd->point_tree) {
676     BLI_bvhtree_free(pd->point_tree);
677     pd->point_tree = NULL;
678   }
679   if (pd->point_data) {
680     MEM_freeN(pd->point_data);
681     pd->point_data = NULL;
682   }
683   if (pd->coba) {
684     MEM_freeN(pd->coba);
685     pd->coba = NULL;
686   }
687
688   curvemapping_free(pd->falloff_curve); /* can be NULL */
689 }
690
691 void BKE_texture_pointdensity_free(PointDensity *pd)
692 {
693   BKE_texture_pointdensity_free_data(pd);
694   MEM_freeN(pd);
695 }
696 /* ------------------------------------------------------------------------- */
697
698 /**
699  * \returns true if this texture can use its #Texture.ima (even if its NULL)
700  */
701 bool BKE_texture_is_image_user(const struct Tex *tex)
702 {
703   switch (tex->type) {
704     case TEX_IMAGE: {
705       return true;
706     }
707   }
708
709   return false;
710 }
711
712 /* ------------------------------------------------------------------------- */
713 bool BKE_texture_dependsOnTime(const struct Tex *texture)
714 {
715   if (texture->ima && BKE_image_is_animated(texture->ima)) {
716     return true;
717   }
718   else if (texture->adt) {
719     /* assume anything in adt means the texture is animated */
720     return true;
721   }
722   else if (texture->type == TEX_NOISE) {
723     /* noise always varies with time */
724     return true;
725   }
726   return false;
727 }
728
729 /* ------------------------------------------------------------------------- */
730
731 void BKE_texture_get_value_ex(const Scene *scene,
732                               Tex *texture,
733                               float *tex_co,
734                               TexResult *texres,
735                               struct ImagePool *pool,
736                               bool use_color_management)
737 {
738   int result_type;
739   bool do_color_manage = false;
740
741   if (scene && use_color_management) {
742     do_color_manage = BKE_scene_check_color_management_enabled(scene);
743   }
744
745   /* no node textures for now */
746   result_type = multitex_ext_safe(texture, tex_co, texres, pool, do_color_manage, false);
747
748   /* if the texture gave an RGB value, we assume it didn't give a valid
749    * intensity, since this is in the context of modifiers don't use perceptual color conversion.
750    * if the texture didn't give an RGB value, copy the intensity across
751    */
752   if (result_type & TEX_RGB) {
753     texres->tin = (1.0f / 3.0f) * (texres->tr + texres->tg + texres->tb);
754   }
755   else {
756     copy_v3_fl(&texres->tr, texres->tin);
757   }
758 }
759
760 void BKE_texture_get_value(
761     const Scene *scene, Tex *texture, float *tex_co, TexResult *texres, bool use_color_management)
762 {
763   BKE_texture_get_value_ex(scene, texture, tex_co, texres, NULL, use_color_management);
764 }
765
766 static void texture_nodes_fetch_images_for_pool(Tex *texture,
767                                                 bNodeTree *ntree,
768                                                 struct ImagePool *pool)
769 {
770   for (bNode *node = ntree->nodes.first; node; node = node->next) {
771     if (node->type == SH_NODE_TEX_IMAGE && node->id != NULL) {
772       Image *image = (Image *)node->id;
773       BKE_image_pool_acquire_ibuf(image, &texture->iuser, pool);
774     }
775     else if (node->type == NODE_GROUP && node->id != NULL) {
776       /* TODO(sergey): Do we need to control recursion here? */
777       bNodeTree *nested_tree = (bNodeTree *)node->id;
778       texture_nodes_fetch_images_for_pool(texture, nested_tree, pool);
779     }
780   }
781 }
782
783 /* Make sure all images used by texture are loaded into pool. */
784 void BKE_texture_fetch_images_for_pool(Tex *texture, struct ImagePool *pool)
785 {
786   if (texture->nodetree != NULL) {
787     texture_nodes_fetch_images_for_pool(texture, texture->nodetree, pool);
788   }
789   else {
790     if (texture->type == TEX_IMAGE) {
791       if (texture->ima != NULL) {
792         BKE_image_pool_acquire_ibuf(texture->ima, &texture->iuser, pool);
793       }
794     }
795   }
796 }