Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen Revision Vorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
en:vegas_python [2018/10/27 13:23]
hlinke [Download and Installation]
en:vegas_python [2019/07/28 10:31]
hlinke [Introduction]
Zeile 3: Zeile 3:
 ===== Introduction ===== ===== Introduction =====
  
-VEGAS Pro allows the control of the application via scripting. Scripting provides access to the internal data structures in VEGAS projects that allows you to automate things that you might normally do via the GUI. +VEGAS Pro allows the control of the application via scripting. 
-VEGAS uses the .NET framework to provide its scripting interface. VEGAS can execute C#, JScript, and Visual Basic script files directly.+PYTHON is an easy to learn powerful programming language that is more and more used for scripting of applicationsIn the 3D and video editing area some application use already PYTHON for scripting.
  
-Although JScript, Visual Basic, and C# can be easy to learn, it certainly helps to have programming experience before you try to write a VEGAS script. +Goal of this VEGAS extension is to provide PYTHON scripting to VEGAS allowing to provide new features to the VEGAS users based on Python solutions.
- +
-PYTHON is an easy to learn powerful programming language that is more an dmore used for scripting of applications. In the 3D and video editing area some application use already PYTHON for scripting. +
- +
-Goal of this VEGAS extension is to provide an easy access to VEGAS scripting using PYTHON.+
  
 The extension provides two options: The extension provides two options:
-  * an interactive dockable VEGASPython Window +  * for users 
-  * executing Scripts located in a specific folder and integrate them into the VEGAS User Interface like other C# Scripts +    * new features like VEGASScenedetect 
- +  * for developers 
-{{:en:vegaspython01.jpg?direct&400|}}+    * an interactive dockable VEGASPython Window 
 +    * executing Scripts located in a specific folder and integrate them into the VEGAS User Interface like other C# Scripts 
 +{{:en:vegaspython01a.jpg?direct|}}
  
 ===== Download and Installation ===== ===== Download and Installation =====
 [[en:vegas_python_download|Download and Installation Page]] [[en:vegas_python_download|Download and Installation Page]]
  
