Skip to content

OpenRend v0.2.0 — Advanced Editing, Compositing & Audio Suite

Choose a tag to compare

View all tags
@jamiejustcodes jamiejustcodes released this 05 Nov 11:05
· 13 commits to main since this release
v0.2.0
d0a8765

OpenRend Release Notes — v0.2.0

Release Tag: v0.2.0
Windows Setup Installer: dist/OpenRend-Setup-v0.2.0.exe (and dist/OpenRend-Setup.exe)
Bundle Archive: dist/OpenRend-win-x64.zip
Standalone Executable: dist/OpenRend/OpenRend.exe
Target Platform: Windows x64 (.NET 10 WPF + Native C++20 Direct3D 11 / FFmpeg Engine)
SHA256 Checksums:

  • 2BAEC436D389525DB8297312023DEB2FC6595BBCDDE155BFE47BEF0D9F1972D2 *OpenRend-Setup-v0.2.0.exe
  • 4D4BCEB3C0BAD02C0390F234F1AE43E5DA58AA2F4F9BA207FD03050557CD1CDA *OpenRend-win-x64.zip
    Automated Verification: 100% Native Tests Passed (1/1 in 2.23s), 1,108 Managed Tests Passed (0 failed, 0 warnings, 0 errors)

🌟 Executive Summary

OpenRend v0.2.0 brings major enhancements to timeline editing, video compositing, and audio processing. This update introduces non-destructive Video Adjustment Tracks and Events, a comprehensive Clipboard Paste Suite (Paste Repeat, Paste Insert, and Selective Attribute Transfer), Track Motion 3D Source Alpha with perspective keyframing, Collapsible Contiguous Track Groups with hierarchical mute/solo cascading, 5 Professional Audio Pan Laws, Timeline Event Snap Offsets, Event Healing, Timeline Gap Closure, and Missing Stream Reconstruction.

All timeline edit decisions remain integer project frames with rational rates, preserving source media untouched while ensuring deterministic evaluation across the Direct3D 11 preview and master export pipelines.

📋 Comprehensive Change Log

1. Timeline Editing Suite: Event Heal, Close Gaps, and Missing Stream Reconstruction

  • Event Heal (Edit > Event Heal / Event Context Menu):
    • Consolidates contiguous split slices originating from the same media asset or adjustment layer back into a single unified event.
    • Automatically reconciles internal cut boundaries: removes split-generated fades, preserves original start FadeIn and end FadeOut, continuously stitches envelope automation curves (shifting right-hand points by leftOrigDuration), merges Pan/Crop and Bézier mask keyframes, and shifts transcript words.
    • Iteratively heals multi-slice chains ($A + B + C \to A$) in chronological order.
    • Heals companion grouped audio/video slices across tracks synchronously.
  • Close Gaps (Edit > Close Gaps / Event Context Menu):
    • Eliminates empty timeline gaps between adjacent events with full atomic undo/redo.
    • Multi-Event Selection Mode: Iterates through selected events on each track in ascending timeline order, shifting downstream events leftward to touch preceding event ends.
    • Single-Track Mode: When no events are selected, closes all gaps sequentially on the active/targeted track.
    • Propagates shifts to linked grouped companion clips on complementary tracks to preserve audio/video sync.
  • Add Missing Stream (Insert > Add Missing Stream for Selected Event / Event Context Menu):
    • Inspects source media asset streams for selected timeline events.
    • If a video event is missing audio, finds or inserts an audio track below and instantiates a paired audio clip matching exact source in/out and timeline ranges.
    • If an audio event is missing video, finds or inserts a video track above and instantiates a paired video clip matching exact source in/out and timeline ranges.
    • Automatically links both clips into a shared group (GroupId).

