mrv2
v2 v1.3.0
MRV2 เป็นผู้เล่นมืออาชีพโอเพนซอร์สและเครื่องมือตรวจสอบสำหรับ VFX, ภาพเคลื่อนไหวและกราฟิกคอมพิวเตอร์
สารบัญ:
หากคุณกำลังมองหาไบนารีที่สร้างไว้ล่วงหน้าสำหรับ Windows, Linux หรือ MacOS พวกเขาสามารถพบได้ใน:
คนอื่น ๆ
หรือในไซต์กระจกที่:
แหล่งที่มา
เว็บไซต์ Source Forge ยังเป็นเจ้าภาพสร้างเบต้า (สร้างทุกคืนด้วยการเปลี่ยนแปลงล่าสุด):
SourceForge Betas
MRV2 Binaries ทำงานบน Windows 8.1+, Redhat 8.9+ หรือ Ubuntu 20.04+ และ MacOS 11.0+
บน MacOS คุณติดตั้งโดยเปิดไฟล์. dmg และลากไอคอน MRV2 ไปยังไดเรกทอรีแอปพลิเคชัน หากมีรุ่น MRV2 อยู่แล้วเราขอแนะนำให้คุณเขียนทับ ขณะนี้แอปพลิเคชัน MacOS ไม่ได้รับการรับรองดังนั้นเมื่อคุณเปิดตัวคุณจะไม่สามารถเรียกใช้งานได้เนื่องจาก MacOS จะเตือนคุณว่าไฟล์นั้นไม่ปลอดภัยเนื่องจากดาวน์โหลดจากอินเทอร์เน็ต เพื่อหลีกเลี่ยงสิ่งนั้นคุณต้องเปิดตัวค้นหาให้ไปที่ไดเรกทอรีแอปพลิเคชันและเมาส์ซ้าย CTRL + คลิกที่แอปพลิเคชัน MRV2 นั่นจะทำให้เกิดคำเตือนเดียวกัน แต่คราวนี้จะมีปุ่มที่จะช่วยให้คุณเปิดได้ คุณต้องทำสิ่งนี้เพียงครั้งเดียว
Windows และ Chrome เช่น MacOS ยังปกป้องคุณจากการติดตั้งไฟล์จากอินเทอร์เน็ต เมื่อคุณดาวน์โหลดครั้งแรกด้วย Chrome อาจเตือนคุณว่ามันไม่ใช่การเก็บถาวรตามปกติที่จะดาวน์โหลด ตรวจสอบให้แน่ใจว่าคลิกที่เมนูลูกศรขวาเพื่อบันทึกต่อไป คุณไม่สามารถเปิด. exe จาก Chrome โดยตรง คุณจะต้องเปิด Windows Explorer และไปที่ไดเรกทอรีดาวน์โหลด จากนั้นคุณควรเรียกใช้จากที่นั่น จากนั้น Windows จะปรากฏกล่องสีน้ำเงินที่บอกคุณว่า Windows SmartScreen ป้องกันการเริ่มต้นของการเพิ่มที่ไม่รู้จักและคุณสามารถวางพีซีของคุณให้เสี่ยงได้ คลิกที่ข้อความเพิ่มเติมและปุ่มที่ระบุว่าทำงานต่อไปหรือคล้ายกันควรปรากฏขึ้น คลิกที่มันและทำตามคำแนะนำมาตรฐานไปยังตัวติดตั้ง Windows ใด ๆ
บน Linux เพื่อติดตั้งแพ็คเกจ. RPM หรือ. DEB ต้องการให้ผู้ใช้ของคุณได้รับสิทธิ์ SUDO
บนระบบ Debian (Ubuntu ฯลฯ ) คุณจะติดตั้งด้วย:
sudo dpkg -i mrv2-v1.0.0-Linux-amd64.tar.gz
บน Red Hat (Rocky Linux ฯลฯ ) คุณจะติดตั้งด้วย:
sudo rpm -i mrv2-v1.0.0-Linux-amd64.tar.gz
เมื่อคุณติดตั้งแล้วคุณสามารถเรียกใช้ MRV2 ได้เพียงแค่พิมพ์ MRV2 ในเชลล์เป็น symlink ไปยังการปฏิบัติการจะถูกวางไว้ใน /usr /bin ตัวติดตั้งจะเชื่อมโยงส่วนขยายไฟล์และติดตั้งไอคอนเพื่อให้ง่ายต่อการเริ่มต้นในไอคอนเดสก์ท็อปของผู้ใช้ที่ติดตั้ง สำหรับการเรียกใช้ MRV2 ด้วยไอคอนคุณต้องเลือกและใช้ปุ่มเมาส์ขวาเพื่อเปิดเมนูและเลือกอนุญาตให้เปิดใช้งาน
หากคุณไม่มีสิทธิ์ sudo ในองค์กรของคุณคุณควรดาวน์โหลดไฟล์. tar.gz และคุณสามารถบีบอัดได้ด้วย:
tar -xf mrv2-v1.0.0-Linux-amd64.tar.gz
ที่จะสร้างโฟลเดอร์ในไดเรกทอรีที่คุณไม่สามารถบีบอัดได้ จากนั้นคุณสามารถเรียกใช้ MRV2 ได้โดยใช้สคริปต์เชลล์ mrv2.sh ใน bin/ subdirectory
ซอร์สโค้ดเขียนใน C ++ 20 และใช้ CMAKE สำหรับระบบบิลด์พร้อมสคริปต์ทุบตีสำหรับงานเสริม
แกนกลางของเอ็นจิ้นการเล่นเป็นรุ่นที่กำหนดเองของ tlrender (www.github.com/darbyjohnston/tlrender.git)
รองรับปัจจุบัน:
#
# Repositories
#
sudo dnf -y install dnf-plugins-core
sudo dnf -y install epel-release
sudo dnf config-manager --set-enabled powertools
#
# Update dnf database
#
sudo dnf makecache --refresh
#
# Install bundles
#
sudo dnf -y groupinstall "Development Tools"
sudo dnf -y install perl perl-CPAN
# Install IPC::Cmd non-interactively
sudo cpan App::cpanminus && cpanm --notest IPC::Cmd
#
# Install dependencies
#
sudo dnf -y install git wget curl cmake pango-devel gettext ninja-build
libglvnd-devel alsa-lib-devel pulseaudio-libs-devel
libXScrnSaver-devel dpkg
autoconf wayland-devel wayland-protocols-devel cairo-devel
libxkbcommon-devel dbus-devel mesa-libGLU-devel gtk3-devel
libffi-devel openssl-devel tk-devel tcl-devel libXt-devel
subversion swig
#
# Update apt database
#
sudo apt update
#
# Install dependencies
#
sudo apt -y install curl build-essential perl git cmake ninja-build
libpango1.0-dev
xorg-dev libx11-dev libxcursor-dev libxinerama-dev
libxss-dev gettext libasound2-dev
libpulse-dev libssl-dev libffi-dev
libwayland-dev wayland-protocols libdbus-1-dev
libxkbcommon-dev libegl-dev libgtk-3-dev rpm
doxygen tk-dev libxt-dev swig subversion
# Install cpanminus and IPC::Cmd non-interactively
sudo cpan App::cpanminus && cpanm --notest IPC::Cmd
#
# Install
#
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
#
# Install development tools
#
xcode-select --install
#
# Install dependencies
#
brew install git gnu-sed swig subversion python cmake ninja gettext openssl readline sqlite3 xz zlib
การพึ่งพาเพิ่มเติมจะถูกดาวน์โหลดและสร้างโดยอัตโนมัติโดยสคริปต์ CMake SuperBuild สำหรับรายการห้องสมุดที่ไม่ใช่ระบบที่ MRV2 ขึ้นอยู่กับและใบอนุญาตของพวกเขาโปรดดูที่ SRC/DOCS/กฎหมาย
ข้อกำหนดพิเศษเพียงอย่างเดียวคือการติดตั้ง CMAKE สำเนาใหม่กว่าที่จัดส่งด้วย MSVC19 หากสร้างตัวติดตั้ง NSIS คุณจะต้องวางรูทของ MRV2 ในเส้นทางที่มีอักขระน้อยกว่า 20 ตัวเช่น:
/D/code/applications
โคลนที่เก็บ:
cd some_dir
#
# Clone the latest cutting-edge build (might be unstable).
#
git clone https://github.com/ggarra13/mrv2.git
cd mrv2
./runme.sh
สคริปต์เป็นสคริปต์ที่ยอดเยี่ยมที่จะดาวน์โหลดการพึ่งพาที่จำเป็นทั้งหมดที่จำเป็น มันจะสร้างงานสร้างและ A:
BUILD-KERNEL-ARCH/BUILDTYPE/install
ไดเรกทอรีที่ไฟล์ทั้งหมดจะอยู่
ตรวจสอบให้แน่ใจว่าคุณได้พบกับการพึ่งพาพื้นฐานสำหรับแพลตฟอร์มของคุณ ดูการพึ่งพา
runme.sh sript จะส่งออกความคืบหน้าไปยังเทอร์มินัลและบันทึกไว้ใน:
BUILD-KERNEL-ARCH/BUILDTYPE/compile.log.
ค่าเริ่มต้นคือการสร้างด้วยคอร์ทั้งหมดในระบบปฏิบัติการทั้งหมด ปัจจุบันการสร้างพร้อมการตั้งค่าทั้งหมดใช้เวลาประมาณ 39 นาทีใน 16 คอร์
หากคุณต้องการคอร์มากหรือน้อยส่งผ่านหมายเลขอื่นไปยังสคริปต์ runme*.sh ตัวอย่างเช่นในการสร้างด้วย 4 คอร์คุณสามารถทำได้:
./runme.sh -j 4
ต่อมาหากคุณต้องการสร้าง MRV2 อย่างรวดเร็ว (Runme Quick Mnemonic) โดยไม่ต้องผ่านการอ้างอิงทั้งหมด Run:
./runmeq.sh
ต่อมาเพียงแค่สร้าง fltk, tlrender และ mrv2 (runme สาม mnemonic), วิ่ง;
./runmet.sh
นอกจากนี้ดูใน Bin/ Directory สำหรับสคริปต์ Runme.SH อื่น ๆ ซึ่งรวบรวม MRV2 รุ่นที่เร็วกว่าโดยไม่มีคุณสมบัติเช่น USD, Python หรือเครือข่าย
สคริปต์ runme.sh ทั้งหมดรองรับพารามิเตอร์เพิ่มเติมสองพารามิเตอร์ สำหรับการดีบักคุณจะทำ:
./runme.sh debug
ในการทำความสะอาดไดเรกทอรีให้เรียกใช้การดีบักบิลด์ด้วย 8 คอร์รัน:
./runme.sh clean debug -j 8
สำหรับ Windows นอกเหนือจาก Visual Studio คุณจะต้องมีสำเนา MSYS ใหม่และสดใหม่ มีไฟล์. bat ที่รวมอยู่ในการแจกแจง (ในผู้ช่วย/windows/bat) ซึ่งจำเป็นต้องได้รับการแก้ไขไปยังเส้นทางของ Visual Studio (2019 โดยค่าเริ่มต้น), Windows SDK เสริม (ไม่มีโดยค่าเริ่มต้น) และสำเนา MSYS ของคุณ คุณเรียกใช้ไฟล์. bat ก่อนซึ่งจะตั้งค่าเส้นทาง Visual Studio และยิงคอนโซล MSYS จากนั้นเป็นต้นมาคำสั่งทั้งหมดที่อธิบายจะทำงานในคอนโซล MSYS
ตอนนี้ FFMPEG และ LIBLCMS2 ถูกรวบรวมเป็นส่วนหนึ่งของการสร้าง CMAKE ก่อนการบิน Libssh และ Libcrypto นำมาจากที่เก็บ MSYS64 เมื่อสร้าง FFMPEG เช่นเดียวกับ Swig และการโค่นล้ม
ไลบรารี libintl และ libiconv นำมาจากที่เก็บ MSYS64 เพื่อตรวจสอบก่อนการบินด้วยสคริปต์ bin/install_libintl_window.sh (ส่วนหนึ่งของ runme.sh)
สคริปต์ Runme.sh หลักรองรับการส่งธง CMake ไปยังมันและอนุญาตให้เปิดหรือปิด MRV2 ตัวเลือกบางอย่าง คุณต้องผ่านพวกเขาเช่น:
-d tlrender_usd = ปิด
ธงจะแสดงรายการเมื่อคุณเริ่มต้นสคริปต์ runme.sh หากคุณต้องการเปลี่ยนแปลงการตั้งค่าสถานะถาวรคุณควรเปลี่ยนใน runme_nolog.sh หรือสร้างสคริปต์ wrapper ที่เรียกว่า runme.sh
หากคุณผ่าน -gpl หรือ -lpgl ไปยังสคริปต์ runme.sh เช่น:
./runme.sh -gpl
ระบบสร้างจะรวบรวม FFMPEG เป็น GPL หรือ LGPL ในทุกแพลตฟอร์ม ค่าเริ่มต้นคือการสร้าง FFMPEG เวอร์ชัน LGPL ตามที่สอดคล้องกับใบอนุญาตการกระจายไบนารี BSD อย่างไรก็ตามเวอร์ชัน LGPL ของ FFMPEG ไม่ได้มาพร้อมกับ LIBX264 ซึ่งหมายความว่าคุณไม่สามารถบันทึกไฟล์ภาพยนตร์ด้วยตัวแปลงสัญญาณ H264 บน Windows และ Linux นอกจากนี้ยังไม่รองรับไฟล์ GoPro Cineform ด้วย Alpha
FFMPEG เวอร์ชัน GPL ไม่มีข้อ จำกัด นั้นและจะรวบรวม LIBX264 ในทุกแพลตฟอร์มและทำงาน GoPro Cineform ด้วย Alpha
หากคุณมีไดเรกทอรีถังขยะในบ้าน $ ของคุณ (เช่น ~/bin) สคริปต์บิลด์จะสร้าง symlink ที่นั่น ดังนั้นคุณควรเพิ่ม ~/bin ลงในเส้นทางของคุณใน. bashrc หรือ. zshrc
สมมติว่าคุณปฏิบัติตาม MRV2 ด้วยไดเรกทอรี ~/bin ที่สร้างขึ้นแล้วเพื่อเริ่ม MRV2 จากนั้นคุณจะทำ:
export PATH=~/bin:$PATH # no need if you add this line to your .bashrc
mrv2
และเพื่อเรียกใช้การดีบักบิลด์
export PATH=~/bin:$PATH # no need if you add this line to your .bashrc
mrv2-dbg
หากคุณรวบรวม mrv2 โดยไม่มีไดเรกทอรี bin ในไดเรกทอรีบ้านของคุณคุณสามารถเริ่มต้นได้จากไดเรกทอรี build ด้วยสคริปต์ mrv2.sh เช่น:
BUILD-Linux-amd64/Release/install/bin/mrv2.sh
หมายเหตุการกระจายไบนารี Linux ของ MRV2 อาจพบกับความไม่ลงรอยกันของ Wayland ที่มีความไม่ลงรอยกันที่ทันสมัยเช่น Ubuntu 22.04.4 LTS ซึ่งนำไปสู่การเตือนที่ไม่เป็นอันตราย
บน Windows เราไม่สามารถสร้างลิงค์สัญลักษณ์ดังนั้นใน MSYS คุณต้องพิมพ์เส้นทางทั้งหมดไปยังการติดตั้ง นั่นคือตัวอย่างเช่น:
BUILD-Msys-amd64/Release/install/bin/mrv2.exe
หากคุณต้องการทำงานบรรทัดคำสั่งคุณควรเพิ่มเส้นทางทั้งหมดไปยัง MRV2.exe ไปยังเส้นทางของคุณ ใน MSYS คุณสามารถเพิ่มลงใน. bashrc เช่นเดียวกับที่แสดงบน macOS และ linux
สำหรับ cmd.exe หรือ PowerShell บนแถบงาน Windows คลิกขวาที่ไอคอน Windows และเลือกระบบ ในหน้าต่างการตั้งค่าภายใต้การตั้งค่าที่เกี่ยวข้องคลิกการตั้งค่าระบบขั้นสูง บนแท็บขั้นสูงให้คลิกตัวแปรสภาพแวดล้อม ค้นหาตัวแปรสภาพแวดล้อมพา ธ และเพิ่มเส้นทางเต็มรูปแบบไปยัง mrv2.exe
สำหรับการทำงานกับ GUI หลังจากสร้างเสร็จแล้วคุณควรทำ:
cd BUILD-Msys-amd64/Release/install/bin/ # or similar
explorer .
และในไดเรกทอรี Explorer ที่จะเปิดคุณควรสร้างทางลัดด้วย RMB ไปยัง MRV2.exe เมื่อเสร็จแล้วคุณสามารถลากและเปลี่ยนชื่อทางลัดไปยังเดสก์ท็อปของคุณเพื่อให้มีประโยชน์ โปรดทราบว่าหากคุณจะไม่พัฒนา MRV2 คุณควรดำเนินการบรรจุภัณฑ์แทน
นอกจากเอกสาร API พื้นฐานแล้วยังมีช่องทางพิเศษใน YouTube.com ซึ่งคุณสามารถหาบทเรียนเกี่ยวกับการใช้งานขั้นพื้นฐาน:
บทช่วยสอนวิดีโอ
ปัจจุบันเอกสารถูกสร้างขึ้นโดยอัตโนมัติจากการแปล ในการทำเช่นนั้นคุณต้องเรียกใช้:
./runmeq.sh -t doc
MRV2 สามารถรองรับการแปลภาษาธรรมชาติหลายภาษา ปัจจุบันมีการสนับสนุนภาษาจีน, อังกฤษ, ฝรั่งเศส, เยอรมัน, ภาษาฮินดี, อิตาลี, โปรตุเกส, รัสเซียและสเปน ระบบการแปลที่ใช้คือ gettext ดังนั้นความคุ้นเคยกับมันเป็นที่ต้องการ (แม้ว่าจะไม่จำเป็น) การแปลอยู่ใน SRC/PO และติดตามไฟล์รหัสภาษาสากลเช่น es.po (สำหรับภาษาสเปน) หรือ de.po (สำหรับภาษาเยอรมัน)
ก่อนอื่นคุณควรสร้างสาขาเพื่อส่งคำขอดึง
มีเอกสาร GitHub เช่น https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request
สั้น:
หากต้องการสร้างไฟล์ดังกล่าวสำหรับภาษาใหม่ให้เปิดไฟล์ cmake/translations.cmake และเพิ่มรหัสภาษาระหว่างประเทศในบรรทัดนี้:
set( LANGUAGES es ) # add a new language code inside the parenthesis, like "de".
จากนั้นเรียกใช้:
./runmeq.sh -t po
หากยังไม่มีไฟล์. po สำหรับภาษานั้นคำสั่ง msginit ของ getText จะเรียกใช้สำหรับคุณ คุณอาจถูกถามถึงที่อยู่อีเมลของคุณซึ่งเป็นส่วนหนึ่งของกระบวนการ
ไปที่ mrv2/po/{lang} .po ที่ lang คือภาษาที่คุณเพิ่ม
และแก้ไขข้อความ ตรวจสอบให้แน่ใจว่าได้เปลี่ยน charset เป็น UTF-8
โปรดทราบว่าคุณควรใช้ตัวแก้ไขที่สามารถเขียนใน Unicode (UTF-8) เพื่อเขียนภาษาที่ไม่สามารถติดต่อได้
คุณต้องแก้ไขสตริง "msgstr" และปล่อยให้ "msgid" ไม่มีการแตะต้องเป็นข้อมูลอ้างอิง หากความคิดเห็นมีสตริง "ฟัซซี่" หมายถึง getText พยายามเดาการแปล แต่มันจะไม่ใช้มัน ลบรอบคัดเลือกฟัซซี่และเปลี่ยนสตริง "msgstr" โปรดทราบว่าหาก "msgid" มีสายใหม่คุณต้องจับคู่พวกเขาด้วย อ้างถึงคู่มือ GetText สำหรับข้อมูลเพิ่มเติม
เมื่อคุณพร้อมที่จะทดสอบการแปลของคุณแล้วให้เรียกใช้:
./runmeq.sh -t mo
ที่จะสร้างไฟล์. mo สำหรับภาษาของคุณ
ในการทดสอบการแปลคุณสามารถเรียกใช้:
./runmeq.sh -t install
หรือเพียงแค่:
./runmeq.sh
และนั่นจะวางไฟล์. mo ไว้ใน: $ build- $ os- $ arch/$ build_type/stall/share/locale directory
หากคุณเพิ่มหรือลบสตริงเป็นส่วนหนึ่งของการเปลี่ยนแปลงรหัสของคุณคุณอาจต้องการสร้างไฟล์. pot ใหม่หลังจากผ่านไประยะหนึ่งก่อนโทร -t mo ที่จะทำเช่นนั้น:
./runmeq.sh -t pot
โปรดทราบว่าการเปลี่ยนแปลงนี้เป็นเรื่องที่น่าทึ่งเนื่องจากการเปลี่ยนแปลงรหัสของคุณจะได้รับการจัดการกับความคิดเห็น. pot/.po ทั้งหมดเพื่อป้องกันการ PR ที่สะอาด (คำขอดึง) บน gitHub.com
มีสคริปต์ AI ที่ใช้ไลบรารี Python Transformers สำหรับการแปล AI ใน:
bin/po/po_translate.sh
มันใช้งานได้โดยการส่งภาษาให้กับมันเช่น:
bin/po/po_translate.sh all # for all languages supported by the script.
bin/po/po_translate.sh zh-CN # for Chinese Simplified
สร้างคำขอดึงบน GitHub:
จากนั้นสร้างไฟล์. po ใหม่สำหรับการแปลหลักของคุณ ตัวอย่างเช่น:
cp mrv2/po/en.po mrv2/po/it.po # For Italian
จากนั้นเพิ่มไฟล์สำหรับภาษาใหม่เปิดไฟล์ cmake/translations.cmake และเพิ่มรหัสนานาชาติภาษาในบรรทัดนี้:
set( LANGUAGES en es it ) # add a new language code inside the parenthesis, like "it".
แปลไฟล์. po ใหม่ด้วยตนเองแล้วทำ:
git add mrv2/po/it.po
git commit
git push
ส่ง GitHub PR ด้วยไฟล์ใหม่นั้น นักพัฒนา MRV2 จะพยายามรวมการเปลี่ยนแปลงของคุณในภายหลัง
บน Windows นอกเหนือจากข้อความของ MRV2 คุณต้องแปลข้อความสำหรับตัวติดตั้ง NSIS .EXE
คุณสามารถทำได้โดยการแก้ไขไฟล์ cmake/nsis/mrv2_translations.nsh เพียงทำตามตัวอย่างในไฟล์นั้น
เมื่อคุณสร้าง MRV2 และทดสอบว่ามันทำงานแล้วคุณอาจต้องการสร้างแพ็คเกจสำหรับการแจกจ่าย บน MacOS นี่คือไฟล์. dmg บน Linux มันเป็นไฟล์ RPM, DEB หรือ TGZ บน Windows มันเป็นตัวติดตั้ง ZIP หรือ NSIS EXE
ในการทำเช่นนั้นจาก DIR หลักของ MRV2 คุณต้องทำ:
./runmeq.sh -t package
สำหรับสถาปัตยกรรมทั้งหมดตัวติดตั้งจะถูกเก็บไว้ใน:
packages/
นั่นคือไดเรกทอรีรากของ MRV2
หากคุณต้องการเป็นนักพัฒนาก่อนที่จะทำความคุ้นเคยกับกระบวนการสร้าง จากนั้นโคลนพื้นที่เก็บข้อมูลไปยังบัญชี GitHub ของคุณและส่ง PRS หากคุณเป็นนักพัฒนาตัวยงคุณสามารถขอการเข้าถึงที่เก็บหลัก
อีกสิ่งหนึ่งที่คุณจะต้องทำในการทำที่เก็บคือ:
clang-format
นี่เป็นส่วนหนึ่งของโครงการ LLVM คุณสามารถดาวน์โหลดได้จากที่เก็บปกติของคุณ (APT, Brew, ฯลฯ ) หรือจาก:
หน้าดาวน์โหลดหลักของ LLVM
ยูทิลิตี้นี้ตรวจสอบก่อนหน้านี้ว่าการจัดรูปแบบ C ++ ทั้งหมดเป็นไปตามมาตรฐานที่ใช้ใน MRV2
คุณอาจต้องการรับ Doxygen เพื่อรับเอกสารซอร์สโค้ดในเอกสาร/doxygen
