Difference between revisions of "Pyluxcoretool merge"

From LuxCoreRender Wiki
Jump to navigation Jump to search
(Created page with "== 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...")
 
Line 38: Line 38:
 
</pre>
 
</pre>
  
== Tutorals ==
+
== Tutorials ==
 +
 
 +
=== Merging two films into a new one ===
 +
 
 +
pyluxcoremerge.py film1.flm film2.flm -f result.flm
 +
 
 +
Any number of films to merge can be specified.
 +
 
 +
=== Merging two films into a new one and write the image pipeline output===
 +
 
 +
pyluxcoremerge.py 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).
 +
 
 +
pyluxcoremerge.py 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.

Revision as of 13:09, 4 February 2018

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: pyluxcoremerge.py [-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: pyluxcoremerge.py [-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 filme and the placement in the destination film
                        where the it will be merged

Tutorials

Merging two films into a new one

pyluxcoremerge.py film1.flm film2.flm -f result.flm

Any number of films to merge can be specified.

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

pyluxcoremerge.py 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).

pyluxcoremerge.py 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.