WiFX - The Karaoke Wiki for ASSCalc, NyuFX, Lua, AFX, Tenfex & Templater - Benutzerbeiträge [de]

LVS

2013-10-15T01:37:21Z

Youka: /* Grafikprogrammierung */

=LVS=
[[Datei:LVS.png|100px]]

LVS (''"Lua Video Sync"'') ist ein [[wikipedia:Video_filter|Filter]]-[[wikipedia:Plug-in_(computing)|Plugin]] für die populären Windows [[wikipedia:Frameserver|Frameserver]] [[wikipedia:Avisynth|Avisynth]], [[wikipedia:VirtualDub|VirtualDub]] und [[wikipedia:DirectShow|DirectShow]]. Durch Angabe eines Skriptes ([[wikipedia:Lua (programming language)|Lua]] Code enthaltend) als Parameter zum durch das Plugin registrierten Filter lassen sich Videobearbeitungen vornehmen (unter Avisynth auch Audio).

Die Macht der Lua Programmiersprache in Version 5.2, erweitert u.a. durch eine einfache, mächtige [[wikipedia:2D computer graphics|2D Grafik]]bibliothek, ermöglicht eindrucksvolle grafische Bearbeitung von streamenden Video Frames in hoher Geschwindigkeit und mit vielen Mitteln.

=Geschichte=
Die Entwicklung von LVS begann im Jahre 2013 durch den Fansubber "Youka".

Inspiriert von [http://forums.animesuki.com/showthread.php?t=52757 Overlua] wurde LVS als Nachfolger jenes unausgereiften Projektes beschlossen und sollte dessen großes Potenzial, programmatisch und direkt zu [[wikipedia:Rendering (computer graphics)|rendern]] und manipulieren, in einem frischen Gewand ausschöpfen. Als Alternative zu [[wikipedia:Adobe_After_Effects|AFX]] zum typesetten komplexerer Erscheinungen und als mächtigeres Karaoke-FX Werkzeug zu den bisherigen fand es ersten Nutzen bei Fansubbern.

=Definition=
LVS sollte in folgenden Schritten verstanden werden, da es all diese vereint.

==Frameserver plugin==
LVS ist kein eigenständiges Programm, sondern eine Erweiterung für Frameserver, um eine Bearbeitung zwischen der [[wikipedia:Decoder|Dekodierung]] eines Videos und dessen Ausgabe einzufügen. [[wikipedia:Video player (software)|Abspielprogramme]] und [[wikipedia:Encoder#Media|Kodierer]], welche Frameserver nutzen, können somit Filter auf das Eingangsmaterial anwenden, womit ein anderes Ausgangsmaterial entsteht. Nach Hinzufügen von LVS als Filter muss diesem ein Parameter angegeben werden: das Skript, das die Bearbeitung beschreibt.

Im Folgenden wird der Gebrauch von LVS mit den nutzbaren Frameservern gezeigt (dies schließt den Umgang mit den Frameservern selbst nicht ein).

===Avisynth===
Avisynth wird über eine Skriptsprache gesteuert, dementsprechend wird auch LVS eingefügt.
<nowiki>LoadPlugin("E:\LVS\plugin\LVS.dll") #Lädt Plugin 'LVS'/registriert Funktion 'LVS'

BlankClip() #Erstellt einen leeren Clip
LVS("hello.lua") #Führt Videobearbeitungsskript mit LVS aus</nowiki>
Die Definition der Funktion sieht wie folgt aus:

: '''clip = LVS(clip''''', string "video", string "audio", string "data"''')'''

:: '''clip''' (1): Ausgabe-Video
:: '''clip''' (2): Eingabe-Video
:: '''string "video"''': Skript zur Videobearbeitung
:: '''string "audio"''': Skript zur Audiobearbeitung
:: '''string "data"''': String zur Übergabe in Skript-Umgebung


===VirtualDub===
VirtualDubs Video-Filterung ist über das Menü "Video", Menüeintrag "Filters...", erreichbar. Über den Button "Add..." lässt sich LVS aus einer Liste von Filtern hinzufügen und anschließend über einen Dialog dessen Skript-Parameter eingeben. Sollte LVS noch nicht in genannter Liste verfügbar sein, kann über den Button "Load..." das Plugin geladen werden.

[[Datei:LVS - VirtualDub.png|800px]]

===DirectShow===
Filter müssen erst als COM Objekt in der Windows-Registry registriert werden, um sie nutzbar für DirectShow gebrauchende Programme zu machen. Dies ist möglich mit dem Kommandozeilen-Programm [[wikipedia:Regsvr32|regsvr32]]. Anschließend hängt es vom Anwenderprogramm ab, wie der Filter geladen wird.

Am Beispiel von [[wikipedia:Media_Player_Classic#Media_Player_Classic_-_Home_Cinema|MPC-HC]] kann über Menü ''View -> Options... -> External Filter'' LVS hinzugefügt, anschließend durch Setzen der Priorität auf 'Prefer' in die Filter-Kette gezwungen und nach Neustart des Programms über Menü ''Play -> Filters -> LVS'' konfiguriert werden.

[[Datei:LVS - DirectShow.png]]

==Skript-Basis==
Basis eines jeden LVS Skripts ist die Filter Funktion, durch welche Frames bzw. Samples geschickt werden.

Im Falle der Videobearbeitung muss diese '''GetFrame''' heißen. Der erste Aufrufparameter ist ein Frame als Bildobjekt, der zweite der Frame Index.
<nowiki>function GetFrame(frame, frame_i)
-- Füll mich
end</nowiki>
Bei Audiobearbeitung lautet der Funktionsname '''GetSamples'''. Der erste Aufrufparameter ist ein Table, die Samples enthaltend, der zweite die Table-Größe des letzteren und der dritte der Sample Index des ersten erhaltenen Samples (kanalübergreifend).
<nowiki>function GetSamples(samples, samples_n, sample_i)
-- Füll mich
end</nowiki>

Metainformationen eines Streams sind als globale Variablen verfügbar. Diese umfassen '''VIDEO_WIDTH''', '''VIDEO_HEIGHT''', '''VIDEO_HAS_ALPHA''', '''VIDEO_FPS''', '''VIDEO_FRAMES''', '''AUDIO_CHANNELS''', '''AUDIO_SAMPLE_RATE''', '''AUDIO_SAMPLES''' und '''USERDATA''' (letzteres ist das ''data'' Argument in Avisynth und ist in beiden Stream-Typen verfügbar).

==Grafikprogrammierung==
Frames werden als Bildobjekt empfangen, welches Teil der nutzbaren '''g2d''' Grafikbibliothek ist. Neben dem Bildobjekt gibt es andere Grafikobjekte, welche zur Bearbeitung gebraucht werden können. Um all diese zu verwenden, werden über Member-Funktionen ihre Attribute verändert.

Eine Liste der Grafikobjekte:
* '''Image'''
: Das Bild, um welches sich die gesamte Bearbeitung dreht. Es kann leer oder aus einer [[wikipedia:Portable_Network_Graphics|PNG]] Datei erstellt, sowie als Videoframe empfangen werden. Ebenso dient es als Farbquelle und zur Analyse von Rendering-Verhalten.
* '''Context'''
: Der Bildkontext, nötig für die meisten Manipulationen am Bild. Farbquelle und Form kann auf diesen gesetzt und schließlich auf das Bild gemalt werden.
* '''Source'''
: Die Farbquelle, welche die Einfärbung der zu malenden Form beschreibt. Solide Farbe, Farbverläufe und Texturen sind ihre Arten und können zudem transformiert werden.
* '''Matrix'''
: Die Matrix, anwendbar für Transformationen an Farbquelle und Form. Rotation, Skalierung, Verschiebung, Scherung und weitere affine Transformationen lassen sich durch jene ausdrücken und kombinieren.

Die Bearbeitung eines Frames könnte nun wie folgt geschehen:
# Ein Kontext für das Bild/den Frame wird erstellt
# Eine Matrix zur Skalierung wird erstellt
# Die Matrix wird dem Kontext zugeordnet
# Ein linearer Farbverlauf wird erstellt
# Der Farbverlauf wird dem Kontext zugeordnet
# Ein Text wird als Form auf dem Kontext definiert
# Der Kontext füllt den Text mit dem Farbverlauf auf dem Frame.
Diese Beschreibung kann weit variieren, z.B. kann die Matrix eine Verschiebung in den Koordinaten-Ursprung, dann eine Rotation und schließlich die Verschiebung zurück ausdrücken, der Farbverlauf kann eine Textur anhand einer Bilddatei, die Form mit Linien und Kurven gestaltet sein und statt das Innere der Form am Ende zu füllen, kann dies mit dessen Aussenlinie geschehen.

<blockquote style="color: red;">TODO</blockquote>

==Audioprogrammierung==
Samples werden im Format Float32, also einer Amplitudenangabe von -1.0 bis +1.0, und als channel interlaced, also in Kanäle-Blöcken, empfangen.

{| style="border-collapse: collapse; font-size: 8px; line-height: 5px; text-align: center;"
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S1
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S1
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S2
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S2
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S3
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S3
C2
|style="border: solid 3px; border-right-width: 0px; background-color: yellow; width: 24px;"|...
|}
;S = Sample Index
;C = Channel

Unter Zuhilfenahme der Metainformationen, wie die Anzahl an Kanälen und der Sample Rate, lässt sich mit ihnen arbeiten.

Wer noch nichts mit Audiobearbeitung zu tun hatte und daher manch genannte Begriffe nicht kennt, kann [http://www.beschallungs-tipps.de/html/digital_audio.html hier] und [http://www.pagus.de/seminar/skript/audio2.html hier] etwas lernen.

==Erweiterungen==
Das Plugin berücksichtigt den Ordner '''LVS''', welcher sich im selben Verzeichnis wie jenes befinden muss, als Bibliotheken-Sammlung. Alle Lua Dateien innerhalb dieses Ordners werden vor jeder Ausführung von LVS geladen, somit lassen sich dort eigene Funktionen und Variablen ablegen, um sie stets ohne weiteren Aufwand nutzen zu können.

Anfangs sind bereits 2 Erweiterungen verfügbar: '''g2du''', eine Erweiterung und Ergänzung der g2d Bibliothek, und '''ass''', Funktionen zum Umgang mit [[wikipedia:SubStation_Alpha#Advanced_SubStation_Alpha|ASS]] Inhalten.

<blockquote style="color: red;">TODO</blockquote>

=Beispiele=
Folgende Beispiele sind Skripte zur Ausführung mit LVS.
==Video==
Folgende Skripte dienen der Videobearbeitung.
===Minimal===
Frame-Farben werden invertiert.
<nowiki>function GetFrame(frame, frame_i)
frame:invert()
end</nowiki>

===Zeichnen===
Zeichnet eine gelbe Aussenlinie eines Halbkreises.
<nowiki>function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_move_to(100, 100)
ctx:path_line_to(200, 100)
ctx:path_add_arc(150, 100, 50, 0, -180)
ctx:set_line_width(5)
ctx:set_line_join("BEVEL")
ctx:set_source(g2du.yellow)
ctx:stroke()
end</nowiki>

===Text===
"Hello world\nfrom LVS!" mit einem rot-zu-grün Farbverlauf.
<nowiki>local pos = {
x = 100,
y = 100
}
local text_properties = {
"Hello world\nfrom LVS!", -- Text
"Arial", -- Font
50, -- Size
true, -- Bold?
true, -- Italic?
true, -- Underline?
true -- Strikeout?
}
local text_extents = {g2d.text_extents(table.unpack(text_properties))}

function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_add_text(pos.x, pos.y, table.unpack(text_properties))
ctx:set_source(
g2d.create_lgradient(pos.x, pos.y, pos.x + text_extents[1], pos.y + text_extents[2])
:add_color(0, 1,0,0)
:add_color(1, 0,1,0)
)
ctx:fill()
end</nowiki>

===Karaoke===
<nowiki>-- Parse ASS file and fill global tables
ass.load("my_ktime.ass")

-- Roumaji & Kanji
local function roumaji_kanji(ctx, ms, line)
-- Iterate through sylables
for _, syl in ipairs(line.styleref.alignment < 7 and line.chars or line.syls) do -- Use characters in case of kanjis
-- Set color dependent on sylable activity
ctx:set_source(ms >= syl.start_time and ms < syl.end_time and g2du.red or g2du.yellow)
-- Draw sylable text
ctx:path_add_text(syl.x, syl.y, syl.text, ass.unpack_font(line.styleref))
ctx:fill()
ctx:path_clear()
end
end

-- Subtitle
local function subtitle(ctx, line)
-- Draw line text
ctx:path_add_text(line.x, line.y, line.text, ass.unpack_font(line.styleref))
ctx:set_source(g2du.yellow)
ctx:fill()
ctx:path_clear()
end

-- Process frames
function GetFrame(frame, frame_i)
-- Create drawing context for frame
local ctx = frame:get_context()
-- Get frame time
local ms = frame_i / VIDEO_FPS * 1000
-- Look for frame-related ASS lines
for _, line in ipairs(lines) do
if ms >= line.start_time and ms < line.end_time then
-- Draw ASS line
if line.styleref.alignment > 3 then
roumaji_kanji(ctx, ms, line)
else
subtitle(ctx, line)
end
end
end
end</nowiki>
==Audio==
Folgende Skripte dienen der Audiobearbeitung.
===Minimal===
Erstellt ein Rauschen.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
for i = 1, samples_n do
samples[i] = math.random(-1000,1000) / 1000
end
end</nowiki>

===Kanal-Tausch===
Tauscht bei Stereo den linken mit dem rechten Kanal.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
if AUDIO_CHANNELS == 2 then
for i = 1, samples_n, 2 do
local temp = samples[i]
samples[i] = samples[i+1]
samples[i+1] = temp
end
end
end</nowiki>

===Audio zu Text===
Schreibt Audiodaten als Text in eine Datei.
<nowiki>local file = io.open("audio.txt", "w")
file:write(string.format("Channels: %d\nSample rate: %d\nSamples: %d\n\n", AUDIO_CHANNELS, AUDIO_SAMPLE_RATE, AUDIO_SAMPLES))

function GetSamples(samples, samples_n, start_sample_i)
file:write(table.concat(samples, "\n"))
file:write("\n")
end</nowiki>

=Videos=
[http://www.mediafire.com/download/i3reijc799edi6v/%5BLVS%5D+Samples.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Karaoke Beispiele</tt>]

[http://www.mediafire.com/download/jfj41pn9xvtbd3w/%5BLVS%5D+Oreimo+S2+-+ED13.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Oreimo S2 ED13</tt>]

=Links=
*[http://sourceforge.net/projects/lua-video-sync/ Projektseite auf Sourceforge]
*[http://forum.youka.de Forum]
[[Category:LVS|{{PAGENAME}}]]

LVS

2013-10-14T08:47:52Z

Youka: /* Erweiterungen */

=LVS=
[[Datei:LVS.png|100px]]

LVS (''"Lua Video Sync"'') ist ein [[wikipedia:Video_filter|Filter]]-[[wikipedia:Plug-in_(computing)|Plugin]] für die populären Windows [[wikipedia:Frameserver|Frameserver]] [[wikipedia:Avisynth|Avisynth]], [[wikipedia:VirtualDub|VirtualDub]] und [[wikipedia:DirectShow|DirectShow]]. Durch Angabe eines Skriptes ([[wikipedia:Lua (programming language)|Lua]] Code enthaltend) als Parameter zum durch das Plugin registrierten Filter lassen sich Videobearbeitungen vornehmen (unter Avisynth auch Audio).

Die Macht der Lua Programmiersprache in Version 5.2, erweitert u.a. durch eine einfache, mächtige [[wikipedia:2D computer graphics|2D Grafik]]bibliothek, ermöglicht eindrucksvolle grafische Bearbeitung von streamenden Video Frames in hoher Geschwindigkeit und mit vielen Mitteln.

=Geschichte=
Die Entwicklung von LVS begann im Jahre 2013 durch den Fansubber "Youka".

Inspiriert von [http://forums.animesuki.com/showthread.php?t=52757 Overlua] wurde LVS als Nachfolger jenes unausgereiften Projektes beschlossen und sollte dessen großes Potenzial, programmatisch und direkt zu [[wikipedia:Rendering (computer graphics)|rendern]] und manipulieren, in einem frischen Gewand ausschöpfen. Als Alternative zu [[wikipedia:Adobe_After_Effects|AFX]] zum typesetten komplexerer Erscheinungen und als mächtigeres Karaoke-FX Werkzeug zu den bisherigen fand es ersten Nutzen bei Fansubbern.

=Definition=
LVS sollte in folgenden Schritten verstanden werden, da es all diese vereint.

==Frameserver plugin==
LVS ist kein eigenständiges Programm, sondern eine Erweiterung für Frameserver, um eine Bearbeitung zwischen der [[wikipedia:Decoder|Dekodierung]] eines Videos und dessen Ausgabe einzufügen. [[wikipedia:Video player (software)|Abspielprogramme]] und [[wikipedia:Encoder#Media|Kodierer]], welche Frameserver nutzen, können somit Filter auf das Eingangsmaterial anwenden, womit ein anderes Ausgangsmaterial entsteht. Nach Hinzufügen von LVS als Filter muss diesem ein Parameter angegeben werden: das Skript, das die Bearbeitung beschreibt.

Im Folgenden wird der Gebrauch von LVS mit den nutzbaren Frameservern gezeigt (dies schließt den Umgang mit den Frameservern selbst nicht ein).

===Avisynth===
Avisynth wird über eine Skriptsprache gesteuert, dementsprechend wird auch LVS eingefügt.
<nowiki>LoadPlugin("E:\LVS\plugin\LVS.dll") #Lädt Plugin 'LVS'/registriert Funktion 'LVS'

BlankClip() #Erstellt einen leeren Clip
LVS("hello.lua") #Führt Videobearbeitungsskript mit LVS aus</nowiki>
Die Definition der Funktion sieht wie folgt aus:

: '''clip = LVS(clip''''', string "video", string "audio", string "data"''')'''

:: '''clip''' (1): Ausgabe-Video
:: '''clip''' (2): Eingabe-Video
:: '''string "video"''': Skript zur Videobearbeitung
:: '''string "audio"''': Skript zur Audiobearbeitung
:: '''string "data"''': String zur Übergabe in Skript-Umgebung


===VirtualDub===
VirtualDubs Video-Filterung ist über das Menü "Video", Menüeintrag "Filters...", erreichbar. Über den Button "Add..." lässt sich LVS aus einer Liste von Filtern hinzufügen und anschließend über einen Dialog dessen Skript-Parameter eingeben. Sollte LVS noch nicht in genannter Liste verfügbar sein, kann über den Button "Load..." das Plugin geladen werden.

[[Datei:LVS - VirtualDub.png|800px]]

===DirectShow===
Filter müssen erst als COM Objekt in der Windows-Registry registriert werden, um sie nutzbar für DirectShow gebrauchende Programme zu machen. Dies ist möglich mit dem Kommandozeilen-Programm [[wikipedia:Regsvr32|regsvr32]]. Anschließend hängt es vom Anwenderprogramm ab, wie der Filter geladen wird.

Am Beispiel von [[wikipedia:Media_Player_Classic#Media_Player_Classic_-_Home_Cinema|MPC-HC]] kann über Menü ''View -> Options... -> External Filter'' LVS hinzugefügt, anschließend durch Setzen der Priorität auf 'Prefer' in die Filter-Kette gezwungen und nach Neustart des Programms über Menü ''Play -> Filters -> LVS'' konfiguriert werden.

[[Datei:LVS - DirectShow.png]]

==Skript-Basis==
Basis eines jeden LVS Skripts ist die Filter Funktion, durch welche Frames bzw. Samples geschickt werden.

Im Falle der Videobearbeitung muss diese '''GetFrame''' heißen. Der erste Aufrufparameter ist ein Frame als Bildobjekt, der zweite der Frame Index.
<nowiki>function GetFrame(frame, frame_i)
-- Füll mich
end</nowiki>
Bei Audiobearbeitung lautet der Funktionsname '''GetSamples'''. Der erste Aufrufparameter ist ein Table, die Samples enthaltend, der zweite die Table-Größe des letzteren und der dritte der Sample Index des ersten erhaltenen Samples (kanalübergreifend).
<nowiki>function GetSamples(samples, samples_n, sample_i)
-- Füll mich
end</nowiki>

Metainformationen eines Streams sind als globale Variablen verfügbar. Diese umfassen '''VIDEO_WIDTH''', '''VIDEO_HEIGHT''', '''VIDEO_HAS_ALPHA''', '''VIDEO_FPS''', '''VIDEO_FRAMES''', '''AUDIO_CHANNELS''', '''AUDIO_SAMPLE_RATE''', '''AUDIO_SAMPLES''' und '''USERDATA''' (letzteres ist das ''data'' Argument in Avisynth und ist in beiden Stream-Typen verfügbar).

==Grafikprogrammierung==
Frames werden als Bildobjekt empfangen, welches Teil der nutzbaren '''g2d''' Grafikbibliothek ist. Neben dem Bildobjekt gibt es andere Grafikobjekte, welche zur Bearbeitung gebraucht werden können. Um all diese zu verwenden, werden über Member-Funktionen ihre Attribute verändert.

Eine Liste der Grafikobjekte:
* '''Image'''
: Das Bild, um welches sich die gesamte Bearbeitung dreht. Es kann leer oder aus einer [[wikipedia:Portable_Network_Graphics|PNG]] Datei erstellt, sowie als Videoframe empfangen werden. Ebenso dient es als Farbquelle und zur Analyse von Rendering-Verhalten.
* '''Context'''
: Der Bildkontext, nötig für die meisten Manipulationen am Bild. Farbquelle und Form kann auf diesen gesetzt und schließlich auf das Bild gemalt werden.
* '''Source'''
: Die Farbquelle, welche die Einfärbung der zu malenden Form beschreibt. Solide Farbe, Farbverläufe und Texturen sind ihre Arten und können zudem transformiert werden.
* '''Matrix'''
: Die Matrix, anwendbar für Transformationen an Farbquelle und Form. Rotation, Skalierung, Verschiebung, Scherung und weitere affine Transformationen lassen sich durch jene ausdrücken und kombinieren.

Die Bearbeitung eines Frames könnte nun wie folgt geschehen:
# Ein Kontext für das Bild/den Frame wird erstellt
# Eine Matrix zur Skalierung wird erstellt
# Die Matrix wird dem Kontext zugeordnet
# Ein Text wird als Form auf dem Kontext definiert
# Ein linearer Farbverlauf wird erstellt
# Der Farbverlauf wird dem Kontext zugeordnet
# Der Kontext füllt den Text mit dem Farbverlauf auf dem Frame.
Diese Beschreibung kann weit variieren, z.B. kann die Matrix eine Verschiebung in den Koordinaten-Ursprung, dann eine Rotation und schließlich die Verschiebung zurück ausdrücken, der Farbverlauf kann eine Textur anhand einer Bilddatei, die Form mit Linien und Kurven gestaltet sein und statt das Innere der Form am Ende zu füllen, kann dies mit dessen Aussenlinie geschehen.

<blockquote style="color: red;">TODO</blockquote>

==Audioprogrammierung==
Samples werden im Format Float32, also einer Amplitudenangabe von -1.0 bis +1.0, und als channel interlaced, also in Kanäle-Blöcken, empfangen.

{| style="border-collapse: collapse; font-size: 8px; line-height: 5px; text-align: center;"
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S1
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S1
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S2
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S2
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S3
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S3
C2
|style="border: solid 3px; border-right-width: 0px; background-color: yellow; width: 24px;"|...
|}
;S = Sample Index
;C = Channel

Unter Zuhilfenahme der Metainformationen, wie die Anzahl an Kanälen und der Sample Rate, lässt sich mit ihnen arbeiten.

Wer noch nichts mit Audiobearbeitung zu tun hatte und daher manch genannte Begriffe nicht kennt, kann [http://www.beschallungs-tipps.de/html/digital_audio.html hier] und [http://www.pagus.de/seminar/skript/audio2.html hier] etwas lernen.

==Erweiterungen==
Das Plugin berücksichtigt den Ordner '''LVS''', welcher sich im selben Verzeichnis wie jenes befinden muss, als Bibliotheken-Sammlung. Alle Lua Dateien innerhalb dieses Ordners werden vor jeder Ausführung von LVS geladen, somit lassen sich dort eigene Funktionen und Variablen ablegen, um sie stets ohne weiteren Aufwand nutzen zu können.

Anfangs sind bereits 2 Erweiterungen verfügbar: '''g2du''', eine Erweiterung und Ergänzung der g2d Bibliothek, und '''ass''', Funktionen zum Umgang mit [[wikipedia:SubStation_Alpha#Advanced_SubStation_Alpha|ASS]] Inhalten.

<blockquote style="color: red;">TODO</blockquote>

=Beispiele=
Folgende Beispiele sind Skripte zur Ausführung mit LVS.
==Video==
Folgende Skripte dienen der Videobearbeitung.
===Minimal===
Frame-Farben werden invertiert.
<nowiki>function GetFrame(frame, frame_i)
frame:invert()
end</nowiki>

===Zeichnen===
Zeichnet eine gelbe Aussenlinie eines Halbkreises.
<nowiki>function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_move_to(100, 100)
ctx:path_line_to(200, 100)
ctx:path_add_arc(150, 100, 50, 0, -180)
ctx:set_line_width(5)
ctx:set_line_join("BEVEL")
ctx:set_source(g2du.yellow)
ctx:stroke()
end</nowiki>

===Text===
"Hello world\nfrom LVS!" mit einem rot-zu-grün Farbverlauf.
<nowiki>local pos = {
x = 100,
y = 100
}
local text_properties = {
"Hello world\nfrom LVS!", -- Text
"Arial", -- Font
50, -- Size
true, -- Bold?
true, -- Italic?
true, -- Underline?
true -- Strikeout?
}
local text_extents = {g2d.text_extents(table.unpack(text_properties))}

function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_add_text(pos.x, pos.y, table.unpack(text_properties))
ctx:set_source(
g2d.create_lgradient(pos.x, pos.y, pos.x + text_extents[1], pos.y + text_extents[2])
:add_color(0, 1,0,0)
:add_color(1, 0,1,0)
)
ctx:fill()
end</nowiki>

===Karaoke===
<nowiki>-- Parse ASS file and fill global tables
ass.load("my_ktime.ass")

-- Roumaji & Kanji
local function roumaji_kanji(ctx, ms, line)
-- Iterate through sylables
for _, syl in ipairs(line.styleref.alignment < 7 and line.chars or line.syls) do -- Use characters in case of kanjis
-- Set color dependent on sylable activity
ctx:set_source(ms >= syl.start_time and ms < syl.end_time and g2du.red or g2du.yellow)
-- Draw sylable text
ctx:path_add_text(syl.x, syl.y, syl.text, ass.unpack_font(line.styleref))
ctx:fill()
ctx:path_clear()
end
end

-- Subtitle
local function subtitle(ctx, line)
-- Draw line text
ctx:path_add_text(line.x, line.y, line.text, ass.unpack_font(line.styleref))
ctx:set_source(g2du.yellow)
ctx:fill()
ctx:path_clear()
end

-- Process frames
function GetFrame(frame, frame_i)
-- Create drawing context for frame
local ctx = frame:get_context()
-- Get frame time
local ms = frame_i / VIDEO_FPS * 1000
-- Look for frame-related ASS lines
for _, line in ipairs(lines) do
if ms >= line.start_time and ms < line.end_time then
-- Draw ASS line
if line.styleref.alignment > 3 then
roumaji_kanji(ctx, ms, line)
else
subtitle(ctx, line)
end
end
end
end</nowiki>
==Audio==
Folgende Skripte dienen der Audiobearbeitung.
===Minimal===
Erstellt ein Rauschen.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
for i = 1, samples_n do
samples[i] = math.random(-1000,1000) / 1000
end
end</nowiki>

===Kanal-Tausch===
Tauscht bei Stereo den linken mit dem rechten Kanal.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
if AUDIO_CHANNELS == 2 then
for i = 1, samples_n, 2 do
local temp = samples[i]
samples[i] = samples[i+1]
samples[i+1] = temp
end
end
end</nowiki>

===Audio zu Text===
Schreibt Audiodaten als Text in eine Datei.
<nowiki>local file = io.open("audio.txt", "w")
file:write(string.format("Channels: %d\nSample rate: %d\nSamples: %d\n\n", AUDIO_CHANNELS, AUDIO_SAMPLE_RATE, AUDIO_SAMPLES))

function GetSamples(samples, samples_n, start_sample_i)
file:write(table.concat(samples, "\n"))
file:write("\n")
end</nowiki>

=Videos=
[http://www.mediafire.com/download/i3reijc799edi6v/%5BLVS%5D+Samples.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Karaoke Beispiele</tt>]

[http://www.mediafire.com/download/jfj41pn9xvtbd3w/%5BLVS%5D+Oreimo+S2+-+ED13.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Oreimo S2 ED13</tt>]

=Links=
*[http://sourceforge.net/projects/lua-video-sync/ Projektseite auf Sourceforge]
*[http://forum.youka.de Forum]
[[Category:LVS|{{PAGENAME}}]]

LVS

2013-10-14T08:40:40Z

Youka: /* Erweiterungen */

=LVS=
[[Datei:LVS.png|100px]]

LVS (''"Lua Video Sync"'') ist ein [[wikipedia:Video_filter|Filter]]-[[wikipedia:Plug-in_(computing)|Plugin]] für die populären Windows [[wikipedia:Frameserver|Frameserver]] [[wikipedia:Avisynth|Avisynth]], [[wikipedia:VirtualDub|VirtualDub]] und [[wikipedia:DirectShow|DirectShow]]. Durch Angabe eines Skriptes ([[wikipedia:Lua (programming language)|Lua]] Code enthaltend) als Parameter zum durch das Plugin registrierten Filter lassen sich Videobearbeitungen vornehmen (unter Avisynth auch Audio).

Die Macht der Lua Programmiersprache in Version 5.2, erweitert u.a. durch eine einfache, mächtige [[wikipedia:2D computer graphics|2D Grafik]]bibliothek, ermöglicht eindrucksvolle grafische Bearbeitung von streamenden Video Frames in hoher Geschwindigkeit und mit vielen Mitteln.

=Geschichte=
Die Entwicklung von LVS begann im Jahre 2013 durch den Fansubber "Youka".

Inspiriert von [http://forums.animesuki.com/showthread.php?t=52757 Overlua] wurde LVS als Nachfolger jenes unausgereiften Projektes beschlossen und sollte dessen großes Potenzial, programmatisch und direkt zu [[wikipedia:Rendering (computer graphics)|rendern]] und manipulieren, in einem frischen Gewand ausschöpfen. Als Alternative zu [[wikipedia:Adobe_After_Effects|AFX]] zum typesetten komplexerer Erscheinungen und als mächtigeres Karaoke-FX Werkzeug zu den bisherigen fand es ersten Nutzen bei Fansubbern.

=Definition=
LVS sollte in folgenden Schritten verstanden werden, da es all diese vereint.

==Frameserver plugin==
LVS ist kein eigenständiges Programm, sondern eine Erweiterung für Frameserver, um eine Bearbeitung zwischen der [[wikipedia:Decoder|Dekodierung]] eines Videos und dessen Ausgabe einzufügen. [[wikipedia:Video player (software)|Abspielprogramme]] und [[wikipedia:Encoder#Media|Kodierer]], welche Frameserver nutzen, können somit Filter auf das Eingangsmaterial anwenden, womit ein anderes Ausgangsmaterial entsteht. Nach Hinzufügen von LVS als Filter muss diesem ein Parameter angegeben werden: das Skript, das die Bearbeitung beschreibt.

Im Folgenden wird der Gebrauch von LVS mit den nutzbaren Frameservern gezeigt (dies schließt den Umgang mit den Frameservern selbst nicht ein).

===Avisynth===
Avisynth wird über eine Skriptsprache gesteuert, dementsprechend wird auch LVS eingefügt.
<nowiki>LoadPlugin("E:\LVS\plugin\LVS.dll") #Lädt Plugin 'LVS'/registriert Funktion 'LVS'

BlankClip() #Erstellt einen leeren Clip
LVS("hello.lua") #Führt Videobearbeitungsskript mit LVS aus</nowiki>
Die Definition der Funktion sieht wie folgt aus:

: '''clip = LVS(clip''''', string "video", string "audio", string "data"''')'''

:: '''clip''' (1): Ausgabe-Video
:: '''clip''' (2): Eingabe-Video
:: '''string "video"''': Skript zur Videobearbeitung
:: '''string "audio"''': Skript zur Audiobearbeitung
:: '''string "data"''': String zur Übergabe in Skript-Umgebung


===VirtualDub===
VirtualDubs Video-Filterung ist über das Menü "Video", Menüeintrag "Filters...", erreichbar. Über den Button "Add..." lässt sich LVS aus einer Liste von Filtern hinzufügen und anschließend über einen Dialog dessen Skript-Parameter eingeben. Sollte LVS noch nicht in genannter Liste verfügbar sein, kann über den Button "Load..." das Plugin geladen werden.

[[Datei:LVS - VirtualDub.png|800px]]

===DirectShow===
Filter müssen erst als COM Objekt in der Windows-Registry registriert werden, um sie nutzbar für DirectShow gebrauchende Programme zu machen. Dies ist möglich mit dem Kommandozeilen-Programm [[wikipedia:Regsvr32|regsvr32]]. Anschließend hängt es vom Anwenderprogramm ab, wie der Filter geladen wird.

Am Beispiel von [[wikipedia:Media_Player_Classic#Media_Player_Classic_-_Home_Cinema|MPC-HC]] kann über Menü ''View -> Options... -> External Filter'' LVS hinzugefügt, anschließend durch Setzen der Priorität auf 'Prefer' in die Filter-Kette gezwungen und nach Neustart des Programms über Menü ''Play -> Filters -> LVS'' konfiguriert werden.

[[Datei:LVS - DirectShow.png]]

==Skript-Basis==
Basis eines jeden LVS Skripts ist die Filter Funktion, durch welche Frames bzw. Samples geschickt werden.

Im Falle der Videobearbeitung muss diese '''GetFrame''' heißen. Der erste Aufrufparameter ist ein Frame als Bildobjekt, der zweite der Frame Index.
<nowiki>function GetFrame(frame, frame_i)
-- Füll mich
end</nowiki>
Bei Audiobearbeitung lautet der Funktionsname '''GetSamples'''. Der erste Aufrufparameter ist ein Table, die Samples enthaltend, der zweite die Table-Größe des letzteren und der dritte der Sample Index des ersten erhaltenen Samples (kanalübergreifend).
<nowiki>function GetSamples(samples, samples_n, sample_i)
-- Füll mich
end</nowiki>

Metainformationen eines Streams sind als globale Variablen verfügbar. Diese umfassen '''VIDEO_WIDTH''', '''VIDEO_HEIGHT''', '''VIDEO_HAS_ALPHA''', '''VIDEO_FPS''', '''VIDEO_FRAMES''', '''AUDIO_CHANNELS''', '''AUDIO_SAMPLE_RATE''', '''AUDIO_SAMPLES''' und '''USERDATA''' (letzteres ist das ''data'' Argument in Avisynth und ist in beiden Stream-Typen verfügbar).

==Grafikprogrammierung==
Frames werden als Bildobjekt empfangen, welches Teil der nutzbaren '''g2d''' Grafikbibliothek ist. Neben dem Bildobjekt gibt es andere Grafikobjekte, welche zur Bearbeitung gebraucht werden können. Um all diese zu verwenden, werden über Member-Funktionen ihre Attribute verändert.

Eine Liste der Grafikobjekte:
* '''Image'''
: Das Bild, um welches sich die gesamte Bearbeitung dreht. Es kann leer oder aus einer [[wikipedia:Portable_Network_Graphics|PNG]] Datei erstellt, sowie als Videoframe empfangen werden. Ebenso dient es als Farbquelle und zur Analyse von Rendering-Verhalten.
* '''Context'''
: Der Bildkontext, nötig für die meisten Manipulationen am Bild. Farbquelle und Form kann auf diesen gesetzt und schließlich auf das Bild gemalt werden.
* '''Source'''
: Die Farbquelle, welche die Einfärbung der zu malenden Form beschreibt. Solide Farbe, Farbverläufe und Texturen sind ihre Arten und können zudem transformiert werden.
* '''Matrix'''
: Die Matrix, anwendbar für Transformationen an Farbquelle und Form. Rotation, Skalierung, Verschiebung, Scherung und weitere affine Transformationen lassen sich durch jene ausdrücken und kombinieren.

Die Bearbeitung eines Frames könnte nun wie folgt geschehen:
# Ein Kontext für das Bild/den Frame wird erstellt
# Eine Matrix zur Skalierung wird erstellt
# Die Matrix wird dem Kontext zugeordnet
# Ein Text wird als Form auf dem Kontext definiert
# Ein linearer Farbverlauf wird erstellt
# Der Farbverlauf wird dem Kontext zugeordnet
# Der Kontext füllt den Text mit dem Farbverlauf auf dem Frame.
Diese Beschreibung kann weit variieren, z.B. kann die Matrix eine Verschiebung in den Koordinaten-Ursprung, dann eine Rotation und schließlich die Verschiebung zurück ausdrücken, der Farbverlauf kann eine Textur anhand einer Bilddatei, die Form mit Linien und Kurven gestaltet sein und statt das Innere der Form am Ende zu füllen, kann dies mit dessen Aussenlinie geschehen.

<blockquote style="color: red;">TODO</blockquote>

==Audioprogrammierung==
Samples werden im Format Float32, also einer Amplitudenangabe von -1.0 bis +1.0, und als channel interlaced, also in Kanäle-Blöcken, empfangen.

{| style="border-collapse: collapse; font-size: 8px; line-height: 5px; text-align: center;"
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S1
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S1
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S2
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S2
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S3
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S3
C2
|style="border: solid 3px; border-right-width: 0px; background-color: yellow; width: 24px;"|...
|}
;S = Sample Index
;C = Channel

Unter Zuhilfenahme der Metainformationen, wie die Anzahl an Kanälen und der Sample Rate, lässt sich mit ihnen arbeiten.

Wer noch nichts mit Audiobearbeitung zu tun hatte und daher manch genannte Begriffe nicht kennt, kann [http://www.beschallungs-tipps.de/html/digital_audio.html hier] und [http://www.pagus.de/seminar/skript/audio2.html hier] etwas lernen.

==Erweiterungen==
Das Plugin berücksichtigt den Ordner '''LVS''', welcher sich im selben Verzeichnis wie jenes befinden muss, als Bibliotheken-Sammlung. Alle Lua Dateien innerhalb dieses Ordners werden vor jeder Ausführung von LVS geladen, somit lassen sich dort eigene Funktion und Variablen ablegen, um sie stets ohne weiteren Aufwand nutzen zu können.

<blockquote style="color: red;">TODO</blockquote>

=Beispiele=
Folgende Beispiele sind Skripte zur Ausführung mit LVS.
==Video==
Folgende Skripte dienen der Videobearbeitung.
===Minimal===
Frame-Farben werden invertiert.
<nowiki>function GetFrame(frame, frame_i)
frame:invert()
end</nowiki>

===Zeichnen===
Zeichnet eine gelbe Aussenlinie eines Halbkreises.
<nowiki>function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_move_to(100, 100)
ctx:path_line_to(200, 100)
ctx:path_add_arc(150, 100, 50, 0, -180)
ctx:set_line_width(5)
ctx:set_line_join("BEVEL")
ctx:set_source(g2du.yellow)
ctx:stroke()
end</nowiki>

===Text===
"Hello world\nfrom LVS!" mit einem rot-zu-grün Farbverlauf.
<nowiki>local pos = {
x = 100,
y = 100
}
local text_properties = {
"Hello world\nfrom LVS!", -- Text
"Arial", -- Font
50, -- Size
true, -- Bold?
true, -- Italic?
true, -- Underline?
true -- Strikeout?
}
local text_extents = {g2d.text_extents(table.unpack(text_properties))}

function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_add_text(pos.x, pos.y, table.unpack(text_properties))
ctx:set_source(
g2d.create_lgradient(pos.x, pos.y, pos.x + text_extents[1], pos.y + text_extents[2])
:add_color(0, 1,0,0)
:add_color(1, 0,1,0)
)
ctx:fill()
end</nowiki>

===Karaoke===
<nowiki>-- Parse ASS file and fill global tables
ass.load("my_ktime.ass")

-- Roumaji & Kanji
local function roumaji_kanji(ctx, ms, line)
-- Iterate through sylables
for _, syl in ipairs(line.styleref.alignment < 7 and line.chars or line.syls) do -- Use characters in case of kanjis
-- Set color dependent on sylable activity
ctx:set_source(ms >= syl.start_time and ms < syl.end_time and g2du.red or g2du.yellow)
-- Draw sylable text
ctx:path_add_text(syl.x, syl.y, syl.text, ass.unpack_font(line.styleref))
ctx:fill()
ctx:path_clear()
end
end

-- Subtitle
local function subtitle(ctx, line)
-- Draw line text
ctx:path_add_text(line.x, line.y, line.text, ass.unpack_font(line.styleref))
ctx:set_source(g2du.yellow)
ctx:fill()
ctx:path_clear()
end

-- Process frames
function GetFrame(frame, frame_i)
-- Create drawing context for frame
local ctx = frame:get_context()
-- Get frame time
local ms = frame_i / VIDEO_FPS * 1000
-- Look for frame-related ASS lines
for _, line in ipairs(lines) do
if ms >= line.start_time and ms < line.end_time then
-- Draw ASS line
if line.styleref.alignment > 3 then
roumaji_kanji(ctx, ms, line)
else
subtitle(ctx, line)
end
end
end
end</nowiki>
==Audio==
Folgende Skripte dienen der Audiobearbeitung.
===Minimal===
Erstellt ein Rauschen.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
for i = 1, samples_n do
samples[i] = math.random(-1000,1000) / 1000
end
end</nowiki>

===Kanal-Tausch===
Tauscht bei Stereo den linken mit dem rechten Kanal.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
if AUDIO_CHANNELS == 2 then
for i = 1, samples_n, 2 do
local temp = samples[i]
samples[i] = samples[i+1]
samples[i+1] = temp
end
end
end</nowiki>

===Audio zu Text===
Schreibt Audiodaten als Text in eine Datei.
<nowiki>local file = io.open("audio.txt", "w")
file:write(string.format("Channels: %d\nSample rate: %d\nSamples: %d\n\n", AUDIO_CHANNELS, AUDIO_SAMPLE_RATE, AUDIO_SAMPLES))

function GetSamples(samples, samples_n, start_sample_i)
file:write(table.concat(samples, "\n"))
file:write("\n")
end</nowiki>

=Videos=
[http://www.mediafire.com/download/i3reijc799edi6v/%5BLVS%5D+Samples.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Karaoke Beispiele</tt>]

[http://www.mediafire.com/download/jfj41pn9xvtbd3w/%5BLVS%5D+Oreimo+S2+-+ED13.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Oreimo S2 ED13</tt>]

=Links=
*[http://sourceforge.net/projects/lua-video-sync/ Projektseite auf Sourceforge]
*[http://forum.youka.de Forum]
[[Category:LVS|{{PAGENAME}}]]

LVS

2013-10-13T21:43:39Z

Youka:

=LVS=
[[Datei:LVS.png|100px]]

LVS (''"Lua Video Sync"'') ist ein [[wikipedia:Video_filter|Filter]]-[[wikipedia:Plug-in_(computing)|Plugin]] für die populären Windows [[wikipedia:Frameserver|Frameserver]] [[wikipedia:Avisynth|Avisynth]], [[wikipedia:VirtualDub|VirtualDub]] und [[wikipedia:DirectShow|DirectShow]]. Durch Angabe eines Skriptes ([[wikipedia:Lua (programming language)|Lua]] Code enthaltend) als Parameter zum durch das Plugin registrierten Filter lassen sich Videobearbeitungen vornehmen (unter Avisynth auch Audio).

Die Macht der Lua Programmiersprache in Version 5.2, erweitert u.a. durch eine einfache, mächtige [[wikipedia:2D computer graphics|2D Grafik]]bibliothek, ermöglicht eindrucksvolle grafische Bearbeitung von streamenden Video Frames in hoher Geschwindigkeit und mit vielen Mitteln.

=Geschichte=
Die Entwicklung von LVS begann im Jahre 2013 durch den Fansubber "Youka".

Inspiriert von [http://forums.animesuki.com/showthread.php?t=52757 Overlua] wurde LVS als Nachfolger jenes unausgereiften Projektes beschlossen und sollte dessen großes Potenzial, programmatisch und direkt zu [[wikipedia:Rendering (computer graphics)|rendern]] und manipulieren, in einem frischen Gewand ausschöpfen. Als Alternative zu [[wikipedia:Adobe_After_Effects|AFX]] zum typesetten komplexerer Erscheinungen und als mächtigeres Karaoke-FX Werkzeug zu den bisherigen fand es ersten Nutzen bei Fansubbern.

=Definition=
LVS sollte in folgenden Schritten verstanden werden, da es all diese vereint.

==Frameserver plugin==
LVS ist kein eigenständiges Programm, sondern eine Erweiterung für Frameserver, um eine Bearbeitung zwischen der [[wikipedia:Decoder|Dekodierung]] eines Videos und dessen Ausgabe einzufügen. [[wikipedia:Video player (software)|Abspielprogramme]] und [[wikipedia:Encoder#Media|Kodierer]], welche Frameserver nutzen, können somit Filter auf das Eingangsmaterial anwenden, womit ein anderes Ausgangsmaterial entsteht. Nach Hinzufügen von LVS als Filter muss diesem ein Parameter angegeben werden: das Skript, das die Bearbeitung beschreibt.

Im Folgenden wird der Gebrauch von LVS mit den nutzbaren Frameservern gezeigt (dies schließt den Umgang mit den Frameservern selbst nicht ein).

===Avisynth===
Avisynth wird über eine Skriptsprache gesteuert, dementsprechend wird auch LVS eingefügt.
<nowiki>LoadPlugin("E:\LVS\plugin\LVS.dll") #Lädt Plugin 'LVS'/registriert Funktion 'LVS'

BlankClip() #Erstellt einen leeren Clip
LVS("hello.lua") #Führt Videobearbeitungsskript mit LVS aus</nowiki>
Die Definition der Funktion sieht wie folgt aus:

: '''clip = LVS(clip''''', string "video", string "audio", string "data"''')'''

:: '''clip''' (1): Ausgabe-Video
:: '''clip''' (2): Eingabe-Video
:: '''string "video"''': Skript zur Videobearbeitung
:: '''string "audio"''': Skript zur Audiobearbeitung
:: '''string "data"''': String zur Übergabe in Skript-Umgebung


===VirtualDub===
VirtualDubs Video-Filterung ist über das Menü "Video", Menüeintrag "Filters...", erreichbar. Über den Button "Add..." lässt sich LVS aus einer Liste von Filtern hinzufügen und anschließend über einen Dialog dessen Skript-Parameter eingeben. Sollte LVS noch nicht in genannter Liste verfügbar sein, kann über den Button "Load..." das Plugin geladen werden.

[[Datei:LVS - VirtualDub.png|800px]]

===DirectShow===
Filter müssen erst als COM Objekt in der Windows-Registry registriert werden, um sie nutzbar für DirectShow gebrauchende Programme zu machen. Dies ist möglich mit dem Kommandozeilen-Programm [[wikipedia:Regsvr32|regsvr32]]. Anschließend hängt es vom Anwenderprogramm ab, wie der Filter geladen wird.

Am Beispiel von [[wikipedia:Media_Player_Classic#Media_Player_Classic_-_Home_Cinema|MPC-HC]] kann über Menü ''View -> Options... -> External Filter'' LVS hinzugefügt, anschließend durch Setzen der Priorität auf 'Prefer' in die Filter-Kette gezwungen und nach Neustart des Programms über Menü ''Play -> Filters -> LVS'' konfiguriert werden.

[[Datei:LVS - DirectShow.png]]

==Skript-Basis==
Basis eines jeden LVS Skripts ist die Filter Funktion, durch welche Frames bzw. Samples geschickt werden.

Im Falle der Videobearbeitung muss diese '''GetFrame''' heißen. Der erste Aufrufparameter ist ein Frame als Bildobjekt, der zweite der Frame Index.
<nowiki>function GetFrame(frame, frame_i)
-- Füll mich
end</nowiki>
Bei Audiobearbeitung lautet der Funktionsname '''GetSamples'''. Der erste Aufrufparameter ist ein Table, die Samples enthaltend, der zweite die Table-Größe des letzteren und der dritte der Sample Index des ersten erhaltenen Samples (kanalübergreifend).
<nowiki>function GetSamples(samples, samples_n, sample_i)
-- Füll mich
end</nowiki>

Metainformationen eines Streams sind als globale Variablen verfügbar. Diese umfassen '''VIDEO_WIDTH''', '''VIDEO_HEIGHT''', '''VIDEO_HAS_ALPHA''', '''VIDEO_FPS''', '''VIDEO_FRAMES''', '''AUDIO_CHANNELS''', '''AUDIO_SAMPLE_RATE''', '''AUDIO_SAMPLES''' und '''USERDATA''' (letzteres ist das ''data'' Argument in Avisynth und ist in beiden Stream-Typen verfügbar).

==Grafikprogrammierung==
Frames werden als Bildobjekt empfangen, welches Teil der nutzbaren '''g2d''' Grafikbibliothek ist. Neben dem Bildobjekt gibt es andere Grafikobjekte, welche zur Bearbeitung gebraucht werden können. Um all diese zu verwenden, werden über Member-Funktionen ihre Attribute verändert.

Eine Liste der Grafikobjekte:
* '''Image'''
: Das Bild, um welches sich die gesamte Bearbeitung dreht. Es kann leer oder aus einer [[wikipedia:Portable_Network_Graphics|PNG]] Datei erstellt, sowie als Videoframe empfangen werden. Ebenso dient es als Farbquelle und zur Analyse von Rendering-Verhalten.
* '''Context'''
: Der Bildkontext, nötig für die meisten Manipulationen am Bild. Farbquelle und Form kann auf diesen gesetzt und schließlich auf das Bild gemalt werden.
* '''Source'''
: Die Farbquelle, welche die Einfärbung der zu malenden Form beschreibt. Solide Farbe, Farbverläufe und Texturen sind ihre Arten und können zudem transformiert werden.
* '''Matrix'''
: Die Matrix, anwendbar für Transformationen an Farbquelle und Form. Rotation, Skalierung, Verschiebung, Scherung und weitere affine Transformationen lassen sich durch jene ausdrücken und kombinieren.

Die Bearbeitung eines Frames könnte nun wie folgt geschehen:
# Ein Kontext für das Bild/den Frame wird erstellt
# Eine Matrix zur Skalierung wird erstellt
# Die Matrix wird dem Kontext zugeordnet
# Ein Text wird als Form auf dem Kontext definiert
# Ein linearer Farbverlauf wird erstellt
# Der Farbverlauf wird dem Kontext zugeordnet
# Der Kontext füllt den Text mit dem Farbverlauf auf dem Frame.
Diese Beschreibung kann weit variieren, z.B. kann die Matrix eine Verschiebung in den Koordinaten-Ursprung, dann eine Rotation und schließlich die Verschiebung zurück ausdrücken, der Farbverlauf kann eine Textur anhand einer Bilddatei, die Form mit Linien und Kurven gestaltet sein und statt das Innere der Form am Ende zu füllen, kann dies mit dessen Aussenlinie geschehen.

<blockquote style="color: red;">TODO</blockquote>

==Audioprogrammierung==
Samples werden im Format Float32, also einer Amplitudenangabe von -1.0 bis +1.0, und als channel interlaced, also in Kanäle-Blöcken, empfangen.

{| style="border-collapse: collapse; font-size: 8px; line-height: 5px; text-align: center;"
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S1
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S1
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S2
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S2
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S3
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S3
C2
|style="border: solid 3px; border-right-width: 0px; background-color: yellow; width: 24px;"|...
|}
;S = Sample Index
;C = Channel

Unter Zuhilfenahme der Metainformationen, wie die Anzahl an Kanälen und der Sample Rate, lässt sich mit ihnen arbeiten.

Wer noch nichts mit Audiobearbeitung zu tun hatte und daher manch genannte Begriffe nicht kennt, kann [http://www.beschallungs-tipps.de/html/digital_audio.html hier] und [http://www.pagus.de/seminar/skript/audio2.html hier] etwas lernen.

==Erweiterungen==
<blockquote style="color: red;">TODO</blockquote>

=Beispiele=
Folgende Beispiele sind Skripte zur Ausführung mit LVS.
==Video==
Folgende Skripte dienen der Videobearbeitung.
===Minimal===
Frame-Farben werden invertiert.
<nowiki>function GetFrame(frame, frame_i)
frame:invert()
end</nowiki>

===Zeichnen===
Zeichnet eine gelbe Aussenlinie eines Halbkreises.
<nowiki>function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_move_to(100, 100)
ctx:path_line_to(200, 100)
ctx:path_add_arc(150, 100, 50, 0, -180)
ctx:set_line_width(5)
ctx:set_line_join("BEVEL")
ctx:set_source(g2du.yellow)
ctx:stroke()
end</nowiki>

===Text===
"Hello world\nfrom LVS!" mit einem rot-zu-grün Farbverlauf.
<nowiki>local pos = {
x = 100,
y = 100
}
local text_properties = {
"Hello world\nfrom LVS!", -- Text
"Arial", -- Font
50, -- Size
true, -- Bold?
true, -- Italic?
true, -- Underline?
true -- Strikeout?
}
local text_extents = {g2d.text_extents(table.unpack(text_properties))}

function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_add_text(pos.x, pos.y, table.unpack(text_properties))
ctx:set_source(
g2d.create_lgradient(pos.x, pos.y, pos.x + text_extents[1], pos.y + text_extents[2])
:add_color(0, 1,0,0)
:add_color(1, 0,1,0)
)
ctx:fill()
end</nowiki>

===Karaoke===
<nowiki>-- Parse ASS file and fill global tables
ass.load("my_ktime.ass")

-- Roumaji & Kanji
local function roumaji_kanji(ctx, ms, line)
-- Iterate through sylables
for _, syl in ipairs(line.styleref.alignment < 7 and line.chars or line.syls) do -- Use characters in case of kanjis
-- Set color dependent on sylable activity
ctx:set_source(ms >= syl.start_time and ms < syl.end_time and g2du.red or g2du.yellow)
-- Draw sylable text
ctx:path_add_text(syl.x, syl.y, syl.text, ass.unpack_font(line.styleref))
ctx:fill()
ctx:path_clear()
end
end

-- Subtitle
local function subtitle(ctx, line)
-- Draw line text
ctx:path_add_text(line.x, line.y, line.text, ass.unpack_font(line.styleref))
ctx:set_source(g2du.yellow)
ctx:fill()
ctx:path_clear()
end

-- Process frames
function GetFrame(frame, frame_i)
-- Create drawing context for frame
local ctx = frame:get_context()
-- Get frame time
local ms = frame_i / VIDEO_FPS * 1000
-- Look for frame-related ASS lines
for _, line in ipairs(lines) do
if ms >= line.start_time and ms < line.end_time then
-- Draw ASS line
if line.styleref.alignment > 3 then
roumaji_kanji(ctx, ms, line)
else
subtitle(ctx, line)
end
end
end
end</nowiki>
==Audio==
Folgende Skripte dienen der Audiobearbeitung.
===Minimal===
Erstellt ein Rauschen.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
for i = 1, samples_n do
samples[i] = math.random(-1000,1000) / 1000
end
end</nowiki>

===Kanal-Tausch===
Tauscht bei Stereo den linken mit dem rechten Kanal.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
if AUDIO_CHANNELS == 2 then
for i = 1, samples_n, 2 do
local temp = samples[i]
samples[i] = samples[i+1]
samples[i+1] = temp
end
end
end</nowiki>

===Audio zu Text===
Schreibt Audiodaten als Text in eine Datei.
<nowiki>local file = io.open("audio.txt", "w")
file:write(string.format("Channels: %d\nSample rate: %d\nSamples: %d\n\n", AUDIO_CHANNELS, AUDIO_SAMPLE_RATE, AUDIO_SAMPLES))

function GetSamples(samples, samples_n, start_sample_i)
file:write(table.concat(samples, "\n"))
file:write("\n")
end</nowiki>

=Videos=
[http://www.mediafire.com/download/i3reijc799edi6v/%5BLVS%5D+Samples.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Karaoke Beispiele</tt>]

[http://www.mediafire.com/download/jfj41pn9xvtbd3w/%5BLVS%5D+Oreimo+S2+-+ED13.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Oreimo S2 ED13</tt>]

=Links=
*[http://sourceforge.net/projects/lua-video-sync/ Projektseite auf Sourceforge]
*[http://forum.youka.de Forum]
[[Category:LVS|{{PAGENAME}}]]

LVS

2013-10-13T21:37:16Z

Youka:

=LVS=
[[Datei:LVS.png|100px]]

LVS (''"Lua Video Sync"'') ist ein [[wikipedia:Video_filter|Filter]]-[[wikipedia:Plug-in_(computing)|Plugin]] für die populären Windows [[wikipedia:Frameserver|Frameserver]] [[wikipedia:Avisynth|Avisynth]], [[wikipedia:VirtualDub|VirtualDub]] und [[wikipedia:DirectShow|DirectShow]]. Durch Angabe eines Skriptes ([[wikipedia:Lua (programming language)|Lua]] Code enthaltend) als Parameter zum durch das Plugin registrierten Filter lassen sich Videobearbeitungen vornehmen (unter Avisynth auch Audio).

Die Macht der Lua Programmiersprache in Version 5.2, erweitert u.a. durch eine einfache, mächtige [[wikipedia:2D computer graphics|2D Grafik]]bibliothek, ermöglicht eindrucksvolle grafische Bearbeitung von streamenden Video Frames in hoher Geschwindigkeit und mit vielen Mitteln.

=Geschichte=
Die Entwicklung von LVS begann im Jahre 2013 durch den Fansubber "Youka".

Inspiriert von [http://forums.animesuki.com/showthread.php?t=52757 Overlua] wurde LVS als Nachfolger jenes unausgereiften Projektes beschlossen und sollte dessen großes Potenzial, programmatisch und direkt zu [[wikipedia:Rendering (computer graphics)|rendern]] und manipulieren, in einem frischen Gewand ausschöpfen. Als Alternative zu [[wikipedia:Adobe_After_Effects|AFX]] zum typesetten komplexerer Erscheinungen und als mächtigeres Karaoke-FX Werkzeug zu den bisherigen fand es ersten Nutzen bei Fansubbern.

=Definition=
LVS sollte in folgenden Schritten verstanden werden, da es all diese vereint.

==Frameserver plugin==
LVS ist kein eigenständiges Programm, sondern eine Erweiterung für Frameserver, um eine Bearbeitung zwischen der [[wikipedia:Decoder|Dekodierung]] eines Videos und dessen Ausgabe einzufügen. [[wikipedia:Video player (software)|Abspielprogramme]] und [[wikipedia:Encoder#Media|Kodierer]], welche Frameserver nutzen, können somit Filter auf das Eingangsmaterial anwenden, womit ein anderes Ausgangsmaterial entsteht. Nach Hinzufügen von LVS als Filter muss diesem ein Parameter angegeben werden: das Skript, das die Bearbeitung beschreibt.

Im Folgenden wird der Gebrauch von LVS mit den nutzbaren Frameservern gezeigt (dies schließt den Umgang mit den Frameservern selbst nicht ein).

===Avisynth===
Avisynth wird über eine Skriptsprache gesteuert, dementsprechend wird auch LVS eingefügt.
<nowiki>LoadPlugin("E:\LVS\plugin\LVS.dll") #Lädt Plugin 'LVS'/registriert Funktion 'LVS'

BlankClip() #Erstellt einen leeren Clip
LVS("hello.lua") #Führt Videobearbeitungsskript mit LVS aus</nowiki>
Die Definition der Funktion sieht wie folgt aus:

: '''clip = LVS(clip''''', string "video", string "audio", string "data"''')'''

:: '''clip''' (1): Ausgabe-Video
:: '''clip''' (2): Eingabe-Video
:: '''string "video"''': Skript zur Videobearbeitung
:: '''string "audio"''': Skript zur Audiobearbeitung
:: '''string "data"''': String zur Übergabe in Skript-Umgebung


===VirtualDub===
VirtualDubs Video-Filterung ist über das Menü "Video", Menüeintrag "Filters...", erreichbar. Über den Button "Add..." lässt sich LVS aus einer Liste von Filtern hinzufügen und anschließend über einen Dialog dessen Skript-Parameter eingeben. Sollte LVS noch nicht in genannter Liste verfügbar sein, kann über den Button "Load..." das Plugin geladen werden.

[[Datei:LVS - VirtualDub.png|800px]]

===DirectShow===
Filter müssen erst als COM Objekt in der Windows-Registry registriert werden, um sie nutzbar für DirectShow gebrauchende Programme zu machen. Dies ist möglich mit dem Kommandozeilen-Programm [[wikipedia:Regsvr32|regsvr32]]. Anschließend hängt es vom Anwenderprogramm ab, wie der Filter geladen wird.

Am Beispiel von [[wikipedia:Media_Player_Classic#Media_Player_Classic_-_Home_Cinema|MPC-HC]] kann über Menü ''View -> Options... -> External Filter'' LVS hinzugefügt, anschließend durch Setzen der Priorität auf 'Prefer' in die Filter-Kette gezwungen und nach Neustart des Programms über Menü ''Play -> Filters -> LVS'' konfiguriert werden.

[[Datei:LVS - DirectShow.png]]

==Skript-Basis==
Basis eines jeden LVS Skripts ist die Filter Funktion, durch welche Frames bzw. Samples geschickt werden.

Im Falle der Videobearbeitung muss diese '''GetFrame''' heißen. Der erste Aufrufparameter ist ein Frame als Bildobjekt, der zweite der Frame Index.
<nowiki>function GetFrame(frame, frame_i)
-- Füll mich
end</nowiki>
Bei Audiobearbeitung lautet der Funktionsname '''GetSamples'''. Der erste Aufrufparameter ist ein Table, die Samples enthaltend, der zweite die Table-Größe des letzteren und der dritte der Sample Index des ersten erhaltenen Samples (kanalübergreifend).
<nowiki>function GetSamples(samples, samples_n, sample_i)
-- Füll mich
end</nowiki>

Metainformationen eines Streams sind als globale Variablen verfügbar. Diese umfassen '''VIDEO_WIDTH''', '''VIDEO_HEIGHT''', '''VIDEO_HAS_ALPHA''', '''VIDEO_FPS''', '''VIDEO_FRAMES''', '''AUDIO_CHANNELS''', '''AUDIO_SAMPLE_RATE''', '''AUDIO_SAMPLES''' und '''USERDATA''' (letzteres ist das ''data'' Argument in Avisynth und ist in beiden Stream-Typen verfügbar).

==Grafikprogrammierung==
Frames werden als Bildobjekt empfangen, welches Teil der nutzbaren '''g2d''' Grafikbibliothek ist. Neben dem Bildobjekt gibt es andere Grafikobjekte, welche zur Bearbeitung gebraucht werden können. Um all diese zu verwenden, werden über Member-Funktionen ihre Attribute verändert.

Eine Liste der Grafikobjekte:
* '''Image''' Das Bild, um welches sich die gesamte Bearbeitung dreht. Es kann leer oder aus einer [[wikipedia:Portable_Network_Graphics|PNG]] Datei erstellt, sowie als Videoframe empfangen werden. Ebenso dient es als Farbquelle und zur Analyse von Rendering-Verhalten.
* '''Context''' Der Bildkontext, nötig für die meisten Manipulationen am Bild. Farbquelle und Form kann auf diesen gesetzt und schließlich auf das Bild gemalt werden.
* '''Source''' Die Farbquelle, welche die Einfärbung der zu malenden Form beschreibt. Solide Farbe, Farbverläufe und Texturen sind ihre Arten und können zudem transformiert werden.
* '''Matrix''' Die Matrix, anwendbar für Transformationen an Farbquelle und Form. Rotation, Skalierung, Verschiebung, Scherung und weitere affine Transformationen lassen sich durch jene ausdrücken und kombinieren.

Die Bearbeitung eines Frames könnte nun wie folgt geschehen:
# Ein Kontext für das Bild/den Frame wird erstellt
# Eine Matrix zur Skalierung wird erstellt
# Die Matrix wird dem Kontext zugeordnet
# Ein Text wird als Form auf dem Kontext definiert
# Ein linearer Farbverlauf wird erstellt
# Der Farbverlauf wird dem Kontext zugeordnet
# Der Kontext füllt den Text mit dem Farbverlauf auf dem Frame.
Diese Beschreibung kann weit variieren, z.B. kann die Matrix eine Verschiebung in den Koordinaten-Ursprung, dann eine Rotation und schließlich die Verschiebung zurück ausdrücken, der Farbverlauf kann eine Textur anhand einer Bilddatei, die Form mit Linien und Kurven gestaltet sein und statt das Innere der Form am Ende zu füllen, kann dies mit dessen Aussenlinie geschehen.

<blockquote style="color: red;">TODO</blockquote>

==Audioprogrammierung==
Samples werden im Format Float32, also einer Amplitudenangabe von -1.0 bis +1.0, und als channel interlaced, also in Kanäle-Blöcken, empfangen.

{| style="border-collapse: collapse; font-size: 8px; line-height: 5px; text-align: center;"
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S1
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S1
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S2
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S2
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S3
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S3
C2
|style="border: solid 3px; border-right-width: 0px; background-color: yellow; width: 24px;"|...
|}
;S = Sample Index
;C = Channel

Unter Zuhilfenahme der Metainformationen, wie die Anzahl an Kanälen und der Sample Rate, lässt sich mit ihnen arbeiten.

Wer noch nichts mit Audiobearbeitung zu tun hatte und daher manch genannte Begriffe nicht kennt, kann [http://www.beschallungs-tipps.de/html/digital_audio.html hier] und [http://www.pagus.de/seminar/skript/audio2.html hier] etwas lernen.

==Erweiterungen==
<blockquote style="color: red;">TODO</blockquote>

=Beispiele=
Folgende Beispiele sind Skripte zur Ausführung mit LVS.
==Video==
Folgende Skripte dienen der Videobearbeitung.
===Minimal===
Frame-Farben werden invertiert.
<nowiki>function GetFrame(frame, frame_i)
frame:invert()
end</nowiki>

===Zeichnen===
Zeichnet eine gelbe Aussenlinie eines Halbkreises.
<nowiki>function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_move_to(100, 100)
ctx:path_line_to(200, 100)
ctx:path_add_arc(150, 100, 50, 0, -180)
ctx:set_line_width(5)
ctx:set_line_join("BEVEL")
ctx:set_source(g2du.yellow)
ctx:stroke()
end</nowiki>

===Text===
"Hello world\nfrom LVS!" mit einem rot-zu-grün Farbverlauf.
<nowiki>local pos = {
x = 100,
y = 100
}
local text_properties = {
"Hello world\nfrom LVS!", -- Text
"Arial", -- Font
50, -- Size
true, -- Bold?
true, -- Italic?
true, -- Underline?
true -- Strikeout?
}
local text_extents = {g2d.text_extents(table.unpack(text_properties))}

function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_add_text(pos.x, pos.y, table.unpack(text_properties))
ctx:set_source(
g2d.create_lgradient(pos.x, pos.y, pos.x + text_extents[1], pos.y + text_extents[2])
:add_color(0, 1,0,0)
:add_color(1, 0,1,0)
)
ctx:fill()
end</nowiki>

===Karaoke===
<nowiki>-- Parse ASS file and fill global tables
ass.load("my_ktime.ass")

-- Roumaji & Kanji
local function roumaji_kanji(ctx, ms, line)
-- Iterate through sylables
for _, syl in ipairs(line.styleref.alignment < 7 and line.chars or line.syls) do -- Use characters in case of kanjis
-- Set color dependent on sylable activity
ctx:set_source(ms >= syl.start_time and ms < syl.end_time and g2du.red or g2du.yellow)
-- Draw sylable text
ctx:path_add_text(syl.x, syl.y, syl.text, ass.unpack_font(line.styleref))
ctx:fill()
ctx:path_clear()
end
end

-- Subtitle
local function subtitle(ctx, line)
-- Draw line text
ctx:path_add_text(line.x, line.y, line.text, ass.unpack_font(line.styleref))
ctx:set_source(g2du.yellow)
ctx:fill()
ctx:path_clear()
end

-- Process frames
function GetFrame(frame, frame_i)
-- Create drawing context for frame
local ctx = frame:get_context()
-- Get frame time
local ms = frame_i / VIDEO_FPS * 1000
-- Look for frame-related ASS lines
for _, line in ipairs(lines) do
if ms >= line.start_time and ms < line.end_time then
-- Draw ASS line
if line.styleref.alignment > 3 then
roumaji_kanji(ctx, ms, line)
else
subtitle(ctx, line)
end
end
end
end</nowiki>
==Audio==
Folgende Skripte dienen der Audiobearbeitung.
===Minimal===
Erstellt ein Rauschen.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
for i = 1, samples_n do
samples[i] = math.random(-1000,1000) / 1000
end
end</nowiki>

===Kanal-Tausch===
Tauscht bei Stereo den linken mit dem rechten Kanal.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
if AUDIO_CHANNELS == 2 then
for i = 1, samples_n, 2 do
local temp = samples[i]
samples[i] = samples[i+1]
samples[i+1] = temp
end
end
end</nowiki>

===Audio zu Text===
Schreibt Audiodaten als Text in eine Datei.
<nowiki>local file = io.open("audio.txt", "w")
file:write(string.format("Channels: %d\nSample rate: %d\nSamples: %d\n\n", AUDIO_CHANNELS, AUDIO_SAMPLE_RATE, AUDIO_SAMPLES))

function GetSamples(samples, samples_n, start_sample_i)
file:write(table.concat(samples, "\n"))
file:write("\n")
end</nowiki>

=Videos=
[http://www.mediafire.com/download/i3reijc799edi6v/%5BLVS%5D+Samples.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Karaoke Beispiele</tt>]

[http://www.mediafire.com/download/jfj41pn9xvtbd3w/%5BLVS%5D+Oreimo+S2+-+ED13.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Oreimo S2 ED13</tt>]

=Links=
*[http://sourceforge.net/projects/lua-video-sync/ Projektseite auf Sourceforge]
*[http://forum.youka.de Forum]
[[Category:LVS|{{PAGENAME}}]]

LVS

2013-10-13T20:39:39Z

Youka:

=LVS=
[[Datei:LVS.png|100px]]

LVS (''"Lua Video Sync"'') ist ein [[wikipedia:Video_filter|Filter]]-[[wikipedia:Plug-in_(computing)|Plugin]] für die populären Windows [[wikipedia:Frameserver|Frameserver]] [[wikipedia:Avisynth|Avisynth]], [[wikipedia:VirtualDub|VirtualDub]] und [[wikipedia:DirectShow|DirectShow]]. Durch Angabe eines Skriptes ([[wikipedia:Lua (programming language)|Lua]] Code enthaltend) als Parameter zum durch das Plugin registrierten Filter lassen sich Videobearbeitungen vornehmen (unter Avisynth auch Audio).

Die Macht der Lua Programmiersprache in Version 5.2, erweitert u.a. durch eine einfache, mächtige [[wikipedia:2D computer graphics|2D Grafik]]bibliothek, ermöglicht eindrucksvolle grafische Bearbeitung von streamenden Video Frames in hoher Geschwindigkeit und mit vielen Mitteln.

=Geschichte=
Die Entwicklung von LVS begann im Jahre 2013 durch den Fansubber "Youka".

Inspiriert von [http://forums.animesuki.com/showthread.php?t=52757 Overlua] wurde LVS als Nachfolger jenes unausgereiften Projektes beschlossen und sollte dessen großes Potenzial, programmatisch und direkt zu [[wikipedia:Rendering (computer graphics)|rendern]] und manipulieren, in einem frischen Gewand ausschöpfen. Als Alternative zu [[wikipedia:Adobe_After_Effects|AFX]] zum typesetten komplexerer Erscheinungen und als mächtigeres Karaoke-FX Werkzeug zu den bisherigen fand es ersten Nutzen bei Fansubbern.

=Definition=
LVS sollte in folgenden Schritten verstanden werden, da es all diese vereint.

==Frameserver plugin==
LVS ist kein eigenständiges Programm, sondern eine Erweiterung für Frameserver, um eine Bearbeitung zwischen der [[wikipedia:Decoder|Dekodierung]] eines Videos und dessen Ausgabe einzufügen. [[wikipedia:Video player (software)|Abspielprogramme]] und [[wikipedia:Encoder#Media|Kodierer]], welche Frameserver nutzen, können somit Filter auf das Eingangsmaterial anwenden, womit ein anderes Ausgangsmaterial entsteht. Nach Hinzufügen von LVS als Filter muss diesem ein Parameter angegeben werden: das Skript, das die Bearbeitung beschreibt.

Im Folgenden wird der Gebrauch von LVS mit den nutzbaren Frameservern gezeigt (dies schließt den Umgang mit den Frameservern selbst nicht ein).

===Avisynth===
Avisynth wird über eine Skriptsprache gesteuert, dementsprechend wird auch LVS eingefügt.
<nowiki>LoadPlugin("E:\LVS\plugin\LVS.dll") #Lädt Plugin 'LVS'/registriert Funktion 'LVS'

BlankClip() #Erstellt einen leeren Clip
LVS("hello.lua") #Führt Videobearbeitungsskript mit LVS aus</nowiki>
Die Definition der Funktion sieht wie folgt aus:

: '''clip = LVS(clip''''', string "video", string "audio", string "data"''')'''

:: '''clip''' (1): Ausgabe-Video
:: '''clip''' (2): Eingabe-Video
:: '''string "video"''': Skript zur Videobearbeitung
:: '''string "audio"''': Skript zur Audiobearbeitung
:: '''string "data"''': String zur Übergabe in Skript-Umgebung


===VirtualDub===
VirtualDubs Video-Filterung ist über das Menü "Video", Menüeintrag "Filters...", erreichbar. Über den Button "Add..." lässt sich LVS aus einer Liste von Filtern hinzufügen und anschließend über einen Dialog dessen Skript-Parameter eingeben. Sollte LVS noch nicht in genannter Liste verfügbar sein, kann über den Button "Load..." das Plugin geladen werden.

[[Datei:LVS - VirtualDub.png|800px]]

===DirectShow===
Filter müssen erst als COM Objekt in der Windows-Registry registriert werden, um sie nutzbar für DirectShow gebrauchende Programme zu machen. Dies ist möglich mit dem Kommandozeilen-Programm [[wikipedia:Regsvr32|regsvr32]]. Anschließend hängt es vom Anwenderprogramm ab, wie der Filter geladen wird.

Am Beispiel von [[wikipedia:Media_Player_Classic#Media_Player_Classic_-_Home_Cinema|MPC-HC]] kann über Menü ''View -> Options... -> External Filter'' LVS hinzugefügt, anschließend durch Setzen der Priorität auf 'Prefer' in die Filter-Kette gezwungen und nach Neustart des Programms über Menü ''Play -> Filters -> LVS'' konfiguriert werden.

[[Datei:LVS - DirectShow.png]]

==Skript-Basis==
Basis eines jeden LVS Skripts ist die Filter Funktion, durch welche Frames bzw. Samples geschickt werden.

Im Falle der Videobearbeitung muss diese '''GetFrame''' heißen. Der erste Aufrufparameter ist ein Frame als Bildobjekt, der zweite der Frame Index.
<nowiki>function GetFrame(frame, frame_i)
-- Füll mich
end</nowiki>
Bei Audiobearbeitung lautet der Funktionsname '''GetSamples'''. Der erste Aufrufparameter ist ein Table, die Samples enthaltend, der zweite die Table-Größe des letzteren und der dritte der Sample Index des ersten erhaltenen Samples (kanalübergreifend).
<nowiki>function GetSamples(samples, samples_n, sample_i)
-- Füll mich
end</nowiki>

Metainformationen eines Streams sind als globale Variablen verfügbar. Diese umfassen '''VIDEO_WIDTH''', '''VIDEO_HEIGHT''', '''VIDEO_HAS_ALPHA''', '''VIDEO_FPS''', '''VIDEO_FRAMES''', '''AUDIO_CHANNELS''', '''AUDIO_SAMPLE_RATE''', '''AUDIO_SAMPLES''' und '''USERDATA''' (letzteres ist das ''data'' Argument in Avisynth und ist in beiden Stream-Typen verfügbar).

==Grafikprogrammierung==
Frames werden als Bildobjekt empfangen, welches Teil der nutzbaren '''g2d''' Grafikbibliothek ist. Neben dem Bildobjekt gibt es andere Grafikobjekte, welche zur Bearbeitung gebraucht werden können. Um all diese zu verwenden, werden über Member-Funktionen ihre Attribute verändert.

Eine Liste der Grafikobjekte:
* '''Image''' Das Bild, um welches sich die gesamte Bearbeitung dreht. Es kann leer oder aus einer [[wikipedia:Portable_Network_Graphics|PNG]] Datei erstellt, sowie als Videoframe empfangen werden. Ebenso dient es als Farbquelle und zur Analyse von Rendering-Verhalten.
* '''Context''' Der Bildkontext, nötig für die meisten Manipulationen am Bild. Farbquelle und Form kann auf diesen gesetzt und schließlich auf das Bild gemalt werden.
* '''Source''' Die Farbquelle, welche die Einfärbung der zu malenden Form beschreibt. Solide Farbe, Farbverläufe und Texturen sind ihre Arten und können zudem transformiert werden.
* '''Matrix''' Die Matrix, anwendbar für Transformationen an Farbquelle und Form. Rotation, Skalierung, Verschiebung, Scherung und weitere affine Transformationen lassen sich durch jene ausdrücken und kombinieren.

<blockquote style="color: red;">TODO</blockquote>

==Audioprogrammierung==
Samples werden im Format Float32, also einer Amplitudenangabe von -1.0 bis +1.0, und als channel interlaced, also in Kanäle-Blöcken, empfangen.

{| style="border-collapse: collapse; font-size: 8px; line-height: 5px; text-align: center;"
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S1
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S1
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S2
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S2
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S3
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S3
C2
|style="border: solid 3px; border-right-width: 0px; background-color: yellow; width: 24px;"|...
|}
;S = Sample Index
;C = Channel

Unter Zuhilfenahme der Metainformationen, wie die Anzahl an Kanälen und der Sample Rate, lässt sich mit ihnen arbeiten.

Wer noch nichts mit Audiobearbeitung zu tun hatte und daher manch genannte Begriffe nicht kennt, kann [http://www.beschallungs-tipps.de/html/digital_audio.html hier] und [http://www.pagus.de/seminar/skript/audio2.html hier] etwas lernen.

==Erweiterungen==
<blockquote style="color: red;">TODO</blockquote>

=Beispiele=
Folgende Beispiele sind Skripte zur Ausführung mit LVS.
==Video==
Folgende Skripte dienen der Videobearbeitung.
===Minimal===
Frame-Farben werden invertiert.
<nowiki>function GetFrame(frame, frame_i)
frame:invert()
end</nowiki>

===Zeichnen===
Zeichnet eine gelbe Aussenlinie eines Halbkreises.
<nowiki>function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_move_to(100, 100)
ctx:path_line_to(200, 100)
ctx:path_add_arc(150, 100, 50, 0, -180)
ctx:set_line_width(5)
ctx:set_line_join("BEVEL")
ctx:set_source(g2du.yellow)
ctx:stroke()
end</nowiki>

===Text===
"Hello world\nfrom LVS!" mit einem rot-zu-grün Farbverlauf.
<nowiki>local pos = {
x = 100,
y = 100
}
local text_properties = {
"Hello world\nfrom LVS!", -- Text
"Arial", -- Font
50, -- Size
true, -- Bold?
true, -- Italic?
true, -- Underline?
true -- Strikeout?
}
local text_extents = {g2d.text_extents(table.unpack(text_properties))}

function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_add_text(pos.x, pos.y, table.unpack(text_properties))
ctx:set_source(
g2d.create_lgradient(pos.x, pos.y, pos.x + text_extents[1], pos.y + text_extents[2])
:add_color(0, 1,0,0)
:add_color(1, 0,1,0)
)
ctx:fill()
end</nowiki>

===Karaoke===
<nowiki>-- Parse ASS file and fill global tables
ass.load("my_ktime.ass")

-- Roumaji & Kanji
local function roumaji_kanji(ctx, ms, line)
-- Iterate through sylables
for _, syl in ipairs(line.styleref.alignment < 7 and line.chars or line.syls) do -- Use characters in case of kanjis
-- Set color dependent on sylable activity
ctx:set_source(ms >= syl.start_time and ms < syl.end_time and g2du.red or g2du.yellow)
-- Draw sylable text
ctx:path_add_text(syl.x, syl.y, syl.text, ass.unpack_font(line.styleref))
ctx:fill()
ctx:path_clear()
end
end

-- Subtitle
local function subtitle(ctx, line)
-- Draw line text
ctx:path_add_text(line.x, line.y, line.text, ass.unpack_font(line.styleref))
ctx:set_source(g2du.yellow)
ctx:fill()
ctx:path_clear()
end

-- Process frames
function GetFrame(frame, frame_i)
-- Create drawing context for frame
local ctx = frame:get_context()
-- Get frame time
local ms = frame_i / VIDEO_FPS * 1000
-- Look for frame-related ASS lines
for _, line in ipairs(lines) do
if ms >= line.start_time and ms < line.end_time then
-- Draw ASS line
if line.styleref.alignment > 3 then
roumaji_kanji(ctx, ms, line)
else
subtitle(ctx, line)
end
end
end
end</nowiki>
==Audio==
Folgende Skripte dienen der Audiobearbeitung.
===Minimal===
Erstellt ein Rauschen.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
for i = 1, samples_n do
samples[i] = math.random(-1000,1000) / 1000
end
end</nowiki>

===Kanal-Tausch===
Tauscht bei Stereo den linken mit dem rechten Kanal.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
if AUDIO_CHANNELS == 2 then
for i = 1, samples_n, 2 do
local temp = samples[i]
samples[i] = samples[i+1]
samples[i+1] = temp
end
end
end</nowiki>

===Audio zu Text===
Schreibt Audiodaten als Text in eine Datei.
<nowiki>local file = io.open("audio.txt", "w")
file:write(string.format("Channels: %d\nSample rate: %d\nSamples: %d\n\n", AUDIO_CHANNELS, AUDIO_SAMPLE_RATE, AUDIO_SAMPLES))

function GetSamples(samples, samples_n, start_sample_i)
file:write(table.concat(samples, "\n"))
file:write("\n")
end</nowiki>

=Videos=
[http://www.mediafire.com/download/i3reijc799edi6v/%5BLVS%5D+Samples.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Karaoke Beispiele</tt>]

[http://www.mediafire.com/download/jfj41pn9xvtbd3w/%5BLVS%5D+Oreimo+S2+-+ED13.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Oreimo S2 ED13</tt>]

=Links=
*[http://sourceforge.net/projects/lua-video-sync/ Projektseite auf Sourceforge]
*[http://forum.youka.de Forum]
[[Category:LVS|{{PAGENAME}}]]

LVS

2013-10-13T19:51:53Z

Youka:

=LVS=
[[Datei:LVS.png|100px]]

LVS (''"Lua Video Sync"'') ist ein [[wikipedia:Video_filter|Filter]]-[[wikipedia:Plug-in_(computing)|Plugin]] für die populären Windows [[wikipedia:Frameserver|Frameserver]] [[wikipedia:Avisynth|Avisynth]], [[wikipedia:VirtualDub|VirtualDub]] und [[wikipedia:DirectShow|DirectShow]]. Durch Angabe eines Skriptes ([[wikipedia:Lua (programming language)|Lua]] Code enthaltend) als Parameter zum durch das Plugin registrierten Filter lassen sich Videobearbeitungen vornehmen (unter Avisynth auch Audio).

Die Macht der Lua Programmiersprache in Version 5.2, erweitert u.a. durch eine einfache, mächtige [[wikipedia:2D computer graphics|2D Grafik]]bibliothek, ermöglicht eindrucksvolle grafische Bearbeitung von streamenden Video Frames in hoher Geschwindigkeit und mit vielen Mitteln.

=Geschichte=
Die Entwicklung von LVS begann im Jahre 2013 durch den Fansubber "Youka".

Inspiriert von [http://forums.animesuki.com/showthread.php?t=52757 Overlua] wurde LVS als Nachfolger jenes unausgereiften Projektes beschlossen und sollte dessen großes Potenzial, programmatisch und direkt zu [[wikipedia:Rendering (computer graphics)|rendern]] und manipulieren, in einem frischen Gewand ausschöpfen. Als Alternative zu [[wikipedia:Adobe_After_Effects|AFX]] zum typesetten komplexerer Erscheinungen und als mächtigeres Karaoke-FX Werkzeug zu den bisherigen fand es ersten Nutzen bei Fansubbern.

=Definition=
LVS sollte in folgenden Schritten verstanden werden, da es all diese vereint.

==Frameserver plugin==
LVS ist kein eigenständiges Programm, sondern eine Erweiterung für Frameserver, um eine Bearbeitung zwischen der [[wikipedia:Decoder|Dekodierung]] eines Videos und dessen Ausgabe einzufügen. [[wikipedia:Video player (software)|Abspielprogramme]] und [[wikipedia:Encoder#Media|Kodierer]], welche Frameserver nutzen, können somit Filter auf das Eingangsmaterial anwenden, womit ein anderes Ausgangsmaterial entsteht. Nach Hinzufügen von LVS als Filter muss diesem ein Parameter angegeben werden: das Skript, das die Bearbeitung beschreibt.

Im Folgenden wird der Gebrauch von LVS mit den nutzbaren Frameservern gezeigt (dies schließt den Umgang mit den Frameservern selbst nicht ein).

===Avisynth===
Avisynth wird über eine Skriptsprache gesteuert, dementsprechend wird auch LVS eingefügt.
<nowiki>LoadPlugin("E:\LVS\plugin\LVS.dll") #Lädt Plugin 'LVS'/registriert Funktion 'LVS'

BlankClip() #Erstellt einen leeren Clip
LVS("hello.lua") #Führt Videobearbeitungsskript mit LVS aus</nowiki>
Die Definition der Funktion sieht wie folgt aus:

: '''clip = LVS(clip''''', string "video", string "audio", string "data"''')'''

:: '''clip''' (1): Ausgabe-Video
:: '''clip''' (2): Eingabe-Video
:: '''string "video"''': Skript zur Videobearbeitung
:: '''string "audio"''': Skript zur Audiobearbeitung
:: '''string "data"''': String zur Übergabe in Skript-Umgebung


===VirtualDub===
VirtualDubs Video-Filterung ist über das Menü "Video", Menüeintrag "Filters...", erreichbar. Über den Button "Add..." lässt sich LVS aus einer Liste von Filtern hinzufügen und anschließend über einen Dialog dessen Skript-Parameter eingeben. Sollte LVS noch nicht in genannter Liste verfügbar sein, kann über den Button "Load..." das Plugin geladen werden.

[[Datei:LVS - VirtualDub.png|800px]]

===DirectShow===
Filter müssen erst als COM Objekt in der Windows-Registry registriert werden, um sie nutzbar für DirectShow gebrauchende Programme zu machen. Dies ist möglich mit dem Kommandozeilen-Programm [[wikipedia:Regsvr32|regsvr32]]. Anschließend hängt es vom Anwenderprogramm ab, wie der Filter geladen wird.

Am Beispiel von [[wikipedia:Media_Player_Classic#Media_Player_Classic_-_Home_Cinema|MPC-HC]] kann über Menü ''View -> Options... -> External Filter'' LVS hinzugefügt, anschließend durch Setzen der Priorität auf 'Prefer' in die Filter-Kette gezwungen und nach Neustart des Programms über Menü ''Play -> Filters -> LVS'' konfiguriert werden.

[[Datei:LVS - DirectShow.png]]

==Skript-Basis==
Basis eines jeden LVS Skripts ist die Filter Funktion, durch welche Frames bzw. Samples geschickt werden.

Im Falle der Videobearbeitung muss diese '''GetFrame''' heißen. Der erste Aufrufparameter ist ein Frame als Bildobjekt, der zweite der Frame Index.
<nowiki>function GetFrame(frame, frame_i)
-- Füll mich
end</nowiki>
Bei Audiobearbeitung lautet der Funktionsname '''GetSamples'''. Der erste Aufrufparameter ist ein Table, die Samples enthaltend, der zweite die Table-Größe des letzteren und der dritte der Sample Index des ersten erhaltenen Samples (kanalübergreifend).
<nowiki>function GetSamples(samples, samples_n, sample_i)
-- Füll mich
end</nowiki>

Metainformationen eines Streams sind als globale Variablen verfügbar. Diese umfassen '''VIDEO_WIDTH''', '''VIDEO_HEIGHT''', '''VIDEO_HAS_ALPHA''', '''VIDEO_FPS''', '''VIDEO_FRAMES''', '''AUDIO_CHANNELS''', '''AUDIO_SAMPLE_RATE''', '''AUDIO_SAMPLES''' und '''USERDATA''' (letzteres ist das ''data'' Argument in Avisynth und ist in beiden Stream-Typen verfügbar).

==Grafikprogrammierung==
Frames werden als Bildobjekt empfangen, welches Teil der nutzbaren '''g2d''' Grafikbibliothek ist. Neben dem Bildobjekt gibt es andere Grafikobjekte, welche zur Bearbeitung gebraucht werden können. Um all diese zu verwenden, werden über Member-Funktionen ihre Attribute verändert.

Eine Liste der Grafikobjekte:
* '''Image''' Das Bild, um welches sich die gesamte Bearbeitung dreht.
* '''Context''' Der Bildkontext, nötig für die meisten Manipulationen am Bild.
* '''Source''' Die Farbquelle, welche die Einfärbung der zu malenden Form beschreibt.
* '''Matrix''' Die Matrix, anwendbar für Transformationen an Farbquelle und Form.

<blockquote style="color: red;">TODO</blockquote>

==Audioprogrammierung==
Samples werden im Format Float32, also einer Amplitudenangabe von -1.0 bis +1.0, und als channel interlaced, also in Kanäle-Blöcken, empfangen.

{| style="border-collapse: collapse; font-size: 8px; line-height: 5px; text-align: center;"
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S1
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S1
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S2
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S2
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S3
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S3
C2
|style="border: solid 3px; border-right-width: 0px; background-color: yellow; width: 24px;"|...
|}
;S = Sample Index
;C = Channel

Unter Zuhilfenahme der Metainformationen, wie die Anzahl an Kanälen und der Sample Rate, lässt sich mit ihnen arbeiten.

==Erweiterungen==
<blockquote style="color: red;">TODO</blockquote>

=Beispiele=
Folgende Beispiele sind Skripte zur Ausführung mit LVS.
==Video==
Folgende Skripte dienen der Videobearbeitung.
===Minimal===
Frame-Farben werden invertiert.
<nowiki>function GetFrame(frame, frame_i)
frame:invert()
end</nowiki>

===Zeichnen===
Zeichnet eine gelbe Aussenlinie eines Halbkreises.
<nowiki>function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_move_to(100, 100)
ctx:path_line_to(200, 100)
ctx:path_add_arc(150, 100, 50, 0, -180)
ctx:set_line_width(5)
ctx:set_line_join("BEVEL")
ctx:set_source(g2du.yellow)
ctx:stroke()
end</nowiki>

===Text===
"Hello world\nfrom LVS!" mit einem rot-zu-grün Farbverlauf.
<nowiki>local pos = {
x = 100,
y = 100
}
local text_properties = {
"Hello world\nfrom LVS!", -- Text
"Arial", -- Font
50, -- Size
true, -- Bold?
true, -- Italic?
true, -- Underline?
true -- Strikeout?
}
local text_extents = {g2d.text_extents(table.unpack(text_properties))}

function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_add_text(pos.x, pos.y, table.unpack(text_properties))
ctx:set_source(
g2d.create_lgradient(pos.x, pos.y, pos.x + text_extents[1], pos.y + text_extents[2])
:add_color(0, 1,0,0)
:add_color(1, 0,1,0)
)
ctx:fill()
end</nowiki>

===Karaoke===
<nowiki>-- Parse ASS file and fill global tables
ass.load("my_ktime.ass")

-- Roumaji & Kanji
local function roumaji_kanji(ctx, ms, line)
-- Iterate through sylables
for _, syl in ipairs(line.styleref.alignment < 7 and line.chars or line.syls) do -- Use characters in case of kanjis
-- Set color dependent on sylable activity
ctx:set_source(ms >= syl.start_time and ms < syl.end_time and g2du.red or g2du.yellow)
-- Draw sylable text
ctx:path_add_text(syl.x, syl.y, syl.text, ass.unpack_font(line.styleref))
ctx:fill()
ctx:path_clear()
end
end

-- Subtitle
local function subtitle(ctx, line)
-- Draw line text
ctx:path_add_text(line.x, line.y, line.text, ass.unpack_font(line.styleref))
ctx:set_source(g2du.yellow)
ctx:fill()
ctx:path_clear()
end

-- Process frames
function GetFrame(frame, frame_i)
-- Create drawing context for frame
local ctx = frame:get_context()
-- Get frame time
local ms = frame_i / VIDEO_FPS * 1000
-- Look for frame-related ASS lines
for _, line in ipairs(lines) do
if ms >= line.start_time and ms < line.end_time then
-- Draw ASS line
if line.styleref.alignment > 3 then
roumaji_kanji(ctx, ms, line)
else
subtitle(ctx, line)
end
end
end
end</nowiki>
==Audio==
Folgende Skripte dienen der Audiobearbeitung.
===Minimal===
Erstellt ein Rauschen.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
for i = 1, samples_n do
samples[i] = math.random(-1000,1000) / 1000
end
end</nowiki>

===Kanal-Tausch===
Tauscht bei Stereo den linken mit dem rechten Kanal.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
if AUDIO_CHANNELS == 2 then
for i = 1, samples_n, 2 do
local temp = samples[i]
samples[i] = samples[i+1]
samples[i+1] = temp
end
end
end</nowiki>

===Audio zu Text===
Schreibt Audiodaten als Text in eine Datei.
<nowiki>local file = io.open("audio.txt", "w")
file:write(string.format("Channels: %d\nSample rate: %d\nSamples: %d\n\n", AUDIO_CHANNELS, AUDIO_SAMPLE_RATE, AUDIO_SAMPLES))

function GetSamples(samples, samples_n, start_sample_i)
file:write(table.concat(samples, "\n"))
file:write("\n")
end</nowiki>

=Videos=
[http://www.mediafire.com/download/i3reijc799edi6v/%5BLVS%5D+Samples.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Karaoke Beispiele</tt>]

[http://www.mediafire.com/download/jfj41pn9xvtbd3w/%5BLVS%5D+Oreimo+S2+-+ED13.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Oreimo S2 ED13</tt>]

=Links=
*[http://sourceforge.net/projects/lua-video-sync/ Projektseite auf Sourceforge]
*[http://forum.youka.de Forum]
[[Category:LVS|{{PAGENAME}}]]

LVS

2013-10-13T19:16:39Z

Youka:

=LVS=
[[Datei:LVS.png|100px]]

LVS (''"Lua Video Sync"'') ist ein [[wikipedia:Video_filter|Filter]]-[[wikipedia:Plug-in_(computing)|Plugin]] für die populären Windows [[wikipedia:Frameserver|Frameserver]] [[wikipedia:Avisynth|Avisynth]], [[wikipedia:VirtualDub|VirtualDub]] und [[wikipedia:DirectShow|DirectShow]]. Durch Angabe eines Skriptes ([[wikipedia:Lua (programming language)|Lua]] Code enthaltend) als Parameter zum durch das Plugin registrierten Filter lassen sich Videobearbeitungen vornehmen (unter Avisynth auch Audio).

Die Macht der Lua Programmiersprache in Version 5.2, erweitert u.a. durch eine einfache, mächtige [[wikipedia:2D computer graphics|2D Grafik]]bibliothek, ermöglicht eindrucksvolle grafische Bearbeitung von streamenden Video Frames in hoher Geschwindigkeit und mit vielen Mitteln.

=Geschichte=
Die Entwicklung von LVS begann im Jahre 2013 durch den Fansubber "Youka".

Inspiriert von [http://forums.animesuki.com/showthread.php?t=52757 Overlua] wurde LVS als Nachfolger jenes unausgereiften Projektes beschlossen und sollte dessen großes Potenzial, programmatisch und direkt zu [[wikipedia:Rendering (computer graphics)|rendern]] und manipulieren, in einem frischen Gewand ausschöpfen. Als Alternative zu [[wikipedia:Adobe_After_Effects|AFX]] zum typesetten komplexerer Erscheinungen und als mächtigeres Karaoke-FX Werkzeug zu den bisherigen fand es ersten Nutzen bei Fansubbern.

=Definition=
LVS sollte in folgenden Schritten verstanden werden, da es all diese vereint.

==Frameserver plugin==
LVS ist kein eigenständiges Programm, sondern eine Erweiterung für Frameserver, um eine Bearbeitung zwischen der [[wikipedia:Decoder|Dekodierung]] eines Videos und dessen Ausgabe einzufügen. [[wikipedia:Video player (software)|Abspielprogramme]] und [[wikipedia:Encoder#Media|Kodierer]], welche Frameserver nutzen, können somit Filter auf das Eingangsmaterial anwenden, womit ein anderes Ausgangsmaterial entsteht. Nach Hinzufügen von LVS als Filter muss diesem ein Parameter angegeben werden: das Skript, das die Bearbeitung beschreibt.

Im Folgenden wird der Gebrauch von LVS mit den nutzbaren Frameservern gezeigt (dies schließt den Umgang mit den Frameservern selbst nicht ein).

===Avisynth===
Avisynth wird über eine Skriptsprache gesteuert, dementsprechend wird auch LVS eingefügt.
<nowiki>LoadPlugin("E:\LVS\plugin\LVS.dll") #Lädt Plugin 'LVS'/registriert Funktion 'LVS'

BlankClip() #Erstellt einen leeren Clip
LVS("hello.lua") #Führt Videobearbeitungsskript mit LVS aus</nowiki>
Die Definition der Funktion sieht wie folgt aus:

: '''clip = LVS(clip''''', string "video", string "audio", string "data"''')'''

:: '''clip''' (1): Ausgabe-Video
:: '''clip''' (2): Eingabe-Video
:: '''string "video"''': Skript zur Videobearbeitung
:: '''string "audio"''': Skript zur Audiobearbeitung
:: '''string "data"''': String zur Übergabe in Skript-Umgebung


===VirtualDub===
VirtualDubs Video-Filterung ist über das Menü "Video", Menüeintrag "Filters...", erreichbar. Über den Button "Add..." lässt sich LVS aus einer Liste von Filtern hinzufügen und anschließend über einen Dialog dessen Skript-Parameter eingeben. Sollte LVS noch nicht in genannter Liste verfügbar sein, kann über den Button "Load..." das Plugin geladen werden.

[[Datei:LVS - VirtualDub.png|800px]]

===DirectShow===
Filter müssen erst als COM Objekt in der Windows-Registry registriert werden, um sie nutzbar für DirectShow gebrauchende Programme zu machen. Dies ist möglich mit dem Kommandozeilen-Programm [[wikipedia:Regsvr32|regsvr32]]. Anschließend hängt es vom Anwenderprogramm ab, wie der Filter geladen wird.

Am Beispiel von [[wikipedia:Media_Player_Classic#Media_Player_Classic_-_Home_Cinema|MPC-HC]] kann über Menü ''View -> Options... -> External Filter'' LVS hinzugefügt, anschließend durch Setzen der Priorität auf 'Prefer' in die Filter-Kette gezwungen und nach Neustart des Programms über Menü ''Play -> Filters -> LVS'' konfiguriert werden.

[[Datei:LVS - DirectShow.png]]

==Skript-Basis==
Basis eines jeden LVS Skripts ist die Filter Funktion, durch welche Frames bzw. Samples geschickt werden.

Im Falle der Videobearbeitung muss diese '''GetFrame''' heißen. Der erste Aufrufparameter ist ein Frame als Bildobjekt, der zweite der Frame Index.
<nowiki>function GetFrame(frame, frame_i)
-- Füll mich
end</nowiki>
Bei Audiobearbeitung lautet der Funktionsname '''GetSamples'''. Der erste Aufrufparameter ist ein Table, die Samples enthaltend, der zweite die Table-Größe des letzteren und der dritte der Sample Index des ersten erhaltenen Samples (kanalübergreifend).
<nowiki>function GetSamples(samples, samples_n, sample_i)
-- Füll mich
end</nowiki>

Metainformationen eines Streams sind als globale Variablen verfügbar. Diese umfassen '''VIDEO_WIDTH''', '''VIDEO_HEIGHT''', '''VIDEO_HAS_ALPHA''', '''VIDEO_FPS''', '''VIDEO_FRAMES''', '''AUDIO_CHANNELS''', '''AUDIO_SAMPLE_RATE''', '''AUDIO_SAMPLES''' und '''USERDATA''' (letzteres ist das ''data'' Argument in Avisynth und ist in beiden Stream-Typen verfügbar).

==Grafikprogrammierung==
Frames werden als Bildobjekt empfangen, welches Teil der nutzbaren '''g2d''' Grafikbibliothek ist. Neben dem Bildobjekt gibt es andere Grafikobjekte, welche zur Bearbeitung gebraucht werden können. Um all diese zu verwenden, werden über Member-Funktionen ihre Attribute verändert.

Eine Liste der Grafikobjekte:
* '''Image''' Das Bild, um welches sich die gesamte Bearbeitung dreht.
* '''Context''' Der Bildkontext, nötig für die meisten Manipulationen am Bild.
* '''Source''' Die Farbquelle, welche die Einfärbung der zu malenden Form beschreibt.
* '''Matrix''' Die Matrix, anwendbar für Transformationen an Farbquelle und Form.

<blockquote style="color: red;">TODO</blockquote>

==Audioprogrammierung==
Samples werden im Format Float32, also einer Amplitudenangabe von -1.0 bis +1.0, und als channel interlaced, also in Kanäle-Blöcken, empfangen.

{| style="border-collapse: collapse; font-size: 8px; line-height: 5px; text-align: center;"
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S1
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S1
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S2
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S2
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S3
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S3
C2
|style="border: solid 3px; border-right-width: 0px; background-color: yellow; width: 24px;"|...
|}
;S = Sample Index
;C = Channel

Unter Zuhilfenahme der Metainformationen, wie die Anzahl an Kanälen und der Sample Rate, lässt sich mit ihnen arbeiten.

<blockquote style="color: red;">TODO</blockquote>

==Erweiterungen==
<blockquote style="color: red;">TODO</blockquote>

=Beispiele=
Folgende Beispiele sind Skripte zur Ausführung mit LVS.
==Video==
Folgende Skripte dienen der Videobearbeitung.
===Minimal===
Frame-Farben werden invertiert.
<nowiki>function GetFrame(frame, frame_i)
frame:invert()
end</nowiki>

===Zeichnen===
Zeichnet eine gelbe Aussenlinie eines Halbkreises.
<nowiki>function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_move_to(100, 100)
ctx:path_line_to(200, 100)
ctx:path_add_arc(150, 100, 50, 0, -180)
ctx:set_line_width(5)
ctx:set_line_join("BEVEL")
ctx:set_source(g2du.yellow)
ctx:stroke()
end</nowiki>

===Text===
"Hello world\nfrom LVS!" mit einem rot-zu-grün Farbverlauf.
<nowiki>local pos = {
x = 100,
y = 100
}
local text_properties = {
"Hello world\nfrom LVS!", -- Text
"Arial", -- Font
50, -- Size
true, -- Bold?
true, -- Italic?
true, -- Underline?
true -- Strikeout?
}
local text_extents = {g2d.text_extents(table.unpack(text_properties))}

function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_add_text(pos.x, pos.y, table.unpack(text_properties))
ctx:set_source(
g2d.create_lgradient(pos.x, pos.y, pos.x + text_extents[1], pos.y + text_extents[2])
:add_color(0, 1,0,0)
:add_color(1, 0,1,0)
)
ctx:fill()
end</nowiki>

===Karaoke===
<nowiki>-- Parse ASS file and fill global tables
ass.load("my_ktime.ass")

-- Roumaji & Kanji
local function roumaji_kanji(ctx, ms, line)
-- Iterate through sylables
for _, syl in ipairs(line.styleref.alignment < 7 and line.chars or line.syls) do -- Use characters in case of kanjis
-- Set color dependent on sylable activity
ctx:set_source(ms >= syl.start_time and ms < syl.end_time and g2du.red or g2du.yellow)
-- Draw sylable text
ctx:path_add_text(syl.x, syl.y, syl.text, ass.unpack_font(line.styleref))
ctx:fill()
ctx:path_clear()
end
end

-- Subtitle
local function subtitle(ctx, line)
-- Draw line text
ctx:path_add_text(line.x, line.y, line.text, ass.unpack_font(line.styleref))
ctx:set_source(g2du.yellow)
ctx:fill()
ctx:path_clear()
end

-- Process frames
function GetFrame(frame, frame_i)
-- Create drawing context for frame
local ctx = frame:get_context()
-- Get frame time
local ms = frame_i / VIDEO_FPS * 1000
-- Look for frame-related ASS lines
for _, line in ipairs(lines) do
if ms >= line.start_time and ms < line.end_time then
-- Draw ASS line
if line.styleref.alignment > 3 then
roumaji_kanji(ctx, ms, line)
else
subtitle(ctx, line)
end
end
end
end</nowiki>
==Audio==
Folgende Skripte dienen der Audiobearbeitung.
===Minimal===
Erstellt ein Rauschen.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
for i = 1, samples_n do
samples[i] = math.random(-1000,1000) / 1000
end
end</nowiki>

===Kanal-Tausch===
Tauscht bei Stereo den linken mit dem rechten Kanal.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
if AUDIO_CHANNELS == 2 then
for i = 1, samples_n, 2 do
local temp = samples[i]
samples[i] = samples[i+1]
samples[i+1] = temp
end
end
end</nowiki>

===Audio zu Text===
Schreibt Audiodaten als Text in eine Datei.
<nowiki>local file = io.open("audio.txt", "w")
file:write(string.format("Channels: %d\nSample rate: %d\nSamples: %d\n\n", AUDIO_CHANNELS, AUDIO_SAMPLE_RATE, AUDIO_SAMPLES))

function GetSamples(samples, samples_n, start_sample_i)
file:write(table.concat(samples, "\n"))
file:write("\n")
end</nowiki>

=Videos=
[http://www.mediafire.com/download/i3reijc799edi6v/%5BLVS%5D+Samples.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Karaoke Beispiele</tt>]

[http://www.mediafire.com/download/jfj41pn9xvtbd3w/%5BLVS%5D+Oreimo+S2+-+ED13.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Oreimo S2 ED13</tt>]

=Links=
*[http://sourceforge.net/projects/lua-video-sync/ Projektseite auf Sourceforge]
*[http://forum.youka.de Forum]
[[Category:LVS|{{PAGENAME}}]]

LVS

2013-10-05T12:37:24Z

Youka: /* Kanal-Tausch */

=LVS=
[[Datei:LVS.png|100px]]

LVS (''"Lua Video Sync"'') ist ein [[wikipedia:Video_filter|Filter]]-[[wikipedia:Plug-in_(computing)|Plugin]] für die populären Windows [[wikipedia:Frameserver|Frameserver]] [[wikipedia:Avisynth|Avisynth]], [[wikipedia:VirtualDub|VirtualDub]] und [[wikipedia:DirectShow|DirectShow]]. Durch Angabe eines Skriptes ([[wikipedia:Lua (programming language)|Lua]] Code enthaltend) als Parameter zum durch das Plugin registrierten Filter lassen sich Videobearbeitungen vornehmen (unter Avisynth auch Audio).

Die Macht der Lua Programmiersprache in Version 5.2, erweitert u.a. durch eine einfache, mächtige [[wikipedia:2D computer graphics|2D Grafik]]bibliothek, ermöglicht eindrucksvolle grafische Bearbeitung von streamenden Video Frames in hoher Geschwindigkeit und mit vielen Mitteln.

=Geschichte=
Die Entwicklung von LVS begann im Jahre 2013 durch den Fansubber "Youka".

Inspiriert von [http://forums.animesuki.com/showthread.php?t=52757 Overlua] wurde LVS als Nachfolger jenes unausgereiften Projektes beschlossen und sollte dessen großes Potenzial, programmatisch und direkt zu [[wikipedia:Rendering (computer graphics)|rendern]] und manipulieren, in einem frischen Gewand ausschöpfen. Als Alternative zu [[wikipedia:Adobe_After_Effects|AFX]] zum typesetten komplexerer Erscheinungen und als mächtigeres Karaoke-FX Werkzeug zu den bisherigen fand es ersten Nutzen bei Fansubbern.

=Definition=
LVS sollte in folgenden Schritten verstanden werden, da es all diese vereint.

==Frameserver plugin==
LVS ist kein eigenständiges Programm, sondern eine Erweiterung für Frameserver, um eine Bearbeitung zwischen der [[wikipedia:Decoder|Dekodierung]] eines Videos und dessen Ausgabe einzufügen. [[wikipedia:Video player (software)|Abspielprogramme]] und [[wikipedia:Encoder#Media|Kodierer]], welche Frameserver nutzen, können somit Filter auf das Eingangsmaterial anwenden, womit ein anderes Ausgangsmaterial entsteht. Nach Hinzufügen von LVS als Filter muss diesem ein Parameter angegeben werden: das Skript, das die Bearbeitung beschreibt.

Im Folgenden wird der Gebrauch von LVS mit den nutzbaren Frameservern gezeigt (dies schließt den Umgang mit den Frameservern selbst nicht ein).

===Avisynth===
Avisynth wird über eine Skriptsprache gesteuert, dementsprechend wird auch LVS eingefügt.
<nowiki>LoadPlugin("E:\LVS\plugin\LVS.dll") #Lädt Plugin 'LVS'/registriert Funktion 'LVS'

BlankClip() #Erstellt einen leeren Clip
LVS("hello.lua") #Führt Videobearbeitungsskript mit LVS aus</nowiki>
Die Definition der Funktion sieht wie folgt aus:

: '''clip = LVS(clip''''', string "video", string "audio", string "data"''')'''

:: '''clip''' (1): Ausgabe-Video
:: '''clip''' (2): Eingabe-Video
:: '''string "video"''': Skript zur Videobearbeitung
:: '''string "audio"''': Skript zur Audiobearbeitung
:: '''string "data"''': String zur Übergabe in Skript-Umgebung


===VirtualDub===
VirtualDubs Video-Filterung ist über das Menü "Video", Menüeintrag "Filters...", erreichbar. Über den Button "Add..." lässt sich LVS aus einer Liste von Filtern hinzufügen und anschließend über einen Dialog dessen Skript-Parameter eingeben. Sollte LVS noch nicht in genannter Liste verfügbar sein, kann über den Button "Load..." das Plugin geladen werden.

[[Datei:LVS - VirtualDub.png|800px]]

===DirectShow===
Filter müssen erst als COM Objekt in der Windows-Registry registriert werden, um sie nutzbar für DirectShow gebrauchende Programme zu machen. Dies ist möglich mit dem Kommandozeilen-Programm [[wikipedia:Regsvr32|regsvr32]]. Anschließend hängt es vom Anwenderprogramm ab, wie der Filter geladen wird.

Am Beispiel von [[wikipedia:Media_Player_Classic#Media_Player_Classic_-_Home_Cinema|MPC-HC]] kann über Menü ''View -> Options... -> External Filter'' LVS hinzugefügt, anschließend durch Setzen der Priorität auf 'Prefer' in die Filter-Kette gezwungen und nach Neustart des Programms über Menü ''Play -> Filters -> LVS'' konfiguriert werden.

[[Datei:LVS - DirectShow.png]]

==Skript-Basis==
Basis eines jeden LVS Skripts ist die Filter Funktion, durch welche Frames bzw. Samples geschickt werden.

Im Falle der Videobearbeitung muss diese '''GetFrame''' heißen. Der erste Aufrufparameter ist ein Frame als Bildobjekt, der zweite der Frame Index.
<nowiki>function GetFrame(frame, frame_i)
-- Füll mich
end</nowiki>
Bei Audiobearbeitung lautet der Funktionsname '''GetSamples'''. Der erste Aufrufparameter ist ein Table, die Samples enthaltend, der zweite die Table-Größe des letzteren und der dritte der Sample Index des ersten erhaltenen Samples (kanalübergreifend).
<nowiki>function GetSamples(samples, samples_n, sample_i)
-- Füll mich
end</nowiki>

Metainformationen eines Streams sind als globale Variablen verfügbar. Diese umfassen '''VIDEO_WIDTH''', '''VIDEO_HEIGHT''', '''VIDEO_HAS_ALPHA''', '''VIDEO_FPS''', '''VIDEO_FRAMES''', '''AUDIO_CHANNELS''', '''AUDIO_SAMPLE_RATE''', '''AUDIO_SAMPLES''' und '''USERDATA''' (letzteres ist das ''data'' Argument in Avisynth und ist in beiden Stream-Typen verfügbar).

==Grafikprogrammierung==
Frames werden als Bildobjekt empfangen, welches Teil der nutzbaren '''g2d''' Grafikbibliothek ist. Neben dem Bildobjekt gibt es andere Grafikobjekte, welche zur Bearbeitung gebraucht werden können. Um all diese zu verwenden, werden über Member-Funktionen ihre Attribute verändert.

Eine Liste der Grafikobjekte:
* '''Image''': Das Bild, um welches sich die gesamte Bearbeitung dreht.
* '''Context''': Der Bildkontext, nötig für die meisten Manipulationen am Bild.
* '''Source''': Die Farbquelle, welche die Einfärbung der zu malenden Form beschreibt.
* '''Matrix''': Die Matrix, anwendbar für Transformationen an Farbquelle und Form.

<blockquote style="color: red;">TODO</blockquote>

==Audioprogrammierung==
Samples werden im Format Float32, also einer Amplitudenangabe von -1.0 bis +1.0, und als channel interlaced, also in Kanäle-Blöcken, empfangen.

{| style="border-collapse: collapse; font-size: 8px; line-height: 5px; text-align: center;"
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S1
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S1
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S2
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S2
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S3
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S3
C2
|style="border: solid 3px; border-right-width: 0px; background-color: yellow; width: 24px;"|...
|}
;S = Sample Index
;C = Channel

Unter Zuhilfenahme der Metainformationen, wie die Anzahl an Kanälen und der Sample Rate, lässt sich mit ihnen arbeiten.

<blockquote style="color: red;">TODO</blockquote>

==Erweiterungen==
<blockquote style="color: red;">TODO</blockquote>

=Beispiele=
Folgende Beispiele sind Skripte zur Ausführung mit LVS.
==Video==
Folgende Skripte dienen der Videobearbeitung.
===Minimal===
Frame-Farben werden invertiert.
<nowiki>function GetFrame(frame, frame_i)
frame:invert()
end</nowiki>

===Zeichnen===
Zeichnet eine gelbe Aussenlinie eines Halbkreises.
<nowiki>function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_move_to(100, 100)
ctx:path_line_to(200, 100)
ctx:path_add_arc(150, 100, 50, 0, -180)
ctx:set_line_width(5)
ctx:set_line_join("BEVEL")
ctx:set_source(g2du.yellow)
ctx:stroke()
end</nowiki>

===Text===
"Hello world\nfrom LVS!" mit einem rot-zu-grün Farbverlauf.
<nowiki>local pos = {
x = 100,
y = 100
}
local text_properties = {
"Hello world\nfrom LVS!", -- Text
"Arial", -- Font
50, -- Size
true, -- Bold?
true, -- Italic?
true, -- Underline?
true -- Strikeout?
}
local text_extents = {g2d.text_extents(table.unpack(text_properties))}

function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_add_text(pos.x, pos.y, table.unpack(text_properties))
ctx:set_source(
g2d.create_lgradient(pos.x, pos.y, pos.x + text_extents[1], pos.y + text_extents[2])
:add_color(0, 1,0,0)
:add_color(1, 0,1,0)
)
ctx:fill()
end</nowiki>

===Karaoke===
<nowiki>-- Parse ASS file and fill global tables
ass.load("my_ktime.ass")

-- Roumaji & Kanji
local function roumaji_kanji(ctx, ms, line)
-- Iterate through sylables
for _, syl in ipairs(line.styleref.alignment < 7 and line.chars or line.syls) do -- Use characters in case of kanjis
-- Set color dependent on sylable activity
ctx:set_source(ms >= syl.start_time and ms < syl.end_time and g2du.red or g2du.yellow)
-- Draw sylable text
ctx:path_add_text(syl.x, syl.y, syl.text, ass.unpack_font(line.styleref))
ctx:fill()
ctx:path_clear()
end
end

-- Subtitle
local function subtitle(ctx, line)
-- Draw line text
ctx:path_add_text(line.x, line.y, line.text, ass.unpack_font(line.styleref))
ctx:set_source(g2du.yellow)
ctx:fill()
ctx:path_clear()
end

-- Process frames
function GetFrame(frame, frame_i)
-- Create drawing context for frame
local ctx = frame:get_context()
-- Get frame time
local ms = frame_i / VIDEO_FPS * 1000
-- Look for frame-related ASS lines
for _, line in ipairs(lines) do
if ms >= line.start_time and ms < line.end_time then
-- Draw ASS line
if line.styleref.alignment > 3 then
roumaji_kanji(ctx, ms, line)
else
subtitle(ctx, line)
end
end
end
end</nowiki>
==Audio==
Folgende Skripte dienen der Audiobearbeitung.
===Minimal===
Erstellt ein Rauschen.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
for i = 1, samples_n do
samples[i] = math.random(-1000,1000) / 1000
end
end</nowiki>

===Kanal-Tausch===
Tauscht bei Stereo den linken mit dem rechten Kanal.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
if AUDIO_CHANNELS == 2 then
for i = 1, samples_n, 2 do
local temp = samples[i]
samples[i] = samples[i+1]
samples[i+1] = temp
end
end
end</nowiki>

===Audio zu Text===
Schreibt Audiodaten als Text in eine Datei.
<nowiki>local file = io.open("audio.txt", "w")
file:write(string.format("Channels: %d\nSample rate: %d\nSamples: %d\n\n", AUDIO_CHANNELS, AUDIO_SAMPLE_RATE, AUDIO_SAMPLES))

function GetSamples(samples, samples_n, start_sample_i)
file:write(table.concat(samples, "\n"))
file:write("\n")
end</nowiki>

=Videos=
[http://www.mediafire.com/download/i3reijc799edi6v/%5BLVS%5D+Samples.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Karaoke Beispiele</tt>]

[http://www.mediafire.com/download/jfj41pn9xvtbd3w/%5BLVS%5D+Oreimo+S2+-+ED13.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Oreimo S2 ED13</tt>]

=Links=
*[http://sourceforge.net/projects/lua-video-sync/ Projektseite auf Sourceforge]
*[http://forum.youka.de Forum]
[[Category:LVS|{{PAGENAME}}]]

LVS

2013-10-05T12:31:31Z

Youka: /* Minimal */

=LVS=
[[Datei:LVS.png|100px]]

LVS (''"Lua Video Sync"'') ist ein [[wikipedia:Video_filter|Filter]]-[[wikipedia:Plug-in_(computing)|Plugin]] für die populären Windows [[wikipedia:Frameserver|Frameserver]] [[wikipedia:Avisynth|Avisynth]], [[wikipedia:VirtualDub|VirtualDub]] und [[wikipedia:DirectShow|DirectShow]]. Durch Angabe eines Skriptes ([[wikipedia:Lua (programming language)|Lua]] Code enthaltend) als Parameter zum durch das Plugin registrierten Filter lassen sich Videobearbeitungen vornehmen (unter Avisynth auch Audio).

Die Macht der Lua Programmiersprache in Version 5.2, erweitert u.a. durch eine einfache, mächtige [[wikipedia:2D computer graphics|2D Grafik]]bibliothek, ermöglicht eindrucksvolle grafische Bearbeitung von streamenden Video Frames in hoher Geschwindigkeit und mit vielen Mitteln.

=Geschichte=
Die Entwicklung von LVS begann im Jahre 2013 durch den Fansubber "Youka".

Inspiriert von [http://forums.animesuki.com/showthread.php?t=52757 Overlua] wurde LVS als Nachfolger jenes unausgereiften Projektes beschlossen und sollte dessen großes Potenzial, programmatisch und direkt zu [[wikipedia:Rendering (computer graphics)|rendern]] und manipulieren, in einem frischen Gewand ausschöpfen. Als Alternative zu [[wikipedia:Adobe_After_Effects|AFX]] zum typesetten komplexerer Erscheinungen und als mächtigeres Karaoke-FX Werkzeug zu den bisherigen fand es ersten Nutzen bei Fansubbern.

=Definition=
LVS sollte in folgenden Schritten verstanden werden, da es all diese vereint.

==Frameserver plugin==
LVS ist kein eigenständiges Programm, sondern eine Erweiterung für Frameserver, um eine Bearbeitung zwischen der [[wikipedia:Decoder|Dekodierung]] eines Videos und dessen Ausgabe einzufügen. [[wikipedia:Video player (software)|Abspielprogramme]] und [[wikipedia:Encoder#Media|Kodierer]], welche Frameserver nutzen, können somit Filter auf das Eingangsmaterial anwenden, womit ein anderes Ausgangsmaterial entsteht. Nach Hinzufügen von LVS als Filter muss diesem ein Parameter angegeben werden: das Skript, das die Bearbeitung beschreibt.

Im Folgenden wird der Gebrauch von LVS mit den nutzbaren Frameservern gezeigt (dies schließt den Umgang mit den Frameservern selbst nicht ein).

===Avisynth===
Avisynth wird über eine Skriptsprache gesteuert, dementsprechend wird auch LVS eingefügt.
<nowiki>LoadPlugin("E:\LVS\plugin\LVS.dll") #Lädt Plugin 'LVS'/registriert Funktion 'LVS'

BlankClip() #Erstellt einen leeren Clip
LVS("hello.lua") #Führt Videobearbeitungsskript mit LVS aus</nowiki>
Die Definition der Funktion sieht wie folgt aus:

: '''clip = LVS(clip''''', string "video", string "audio", string "data"''')'''

:: '''clip''' (1): Ausgabe-Video
:: '''clip''' (2): Eingabe-Video
:: '''string "video"''': Skript zur Videobearbeitung
:: '''string "audio"''': Skript zur Audiobearbeitung
:: '''string "data"''': String zur Übergabe in Skript-Umgebung


===VirtualDub===
VirtualDubs Video-Filterung ist über das Menü "Video", Menüeintrag "Filters...", erreichbar. Über den Button "Add..." lässt sich LVS aus einer Liste von Filtern hinzufügen und anschließend über einen Dialog dessen Skript-Parameter eingeben. Sollte LVS noch nicht in genannter Liste verfügbar sein, kann über den Button "Load..." das Plugin geladen werden.

[[Datei:LVS - VirtualDub.png|800px]]

===DirectShow===
Filter müssen erst als COM Objekt in der Windows-Registry registriert werden, um sie nutzbar für DirectShow gebrauchende Programme zu machen. Dies ist möglich mit dem Kommandozeilen-Programm [[wikipedia:Regsvr32|regsvr32]]. Anschließend hängt es vom Anwenderprogramm ab, wie der Filter geladen wird.

Am Beispiel von [[wikipedia:Media_Player_Classic#Media_Player_Classic_-_Home_Cinema|MPC-HC]] kann über Menü ''View -> Options... -> External Filter'' LVS hinzugefügt, anschließend durch Setzen der Priorität auf 'Prefer' in die Filter-Kette gezwungen und nach Neustart des Programms über Menü ''Play -> Filters -> LVS'' konfiguriert werden.

[[Datei:LVS - DirectShow.png]]

==Skript-Basis==
Basis eines jeden LVS Skripts ist die Filter Funktion, durch welche Frames bzw. Samples geschickt werden.

Im Falle der Videobearbeitung muss diese '''GetFrame''' heißen. Der erste Aufrufparameter ist ein Frame als Bildobjekt, der zweite der Frame Index.
<nowiki>function GetFrame(frame, frame_i)
-- Füll mich
end</nowiki>
Bei Audiobearbeitung lautet der Funktionsname '''GetSamples'''. Der erste Aufrufparameter ist ein Table, die Samples enthaltend, der zweite die Table-Größe des letzteren und der dritte der Sample Index des ersten erhaltenen Samples (kanalübergreifend).
<nowiki>function GetSamples(samples, samples_n, sample_i)
-- Füll mich
end</nowiki>

Metainformationen eines Streams sind als globale Variablen verfügbar. Diese umfassen '''VIDEO_WIDTH''', '''VIDEO_HEIGHT''', '''VIDEO_HAS_ALPHA''', '''VIDEO_FPS''', '''VIDEO_FRAMES''', '''AUDIO_CHANNELS''', '''AUDIO_SAMPLE_RATE''', '''AUDIO_SAMPLES''' und '''USERDATA''' (letzteres ist das ''data'' Argument in Avisynth und ist in beiden Stream-Typen verfügbar).

==Grafikprogrammierung==
Frames werden als Bildobjekt empfangen, welches Teil der nutzbaren '''g2d''' Grafikbibliothek ist. Neben dem Bildobjekt gibt es andere Grafikobjekte, welche zur Bearbeitung gebraucht werden können. Um all diese zu verwenden, werden über Member-Funktionen ihre Attribute verändert.

Eine Liste der Grafikobjekte:
* '''Image''': Das Bild, um welches sich die gesamte Bearbeitung dreht.
* '''Context''': Der Bildkontext, nötig für die meisten Manipulationen am Bild.
* '''Source''': Die Farbquelle, welche die Einfärbung der zu malenden Form beschreibt.
* '''Matrix''': Die Matrix, anwendbar für Transformationen an Farbquelle und Form.

<blockquote style="color: red;">TODO</blockquote>

==Audioprogrammierung==
Samples werden im Format Float32, also einer Amplitudenangabe von -1.0 bis +1.0, und als channel interlaced, also in Kanäle-Blöcken, empfangen.

{| style="border-collapse: collapse; font-size: 8px; line-height: 5px; text-align: center;"
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S1
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S1
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S2
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S2
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S3
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S3
C2
|style="border: solid 3px; border-right-width: 0px; background-color: yellow; width: 24px;"|...
|}
;S = Sample Index
;C = Channel

Unter Zuhilfenahme der Metainformationen, wie die Anzahl an Kanälen und der Sample Rate, lässt sich mit ihnen arbeiten.

<blockquote style="color: red;">TODO</blockquote>

==Erweiterungen==
<blockquote style="color: red;">TODO</blockquote>

=Beispiele=
Folgende Beispiele sind Skripte zur Ausführung mit LVS.
==Video==
Folgende Skripte dienen der Videobearbeitung.
===Minimal===
Frame-Farben werden invertiert.
<nowiki>function GetFrame(frame, frame_i)
frame:invert()
end</nowiki>

===Zeichnen===
Zeichnet eine gelbe Aussenlinie eines Halbkreises.
<nowiki>function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_move_to(100, 100)
ctx:path_line_to(200, 100)
ctx:path_add_arc(150, 100, 50, 0, -180)
ctx:set_line_width(5)
ctx:set_line_join("BEVEL")
ctx:set_source(g2du.yellow)
ctx:stroke()
end</nowiki>

===Text===
"Hello world\nfrom LVS!" mit einem rot-zu-grün Farbverlauf.
<nowiki>local pos = {
x = 100,
y = 100
}
local text_properties = {
"Hello world\nfrom LVS!", -- Text
"Arial", -- Font
50, -- Size
true, -- Bold?
true, -- Italic?
true, -- Underline?
true -- Strikeout?
}
local text_extents = {g2d.text_extents(table.unpack(text_properties))}

function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_add_text(pos.x, pos.y, table.unpack(text_properties))
ctx:set_source(
g2d.create_lgradient(pos.x, pos.y, pos.x + text_extents[1], pos.y + text_extents[2])
:add_color(0, 1,0,0)
:add_color(1, 0,1,0)
)
ctx:fill()
end</nowiki>

===Karaoke===
<nowiki>-- Parse ASS file and fill global tables
ass.load("my_ktime.ass")

-- Roumaji & Kanji
local function roumaji_kanji(ctx, ms, line)
-- Iterate through sylables
for _, syl in ipairs(line.styleref.alignment < 7 and line.chars or line.syls) do -- Use characters in case of kanjis
-- Set color dependent on sylable activity
ctx:set_source(ms >= syl.start_time and ms < syl.end_time and g2du.red or g2du.yellow)
-- Draw sylable text
ctx:path_add_text(syl.x, syl.y, syl.text, ass.unpack_font(line.styleref))
ctx:fill()
ctx:path_clear()
end
end

-- Subtitle
local function subtitle(ctx, line)
-- Draw line text
ctx:path_add_text(line.x, line.y, line.text, ass.unpack_font(line.styleref))
ctx:set_source(g2du.yellow)
ctx:fill()
ctx:path_clear()
end

-- Process frames
function GetFrame(frame, frame_i)
-- Create drawing context for frame
local ctx = frame:get_context()
-- Get frame time
local ms = frame_i / VIDEO_FPS * 1000
-- Look for frame-related ASS lines
for _, line in ipairs(lines) do
if ms >= line.start_time and ms < line.end_time then
-- Draw ASS line
if line.styleref.alignment > 3 then
roumaji_kanji(ctx, ms, line)
else
subtitle(ctx, line)
end
end
end
end</nowiki>
==Audio==
Folgende Skripte dienen der Audiobearbeitung.
===Minimal===
Erstellt ein Rauschen.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
for i = 1, samples_n do
samples[i] = math.random(-1000,1000) / 1000
end
end</nowiki>

==Kanal-Tausch==
Tauscht bei Stereo den linken mit dem rechten Kanal.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
if AUDIO_CHANNELS == 2 then
for i = 1, samples_n, 2 do
local temp = samples[i]
samples[i] = samples[i+1]
samples[i+1] = temp
end
end
end</nowiki>

===Audio zu Text===
Schreibt Audiodaten als Text in eine Datei.
<nowiki>local file = io.open("audio.txt", "w")
file:write(string.format("Channels: %d\nSample rate: %d\nSamples: %d\n\n", AUDIO_CHANNELS, AUDIO_SAMPLE_RATE, AUDIO_SAMPLES))

function GetSamples(samples, samples_n, start_sample_i)
file:write(table.concat(samples, "\n"))
file:write("\n")
end</nowiki>

=Videos=
[http://www.mediafire.com/download/i3reijc799edi6v/%5BLVS%5D+Samples.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Karaoke Beispiele</tt>]

[http://www.mediafire.com/download/jfj41pn9xvtbd3w/%5BLVS%5D+Oreimo+S2+-+ED13.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Oreimo S2 ED13</tt>]

=Links=
*[http://sourceforge.net/projects/lua-video-sync/ Projektseite auf Sourceforge]
*[http://forum.youka.de Forum]
[[Category:LVS|{{PAGENAME}}]]

LVS

2013-10-05T12:30:27Z

Youka: /* Grafikprogrammierung */

=LVS=
[[Datei:LVS.png|100px]]

LVS (''"Lua Video Sync"'') ist ein [[wikipedia:Video_filter|Filter]]-[[wikipedia:Plug-in_(computing)|Plugin]] für die populären Windows [[wikipedia:Frameserver|Frameserver]] [[wikipedia:Avisynth|Avisynth]], [[wikipedia:VirtualDub|VirtualDub]] und [[wikipedia:DirectShow|DirectShow]]. Durch Angabe eines Skriptes ([[wikipedia:Lua (programming language)|Lua]] Code enthaltend) als Parameter zum durch das Plugin registrierten Filter lassen sich Videobearbeitungen vornehmen (unter Avisynth auch Audio).

Die Macht der Lua Programmiersprache in Version 5.2, erweitert u.a. durch eine einfache, mächtige [[wikipedia:2D computer graphics|2D Grafik]]bibliothek, ermöglicht eindrucksvolle grafische Bearbeitung von streamenden Video Frames in hoher Geschwindigkeit und mit vielen Mitteln.

=Geschichte=
Die Entwicklung von LVS begann im Jahre 2013 durch den Fansubber "Youka".

Inspiriert von [http://forums.animesuki.com/showthread.php?t=52757 Overlua] wurde LVS als Nachfolger jenes unausgereiften Projektes beschlossen und sollte dessen großes Potenzial, programmatisch und direkt zu [[wikipedia:Rendering (computer graphics)|rendern]] und manipulieren, in einem frischen Gewand ausschöpfen. Als Alternative zu [[wikipedia:Adobe_After_Effects|AFX]] zum typesetten komplexerer Erscheinungen und als mächtigeres Karaoke-FX Werkzeug zu den bisherigen fand es ersten Nutzen bei Fansubbern.

=Definition=
LVS sollte in folgenden Schritten verstanden werden, da es all diese vereint.

==Frameserver plugin==
LVS ist kein eigenständiges Programm, sondern eine Erweiterung für Frameserver, um eine Bearbeitung zwischen der [[wikipedia:Decoder|Dekodierung]] eines Videos und dessen Ausgabe einzufügen. [[wikipedia:Video player (software)|Abspielprogramme]] und [[wikipedia:Encoder#Media|Kodierer]], welche Frameserver nutzen, können somit Filter auf das Eingangsmaterial anwenden, womit ein anderes Ausgangsmaterial entsteht. Nach Hinzufügen von LVS als Filter muss diesem ein Parameter angegeben werden: das Skript, das die Bearbeitung beschreibt.

Im Folgenden wird der Gebrauch von LVS mit den nutzbaren Frameservern gezeigt (dies schließt den Umgang mit den Frameservern selbst nicht ein).

===Avisynth===
Avisynth wird über eine Skriptsprache gesteuert, dementsprechend wird auch LVS eingefügt.
<nowiki>LoadPlugin("E:\LVS\plugin\LVS.dll") #Lädt Plugin 'LVS'/registriert Funktion 'LVS'

BlankClip() #Erstellt einen leeren Clip
LVS("hello.lua") #Führt Videobearbeitungsskript mit LVS aus</nowiki>
Die Definition der Funktion sieht wie folgt aus:

: '''clip = LVS(clip''''', string "video", string "audio", string "data"''')'''

:: '''clip''' (1): Ausgabe-Video
:: '''clip''' (2): Eingabe-Video
:: '''string "video"''': Skript zur Videobearbeitung
:: '''string "audio"''': Skript zur Audiobearbeitung
:: '''string "data"''': String zur Übergabe in Skript-Umgebung


===VirtualDub===
VirtualDubs Video-Filterung ist über das Menü "Video", Menüeintrag "Filters...", erreichbar. Über den Button "Add..." lässt sich LVS aus einer Liste von Filtern hinzufügen und anschließend über einen Dialog dessen Skript-Parameter eingeben. Sollte LVS noch nicht in genannter Liste verfügbar sein, kann über den Button "Load..." das Plugin geladen werden.

[[Datei:LVS - VirtualDub.png|800px]]

===DirectShow===
Filter müssen erst als COM Objekt in der Windows-Registry registriert werden, um sie nutzbar für DirectShow gebrauchende Programme zu machen. Dies ist möglich mit dem Kommandozeilen-Programm [[wikipedia:Regsvr32|regsvr32]]. Anschließend hängt es vom Anwenderprogramm ab, wie der Filter geladen wird.

Am Beispiel von [[wikipedia:Media_Player_Classic#Media_Player_Classic_-_Home_Cinema|MPC-HC]] kann über Menü ''View -> Options... -> External Filter'' LVS hinzugefügt, anschließend durch Setzen der Priorität auf 'Prefer' in die Filter-Kette gezwungen und nach Neustart des Programms über Menü ''Play -> Filters -> LVS'' konfiguriert werden.

[[Datei:LVS - DirectShow.png]]

==Skript-Basis==
Basis eines jeden LVS Skripts ist die Filter Funktion, durch welche Frames bzw. Samples geschickt werden.

Im Falle der Videobearbeitung muss diese '''GetFrame''' heißen. Der erste Aufrufparameter ist ein Frame als Bildobjekt, der zweite der Frame Index.
<nowiki>function GetFrame(frame, frame_i)
-- Füll mich
end</nowiki>
Bei Audiobearbeitung lautet der Funktionsname '''GetSamples'''. Der erste Aufrufparameter ist ein Table, die Samples enthaltend, der zweite die Table-Größe des letzteren und der dritte der Sample Index des ersten erhaltenen Samples (kanalübergreifend).
<nowiki>function GetSamples(samples, samples_n, sample_i)
-- Füll mich
end</nowiki>

Metainformationen eines Streams sind als globale Variablen verfügbar. Diese umfassen '''VIDEO_WIDTH''', '''VIDEO_HEIGHT''', '''VIDEO_HAS_ALPHA''', '''VIDEO_FPS''', '''VIDEO_FRAMES''', '''AUDIO_CHANNELS''', '''AUDIO_SAMPLE_RATE''', '''AUDIO_SAMPLES''' und '''USERDATA''' (letzteres ist das ''data'' Argument in Avisynth und ist in beiden Stream-Typen verfügbar).

==Grafikprogrammierung==
Frames werden als Bildobjekt empfangen, welches Teil der nutzbaren '''g2d''' Grafikbibliothek ist. Neben dem Bildobjekt gibt es andere Grafikobjekte, welche zur Bearbeitung gebraucht werden können. Um all diese zu verwenden, werden über Member-Funktionen ihre Attribute verändert.

Eine Liste der Grafikobjekte:
* '''Image''': Das Bild, um welches sich die gesamte Bearbeitung dreht.
* '''Context''': Der Bildkontext, nötig für die meisten Manipulationen am Bild.
* '''Source''': Die Farbquelle, welche die Einfärbung der zu malenden Form beschreibt.
* '''Matrix''': Die Matrix, anwendbar für Transformationen an Farbquelle und Form.

<blockquote style="color: red;">TODO</blockquote>

==Audioprogrammierung==
Samples werden im Format Float32, also einer Amplitudenangabe von -1.0 bis +1.0, und als channel interlaced, also in Kanäle-Blöcken, empfangen.

{| style="border-collapse: collapse; font-size: 8px; line-height: 5px; text-align: center;"
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S1
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S1
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S2
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S2
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S3
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S3
C2
|style="border: solid 3px; border-right-width: 0px; background-color: yellow; width: 24px;"|...
|}
;S = Sample Index
;C = Channel

Unter Zuhilfenahme der Metainformationen, wie die Anzahl an Kanälen und der Sample Rate, lässt sich mit ihnen arbeiten.

<blockquote style="color: red;">TODO</blockquote>

==Erweiterungen==
<blockquote style="color: red;">TODO</blockquote>

=Beispiele=
Folgende Beispiele sind Skripte zur Ausführung mit LVS.
==Video==
Folgende Skripte dienen der Videobearbeitung.
===Minimal===
Farben aller Frames werden invertiert.
<nowiki>function GetFrame(frame, frame_i)
frame:invert()
end</nowiki>

===Zeichnen===
Zeichnet eine gelbe Aussenlinie eines Halbkreises.
<nowiki>function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_move_to(100, 100)
ctx:path_line_to(200, 100)
ctx:path_add_arc(150, 100, 50, 0, -180)
ctx:set_line_width(5)
ctx:set_line_join("BEVEL")
ctx:set_source(g2du.yellow)
ctx:stroke()
end</nowiki>

===Text===
"Hello world\nfrom LVS!" mit einem rot-zu-grün Farbverlauf.
<nowiki>local pos = {
x = 100,
y = 100
}
local text_properties = {
"Hello world\nfrom LVS!", -- Text
"Arial", -- Font
50, -- Size
true, -- Bold?
true, -- Italic?
true, -- Underline?
true -- Strikeout?
}
local text_extents = {g2d.text_extents(table.unpack(text_properties))}

function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_add_text(pos.x, pos.y, table.unpack(text_properties))
ctx:set_source(
g2d.create_lgradient(pos.x, pos.y, pos.x + text_extents[1], pos.y + text_extents[2])
:add_color(0, 1,0,0)
:add_color(1, 0,1,0)
)
ctx:fill()
end</nowiki>

===Karaoke===
<nowiki>-- Parse ASS file and fill global tables
ass.load("my_ktime.ass")

-- Roumaji & Kanji
local function roumaji_kanji(ctx, ms, line)
-- Iterate through sylables
for _, syl in ipairs(line.styleref.alignment < 7 and line.chars or line.syls) do -- Use characters in case of kanjis
-- Set color dependent on sylable activity
ctx:set_source(ms >= syl.start_time and ms < syl.end_time and g2du.red or g2du.yellow)
-- Draw sylable text
ctx:path_add_text(syl.x, syl.y, syl.text, ass.unpack_font(line.styleref))
ctx:fill()
ctx:path_clear()
end
end

-- Subtitle
local function subtitle(ctx, line)
-- Draw line text
ctx:path_add_text(line.x, line.y, line.text, ass.unpack_font(line.styleref))
ctx:set_source(g2du.yellow)
ctx:fill()
ctx:path_clear()
end

-- Process frames
function GetFrame(frame, frame_i)
-- Create drawing context for frame
local ctx = frame:get_context()
-- Get frame time
local ms = frame_i / VIDEO_FPS * 1000
-- Look for frame-related ASS lines
for _, line in ipairs(lines) do
if ms >= line.start_time and ms < line.end_time then
-- Draw ASS line
if line.styleref.alignment > 3 then
roumaji_kanji(ctx, ms, line)
else
subtitle(ctx, line)
end
end
end
end</nowiki>
==Audio==
Folgende Skripte dienen der Audiobearbeitung.
===Minimal===
Erstellt ein Rauschen.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
for i = 1, samples_n do
samples[i] = math.random(-1000,1000) / 1000
end
end</nowiki>

==Kanal-Tausch==
Tauscht bei Stereo den linken mit dem rechten Kanal.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
if AUDIO_CHANNELS == 2 then
for i = 1, samples_n, 2 do
local temp = samples[i]
samples[i] = samples[i+1]
samples[i+1] = temp
end
end
end</nowiki>

===Audio zu Text===
Schreibt Audiodaten als Text in eine Datei.
<nowiki>local file = io.open("audio.txt", "w")
file:write(string.format("Channels: %d\nSample rate: %d\nSamples: %d\n\n", AUDIO_CHANNELS, AUDIO_SAMPLE_RATE, AUDIO_SAMPLES))

function GetSamples(samples, samples_n, start_sample_i)
file:write(table.concat(samples, "\n"))
file:write("\n")
end</nowiki>

=Videos=
[http://www.mediafire.com/download/i3reijc799edi6v/%5BLVS%5D+Samples.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Karaoke Beispiele</tt>]

[http://www.mediafire.com/download/jfj41pn9xvtbd3w/%5BLVS%5D+Oreimo+S2+-+ED13.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Oreimo S2 ED13</tt>]

=Links=
*[http://sourceforge.net/projects/lua-video-sync/ Projektseite auf Sourceforge]
*[http://forum.youka.de Forum]
[[Category:LVS|{{PAGENAME}}]]

LVS

2013-10-05T12:27:32Z

Youka: /* Avisynth */

=LVS=
[[Datei:LVS.png|100px]]

LVS (''"Lua Video Sync"'') ist ein [[wikipedia:Video_filter|Filter]]-[[wikipedia:Plug-in_(computing)|Plugin]] für die populären Windows [[wikipedia:Frameserver|Frameserver]] [[wikipedia:Avisynth|Avisynth]], [[wikipedia:VirtualDub|VirtualDub]] und [[wikipedia:DirectShow|DirectShow]]. Durch Angabe eines Skriptes ([[wikipedia:Lua (programming language)|Lua]] Code enthaltend) als Parameter zum durch das Plugin registrierten Filter lassen sich Videobearbeitungen vornehmen (unter Avisynth auch Audio).

Die Macht der Lua Programmiersprache in Version 5.2, erweitert u.a. durch eine einfache, mächtige [[wikipedia:2D computer graphics|2D Grafik]]bibliothek, ermöglicht eindrucksvolle grafische Bearbeitung von streamenden Video Frames in hoher Geschwindigkeit und mit vielen Mitteln.

=Geschichte=
Die Entwicklung von LVS begann im Jahre 2013 durch den Fansubber "Youka".

Inspiriert von [http://forums.animesuki.com/showthread.php?t=52757 Overlua] wurde LVS als Nachfolger jenes unausgereiften Projektes beschlossen und sollte dessen großes Potenzial, programmatisch und direkt zu [[wikipedia:Rendering (computer graphics)|rendern]] und manipulieren, in einem frischen Gewand ausschöpfen. Als Alternative zu [[wikipedia:Adobe_After_Effects|AFX]] zum typesetten komplexerer Erscheinungen und als mächtigeres Karaoke-FX Werkzeug zu den bisherigen fand es ersten Nutzen bei Fansubbern.

=Definition=
LVS sollte in folgenden Schritten verstanden werden, da es all diese vereint.

==Frameserver plugin==
LVS ist kein eigenständiges Programm, sondern eine Erweiterung für Frameserver, um eine Bearbeitung zwischen der [[wikipedia:Decoder|Dekodierung]] eines Videos und dessen Ausgabe einzufügen. [[wikipedia:Video player (software)|Abspielprogramme]] und [[wikipedia:Encoder#Media|Kodierer]], welche Frameserver nutzen, können somit Filter auf das Eingangsmaterial anwenden, womit ein anderes Ausgangsmaterial entsteht. Nach Hinzufügen von LVS als Filter muss diesem ein Parameter angegeben werden: das Skript, das die Bearbeitung beschreibt.

Im Folgenden wird der Gebrauch von LVS mit den nutzbaren Frameservern gezeigt (dies schließt den Umgang mit den Frameservern selbst nicht ein).

===Avisynth===
Avisynth wird über eine Skriptsprache gesteuert, dementsprechend wird auch LVS eingefügt.
<nowiki>LoadPlugin("E:\LVS\plugin\LVS.dll") #Lädt Plugin 'LVS'/registriert Funktion 'LVS'

BlankClip() #Erstellt einen leeren Clip
LVS("hello.lua") #Führt Videobearbeitungsskript mit LVS aus</nowiki>
Die Definition der Funktion sieht wie folgt aus:

: '''clip = LVS(clip''''', string "video", string "audio", string "data"''')'''

:: '''clip''' (1): Ausgabe-Video
:: '''clip''' (2): Eingabe-Video
:: '''string "video"''': Skript zur Videobearbeitung
:: '''string "audio"''': Skript zur Audiobearbeitung
:: '''string "data"''': String zur Übergabe in Skript-Umgebung


===VirtualDub===
VirtualDubs Video-Filterung ist über das Menü "Video", Menüeintrag "Filters...", erreichbar. Über den Button "Add..." lässt sich LVS aus einer Liste von Filtern hinzufügen und anschließend über einen Dialog dessen Skript-Parameter eingeben. Sollte LVS noch nicht in genannter Liste verfügbar sein, kann über den Button "Load..." das Plugin geladen werden.

[[Datei:LVS - VirtualDub.png|800px]]

===DirectShow===
Filter müssen erst als COM Objekt in der Windows-Registry registriert werden, um sie nutzbar für DirectShow gebrauchende Programme zu machen. Dies ist möglich mit dem Kommandozeilen-Programm [[wikipedia:Regsvr32|regsvr32]]. Anschließend hängt es vom Anwenderprogramm ab, wie der Filter geladen wird.

Am Beispiel von [[wikipedia:Media_Player_Classic#Media_Player_Classic_-_Home_Cinema|MPC-HC]] kann über Menü ''View -> Options... -> External Filter'' LVS hinzugefügt, anschließend durch Setzen der Priorität auf 'Prefer' in die Filter-Kette gezwungen und nach Neustart des Programms über Menü ''Play -> Filters -> LVS'' konfiguriert werden.

[[Datei:LVS - DirectShow.png]]

==Skript-Basis==
Basis eines jeden LVS Skripts ist die Filter Funktion, durch welche Frames bzw. Samples geschickt werden.

Im Falle der Videobearbeitung muss diese '''GetFrame''' heißen. Der erste Aufrufparameter ist ein Frame als Bildobjekt, der zweite der Frame Index.
<nowiki>function GetFrame(frame, frame_i)
-- Füll mich
end</nowiki>
Bei Audiobearbeitung lautet der Funktionsname '''GetSamples'''. Der erste Aufrufparameter ist ein Table, die Samples enthaltend, der zweite die Table-Größe des letzteren und der dritte der Sample Index des ersten erhaltenen Samples (kanalübergreifend).
<nowiki>function GetSamples(samples, samples_n, sample_i)
-- Füll mich
end</nowiki>

Metainformationen eines Streams sind als globale Variablen verfügbar. Diese umfassen '''VIDEO_WIDTH''', '''VIDEO_HEIGHT''', '''VIDEO_HAS_ALPHA''', '''VIDEO_FPS''', '''VIDEO_FRAMES''', '''AUDIO_CHANNELS''', '''AUDIO_SAMPLE_RATE''', '''AUDIO_SAMPLES''' und '''USERDATA''' (letzteres ist das ''data'' Argument in Avisynth und ist in beiden Stream-Typen verfügbar).

==Grafikprogrammierung==
Frames werden als Bildobjekt empfangen, welches Teil der nutzbaren '''g2d''' Grafikbibliothek ist. Neben dem Bildobjekt gibt es andere Grafikobjekte, welche zur Bearbeitung gebraucht werden. Um all diese zu verwenden, werden über Member-Funktionen ihre Attribute verändert.

Eine Liste der Grafikobjekte:
* '''Image''': Das Bild, um welches sich die gesamte Bearbeitung dreht.
* '''Context''': Der Bildkontext, nötig für die meisten Manipulationen am Bild.
* '''Source''': Die Farbquelle, welche die Einfärbung der zu malenden Form beschreibt.
* '''Matrix''': Die Matrix, anwendbar für Transformationen an Farbquelle und Form.

<blockquote style="color: red;">TODO</blockquote>

==Audioprogrammierung==
Samples werden im Format Float32, also einer Amplitudenangabe von -1.0 bis +1.0, und als channel interlaced, also in Kanäle-Blöcken, empfangen.

{| style="border-collapse: collapse; font-size: 8px; line-height: 5px; text-align: center;"
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S1
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S1
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S2
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S2
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S3
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S3
C2
|style="border: solid 3px; border-right-width: 0px; background-color: yellow; width: 24px;"|...
|}
;S = Sample Index
;C = Channel

Unter Zuhilfenahme der Metainformationen, wie die Anzahl an Kanälen und der Sample Rate, lässt sich mit ihnen arbeiten.

<blockquote style="color: red;">TODO</blockquote>

==Erweiterungen==
<blockquote style="color: red;">TODO</blockquote>

=Beispiele=
Folgende Beispiele sind Skripte zur Ausführung mit LVS.
==Video==
Folgende Skripte dienen der Videobearbeitung.
===Minimal===
Farben aller Frames werden invertiert.
<nowiki>function GetFrame(frame, frame_i)
frame:invert()
end</nowiki>

===Zeichnen===
Zeichnet eine gelbe Aussenlinie eines Halbkreises.
<nowiki>function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_move_to(100, 100)
ctx:path_line_to(200, 100)
ctx:path_add_arc(150, 100, 50, 0, -180)
ctx:set_line_width(5)
ctx:set_line_join("BEVEL")
ctx:set_source(g2du.yellow)
ctx:stroke()
end</nowiki>

===Text===
"Hello world\nfrom LVS!" mit einem rot-zu-grün Farbverlauf.
<nowiki>local pos = {
x = 100,
y = 100
}
local text_properties = {
"Hello world\nfrom LVS!", -- Text
"Arial", -- Font
50, -- Size
true, -- Bold?
true, -- Italic?
true, -- Underline?
true -- Strikeout?
}
local text_extents = {g2d.text_extents(table.unpack(text_properties))}

function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_add_text(pos.x, pos.y, table.unpack(text_properties))
ctx:set_source(
g2d.create_lgradient(pos.x, pos.y, pos.x + text_extents[1], pos.y + text_extents[2])
:add_color(0, 1,0,0)
:add_color(1, 0,1,0)
)
ctx:fill()
end</nowiki>

===Karaoke===
<nowiki>-- Parse ASS file and fill global tables
ass.load("my_ktime.ass")

-- Roumaji & Kanji
local function roumaji_kanji(ctx, ms, line)
-- Iterate through sylables
for _, syl in ipairs(line.styleref.alignment < 7 and line.chars or line.syls) do -- Use characters in case of kanjis
-- Set color dependent on sylable activity
ctx:set_source(ms >= syl.start_time and ms < syl.end_time and g2du.red or g2du.yellow)
-- Draw sylable text
ctx:path_add_text(syl.x, syl.y, syl.text, ass.unpack_font(line.styleref))
ctx:fill()
ctx:path_clear()
end
end

-- Subtitle
local function subtitle(ctx, line)
-- Draw line text
ctx:path_add_text(line.x, line.y, line.text, ass.unpack_font(line.styleref))
ctx:set_source(g2du.yellow)
ctx:fill()
ctx:path_clear()
end

-- Process frames
function GetFrame(frame, frame_i)
-- Create drawing context for frame
local ctx = frame:get_context()
-- Get frame time
local ms = frame_i / VIDEO_FPS * 1000
-- Look for frame-related ASS lines
for _, line in ipairs(lines) do
if ms >= line.start_time and ms < line.end_time then
-- Draw ASS line
if line.styleref.alignment > 3 then
roumaji_kanji(ctx, ms, line)
else
subtitle(ctx, line)
end
end
end
end</nowiki>
==Audio==
Folgende Skripte dienen der Audiobearbeitung.
===Minimal===
Erstellt ein Rauschen.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
for i = 1, samples_n do
samples[i] = math.random(-1000,1000) / 1000
end
end</nowiki>

==Kanal-Tausch==
Tauscht bei Stereo den linken mit dem rechten Kanal.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
if AUDIO_CHANNELS == 2 then
for i = 1, samples_n, 2 do
local temp = samples[i]
samples[i] = samples[i+1]
samples[i+1] = temp
end
end
end</nowiki>

===Audio zu Text===
Schreibt Audiodaten als Text in eine Datei.
<nowiki>local file = io.open("audio.txt", "w")
file:write(string.format("Channels: %d\nSample rate: %d\nSamples: %d\n\n", AUDIO_CHANNELS, AUDIO_SAMPLE_RATE, AUDIO_SAMPLES))

function GetSamples(samples, samples_n, start_sample_i)
file:write(table.concat(samples, "\n"))
file:write("\n")
end</nowiki>

=Videos=
[http://www.mediafire.com/download/i3reijc799edi6v/%5BLVS%5D+Samples.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Karaoke Beispiele</tt>]

[http://www.mediafire.com/download/jfj41pn9xvtbd3w/%5BLVS%5D+Oreimo+S2+-+ED13.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Oreimo S2 ED13</tt>]

=Links=
*[http://sourceforge.net/projects/lua-video-sync/ Projektseite auf Sourceforge]
*[http://forum.youka.de Forum]
[[Category:LVS|{{PAGENAME}}]]

LVS

2013-10-05T12:25:36Z

Youka: /* Audio */

=LVS=
[[Datei:LVS.png|100px]]

LVS (''"Lua Video Sync"'') ist ein [[wikipedia:Video_filter|Filter]]-[[wikipedia:Plug-in_(computing)|Plugin]] für die populären Windows [[wikipedia:Frameserver|Frameserver]] [[wikipedia:Avisynth|Avisynth]], [[wikipedia:VirtualDub|VirtualDub]] und [[wikipedia:DirectShow|DirectShow]]. Durch Angabe eines Skriptes ([[wikipedia:Lua (programming language)|Lua]] Code enthaltend) als Parameter zum durch das Plugin registrierten Filter lassen sich Videobearbeitungen vornehmen (unter Avisynth auch Audio).

Die Macht der Lua Programmiersprache in Version 5.2, erweitert u.a. durch eine einfache, mächtige [[wikipedia:2D computer graphics|2D Grafik]]bibliothek, ermöglicht eindrucksvolle grafische Bearbeitung von streamenden Video Frames in hoher Geschwindigkeit und mit vielen Mitteln.

=Geschichte=
Die Entwicklung von LVS begann im Jahre 2013 durch den Fansubber "Youka".

Inspiriert von [http://forums.animesuki.com/showthread.php?t=52757 Overlua] wurde LVS als Nachfolger jenes unausgereiften Projektes beschlossen und sollte dessen großes Potenzial, programmatisch und direkt zu [[wikipedia:Rendering (computer graphics)|rendern]] und manipulieren, in einem frischen Gewand ausschöpfen. Als Alternative zu [[wikipedia:Adobe_After_Effects|AFX]] zum typesetten komplexerer Erscheinungen und als mächtigeres Karaoke-FX Werkzeug zu den bisherigen fand es ersten Nutzen bei Fansubbern.

=Definition=
LVS sollte in folgenden Schritten verstanden werden, da es all diese vereint.

==Frameserver plugin==
LVS ist kein eigenständiges Programm, sondern eine Erweiterung für Frameserver, um eine Bearbeitung zwischen der [[wikipedia:Decoder|Dekodierung]] eines Videos und dessen Ausgabe einzufügen. [[wikipedia:Video player (software)|Abspielprogramme]] und [[wikipedia:Encoder#Media|Kodierer]], welche Frameserver nutzen, können somit Filter auf das Eingangsmaterial anwenden, womit ein anderes Ausgangsmaterial entsteht. Nach Hinzufügen von LVS als Filter muss diesem ein Parameter angegeben werden: das Skript, das die Bearbeitung beschreibt.

Im Folgenden wird der Gebrauch von LVS mit den nutzbaren Frameservern gezeigt (dies schließt den Umgang mit den Frameservern selbst nicht ein).

===Avisynth===
Avisynth wird über eine Skriptsprache gesteuert, dementsprechend wird auch LVS eingefügt.
<nowiki>LoadPlugin("E:\LVS\plugin\LVS.dll") #Lädt Plugin 'LVS'/registriert Funktion 'LVS'

BlankClip() #Erstellt einen leeren Clip
LVS("hello.lua") #Führt Videobearbeitungsskript mit LVS aus</nowiki>
Die Definition der Funktion sieht wie folgt aus:

: '''clip = LVS(clip''''', string "video", string "audio", string "data"''')'''

:: '''clip''' (1): Ausgabe-Video
:: '''clip''' (2): Eingabe-Video
:: '''string "video"''' (2): Skript zur Videobearbeitung
:: '''string "audio"''' (2): Skript zur Audiobearbeitung
:: '''string "data"''' (2): String zur Übergabe in Skript-Umgebung


===VirtualDub===
VirtualDubs Video-Filterung ist über das Menü "Video", Menüeintrag "Filters...", erreichbar. Über den Button "Add..." lässt sich LVS aus einer Liste von Filtern hinzufügen und anschließend über einen Dialog dessen Skript-Parameter eingeben. Sollte LVS noch nicht in genannter Liste verfügbar sein, kann über den Button "Load..." das Plugin geladen werden.

[[Datei:LVS - VirtualDub.png|800px]]

===DirectShow===
Filter müssen erst als COM Objekt in der Windows-Registry registriert werden, um sie nutzbar für DirectShow gebrauchende Programme zu machen. Dies ist möglich mit dem Kommandozeilen-Programm [[wikipedia:Regsvr32|regsvr32]]. Anschließend hängt es vom Anwenderprogramm ab, wie der Filter geladen wird.

Am Beispiel von [[wikipedia:Media_Player_Classic#Media_Player_Classic_-_Home_Cinema|MPC-HC]] kann über Menü ''View -> Options... -> External Filter'' LVS hinzugefügt, anschließend durch Setzen der Priorität auf 'Prefer' in die Filter-Kette gezwungen und nach Neustart des Programms über Menü ''Play -> Filters -> LVS'' konfiguriert werden.

[[Datei:LVS - DirectShow.png]]

==Skript-Basis==
Basis eines jeden LVS Skripts ist die Filter Funktion, durch welche Frames bzw. Samples geschickt werden.

Im Falle der Videobearbeitung muss diese '''GetFrame''' heißen. Der erste Aufrufparameter ist ein Frame als Bildobjekt, der zweite der Frame Index.
<nowiki>function GetFrame(frame, frame_i)
-- Füll mich
end</nowiki>
Bei Audiobearbeitung lautet der Funktionsname '''GetSamples'''. Der erste Aufrufparameter ist ein Table, die Samples enthaltend, der zweite die Table-Größe des letzteren und der dritte der Sample Index des ersten erhaltenen Samples (kanalübergreifend).
<nowiki>function GetSamples(samples, samples_n, sample_i)
-- Füll mich
end</nowiki>

Metainformationen eines Streams sind als globale Variablen verfügbar. Diese umfassen '''VIDEO_WIDTH''', '''VIDEO_HEIGHT''', '''VIDEO_HAS_ALPHA''', '''VIDEO_FPS''', '''VIDEO_FRAMES''', '''AUDIO_CHANNELS''', '''AUDIO_SAMPLE_RATE''', '''AUDIO_SAMPLES''' und '''USERDATA''' (letzteres ist das ''data'' Argument in Avisynth und ist in beiden Stream-Typen verfügbar).

==Grafikprogrammierung==
Frames werden als Bildobjekt empfangen, welches Teil der nutzbaren '''g2d''' Grafikbibliothek ist. Neben dem Bildobjekt gibt es andere Grafikobjekte, welche zur Bearbeitung gebraucht werden. Um all diese zu verwenden, werden über Member-Funktionen ihre Attribute verändert.

Eine Liste der Grafikobjekte:
* '''Image''': Das Bild, um welches sich die gesamte Bearbeitung dreht.
* '''Context''': Der Bildkontext, nötig für die meisten Manipulationen am Bild.
* '''Source''': Die Farbquelle, welche die Einfärbung der zu malenden Form beschreibt.
* '''Matrix''': Die Matrix, anwendbar für Transformationen an Farbquelle und Form.

<blockquote style="color: red;">TODO</blockquote>

==Audioprogrammierung==
Samples werden im Format Float32, also einer Amplitudenangabe von -1.0 bis +1.0, und als channel interlaced, also in Kanäle-Blöcken, empfangen.

{| style="border-collapse: collapse; font-size: 8px; line-height: 5px; text-align: center;"
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S1
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S1
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S2
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S2
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S3
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S3
C2
|style="border: solid 3px; border-right-width: 0px; background-color: yellow; width: 24px;"|...
|}
;S = Sample Index
;C = Channel

Unter Zuhilfenahme der Metainformationen, wie die Anzahl an Kanälen und der Sample Rate, lässt sich mit ihnen arbeiten.

<blockquote style="color: red;">TODO</blockquote>

==Erweiterungen==
<blockquote style="color: red;">TODO</blockquote>

=Beispiele=
Folgende Beispiele sind Skripte zur Ausführung mit LVS.
==Video==
Folgende Skripte dienen der Videobearbeitung.
===Minimal===
Farben aller Frames werden invertiert.
<nowiki>function GetFrame(frame, frame_i)
frame:invert()
end</nowiki>

===Zeichnen===
Zeichnet eine gelbe Aussenlinie eines Halbkreises.
<nowiki>function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_move_to(100, 100)
ctx:path_line_to(200, 100)
ctx:path_add_arc(150, 100, 50, 0, -180)
ctx:set_line_width(5)
ctx:set_line_join("BEVEL")
ctx:set_source(g2du.yellow)
ctx:stroke()
end</nowiki>

===Text===
"Hello world\nfrom LVS!" mit einem rot-zu-grün Farbverlauf.
<nowiki>local pos = {
x = 100,
y = 100
}
local text_properties = {
"Hello world\nfrom LVS!", -- Text
"Arial", -- Font
50, -- Size
true, -- Bold?
true, -- Italic?
true, -- Underline?
true -- Strikeout?
}
local text_extents = {g2d.text_extents(table.unpack(text_properties))}

function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_add_text(pos.x, pos.y, table.unpack(text_properties))
ctx:set_source(
g2d.create_lgradient(pos.x, pos.y, pos.x + text_extents[1], pos.y + text_extents[2])
:add_color(0, 1,0,0)
:add_color(1, 0,1,0)
)
ctx:fill()
end</nowiki>

===Karaoke===
<nowiki>-- Parse ASS file and fill global tables
ass.load("my_ktime.ass")

-- Roumaji & Kanji
local function roumaji_kanji(ctx, ms, line)
-- Iterate through sylables
for _, syl in ipairs(line.styleref.alignment < 7 and line.chars or line.syls) do -- Use characters in case of kanjis
-- Set color dependent on sylable activity
ctx:set_source(ms >= syl.start_time and ms < syl.end_time and g2du.red or g2du.yellow)
-- Draw sylable text
ctx:path_add_text(syl.x, syl.y, syl.text, ass.unpack_font(line.styleref))
ctx:fill()
ctx:path_clear()
end
end

-- Subtitle
local function subtitle(ctx, line)
-- Draw line text
ctx:path_add_text(line.x, line.y, line.text, ass.unpack_font(line.styleref))
ctx:set_source(g2du.yellow)
ctx:fill()
ctx:path_clear()
end

-- Process frames
function GetFrame(frame, frame_i)
-- Create drawing context for frame
local ctx = frame:get_context()
-- Get frame time
local ms = frame_i / VIDEO_FPS * 1000
-- Look for frame-related ASS lines
for _, line in ipairs(lines) do
if ms >= line.start_time and ms < line.end_time then
-- Draw ASS line
if line.styleref.alignment > 3 then
roumaji_kanji(ctx, ms, line)
else
subtitle(ctx, line)
end
end
end
end</nowiki>
==Audio==
Folgende Skripte dienen der Audiobearbeitung.
===Minimal===
Erstellt ein Rauschen.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
for i = 1, samples_n do
samples[i] = math.random(-1000,1000) / 1000
end
end</nowiki>

==Kanal-Tausch==
Tauscht bei Stereo den linken mit dem rechten Kanal.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
if AUDIO_CHANNELS == 2 then
for i = 1, samples_n, 2 do
local temp = samples[i]
samples[i] = samples[i+1]
samples[i+1] = temp
end
end
end</nowiki>

===Audio zu Text===
Schreibt Audiodaten als Text in eine Datei.
<nowiki>local file = io.open("audio.txt", "w")
file:write(string.format("Channels: %d\nSample rate: %d\nSamples: %d\n\n", AUDIO_CHANNELS, AUDIO_SAMPLE_RATE, AUDIO_SAMPLES))

function GetSamples(samples, samples_n, start_sample_i)
file:write(table.concat(samples, "\n"))
file:write("\n")
end</nowiki>

=Videos=
[http://www.mediafire.com/download/i3reijc799edi6v/%5BLVS%5D+Samples.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Karaoke Beispiele</tt>]

[http://www.mediafire.com/download/jfj41pn9xvtbd3w/%5BLVS%5D+Oreimo+S2+-+ED13.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Oreimo S2 ED13</tt>]

=Links=
*[http://sourceforge.net/projects/lua-video-sync/ Projektseite auf Sourceforge]
*[http://forum.youka.de Forum]
[[Category:LVS|{{PAGENAME}}]]

LVS

2013-10-05T12:06:31Z

Youka:

=LVS=
[[Datei:LVS.png|100px]]

LVS (''"Lua Video Sync"'') ist ein [[wikipedia:Video_filter|Filter]]-[[wikipedia:Plug-in_(computing)|Plugin]] für die populären Windows [[wikipedia:Frameserver|Frameserver]] [[wikipedia:Avisynth|Avisynth]], [[wikipedia:VirtualDub|VirtualDub]] und [[wikipedia:DirectShow|DirectShow]]. Durch Angabe eines Skriptes ([[wikipedia:Lua (programming language)|Lua]] Code enthaltend) als Parameter zum durch das Plugin registrierten Filter lassen sich Videobearbeitungen vornehmen (unter Avisynth auch Audio).

Die Macht der Lua Programmiersprache in Version 5.2, erweitert u.a. durch eine einfache, mächtige [[wikipedia:2D computer graphics|2D Grafik]]bibliothek, ermöglicht eindrucksvolle grafische Bearbeitung von streamenden Video Frames in hoher Geschwindigkeit und mit vielen Mitteln.

=Geschichte=
Die Entwicklung von LVS begann im Jahre 2013 durch den Fansubber "Youka".

Inspiriert von [http://forums.animesuki.com/showthread.php?t=52757 Overlua] wurde LVS als Nachfolger jenes unausgereiften Projektes beschlossen und sollte dessen großes Potenzial, programmatisch und direkt zu [[wikipedia:Rendering (computer graphics)|rendern]] und manipulieren, in einem frischen Gewand ausschöpfen. Als Alternative zu [[wikipedia:Adobe_After_Effects|AFX]] zum typesetten komplexerer Erscheinungen und als mächtigeres Karaoke-FX Werkzeug zu den bisherigen fand es ersten Nutzen bei Fansubbern.

=Definition=
LVS sollte in folgenden Schritten verstanden werden, da es all diese vereint.

==Frameserver plugin==
LVS ist kein eigenständiges Programm, sondern eine Erweiterung für Frameserver, um eine Bearbeitung zwischen der [[wikipedia:Decoder|Dekodierung]] eines Videos und dessen Ausgabe einzufügen. [[wikipedia:Video player (software)|Abspielprogramme]] und [[wikipedia:Encoder#Media|Kodierer]], welche Frameserver nutzen, können somit Filter auf das Eingangsmaterial anwenden, womit ein anderes Ausgangsmaterial entsteht. Nach Hinzufügen von LVS als Filter muss diesem ein Parameter angegeben werden: das Skript, das die Bearbeitung beschreibt.

Im Folgenden wird der Gebrauch von LVS mit den nutzbaren Frameservern gezeigt (dies schließt den Umgang mit den Frameservern selbst nicht ein).

===Avisynth===
Avisynth wird über eine Skriptsprache gesteuert, dementsprechend wird auch LVS eingefügt.
<nowiki>LoadPlugin("E:\LVS\plugin\LVS.dll") #Lädt Plugin 'LVS'/registriert Funktion 'LVS'

BlankClip() #Erstellt einen leeren Clip
LVS("hello.lua") #Führt Videobearbeitungsskript mit LVS aus</nowiki>
Die Definition der Funktion sieht wie folgt aus:

: '''clip = LVS(clip''''', string "video", string "audio", string "data"''')'''

:: '''clip''' (1): Ausgabe-Video
:: '''clip''' (2): Eingabe-Video
:: '''string "video"''' (2): Skript zur Videobearbeitung
:: '''string "audio"''' (2): Skript zur Audiobearbeitung
:: '''string "data"''' (2): String zur Übergabe in Skript-Umgebung


===VirtualDub===
VirtualDubs Video-Filterung ist über das Menü "Video", Menüeintrag "Filters...", erreichbar. Über den Button "Add..." lässt sich LVS aus einer Liste von Filtern hinzufügen und anschließend über einen Dialog dessen Skript-Parameter eingeben. Sollte LVS noch nicht in genannter Liste verfügbar sein, kann über den Button "Load..." das Plugin geladen werden.

[[Datei:LVS - VirtualDub.png|800px]]

===DirectShow===
Filter müssen erst als COM Objekt in der Windows-Registry registriert werden, um sie nutzbar für DirectShow gebrauchende Programme zu machen. Dies ist möglich mit dem Kommandozeilen-Programm [[wikipedia:Regsvr32|regsvr32]]. Anschließend hängt es vom Anwenderprogramm ab, wie der Filter geladen wird.

Am Beispiel von [[wikipedia:Media_Player_Classic#Media_Player_Classic_-_Home_Cinema|MPC-HC]] kann über Menü ''View -> Options... -> External Filter'' LVS hinzugefügt, anschließend durch Setzen der Priorität auf 'Prefer' in die Filter-Kette gezwungen und nach Neustart des Programms über Menü ''Play -> Filters -> LVS'' konfiguriert werden.

[[Datei:LVS - DirectShow.png]]

==Skript-Basis==
Basis eines jeden LVS Skripts ist die Filter Funktion, durch welche Frames bzw. Samples geschickt werden.

Im Falle der Videobearbeitung muss diese '''GetFrame''' heißen. Der erste Aufrufparameter ist ein Frame als Bildobjekt, der zweite der Frame Index.
<nowiki>function GetFrame(frame, frame_i)
-- Füll mich
end</nowiki>
Bei Audiobearbeitung lautet der Funktionsname '''GetSamples'''. Der erste Aufrufparameter ist ein Table, die Samples enthaltend, der zweite die Table-Größe des letzteren und der dritte der Sample Index des ersten erhaltenen Samples (kanalübergreifend).
<nowiki>function GetSamples(samples, samples_n, sample_i)
-- Füll mich
end</nowiki>

Metainformationen eines Streams sind als globale Variablen verfügbar. Diese umfassen '''VIDEO_WIDTH''', '''VIDEO_HEIGHT''', '''VIDEO_HAS_ALPHA''', '''VIDEO_FPS''', '''VIDEO_FRAMES''', '''AUDIO_CHANNELS''', '''AUDIO_SAMPLE_RATE''', '''AUDIO_SAMPLES''' und '''USERDATA''' (letzteres ist das ''data'' Argument in Avisynth und ist in beiden Stream-Typen verfügbar).

==Grafikprogrammierung==
Frames werden als Bildobjekt empfangen, welches Teil der nutzbaren '''g2d''' Grafikbibliothek ist. Neben dem Bildobjekt gibt es andere Grafikobjekte, welche zur Bearbeitung gebraucht werden. Um all diese zu verwenden, werden über Member-Funktionen ihre Attribute verändert.

Eine Liste der Grafikobjekte:
* '''Image''': Das Bild, um welches sich die gesamte Bearbeitung dreht.
* '''Context''': Der Bildkontext, nötig für die meisten Manipulationen am Bild.
* '''Source''': Die Farbquelle, welche die Einfärbung der zu malenden Form beschreibt.
* '''Matrix''': Die Matrix, anwendbar für Transformationen an Farbquelle und Form.

<blockquote style="color: red;">TODO</blockquote>

==Audioprogrammierung==
Samples werden im Format Float32, also einer Amplitudenangabe von -1.0 bis +1.0, und als channel interlaced, also in Kanäle-Blöcken, empfangen.

{| style="border-collapse: collapse; font-size: 8px; line-height: 5px; text-align: center;"
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S1
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S1
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S2
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S2
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S3
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S3
C2
|style="border: solid 3px; border-right-width: 0px; background-color: yellow; width: 24px;"|...
|}
;S = Sample Index
;C = Channel

Unter Zuhilfenahme der Metainformationen, wie die Anzahl an Kanälen und der Sample Rate, lässt sich mit ihnen arbeiten.

<blockquote style="color: red;">TODO</blockquote>

==Erweiterungen==
<blockquote style="color: red;">TODO</blockquote>

=Beispiele=
Folgende Beispiele sind Skripte zur Ausführung mit LVS.
==Video==
Folgende Skripte dienen der Videobearbeitung.
===Minimal===
Farben aller Frames werden invertiert.
<nowiki>function GetFrame(frame, frame_i)
frame:invert()
end</nowiki>

===Zeichnen===
Zeichnet eine gelbe Aussenlinie eines Halbkreises.
<nowiki>function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_move_to(100, 100)
ctx:path_line_to(200, 100)
ctx:path_add_arc(150, 100, 50, 0, -180)
ctx:set_line_width(5)
ctx:set_line_join("BEVEL")
ctx:set_source(g2du.yellow)
ctx:stroke()
end</nowiki>

===Text===
"Hello world\nfrom LVS!" mit einem rot-zu-grün Farbverlauf.
<nowiki>local pos = {
x = 100,
y = 100
}
local text_properties = {
"Hello world\nfrom LVS!", -- Text
"Arial", -- Font
50, -- Size
true, -- Bold?
true, -- Italic?
true, -- Underline?
true -- Strikeout?
}
local text_extents = {g2d.text_extents(table.unpack(text_properties))}

function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_add_text(pos.x, pos.y, table.unpack(text_properties))
ctx:set_source(
g2d.create_lgradient(pos.x, pos.y, pos.x + text_extents[1], pos.y + text_extents[2])
:add_color(0, 1,0,0)
:add_color(1, 0,1,0)
)
ctx:fill()
end</nowiki>

===Karaoke===
<nowiki>-- Parse ASS file and fill global tables
ass.load("my_ktime.ass")

-- Roumaji & Kanji
local function roumaji_kanji(ctx, ms, line)
-- Iterate through sylables
for _, syl in ipairs(line.styleref.alignment < 7 and line.chars or line.syls) do -- Use characters in case of kanjis
-- Set color dependent on sylable activity
ctx:set_source(ms >= syl.start_time and ms < syl.end_time and g2du.red or g2du.yellow)
-- Draw sylable text
ctx:path_add_text(syl.x, syl.y, syl.text, ass.unpack_font(line.styleref))
ctx:fill()
ctx:path_clear()
end
end

-- Subtitle
local function subtitle(ctx, line)
-- Draw line text
ctx:path_add_text(line.x, line.y, line.text, ass.unpack_font(line.styleref))
ctx:set_source(g2du.yellow)
ctx:fill()
ctx:path_clear()
end

-- Process frames
function GetFrame(frame, frame_i)
-- Create drawing context for frame
local ctx = frame:get_context()
-- Get frame time
local ms = frame_i / VIDEO_FPS * 1000
-- Look for frame-related ASS lines
for _, line in ipairs(lines) do
if ms >= line.start_time and ms < line.end_time then
-- Draw ASS line
if line.styleref.alignment > 3 then
roumaji_kanji(ctx, ms, line)
else
subtitle(ctx, line)
end
end
end
end</nowiki>
==Audio==
Folgende Skripte dienen der Audiobearbeitung.
===Minimal===
Erstellt ein Rauschen.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
for i = 1, samples_n do
samples[i] = math.random(-1000,1000) / 1000
end
end</nowiki>

===Audio zu Text===
Schreibt Audiodaten als Text in eine Datei.
<nowiki>local file = io.open("audio.txt", "w")
file:write(string.format("Channels: %d\nSample rate: %d\nSamples: %d\n\n", AUDIO_CHANNELS, AUDIO_SAMPLE_RATE, AUDIO_SAMPLES))

function GetSamples(samples, samples_n, start_sample_i)
file:write(table.concat(samples, "\n"))
file:write("\n")
end</nowiki>

=Videos=
[http://www.mediafire.com/download/i3reijc799edi6v/%5BLVS%5D+Samples.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Karaoke Beispiele</tt>]

[http://www.mediafire.com/download/jfj41pn9xvtbd3w/%5BLVS%5D+Oreimo+S2+-+ED13.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Oreimo S2 ED13</tt>]

=Links=
*[http://sourceforge.net/projects/lua-video-sync/ Projektseite auf Sourceforge]
*[http://forum.youka.de Forum]
[[Category:LVS|{{PAGENAME}}]]

LVS

2013-10-05T12:04:45Z

Youka: /* Rauschen */

=LVS=
[[Datei:LVS.png|100px]]

LVS (''"Lua Video Sync"'') ist ein [[wikipedia:Video_filter|Filter]]-[[wikipedia:Plug-in_(computing)|Plugin]] für die populären Windows [[wikipedia:Frameserver|Frameserver]] [[wikipedia:Avisynth|Avisynth]], [[wikipedia:VirtualDub|VirtualDub]] und [[wikipedia:DirectShow|DirectShow]]. Durch Angabe eines Skriptes ([[wikipedia:Lua (programming language)|Lua]] Code enthaltend) als Parameter zum durch das Plugin registrierten Filter lassen sich Videobearbeitungen vornehmen (unter Avisynth auch Audio).

Die Macht der Lua Programmiersprache in Version 5.2, erweitert u.a. durch eine einfache, mächtige [[wikipedia:2D computer graphics|2D Grafik]]bibliothek, ermöglicht eindrucksvolle grafische Bearbeitung von streamenden Video Frames in hoher Geschwindigkeit und mit vielen Mitteln.

=Geschichte=
Die Entwicklung von LVS begann im Jahre 2013 durch den Fansubber "Youka".

Inspiriert von [http://forums.animesuki.com/showthread.php?t=52757 Overlua] wurde LVS als Nachfolger jenes unausgereiften Projektes beschlossen und sollte dessen großes Potenzial, programmatisch und direkt zu [[wikipedia:Rendering (computer graphics)|rendern]] und manipulieren, in einem frischen Gewand ausschöpfen. Als Alternative zu [[wikipedia:Adobe_After_Effects|AFX]] zum typesetten komplexerer Erscheinungen und als mächtigeres Karaoke-FX Werkzeug zu den bisherigen fand es ersten Nutzen bei Fansubbern.

=Definition=
LVS sollte in folgenden Schritten verstanden werden, da es all diese vereint.

==Frameserver plugin==
LVS ist kein eigenständiges Programm, sondern eine Erweiterung für Frameserver, um eine Bearbeitung zwischen der [[wikipedia:Decoder|Dekodierung]] eines Videos und dessen Ausgabe einzufügen. [[wikipedia:Video player (software)|Abspielprogramme]] und [[wikipedia:Encoder#Media|Kodierer]], welche Frameserver nutzen, können somit Filter auf das Eingangsmaterial anwenden, womit ein anderes Ausgangsmaterial entsteht. Nach Hinzufügen von LVS als Filter muss diesem ein Parameter angegeben werden: das Skript, das die Bearbeitung beschreibt.

Im Folgenden wird der Gebrauch von LVS mit den nutzbaren Frameservern gezeigt (dies schließt den Umgang mit den Frameservern selbst nicht ein).

===Avisynth===
Avisynth wird über eine Skriptsprache gesteuert, dementsprechend wird auch LVS eingefügt.
<nowiki>LoadPlugin("E:\LVS\plugin\LVS.dll") #Lädt Plugin 'LVS'/registriert Funktion 'LVS'

BlankClip() #Erstellt einen leeren Clip
LVS("hello.lua") #Führt Videobearbeitungsskript mit LVS aus</nowiki>
Die Definition der Funktion sieht wie folgt aus:

: '''clip = LVS(clip''''', string "video", string "audio", string "data"''')'''

:: '''clip''' (1): Ausgabe-Video
:: '''clip''' (2): Eingabe-Video
:: '''string "video"''' (2): Skript zur Videobearbeitung
:: '''string "audio"''' (2): Skript zur Audiobearbeitung
:: '''string "data"''' (2): String zur Übergabe in Skript-Umgebung


===VirtualDub===
VirtualDubs Video-Filterung ist über das Menü "Video", Menüeintrag "Filters...", erreichbar. Über den Button "Add..." lässt sich LVS aus einer Liste von Filtern hinzufügen und anschließend über einen Dialog dessen Skript-Parameter eingeben. Sollte LVS noch nicht in genannter Liste verfügbar sein, kann über den Button "Load..." das Plugin geladen werden.

[[Datei:LVS - VirtualDub.png|800px]]

===DirectShow===
Filter müssen erst als COM Objekt in der Windows-Registry registriert werden, um sie nutzbar für DirectShow gebrauchende Programme zu machen. Dies ist möglich mit dem Kommandozeilen-Programm [[wikipedia:Regsvr32|regsvr32]]. Anschließend hängt es vom Anwenderprogramm ab, wie der Filter geladen wird.

Am Beispiel von [[wikipedia:Media_Player_Classic#Media_Player_Classic_-_Home_Cinema|MPC-HC]] kann über Menü ''View -> Options... -> External Filter'' LVS hinzugefügt, anschließend durch Setzen der Priorität auf 'Prefer' in die Filter-Kette gezwungen und nach Neustart des Programms über Menü ''Play -> Filters -> LVS'' konfiguriert werden.

[[Datei:LVS - DirectShow.png]]

==Skript-Basis==
Basis eines jeden LVS Skripts ist die Filter Funktion, durch welche Frames bzw. Samples geschickt werden.

Im Falle der Videobearbeitung muss diese '''GetFrame''' heißen. Der erste Aufrufparameter ist ein Frame als Bildobjekt, der zweite der Frame Index.
<nowiki>function GetFrame(frame, frame_i)
-- Füll mich
end</nowiki>
Bei Audiobearbeitung lautet der Funktionsname '''GetSamples'''. Der erste Aufrufparameter ist ein Table, die Samples enthaltend, der zweite die Table-Größe des letzteren und der dritte der Sample Index des ersten erhaltenen Samples (kanalübergreifend).
<nowiki>function GetSamples(samples, samples_n, sample_i)
-- Füll mich
end</nowiki>

Metainformationen eines Streams sind als globale Variablen verfügbar. Diese umfassen '''VIDEO_WIDTH''', '''VIDEO_HEIGHT''', '''VIDEO_HAS_ALPHA''', '''VIDEO_FPS''', '''VIDEO_FRAMES''', '''AUDIO_CHANNELS''', '''AUDIO_SAMPLE_RATE''', '''AUDIO_SAMPLES''' und '''USERDATA''' (letzteres ist das ''data'' Argument in Avisynth und ist in beiden Stream-Typen verfügbar).

==Audioprogrammierung==
Samples werden im Format Float32, also einer Amplitudenangabe von -1.0 bis +1.0, und als channel interlaced, also in Kanäle-Blöcken, empfangen.

{| style="border-collapse: collapse; font-size: 8px; line-height: 5px; text-align: center;"
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S1
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S1
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S2
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S2
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S3
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S3
C2
|style="border: solid 3px; border-right-width: 0px; background-color: yellow; width: 24px;"|...
|}
;S = Sample Index
;C = Channel

Unter Zuhilfenahme der Metainformationen, wie die Anzahl an Kanälen und der Sample Rate, lässt sich mit ihnen arbeiten.

==Grafikprogrammierung==
Frames werden als Bildobjekt empfangen, welches Teil der nutzbaren '''g2d''' Grafikbibliothek ist. Neben dem Bildobjekt gibt es andere Grafikobjekte, welche zur Bearbeitung gebraucht werden. Um all diese zu verwenden, werden über Member-Funktionen ihre Attribute verändert.

Eine Liste der Grafikobjekte:
* '''Image''': Das Bild, um welches sich die gesamte Bearbeitung dreht.
* '''Context''': Der Bildkontext, nötig für die meisten Manipulationen am Bild.
* '''Source''': Die Farbquelle, welche die Einfärbung der zu malenden Form beschreibt.
* '''Matrix''': Die Matrix, anwendbar für Transformationen an Farbquelle und Form.

<blockquote style="color: red;">TODO</blockquote>

==Erweiterungen==
<blockquote style="color: red;">TODO</blockquote>

=Beispiele=
Folgende Beispiele sind Skripte zur Ausführung mit LVS.
==Audio==
Folgende Skripte dienen der Audiobearbeitung.
===Minimal===
Erstellt ein Rauschen.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
for i = 1, samples_n do
samples[i] = math.random(-1000,1000) / 1000
end
end</nowiki>

===Audio zu Text===
Schreibt Audiodaten als Text in eine Datei.
<nowiki>local file = io.open("audio.txt", "w")
file:write(string.format("Channels: %d\nSample rate: %d\nSamples: %d\n\n", AUDIO_CHANNELS, AUDIO_SAMPLE_RATE, AUDIO_SAMPLES))

function GetSamples(samples, samples_n, start_sample_i)
file:write(table.concat(samples, "\n"))
file:write("\n")
end</nowiki>

==Video==
Folgende Skripte dienen der Videobearbeitung.
===Minimal===
Farben aller Frames werden invertiert.
<nowiki>function GetFrame(frame, frame_i)
frame:invert()
end</nowiki>

===Zeichnen===
Zeichnet eine gelbe Aussenlinie eines Halbkreises.
<nowiki>function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_move_to(100, 100)
ctx:path_line_to(200, 100)
ctx:path_add_arc(150, 100, 50, 0, -180)
ctx:set_line_width(5)
ctx:set_line_join("BEVEL")
ctx:set_source(g2du.yellow)
ctx:stroke()
end</nowiki>

===Text===
"Hello world\nfrom LVS!" mit einem rot-zu-grün Farbverlauf.
<nowiki>local pos = {
x = 100,
y = 100
}
local text_properties = {
"Hello world\nfrom LVS!", -- Text
"Arial", -- Font
50, -- Size
true, -- Bold?
true, -- Italic?
true, -- Underline?
true -- Strikeout?
}
local text_extents = {g2d.text_extents(table.unpack(text_properties))}

function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_add_text(pos.x, pos.y, table.unpack(text_properties))
ctx:set_source(
g2d.create_lgradient(pos.x, pos.y, pos.x + text_extents[1], pos.y + text_extents[2])
:add_color(0, 1,0,0)
:add_color(1, 0,1,0)
)
ctx:fill()
end</nowiki>

===Karaoke===
<nowiki>-- Parse ASS file and fill global tables
ass.load("my_ktime.ass")

-- Roumaji & Kanji
local function roumaji_kanji(ctx, ms, line)
-- Iterate through sylables
for _, syl in ipairs(line.styleref.alignment < 7 and line.chars or line.syls) do -- Use characters in case of kanjis
-- Set color dependent on sylable activity
ctx:set_source(ms >= syl.start_time and ms < syl.end_time and g2du.red or g2du.yellow)
-- Draw sylable text
ctx:path_add_text(syl.x, syl.y, syl.text, ass.unpack_font(line.styleref))
ctx:fill()
ctx:path_clear()
end
end

-- Subtitle
local function subtitle(ctx, line)
-- Draw line text
ctx:path_add_text(line.x, line.y, line.text, ass.unpack_font(line.styleref))
ctx:set_source(g2du.yellow)
ctx:fill()
ctx:path_clear()
end

-- Process frames
function GetFrame(frame, frame_i)
-- Create drawing context for frame
local ctx = frame:get_context()
-- Get frame time
local ms = frame_i / VIDEO_FPS * 1000
-- Look for frame-related ASS lines
for _, line in ipairs(lines) do
if ms >= line.start_time and ms < line.end_time then
-- Draw ASS line
if line.styleref.alignment > 3 then
roumaji_kanji(ctx, ms, line)
else
subtitle(ctx, line)
end
end
end
end</nowiki>

=Videos=
[http://www.mediafire.com/download/i3reijc799edi6v/%5BLVS%5D+Samples.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Karaoke Beispiele</tt>]

[http://www.mediafire.com/download/jfj41pn9xvtbd3w/%5BLVS%5D+Oreimo+S2+-+ED13.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Oreimo S2 ED13</tt>]

=Links=
*[http://sourceforge.net/projects/lua-video-sync/ Projektseite auf Sourceforge]
*[http://forum.youka.de Forum]
[[Category:LVS|{{PAGENAME}}]]

LVS

2013-10-02T18:56:25Z

Youka: /* Audioprogrammierung */

=LVS=
[[Datei:LVS.png|100px]]

LVS (''"Lua Video Sync"'') ist ein [[wikipedia:Video_filter|Filter]]-[[wikipedia:Plug-in_(computing)|Plugin]] für die populären Windows [[wikipedia:Frameserver|Frameserver]] [[wikipedia:Avisynth|Avisynth]], [[wikipedia:VirtualDub|VirtualDub]] und [[wikipedia:DirectShow|DirectShow]]. Durch Angabe eines Skriptes ([[wikipedia:Lua (programming language)|Lua]] Code enthaltend) als Parameter zum durch das Plugin registrierten Filter lassen sich Videobearbeitungen vornehmen (unter Avisynth auch Audio).

Die Macht der Lua Programmiersprache in Version 5.2, erweitert u.a. durch eine einfache, mächtige [[wikipedia:2D computer graphics|2D Grafik]]bibliothek, ermöglicht eindrucksvolle grafische Bearbeitung von streamenden Video Frames in hoher Geschwindigkeit und mit vielen Mitteln.

=Geschichte=
Die Entwicklung von LVS begann im Jahre 2013 durch den Fansubber "Youka".

Inspiriert von [http://forums.animesuki.com/showthread.php?t=52757 Overlua] wurde LVS als Nachfolger jenes unausgereiften Projektes beschlossen und sollte dessen großes Potenzial, programmatisch und direkt zu [[wikipedia:Rendering (computer graphics)|rendern]] und manipulieren, in einem frischen Gewand ausschöpfen. Als Alternative zu [[wikipedia:Adobe_After_Effects|AFX]] zum typesetten komplexerer Erscheinungen und als mächtigeres Karaoke-FX Werkzeug zu den bisherigen fand es ersten Nutzen bei Fansubbern.

=Definition=
LVS sollte in folgenden Schritten verstanden werden, da es all diese vereint.

==Frameserver plugin==
LVS ist kein eigenständiges Programm, sondern eine Erweiterung für Frameserver, um eine Bearbeitung zwischen der [[wikipedia:Decoder|Dekodierung]] eines Videos und dessen Ausgabe einzufügen. [[wikipedia:Video player (software)|Abspielprogramme]] und [[wikipedia:Encoder#Media|Kodierer]], welche Frameserver nutzen, können somit Filter auf das Eingangsmaterial anwenden, womit ein anderes Ausgangsmaterial entsteht. Nach Hinzufügen von LVS als Filter muss diesem ein Parameter angegeben werden: das Skript, das die Bearbeitung beschreibt.

Im Folgenden wird der Gebrauch von LVS mit den nutzbaren Frameservern gezeigt (dies schließt den Umgang mit den Frameservern selbst nicht ein).

===Avisynth===
Avisynth wird über eine Skriptsprache gesteuert, dementsprechend wird auch LVS eingefügt.
<nowiki>LoadPlugin("E:\LVS\plugin\LVS.dll") #Lädt Plugin 'LVS'/registriert Funktion 'LVS'

BlankClip() #Erstellt einen leeren Clip
LVS("hello.lua") #Führt Videobearbeitungsskript mit LVS aus</nowiki>
Die Definition der Funktion sieht wie folgt aus:

: '''clip = LVS(clip''''', string "video", string "audio", string "data"''')'''

:: '''clip''' (1): Ausgabe-Video
:: '''clip''' (2): Eingabe-Video
:: '''string "video"''' (2): Skript zur Videobearbeitung
:: '''string "audio"''' (2): Skript zur Audiobearbeitung
:: '''string "data"''' (2): String zur Übergabe in Skript-Umgebung


===VirtualDub===
VirtualDubs Video-Filterung ist über das Menü "Video", Menüeintrag "Filters...", erreichbar. Über den Button "Add..." lässt sich LVS aus einer Liste von Filtern hinzufügen und anschließend über einen Dialog dessen Skript-Parameter eingeben. Sollte LVS noch nicht in genannter Liste verfügbar sein, kann über den Button "Load..." das Plugin geladen werden.

[[Datei:LVS - VirtualDub.png|800px]]

===DirectShow===
Filter müssen erst als COM Objekt in der Windows-Registry registriert werden, um sie nutzbar für DirectShow gebrauchende Programme zu machen. Dies ist möglich mit dem Kommandozeilen-Programm [[wikipedia:Regsvr32|regsvr32]]. Anschließend hängt es vom Anwenderprogramm ab, wie der Filter geladen wird.

Am Beispiel von [[wikipedia:Media_Player_Classic#Media_Player_Classic_-_Home_Cinema|MPC-HC]] kann über Menü ''View -> Options... -> External Filter'' LVS hinzugefügt, anschließend durch Setzen der Priorität auf 'Prefer' in die Filter-Kette gezwungen und nach Neustart des Programms über Menü ''Play -> Filters -> LVS'' konfiguriert werden.

[[Datei:LVS - DirectShow.png]]

==Skript-Basis==
Basis eines jeden LVS Skripts ist die Filter Funktion, durch welche Frames bzw. Samples geschickt werden.

Im Falle der Videobearbeitung muss diese '''GetFrame''' heißen. Der erste Aufrufparameter ist ein Frame als Bildobjekt, der zweite der Frame Index.
<nowiki>function GetFrame(frame, frame_i)
-- Füll mich
end</nowiki>
Bei Audiobearbeitung lautet der Funktionsname '''GetSamples'''. Der erste Aufrufparameter ist ein Table, die Samples enthaltend, der zweite die Table-Größe des letzteren und der dritte der Sample Index des ersten erhaltenen Samples (kanalübergreifend).
<nowiki>function GetSamples(samples, samples_n, sample_i)
-- Füll mich
end</nowiki>

Metainformationen eines Streams sind als globale Variablen verfügbar. Diese umfassen '''VIDEO_WIDTH''', '''VIDEO_HEIGHT''', '''VIDEO_HAS_ALPHA''', '''VIDEO_FPS''', '''VIDEO_FRAMES''', '''AUDIO_CHANNELS''', '''AUDIO_SAMPLE_RATE''', '''AUDIO_SAMPLES''' und '''USERDATA''' (letzteres ist das ''data'' Argument in Avisynth und ist in beiden Stream-Typen verfügbar).

==Audioprogrammierung==
Samples werden im Format Float32, also einer Amplitudenangabe von -1.0 bis +1.0, und als channel interlaced, also in Kanäle-Blöcken, empfangen.

{| style="border-collapse: collapse; font-size: 8px; line-height: 5px; text-align: center;"
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S1
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S1
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S2
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S2
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S3
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S3
C2
|style="border: solid 3px; border-right-width: 0px; background-color: yellow; width: 24px;"|...
|}
;S = Sample Index
;C = Channel

Unter Zuhilfenahme der Metainformationen, wie die Anzahl an Kanälen und der Sample Rate, lässt sich mit ihnen arbeiten.

==Grafikprogrammierung==
Frames werden als Bildobjekt empfangen, welches Teil der nutzbaren '''g2d''' Grafikbibliothek ist. Neben dem Bildobjekt gibt es andere Grafikobjekte, welche zur Bearbeitung gebraucht werden. Um all diese zu verwenden, werden über Member-Funktionen ihre Attribute verändert.

Eine Liste der Grafikobjekte:
* '''Image''': Das Bild, um welches sich die gesamte Bearbeitung dreht.
* '''Context''': Der Bildkontext, nötig für die meisten Manipulationen am Bild.
* '''Source''': Die Farbquelle, welche die Einfärbung der zu malenden Form beschreibt.
* '''Matrix''': Die Matrix, anwendbar für Transformationen an Farbquelle und Form.

<blockquote style="color: red;">TODO</blockquote>

==Erweiterungen==
<blockquote style="color: red;">TODO</blockquote>

=Beispiele=
Folgende Beispiele sind Skripte zur Ausführung mit LVS.
==Audio==
Folgende Skripte dienen der Audiobearbeitung.
===Rauschen===
Erstellt ein Rauschen.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
for i = 1, samples_n do
samples[i] = math.random(-1000,1000) / 1000
end
end</nowiki>

===Audio zu Text===
Schreibt Audiodaten als Text in eine Datei.
<nowiki>local file = io.open("audio.txt", "w")
file:write(string.format("Channels: %d\nSample rate: %d\nSamples: %d\n\n", AUDIO_CHANNELS, AUDIO_SAMPLE_RATE, AUDIO_SAMPLES))

function GetSamples(samples, samples_n, start_sample_i)
file:write(table.concat(samples, "\n"))
file:write("\n")
end</nowiki>

==Video==
Folgende Skripte dienen der Videobearbeitung.
===Minimal===
Farben aller Frames werden invertiert.
<nowiki>function GetFrame(frame, frame_i)
frame:invert()
end</nowiki>

===Zeichnen===
Zeichnet eine gelbe Aussenlinie eines Halbkreises.
<nowiki>function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_move_to(100, 100)
ctx:path_line_to(200, 100)
ctx:path_add_arc(150, 100, 50, 0, -180)
ctx:set_line_width(5)
ctx:set_line_join("BEVEL")
ctx:set_source(g2du.yellow)
ctx:stroke()
end</nowiki>

===Text===
"Hello world\nfrom LVS!" mit einem rot-zu-grün Farbverlauf.
<nowiki>local pos = {
x = 100,
y = 100
}
local text_properties = {
"Hello world\nfrom LVS!", -- Text
"Arial", -- Font
50, -- Size
true, -- Bold?
true, -- Italic?
true, -- Underline?
true -- Strikeout?
}
local text_extents = {g2d.text_extents(table.unpack(text_properties))}

function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_add_text(pos.x, pos.y, table.unpack(text_properties))
ctx:set_source(
g2d.create_lgradient(pos.x, pos.y, pos.x + text_extents[1], pos.y + text_extents[2])
:add_color(0, 1,0,0)
:add_color(1, 0,1,0)
)
ctx:fill()
end</nowiki>

===Karaoke===
<nowiki>-- Parse ASS file and fill global tables
ass.load("my_ktime.ass")

-- Roumaji & Kanji
local function roumaji_kanji(ctx, ms, line)
-- Iterate through sylables
for _, syl in ipairs(line.styleref.alignment < 7 and line.chars or line.syls) do -- Use characters in case of kanjis
-- Set color dependent on sylable activity
ctx:set_source(ms >= syl.start_time and ms < syl.end_time and g2du.red or g2du.yellow)
-- Draw sylable text
ctx:path_add_text(syl.x, syl.y, syl.text, ass.unpack_font(line.styleref))
ctx:fill()
ctx:path_clear()
end
end

-- Subtitle
local function subtitle(ctx, line)
-- Draw line text
ctx:path_add_text(line.x, line.y, line.text, ass.unpack_font(line.styleref))
ctx:set_source(g2du.yellow)
ctx:fill()
ctx:path_clear()
end

-- Process frames
function GetFrame(frame, frame_i)
-- Create drawing context for frame
local ctx = frame:get_context()
-- Get frame time
local ms = frame_i / VIDEO_FPS * 1000
-- Look for frame-related ASS lines
for _, line in ipairs(lines) do
if ms >= line.start_time and ms < line.end_time then
-- Draw ASS line
if line.styleref.alignment > 3 then
roumaji_kanji(ctx, ms, line)
else
subtitle(ctx, line)
end
end
end
end</nowiki>

=Videos=
[http://www.mediafire.com/download/i3reijc799edi6v/%5BLVS%5D+Samples.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Karaoke Beispiele</tt>]

[http://www.mediafire.com/download/jfj41pn9xvtbd3w/%5BLVS%5D+Oreimo+S2+-+ED13.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Oreimo S2 ED13</tt>]

=Links=
*[http://sourceforge.net/projects/lua-video-sync/ Projektseite auf Sourceforge]
*[http://forum.youka.de Forum]
[[Category:LVS|{{PAGENAME}}]]

LVS

2013-10-02T09:56:55Z

Youka: /* Grafikprogrammierung */

=LVS=
[[Datei:LVS.png|100px]]

LVS (''"Lua Video Sync"'') ist ein [[wikipedia:Video_filter|Filter]]-[[wikipedia:Plug-in_(computing)|Plugin]] für die populären Windows [[wikipedia:Frameserver|Frameserver]] [[wikipedia:Avisynth|Avisynth]], [[wikipedia:VirtualDub|VirtualDub]] und [[wikipedia:DirectShow|DirectShow]]. Durch Angabe eines Skriptes ([[wikipedia:Lua (programming language)|Lua]] Code enthaltend) als Parameter zum durch das Plugin registrierten Filter lassen sich Videobearbeitungen vornehmen (unter Avisynth auch Audio).

Die Macht der Lua Programmiersprache in Version 5.2, erweitert u.a. durch eine einfache, mächtige [[wikipedia:2D computer graphics|2D Grafik]]bibliothek, ermöglicht eindrucksvolle grafische Bearbeitung von streamenden Video Frames in hoher Geschwindigkeit und mit vielen Mitteln.

=Geschichte=
Die Entwicklung von LVS begann im Jahre 2013 durch den Fansubber "Youka".

Inspiriert von [http://forums.animesuki.com/showthread.php?t=52757 Overlua] wurde LVS als Nachfolger jenes unausgereiften Projektes beschlossen und sollte dessen großes Potenzial, programmatisch und direkt zu [[wikipedia:Rendering (computer graphics)|rendern]] und manipulieren, in einem frischen Gewand ausschöpfen. Als Alternative zu [[wikipedia:Adobe_After_Effects|AFX]] zum typesetten komplexerer Erscheinungen und als mächtigeres Karaoke-FX Werkzeug zu den bisherigen fand es ersten Nutzen bei Fansubbern.

=Definition=
LVS sollte in folgenden Schritten verstanden werden, da es all diese vereint.

==Frameserver plugin==
LVS ist kein eigenständiges Programm, sondern eine Erweiterung für Frameserver, um eine Bearbeitung zwischen der [[wikipedia:Decoder|Dekodierung]] eines Videos und dessen Ausgabe einzufügen. [[wikipedia:Video player (software)|Abspielprogramme]] und [[wikipedia:Encoder#Media|Kodierer]], welche Frameserver nutzen, können somit Filter auf das Eingangsmaterial anwenden, womit ein anderes Ausgangsmaterial entsteht. Nach Hinzufügen von LVS als Filter muss diesem ein Parameter angegeben werden: das Skript, das die Bearbeitung beschreibt.

Im Folgenden wird der Gebrauch von LVS mit den nutzbaren Frameservern gezeigt (dies schließt den Umgang mit den Frameservern selbst nicht ein).

===Avisynth===
Avisynth wird über eine Skriptsprache gesteuert, dementsprechend wird auch LVS eingefügt.
<nowiki>LoadPlugin("E:\LVS\plugin\LVS.dll") #Lädt Plugin 'LVS'/registriert Funktion 'LVS'

BlankClip() #Erstellt einen leeren Clip
LVS("hello.lua") #Führt Videobearbeitungsskript mit LVS aus</nowiki>
Die Definition der Funktion sieht wie folgt aus:

: '''clip = LVS(clip''''', string "video", string "audio", string "data"''')'''

:: '''clip''' (1): Ausgabe-Video
:: '''clip''' (2): Eingabe-Video
:: '''string "video"''' (2): Skript zur Videobearbeitung
:: '''string "audio"''' (2): Skript zur Audiobearbeitung
:: '''string "data"''' (2): String zur Übergabe in Skript-Umgebung


===VirtualDub===
VirtualDubs Video-Filterung ist über das Menü "Video", Menüeintrag "Filters...", erreichbar. Über den Button "Add..." lässt sich LVS aus einer Liste von Filtern hinzufügen und anschließend über einen Dialog dessen Skript-Parameter eingeben. Sollte LVS noch nicht in genannter Liste verfügbar sein, kann über den Button "Load..." das Plugin geladen werden.

[[Datei:LVS - VirtualDub.png|800px]]

===DirectShow===
Filter müssen erst als COM Objekt in der Windows-Registry registriert werden, um sie nutzbar für DirectShow gebrauchende Programme zu machen. Dies ist möglich mit dem Kommandozeilen-Programm [[wikipedia:Regsvr32|regsvr32]]. Anschließend hängt es vom Anwenderprogramm ab, wie der Filter geladen wird.

Am Beispiel von [[wikipedia:Media_Player_Classic#Media_Player_Classic_-_Home_Cinema|MPC-HC]] kann über Menü ''View -> Options... -> External Filter'' LVS hinzugefügt, anschließend durch Setzen der Priorität auf 'Prefer' in die Filter-Kette gezwungen und nach Neustart des Programms über Menü ''Play -> Filters -> LVS'' konfiguriert werden.

[[Datei:LVS - DirectShow.png]]

==Skript-Basis==
Basis eines jeden LVS Skripts ist die Filter Funktion, durch welche Frames bzw. Samples geschickt werden.

Im Falle der Videobearbeitung muss diese '''GetFrame''' heißen. Der erste Aufrufparameter ist ein Frame als Bildobjekt, der zweite der Frame Index.
<nowiki>function GetFrame(frame, frame_i)
-- Füll mich
end</nowiki>
Bei Audiobearbeitung lautet der Funktionsname '''GetSamples'''. Der erste Aufrufparameter ist ein Table, die Samples enthaltend, der zweite die Table-Größe des letzteren und der dritte der Sample Index des ersten erhaltenen Samples (kanalübergreifend).
<nowiki>function GetSamples(samples, samples_n, sample_i)
-- Füll mich
end</nowiki>

Metainformationen eines Streams sind als globale Variablen verfügbar. Diese umfassen '''VIDEO_WIDTH''', '''VIDEO_HEIGHT''', '''VIDEO_HAS_ALPHA''', '''VIDEO_FPS''', '''VIDEO_FRAMES''', '''AUDIO_CHANNELS''', '''AUDIO_SAMPLE_RATE''', '''AUDIO_SAMPLES''' und '''USERDATA''' (letzteres ist das ''data'' Argument in Avisynth und ist in beiden Stream-Typen verfügbar).

==Audioprogrammierung==
Samples werden im Format Float32, also einer Amplitudenangabe von -1.0 bis +1.0, und als channel interlaced, also in Kanäle-Blöcken, empfangen.

{| style="border-collapse: collapse; font-size: 8px; line-height: 5px; text-align: center;"
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S1
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S1
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S2
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S2
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S3
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S3
C2
|style="border: solid 3px; border-right-width: 0px; background-color: yellow; width: 24px; padding-top: 8px;"|...
|}
;S = Sample Index
;C = Channel

Unter Zuhilfenahme der Metainformationen, wie die Anzahl an Kanälen und der Sample Rate, lässt sich mit ihnen arbeiten.

==Grafikprogrammierung==
Frames werden als Bildobjekt empfangen, welches Teil der nutzbaren '''g2d''' Grafikbibliothek ist. Neben dem Bildobjekt gibt es andere Grafikobjekte, welche zur Bearbeitung gebraucht werden. Um all diese zu verwenden, werden über Member-Funktionen ihre Attribute verändert.

Eine Liste der Grafikobjekte:
* '''Image''': Das Bild, um welches sich die gesamte Bearbeitung dreht.
* '''Context''': Der Bildkontext, nötig für die meisten Manipulationen am Bild.
* '''Source''': Die Farbquelle, welche die Einfärbung der zu malenden Form beschreibt.
* '''Matrix''': Die Matrix, anwendbar für Transformationen an Farbquelle und Form.

<blockquote style="color: red;">TODO</blockquote>

==Erweiterungen==
<blockquote style="color: red;">TODO</blockquote>

=Beispiele=
Folgende Beispiele sind Skripte zur Ausführung mit LVS.
==Audio==
Folgende Skripte dienen der Audiobearbeitung.
===Rauschen===
Erstellt ein Rauschen.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
for i = 1, samples_n do
samples[i] = math.random(-1000,1000) / 1000
end
end</nowiki>

===Audio zu Text===
Schreibt Audiodaten als Text in eine Datei.
<nowiki>local file = io.open("audio.txt", "w")
file:write(string.format("Channels: %d\nSample rate: %d\nSamples: %d\n\n", AUDIO_CHANNELS, AUDIO_SAMPLE_RATE, AUDIO_SAMPLES))

function GetSamples(samples, samples_n, start_sample_i)
file:write(table.concat(samples, "\n"))
file:write("\n")
end</nowiki>

==Video==
Folgende Skripte dienen der Videobearbeitung.
===Minimal===
Farben aller Frames werden invertiert.
<nowiki>function GetFrame(frame, frame_i)
frame:invert()
end</nowiki>

===Zeichnen===
Zeichnet eine gelbe Aussenlinie eines Halbkreises.
<nowiki>function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_move_to(100, 100)
ctx:path_line_to(200, 100)
ctx:path_add_arc(150, 100, 50, 0, -180)
ctx:set_line_width(5)
ctx:set_line_join("BEVEL")
ctx:set_source(g2du.yellow)
ctx:stroke()
end</nowiki>

===Text===
"Hello world\nfrom LVS!" mit einem rot-zu-grün Farbverlauf.
<nowiki>local pos = {
x = 100,
y = 100
}
local text_properties = {
"Hello world\nfrom LVS!", -- Text
"Arial", -- Font
50, -- Size
true, -- Bold?
true, -- Italic?
true, -- Underline?
true -- Strikeout?
}
local text_extents = {g2d.text_extents(table.unpack(text_properties))}

function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_add_text(pos.x, pos.y, table.unpack(text_properties))
ctx:set_source(
g2d.create_lgradient(pos.x, pos.y, pos.x + text_extents[1], pos.y + text_extents[2])
:add_color(0, 1,0,0)
:add_color(1, 0,1,0)
)
ctx:fill()
end</nowiki>

===Karaoke===
<nowiki>-- Parse ASS file and fill global tables
ass.load("my_ktime.ass")

-- Roumaji & Kanji
local function roumaji_kanji(ctx, ms, line)
-- Iterate through sylables
for _, syl in ipairs(line.styleref.alignment < 7 and line.chars or line.syls) do -- Use characters in case of kanjis
-- Set color dependent on sylable activity
ctx:set_source(ms >= syl.start_time and ms < syl.end_time and g2du.red or g2du.yellow)
-- Draw sylable text
ctx:path_add_text(syl.x, syl.y, syl.text, ass.unpack_font(line.styleref))
ctx:fill()
ctx:path_clear()
end
end

-- Subtitle
local function subtitle(ctx, line)
-- Draw line text
ctx:path_add_text(line.x, line.y, line.text, ass.unpack_font(line.styleref))
ctx:set_source(g2du.yellow)
ctx:fill()
ctx:path_clear()
end

-- Process frames
function GetFrame(frame, frame_i)
-- Create drawing context for frame
local ctx = frame:get_context()
-- Get frame time
local ms = frame_i / VIDEO_FPS * 1000
-- Look for frame-related ASS lines
for _, line in ipairs(lines) do
if ms >= line.start_time and ms < line.end_time then
-- Draw ASS line
if line.styleref.alignment > 3 then
roumaji_kanji(ctx, ms, line)
else
subtitle(ctx, line)
end
end
end
end</nowiki>

=Videos=
[http://www.mediafire.com/download/i3reijc799edi6v/%5BLVS%5D+Samples.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Karaoke Beispiele</tt>]

[http://www.mediafire.com/download/jfj41pn9xvtbd3w/%5BLVS%5D+Oreimo+S2+-+ED13.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Oreimo S2 ED13</tt>]

=Links=
*[http://sourceforge.net/projects/lua-video-sync/ Projektseite auf Sourceforge]
*[http://forum.youka.de Forum]
[[Category:LVS|{{PAGENAME}}]]

LVS

2013-10-02T09:47:18Z

Youka: /* Audioprogrammierung */

=LVS=
[[Datei:LVS.png|100px]]

LVS (''"Lua Video Sync"'') ist ein [[wikipedia:Video_filter|Filter]]-[[wikipedia:Plug-in_(computing)|Plugin]] für die populären Windows [[wikipedia:Frameserver|Frameserver]] [[wikipedia:Avisynth|Avisynth]], [[wikipedia:VirtualDub|VirtualDub]] und [[wikipedia:DirectShow|DirectShow]]. Durch Angabe eines Skriptes ([[wikipedia:Lua (programming language)|Lua]] Code enthaltend) als Parameter zum durch das Plugin registrierten Filter lassen sich Videobearbeitungen vornehmen (unter Avisynth auch Audio).

Die Macht der Lua Programmiersprache in Version 5.2, erweitert u.a. durch eine einfache, mächtige [[wikipedia:2D computer graphics|2D Grafik]]bibliothek, ermöglicht eindrucksvolle grafische Bearbeitung von streamenden Video Frames in hoher Geschwindigkeit und mit vielen Mitteln.

=Geschichte=
Die Entwicklung von LVS begann im Jahre 2013 durch den Fansubber "Youka".

Inspiriert von [http://forums.animesuki.com/showthread.php?t=52757 Overlua] wurde LVS als Nachfolger jenes unausgereiften Projektes beschlossen und sollte dessen großes Potenzial, programmatisch und direkt zu [[wikipedia:Rendering (computer graphics)|rendern]] und manipulieren, in einem frischen Gewand ausschöpfen. Als Alternative zu [[wikipedia:Adobe_After_Effects|AFX]] zum typesetten komplexerer Erscheinungen und als mächtigeres Karaoke-FX Werkzeug zu den bisherigen fand es ersten Nutzen bei Fansubbern.

=Definition=
LVS sollte in folgenden Schritten verstanden werden, da es all diese vereint.

==Frameserver plugin==
LVS ist kein eigenständiges Programm, sondern eine Erweiterung für Frameserver, um eine Bearbeitung zwischen der [[wikipedia:Decoder|Dekodierung]] eines Videos und dessen Ausgabe einzufügen. [[wikipedia:Video player (software)|Abspielprogramme]] und [[wikipedia:Encoder#Media|Kodierer]], welche Frameserver nutzen, können somit Filter auf das Eingangsmaterial anwenden, womit ein anderes Ausgangsmaterial entsteht. Nach Hinzufügen von LVS als Filter muss diesem ein Parameter angegeben werden: das Skript, das die Bearbeitung beschreibt.

Im Folgenden wird der Gebrauch von LVS mit den nutzbaren Frameservern gezeigt (dies schließt den Umgang mit den Frameservern selbst nicht ein).

===Avisynth===
Avisynth wird über eine Skriptsprache gesteuert, dementsprechend wird auch LVS eingefügt.
<nowiki>LoadPlugin("E:\LVS\plugin\LVS.dll") #Lädt Plugin 'LVS'/registriert Funktion 'LVS'

BlankClip() #Erstellt einen leeren Clip
LVS("hello.lua") #Führt Videobearbeitungsskript mit LVS aus</nowiki>
Die Definition der Funktion sieht wie folgt aus:

: '''clip = LVS(clip''''', string "video", string "audio", string "data"''')'''

:: '''clip''' (1): Ausgabe-Video
:: '''clip''' (2): Eingabe-Video
:: '''string "video"''' (2): Skript zur Videobearbeitung
:: '''string "audio"''' (2): Skript zur Audiobearbeitung
:: '''string "data"''' (2): String zur Übergabe in Skript-Umgebung


===VirtualDub===
VirtualDubs Video-Filterung ist über das Menü "Video", Menüeintrag "Filters...", erreichbar. Über den Button "Add..." lässt sich LVS aus einer Liste von Filtern hinzufügen und anschließend über einen Dialog dessen Skript-Parameter eingeben. Sollte LVS noch nicht in genannter Liste verfügbar sein, kann über den Button "Load..." das Plugin geladen werden.

[[Datei:LVS - VirtualDub.png|800px]]

===DirectShow===
Filter müssen erst als COM Objekt in der Windows-Registry registriert werden, um sie nutzbar für DirectShow gebrauchende Programme zu machen. Dies ist möglich mit dem Kommandozeilen-Programm [[wikipedia:Regsvr32|regsvr32]]. Anschließend hängt es vom Anwenderprogramm ab, wie der Filter geladen wird.

Am Beispiel von [[wikipedia:Media_Player_Classic#Media_Player_Classic_-_Home_Cinema|MPC-HC]] kann über Menü ''View -> Options... -> External Filter'' LVS hinzugefügt, anschließend durch Setzen der Priorität auf 'Prefer' in die Filter-Kette gezwungen und nach Neustart des Programms über Menü ''Play -> Filters -> LVS'' konfiguriert werden.

[[Datei:LVS - DirectShow.png]]

==Skript-Basis==
Basis eines jeden LVS Skripts ist die Filter Funktion, durch welche Frames bzw. Samples geschickt werden.

Im Falle der Videobearbeitung muss diese '''GetFrame''' heißen. Der erste Aufrufparameter ist ein Frame als Bildobjekt, der zweite der Frame Index.
<nowiki>function GetFrame(frame, frame_i)
-- Füll mich
end</nowiki>
Bei Audiobearbeitung lautet der Funktionsname '''GetSamples'''. Der erste Aufrufparameter ist ein Table, die Samples enthaltend, der zweite die Table-Größe des letzteren und der dritte der Sample Index des ersten erhaltenen Samples (kanalübergreifend).
<nowiki>function GetSamples(samples, samples_n, sample_i)
-- Füll mich
end</nowiki>

Metainformationen eines Streams sind als globale Variablen verfügbar. Diese umfassen '''VIDEO_WIDTH''', '''VIDEO_HEIGHT''', '''VIDEO_HAS_ALPHA''', '''VIDEO_FPS''', '''VIDEO_FRAMES''', '''AUDIO_CHANNELS''', '''AUDIO_SAMPLE_RATE''', '''AUDIO_SAMPLES''' und '''USERDATA''' (letzteres ist das ''data'' Argument in Avisynth und ist in beiden Stream-Typen verfügbar).

==Audioprogrammierung==
Samples werden im Format Float32, also einer Amplitudenangabe von -1.0 bis +1.0, und als channel interlaced, also in Kanäle-Blöcken, empfangen.

{| style="border-collapse: collapse; font-size: 8px; line-height: 5px; text-align: center;"
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S1
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S1
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S2
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S2
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S3
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S3
C2
|style="border: solid 3px; border-right-width: 0px; background-color: yellow; width: 24px; padding-top: 8px;"|...
|}
;S = Sample Index
;C = Channel

Unter Zuhilfenahme der Metainformationen, wie die Anzahl an Kanälen und der Sample Rate, lässt sich mit ihnen arbeiten.

==Grafikprogrammierung==
Frames werden als Bildobjekt empfangen, welches Teil der nutzbaren '''g2d''' Grafikbibliothek ist. Neben dem Bildobjekt gibt es andere Grafikobjekte, welche zur Bearbeitung gebraucht werden. Um all diese zu verwenden, werden über Member-Funktionen ihre Attribute verändert.

Eine Liste der Grafikobjekte:

<blockquote style="color: red;">TODO</blockquote>

==Erweiterungen==
<blockquote style="color: red;">TODO</blockquote>

=Beispiele=
Folgende Beispiele sind Skripte zur Ausführung mit LVS.
==Audio==
Folgende Skripte dienen der Audiobearbeitung.
===Rauschen===
Erstellt ein Rauschen.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
for i = 1, samples_n do
samples[i] = math.random(-1000,1000) / 1000
end
end</nowiki>

===Audio zu Text===
Schreibt Audiodaten als Text in eine Datei.
<nowiki>local file = io.open("audio.txt", "w")
file:write(string.format("Channels: %d\nSample rate: %d\nSamples: %d\n\n", AUDIO_CHANNELS, AUDIO_SAMPLE_RATE, AUDIO_SAMPLES))

function GetSamples(samples, samples_n, start_sample_i)
file:write(table.concat(samples, "\n"))
file:write("\n")
end</nowiki>

==Video==
Folgende Skripte dienen der Videobearbeitung.
===Minimal===
Farben aller Frames werden invertiert.
<nowiki>function GetFrame(frame, frame_i)
frame:invert()
end</nowiki>

===Zeichnen===
Zeichnet eine gelbe Aussenlinie eines Halbkreises.
<nowiki>function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_move_to(100, 100)
ctx:path_line_to(200, 100)
ctx:path_add_arc(150, 100, 50, 0, -180)
ctx:set_line_width(5)
ctx:set_line_join("BEVEL")
ctx:set_source(g2du.yellow)
ctx:stroke()
end</nowiki>

===Text===
"Hello world\nfrom LVS!" mit einem rot-zu-grün Farbverlauf.
<nowiki>local pos = {
x = 100,
y = 100
}
local text_properties = {
"Hello world\nfrom LVS!", -- Text
"Arial", -- Font
50, -- Size
true, -- Bold?
true, -- Italic?
true, -- Underline?
true -- Strikeout?
}
local text_extents = {g2d.text_extents(table.unpack(text_properties))}

function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_add_text(pos.x, pos.y, table.unpack(text_properties))
ctx:set_source(
g2d.create_lgradient(pos.x, pos.y, pos.x + text_extents[1], pos.y + text_extents[2])
:add_color(0, 1,0,0)
:add_color(1, 0,1,0)
)
ctx:fill()
end</nowiki>

===Karaoke===
<nowiki>-- Parse ASS file and fill global tables
ass.load("my_ktime.ass")

-- Roumaji & Kanji
local function roumaji_kanji(ctx, ms, line)
-- Iterate through sylables
for _, syl in ipairs(line.styleref.alignment < 7 and line.chars or line.syls) do -- Use characters in case of kanjis
-- Set color dependent on sylable activity
ctx:set_source(ms >= syl.start_time and ms < syl.end_time and g2du.red or g2du.yellow)
-- Draw sylable text
ctx:path_add_text(syl.x, syl.y, syl.text, ass.unpack_font(line.styleref))
ctx:fill()
ctx:path_clear()
end
end

-- Subtitle
local function subtitle(ctx, line)
-- Draw line text
ctx:path_add_text(line.x, line.y, line.text, ass.unpack_font(line.styleref))
ctx:set_source(g2du.yellow)
ctx:fill()
ctx:path_clear()
end

-- Process frames
function GetFrame(frame, frame_i)
-- Create drawing context for frame
local ctx = frame:get_context()
-- Get frame time
local ms = frame_i / VIDEO_FPS * 1000
-- Look for frame-related ASS lines
for _, line in ipairs(lines) do
if ms >= line.start_time and ms < line.end_time then
-- Draw ASS line
if line.styleref.alignment > 3 then
roumaji_kanji(ctx, ms, line)
else
subtitle(ctx, line)
end
end
end
end</nowiki>

=Videos=
[http://www.mediafire.com/download/i3reijc799edi6v/%5BLVS%5D+Samples.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Karaoke Beispiele</tt>]

[http://www.mediafire.com/download/jfj41pn9xvtbd3w/%5BLVS%5D+Oreimo+S2+-+ED13.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Oreimo S2 ED13</tt>]

=Links=
*[http://sourceforge.net/projects/lua-video-sync/ Projektseite auf Sourceforge]
*[http://forum.youka.de Forum]
[[Category:LVS|{{PAGENAME}}]]

LVS

2013-10-02T09:18:22Z

Youka: /* Grafikprogrammierung */

=LVS=
[[Datei:LVS.png|100px]]

LVS (''"Lua Video Sync"'') ist ein [[wikipedia:Video_filter|Filter]]-[[wikipedia:Plug-in_(computing)|Plugin]] für die populären Windows [[wikipedia:Frameserver|Frameserver]] [[wikipedia:Avisynth|Avisynth]], [[wikipedia:VirtualDub|VirtualDub]] und [[wikipedia:DirectShow|DirectShow]]. Durch Angabe eines Skriptes ([[wikipedia:Lua (programming language)|Lua]] Code enthaltend) als Parameter zum durch das Plugin registrierten Filter lassen sich Videobearbeitungen vornehmen (unter Avisynth auch Audio).

Die Macht der Lua Programmiersprache in Version 5.2, erweitert u.a. durch eine einfache, mächtige [[wikipedia:2D computer graphics|2D Grafik]]bibliothek, ermöglicht eindrucksvolle grafische Bearbeitung von streamenden Video Frames in hoher Geschwindigkeit und mit vielen Mitteln.

=Geschichte=
Die Entwicklung von LVS begann im Jahre 2013 durch den Fansubber "Youka".

Inspiriert von [http://forums.animesuki.com/showthread.php?t=52757 Overlua] wurde LVS als Nachfolger jenes unausgereiften Projektes beschlossen und sollte dessen großes Potenzial, programmatisch und direkt zu [[wikipedia:Rendering (computer graphics)|rendern]] und manipulieren, in einem frischen Gewand ausschöpfen. Als Alternative zu [[wikipedia:Adobe_After_Effects|AFX]] zum typesetten komplexerer Erscheinungen und als mächtigeres Karaoke-FX Werkzeug zu den bisherigen fand es ersten Nutzen bei Fansubbern.

=Definition=
LVS sollte in folgenden Schritten verstanden werden, da es all diese vereint.

==Frameserver plugin==
LVS ist kein eigenständiges Programm, sondern eine Erweiterung für Frameserver, um eine Bearbeitung zwischen der [[wikipedia:Decoder|Dekodierung]] eines Videos und dessen Ausgabe einzufügen. [[wikipedia:Video player (software)|Abspielprogramme]] und [[wikipedia:Encoder#Media|Kodierer]], welche Frameserver nutzen, können somit Filter auf das Eingangsmaterial anwenden, womit ein anderes Ausgangsmaterial entsteht. Nach Hinzufügen von LVS als Filter muss diesem ein Parameter angegeben werden: das Skript, das die Bearbeitung beschreibt.

Im Folgenden wird der Gebrauch von LVS mit den nutzbaren Frameservern gezeigt (dies schließt den Umgang mit den Frameservern selbst nicht ein).

===Avisynth===
Avisynth wird über eine Skriptsprache gesteuert, dementsprechend wird auch LVS eingefügt.
<nowiki>LoadPlugin("E:\LVS\plugin\LVS.dll") #Lädt Plugin 'LVS'/registriert Funktion 'LVS'

BlankClip() #Erstellt einen leeren Clip
LVS("hello.lua") #Führt Videobearbeitungsskript mit LVS aus</nowiki>
Die Definition der Funktion sieht wie folgt aus:

: '''clip = LVS(clip''''', string "video", string "audio", string "data"''')'''

:: '''clip''' (1): Ausgabe-Video
:: '''clip''' (2): Eingabe-Video
:: '''string "video"''' (2): Skript zur Videobearbeitung
:: '''string "audio"''' (2): Skript zur Audiobearbeitung
:: '''string "data"''' (2): String zur Übergabe in Skript-Umgebung


===VirtualDub===
VirtualDubs Video-Filterung ist über das Menü "Video", Menüeintrag "Filters...", erreichbar. Über den Button "Add..." lässt sich LVS aus einer Liste von Filtern hinzufügen und anschließend über einen Dialog dessen Skript-Parameter eingeben. Sollte LVS noch nicht in genannter Liste verfügbar sein, kann über den Button "Load..." das Plugin geladen werden.

[[Datei:LVS - VirtualDub.png|800px]]

===DirectShow===
Filter müssen erst als COM Objekt in der Windows-Registry registriert werden, um sie nutzbar für DirectShow gebrauchende Programme zu machen. Dies ist möglich mit dem Kommandozeilen-Programm [[wikipedia:Regsvr32|regsvr32]]. Anschließend hängt es vom Anwenderprogramm ab, wie der Filter geladen wird.

Am Beispiel von [[wikipedia:Media_Player_Classic#Media_Player_Classic_-_Home_Cinema|MPC-HC]] kann über Menü ''View -> Options... -> External Filter'' LVS hinzugefügt, anschließend durch Setzen der Priorität auf 'Prefer' in die Filter-Kette gezwungen und nach Neustart des Programms über Menü ''Play -> Filters -> LVS'' konfiguriert werden.

[[Datei:LVS - DirectShow.png]]

==Skript-Basis==
Basis eines jeden LVS Skripts ist die Filter Funktion, durch welche Frames bzw. Samples geschickt werden.

Im Falle der Videobearbeitung muss diese '''GetFrame''' heißen. Der erste Aufrufparameter ist ein Frame als Bildobjekt, der zweite der Frame Index.
<nowiki>function GetFrame(frame, frame_i)
-- Füll mich
end</nowiki>
Bei Audiobearbeitung lautet der Funktionsname '''GetSamples'''. Der erste Aufrufparameter ist ein Table, die Samples enthaltend, der zweite die Table-Größe des letzteren und der dritte der Sample Index des ersten erhaltenen Samples (kanalübergreifend).
<nowiki>function GetSamples(samples, samples_n, sample_i)
-- Füll mich
end</nowiki>

Metainformationen eines Streams sind als globale Variablen verfügbar. Diese umfassen '''VIDEO_WIDTH''', '''VIDEO_HEIGHT''', '''VIDEO_HAS_ALPHA''', '''VIDEO_FPS''', '''VIDEO_FRAMES''', '''AUDIO_CHANNELS''', '''AUDIO_SAMPLE_RATE''', '''AUDIO_SAMPLES''' und '''USERDATA''' (letzteres ist das ''data'' Argument in Avisynth und ist in beiden Stream-Typen verfügbar).

==Audioprogrammierung==
Samples werden im Format Float32, also einer Amplitudenangabe von -1.0 bis +1.0, und als channel interlaced, also in Kanäle-Blöcken, empfangen.

{| style="border-collapse: collapse; font-size: 8px; line-height: 5px; text-align: center;"
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S1
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S1
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S2
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S2
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S3
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S3
C2
|style="border: solid 3px; border-right-width: 0px; background-color: yellow; width: 24px; padding-top: 8px;"|...
|}
;S = Sample Index
;C = Channel

Unter Zuhilfenahme der Metainformationen, wie die Anzahl an Kanälen und der Sample Rate, lässt sich mit ihnen arbeiten.

<blockquote style="color: red;">TODO</blockquote>

==Grafikprogrammierung==
Frames werden als Bildobjekt empfangen, welches Teil der nutzbaren '''g2d''' Grafikbibliothek ist. Neben dem Bildobjekt gibt es andere Grafikobjekte, welche zur Bearbeitung gebraucht werden. Um all diese zu verwenden, werden über Member-Funktionen ihre Attribute verändert.

Eine Liste der Grafikobjekte:

<blockquote style="color: red;">TODO</blockquote>

==Erweiterungen==
<blockquote style="color: red;">TODO</blockquote>

=Beispiele=
Folgende Beispiele sind Skripte zur Ausführung mit LVS.
==Audio==
Folgende Skripte dienen der Audiobearbeitung.
===Rauschen===
Erstellt ein Rauschen.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
for i = 1, samples_n do
samples[i] = math.random(-1000,1000) / 1000
end
end</nowiki>

===Audio zu Text===
Schreibt Audiodaten als Text in eine Datei.
<nowiki>local file = io.open("audio.txt", "w")
file:write(string.format("Channels: %d\nSample rate: %d\nSamples: %d\n\n", AUDIO_CHANNELS, AUDIO_SAMPLE_RATE, AUDIO_SAMPLES))

function GetSamples(samples, samples_n, start_sample_i)
file:write(table.concat(samples, "\n"))
file:write("\n")
end</nowiki>

==Video==
Folgende Skripte dienen der Videobearbeitung.
===Minimal===
Farben aller Frames werden invertiert.
<nowiki>function GetFrame(frame, frame_i)
frame:invert()
end</nowiki>

===Zeichnen===
Zeichnet eine gelbe Aussenlinie eines Halbkreises.
<nowiki>function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_move_to(100, 100)
ctx:path_line_to(200, 100)
ctx:path_add_arc(150, 100, 50, 0, -180)
ctx:set_line_width(5)
ctx:set_line_join("BEVEL")
ctx:set_source(g2du.yellow)
ctx:stroke()
end</nowiki>

===Text===
"Hello world\nfrom LVS!" mit einem rot-zu-grün Farbverlauf.
<nowiki>local pos = {
x = 100,
y = 100
}
local text_properties = {
"Hello world\nfrom LVS!", -- Text
"Arial", -- Font
50, -- Size
true, -- Bold?
true, -- Italic?
true, -- Underline?
true -- Strikeout?
}
local text_extents = {g2d.text_extents(table.unpack(text_properties))}

function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_add_text(pos.x, pos.y, table.unpack(text_properties))
ctx:set_source(
g2d.create_lgradient(pos.x, pos.y, pos.x + text_extents[1], pos.y + text_extents[2])
:add_color(0, 1,0,0)
:add_color(1, 0,1,0)
)
ctx:fill()
end</nowiki>

===Karaoke===
<nowiki>-- Parse ASS file and fill global tables
ass.load("my_ktime.ass")

-- Roumaji & Kanji
local function roumaji_kanji(ctx, ms, line)
-- Iterate through sylables
for _, syl in ipairs(line.styleref.alignment < 7 and line.chars or line.syls) do -- Use characters in case of kanjis
-- Set color dependent on sylable activity
ctx:set_source(ms >= syl.start_time and ms < syl.end_time and g2du.red or g2du.yellow)
-- Draw sylable text
ctx:path_add_text(syl.x, syl.y, syl.text, ass.unpack_font(line.styleref))
ctx:fill()
ctx:path_clear()
end
end

-- Subtitle
local function subtitle(ctx, line)
-- Draw line text
ctx:path_add_text(line.x, line.y, line.text, ass.unpack_font(line.styleref))
ctx:set_source(g2du.yellow)
ctx:fill()
ctx:path_clear()
end

-- Process frames
function GetFrame(frame, frame_i)
-- Create drawing context for frame
local ctx = frame:get_context()
-- Get frame time
local ms = frame_i / VIDEO_FPS * 1000
-- Look for frame-related ASS lines
for _, line in ipairs(lines) do
if ms >= line.start_time and ms < line.end_time then
-- Draw ASS line
if line.styleref.alignment > 3 then
roumaji_kanji(ctx, ms, line)
else
subtitle(ctx, line)
end
end
end
end</nowiki>

=Videos=
[http://www.mediafire.com/download/i3reijc799edi6v/%5BLVS%5D+Samples.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Karaoke Beispiele</tt>]

[http://www.mediafire.com/download/jfj41pn9xvtbd3w/%5BLVS%5D+Oreimo+S2+-+ED13.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Oreimo S2 ED13</tt>]

=Links=
*[http://sourceforge.net/projects/lua-video-sync/ Projektseite auf Sourceforge]
*[http://forum.youka.de Forum]
[[Category:LVS|{{PAGENAME}}]]

LVS

2013-10-02T09:06:55Z

Youka: /* Grafikprogrammierung */

=LVS=
[[Datei:LVS.png|100px]]

LVS (''"Lua Video Sync"'') ist ein [[wikipedia:Video_filter|Filter]]-[[wikipedia:Plug-in_(computing)|Plugin]] für die populären Windows [[wikipedia:Frameserver|Frameserver]] [[wikipedia:Avisynth|Avisynth]], [[wikipedia:VirtualDub|VirtualDub]] und [[wikipedia:DirectShow|DirectShow]]. Durch Angabe eines Skriptes ([[wikipedia:Lua (programming language)|Lua]] Code enthaltend) als Parameter zum durch das Plugin registrierten Filter lassen sich Videobearbeitungen vornehmen (unter Avisynth auch Audio).

Die Macht der Lua Programmiersprache in Version 5.2, erweitert u.a. durch eine einfache, mächtige [[wikipedia:2D computer graphics|2D Grafik]]bibliothek, ermöglicht eindrucksvolle grafische Bearbeitung von streamenden Video Frames in hoher Geschwindigkeit und mit vielen Mitteln.

=Geschichte=
Die Entwicklung von LVS begann im Jahre 2013 durch den Fansubber "Youka".

Inspiriert von [http://forums.animesuki.com/showthread.php?t=52757 Overlua] wurde LVS als Nachfolger jenes unausgereiften Projektes beschlossen und sollte dessen großes Potenzial, programmatisch und direkt zu [[wikipedia:Rendering (computer graphics)|rendern]] und manipulieren, in einem frischen Gewand ausschöpfen. Als Alternative zu [[wikipedia:Adobe_After_Effects|AFX]] zum typesetten komplexerer Erscheinungen und als mächtigeres Karaoke-FX Werkzeug zu den bisherigen fand es ersten Nutzen bei Fansubbern.

=Definition=
LVS sollte in folgenden Schritten verstanden werden, da es all diese vereint.

==Frameserver plugin==
LVS ist kein eigenständiges Programm, sondern eine Erweiterung für Frameserver, um eine Bearbeitung zwischen der [[wikipedia:Decoder|Dekodierung]] eines Videos und dessen Ausgabe einzufügen. [[wikipedia:Video player (software)|Abspielprogramme]] und [[wikipedia:Encoder#Media|Kodierer]], welche Frameserver nutzen, können somit Filter auf das Eingangsmaterial anwenden, womit ein anderes Ausgangsmaterial entsteht. Nach Hinzufügen von LVS als Filter muss diesem ein Parameter angegeben werden: das Skript, das die Bearbeitung beschreibt.

Im Folgenden wird der Gebrauch von LVS mit den nutzbaren Frameservern gezeigt (dies schließt den Umgang mit den Frameservern selbst nicht ein).

===Avisynth===
Avisynth wird über eine Skriptsprache gesteuert, dementsprechend wird auch LVS eingefügt.
<nowiki>LoadPlugin("E:\LVS\plugin\LVS.dll") #Lädt Plugin 'LVS'/registriert Funktion 'LVS'

BlankClip() #Erstellt einen leeren Clip
LVS("hello.lua") #Führt Videobearbeitungsskript mit LVS aus</nowiki>
Die Definition der Funktion sieht wie folgt aus:

: '''clip = LVS(clip''''', string "video", string "audio", string "data"''')'''

:: '''clip''' (1): Ausgabe-Video
:: '''clip''' (2): Eingabe-Video
:: '''string "video"''' (2): Skript zur Videobearbeitung
:: '''string "audio"''' (2): Skript zur Audiobearbeitung
:: '''string "data"''' (2): String zur Übergabe in Skript-Umgebung


===VirtualDub===
VirtualDubs Video-Filterung ist über das Menü "Video", Menüeintrag "Filters...", erreichbar. Über den Button "Add..." lässt sich LVS aus einer Liste von Filtern hinzufügen und anschließend über einen Dialog dessen Skript-Parameter eingeben. Sollte LVS noch nicht in genannter Liste verfügbar sein, kann über den Button "Load..." das Plugin geladen werden.

[[Datei:LVS - VirtualDub.png|800px]]

===DirectShow===
Filter müssen erst als COM Objekt in der Windows-Registry registriert werden, um sie nutzbar für DirectShow gebrauchende Programme zu machen. Dies ist möglich mit dem Kommandozeilen-Programm [[wikipedia:Regsvr32|regsvr32]]. Anschließend hängt es vom Anwenderprogramm ab, wie der Filter geladen wird.

Am Beispiel von [[wikipedia:Media_Player_Classic#Media_Player_Classic_-_Home_Cinema|MPC-HC]] kann über Menü ''View -> Options... -> External Filter'' LVS hinzugefügt, anschließend durch Setzen der Priorität auf 'Prefer' in die Filter-Kette gezwungen und nach Neustart des Programms über Menü ''Play -> Filters -> LVS'' konfiguriert werden.

[[Datei:LVS - DirectShow.png]]

==Skript-Basis==
Basis eines jeden LVS Skripts ist die Filter Funktion, durch welche Frames bzw. Samples geschickt werden.

Im Falle der Videobearbeitung muss diese '''GetFrame''' heißen. Der erste Aufrufparameter ist ein Frame als Bildobjekt, der zweite der Frame Index.
<nowiki>function GetFrame(frame, frame_i)
-- Füll mich
end</nowiki>
Bei Audiobearbeitung lautet der Funktionsname '''GetSamples'''. Der erste Aufrufparameter ist ein Table, die Samples enthaltend, der zweite die Table-Größe des letzteren und der dritte der Sample Index des ersten erhaltenen Samples (kanalübergreifend).
<nowiki>function GetSamples(samples, samples_n, sample_i)
-- Füll mich
end</nowiki>

Metainformationen eines Streams sind als globale Variablen verfügbar. Diese umfassen '''VIDEO_WIDTH''', '''VIDEO_HEIGHT''', '''VIDEO_HAS_ALPHA''', '''VIDEO_FPS''', '''VIDEO_FRAMES''', '''AUDIO_CHANNELS''', '''AUDIO_SAMPLE_RATE''', '''AUDIO_SAMPLES''' und '''USERDATA''' (letzteres ist das ''data'' Argument in Avisynth und ist in beiden Stream-Typen verfügbar).

==Audioprogrammierung==
Samples werden im Format Float32, also einer Amplitudenangabe von -1.0 bis +1.0, und als channel interlaced, also in Kanäle-Blöcken, empfangen.

{| style="border-collapse: collapse; font-size: 8px; line-height: 5px; text-align: center;"
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S1
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S1
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S2
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S2
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S3
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S3
C2
|style="border: solid 3px; border-right-width: 0px; background-color: yellow; width: 24px; padding-top: 8px;"|...
|}
;S = Sample Index
;C = Channel

Unter Zuhilfenahme der Metainformationen, wie die Anzahl an Kanälen und der Sample Rate, lässt sich mit ihnen arbeiten.

<blockquote style="color: red;">TODO</blockquote>

==Grafikprogrammierung==
Frames werden als Bildobjekt empfangen, welches Teil der nutzbaren '''g2d''' Grafikbibliothek ist. Neben dem Bildobjekt gibt es andere Grafikobjekte, welche zur Bearbeitung gebraucht werden. Um all diese zu verwenden, werden über Member-Funktionen ihre Attribute verändert.

<blockquote style="color: red;">TODO</blockquote>

==Erweiterungen==
<blockquote style="color: red;">TODO</blockquote>

=Beispiele=
Folgende Beispiele sind Skripte zur Ausführung mit LVS.
==Audio==
Folgende Skripte dienen der Audiobearbeitung.
===Rauschen===
Erstellt ein Rauschen.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
for i = 1, samples_n do
samples[i] = math.random(-1000,1000) / 1000
end
end</nowiki>

===Audio zu Text===
Schreibt Audiodaten als Text in eine Datei.
<nowiki>local file = io.open("audio.txt", "w")
file:write(string.format("Channels: %d\nSample rate: %d\nSamples: %d\n\n", AUDIO_CHANNELS, AUDIO_SAMPLE_RATE, AUDIO_SAMPLES))

function GetSamples(samples, samples_n, start_sample_i)
file:write(table.concat(samples, "\n"))
file:write("\n")
end</nowiki>

==Video==
Folgende Skripte dienen der Videobearbeitung.
===Minimal===
Farben aller Frames werden invertiert.
<nowiki>function GetFrame(frame, frame_i)
frame:invert()
end</nowiki>

===Zeichnen===
Zeichnet eine gelbe Aussenlinie eines Halbkreises.
<nowiki>function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_move_to(100, 100)
ctx:path_line_to(200, 100)
ctx:path_add_arc(150, 100, 50, 0, -180)
ctx:set_line_width(5)
ctx:set_line_join("BEVEL")
ctx:set_source(g2du.yellow)
ctx:stroke()
end</nowiki>

===Text===
"Hello world\nfrom LVS!" mit einem rot-zu-grün Farbverlauf.
<nowiki>local pos = {
x = 100,
y = 100
}
local text_properties = {
"Hello world\nfrom LVS!", -- Text
"Arial", -- Font
50, -- Size
true, -- Bold?
true, -- Italic?
true, -- Underline?
true -- Strikeout?
}
local text_extents = {g2d.text_extents(table.unpack(text_properties))}

function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_add_text(pos.x, pos.y, table.unpack(text_properties))
ctx:set_source(
g2d.create_lgradient(pos.x, pos.y, pos.x + text_extents[1], pos.y + text_extents[2])
:add_color(0, 1,0,0)
:add_color(1, 0,1,0)
)
ctx:fill()
end</nowiki>

===Karaoke===
<nowiki>-- Parse ASS file and fill global tables
ass.load("my_ktime.ass")

-- Roumaji & Kanji
local function roumaji_kanji(ctx, ms, line)
-- Iterate through sylables
for _, syl in ipairs(line.styleref.alignment < 7 and line.chars or line.syls) do -- Use characters in case of kanjis
-- Set color dependent on sylable activity
ctx:set_source(ms >= syl.start_time and ms < syl.end_time and g2du.red or g2du.yellow)
-- Draw sylable text
ctx:path_add_text(syl.x, syl.y, syl.text, ass.unpack_font(line.styleref))
ctx:fill()
ctx:path_clear()
end
end

-- Subtitle
local function subtitle(ctx, line)
-- Draw line text
ctx:path_add_text(line.x, line.y, line.text, ass.unpack_font(line.styleref))
ctx:set_source(g2du.yellow)
ctx:fill()
ctx:path_clear()
end

-- Process frames
function GetFrame(frame, frame_i)
-- Create drawing context for frame
local ctx = frame:get_context()
-- Get frame time
local ms = frame_i / VIDEO_FPS * 1000
-- Look for frame-related ASS lines
for _, line in ipairs(lines) do
if ms >= line.start_time and ms < line.end_time then
-- Draw ASS line
if line.styleref.alignment > 3 then
roumaji_kanji(ctx, ms, line)
else
subtitle(ctx, line)
end
end
end
end</nowiki>

=Videos=
[http://www.mediafire.com/download/i3reijc799edi6v/%5BLVS%5D+Samples.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Karaoke Beispiele</tt>]

[http://www.mediafire.com/download/jfj41pn9xvtbd3w/%5BLVS%5D+Oreimo+S2+-+ED13.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Oreimo S2 ED13</tt>]

=Links=
*[http://sourceforge.net/projects/lua-video-sync/ Projektseite auf Sourceforge]
*[http://forum.youka.de Forum]
[[Category:LVS|{{PAGENAME}}]]

LVS

2013-10-02T09:06:16Z

Youka: /* Audioprogrammierung */

=LVS=
[[Datei:LVS.png|100px]]

LVS (''"Lua Video Sync"'') ist ein [[wikipedia:Video_filter|Filter]]-[[wikipedia:Plug-in_(computing)|Plugin]] für die populären Windows [[wikipedia:Frameserver|Frameserver]] [[wikipedia:Avisynth|Avisynth]], [[wikipedia:VirtualDub|VirtualDub]] und [[wikipedia:DirectShow|DirectShow]]. Durch Angabe eines Skriptes ([[wikipedia:Lua (programming language)|Lua]] Code enthaltend) als Parameter zum durch das Plugin registrierten Filter lassen sich Videobearbeitungen vornehmen (unter Avisynth auch Audio).

Die Macht der Lua Programmiersprache in Version 5.2, erweitert u.a. durch eine einfache, mächtige [[wikipedia:2D computer graphics|2D Grafik]]bibliothek, ermöglicht eindrucksvolle grafische Bearbeitung von streamenden Video Frames in hoher Geschwindigkeit und mit vielen Mitteln.

=Geschichte=
Die Entwicklung von LVS begann im Jahre 2013 durch den Fansubber "Youka".

Inspiriert von [http://forums.animesuki.com/showthread.php?t=52757 Overlua] wurde LVS als Nachfolger jenes unausgereiften Projektes beschlossen und sollte dessen großes Potenzial, programmatisch und direkt zu [[wikipedia:Rendering (computer graphics)|rendern]] und manipulieren, in einem frischen Gewand ausschöpfen. Als Alternative zu [[wikipedia:Adobe_After_Effects|AFX]] zum typesetten komplexerer Erscheinungen und als mächtigeres Karaoke-FX Werkzeug zu den bisherigen fand es ersten Nutzen bei Fansubbern.

=Definition=
LVS sollte in folgenden Schritten verstanden werden, da es all diese vereint.

==Frameserver plugin==
LVS ist kein eigenständiges Programm, sondern eine Erweiterung für Frameserver, um eine Bearbeitung zwischen der [[wikipedia:Decoder|Dekodierung]] eines Videos und dessen Ausgabe einzufügen. [[wikipedia:Video player (software)|Abspielprogramme]] und [[wikipedia:Encoder#Media|Kodierer]], welche Frameserver nutzen, können somit Filter auf das Eingangsmaterial anwenden, womit ein anderes Ausgangsmaterial entsteht. Nach Hinzufügen von LVS als Filter muss diesem ein Parameter angegeben werden: das Skript, das die Bearbeitung beschreibt.

Im Folgenden wird der Gebrauch von LVS mit den nutzbaren Frameservern gezeigt (dies schließt den Umgang mit den Frameservern selbst nicht ein).

===Avisynth===
Avisynth wird über eine Skriptsprache gesteuert, dementsprechend wird auch LVS eingefügt.
<nowiki>LoadPlugin("E:\LVS\plugin\LVS.dll") #Lädt Plugin 'LVS'/registriert Funktion 'LVS'

BlankClip() #Erstellt einen leeren Clip
LVS("hello.lua") #Führt Videobearbeitungsskript mit LVS aus</nowiki>
Die Definition der Funktion sieht wie folgt aus:

: '''clip = LVS(clip''''', string "video", string "audio", string "data"''')'''

:: '''clip''' (1): Ausgabe-Video
:: '''clip''' (2): Eingabe-Video
:: '''string "video"''' (2): Skript zur Videobearbeitung
:: '''string "audio"''' (2): Skript zur Audiobearbeitung
:: '''string "data"''' (2): String zur Übergabe in Skript-Umgebung


===VirtualDub===
VirtualDubs Video-Filterung ist über das Menü "Video", Menüeintrag "Filters...", erreichbar. Über den Button "Add..." lässt sich LVS aus einer Liste von Filtern hinzufügen und anschließend über einen Dialog dessen Skript-Parameter eingeben. Sollte LVS noch nicht in genannter Liste verfügbar sein, kann über den Button "Load..." das Plugin geladen werden.

[[Datei:LVS - VirtualDub.png|800px]]

===DirectShow===
Filter müssen erst als COM Objekt in der Windows-Registry registriert werden, um sie nutzbar für DirectShow gebrauchende Programme zu machen. Dies ist möglich mit dem Kommandozeilen-Programm [[wikipedia:Regsvr32|regsvr32]]. Anschließend hängt es vom Anwenderprogramm ab, wie der Filter geladen wird.

Am Beispiel von [[wikipedia:Media_Player_Classic#Media_Player_Classic_-_Home_Cinema|MPC-HC]] kann über Menü ''View -> Options... -> External Filter'' LVS hinzugefügt, anschließend durch Setzen der Priorität auf 'Prefer' in die Filter-Kette gezwungen und nach Neustart des Programms über Menü ''Play -> Filters -> LVS'' konfiguriert werden.

[[Datei:LVS - DirectShow.png]]

==Skript-Basis==
Basis eines jeden LVS Skripts ist die Filter Funktion, durch welche Frames bzw. Samples geschickt werden.

Im Falle der Videobearbeitung muss diese '''GetFrame''' heißen. Der erste Aufrufparameter ist ein Frame als Bildobjekt, der zweite der Frame Index.
<nowiki>function GetFrame(frame, frame_i)
-- Füll mich
end</nowiki>
Bei Audiobearbeitung lautet der Funktionsname '''GetSamples'''. Der erste Aufrufparameter ist ein Table, die Samples enthaltend, der zweite die Table-Größe des letzteren und der dritte der Sample Index des ersten erhaltenen Samples (kanalübergreifend).
<nowiki>function GetSamples(samples, samples_n, sample_i)
-- Füll mich
end</nowiki>

Metainformationen eines Streams sind als globale Variablen verfügbar. Diese umfassen '''VIDEO_WIDTH''', '''VIDEO_HEIGHT''', '''VIDEO_HAS_ALPHA''', '''VIDEO_FPS''', '''VIDEO_FRAMES''', '''AUDIO_CHANNELS''', '''AUDIO_SAMPLE_RATE''', '''AUDIO_SAMPLES''' und '''USERDATA''' (letzteres ist das ''data'' Argument in Avisynth und ist in beiden Stream-Typen verfügbar).

==Audioprogrammierung==
Samples werden im Format Float32, also einer Amplitudenangabe von -1.0 bis +1.0, und als channel interlaced, also in Kanäle-Blöcken, empfangen.

{| style="border-collapse: collapse; font-size: 8px; line-height: 5px; text-align: center;"
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S1
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S1
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S2
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S2
C2
|style="border: solid 3px; background-color: yellow; width: 24px; padding-top: 8px;"|S3
C1
|style="border: solid 3px; background-color: #FFC000; width: 24px; padding-top: 8px;"|S3
C2
|style="border: solid 3px; border-right-width: 0px; background-color: yellow; width: 24px; padding-top: 8px;"|...
|}
;S = Sample Index
;C = Channel

Unter Zuhilfenahme der Metainformationen, wie die Anzahl an Kanälen und der Sample Rate, lässt sich mit ihnen arbeiten.

<blockquote style="color: red;">TODO</blockquote>

==Grafikprogrammierung==
Einzelne Frames werden als Bildobjekt empfangen, welches Teil der nutzbaren '''g2d''' 2D Grafikbibliothek ist. Neben dem Bildobjekt gibt es andere Grafikobjekte, welche zur Bearbeitung gebraucht werden. Um all diese zu verwenden, werden über Member-Funktionen ihre Attribute verändert.

<blockquote style="color: red;">TODO</blockquote>

==Erweiterungen==
<blockquote style="color: red;">TODO</blockquote>

=Beispiele=
Folgende Beispiele sind Skripte zur Ausführung mit LVS.
==Audio==
Folgende Skripte dienen der Audiobearbeitung.
===Rauschen===
Erstellt ein Rauschen.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
for i = 1, samples_n do
samples[i] = math.random(-1000,1000) / 1000
end
end</nowiki>

===Audio zu Text===
Schreibt Audiodaten als Text in eine Datei.
<nowiki>local file = io.open("audio.txt", "w")
file:write(string.format("Channels: %d\nSample rate: %d\nSamples: %d\n\n", AUDIO_CHANNELS, AUDIO_SAMPLE_RATE, AUDIO_SAMPLES))

function GetSamples(samples, samples_n, start_sample_i)
file:write(table.concat(samples, "\n"))
file:write("\n")
end</nowiki>

==Video==
Folgende Skripte dienen der Videobearbeitung.
===Minimal===
Farben aller Frames werden invertiert.
<nowiki>function GetFrame(frame, frame_i)
frame:invert()
end</nowiki>

===Zeichnen===
Zeichnet eine gelbe Aussenlinie eines Halbkreises.
<nowiki>function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_move_to(100, 100)
ctx:path_line_to(200, 100)
ctx:path_add_arc(150, 100, 50, 0, -180)
ctx:set_line_width(5)
ctx:set_line_join("BEVEL")
ctx:set_source(g2du.yellow)
ctx:stroke()
end</nowiki>

===Text===
"Hello world\nfrom LVS!" mit einem rot-zu-grün Farbverlauf.
<nowiki>local pos = {
x = 100,
y = 100
}
local text_properties = {
"Hello world\nfrom LVS!", -- Text
"Arial", -- Font
50, -- Size
true, -- Bold?
true, -- Italic?
true, -- Underline?
true -- Strikeout?
}
local text_extents = {g2d.text_extents(table.unpack(text_properties))}

function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_add_text(pos.x, pos.y, table.unpack(text_properties))
ctx:set_source(
g2d.create_lgradient(pos.x, pos.y, pos.x + text_extents[1], pos.y + text_extents[2])
:add_color(0, 1,0,0)
:add_color(1, 0,1,0)
)
ctx:fill()
end</nowiki>

===Karaoke===
<nowiki>-- Parse ASS file and fill global tables
ass.load("my_ktime.ass")

-- Roumaji & Kanji
local function roumaji_kanji(ctx, ms, line)
-- Iterate through sylables
for _, syl in ipairs(line.styleref.alignment < 7 and line.chars or line.syls) do -- Use characters in case of kanjis
-- Set color dependent on sylable activity
ctx:set_source(ms >= syl.start_time and ms < syl.end_time and g2du.red or g2du.yellow)
-- Draw sylable text
ctx:path_add_text(syl.x, syl.y, syl.text, ass.unpack_font(line.styleref))
ctx:fill()
ctx:path_clear()
end
end

-- Subtitle
local function subtitle(ctx, line)
-- Draw line text
ctx:path_add_text(line.x, line.y, line.text, ass.unpack_font(line.styleref))
ctx:set_source(g2du.yellow)
ctx:fill()
ctx:path_clear()
end

-- Process frames
function GetFrame(frame, frame_i)
-- Create drawing context for frame
local ctx = frame:get_context()
-- Get frame time
local ms = frame_i / VIDEO_FPS * 1000
-- Look for frame-related ASS lines
for _, line in ipairs(lines) do
if ms >= line.start_time and ms < line.end_time then
-- Draw ASS line
if line.styleref.alignment > 3 then
roumaji_kanji(ctx, ms, line)
else
subtitle(ctx, line)
end
end
end
end</nowiki>

=Videos=
[http://www.mediafire.com/download/i3reijc799edi6v/%5BLVS%5D+Samples.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Karaoke Beispiele</tt>]

[http://www.mediafire.com/download/jfj41pn9xvtbd3w/%5BLVS%5D+Oreimo+S2+-+ED13.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Oreimo S2 ED13</tt>]

=Links=
*[http://sourceforge.net/projects/lua-video-sync/ Projektseite auf Sourceforge]
*[http://forum.youka.de Forum]
[[Category:LVS|{{PAGENAME}}]]

LVS

2013-10-02T09:02:46Z

Youka: /* Audioprogrammierung */

=LVS=
[[Datei:LVS.png|100px]]

LVS (''"Lua Video Sync"'') ist ein [[wikipedia:Video_filter|Filter]]-[[wikipedia:Plug-in_(computing)|Plugin]] für die populären Windows [[wikipedia:Frameserver|Frameserver]] [[wikipedia:Avisynth|Avisynth]], [[wikipedia:VirtualDub|VirtualDub]] und [[wikipedia:DirectShow|DirectShow]]. Durch Angabe eines Skriptes ([[wikipedia:Lua (programming language)|Lua]] Code enthaltend) als Parameter zum durch das Plugin registrierten Filter lassen sich Videobearbeitungen vornehmen (unter Avisynth auch Audio).

Die Macht der Lua Programmiersprache in Version 5.2, erweitert u.a. durch eine einfache, mächtige [[wikipedia:2D computer graphics|2D Grafik]]bibliothek, ermöglicht eindrucksvolle grafische Bearbeitung von streamenden Video Frames in hoher Geschwindigkeit und mit vielen Mitteln.

=Geschichte=
Die Entwicklung von LVS begann im Jahre 2013 durch den Fansubber "Youka".

Inspiriert von [http://forums.animesuki.com/showthread.php?t=52757 Overlua] wurde LVS als Nachfolger jenes unausgereiften Projektes beschlossen und sollte dessen großes Potenzial, programmatisch und direkt zu [[wikipedia:Rendering (computer graphics)|rendern]] und manipulieren, in einem frischen Gewand ausschöpfen. Als Alternative zu [[wikipedia:Adobe_After_Effects|AFX]] zum typesetten komplexerer Erscheinungen und als mächtigeres Karaoke-FX Werkzeug zu den bisherigen fand es ersten Nutzen bei Fansubbern.

=Definition=
LVS sollte in folgenden Schritten verstanden werden, da es all diese vereint.

==Frameserver plugin==
LVS ist kein eigenständiges Programm, sondern eine Erweiterung für Frameserver, um eine Bearbeitung zwischen der [[wikipedia:Decoder|Dekodierung]] eines Videos und dessen Ausgabe einzufügen. [[wikipedia:Video player (software)|Abspielprogramme]] und [[wikipedia:Encoder#Media|Kodierer]], welche Frameserver nutzen, können somit Filter auf das Eingangsmaterial anwenden, womit ein anderes Ausgangsmaterial entsteht. Nach Hinzufügen von LVS als Filter muss diesem ein Parameter angegeben werden: das Skript, das die Bearbeitung beschreibt.

Im Folgenden wird der Gebrauch von LVS mit den nutzbaren Frameservern gezeigt (dies schließt den Umgang mit den Frameservern selbst nicht ein).

===Avisynth===
Avisynth wird über eine Skriptsprache gesteuert, dementsprechend wird auch LVS eingefügt.
<nowiki>LoadPlugin("E:\LVS\plugin\LVS.dll") #Lädt Plugin 'LVS'/registriert Funktion 'LVS'

BlankClip() #Erstellt einen leeren Clip
LVS("hello.lua") #Führt Videobearbeitungsskript mit LVS aus</nowiki>
Die Definition der Funktion sieht wie folgt aus:

: '''clip = LVS(clip''''', string "video", string "audio", string "data"''')'''

:: '''clip''' (1): Ausgabe-Video
:: '''clip''' (2): Eingabe-Video
:: '''string "video"''' (2): Skript zur Videobearbeitung
:: '''string "audio"''' (2): Skript zur Audiobearbeitung
:: '''string "data"''' (2): String zur Übergabe in Skript-Umgebung


===VirtualDub===
VirtualDubs Video-Filterung ist über das Menü "Video", Menüeintrag "Filters...", erreichbar. Über den Button "Add..." lässt sich LVS aus einer Liste von Filtern hinzufügen und anschließend über einen Dialog dessen Skript-Parameter eingeben. Sollte LVS noch nicht in genannter Liste verfügbar sein, kann über den Button "Load..." das Plugin geladen werden.

[[Datei:LVS - VirtualDub.png|800px]]

===DirectShow===
Filter müssen erst als COM Objekt in der Windows-Registry registriert werden, um sie nutzbar für DirectShow gebrauchende Programme zu machen. Dies ist möglich mit dem Kommandozeilen-Programm [[wikipedia:Regsvr32|regsvr32]]. Anschließend hängt es vom Anwenderprogramm ab, wie der Filter geladen wird.

Am Beispiel von [[wikipedia:Media_Player_Classic#Media_Player_Classic_-_Home_Cinema|MPC-HC]] kann über Menü ''View -> Options... -> External Filter'' LVS hinzugefügt, anschließend durch Setzen der Priorität auf 'Prefer' in die Filter-Kette gezwungen und nach Neustart des Programms über Menü ''Play -> Filters -> LVS'' konfiguriert werden.

[[Datei:LVS - DirectShow.png]]

==Skript-Basis==
Basis eines jeden LVS Skripts ist die Filter Funktion, durch welche Frames bzw. Samples geschickt werden.

Im Falle der Videobearbeitung muss diese '''GetFrame''' heißen. Der erste Aufrufparameter ist ein Frame als Bildobjekt, der zweite der Frame Index.
<nowiki>function GetFrame(frame, frame_i)
-- Füll mich
end</nowiki>
Bei Audiobearbeitung lautet der Funktionsname '''GetSamples'''. Der erste Aufrufparameter ist ein Table, die Samples enthaltend, der zweite die Table-Größe des letzteren und der dritte der Sample Index des ersten erhaltenen Samples (kanalübergreifend).
<nowiki>function GetSamples(samples, samples_n, sample_i)
-- Füll mich
end</nowiki>

Metainformationen eines Streams sind als globale Variablen verfügbar. Diese umfassen '''VIDEO_WIDTH''', '''VIDEO_HEIGHT''', '''VIDEO_HAS_ALPHA''', '''VIDEO_FPS''', '''VIDEO_FRAMES''', '''AUDIO_CHANNELS''', '''AUDIO_SAMPLE_RATE''', '''AUDIO_SAMPLES''' und '''USERDATA''' (letzteres ist das ''data'' Argument in Avisynth und ist in beiden Stream-Typen verfügbar).

==Audioprogrammierung==
Samples werden im Format Float32, also einer Amplitudenangabe von -1.0 bis +1.0, und als channel interlaced, also in Kanäle-Blöcken, empfangen.

{| style="border-collapse: collapse; font-size: 8px; line-height: 5px; text-align: center;"
|style="border: solid 3px; background-color: yellow; width: 20px;"|S1
C1
|style="border: solid 3px; background-color: #FFC000; width: 20px;"|S1
C2
|style="border: solid 3px; background-color: yellow; width: 20px;"|S2
C1
|style="border: solid 3px; background-color: #FFC000; width: 20px;"|S2
C2
|style="border: solid 3px; background-color: yellow; width: 20px;"|S3
C1
|style="border: solid 3px; background-color: #FFC000; width: 20px;"|S3
C2
|style="border: solid 3px; border-right-width: 0px; background-color: yellow; width: 20px;"|...
|}
;S = Sample Index
;C = Channel

Unter Zuhilfenahme der Metainformationen, wie die Anzahl an Kanälen und der Sample Rate, lässt sich mit ihnen arbeiten.

<blockquote style="color: red;">TODO</blockquote>

==Grafikprogrammierung==
Einzelne Frames werden als Bildobjekt empfangen, welches Teil der nutzbaren '''g2d''' 2D Grafikbibliothek ist. Neben dem Bildobjekt gibt es andere Grafikobjekte, welche zur Bearbeitung gebraucht werden. Um all diese zu verwenden, werden über Member-Funktionen ihre Attribute verändert.

<blockquote style="color: red;">TODO</blockquote>

==Erweiterungen==
<blockquote style="color: red;">TODO</blockquote>

=Beispiele=
Folgende Beispiele sind Skripte zur Ausführung mit LVS.
==Audio==
Folgende Skripte dienen der Audiobearbeitung.
===Rauschen===
Erstellt ein Rauschen.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
for i = 1, samples_n do
samples[i] = math.random(-1000,1000) / 1000
end
end</nowiki>

===Audio zu Text===
Schreibt Audiodaten als Text in eine Datei.
<nowiki>local file = io.open("audio.txt", "w")
file:write(string.format("Channels: %d\nSample rate: %d\nSamples: %d\n\n", AUDIO_CHANNELS, AUDIO_SAMPLE_RATE, AUDIO_SAMPLES))

function GetSamples(samples, samples_n, start_sample_i)
file:write(table.concat(samples, "\n"))
file:write("\n")
end</nowiki>

==Video==
Folgende Skripte dienen der Videobearbeitung.
===Minimal===
Farben aller Frames werden invertiert.
<nowiki>function GetFrame(frame, frame_i)
frame:invert()
end</nowiki>

===Zeichnen===
Zeichnet eine gelbe Aussenlinie eines Halbkreises.
<nowiki>function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_move_to(100, 100)
ctx:path_line_to(200, 100)
ctx:path_add_arc(150, 100, 50, 0, -180)
ctx:set_line_width(5)
ctx:set_line_join("BEVEL")
ctx:set_source(g2du.yellow)
ctx:stroke()
end</nowiki>

===Text===
"Hello world\nfrom LVS!" mit einem rot-zu-grün Farbverlauf.
<nowiki>local pos = {
x = 100,
y = 100
}
local text_properties = {
"Hello world\nfrom LVS!", -- Text
"Arial", -- Font
50, -- Size
true, -- Bold?
true, -- Italic?
true, -- Underline?
true -- Strikeout?
}
local text_extents = {g2d.text_extents(table.unpack(text_properties))}

function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_add_text(pos.x, pos.y, table.unpack(text_properties))
ctx:set_source(
g2d.create_lgradient(pos.x, pos.y, pos.x + text_extents[1], pos.y + text_extents[2])
:add_color(0, 1,0,0)
:add_color(1, 0,1,0)
)
ctx:fill()
end</nowiki>

===Karaoke===
<nowiki>-- Parse ASS file and fill global tables
ass.load("my_ktime.ass")

-- Roumaji & Kanji
local function roumaji_kanji(ctx, ms, line)
-- Iterate through sylables
for _, syl in ipairs(line.styleref.alignment < 7 and line.chars or line.syls) do -- Use characters in case of kanjis
-- Set color dependent on sylable activity
ctx:set_source(ms >= syl.start_time and ms < syl.end_time and g2du.red or g2du.yellow)
-- Draw sylable text
ctx:path_add_text(syl.x, syl.y, syl.text, ass.unpack_font(line.styleref))
ctx:fill()
ctx:path_clear()
end
end

-- Subtitle
local function subtitle(ctx, line)
-- Draw line text
ctx:path_add_text(line.x, line.y, line.text, ass.unpack_font(line.styleref))
ctx:set_source(g2du.yellow)
ctx:fill()
ctx:path_clear()
end

-- Process frames
function GetFrame(frame, frame_i)
-- Create drawing context for frame
local ctx = frame:get_context()
-- Get frame time
local ms = frame_i / VIDEO_FPS * 1000
-- Look for frame-related ASS lines
for _, line in ipairs(lines) do
if ms >= line.start_time and ms < line.end_time then
-- Draw ASS line
if line.styleref.alignment > 3 then
roumaji_kanji(ctx, ms, line)
else
subtitle(ctx, line)
end
end
end
end</nowiki>

=Videos=
[http://www.mediafire.com/download/i3reijc799edi6v/%5BLVS%5D+Samples.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Karaoke Beispiele</tt>]

[http://www.mediafire.com/download/jfj41pn9xvtbd3w/%5BLVS%5D+Oreimo+S2+-+ED13.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Oreimo S2 ED13</tt>]

=Links=
*[http://sourceforge.net/projects/lua-video-sync/ Projektseite auf Sourceforge]
*[http://forum.youka.de Forum]
[[Category:LVS|{{PAGENAME}}]]

LVS

2013-10-02T08:25:34Z

Youka: /* Grafikprogrammierung */

=LVS=
[[Datei:LVS.png|100px]]

LVS (''"Lua Video Sync"'') ist ein [[wikipedia:Video_filter|Filter]]-[[wikipedia:Plug-in_(computing)|Plugin]] für die populären Windows [[wikipedia:Frameserver|Frameserver]] [[wikipedia:Avisynth|Avisynth]], [[wikipedia:VirtualDub|VirtualDub]] und [[wikipedia:DirectShow|DirectShow]]. Durch Angabe eines Skriptes ([[wikipedia:Lua (programming language)|Lua]] Code enthaltend) als Parameter zum durch das Plugin registrierten Filter lassen sich Videobearbeitungen vornehmen (unter Avisynth auch Audio).

Die Macht der Lua Programmiersprache in Version 5.2, erweitert u.a. durch eine einfache, mächtige [[wikipedia:2D computer graphics|2D Grafik]]bibliothek, ermöglicht eindrucksvolle grafische Bearbeitung von streamenden Video Frames in hoher Geschwindigkeit und mit vielen Mitteln.

=Geschichte=
Die Entwicklung von LVS begann im Jahre 2013 durch den Fansubber "Youka".

Inspiriert von [http://forums.animesuki.com/showthread.php?t=52757 Overlua] wurde LVS als Nachfolger jenes unausgereiften Projektes beschlossen und sollte dessen großes Potenzial, programmatisch und direkt zu [[wikipedia:Rendering (computer graphics)|rendern]] und manipulieren, in einem frischen Gewand ausschöpfen. Als Alternative zu [[wikipedia:Adobe_After_Effects|AFX]] zum typesetten komplexerer Erscheinungen und als mächtigeres Karaoke-FX Werkzeug zu den bisherigen fand es ersten Nutzen bei Fansubbern.

=Definition=
LVS sollte in folgenden Schritten verstanden werden, da es all diese vereint.

==Frameserver plugin==
LVS ist kein eigenständiges Programm, sondern eine Erweiterung für Frameserver, um eine Bearbeitung zwischen der [[wikipedia:Decoder|Dekodierung]] eines Videos und dessen Ausgabe einzufügen. [[wikipedia:Video player (software)|Abspielprogramme]] und [[wikipedia:Encoder#Media|Kodierer]], welche Frameserver nutzen, können somit Filter auf das Eingangsmaterial anwenden, womit ein anderes Ausgangsmaterial entsteht. Nach Hinzufügen von LVS als Filter muss diesem ein Parameter angegeben werden: das Skript, das die Bearbeitung beschreibt.

Im Folgenden wird der Gebrauch von LVS mit den nutzbaren Frameservern gezeigt (dies schließt den Umgang mit den Frameservern selbst nicht ein).

===Avisynth===
Avisynth wird über eine Skriptsprache gesteuert, dementsprechend wird auch LVS eingefügt.
<nowiki>LoadPlugin("E:\LVS\plugin\LVS.dll") #Lädt Plugin 'LVS'/registriert Funktion 'LVS'

BlankClip() #Erstellt einen leeren Clip
LVS("hello.lua") #Führt Videobearbeitungsskript mit LVS aus</nowiki>
Die Definition der Funktion sieht wie folgt aus:

: '''clip = LVS(clip''''', string "video", string "audio", string "data"''')'''

:: '''clip''' (1): Ausgabe-Video
:: '''clip''' (2): Eingabe-Video
:: '''string "video"''' (2): Skript zur Videobearbeitung
:: '''string "audio"''' (2): Skript zur Audiobearbeitung
:: '''string "data"''' (2): String zur Übergabe in Skript-Umgebung


===VirtualDub===
VirtualDubs Video-Filterung ist über das Menü "Video", Menüeintrag "Filters...", erreichbar. Über den Button "Add..." lässt sich LVS aus einer Liste von Filtern hinzufügen und anschließend über einen Dialog dessen Skript-Parameter eingeben. Sollte LVS noch nicht in genannter Liste verfügbar sein, kann über den Button "Load..." das Plugin geladen werden.

[[Datei:LVS - VirtualDub.png|800px]]

===DirectShow===
Filter müssen erst als COM Objekt in der Windows-Registry registriert werden, um sie nutzbar für DirectShow gebrauchende Programme zu machen. Dies ist möglich mit dem Kommandozeilen-Programm [[wikipedia:Regsvr32|regsvr32]]. Anschließend hängt es vom Anwenderprogramm ab, wie der Filter geladen wird.

Am Beispiel von [[wikipedia:Media_Player_Classic#Media_Player_Classic_-_Home_Cinema|MPC-HC]] kann über Menü ''View -> Options... -> External Filter'' LVS hinzugefügt, anschließend durch Setzen der Priorität auf 'Prefer' in die Filter-Kette gezwungen und nach Neustart des Programms über Menü ''Play -> Filters -> LVS'' konfiguriert werden.

[[Datei:LVS - DirectShow.png]]

==Skript-Basis==
Basis eines jeden LVS Skripts ist die Filter Funktion, durch welche Frames bzw. Samples geschickt werden.

Im Falle der Videobearbeitung muss diese '''GetFrame''' heißen. Der erste Aufrufparameter ist ein Frame als Bildobjekt, der zweite der Frame Index.
<nowiki>function GetFrame(frame, frame_i)
-- Füll mich
end</nowiki>
Bei Audiobearbeitung lautet der Funktionsname '''GetSamples'''. Der erste Aufrufparameter ist ein Table, die Samples enthaltend, der zweite die Table-Größe des letzteren und der dritte der Sample Index des ersten erhaltenen Samples (kanalübergreifend).
<nowiki>function GetSamples(samples, samples_n, sample_i)
-- Füll mich
end</nowiki>

Metainformationen eines Streams sind als globale Variablen verfügbar. Diese umfassen '''VIDEO_WIDTH''', '''VIDEO_HEIGHT''', '''VIDEO_HAS_ALPHA''', '''VIDEO_FPS''', '''VIDEO_FRAMES''', '''AUDIO_CHANNELS''', '''AUDIO_SAMPLE_RATE''', '''AUDIO_SAMPLES''' und '''USERDATA''' (letzteres ist das ''data'' Argument in Avisynth und ist in beiden Stream-Typen verfügbar).

==Audioprogrammierung==
Samples werden im Format Float32, also einer Amplitudenangabe von -1.0 bis +1.0, und als channel interlaced, also in Kanäle-Blöcken, empfangen.

[[Datei:Samples Interlacing.png]]

Unter Zuhilfenahme der Metainformationen, wie die Anzahl an Kanälen und der Sample Rate, lässt sich mit ihnen arbeiten.

<blockquote style="color: red;">TODO</blockquote>

==Grafikprogrammierung==
Einzelne Frames werden als Bildobjekt empfangen, welches Teil der nutzbaren '''g2d''' 2D Grafikbibliothek ist. Neben dem Bildobjekt gibt es andere Grafikobjekte, welche zur Bearbeitung gebraucht werden. Um all diese zu verwenden, werden über Member-Funktionen ihre Attribute verändert.

<blockquote style="color: red;">TODO</blockquote>

==Erweiterungen==
<blockquote style="color: red;">TODO</blockquote>

=Beispiele=
Folgende Beispiele sind Skripte zur Ausführung mit LVS.
==Audio==
Folgende Skripte dienen der Audiobearbeitung.
===Rauschen===
Erstellt ein Rauschen.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
for i = 1, samples_n do
samples[i] = math.random(-1000,1000) / 1000
end
end</nowiki>

===Audio zu Text===
Schreibt Audiodaten als Text in eine Datei.
<nowiki>local file = io.open("audio.txt", "w")
file:write(string.format("Channels: %d\nSample rate: %d\nSamples: %d\n\n", AUDIO_CHANNELS, AUDIO_SAMPLE_RATE, AUDIO_SAMPLES))

function GetSamples(samples, samples_n, start_sample_i)
file:write(table.concat(samples, "\n"))
file:write("\n")
end</nowiki>

==Video==
Folgende Skripte dienen der Videobearbeitung.
===Minimal===
Farben aller Frames werden invertiert.
<nowiki>function GetFrame(frame, frame_i)
frame:invert()
end</nowiki>

===Zeichnen===
Zeichnet eine gelbe Aussenlinie eines Halbkreises.
<nowiki>function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_move_to(100, 100)
ctx:path_line_to(200, 100)
ctx:path_add_arc(150, 100, 50, 0, -180)
ctx:set_line_width(5)
ctx:set_line_join("BEVEL")
ctx:set_source(g2du.yellow)
ctx:stroke()
end</nowiki>

===Text===
"Hello world\nfrom LVS!" mit einem rot-zu-grün Farbverlauf.
<nowiki>local pos = {
x = 100,
y = 100
}
local text_properties = {
"Hello world\nfrom LVS!", -- Text
"Arial", -- Font
50, -- Size
true, -- Bold?
true, -- Italic?
true, -- Underline?
true -- Strikeout?
}
local text_extents = {g2d.text_extents(table.unpack(text_properties))}

function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_add_text(pos.x, pos.y, table.unpack(text_properties))
ctx:set_source(
g2d.create_lgradient(pos.x, pos.y, pos.x + text_extents[1], pos.y + text_extents[2])
:add_color(0, 1,0,0)
:add_color(1, 0,1,0)
)
ctx:fill()
end</nowiki>

===Karaoke===
<nowiki>-- Parse ASS file and fill global tables
ass.load("my_ktime.ass")

-- Roumaji & Kanji
local function roumaji_kanji(ctx, ms, line)
-- Iterate through sylables
for _, syl in ipairs(line.styleref.alignment < 7 and line.chars or line.syls) do -- Use characters in case of kanjis
-- Set color dependent on sylable activity
ctx:set_source(ms >= syl.start_time and ms < syl.end_time and g2du.red or g2du.yellow)
-- Draw sylable text
ctx:path_add_text(syl.x, syl.y, syl.text, ass.unpack_font(line.styleref))
ctx:fill()
ctx:path_clear()
end
end

-- Subtitle
local function subtitle(ctx, line)
-- Draw line text
ctx:path_add_text(line.x, line.y, line.text, ass.unpack_font(line.styleref))
ctx:set_source(g2du.yellow)
ctx:fill()
ctx:path_clear()
end

-- Process frames
function GetFrame(frame, frame_i)
-- Create drawing context for frame
local ctx = frame:get_context()
-- Get frame time
local ms = frame_i / VIDEO_FPS * 1000
-- Look for frame-related ASS lines
for _, line in ipairs(lines) do
if ms >= line.start_time and ms < line.end_time then
-- Draw ASS line
if line.styleref.alignment > 3 then
roumaji_kanji(ctx, ms, line)
else
subtitle(ctx, line)
end
end
end
end</nowiki>

=Videos=
[http://www.mediafire.com/download/i3reijc799edi6v/%5BLVS%5D+Samples.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Karaoke Beispiele</tt>]

[http://www.mediafire.com/download/jfj41pn9xvtbd3w/%5BLVS%5D+Oreimo+S2+-+ED13.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Oreimo S2 ED13</tt>]

=Links=
*[http://sourceforge.net/projects/lua-video-sync/ Projektseite auf Sourceforge]
*[http://forum.youka.de Forum]
[[Category:LVS|{{PAGENAME}}]]

LVS

2013-10-02T08:24:06Z

Youka: /* Grafikprogrammierung */

=LVS=
[[Datei:LVS.png|100px]]

LVS (''"Lua Video Sync"'') ist ein [[wikipedia:Video_filter|Filter]]-[[wikipedia:Plug-in_(computing)|Plugin]] für die populären Windows [[wikipedia:Frameserver|Frameserver]] [[wikipedia:Avisynth|Avisynth]], [[wikipedia:VirtualDub|VirtualDub]] und [[wikipedia:DirectShow|DirectShow]]. Durch Angabe eines Skriptes ([[wikipedia:Lua (programming language)|Lua]] Code enthaltend) als Parameter zum durch das Plugin registrierten Filter lassen sich Videobearbeitungen vornehmen (unter Avisynth auch Audio).

Die Macht der Lua Programmiersprache in Version 5.2, erweitert u.a. durch eine einfache, mächtige [[wikipedia:2D computer graphics|2D Grafik]]bibliothek, ermöglicht eindrucksvolle grafische Bearbeitung von streamenden Video Frames in hoher Geschwindigkeit und mit vielen Mitteln.

=Geschichte=
Die Entwicklung von LVS begann im Jahre 2013 durch den Fansubber "Youka".

Inspiriert von [http://forums.animesuki.com/showthread.php?t=52757 Overlua] wurde LVS als Nachfolger jenes unausgereiften Projektes beschlossen und sollte dessen großes Potenzial, programmatisch und direkt zu [[wikipedia:Rendering (computer graphics)|rendern]] und manipulieren, in einem frischen Gewand ausschöpfen. Als Alternative zu [[wikipedia:Adobe_After_Effects|AFX]] zum typesetten komplexerer Erscheinungen und als mächtigeres Karaoke-FX Werkzeug zu den bisherigen fand es ersten Nutzen bei Fansubbern.

=Definition=
LVS sollte in folgenden Schritten verstanden werden, da es all diese vereint.

==Frameserver plugin==
LVS ist kein eigenständiges Programm, sondern eine Erweiterung für Frameserver, um eine Bearbeitung zwischen der [[wikipedia:Decoder|Dekodierung]] eines Videos und dessen Ausgabe einzufügen. [[wikipedia:Video player (software)|Abspielprogramme]] und [[wikipedia:Encoder#Media|Kodierer]], welche Frameserver nutzen, können somit Filter auf das Eingangsmaterial anwenden, womit ein anderes Ausgangsmaterial entsteht. Nach Hinzufügen von LVS als Filter muss diesem ein Parameter angegeben werden: das Skript, das die Bearbeitung beschreibt.

Im Folgenden wird der Gebrauch von LVS mit den nutzbaren Frameservern gezeigt (dies schließt den Umgang mit den Frameservern selbst nicht ein).

===Avisynth===
Avisynth wird über eine Skriptsprache gesteuert, dementsprechend wird auch LVS eingefügt.
<nowiki>LoadPlugin("E:\LVS\plugin\LVS.dll") #Lädt Plugin 'LVS'/registriert Funktion 'LVS'

BlankClip() #Erstellt einen leeren Clip
LVS("hello.lua") #Führt Videobearbeitungsskript mit LVS aus</nowiki>
Die Definition der Funktion sieht wie folgt aus:

: '''clip = LVS(clip''''', string "video", string "audio", string "data"''')'''

:: '''clip''' (1): Ausgabe-Video
:: '''clip''' (2): Eingabe-Video
:: '''string "video"''' (2): Skript zur Videobearbeitung
:: '''string "audio"''' (2): Skript zur Audiobearbeitung
:: '''string "data"''' (2): String zur Übergabe in Skript-Umgebung


===VirtualDub===
VirtualDubs Video-Filterung ist über das Menü "Video", Menüeintrag "Filters...", erreichbar. Über den Button "Add..." lässt sich LVS aus einer Liste von Filtern hinzufügen und anschließend über einen Dialog dessen Skript-Parameter eingeben. Sollte LVS noch nicht in genannter Liste verfügbar sein, kann über den Button "Load..." das Plugin geladen werden.

[[Datei:LVS - VirtualDub.png|800px]]

===DirectShow===
Filter müssen erst als COM Objekt in der Windows-Registry registriert werden, um sie nutzbar für DirectShow gebrauchende Programme zu machen. Dies ist möglich mit dem Kommandozeilen-Programm [[wikipedia:Regsvr32|regsvr32]]. Anschließend hängt es vom Anwenderprogramm ab, wie der Filter geladen wird.

Am Beispiel von [[wikipedia:Media_Player_Classic#Media_Player_Classic_-_Home_Cinema|MPC-HC]] kann über Menü ''View -> Options... -> External Filter'' LVS hinzugefügt, anschließend durch Setzen der Priorität auf 'Prefer' in die Filter-Kette gezwungen und nach Neustart des Programms über Menü ''Play -> Filters -> LVS'' konfiguriert werden.

[[Datei:LVS - DirectShow.png]]

==Skript-Basis==
Basis eines jeden LVS Skripts ist die Filter Funktion, durch welche Frames bzw. Samples geschickt werden.

Im Falle der Videobearbeitung muss diese '''GetFrame''' heißen. Der erste Aufrufparameter ist ein Frame als Bildobjekt, der zweite der Frame Index.
<nowiki>function GetFrame(frame, frame_i)
-- Füll mich
end</nowiki>
Bei Audiobearbeitung lautet der Funktionsname '''GetSamples'''. Der erste Aufrufparameter ist ein Table, die Samples enthaltend, der zweite die Table-Größe des letzteren und der dritte der Sample Index des ersten erhaltenen Samples (kanalübergreifend).
<nowiki>function GetSamples(samples, samples_n, sample_i)
-- Füll mich
end</nowiki>

Metainformationen eines Streams sind als globale Variablen verfügbar. Diese umfassen '''VIDEO_WIDTH''', '''VIDEO_HEIGHT''', '''VIDEO_HAS_ALPHA''', '''VIDEO_FPS''', '''VIDEO_FRAMES''', '''AUDIO_CHANNELS''', '''AUDIO_SAMPLE_RATE''', '''AUDIO_SAMPLES''' und '''USERDATA''' (letzteres ist das ''data'' Argument in Avisynth und ist in beiden Stream-Typen verfügbar).

==Audioprogrammierung==
Samples werden im Format Float32, also einer Amplitudenangabe von -1.0 bis +1.0, und als channel interlaced, also in Kanäle-Blöcken, empfangen.

[[Datei:Samples Interlacing.png]]

Unter Zuhilfenahme der Metainformationen, wie die Anzahl an Kanälen und der Sample Rate, lässt sich mit ihnen arbeiten.

<blockquote style="color: red;">TODO</blockquote>

==Grafikprogrammierung==
Einzelne Frames werden als Bildobjekt empfangen, welches Teil der nutzbaren '''g2d''' 2D Grafikbibliothek ist. Neben dem Bildobjekt gibt es auch andere Grafikobjekte, welche zur Bearbeitung gebraucht werden. Um diese zu verwenden, werden über Member-Funktionen ihre Attribute verändert.

<blockquote style="color: red;">TODO</blockquote>

==Erweiterungen==
<blockquote style="color: red;">TODO</blockquote>

=Beispiele=
Folgende Beispiele sind Skripte zur Ausführung mit LVS.
==Audio==
Folgende Skripte dienen der Audiobearbeitung.
===Rauschen===
Erstellt ein Rauschen.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
for i = 1, samples_n do
samples[i] = math.random(-1000,1000) / 1000
end
end</nowiki>

===Audio zu Text===
Schreibt Audiodaten als Text in eine Datei.
<nowiki>local file = io.open("audio.txt", "w")
file:write(string.format("Channels: %d\nSample rate: %d\nSamples: %d\n\n", AUDIO_CHANNELS, AUDIO_SAMPLE_RATE, AUDIO_SAMPLES))

function GetSamples(samples, samples_n, start_sample_i)
file:write(table.concat(samples, "\n"))
file:write("\n")
end</nowiki>

==Video==
Folgende Skripte dienen der Videobearbeitung.
===Minimal===
Farben aller Frames werden invertiert.
<nowiki>function GetFrame(frame, frame_i)
frame:invert()
end</nowiki>

===Zeichnen===
Zeichnet eine gelbe Aussenlinie eines Halbkreises.
<nowiki>function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_move_to(100, 100)
ctx:path_line_to(200, 100)
ctx:path_add_arc(150, 100, 50, 0, -180)
ctx:set_line_width(5)
ctx:set_line_join("BEVEL")
ctx:set_source(g2du.yellow)
ctx:stroke()
end</nowiki>

===Text===
"Hello world\nfrom LVS!" mit einem rot-zu-grün Farbverlauf.
<nowiki>local pos = {
x = 100,
y = 100
}
local text_properties = {
"Hello world\nfrom LVS!", -- Text
"Arial", -- Font
50, -- Size
true, -- Bold?
true, -- Italic?
true, -- Underline?
true -- Strikeout?
}
local text_extents = {g2d.text_extents(table.unpack(text_properties))}

function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_add_text(pos.x, pos.y, table.unpack(text_properties))
ctx:set_source(
g2d.create_lgradient(pos.x, pos.y, pos.x + text_extents[1], pos.y + text_extents[2])
:add_color(0, 1,0,0)
:add_color(1, 0,1,0)
)
ctx:fill()
end</nowiki>

===Karaoke===
<nowiki>-- Parse ASS file and fill global tables
ass.load("my_ktime.ass")

-- Roumaji & Kanji
local function roumaji_kanji(ctx, ms, line)
-- Iterate through sylables
for _, syl in ipairs(line.styleref.alignment < 7 and line.chars or line.syls) do -- Use characters in case of kanjis
-- Set color dependent on sylable activity
ctx:set_source(ms >= syl.start_time and ms < syl.end_time and g2du.red or g2du.yellow)
-- Draw sylable text
ctx:path_add_text(syl.x, syl.y, syl.text, ass.unpack_font(line.styleref))
ctx:fill()
ctx:path_clear()
end
end

-- Subtitle
local function subtitle(ctx, line)
-- Draw line text
ctx:path_add_text(line.x, line.y, line.text, ass.unpack_font(line.styleref))
ctx:set_source(g2du.yellow)
ctx:fill()
ctx:path_clear()
end

-- Process frames
function GetFrame(frame, frame_i)
-- Create drawing context for frame
local ctx = frame:get_context()
-- Get frame time
local ms = frame_i / VIDEO_FPS * 1000
-- Look for frame-related ASS lines
for _, line in ipairs(lines) do
if ms >= line.start_time and ms < line.end_time then
-- Draw ASS line
if line.styleref.alignment > 3 then
roumaji_kanji(ctx, ms, line)
else
subtitle(ctx, line)
end
end
end
end</nowiki>

=Videos=
[http://www.mediafire.com/download/i3reijc799edi6v/%5BLVS%5D+Samples.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Karaoke Beispiele</tt>]

[http://www.mediafire.com/download/jfj41pn9xvtbd3w/%5BLVS%5D+Oreimo+S2+-+ED13.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Oreimo S2 ED13</tt>]

=Links=
*[http://sourceforge.net/projects/lua-video-sync/ Projektseite auf Sourceforge]
*[http://forum.youka.de Forum]
[[Category:LVS|{{PAGENAME}}]]

LVS

2013-10-02T08:18:03Z

Youka: /* Grafikprogrammierung */

=LVS=
[[Datei:LVS.png|100px]]

LVS (''"Lua Video Sync"'') ist ein [[wikipedia:Video_filter|Filter]]-[[wikipedia:Plug-in_(computing)|Plugin]] für die populären Windows [[wikipedia:Frameserver|Frameserver]] [[wikipedia:Avisynth|Avisynth]], [[wikipedia:VirtualDub|VirtualDub]] und [[wikipedia:DirectShow|DirectShow]]. Durch Angabe eines Skriptes ([[wikipedia:Lua (programming language)|Lua]] Code enthaltend) als Parameter zum durch das Plugin registrierten Filter lassen sich Videobearbeitungen vornehmen (unter Avisynth auch Audio).

Die Macht der Lua Programmiersprache in Version 5.2, erweitert u.a. durch eine einfache, mächtige [[wikipedia:2D computer graphics|2D Grafik]]bibliothek, ermöglicht eindrucksvolle grafische Bearbeitung von streamenden Video Frames in hoher Geschwindigkeit und mit vielen Mitteln.

=Geschichte=
Die Entwicklung von LVS begann im Jahre 2013 durch den Fansubber "Youka".

Inspiriert von [http://forums.animesuki.com/showthread.php?t=52757 Overlua] wurde LVS als Nachfolger jenes unausgereiften Projektes beschlossen und sollte dessen großes Potenzial, programmatisch und direkt zu [[wikipedia:Rendering (computer graphics)|rendern]] und manipulieren, in einem frischen Gewand ausschöpfen. Als Alternative zu [[wikipedia:Adobe_After_Effects|AFX]] zum typesetten komplexerer Erscheinungen und als mächtigeres Karaoke-FX Werkzeug zu den bisherigen fand es ersten Nutzen bei Fansubbern.

=Definition=
LVS sollte in folgenden Schritten verstanden werden, da es all diese vereint.

==Frameserver plugin==
LVS ist kein eigenständiges Programm, sondern eine Erweiterung für Frameserver, um eine Bearbeitung zwischen der [[wikipedia:Decoder|Dekodierung]] eines Videos und dessen Ausgabe einzufügen. [[wikipedia:Video player (software)|Abspielprogramme]] und [[wikipedia:Encoder#Media|Kodierer]], welche Frameserver nutzen, können somit Filter auf das Eingangsmaterial anwenden, womit ein anderes Ausgangsmaterial entsteht. Nach Hinzufügen von LVS als Filter muss diesem ein Parameter angegeben werden: das Skript, das die Bearbeitung beschreibt.

Im Folgenden wird der Gebrauch von LVS mit den nutzbaren Frameservern gezeigt (dies schließt den Umgang mit den Frameservern selbst nicht ein).

===Avisynth===
Avisynth wird über eine Skriptsprache gesteuert, dementsprechend wird auch LVS eingefügt.
<nowiki>LoadPlugin("E:\LVS\plugin\LVS.dll") #Lädt Plugin 'LVS'/registriert Funktion 'LVS'

BlankClip() #Erstellt einen leeren Clip
LVS("hello.lua") #Führt Videobearbeitungsskript mit LVS aus</nowiki>
Die Definition der Funktion sieht wie folgt aus:

: '''clip = LVS(clip''''', string "video", string "audio", string "data"''')'''

:: '''clip''' (1): Ausgabe-Video
:: '''clip''' (2): Eingabe-Video
:: '''string "video"''' (2): Skript zur Videobearbeitung
:: '''string "audio"''' (2): Skript zur Audiobearbeitung
:: '''string "data"''' (2): String zur Übergabe in Skript-Umgebung


===VirtualDub===
VirtualDubs Video-Filterung ist über das Menü "Video", Menüeintrag "Filters...", erreichbar. Über den Button "Add..." lässt sich LVS aus einer Liste von Filtern hinzufügen und anschließend über einen Dialog dessen Skript-Parameter eingeben. Sollte LVS noch nicht in genannter Liste verfügbar sein, kann über den Button "Load..." das Plugin geladen werden.

[[Datei:LVS - VirtualDub.png|800px]]

===DirectShow===
Filter müssen erst als COM Objekt in der Windows-Registry registriert werden, um sie nutzbar für DirectShow gebrauchende Programme zu machen. Dies ist möglich mit dem Kommandozeilen-Programm [[wikipedia:Regsvr32|regsvr32]]. Anschließend hängt es vom Anwenderprogramm ab, wie der Filter geladen wird.

Am Beispiel von [[wikipedia:Media_Player_Classic#Media_Player_Classic_-_Home_Cinema|MPC-HC]] kann über Menü ''View -> Options... -> External Filter'' LVS hinzugefügt, anschließend durch Setzen der Priorität auf 'Prefer' in die Filter-Kette gezwungen und nach Neustart des Programms über Menü ''Play -> Filters -> LVS'' konfiguriert werden.

[[Datei:LVS - DirectShow.png]]

==Skript-Basis==
Basis eines jeden LVS Skripts ist die Filter Funktion, durch welche Frames bzw. Samples geschickt werden.

Im Falle der Videobearbeitung muss diese '''GetFrame''' heißen. Der erste Aufrufparameter ist ein Frame als Bildobjekt, der zweite der Frame Index.
<nowiki>function GetFrame(frame, frame_i)
-- Füll mich
end</nowiki>
Bei Audiobearbeitung lautet der Funktionsname '''GetSamples'''. Der erste Aufrufparameter ist ein Table, die Samples enthaltend, der zweite die Table-Größe des letzteren und der dritte der Sample Index des ersten erhaltenen Samples (kanalübergreifend).
<nowiki>function GetSamples(samples, samples_n, sample_i)
-- Füll mich
end</nowiki>

Metainformationen eines Streams sind als globale Variablen verfügbar. Diese umfassen '''VIDEO_WIDTH''', '''VIDEO_HEIGHT''', '''VIDEO_HAS_ALPHA''', '''VIDEO_FPS''', '''VIDEO_FRAMES''', '''AUDIO_CHANNELS''', '''AUDIO_SAMPLE_RATE''', '''AUDIO_SAMPLES''' und '''USERDATA''' (letzteres ist das ''data'' Argument in Avisynth und ist in beiden Stream-Typen verfügbar).

==Audioprogrammierung==
Samples werden im Format Float32, also einer Amplitudenangabe von -1.0 bis +1.0, und als channel interlaced, also in Kanäle-Blöcken, empfangen.

[[Datei:Samples Interlacing.png]]

Unter Zuhilfenahme der Metainformationen, wie die Anzahl an Kanälen und der Sample Rate, lässt sich mit ihnen arbeiten.

<blockquote style="color: red;">TODO</blockquote>

==Grafikprogrammierung==
Einzelne Frames werden als Bildobjekt empfangen, welches Teil der nutzbaren '''g2d''' 2D Grafikbibliothek ist. Um dieses zu verändern, müssen Member-Funktionen aufgerufen werden. Neben dem Bildobjekt gibt es auch andere Grafikobjekte, welche zur Bearbeitung verwendet werden.

<blockquote style="color: red;">TODO</blockquote>

==Erweiterungen==
<blockquote style="color: red;">TODO</blockquote>

=Beispiele=
Folgende Beispiele sind Skripte zur Ausführung mit LVS.
==Audio==
Folgende Skripte dienen der Audiobearbeitung.
===Rauschen===
Erstellt ein Rauschen.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
for i = 1, samples_n do
samples[i] = math.random(-1000,1000) / 1000
end
end</nowiki>

===Audio zu Text===
Schreibt Audiodaten als Text in eine Datei.
<nowiki>local file = io.open("audio.txt", "w")
file:write(string.format("Channels: %d\nSample rate: %d\nSamples: %d\n\n", AUDIO_CHANNELS, AUDIO_SAMPLE_RATE, AUDIO_SAMPLES))

function GetSamples(samples, samples_n, start_sample_i)
file:write(table.concat(samples, "\n"))
file:write("\n")
end</nowiki>

==Video==
Folgende Skripte dienen der Videobearbeitung.
===Minimal===
Farben aller Frames werden invertiert.
<nowiki>function GetFrame(frame, frame_i)
frame:invert()
end</nowiki>

===Zeichnen===
Zeichnet eine gelbe Aussenlinie eines Halbkreises.
<nowiki>function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_move_to(100, 100)
ctx:path_line_to(200, 100)
ctx:path_add_arc(150, 100, 50, 0, -180)
ctx:set_line_width(5)
ctx:set_line_join("BEVEL")
ctx:set_source(g2du.yellow)
ctx:stroke()
end</nowiki>

===Text===
"Hello world\nfrom LVS!" mit einem rot-zu-grün Farbverlauf.
<nowiki>local pos = {
x = 100,
y = 100
}
local text_properties = {
"Hello world\nfrom LVS!", -- Text
"Arial", -- Font
50, -- Size
true, -- Bold?
true, -- Italic?
true, -- Underline?
true -- Strikeout?
}
local text_extents = {g2d.text_extents(table.unpack(text_properties))}

function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_add_text(pos.x, pos.y, table.unpack(text_properties))
ctx:set_source(
g2d.create_lgradient(pos.x, pos.y, pos.x + text_extents[1], pos.y + text_extents[2])
:add_color(0, 1,0,0)
:add_color(1, 0,1,0)
)
ctx:fill()
end</nowiki>

===Karaoke===
<nowiki>-- Parse ASS file and fill global tables
ass.load("my_ktime.ass")

-- Roumaji & Kanji
local function roumaji_kanji(ctx, ms, line)
-- Iterate through sylables
for _, syl in ipairs(line.styleref.alignment < 7 and line.chars or line.syls) do -- Use characters in case of kanjis
-- Set color dependent on sylable activity
ctx:set_source(ms >= syl.start_time and ms < syl.end_time and g2du.red or g2du.yellow)
-- Draw sylable text
ctx:path_add_text(syl.x, syl.y, syl.text, ass.unpack_font(line.styleref))
ctx:fill()
ctx:path_clear()
end
end

-- Subtitle
local function subtitle(ctx, line)
-- Draw line text
ctx:path_add_text(line.x, line.y, line.text, ass.unpack_font(line.styleref))
ctx:set_source(g2du.yellow)
ctx:fill()
ctx:path_clear()
end

-- Process frames
function GetFrame(frame, frame_i)
-- Create drawing context for frame
local ctx = frame:get_context()
-- Get frame time
local ms = frame_i / VIDEO_FPS * 1000
-- Look for frame-related ASS lines
for _, line in ipairs(lines) do
if ms >= line.start_time and ms < line.end_time then
-- Draw ASS line
if line.styleref.alignment > 3 then
roumaji_kanji(ctx, ms, line)
else
subtitle(ctx, line)
end
end
end
end</nowiki>

=Videos=
[http://www.mediafire.com/download/i3reijc799edi6v/%5BLVS%5D+Samples.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Karaoke Beispiele</tt>]

[http://www.mediafire.com/download/jfj41pn9xvtbd3w/%5BLVS%5D+Oreimo+S2+-+ED13.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Oreimo S2 ED13</tt>]

=Links=
*[http://sourceforge.net/projects/lua-video-sync/ Projektseite auf Sourceforge]
*[http://forum.youka.de Forum]
[[Category:LVS|{{PAGENAME}}]]

LVS

2013-10-02T07:58:04Z

Youka: /* Audioprogrammierung */

=LVS=
[[Datei:LVS.png|100px]]

LVS (''"Lua Video Sync"'') ist ein [[wikipedia:Video_filter|Filter]]-[[wikipedia:Plug-in_(computing)|Plugin]] für die populären Windows [[wikipedia:Frameserver|Frameserver]] [[wikipedia:Avisynth|Avisynth]], [[wikipedia:VirtualDub|VirtualDub]] und [[wikipedia:DirectShow|DirectShow]]. Durch Angabe eines Skriptes ([[wikipedia:Lua (programming language)|Lua]] Code enthaltend) als Parameter zum durch das Plugin registrierten Filter lassen sich Videobearbeitungen vornehmen (unter Avisynth auch Audio).

Die Macht der Lua Programmiersprache in Version 5.2, erweitert u.a. durch eine einfache, mächtige [[wikipedia:2D computer graphics|2D Grafik]]bibliothek, ermöglicht eindrucksvolle grafische Bearbeitung von streamenden Video Frames in hoher Geschwindigkeit und mit vielen Mitteln.

=Geschichte=
Die Entwicklung von LVS begann im Jahre 2013 durch den Fansubber "Youka".

Inspiriert von [http://forums.animesuki.com/showthread.php?t=52757 Overlua] wurde LVS als Nachfolger jenes unausgereiften Projektes beschlossen und sollte dessen großes Potenzial, programmatisch und direkt zu [[wikipedia:Rendering (computer graphics)|rendern]] und manipulieren, in einem frischen Gewand ausschöpfen. Als Alternative zu [[wikipedia:Adobe_After_Effects|AFX]] zum typesetten komplexerer Erscheinungen und als mächtigeres Karaoke-FX Werkzeug zu den bisherigen fand es ersten Nutzen bei Fansubbern.

=Definition=
LVS sollte in folgenden Schritten verstanden werden, da es all diese vereint.

==Frameserver plugin==
LVS ist kein eigenständiges Programm, sondern eine Erweiterung für Frameserver, um eine Bearbeitung zwischen der [[wikipedia:Decoder|Dekodierung]] eines Videos und dessen Ausgabe einzufügen. [[wikipedia:Video player (software)|Abspielprogramme]] und [[wikipedia:Encoder#Media|Kodierer]], welche Frameserver nutzen, können somit Filter auf das Eingangsmaterial anwenden, womit ein anderes Ausgangsmaterial entsteht. Nach Hinzufügen von LVS als Filter muss diesem ein Parameter angegeben werden: das Skript, das die Bearbeitung beschreibt.

Im Folgenden wird der Gebrauch von LVS mit den nutzbaren Frameservern gezeigt (dies schließt den Umgang mit den Frameservern selbst nicht ein).

===Avisynth===
Avisynth wird über eine Skriptsprache gesteuert, dementsprechend wird auch LVS eingefügt.
<nowiki>LoadPlugin("E:\LVS\plugin\LVS.dll") #Lädt Plugin 'LVS'/registriert Funktion 'LVS'

BlankClip() #Erstellt einen leeren Clip
LVS("hello.lua") #Führt Videobearbeitungsskript mit LVS aus</nowiki>
Die Definition der Funktion sieht wie folgt aus:

: '''clip = LVS(clip''''', string "video", string "audio", string "data"''')'''

:: '''clip''' (1): Ausgabe-Video
:: '''clip''' (2): Eingabe-Video
:: '''string "video"''' (2): Skript zur Videobearbeitung
:: '''string "audio"''' (2): Skript zur Audiobearbeitung
:: '''string "data"''' (2): String zur Übergabe in Skript-Umgebung


===VirtualDub===
VirtualDubs Video-Filterung ist über das Menü "Video", Menüeintrag "Filters...", erreichbar. Über den Button "Add..." lässt sich LVS aus einer Liste von Filtern hinzufügen und anschließend über einen Dialog dessen Skript-Parameter eingeben. Sollte LVS noch nicht in genannter Liste verfügbar sein, kann über den Button "Load..." das Plugin geladen werden.

[[Datei:LVS - VirtualDub.png|800px]]

===DirectShow===
Filter müssen erst als COM Objekt in der Windows-Registry registriert werden, um sie nutzbar für DirectShow gebrauchende Programme zu machen. Dies ist möglich mit dem Kommandozeilen-Programm [[wikipedia:Regsvr32|regsvr32]]. Anschließend hängt es vom Anwenderprogramm ab, wie der Filter geladen wird.

Am Beispiel von [[wikipedia:Media_Player_Classic#Media_Player_Classic_-_Home_Cinema|MPC-HC]] kann über Menü ''View -> Options... -> External Filter'' LVS hinzugefügt, anschließend durch Setzen der Priorität auf 'Prefer' in die Filter-Kette gezwungen und nach Neustart des Programms über Menü ''Play -> Filters -> LVS'' konfiguriert werden.

[[Datei:LVS - DirectShow.png]]

==Skript-Basis==
Basis eines jeden LVS Skripts ist die Filter Funktion, durch welche Frames bzw. Samples geschickt werden.

Im Falle der Videobearbeitung muss diese '''GetFrame''' heißen. Der erste Aufrufparameter ist ein Frame als Bildobjekt, der zweite der Frame Index.
<nowiki>function GetFrame(frame, frame_i)
-- Füll mich
end</nowiki>
Bei Audiobearbeitung lautet der Funktionsname '''GetSamples'''. Der erste Aufrufparameter ist ein Table, die Samples enthaltend, der zweite die Table-Größe des letzteren und der dritte der Sample Index des ersten erhaltenen Samples (kanalübergreifend).
<nowiki>function GetSamples(samples, samples_n, sample_i)
-- Füll mich
end</nowiki>

Metainformationen eines Streams sind als globale Variablen verfügbar. Diese umfassen '''VIDEO_WIDTH''', '''VIDEO_HEIGHT''', '''VIDEO_HAS_ALPHA''', '''VIDEO_FPS''', '''VIDEO_FRAMES''', '''AUDIO_CHANNELS''', '''AUDIO_SAMPLE_RATE''', '''AUDIO_SAMPLES''' und '''USERDATA''' (letzteres ist das ''data'' Argument in Avisynth und ist in beiden Stream-Typen verfügbar).

==Audioprogrammierung==
Samples werden im Format Float32, also einer Amplitudenangabe von -1.0 bis +1.0, und als channel interlaced, also in Kanäle-Blöcken, empfangen.

[[Datei:Samples Interlacing.png]]

Unter Zuhilfenahme der Metainformationen, wie die Anzahl an Kanälen und der Sample Rate, lässt sich mit ihnen arbeiten.

<blockquote style="color: red;">TODO</blockquote>

==Grafikprogrammierung==
<blockquote style="color: red;">TODO</blockquote>

==Erweiterungen==
<blockquote style="color: red;">TODO</blockquote>

=Beispiele=
Folgende Beispiele sind Skripte zur Ausführung mit LVS.
==Audio==
Folgende Skripte dienen der Audiobearbeitung.
===Rauschen===
Erstellt ein Rauschen.
<nowiki>function GetSamples(samples, samples_n, start_sample_i)
for i = 1, samples_n do
samples[i] = math.random(-1000,1000) / 1000
end
end</nowiki>

===Audio zu Text===
Schreibt Audiodaten als Text in eine Datei.
<nowiki>local file = io.open("audio.txt", "w")
file:write(string.format("Channels: %d\nSample rate: %d\nSamples: %d\n\n", AUDIO_CHANNELS, AUDIO_SAMPLE_RATE, AUDIO_SAMPLES))

function GetSamples(samples, samples_n, start_sample_i)
file:write(table.concat(samples, "\n"))
file:write("\n")
end</nowiki>

==Video==
Folgende Skripte dienen der Videobearbeitung.
===Minimal===
Farben aller Frames werden invertiert.
<nowiki>function GetFrame(frame, frame_i)
frame:invert()
end</nowiki>

===Zeichnen===
Zeichnet eine gelbe Aussenlinie eines Halbkreises.
<nowiki>function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_move_to(100, 100)
ctx:path_line_to(200, 100)
ctx:path_add_arc(150, 100, 50, 0, -180)
ctx:set_line_width(5)
ctx:set_line_join("BEVEL")
ctx:set_source(g2du.yellow)
ctx:stroke()
end</nowiki>

===Text===
"Hello world\nfrom LVS!" mit einem rot-zu-grün Farbverlauf.
<nowiki>local pos = {
x = 100,
y = 100
}
local text_properties = {
"Hello world\nfrom LVS!", -- Text
"Arial", -- Font
50, -- Size
true, -- Bold?
true, -- Italic?
true, -- Underline?
true -- Strikeout?
}
local text_extents = {g2d.text_extents(table.unpack(text_properties))}

function GetFrame(frame, frame_i)
local ctx = frame:get_context()
ctx:path_add_text(pos.x, pos.y, table.unpack(text_properties))
ctx:set_source(
g2d.create_lgradient(pos.x, pos.y, pos.x + text_extents[1], pos.y + text_extents[2])
:add_color(0, 1,0,0)
:add_color(1, 0,1,0)
)
ctx:fill()
end</nowiki>

===Karaoke===
<nowiki>-- Parse ASS file and fill global tables
ass.load("my_ktime.ass")

-- Roumaji & Kanji
local function roumaji_kanji(ctx, ms, line)
-- Iterate through sylables
for _, syl in ipairs(line.styleref.alignment < 7 and line.chars or line.syls) do -- Use characters in case of kanjis
-- Set color dependent on sylable activity
ctx:set_source(ms >= syl.start_time and ms < syl.end_time and g2du.red or g2du.yellow)
-- Draw sylable text
ctx:path_add_text(syl.x, syl.y, syl.text, ass.unpack_font(line.styleref))
ctx:fill()
ctx:path_clear()
end
end

-- Subtitle
local function subtitle(ctx, line)
-- Draw line text
ctx:path_add_text(line.x, line.y, line.text, ass.unpack_font(line.styleref))
ctx:set_source(g2du.yellow)
ctx:fill()
ctx:path_clear()
end

-- Process frames
function GetFrame(frame, frame_i)
-- Create drawing context for frame
local ctx = frame:get_context()
-- Get frame time
local ms = frame_i / VIDEO_FPS * 1000
-- Look for frame-related ASS lines
for _, line in ipairs(lines) do
if ms >= line.start_time and ms < line.end_time then
-- Draw ASS line
if line.styleref.alignment > 3 then
roumaji_kanji(ctx, ms, line)
else
subtitle(ctx, line)
end
end
end
end</nowiki>

=Videos=
[http://www.mediafire.com/download/i3reijc799edi6v/%5BLVS%5D+Samples.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Karaoke Beispiele</tt>]

[http://www.mediafire.com/download/jfj41pn9xvtbd3w/%5BLVS%5D+Oreimo+S2+-+ED13.mp4 <tt style="font-weight:bold; font-size:18px; color:blue;">Oreimo S2 ED13</tt>]

=Links=
*[http://sourceforge.net/projects/lua-video-sync/ Projektseite auf Sourceforge]
*[http://forum.youka.de Forum]
[[Category:LVS|{{PAGENAME}}]]

LVS

2013-10-02T07:25:40Z

Youka:

LVS

2013-10-01T19:26:14Z

Youka: /* Audio als Text */

LVS

2013-10-01T19:17:16Z

Youka:

LVS

2013-10-01T19:09:35Z

Youka:

LVS

2013-10-01T18:58:32Z

Youka: /* Skript-Basis */

LVS

2013-10-01T16:17:00Z

Youka:

LVS

2013-10-01T15:58:49Z

Youka: /* Skript-Basis */

LVS

2013-10-01T15:48:46Z

Youka: /* Skript-Basis */

LVS

2013-10-01T15:34:04Z

Youka:

LVS

2013-10-01T15:33:34Z

Youka: /* DirectShow */

Datei:LVS - DirectShow.png

2013-10-01T15:31:27Z

Youka: DirectShow Filterung mit LVS

DirectShow Filterung mit LVS

LVS

2013-10-01T15:17:35Z

Youka: /* DirectShow */

LVS

2013-10-01T14:45:52Z

Youka: /* VirtualDub */

LVS

2013-10-01T14:39:06Z

Youka:

Datei:LVS - VirtualDub.png

2013-10-01T14:36:30Z

Youka: VirtualDub Filterung mit LVS

VirtualDub Filterung mit LVS

LVS

2013-10-01T14:27:07Z

Youka:

LVS

2013-10-01T13:58:18Z

Youka:

LVS

2013-10-01T13:55:45Z

Youka: Avisynth Nutzung

LVS

2013-10-01T09:52:35Z

Youka: /* Text */

LVS

2013-09-30T19:17:23Z

Youka: /* Geschichte */

LVS

2013-09-29T12:22:50Z

Youka: /* Links */

LVS

2013-09-29T12:21:44Z

Youka: /* Geschichte */

LVS

2013-09-29T12:21:01Z

Youka: /* Geschichte */

LVS

2013-09-29T12:19:40Z

Youka: /* Frameserver plugin */