diff --git a/doc/clips.rst b/doc/clips.rst index 798b6263e..29482efd4 100644 --- a/doc/clips.rst +++ b/doc/clips.rst @@ -22,25 +22,25 @@ Clips ===== -When media files are added to the OpenShot timeline, they are represented by a "clip", visualized as -rounded rectangles. Clips possess various properties, affecting rendering and compositing. These -include position, layer, scale, location, rotation, and alpha, which can be animated for -stunning effects. +In OpenShot, when you add project files (videos, images, and audio) to the timeline, they appear as **clips** +represented by rounded rectangles. These clips come with different properties that influence how they're rendered +and composited. These properties include the clip's :guilabel:`position`, :guilabel:`layer`, :guilabel:`scale`, +:guilabel:`location`, :guilabel:`rotation`, and :guilabel:`alpha`. -View a clip's properties by right-clicking and selecting "Properties" or double-clicking the clip. -Properties appear alphabetically in the dock, with filter options available at the top. -See :ref:`clip_properties_ref`. +You can examine a clip's properties by either right-clicking and selecting :guilabel:`Properties` or by double-clicking the clip. +The properties are listed alphabetically in the Property dock, and you can use the filter options at the top to +find specific properties. See :ref:`clip_properties_ref` for a list of all clip properties. -To adjust a property: +To **make adjustments** to a property: -- Drag the slider for coarse changes. -- Double-click to enter precise values. -- Right/double-click for non-numerical options. +- For **rough** changes, you can drag the slider. +- For **precise** adjustments, double-click the property to enter exact values. +- If the property involves **non-numerical choices**, right-click or double-click for options. -Clip properties are integral to the :ref:`animation_ref` system. When you modify a clip property, a -keyframe is generated at the current playhead position. For a property to span the entire clip, -position the playhead at or before the clip's start before making adjustments. A convenient way to -identify a clip's start is by utilizing the 'next/previous marker' feature on the Timeline toolbar. +Clip properties play a vital role in the :ref:`animation_ref` system. Whenever you modify a clip property, a +``key-frame`` is automatically created at the current playhead position. If you want a property change to apply +throughout the entire clip, ensure the playhead is positioned at or before the clip's start, before making adjustments. +You can easily find a clip's start by using the :guilabel:`next/previous marker` feature on the Timeline toolbar. .. image:: images/clip-overview.jpg @@ -295,12 +295,12 @@ See the table below for a full list of clip properties. Channel Filter Key-Frame A number representing an audio channel to filter (clears all other channels) Channel Mapping Key-Frame A number representing an audio channel to output (only works when filtering a channel) Frame Number Enum The format to display the frame number (if any) - Duration Float The length of the clip (in seconds) + Duration Float The length of the clip (in seconds). Read-only property. This is calculated by: End - Start. End Float The end trimming position of the clip (in seconds) Gravity Enum The gravity of a clip determines where it snaps to its parent (details below) Enable Audio Enum An optional override to determine if this clip has audio (-1=undefined, 0=no, 1=yes) Enable Video Enum An optional override to determine if this clip has video (-1=undefined, 0=no, 1=yes) - ID String A randomly generated GUID (globally unique identifier) assigned to each clip + ID String A randomly generated GUID (globally unique identifier) assigned to each clip. Read-only property. Track Int The layer which holds the clip (higher tracks are rendered on top of lower tracks) Location X Key-Frame Curve representing the relative X position in percent based on the gravity (-1 to 1) Location Y Key-Frame Curve representing the relative Y position in percent based on the gravity (-1 to 1) @@ -357,15 +357,16 @@ The :guilabel:`Frame Number` property specifies the format in which the frame nu Duration """""""" -The :guilabel:`Duration` property is a float value indicating the length of the clip in seconds. +The :guilabel:`Duration` property is a float value indicating the length of the clip in seconds. This is a Read-only property. +This is calculated by: End - Start. To modify duration, you must edit the :guilabel:`Start` and/or :guilabel:`End` clip properties. -- **Usage Example:** Adjusting the duration of a clip to fit a specific time slot in the project. +- **Usage Example:** Inspect the duration of a clip to ensure it fits a specific time slot in the project. - **Tip:** Consider using the "Duration" property for clips that need to match specific time intervals, such as dialogue or scenes. End """ The :guilabel:`End` property defines the trimming point at the end of the clip in seconds, allowing you to control how much -of the clip is visible in the timeline. +of the clip is visible in the timeline. Changing this property will impact the :guilabel:`Duration` clip property. - **Usage Example:** Trimming the end of a clip to align with another clip or trimming off unwanted sections of the clip. - **Tip:** Combine the "Start" and "End" properties to precisely control the visible portion of the clip. @@ -405,7 +406,8 @@ Possible values: -1 (undefined), 0 (no video), 1 (video enabled). ID "" -The :guilabel:`ID` property holds a randomly generated GUID (Globally Unique Identifier) assigned to each clip, ensuring its uniqueness. +The :guilabel:`ID` property holds a randomly generated GUID (Globally Unique Identifier) assigned to each clip, +ensuring its uniqueness. This is a Read-only property, and assigned by OpenShot when a clip is created. - **Usage Example:** Referencing specific clips within custom scripts or automation tasks. - **Tip:** While typically managed behind the scenes, understanding clip IDs can aid in advanced project customization. @@ -521,6 +523,7 @@ angles in degrees, respectively. See :ref:`clip_transform_ref`. Start """"" The :guilabel:`Start` property defines the trimming point at the beginning of the clip in seconds. +Changing this property will impact the :guilabel:`Duration` clip property. - **Usage Example:** Removing the initial portion of a clip to focus on a specific scene or moment. - **Tip:** Utilize the "Start" property in combination with the "End" property for precise clip trimming. diff --git a/doc/effects.rst b/doc/effects.rst index 9c944c336..1d03c9b54 100644 --- a/doc/effects.rst +++ b/doc/effects.rst @@ -24,15 +24,28 @@ Effects Effects are used in OpenShot to enhance or modify the audio or video of a clip. They can modify pixels and audio data, and can generally enhance your video projects. Each effect has its own set of properties, most of which can be animated -over time. +over time, for example varying the :guilabel:`Brightness & Contrast` of a clip over time. Effects can be added to any clip by dragging and dropping them from the Effects tab onto a clip. Each effect is -represented by a small colored icon and the first letter of the effect name. To view an effect's properties, -right-click on the effect icon, revealing the context menu, and choose :guilabel:`Properties`. The property -editor will appear, where you can edit these properties. Note: Pay close attention to where the play-head +represented by a small colored icon and the first letter of the effect name. Note: Pay close attention to where the play-head (i.e. red playback line) is. Key frames are automatically created at the current playback position, to help create animations quickly. +To view an effect's properties, right-click on the effect icon, revealing the context menu, and choose :guilabel:`Properties`. +The property editor will appear, where you can edit these properties. Properties appear alphabetically in the dock, +with filter options available at the top. See :ref:`clip_properties_ref`. + +To adjust a property: + +- Drag the slider for coarse changes. +- Double-click to enter precise values. +- Right/double-click for non-numerical options. + +Effect properties are integral to the :ref:`animation_ref` system. When you modify an effect property, a +keyframe is generated at the current playhead position. For a property to span the entire clip, +position the playhead at or before the clip's start before making adjustments. A convenient way to +identify a clip's start is by utilizing the 'next/previous marker' feature on the Timeline toolbar. + .. image:: images/clip-effects.jpg List of Effects @@ -76,6 +89,82 @@ the name and short description of each effect. Whisperization Transform audio into whispers. ============================= =============== +Effect Properties +----------------- +Below is a list of **common** effect properties, shared by all effects in OpenShot. To view an effect's properties, +right click and choose :guilabel:`Properties`. The property editor will appear, where you can change these properties. Note: Pay +close attention to where the play-head (i.e. red playback line) is. Key frames are automatically created at the current playback +position, to help quickly create animations. + +See the table below for a list of common effect properties. Only the **common properties** that all effects share are listed here. +Each effect also has many **unique properties**, which are specific to each effect, see :ref:`effect_video_effects_ref` for +more information on individual effects and their unique properties. + +.. table:: + :widths: 18 18 70 + + ====================== ========== ============ + Effect Property Name Type Description + ====================== ========== ============ + Duration Float The length of the effect (in seconds). Read-only property. Most effects default to the length of a clip. This property is hidden when an effect belongs to a clip. + End Float The end trimming position of the effect (in seconds). This property is hidden when an effect belongs to a clip. + ID String A randomly generated GUID (globally unique identifier) assigned to each effect. Read-only property. + Parent String The parent object to this effect, which makes many of these keyframe values initialize to the parent value. + Position Float The position of the effect on the timeline (in seconds). This property is hidden when an effect belongs to a clip. + Start Float The start trimming position of the effect (in seconds). This property is hidden when an effect belongs to a clip. + Track Int The layer which holds the effect (higher tracks are rendered on top of lower tracks). This property is hidden when an effect belongs to a clip. + ====================== ========== ============ + +Duration +"""""""" +The :guilabel:`Duration` property is a float value indicating the length of the effect in seconds. This is a Read-only property. +This is calculated by: End - Start. To modify duration, you must edit the :guilabel:`Start` and/or :guilabel:`End` effect properties. + +*NOTE: Most effects in OpenShot default the effect duration to the clip duration, and hide this property from the editor.* + +End +""" +The :guilabel:`End` property defines the trimming point at the end of the effect in seconds, allowing you to control how much +of the effect is visible in the timeline. Changing this property will impact the :guilabel:`Duration` effect property. + +*NOTE: Most effects in OpenShot default this property to match the clip, and hide this property from the editor.* + +ID +"" +The :guilabel:`ID` property holds a randomly generated GUID (Globally Unique Identifier) assigned to each effect, +ensuring its uniqueness. This is a Read-only property, and assigned by OpenShot when an effect is created. + +Track +""""" +The :guilabel:`Track` property is an integer indicating the layer on which the effect is placed. Effects on higher tracks are rendered +above those on lower tracks. + +*NOTE: Most effects in OpenShot default this property to match the clip, and hide this property from the editor.* + +.. _effect_parent_ref: + +Effect Parent +------------- +The :guilabel:`Parent` property of an effect sets the initial keyframe values to a parent effect. For example, if many effects all point to the +same parent effect, they will inherit all their initial properties, such as font size, font color, and background color for a ``Caption`` effect. +In the example of many ``Caption`` effects using the same Parent effect, it is an efficient way to manage a large number of these effects. + +NOTE: The ``parent`` property for effects should be linked to the **same type** of parent effect, otherwise their default initial values +will not match. Also see :ref:`clip_parent_ref`. + +Position +"""""""" +The :guilabel:`Position` property determines the effect's position on the timeline in seconds, with 0.0 indicating the beginning. + +*NOTE: Most effects in OpenShot default this property to match the clip, and hide this property from the editor.* + +Start +""""" +The :guilabel:`Start` property defines the trimming point at the beginning of the effect in seconds. +Changing this property will impact the :guilabel:`Duration` effect property. + +*NOTE: Most effects in OpenShot default this property to match the clip, and hide this property from the editor.* + Sequencing ---------- @@ -88,16 +177,7 @@ If you set the ``Apply Before Clip Keyframes`` property to ``No``, the effect wi and applies keyframes to the image. This can be useful on certain effects, such as the **Mask** effect, when you want to animate a clip first and then apply a static mask to the clip. -.. _effect_parent_ref: - -Effect Parent -------------- -The :guilabel:`Parent` property of an effect sets the initial keyframe values to a parent effect. For example, if many effects all point to the -same parent effect, they will inherit all their initial properties, such as font size, font color, and background color for a ``Caption`` effect. -In the example of many ``Caption`` effects using the same Parent effect, it is an efficient way to manage a large number of these effects. - -NOTE: The ``parent`` property for effects should be linked to the **same type** of parent effect, otherwise their defaut initial values -will not match. Also see :ref:`clip_parent_ref`. +.. _effect_video_effects_ref: Video Effects ------------- @@ -107,7 +187,7 @@ data of a clip. Below is a list of video effects, and their properties. Often it entering different values into the properties, and observing the results. Alpha Mask / Wipe Transition -^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +"""""""""""""""""""""""""""" Uses a grayscale mask image to gradually wipe / transition between 2 images (only affects the image, and not the audio track) .. table:: @@ -124,7 +204,7 @@ Uses a grayscale mask image to gradually wipe / transition between 2 images (onl ========================== ============ Bars -^^^^ +"""" Add colored bars around your video. .. table:: @@ -142,7 +222,7 @@ Add colored bars around your video. ========================== ============ Blur -^^^^ +"""" Adjust the blur of the frame's image. .. table:: @@ -159,7 +239,7 @@ Adjust the blur of the frame's image. ========================== ============ Brightness & Contrast -^^^^^^^^^^^^^^^^^^^^^ +""""""""""""""""""""" Adjust the brightness and contrast of the frame's image. .. table:: @@ -174,7 +254,7 @@ Adjust the brightness and contrast of the frame's image. ========================== ============ Caption -^^^^^^^ +""""""" Add text captions on top of your video. We support both VTT (WebVTT) and SubRip (SRT) subtitle file formats. These formats are used to display captions or subtitles in videos. They allow you to add text-based subtitles to video content, making it more accessible to a wider audience, especially for those who are deaf or hard of hearing. The Caption @@ -215,7 +295,7 @@ text in one place. ========================== ============ Chroma Key (Greenscreen) -^^^^^^^^^^^^^^^^^^^^^^^^ +"""""""""""""""""""""""" Replaces the color (or chroma) of the frame with transparency (i.e. keys out the color). .. table:: @@ -232,7 +312,7 @@ Replaces the color (or chroma) of the frame with transparency (i.e. keys out the ========================== ============ Color Saturation -^^^^^^^^^^^^^^^^ +"""""""""""""""" Adjust the color saturation. .. table:: @@ -249,7 +329,7 @@ Adjust the color saturation. ========================== ============ Color Shift -^^^^^^^^^^^ +""""""""""" Shift the colors of an image up, down, left, and right (with infinite wrapping). **Each pixel has 4 color channels:** @@ -281,7 +361,7 @@ shift of the alpha channel.* .. _effects_crop_ref: Crop -^^^^ +"""" Crop out any part of a video clip. This effect is the primary method for cropping a Clip in OpenShot. The ``left``, ``right``, ``top``, and ``bottom`` key-frames can even be animated, for a moving and resizing cropped area. You can leave the cropped area blank, or you can dynamically resize the cropped area to fill the screen. @@ -303,7 +383,7 @@ blank, or you can dynamically resize the cropped area to fill the screen. ========================== ============ Deinterlace -^^^^^^^^^^^ +""""""""""" Remove interlacing from a video (i.e. even or odd horizontal lines) .. table:: @@ -317,7 +397,7 @@ Remove interlacing from a video (i.e. even or odd horizontal lines) ========================== ============ Hue -^^^ +""" Adjust the hue / color of the frame's image. .. table:: @@ -331,11 +411,11 @@ Adjust the hue / color of the frame's image. ========================== ============ Negative -^^^^^^^^ +"""""""" Negates the colors, producing a negative of the image. Object Detector -^^^^^^^^^^^^^^^ +""""""""""""""" Detect objects through the video. .. table:: @@ -353,7 +433,7 @@ Detect objects through the video. ========================== ============ Pixelate -^^^^^^^^ +"""""""" Pixelate (increase or decrease) the number of visible pixels. .. table:: @@ -371,7 +451,7 @@ Pixelate (increase or decrease) the number of visible pixels. ========================== ============ Shift -^^^^^ +""""" Shift the image up, down, left, and right (with infinite wrapping). .. table:: @@ -386,7 +466,7 @@ Shift the image up, down, left, and right (with infinite wrapping). ========================== ============ Stabilizer -^^^^^^^^^^ +"""""""""" Stabilize video clip to remove undesired shaking and jitter. .. table:: @@ -400,11 +480,11 @@ Stabilize video clip to remove undesired shaking and jitter. ========================== ============ Tracker -^^^^^^^ +""""""" Track the selected bounding box through the video. The tracked object can be selected as a parent on other clips. See :ref:`clip_parent_ref`. Wave -^^^^ +"""" Distort the frame's image into a wave pattern. .. table:: @@ -429,7 +509,7 @@ their properties. Often it is best to experiment with an effect, entering differ and observing the results. Compressor -^^^^^^^^^^ +"""""""""" Reduce the volume of loud sounds or amplify quiet sounds. .. table:: @@ -448,7 +528,7 @@ Reduce the volume of loud sounds or amplify quiet sounds. ========================== ============ Delay -^^^^^ +""""" Adjust the synchronism between the audio and video track. .. table:: @@ -462,7 +542,7 @@ Adjust the synchronism between the audio and video track. ========================== ============ Distortion -^^^^^^^^^^ +"""""""""" Alter the audio by clipping the signal. .. table:: @@ -479,7 +559,7 @@ Alter the audio by clipping the signal. ========================== ============ Echo -^^^^ +"""" Reflection of sound with a delay after the direct sound. .. table:: @@ -495,7 +575,7 @@ Reflection of sound with a delay after the direct sound. ========================== ============ Expander -^^^^^^^^ +"""""""" Louder parts of audio become relatively louder and quieter parts become quieter. .. table:: @@ -514,7 +594,7 @@ Louder parts of audio become relatively louder and quieter parts become quieter. ========================== ============ Noise -^^^^^ +""""" Random signal having equal intensity at different frequencies. .. table:: @@ -528,7 +608,7 @@ Random signal having equal intensity at different frequencies. ========================== ============ Parametric EQ -^^^^^^^^^^^^^ +""""""""""""" Filter that allows you to adjust the volume level of a frequency in the audio track. .. table:: @@ -545,7 +625,7 @@ Filter that allows you to adjust the volume level of a frequency in the audio tr ========================== ============ Robotization -^^^^^^^^^^^^ +"""""""""""" Transform the voice present in an audio track into a robotic voice effect. .. table:: @@ -561,7 +641,7 @@ Transform the voice present in an audio track into a robotic voice effect. ========================== ============ Whisperization -^^^^^^^^^^^^^^ +"""""""""""""" Transform the voice present in an audio track into a whispering voice effect. .. table:: diff --git a/doc/export.rst b/doc/export.rst index 94b737c8c..c495399f5 100644 --- a/doc/export.rst +++ b/doc/export.rst @@ -22,7 +22,8 @@ Export Exporting converts your OpenShot project (clips, effects, animations, titles) into a single video output file (using a process called ``video encoding``). By using the default settings, the exported video will be compatible -with most media players (such as VLC) and websites (such as YouTube, Vimeo, Facebook). +with most media players (such as VLC) and websites (such as YouTube, Vimeo, Facebook) and creates a +``MP4 (h.264 + AAC)`` formatted video file. See :ref:`profiles_mp4_h264_ref`. Click on the :guilabel:`Export Video` icon at the top of the screen (or use the :guilabel:`File→Export Video` menu). The default values will work fine, so just click the :guilabel:`Export Video` button to render your diff --git a/doc/profiles.rst b/doc/profiles.rst index 2b1f06222..8dcd3f8ae 100644 --- a/doc/profiles.rst +++ b/doc/profiles.rst @@ -120,8 +120,9 @@ Once you restart OpenShot, you will see your custom profile appear in the list o Preset List ----------- -OpenShot includes a large list of common profiles and their associated video export settings (``video codec``, -``audio codec``, ``audio channels``, ``audio sample rate``, etc...), which targets specific websites and devices. +OpenShot includes many **export presets**, which combine our list of common profiles and their associated video export settings (``video codec``, +``audio codec``, ``audio channels``, ``audio sample rate``, etc...), which target specific output formats, websites, and devices. The **default +export preset** used by OpenShot is ``MP4 (h.264 + AAC)``, see :ref:`profiles_mp4_h264_ref`. All Formats ^^^^^^^^^^^ @@ -691,9 +692,14 @@ MP4 (h.264 videotoolbox) Profiles | All Profiles ======================= ============ +.. _profiles_mp4_h264_ref: + MP4 (h.264) ~~~~~~~~~~~ +This is the default export preset used by OpenShot. This format is compatible +with most media players (such as VLC) and websites (such as YouTube, Vimeo, Facebook). + .. table:: :widths: 30 30 diff --git a/doc/transitions.rst b/doc/transitions.rst index e9d376a6c..da871e017 100644 --- a/doc/transitions.rst +++ b/doc/transitions.rst @@ -24,7 +24,9 @@ A transition is used to gradually fade (or wipe) between two clip images. In Ope transitions are represented by blue, rounded rectangles on the timeline. They are automatically created when you overlap two clips, and can be added manually by dragging one onto the timeline from the **Transitions** panel. A transition must be placed on top of a clip (overlapping it), with the most common location being the beginning or end -or a clip. NOTE: Transitions do not affect audio, so if you are intending to fade in/out the +or a clip. + +NOTE: Transitions **do not** affect **audio**, so if you are intending to fade in/out the audio volume of a clip, you must adjust the ``volume`` clip property. See :ref:`clip_properties_ref`. Overview @@ -43,14 +45,14 @@ Overview Direction --------- Transitions adjust the alpha/transparency of the overlapping clip image (i.e. the clip under the transition), and can either -fade from opaque to transparent, or transparent to opaque (does not affect the audio). Right click and choose **Reverse Transition** to change the +fade from opaque to transparent, or transparent to opaque (does not affect the audio). Right click and choose :guilabel:`Reverse Transition` to change the direction of the fade. You can also manually adjust the **Brightness** curve, animating the visual fade in any way you wish. .. image:: images/transition-reverse.jpg Cutting & Slicing ----------------- -OpenShot has many easy ways to adjust the start and end positions of a transition (otherwise known as cutting). The most common +OpenShot has many easy ways to adjust the start and end trim positions of a transition (otherwise known as cutting or trimming). The most common method is simply grabbing the left (or right) edge of the transition and dragging. Here is a list of methods for cutting transitions in OpenShot: .. table:: @@ -69,8 +71,18 @@ Keep in mind that all of the above cutting methods also have :ref:`keyboard_shor Mask ---- -Like :ref:`clips_ref`, transitions also have properties which can be animated over time. The fade (or wipe) can be adjusted -with the **Brightness** curve, or held at a constant value to create a transparency mask on top of a clip. +In video editing, masks are powerful tools that allow you to selectively display specific areas of a video clip. +Similar to masking in image editing, video masks define a region where changes will be applied while leaving +other parts of the video unaffected. + +A mask can be thought of as a shape or path that outlines the area you want to target. Commonly used shapes +include rectangles, circles, and freeform paths. The masked area is referred to as the "masked region." + +Masks can be animated, allowing you to change the shape or position over time. This enables dynamic effects like +revealing hidden elements or transitioning between different visual states. In OpenShot, you can convert a +transition to a mask, by customizing the :guilabel:`Brightness` key-frame curve. Keeping a static (unchanging) +value of brightness, will maintain a fixed mask location. Combine this with custom transition images, or even +custom image sequences, to create animated, complex masks. Custom Transition ----------------- @@ -81,19 +93,59 @@ up in the list of transitions. Transition Properties --------------------- Below is a list of transition properties which can be edited, and in most cases, animated over time. To view a transition's properties, -right click and choose **Properties**. The property editor will appear, where you can change these properties. NOTE: Pay +right click and choose :guilabel:`Properties`. The property editor will appear, where you can change these properties. NOTE: Pay close attention to where the play-head (i.e. red playback line) is. Key frames are automatically created at the current playback -position, to help create animations. NOTE: Transitions do not affect audio, so if you are intending to fade in/out the +position, to help create animations. + +NOTE: Transitions do not affect audio, so if you are intending to fade in/out the audio volume of a clip, you must adjust the ``volume`` clip property. See :ref:`clip_properties_ref`. .. table:: - :widths: 20 80 - - ================== ============ - Property Name Description - ================== ============ - Brightness Curve representing the brightness of the transition image, which affects the fade/wipe (-1 to 1) - Contrast Curve representing the contrast of the transition image, which affects the softness/hardness of the fade/wipe (0 to 20) - Replace Image For debugging a problem, this property displays the transition image (instead of becoming a transparency) - ================== ============ - + :widths: 18 18 70 + + ========================== ========== ============ + Transition Property Name Type Description + ========================== ========== ============ + Brightness Key-frame Curve representing the brightness of the transition image, which affects the fade/wipe (-1 to 1) + Contrast Key-frame Curve representing the contrast of the transition image, which affects the softness/hardness of the fade/wipe (0 to 20) + Duration Float The length of the transition (in seconds). Read-only property. + End Float The end trimming position of the transition (in seconds). + ID String A randomly generated GUID (globally unique identifier) assigned to each transition. Read-only property. + Parent String The parent object to this transition, which makes many of these keyframe values initialize to the parent value. + Position Float The position of the transition on the timeline (in seconds). + Replace Image Bool For debugging a problem, this property displays the transition image (instead of becoming a transparency). + Start Float The start trimming position of the transition (in seconds). + Track Int The layer which holds the transition (higher tracks are rendered on top of lower tracks). + ========================== ========== ============ + +Duration +"""""""" +The :guilabel:`Duration` property is a float value indicating the length of the transition in seconds. This is a Read-only property. +This is calculated by: End - Start. To modify duration, you must edit the :guilabel:`Start` and/or :guilabel:`End` transition properties. + +- **Usage Example:** Inspect the duration of a transition to ensure it fits a specific time slot in the project. +- **Tip:** Consider using the "Duration" property for transitions that need to match specific time intervals, such as dialogue or scenes. + +End +""" +The :guilabel:`End` property defines the trimming point at the end of the transition in seconds, allowing you to control how much +of the transition is visible in the timeline. Changing this property will impact the :guilabel:`Duration` transition property. + +- **Usage Example:** Trimming the end of a transition to align with another clip or trimming off unwanted sections of the transition. +- **Tip:** Combine the "Start" and "End" properties to precisely control the visible portion of the transition. + +ID +"" +The :guilabel:`ID` property holds a randomly generated GUID (Globally Unique Identifier) assigned to each transition, +ensuring its uniqueness. This is a Read-only property, and assigned by OpenShot when a transition is created. + +- **Usage Example:** Referencing specific transitions within custom scripts or automation tasks. +- **Tip:** While typically managed behind the scenes, understanding transition IDs can aid in advanced project customization. + +Track +""""" +The :guilabel:`Track` property is an integer indicating the layer on which the transition is placed. Transitions on higher +tracks are rendered above those on lower tracks. + +- **Usage Example:** Arranging transitions in different layers for creating visual depth and complexity. +- **Tip:** Use higher tracks for elements that need to appear above others, like text overlays or graphics.