Pyluxcoretool merge

From LuxCoreRender Wiki
Jump to: navigation, search

Introduction

PyLuxCoreMerge is a command line tool for merging and multiple films. Films have usually the ".flm" file extension and are the most rich type of image file format you can obtain as out of a LuxCoreRender rendering. The command line options are:

usage: pyluxcoretools.zip [-o FILE_NAME] [-f FILE_NAME] [-h]

PyLuxCoreMerge

optional arguments:
  -o FILE_NAME, --image-output FILE_NAME
                        Save the RGB_IMAGEPIPELINE film output to a file
  -f FILE_NAME, --film-output FILE_NAME
                        Save the merge film to a file
  -h, --help            Show this help message and exit
usage: pyluxcoretools.zip [-p] [-s]
                          [-r SRC_OFFSET_X SRC_OFFSET_Y SRC_WIDTH SRC_HEIGHT DST_OFFSET_X DST_OFFSET_Y]
                          fileFilm

Film Options

positional arguments:
  fileFilm              .cfg, .flm or .rsm files with a film

optional arguments:
  -p, --pixel-normalized-channel
                        the film will have
                        CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED (required by all
                        render engines)
  -s, --screen-normalized-channel
                        the film will have
                        CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (required by
                        BIDIRCPU and LIGHTCPU render engines)
  -r SRC_OFFSET_X SRC_OFFSET_Y SRC_WIDTH SRC_HEIGHT DST_OFFSET_X DST_OFFSET_Y, --region SRC_OFFSET_X SRC_OFFSET_Y SRC_WIDTH SRC_HEIGHT DST_OFFSET_X DST_OFFSET_Y
                        define the origin and the size of the region in the
                        source film and the placement in the destination film
                        where the it will be merged

Tutorials

Merging two films into a new one

pyluxcoretool merge film1.flm film2.flm -f result.flm

Any number of films to merge can be specified.

Merging two films into a new one and writing the image pipeline output

pyluxcoretool merge film1.flm film2.flm -o result.jpg

You can also output the new film and image at the same time.

Merging a sub-region of a film and write the image pipeline output

The following command merge a sub-region of film2.flm starting at (100, 100) and with width and height 150x150 to the destination at (10, 10).

pyluxcoretool merge film1.flm -r 100 100 150 150 10 10 film2.flm -o result.jpg

Support for .flm, .rsm and .cfg files

Not films but also resume rendering files and rendering configurations can be used.

Resume rendering files

The film included in a resume rendering file will be extracted and used.

Rendering configuration files

The film defined in a rendering configuration file can be used to create a new blank film with any type of size, image pipeline, radiance groups, etc.