2. Advanced Clipboard Paste Suite & Selective Attribute Transfer

  • Paste Repeat (Edit > Paste Repeat... / Ctrl+B):
    • Modal dialog with repeat count spinner (1–999) and spacing mode selection:
      • End to end: Pastes $N$ copies back-to-back without gap.
      • Even spacing: Pastes $N$ copies spaced at custom intervals input via project timecode.
  • Paste Insert (Edit > Paste Insert / Ctrl+Shift+V):
    • Pastes clipboard events at the edit cursor while automatically rippling all downstream material on the target track(s) later in time by the pasted duration.
  • Paste Event Attributes (Ctrl+Shift+B) & Selective Paste (Edit > Selectively Paste Event Attributes...):
    • Granular attribute transfer dialog with modular selection:
      • Video Attributes: Video Event FX, Event Pan/Crop (including Mask), Switches (Mute, Lock, Loop, Rate, Aspect, Interlace), Opacity & Fade Curves.
      • Audio Attributes: Audio Event FX, Volume & Pan, Pitch, Invert Phase, Normalize & Channels, Switches, Fade Curves.
      • Options: "Replace existing FX on destination events (uncheck to append)".
    • Added clip-level audio FX chain processing (AudioEffects) to TimelineClip and integrated with TimelineRenderService.RenderAudio for identical DSP evaluation.
  • Track Keyboard Shortcuts:
    • Insert > Video Track: Ctrl+Shift+Q.
    • Insert > Audio Track: Ctrl+Q.
    • Edit > Paste Repeat...: Ctrl+B.
    • Edit > Paste Insert: Ctrl+Shift+V.
    • Edit > Paste Event Attributes: Ctrl+Shift+B.

