Difference between revisions of "3Denlive User Guide"

From 3Denlive
Jump to: navigation, search
(Table of contents)
(Table of contents)
 
(33 intermediate revisions by the same user not shown)
Line 10: Line 10:
 
Original input picture and video files are never changed/modified on disk.
 
Original input picture and video files are never changed/modified on disk.
  
Output picture or video files are always written only once (with no intermediate temporary files produced) at the final rendering time. Knowing that compressed file formats like JPG, MP3 or MP4 are always damaging the result in some ways, writing the output files only once ensure the best possible quality on the result.
+
Output picture or video files are always written all at once (with no intermediate temporary files produced) at the final rendering time. Knowing that compressed file formats like JPG, MP3 or MP4 are always damaging the result in some ways, writing the output files all at once ensures the best possible quality on the result.
  
 
[[File:Non-linear_processing.png|center|x100px]]
 
[[File:Non-linear_processing.png|center|x100px]]
  
Input files may be in heterogeneous formats, and may be processed in a higher resolution than the final rendered result. Knowing that all image modifications (resize, translate, rotate, etc) are damaging the results in some ways, processing them in a higher resolution ensure the best possible quality on the result.
+
Input files may be in heterogeneous formats, and may be processed in a higher resolution than the final rendered result. Knowing that all image modifications (resize, translate, rotate, etc) are damaging the results in some ways, processing them in a higher resolution ensures the best possible quality on the result.
  
 
[[File:Non-linear_processing_res.png|center|x100px]]
 
[[File:Non-linear_processing_res.png|center|x100px]]
Line 20: Line 20:
 
For efficiency purposes:
 
For efficiency purposes:
 
* the processing resolution is lower when working within 3Denlive (typically, HD = 720 lines), than the resolution used for full-screen displaying (typically, FullHD = 1080 lines), than the resolution used for the final rendering (typically, 4K = 2160 lines).  
 
* the processing resolution is lower when working within 3Denlive (typically, HD = 720 lines), than the resolution used for full-screen displaying (typically, FullHD = 1080 lines), than the resolution used for the final rendering (typically, 4K = 2160 lines).  
* for each high-resolution video input file, a low-resolution copy of it is built to be used when working within 3Denlive. The original high-res video input file is used when producing the final rendering.
+
* for each high-resolution video input file, a low-resolution copy of it is built to be used when working within 3Denlive. The original high-resolution video input file is used when producing the final rendering.
  
 
Processing pipe:
 
Processing pipe:
Line 26: Line 26:
 
# '''clips in the timeline'''. Each clip refers to an input media. It resizes this input media to the project ratio (1:1, 4:3, 16:9, etc) at the processing resolution (for example 4K), defines a start time and a duration, and holds a collection of processors to be applied to it (stereo alignment, resizing, positioning, colors filtering, etc). Multiple clips can refer to the same input media, with different start times and durations, possibly applying different processors.  
 
# '''clips in the timeline'''. Each clip refers to an input media. It resizes this input media to the project ratio (1:1, 4:3, 16:9, etc) at the processing resolution (for example 4K), defines a start time and a duration, and holds a collection of processors to be applied to it (stereo alignment, resizing, positioning, colors filtering, etc). Multiple clips can refer to the same input media, with different start times and durations, possibly applying different processors.  
 
# '''composition of the timeline tracks'''. Tracks are combined together layer by layer. A track is overwriting/masking the tracks below it.
 
# '''composition of the timeline tracks'''. Tracks are combined together layer by layer. A track is overwriting/masking the tracks below it.
# '''output file rendering''' (typically, PNG or MP4). The processed multi-tracks composition is resized to the final rendering resolution (for example FullHD) and sent to the final processor building the output file (typically, PNG or MP4 compressors). If a single picture is produced, only one point of the time line is processed (typically, the current time cursor position), otherwise the timeline is processed point by point, depending on the required frame rate of the final video (typically, 30 images per second).
+
# '''output file rendering''' (typically, PNG or MP4). The processed multi-tracks composition is resized to the final rendering resolution (for example FullHD) and sent to the final processor building the output file (typically, PNG or MP4 compressors). If a single picture is produced, only one point of the timeline is processed (typically, the current time cursor position), otherwise the timeline is processed point by point, depending on the required frame rate of the final video (typically, 30 images per second).
 +
 
 +
== Before reading this User Guide ==
 +
 
 +
You may have a look at:
 +
