Page MenuHome

Image Layer for Blender
Closed, ArchivedPublicPATCH


Hello everyone!
I started to develop features for images to create layers [1] in Blender, as in PS and Gimp!!
A first implementation was done by KWK (Konrad Kleine) [2] for Gsoc2010.
After just over a month, I am ready with the first phase of image layers.

For information about the roadmap:
Instead, for information regarding the status of the project:


The builds are uploaded to

The current status of the project is:

Layers v0.1 beta2 new features and fixed bug for Phase 1. Completed: 15\4\2012:
1. FIX: Fixed many memory problems.
2. FIX: Increased the range of parameters of the function “sdrawbox” in “glutil.c”. When you
have a zomm very excessive, the dashed border of the layer changed direction.
3. FIX: Almost solved the problem of the black border, when you paint on a layer.
4. UPD: The layers are handled by the bottom to the top, as in GIMP e PS.
5. UPD: Improved UI.
6. UPD: Layer names are handled by the API of Blender
7. UPD: The BaseLayer if it is not a layer, it can not be moved.
8. UPD: Added control to manage operations on layers only when it is in the “Painting mode”.
9. ADD: Added Menu for the management of the layers.
10. ADD: Added the ability to create layers above or below a selected layer.
11. ADD: For some operations have been associated keyboard shortcuts.
12. ADD: Added the Menu “Select”.
13. ADD: Added the dotted border around the layer. With the ability to change color at the
dotted line in the Theme Manager. In addition there is also the possibility to
disable it.
14. ADD: Now you see a cursor in the Image Space more inherent, which is disabled if you can
not draw.
15. ADD: When you invoke the Color Sample in paint mode, you see a box at the bottom left with
the selected color.
16. ADD: Added the ability to clear a layer, even if the layer is loaded a photo.
17. ADD: The Color Picker in the Image Editor, in Vertex Paint and Texture Paint change to
reflect your choices nell’User Preferences.
18. ADD: You can add an image as a layer.
19. ADD: Added the Menu “Order”.
20. ADD: Added the Menu “Merge”.
21. ADD: Ability to lock a layer.

Layers v0.1 beta1 new features and fixed bug 2\3\2012:

1. FIX : Fixed many bugs from the patch of KWK.
2. UPD: Improved UI.
3. ADD: With the creation of a new image now you can choose the background color: Transparent, White, RGB.
4. ADD: Ability to duplicate a layer.
5. ADD: Blend Modes: Normal, Multiply, Screen, Overlay, Soft Light, Hard Light, Color Dodge, Linear Dodge, Color Burn, Linear Burn, Average, Add, Subtract, Difference, Lighten, Darken, Negation, Exclusion, Linear Light, Vivid Light, Pin Light, Hard Light.


Event Timeline

tried to compile and i get this error:

using scons on windows 7 x64, and building blender x64.

Fix for ImageLayer_Blend_type_HARD_LIGHT compile issue with cycles on windows

thanks, it compile ok now.

hi again, it doesn't build with cycles, and it hangs on render (f12)!

What errors are displayed when compiling? I have now compiled using scons with VS2008 on Win 7 64bit and gave no problems!
the block by pressing F12 I know, I'm trying! XD

here is the log:

Layers v0.2 beta6 new features and fixed bug for Phase 2. Completed: 28\09\2012:
1. FIX: If there is only one layer and you try to delete it, Blender crashes.
2. FIX: You create a layer only if it is an image of a file or if it is a generated image.
In this way you avoid several crashes.
3. FIX: Fixed a display issue of the border around the image.
4. FIX: When you render a scene, Blender does not lock.
5. FIX: If it is invisible Baselayer and remove layers invisible, Blender crashes.
6. FIX: Quando applicavo Merge All con foto in un layer si verificava un crash.
7. UPD: When does the "Merge All" and is also deleted the "Background", the last layer is
renamed "Background".
8. UPD: In the "Merge All" when you delete the "Background", the "default_color" is set in
white, the property "Background" in "IMA_LAYER_BG_WHITE".
9. UPD: Updated "startup.blend" with the properties of the dashed border to the image.
10. UPD: In the panel Image Layers when you create a layer is created with the default settings.
11. UPD: Modified functions "BKE_image_get_ibuf" and "BKE_image_acquire_ibuf" in order to allow
the integration of layers in Blender.
12. UPD: Modified "IMB_imbuf_types.h" in "DNA_imbuf_types.h", so you can save the ImBuf within
files ".Blend".
13. UPD: Modified "image_get_ibuf" so you can return a layer or merge layers.
Useful for integration.
14. UPD: Updated Blending layers but the problem of the black border around the stroke has not
been resolved.
15. UPD: Changed the way you view an image in the "View" and for Render.
Now uses the "glaDrawPixelsTexScaled".
16. UPD: In the structure "Image" is connected to ibufs the resulting image of the union of
all layers.
17. ADD: Added menu "Transform".
18. ADD: Added menu "Scale".
19. ADD: Added "Open Image" in the header of the Space Image.
20. ADD: Ability to save layers and images in the file. "Blend".
21. ADD: Now you can choose the layer to be used within the node "Image".
22. ADD: Now it is possible to save an image composed of several layers.