3. Video Adjustment Tracks and Adjustment Events Suite

  • Core Data Models & Validation:
    • Extended TimelineClip with IsAdjustmentEvent, FrameWidth, FrameHeight, PixelAspectRatio, and UseAlternateAdjustmentEventBehavior.
    • Added schema validation ensuring adjustment events only exist on video tracks, have non-negative dimensions, and maintain finite positive pixel aspect ratios.
  • Compositing & DSP Pipeline (TimelineRenderService.cs):
    • When rendering an adjustment layer, dynamically captures the accumulated lower-track composite frame buffer as source.
    • Resamples bilinearly to adjustment event dimensions, applies clip video effects chain (Invert, Color Grading, Blur, LUTs, etc.), evaluates Bézier masks and Pan/Crop transforms, and alpha-blends down onto the output buffer.
  • UI & Menus:
    • In TimelineView.cs: Rendered adjustment events in dedicated purple styling (#3E244B, header #5D2F6E, border #AB47BC) with [ADJ] tag.
    • Added Insert > Adjustment track and Insert > Adjustment event.
    • Added Edit > Resize selected Adjustment Events to Project and Edit > Resize all Adjustment Events to Project.
    • Added event context menu item Resize Adjustment Event to Project.

4. Track Motion 3D Source Alpha & Perspective Keyframing

  • 3D Camera & Homography Engine:
    • Extended TrackCompositeMode with SourceAlpha3D = 3.
    • Extended TrackMotionKeyframe with 3D parameters: Depth, RotationOffsetX, RotationOffsetY, RotationOffsetZ, and spherical/linear Lerp interpolation.
    • Implemented CompositeTransformedPerspective performing camera perspective projection (53.13° FOV camera focal length $f = \max(W, H) \cdot 1.25$, corner scaling $scale = f / (f + Z_{3D})$) with 3x3 projective homography matrix inversion for exact subpixel bilinear sampling.
    • Integrated across preview playback and final video export.

5. Track Groups Architecture & Collapsible Layout

  • Data Models & Contiguity Invariant:
    • Created TrackGroup.cs in OpenRend.Core: Id, Name, ColorHex, IsCollapsed, IsMuted, IsSolo, TrackIds.
    • Implemented contiguity validation enforcing organized track clustering.
  • UI Bracket Visualization (TimelineView.cs):
    • Collapsed groups fold member tracks to height 0 and render a 26px compact group header bar with expand chevron (▶), group name, track count, Mute (M), and Solo (S) toggle buttons.
    • Expanded groups render a colored vertical grouping bracket down the left edge of track headers with top (┌) and bottom (└) ticks, alongside collapse chevron (▼), group Mute, and Solo buttons.
    • Added track header context menu actions: Group Selected Tracks (Ctrl+Shift+G), Ungroup Tracks, Remove from Track Group, Toggle Group Collapse, Group Mute, Group Solo, and Rename Group....
  • Cascaded DSP Evaluation:
    • Group mute and solo states cascade hierarchically across audio and video member tracks for identical preview and master export evaluation.
    • Edit Details window integration: Added Track Groups view mode with TSV clipboard export.

6. Audio Pan Laws & Timeline Event Snap Offset Suite

  • 5 Professional Audio Pan Laws:
    • Linear (-6 dB): standard linear attenuation $L = 1 - p$, $R = p$.
    • ConstantPower0dB: equal loudness curve maintaining unity gain at center $L = \cos(\theta)$, $R = \sin(\theta)$ with 0 dB center.
    • ConstantPower3dB: 3 dB attenuation at center.
    • ConstantPowerMinus3dB: -3 dB attenuation at center ($L = \cos(\frac{\pi(p + 1)}{4})$, $R = \sin(\frac{\pi(p + 1)}{4})$).
    • SquareRootMinus3dB: square-root power curve.
    • Integrated in AudioDspService.cs and track header context menus.
  • Timeline Event Snap Offset (TimelineClip.SnapOffsetFrames):
    • Interactive triangular snap pin glyph at the bottom edge of timeline events.
    • Draggable snap handle snapping event position to cursor, cut boundaries, and markers.
    • Context menu items: Set Snap Offset to Cursor and Reset Snap Offset.

7. Timeline Regions, Audio Channels Remapping, & Pitch Shifting

  • Timeline Regions:
    • Dedicated TimelineRegion model with start frame, duration, numbered green flags (01, 02), and name labels.
    • Interactive resizing handles on ruler flags and context menu editing.
    • Shortcut R / Insert > Region.
  • Audio Channel Remapping:
    • Event channel routing modes: Both (Stereo), Left Only, Right Only, and Swap (L<->R).
    • Evaluated in realtime during audio preview and export channel downmixing.
  • Event Pitch Shifting:
    • Precise semitone modulation (-12 to +12 semitones, octaves) applied per event.
    • Keyboard shortcuts: + (+1 semitone), - (-1 semitone), 0 (reset pitch).

8. UI & Responsive Interaction Polishing

  • Track header slider layout adapts responsively to prevent overlapping controls.
  • Timeline file drag-and-drop hover indicators with ghost clip placement preview.
  • Viewport and preview player sizing constraints optimized for flexible workspace docking.
  • Vector icons and theme styling unified across dark UI palette.

🧪 Verification & Quality Gate

================================================================================
Test Suite Results:
--------------------------------------------------------------------------------
1. Native Direct3D 11 / C++20 Integration:  1/1 Passed (100%) - 2.23s
2. OpenRend.Core.Tests:                     413/413 Passed (100%)
3. OpenRend.Editor.Tests:                   376/376 Passed (100%)
4. OpenRend.Media.Tests:                    308/308 Passed (100%)
5. OpenRend.Playback.Tests:                 2/2 Passed (100%)
--------------------------------------------------------------------------------
TOTAL: 1,099 Managed Tests Passed | 0 Failed | 0 Errors | 0 Warnings
================================================================================

📦 Distribution Artifacts

  • Windows Setup Installer: dist/OpenRend-Setup-v0.2.0.exe (and stable generic link dist/OpenRend-Setup.exe)
    • Lightweight single-binary setup (~95.7 MB) compiled via Inno Setup 6 with ultra LZMA2 solid compression.
    • Generates Desktop shortcut (OpenRend.lnk) with high-resolution vector application icon and Start Menu entry.
    • Registers .openrend project file associations and Windows App Paths.
    • Non-elevated per-user installation (%LOCALAPPDATA%\Programs\OpenRend) without requiring UAC admin rights.
    • Full uninstaller support (unins000.exe) integrated into Windows Settings > Installed Apps.
  • Standalone Directory: dist/OpenRend/
    • OpenRend.exe: Primary WPF / .NET 10 application launcher
    • OpenRend.Native.dll: C++20 / Direct3D 11 timeline rendering and compositing engine
    • ffmpeg.exe & ffprobe.exe: Hardware-accelerated media decoders/encoders
    • Complete third-party licenses and attribution notices
  • Zip Archive: dist/OpenRend-win-x64.zip
  • Checksum Manifest: dist/SHA256SUMS.txt
    • 2BAEC436D389525DB8297312023DEB2FC6595BBCDDE155BFE47BEF0D9F1972D2 *OpenRend-Setup-v0.2.0.exe
    • 2BAEC436D389525DB8297312023DEB2FC6595BBCDDE155BFE47BEF0D9F1972D2 *OpenRend-Setup.exe
    • 4D4BCEB3C0BAD02C0390F234F1AE43E5DA58AA2F4F9BA207FD03050557CD1CDA *OpenRend-win-x64.zip
Assets 6
Loading