» badMapper
This site relies heavily on Javascript. You should enable it if you want the full experience. Learn more.


Credits: MadMapper, DominikKoller


Inspired by MadMapper and mapping-toolkit (alpha) badMapper allows to select multiple rectangles from a SourceRenderer and distort those (via homography) in a DestinationRenderer.

Provide a texture with your own content, point your projector to the surfaces you want to be mapped and go fullscreen on it with the Destination Renderer. Create/place/size selections in the Source and then drag their corresponding cornerpoints to their targetposition by directly operating in the Destination Preview Renderer. Selections can be tweaked pixelprecise via keyboard, vertices snap, mappings can be saved/loaded, ... which makes this a perfectly usable tool for simple scenarios.

Built in an ultra-modular fashion that allows it to be easily adapted to a DX11 version.

Also available via github.


24.06.17 [18:11 UTC] by dominikKoller | 2225 downloads
fixed legacy cursor nodes. tested with b35.7
Show 6 older revisions

Older Revisions

21.05.16 [16:55 UTC] by joreg | 1067 downloads
fixed texture filtering for destination to Linear (was Point)
12.04.16 [22:00 UTC] by joreg | 627 downloads
minor cosmetics, no functional changes. tested with b34.2
02.09.14 [17:15 UTC] by dominikKoller | 1733 downloads
Rework for b>32.1
09.05.14 [17:11 UTC] by joreg | 1235 downloads
updated for b32
20.05.14 [18:54 UTC] by herbst | 843 downloads
made a quick hack for a DX11 version -- working but ugly!
21.11.13 [23:45 UTC] by joreg | 1104 downloads
initial release

everyoneishappy 22/11/2013 - 06:04

Haha love the name :)

Noir 22/11/2013 - 11:29


manuel 01/05/2014 - 15:59

whats this xy node that is missing ?=

joreg 01/05/2014 - 16:01

probably not missing but you're not running latest vvvv, see: new-vector-swizzle-nodes-and-vector-joinsplit-up-to-5x-faster

manuel 01/05/2014 - 16:05

ups, i just notice that, your reply was too fast!

Alec 02/05/2014 - 14:52

Nice tool! TYVM! Would be great if it has keyboard controls to select and move cornerpoints more carefully.

herbst 20/05/2014 - 18:57

I uploaded a DX11 version which is working, but not nice (texts are wrong format, contains a lot of hacks for strange Transform behaviours -- Billboard not working as I expected etc., no wireframe). Would be cool if someone makes it better, though.

artifak 22/09/2014 - 09:54

im currently have the vvvv b32.1 x64. If i open the badMapper (dx9) help patch its open but the badMapper node turn red (its like it missing node). can anyone help me why its happening?


joreg 22/09/2014 - 12:59

@artifak: as mentioned above badmapper v3 needs b>32.1 so try again with b33.1 please.

artifak 22/09/2014 - 13:15

@joreg owh i thought its from b32.1 to the newest, oke oke thx for the explanation ad suggestion :)

anonym_hk 09/10/2014 - 13:38

Hi, Just stumbled on Bad Mapper.
It is assumed that the polygons have four vertices. What if I want a polygon with more or less vertices for masking?
I changed bin size for polygons in the sub folder patches. But then I started to get weird shaped textures. No wonder :)
How do I do it?
Thanks, Bad Mapper is cool.

dominikKoller 06/11/2014 - 21:14

@anonym_hk You have to apply masks to the content before putting it into badMapper. badMapper cannot do any masking (for now). It would be a lovely feature, I agree!

Maybe someone wants to give it a try? ;)

screamer 28/01/2015 - 15:42

hey guys,
i love badmapper, but i also love dx11, so i've made a conversion of the latest v3 bad mapper.
Now i'm in the point that i have a badmapper that works identical in dx9 or dx11 (in the same module), but probably is more convenient to create a dx11 only badmapper (only a matter of cutting pieces now).
anyway, if someone is interested, here it is


Noir 28/01/2015 - 18:12

totally agree with u

joreg 28/01/2015 - 19:07

@screamer that does not sound like the way to go. essentially you'd only have to create DX11 versions of those modules that are now there as DX9 modules only. then they can happily live sidebyside. see?

screamer 28/01/2015 - 21:32

@joreg: yes, i agree, and in fact, after confirming to myself that quite all is working in dx11, i'm going to delete all the dx9 part and polishing the dx11 part a bit, just to have both versions working indipendently.
you can say that the one i posted is only the first rough conversion, but seems to work in the most substantial parts.

i've found a problem in dx11 about ActiveWindow not giving the correct handle (i've written a forum post with an example attached, and you can find it here: activewindow(windows)-dosent-give-the-right-windows-handle-with-dx11-render

screamer 28/01/2015 - 21:57

here we are, this is the DX11 only version. Not perfect, i still have some graphical differences (text without the brush, different size of some GUI parts, some nonclosed lines in the GUI, and last, i'm not the most clean patcher here, so don't expect clean subpatches as the original was :)
but for all the rest, seems to do the job quite well


Amerlander 03/05/2016 - 13:29