Layers v0.3 new features and fixed bug for Phase 3. Completed: 03\03\2014:

  1. FIX: Mancata assegnazione del nome alla creazione di un layer di default.
  2. FIX: Nello Space Image se passo nella modalità paint senza un'immagine, Blender crash.
  3. FIX: Nello Space Image prodotto da un render o dal Composite se si passa nella modalità paint, Blender crash.
  4. FIX: BUG danxsy: Crash quando aggiungo un layer mentre eseguo l'unwrap.
  5. FIX: Reload e Replace Image non funzionavano correttamente.
  6. FIX: Open as Layer non visualizzava il layer con l'immagine.
  7. FIX: Risolto problemi di inizializzazione dell'ImBuf dei layer.
  8. FIX: Le dimensioni di un'immagine ruotata ora vengono calcolate correttamente.
  9. FIX: Risolti problemi con i seguenti Blend Mode: Color Dodge, Color Burn, Vivid Light e Hard Mix.
  10. FIX: Ora blender non crash quando si richiama l'Undo.
  11. FIX: Nel caso in cui si apre un immagine da un file, i layer se resi tutti invisibili venivano cancellati.
  12. FIX: Ora i layer di un'immagine salvati all'interno di un file .blend vengono letti correttamente.
  13. FIX: Se si apre un file con all'interno un'immagine e i propri layer, l'immagine viene visualizzato con un ColorSpace errato.
  14. FIX: All'apertura di un file con all'interno un'immagine con i propri layer si ha il crash di Blender, perchè non veniva salvato correttamente il ColorSpace dei layer.
  15. FIX: Se ho un'immagine con dei layer e passo dall'Image Editor al 3D View, Blender crash.
  16. FIX: Risolto il problema che si presentava quando si aveva un'immagine trasparente. Il blend mode veniva calcolato solo dove si sovrapponevano i colori, non visualizzando le parti dove la base era trasparente.
  17. FIX: Se gli offset superavano le dimensioni dell'immagine, la memoria non veniva deallocata.
  18. FIX: Ora se il wrap è disattivato per i valori negativi l'immagine non si ripete.
  19. FIX: L'offset sull'asse x e y ora è completo, prima rimaneva l'ultimo pixel non traslato.
  20. FIX: Quando viene cancellata un'immagine non liberava la memoria del preview.
  21. UPD: Anche i layer ora sono Thread Safe.
  22. UPD: Aggiornati i layer con la nuova gestione dell'Image Thread.
  23. UPD: Aggiunto shortcut: ALT + LeftClick per creare un layer di default.
  24. UPD: Il Panel "Image Layer" è visualizzato solo se esiste un immagine e se ci si trova nella modalità "Paint".
  25. UPD: Migliorato Sample Color nella modalità Paint (tasto: S). Con il tasto destro del mouse e con il tasto ESC, ripristina il colore iniziale. Inoltre preleva solo il colore dell'immagine e non anche quella dell'interfaccia.
  26. ADD: Aggiunta la possibilità di utilizzare la modalità di Color Space: GrayScale.
  27. ADD: Aggiunto il menù "Image".

Menu Image

-> Color Space
-> GrayScale
-> RGB
-> ------------------
-> Duplicate
-> Trasforma
-> Rifletti Orizzontalmente
-> Rifletti Verticalmente
-> ------------------
-> Ruota di 90° in senso orario
-> Ruota di 90° in senso antiorario
-> Ruota di 180°
-> Rotazione Arbitraria
-> ------------------
-> Spostamento
-> Scala Immagine
-> ------------------
-> Fonde livelli visibili
-> Appiattisci Immagine
  1. ADD: Aggiunto il menù "Color".

Menu Color

-> Luminosità - Contrasto
-> Esposizione
-> ------------------
-> Colora
-> Desaturazione ...
-> ------------------
-> Soglia
-> Posterizza
-> Inverti ...
-> Inverti Valore
  1. ADD: Aggiunta la possibilità di bloccare l'alpha mentre si dipinge.
  2. ADD: Aggiunti i seguenti Blend Mode: Inverse Color Burn, Soft Burn.
  3. ADD: Aggiunta possibilità di utilizzare l'undo con le operazioni sui layer.
  4. ADD: Aggiunto alla rotazione arbitraria, il sampling dell'immagine.
  5. ADD: La rotazione arbitraria ora ha la possibilità di lasciare le dimensioni originali dell'immagine.
  6. ADD: Aggiunto preview alle seguenti operazioni:

Mode View
Menu Image

-> Trasforma
-> Rotazione Arbitraria
-> Spostamento

Menu Color

-> Luminosità - Contrasto
-> Esposizione
-> Colora
-> Soglia
-> Posterizza

Mode Paint
Menu Image

-> Trasforma
-> Rotazione Arbitraria
-> Spostamento

Menu Color (Layer Selezionato)

-> Luminosità - Contrasto
-> Esposizione
-> Colora
-> Soglia
-> Posterizza

Menu Layer (Layer Selezionato)

-> Trasforma
-> Rotazione Arbitraria
-> Spostamento

doesn't patch with today's pull dad96000
using patch command from git -> doesn't recognize the format
using patch -p0 < -> many fails

can you post the blender git version you used, thanks.

also can you add the log in english :)

Fabio Russo (ruesp83) added a comment.EditedMar 5 2014, 1:30 AM

You can use the patch till the rB51b9d85 revision, because after that the handling of the images inside the code changed.
I stopped updating to publish the project official release.
I will soon update the patch.

Aaron Carlisle (Blendify) changed the task status from Unknown Status to Unknown Status.Sep 4 2016, 1:41 AM
Aaron Carlisle (Blendify) claimed this task.

Time to archive, discussing can continue on D1135