-===== Usage ===== +====== VEGASPYTHON for Users ====== 
-[[en:vegas_python_usage|Usage description Page]] +Please find details for users on the following page
- +[[en:vegas_python_users|VEGASPython for Users]]
- +
- +
- +
-===== Usage ===== +
-The VEGASPython extension can be used in two ways: +
- +
-  * the interactive VEGASPython window +
-  * VEGASPython scripts in the folder VEGASPython +
- +
-==== Interactive VEGASPython window ==== +
- +
-To allow a very fast and easy Python script creation and execution the extension provides an interactive VEGASPython window. +
- +
-You open the window in VEGAS via "View - Extensions - VEGASPython Interactive Window" +
- +
-{{:en:vegaspython02a.jpg?direct&400|}} +
- +
-This opens the interactive VEGASPython Window: +
- +
-{{:en:vegaspython03.jpg?direct&400|}} +
- +
-The interactive VEGASPython Window consists of two textboxes. +
-The upper textbox is the Input textbox, where you can enter Python commands and scripts. The lower part is the Output textbox that shows the shows the results of the Python Command execution. +
- +
-After the first start of the window the output shows that the script init.py has been executed. +
-This script is located in the same folder as the VEGASPython.dll and includes some inital Python commands that make your life easier. +
-Please feel free to add additional commands or function declarations that you would like to have at hand during your work. +
- +
- +
-The VEGASPython window can float over the VEGAS UI or can be docked into the user interface like all other VEGAS windows. +
-=== Working With the Interactive VEGASPython Window === +
- +
-== Hello World == +
-The standard "Hello World" script is in Python very easy: +
- +
-Enter:  +
-<code python> +
-print("Hello World"+
-</code> +
- +
-in the Input textbox and click on "Execute VEGASPython Script" in the Menu. +
- +
-The result is as follows: +
-{{:en:vegaspython08a.jpg?direct&400|}} +
- +
-The text "Hello World" is printed into the Output textbox. +
-If you did something wrong then you will see an error message in the Output textbox. +
- +
-Please try other texts for printing. +
-You will see that with every click on "Execute VEGASPythonScript" the Output textbox is cleared and the new text is shown in the textbox. +
- +
-== Access to VEGAS == +
-For acessing and controlling VEGAS and VEGAS projects and data structures VEGASPython has a predefined variable +
- +
-"pyVEGAS" +
- +
-Starting from this variable you can access all VEGAS information. +
- +
-Please try following: +
- +
-<code python> +
-print(pyVEGAS.Version) +
-</code> +
- +
-This command prints the current version of VEGAS into the Output textbox: Version 16.0 (Build 261). +
- +
-{{:en:vegaspython11a.jpg?direct&400|}} +
- +
-Now try the following script: +
- +
-<code python> +
-for track in pyVEGAS.Project.Tracks: +
-    print("Track Length:",track.Length.ToString()) +
-</code> +
- +
-Please enter it exactly as it is written here. Important are the 4 blanks in front of the print statement. +
-This script loops over all tracks existing in the current VEGAS project and prints the length of each track. +
- +
-After clicking the "Execute" Menu item the output textbox will show the length of all tracks you have in the current project. +
-If there is no track in the current project, the output textbox remains empty!! +
- +
-More examples for scripts are shown in the examples chapter below. +
- +
-== Loading and Saving Scripts == +
-Via the "File" Menu you can load and save scripts. +
- +
- +
- +
- +
-==== VEGASPython Scripts ==== +
-To allow an easier access to Python Scripts VEGASPython scans the subfolder "VEGASPython". This subfolder must be in the same directory as the VEGASPython.dll. +
- +
-{{:en:vegaspython13a.jpg?direct&400|}} +
- +
-The scripts in this folder are accessible via "Tools - Extensions" from the VEGAS Menu. +
- +
-{{:en:vegaspython05a.jpg?direct&400|}} +
- +
-When selecting the Menu-Item in this menu that selected Python Script will be executed immediatly. +
-All output of the script is readirected to the "Output textbox of the Interactive VEGASPython Window". If the window is not open it opens automatically when the script starts.  +
- +
-=== New Features in Version 2.0 for Scripts === +
-  * [[Debugging of Scripts with Visual Studio 2017|Debugging of Scripts with Visual Studio 2017]] +
-  * [[Script hierarchy|Script hierarchy]] +
-  * [[Script help|Script help]] +
-==== Restrictions ==== +
-VEGASPytghon is based on IRONPython. [[http://ironpython.net|http://ironpython.net/]]. +
- +
-VEGAS scriting is based on .NET. IRONPython allows the use of .NET assemblies with Python. Unfortunately this binding to .NET creates some restrictions. +
- +
-Several Python libraries that are base on C or C++ code cannot be used. +
-More details can be found in the IRONPython documentation [[http://ironpython.net/documentation/dotnet/|http://ironpython.net/documentation/dotnet/]] +
- +
- +
- +
-==== Examples ==== +
-see the folder VEGASPython+
-The folder contains several VEGASPython Scripts that show how to deal with the VEGAS objects, events and tracks. +
- +
- +
-===== Documentation ===== +
- +
-VEGAS Scripting FAQ: +
-[[https://www.vegascreativesoftware.info/us/proxy/175d74cd3dcb5234be3c/?link=http%3A//www.vegascreativesoftware.com/fileadmin/user_upload/non_product/downloads/vegas_scripting_faq.zip|direct link vegas_scripting_faq.zip]] +
- +
-The FAQ describes the usage of VEGAS scriting for C#. The examples can be easily transfered to VEGASPython. An updated FAQ for VEGASPython will follow soon. +
- +
-VEGAS Scripting API:  +
-[[https://www.vegascreativesoftware.info/us/proxy/a8eb406a0178c38cd120/?link=http%3A//www.vegascreativesoftware.com/fileadmin/user_upload/non_product/downloads/vegas_scripting_api.zip|direct link vegas_scripting_api.zip]] +
- +
-The API describes the C# definition of all VEGAS structures and items that can be accessed. All these items can be accessed in the same way in VEGASPython. +
- +
-Sony VEGAS SDK: +
-[[https://www.vegascreativesoftware.info/us/proxy/47947f46f4594b63dd11/?link=https%3A//web.archive.org/web/20150402205921/http%3A//dspcdn.sonycreativesoftware.com/dev/vegaspro10bscriptsdk.zip|direct link to Sony VEGAS Pro SDK]] +
- +
-VEGAS Pro Tools for developers: +
-[[https://www.vegascreativesoftware.com/us/downloads/#c24726|VEGAS Tools for Developers]] +
- +
-PYTHON documentation: +
-[[https://docs.python.org/2.7/|PYTHON 2.7 documentation]] +
- +
-PYTHON Tutorials: +
-[[https://docs.python.org/2.7/tutorial/index.html|PYTHON 2.7 tutorial]] +
- +
-IRONPython Website: +
-[[http://ironpython.net/|ironpython.net]] +
  
  
 +====== VEGASPython for Developers ======
 +Please find details for developers on the following page: 
 +[[en:vegas_python_dev|VEGASPython for Developers]]
  
  
  

Andere Sprachen
QR-Code
QR-Code en:vegas_python (erstellt für aktuelle Seite)