You are here

Map Style

  • 1
  • 2
  • 3
  • 4
  • 5
Total votes: 0
Rate this item!
AttachmentSize KB
ufo-grass-example.jpg19.44 KB

Users Guide

What this plugin does:

Transfers artistic style from one image to another. Often the source is an artistic image and the target is a realistic, photo image. But you can also transfer between artistic images or between realistic images.

An artist might say this plugin "renders in the media and style from another image." A computer user might say it "renders in the theme of another image."

Transferring style means transferring small scale features (color and texture) to an image while retaining large scale features (objects.)

Map can mean "transfer and transform". This plugin gives limited control of the transform. That is, colors are usually mapped to similar colors (hues.) This plugin is not intended to do "false color" (but it might have that effect.)

Style can mean "color and surface." Texture mapping usually means just surface (pattern of brightness, e.g. a weave or grain.) This plugin can transfer both color and surface.

This plugin has more effect than just an overlay or screen or a map. A screen usually applies a texture uniformly across an image. This plugin transfers style in patches. The style in a region can come from any patch of the source, or be synthesized (mixed) from many patches of the source.

The transfer is not exactly a copy, again because of optional synthesis or mixing.

About the selection:

Usually you transfer between separate images, the target and source images. You can make a selection in either image, or both. If there is no selection, the plugin uses the entire layer.

The target is the active LAYER and you can choose the source LAYER. Note that the plugin doesn't use everything visible in an image, just one layer.

SPECIAL CASE: If the target and source layers are in the same image, the source style comes from the inverse of the selection in the source layer. Similarly, if the target and source layers are the same layer, the target is the selection and the style comes from the inverse of the selection, i.e. outside the selection. In this case, the effect is little if there is no difference in texture between the inside and outside of the selection, or a distort, if there is a difference.

About the settings:

"Percent transfer:" how much style to transfer. Less transfer means the effect retains the large scale objects of the original, but gives the image a grainy surface. More transfer means the effect leaves only a ghost of the large scale objects, and almost fully copies the style image (with less synthesis or mixing.)

"Map by:" whether color affects the style transfer, when both target and source are in color. If you choose "color and brightness", style colors are more apt to be transferred to areas with same colors. However, it is still possible that colors are radically transformed, if the surface (brightness pattern) is a better match. If you choose "brightness only", style colors are more apt to be radically transformed.

This setting has less effect if there are no color matches between source and target (e.g. one is all red and the other is all green) or if the target image is GRAY. This setting has NO effect if the source image or both images are GRAY.

About modes:

You can transfer style between any combination of RGB and GRAY images. The plugin changes the mode of the target to the mode of the source as necessary.

Why this plugin:

This plugin is a front-end to the separate resynthesizer plugin. This plugin simplifies using the resynthesizer plugin. It automates many steps. It hides several complexities of the resynthesizer plugin: selection, modes, alpha channels, and settings.

The best examples are at the resynthesizer author's site:

This is an example of an image, a source, and the result of the plugin at 50% transfer:

Standard installation instructions apply.

Appears as Filters.Map.Style

Code License: 
GIMP Version: 
Scripting Engine: 


Ok, some things are just too simple to figure out!

I removed the last two parameters from the .py file on line 345:

pdb.plug_in_resynthesizer2(image, drawable, 1, 1, 1, source_drawable, source_map, target_map, map_weight, 0.117, 9, 200)


pdb.plug_in_resynthesizer2(image, drawable, 1, 1, 1, source_drawable, source_map, target_map, map_weight, 0.117)

NOTE: This is for those of you using Resynthesizer .13!

It tends to grab a portion from the top of an image when using heal selection, and makes the selected areas look worse. Example, you select a grassy area to heal, and its replaced with blue sky from the top of the image.

Version .13 doesn't do this.

it should be possible adapt the script to 1..3 version

But is a pity that nobody seems interested to fix that bug and mantain the plugin


Subscribe to Comments for "Map Style"