@screamer: I´m really interested in your dx11 version, could you reupp it?
I´m pretty new to vvvv, so even after reading a load of tutorials I have no clue what to change in that "ultra-modular fashion that allows it to be easily adapted to a DX11 version." :)

screamer 03/05/2016 - 15:27

@Amerlander: need to find a backup, or to redo the porting again, gimme some time to sort it out ;)

screamer 03/05/2016 - 20:13

Here we are, i've found my backup, there was some things no more working, but now it should work with the latest beta of vvvv, let me know


Amerlander 04/05/2016 - 17:46

wow great, the test setup with spout and AfterFX works like a charm now. Thank you! :)

Veronika_Bol 26/01/2017 - 09:43

I'm working with vvvv b32.1 x64 and i already did all my Patches. But now i need to map video. And for that i need a bad Mappen, which is as i get working only with another Version? But if i open my patch in another one, some things such Hit Boxen turning red.
How can i map my video in this Situation

joreg 26/01/2017 - 12:54

you should really get your patch working with beta35 first. please start a new forum thread about your troubles when opening your patches with beta35.

artifak 06/06/2017 - 09:34

Dear joreg

i tried using bad mapper again and it still an absolutely awesome patch, but i wonder can i use multiple texture or source to the badmapper and have different polygon for every texture? for example i use texture A for polygon 0 and switch to texture B for polygon 1 and so on.

thank you

joreg 06/06/2017 - 12:37

@artifak in order to do this you'll have to first "merge" the textures to one, by e.g. rendering them together in an extra renderpass and then using that combined result as input to the badMapper. hope that explains..

artifak 07/06/2017 - 07:30

@joreg ehmmm did you mean by merge it first in another renderer and pass them using dx9texture?

joreg 07/06/2017 - 12:24

@artifak: exactly..using dx9texture..

knoeterich 21/03/2018 - 19:20

is it possible to get this to work with two or renderer which render different parts of the texture to cover different angles of the "real world image"?

joreg 04/04/2018 - 13:06

@knoeterich for sure this can be adapted to your needs. only it would kinda go beyond the scope of a simple answer here. try to take steps in the direction and ask more specific questions on the forum as they arise.

Aurel 14/09/2018 - 00:46

Good hey mates from Wisp...!
Working with severals beamers with badmapper and boygrouping.
We are looking for a method to save renderers positions.
Problem is when closing and saving from server or client, the position is lost and we have to manage it each time we restart.

Thanks !


tonfilm 17/09/2018 - 22:07

@Aurel maybe you need the SetRenderer node from here: setrenderer-(ex9)

madPhan 05/12/2018 - 10:59

As the link for the badmapper dx11 version doesn´t work anymore would it be possible that anyone uploads the conversion of badmapper for dx11 again? This would be really great. Many thanx Stephan

Urbachd 07/01/2020 - 06:58

I just started working with vvvv, should I be using this with beta35? when I open the patch in beta39 the badmapper node is red.

joreg 07/01/2020 - 12:29

@madPhan you can write @screamer to get his attention since he was the one who shared the dx11 version...

joreg 09/01/2020 - 03:06

@Urbachd cannot confirm. just tested this to work with latest b39. you're not missing the addonpack, are you?

Urbachd 09/01/2020 - 03:13

@Joreg I do not have the dx11 add on pack, I believe that is the problem with badmapper's node being red. @Iorec brought that up as well. I'll install the add and post the results.

joreg 09/01/2020 - 03:19

@urbachd you don't need the dx11 pack for badMapper. only the addonpack that since b39 is by default installed by the installer.

Urbachd 09/01/2020 - 03:44

Oh,OK. Thanks!

m9dfukc 27/01/2020 - 18:52


can anybody the provide me the DX11 version of badMapper @screamer did? All the links from above seem to be dead unfortunately :/


tsch8n 15/01/2021 - 14:30
  • push

Im interested in the dx11 version too!

matka 31/08/2021 - 11:55

+1 for the DX11 version. Cheers!

Meierhans 18/03/2022 - 11:56


urbandrone 24/03/2022 - 16:16

@noir very very good thanks a million

Meierhans 31/03/2022 - 00:05

thx alot!

anonymous user login


~1d ago

joreg: Workshop on 07.12: An Introduction to FUSE Signup here: https://thenodeinstitute.org/courses/ws23-vvvv-03-fuse-introduction/

~8d ago

joreg: Workshop on 30.11: Strategies for Sound Reactive Graphics: How to control everything through sound Signup here: https://thenodeinstitute.org/courses/ws23-vvvv-02-how-to-control-everything-through-sound/

~18d ago

joreg: The vvvv winter semester course program is out, starting with a free course on November 23rd: https://thenodeinstitute.org/ws23-vvvv-intermediates

~18d ago

LCA: ravazque, this guy is working on this v3 since ever. check: https://nuitrack.com/

~28d ago

~2mth ago

karistouf: done with vvvv beta :) https://vimeo.com/872242439

~2mth ago

joreg: Mapping festical call for projects: https://mappingfestival.com/en/call-for-projects

~2mth ago

joreg: Starting October 16: vvvv beginner class winter 23/24 Sign up here: https://thenodeinstitute.org/courses/ws23-vvvv-beginner-class/