* the [http://3denlive.com/doc/EN/index.php Quick Start Guide].
 +
* the [http://3denlive.com/demos/en.php Demo Packs] that demonstrate some features, providing with all necessary files you can download to reproduce and study on your own machine.
  
 
== Table of contents ==
 
== Table of contents ==
Line 37: Line 43:
 
## [[Save a picture]]
 
## [[Save a picture]]
 
## [[Render a video]]
 
## [[Render a video]]
# Processors
+
# Monitor panel
 +
## [[Working configuration]]
 +
## [[Player control]]
 +
# Timeline panel
 +
## [[Manage timelines]]
 +
## [[Manage clips in timelines]]
 +
# Properties panel
 +
## Media properties
 +
## Clip properties
 +
## Processor properties
 +
# Processor library panel
 
## Stereo
 
## Stereo
### [[Alignment]]
+
### Alignment
### [[Color adaptation]]
+
### Color adaptation
 +
### 2D+depthmap->stereo
 +
### Stereo+depthmap->stereo
 
## Colors
 
## Colors
### [[Hue saturation]]
+
### Hue saturation
### [[Brightness contrast]]
+
### Brightness contrast
 +
## Image
 +
### [[Lens correction (ffmpeg K1 K2)]]
 
## Composition
 
## Composition
### [[Cropping]]
+
### Cropping
### [[Placement]]
+
### Placement
### [[Transparency / transition]]
+
### Transparency / transition
### [[Chroma key (green background)]]
+
### Chroma key (green background)
 
## Design
 
## Design
### [[Framing]]
+
### Framing
 
## Expert
 
## Expert
### [[Script]]
+
### Script
 +
# [[3D-stereo softwares]]
 +
# [[3D-stereo discussion groups]]
 +
# Personal experiments
 +
## [[Low-cost stereo camera]]
 +
# General discussions
 +
## [[Mono-lens stereo beam splitter]]

Latest revision as of 08:21, 16 April 2021

3Denlive is a Non-linear editing freeware.

  • it may be used to produce 2D or 3D-stereoscopic pictures or videos from 2D or 3D-stereoscopic pictures or videos.
  • it's a multi-platforms software currently available for Windows, MacOsX, and Linux.
  • it's written in Java, thus potentially working on all kinds of systems. For not-already-available systems, few native third party modules are mandatory (especially ffmpeg for video handling) and need to be properly installed and configured.

3Denlive is inspired by the multi-platforms open-source kdenlive software, but shares no code with it.

Non-linear editing principle

Original input picture and video files are never changed/modified on disk.

Output picture or video files are always written all at once (with no intermediate temporary files produced) at the final rendering time. Knowing that compressed file formats like JPG, MP3 or MP4 are always damaging the result in some ways, writing the output files all at once ensures the best possible quality on the result.

Non-linear processing.png

Input files may be in heterogeneous formats, and may be processed in a higher resolution than the final rendered result. Knowing that all image modifications (resize, translate, rotate, etc) are damaging the results in some ways, processing them in a higher resolution ensures the best possible quality on the result.

Non-linear processing res.png

For efficiency purposes:

  • the processing resolution is lower when working within 3Denlive (typically, HD = 720 lines), than the resolution used for full-screen displaying (typically, FullHD = 1080 lines), than the resolution used for the final rendering (typically, 4K = 2160 lines).
  • for each high-resolution video input file, a low-resolution copy of it is built to be used when working within 3Denlive. The original high-resolution video input file is used when producing the final rendering.

Processing pipe:

  1. input files in the media collection (JPG, PNG, GIF, SVG, MPG, MOV, MP4, etc). In major cases, a media refers to a file on disk. Some media can be created by 3Denlive without referring to a file (like a color background).
  2. clips in the timeline. Each clip refers to an input media. It resizes this input media to the project ratio (1:1, 4:3, 16:9, etc) at the processing resolution (for example 4K), defines a start time and a duration, and holds a collection of processors to be applied to it (stereo alignment, resizing, positioning, colors filtering, etc). Multiple clips can refer to the same input media, with different start times and durations, possibly applying different processors.
  3. composition of the timeline tracks. Tracks are combined together layer by layer. A track is overwriting/masking the tracks below it.
  4. output file rendering (typically, PNG or MP4). The processed multi-tracks composition is resized to the final rendering resolution (for example FullHD) and sent to the final processor building the output file (typically, PNG or MP4 compressors). If a single picture is produced, only one point of the timeline is processed (typically, the current time cursor position), otherwise the timeline is processed point by point, depending on the required frame rate of the final video (typically, 30 images per second).

Before reading this User Guide

You may have a look at:

  • the Quick Start Guide.
  • the Demo Packs that demonstrate some features, providing with all necessary files you can download to reproduce and study on your own machine.

Table of contents

  1. Basics
    1. Open/save a project
    2. Add a media
    3. Create a clip
    4. Add a processor to a clip
    5. Save a picture
    6. Render a video
  2. Monitor panel
    1. Working configuration
    2. Player control
  3. Timeline panel
    1. Manage timelines
    2. Manage clips in timelines
  4. Properties panel
    1. Media properties
    2. Clip properties
    3. Processor properties
  5. Processor library panel
    1. Stereo
      1. Alignment
      2. Color adaptation
      3. 2D+depthmap->stereo
      4. Stereo+depthmap->stereo
    2. Colors
      1. Hue saturation
      2. Brightness contrast
    3. Image
      1. Lens correction (ffmpeg K1 K2)
    4. Composition
      1. Cropping
      2. Placement
      3. Transparency / transition
      4. Chroma key (green background)
    5. Design
      1. Framing
    6. Expert
      1. Script
  6. 3D-stereo softwares
  7. 3D-stereo discussion groups
  8. Personal experiments
    1. Low-cost stereo camera
  9. General discussions
    1. Mono-lens stereo beam splitter