Difference between revisions of "Pyluxcoretool merge"

From LuxCoreRender Wiki
Jump to navigation Jump to search
Line 4: Line 4:
  
 
<pre>
 
<pre>
usage: pyluxcoremerge.py [-o FILE_NAME] [-f FILE_NAME] [-h]
+
usage: pyluxcoretools.zip [-o FILE_NAME] [-f FILE_NAME] [-h]
  
 
PyLuxCoreMerge
 
PyLuxCoreMerge
Line 13: Line 13:
 
   -f FILE_NAME, --film-output FILE_NAME
 
   -f FILE_NAME, --film-output FILE_NAME
 
                         Save the merge film to a file
 
                         Save the merge film to a file
   -h, --help            Show this help message and exit.
+
   -h, --help            Show this help message and exit
usage: pyluxcoremerge.py [-p] [-s]
+
usage: pyluxcoretools.zip [-p] [-s]
                        [-r SRC_OFFSET_X SRC_OFFSET_Y SRC_WIDTH SRC_HEIGHT DST_OFFSET_X DST_OFFSET_Y]
+
                          [-r SRC_OFFSET_X SRC_OFFSET_Y SRC_WIDTH SRC_HEIGHT DST_OFFSET_X DST_OFFSET_Y]
                        fileFilm
+
                          fileFilm
  
 
Film Options
 
Film Options
Line 34: Line 34:
 
   -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
 
   -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
 
                         define the origin and the size of the region in the
                         source filme and the placement in the destination film
+
                         source film and the placement in the destination film
 
                         where the it will be merged
 
                         where the it will be merged
 +
 
</pre>
 
</pre>
  
Line 42: Line 43:
 
=== Merging two films into a new one ===
 
=== Merging two films into a new one ===
  
  pyluxcoremerge.py film1.flm film2.flm -f result.flm
+
  pyluxcoretool merge film1.flm film2.flm -f result.flm
  
 
Any number of films to merge can be specified.
 
Any number of films to merge can be specified.
Line 48: Line 49:
 
=== Merging two films into a new one and writing the image pipeline output===
 
=== Merging two films into a new one and writing the image pipeline output===
  
  pyluxcoremerge.py film1.flm film2.flm -o result.jpg
+
  pyluxcoretool merge film1.flm film2.flm -o result.jpg
  
 
You can also output the new film and image at the same time.
 
You can also output the new film and image at the same time.
Line 56: Line 57:
 
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).
 
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
+
  pyluxcoretool merge film1.flm -r 100 100 150 150 10 10 film2.flm -o result.jpg
  
 
=== Support for .flm, .rsm and .cfg files ===
 
=== Support for .flm, .rsm and .cfg files ===

Revision as of 09:47, 6 May 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: 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.