UV Texture Mapping

3D applications are highly effective in composing models and animation, capable of rendering startlingly realistic scenes. It would be great to export the output of your favorite 3D application into ImpossibleFX so you could combine it with other footage and use the systems's many functions to manipulate this data as video. You could create a 3D model of a face and texture it with a user's photo (face mapping) or you can texture a waving flag with images or a video.

The process to do this is called UV texture mapping. The mapping process transforms a source image by remapping its pixels. Pixel remapping is performed using another image - a UV map - to look-up the coordinates of the source image pixel that is written to the target destination image pixel.

The UV map is just an image (usually a 32-bit floating point TIFF) that encodes the source pixels position as a color. As you need 2 coordinates to map a position, a UV map uses only two colors, namely red and green, where the red color channel encodes the horizontal, X axis and green encodes the Y axis.

Original UV texture and a UV map

Original source and mapped result

Texuremapping32f

Field name	Field type	Description
Required fields
	Transformation.Type	texuremapping32f
image	ImageProvider	Reference to the UV map image sequence (type 'video', ZIP with '.uvmap' extension and 32bit floting point TIFF images)

Example

{
    "scenes": [
        {
            "numframes": 1,
            "tracks": [
                {
                    "content": {
                        "type": "stillimage",
                        "source": {
                            "path": "userdata/obama.jpg"
                        }
                    },
                    "transformations": [
                        {
                            "image": {
                                "type": "video",
                                "source": {
                                    "path": "userdata/mapswirl.uvmap"
                                }
                            },
                            "type": "texturemapping32f"
                        }
                    ]
                }
            ]
        }
    ],
    "params": {
        "vparams": {
            "width": 110,
            "height": 150
        }
    }
}