NyuFX Funktionen: Unterschied zwischen den Versionen
Aus WiFX - The Karaoke Wiki for ASSCalc, NyuFX, Lua, AFX, Tenfex & Templater
Youka (Diskussion | Beiträge) K |
Youka (Diskussion | Beiträge) K (→Shapes) |
||
(14 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
Zeile 1: | Zeile 1: | ||
=Basic= | =Basic= | ||
− | *pack(...) | + | *'''pack(...)''' |
*:Gegenfunktion zu ''unpack''. | *:Gegenfunktion zu ''unpack''. | ||
− | *print(VALUE[, FILENAME]) | + | *'''print(VALUE[, FILENAME])''' |
*:Text-Ausgabe in Log-Fenster oder Datei. | *:Text-Ausgabe in Log-Fenster oder Datei. | ||
=Conversion= | =Conversion= | ||
− | *ASS_ALPHA = convert.a_to_ass(ALPHA) | + | *'''ASS_ALPHA = convert.a_to_ass(ALPHA)''' |
*:Wandelt Alpha-Wert von numerisch zu ASS-String um. | *:Wandelt Alpha-Wert von numerisch zu ASS-String um. | ||
− | *ALPHA = convert.ass_to_a(ASS_ALPHA) | + | *'''ALPHA = convert.ass_to_a(ASS_ALPHA)''' |
*:Wandelt Alpha-Wert von ASS-String zu numerisch um. | *:Wandelt Alpha-Wert von ASS-String zu numerisch um. | ||
− | *ASS_RGB = convert.rgb_to_ass(R,G,B) | + | *'''ASS_RGB = convert.rgb_to_ass(R,G,B)''' |
*:Wandelt Farb-Wert von numerisch zu ASS-String um. | *:Wandelt Farb-Wert von numerisch zu ASS-String um. | ||
− | *R, G, B = convert.ass_to_rgb(ASS_RGB) | + | *'''R, G, B = convert.ass_to_rgb(ASS_RGB)''' |
*:Wandelt Farb-Wert von ASS-String zu numerisch um. | *:Wandelt Farb-Wert von ASS-String zu numerisch um. | ||
− | *PIXELS = convert.text_to_pixels(TEXT, STYLE) | + | *'''PIXELS = convert.text_to_pixels(TEXT, STYLE)''' |
*:Gibt Pixelinformationen zu gegebenen Text + Style/Font zurück. | *:Gibt Pixelinformationen zu gegebenen Text + Style/Font zurück. | ||
− | *SHAPE = convert.text_to_shape(TEXT, STYLE) | + | *'''SHAPE = convert.text_to_shape(TEXT, STYLE)''' |
− | *:Gibt gegebenen Text + Style/Font als | + | *:Gibt gegebenen Text + Style/Font als Zeichnung zurück. |
− | *PIXELS = convert.shape_to_pixels(SHAPE[, DOWNSCALE]) | + | *'''PIXELS = convert.shape_to_pixels(SHAPE[, DOWNSCALE])''' |
− | *:Gibt Pixelinformationen zu | + | *:Gibt Pixelinformationen zu gegebener Zeichnung zurück. |
− | *PIXELS = convert.image_to_pixels(FILENAME) | + | *'''PIXELS = convert.image_to_pixels(FILENAME)''' |
*:Gibt Pixelinformationen zu gegebenen .bmp/.ico/.tga/.jpeg/.png Bild zurück. | *:Gibt Pixelinformationen zu gegebenen .bmp/.ico/.tga/.jpeg/.png Bild zurück. | ||
+ | |||
=Input/Output= | =Input/Output= | ||
− | * | + | *'''io.load_ass(ASS_FILE)''' |
− | *: | + | *:Erlaubt erneutes Laden einer ASS Datei zu Werten in Lua. |
− | * | + | *'''io.progressbar(PERCENT)''' |
− | *: | + | *:Setzt Prozessbalken. |
− | * | + | *'''io.write_line(LINE)''' |
− | *: | + | *:Schreiben einer Dialogzeile in die Ausgabe-Datei. |
+ | |||
=Math= | =Math= | ||
− | * | + | *'''POINT = math.bezier(PERCENT, POINTS)''' |
− | *: | + | *:Berechnung eines Punktes auf einer Bezierkurve. |
− | * | + | *'''LENGTH = math.distance(WIDTH, HEIGHT[, DEPTH])''' |
− | *: | + | *:Satz des Pythagoras zur Abstandsberechnung. |
− | * | + | *'''NEW_X, NEW_Y = math.ellipse(X, Y, WIDTH, HEIGHT, ANGLE)''' |
− | *: | + | *:Berechnung eines Punktes auf einer Ellipse. |
− | * | + | *'''RANDOM_NUMBER = math.randomsteps(START, END, STRIDE)''' |
− | *: | + | *:Generierung einer Zufallszahl mit gewünschtem Anfang, Ende und Abweichungsgrad. |
− | * | + | *'''DIRECTION = math.randomway()''' |
− | *: | + | *:Zufällige Generierung von -1 oder 1. |
− | * | + | *'''ROTATED_POINT = math.rotate(POINT, AXIS, ANGLE)''' |
− | *: | + | *:Berechnung eines Punktes nach einer Rotation um eine Gradzahl an einer Achse. |
− | * | + | *'''INTEGER = math.round(NUMBER)''' |
− | *: | + | *:Effektives Runden einer Zahl. |
− | * | + | *'''TRIMMED_NUMBER = math.trim(NUMBER, MIN, MAX)''' |
− | *: | + | *:Eine Zahl in einen Zahlenraum begrenzen. |
=Shapes= | =Shapes= | ||
− | * | + | *'''MIN_X, MIN_Y, MAX_X, MAX_Y = shape.bounding(SHAPE)''' |
− | *: | + | *:Innerer gebundener Rahmen einer Zeichnung. |
− | * | + | *'''SHAPE = shape.ellipse(WIDTH, HEIGHT)''' |
− | *: | + | *:Benutzerspezifische Ellipse als Zeichnung. |
− | * | + | *'''SHAPE = shape.filter(SHAPE, FILTER)''' |
− | *: | + | *:Manipulation von Punkten einer Zeichnung über eine Filter-Funktion. |
− | * | + | *'''SHAPE = shape.glance(EDGES, INNER_DISTANCE, OUTER_DISTANCE)''' |
− | *: | + | *:Benutzerspezifisches Glanz Objekt als Zeichnung. |
− | * | + | *'''SHAPE = shape.heart(SIZE, CENTER_Y_OFFSET)''' |
− | *: | + | *:Benutzerspezifisches Herz Objekt als Zeichnung. |
− | * | + | *'''SHAPE = shape.move(SHAPE, X, Y)''' |
− | *: | + | *:Bewegung aller Punkte einer Zeichnung. |
− | * | + | *'''SHAPE = shape.rectangle(WIDTH, HEIGHT)''' |
− | *: | + | *:Benutzerspezifisches Rechteck als Zeichnung. |
− | * | + | *'''SHAPE = shape.split(SHAPE[, LINE_LENGTH])''' |
− | *: | + | *:Umwandlung von Kurven in Linien und Trennung von Linien in gewünscht kleinere Segmente einer Zeichnung. |
− | * | + | *'''SHAPE = shape.star(EDGES, INNER_DISTANCE, OUTER_DISTANCE)''' |
− | *: | + | *:Benutzerspezifisches Stern Objekt als Zeichnung. |
− | * | + | *'''SHAPE = shape.tooutline(SHAPE, LINE_WIDTH)''' |
− | *: | + | *:Umwandlung einer Zeichnung zur Füllung eines Objektes zu einer Zeichnung zur Füllung der Aussenlinie. |
− | * | + | *'''SHAPE = shape.triangle(SIDE_LENGTH)''' |
− | *: | + | *:Benutzerspezifisches Dreieck als Zeichnung. |
− | * | + | *'''TRANSV_OBJ = shape.transverter()''' |
− | *: | + | *'''TRANSV_OBJ:add(TAGGED_SHAPE)''' |
+ | *'''TAGGED_SHAPES = TRANSV_OBJ:get()''' | ||
+ | *:Verbindung von attributunterschiedlichen Zeichnungen entgegen der üblichen Verschiebungen. | ||
+ | |||
=Strings= | =Strings= | ||
− | * | + | *'''UTF8_STRING = string.uc_to_utf8(UNICODE)''' |
− | *: | + | *:Umwandlung von UTF16 in UTF8. |
− | * | + | *'''RANGE = string.ucharrange(TEXT, INDEX)''' |
− | *: | + | *:Länge eines Unicode Charakters in Byte/UTF8 Charakter. |
− | * | + | *'''INDEX, CHAR = string.uchars(TEXT)''' |
− | *: | + | *:Schleifen-Funktion. Gibt in jedem Durchgang einen Unicode Charakter zurück. |
− | * | + | *'''LENGTH = string.ulen(TEXT)''' |
− | *: | + | *:Unicode Länge eines Textes. |
+ | |||
=Tables= | =Tables= | ||
− | * | + | *'''table.append(TABLE1, TABLE2)''' |
− | *: | + | *:Anfügen eines Tables an einen anderen. |
− | * | + | *'''TABLECOPY = table.copy(TABLE)''' |
− | *: | + | *:Tiefe Kopie eines Tables (echte Kopie, keine Referenzierung). |
− | * | + | *'''SIZE = table.max(TABLE)''' |
− | *: | + | *:Größe eines Tables, einschließlich Array und Hash-Table. |
− | * | + | *'''DESCRIPTION = table.tostring(TABLE)''' |
− | *: | + | *:Textuelle Beschreibung eines Tables. |
+ | |||
=Utils= | =Utils= | ||
− | *DIST_OBJ = utils.distributor(TABLE) | + | *'''DIST_OBJ = utils.distributor(TABLE)''' |
− | * | + | *'''VALUE = DIST_OBJ:get()''' |
*:Hält einen Table und gibt nacheinander Werte zurück. | *:Hält einen Table und gibt nacheinander Werte zurück. | ||
− | *FRAME_START, FRAME_END, INDEX, FRAMES = utils.frames(START_TIME, END_TIME, STRIDE) | + | *'''FRAME_START, FRAME_END, INDEX, FRAMES = utils.frames(START_TIME, END_TIME, STRIDE)''' |
*:Schleifen-Funktion. Einfaches Erstellen von Frame-für-Frame Dialogzeilen. | *:Schleifen-Funktion. Einfaches Erstellen von Frame-für-Frame Dialogzeilen. | ||
− | *VALUE = utils.interpolate(PERCENT, VALUE1, VALUE2[, FILTER]) | + | *'''VALUE = utils.interpolate(PERCENT, VALUE1, VALUE2[, FILTER])''' |
*:Interpolation von Zahlen, ASS-Farben und ASS-Alpha. | *:Interpolation von Zahlen, ASS-Farben und ASS-Alpha. | ||
− | *WIDTH, HEIGHT, ASCENT, DESCENT, INTLEAD, EXTLEAD = utils.textextents(TEXT, STYLE) | + | *'''WIDTH, HEIGHT, ASCENT, DESCENT, INTLEAD, EXTLEAD = utils.textextents(TEXT, STYLE)''' |
*:Berechnung der Größen des gegebenen Texts + Styles/Fonts. | *:Berechnung der Größen des gegebenen Texts + Styles/Fonts. | ||
+ | |||
=Weitere Informationen= | =Weitere Informationen= | ||
Die offiziellen Dokumentationen, welche dem Programm beiliegen, sind weitaus ausführlicher, daher ist zu raten, diese eher in Betracht zu ziehen. | Die offiziellen Dokumentationen, welche dem Programm beiliegen, sind weitaus ausführlicher, daher ist zu raten, diese eher in Betracht zu ziehen. | ||
− | |||
[[Category:NyuFX|{{PAGENAME}}]] | [[Category:NyuFX|{{PAGENAME}}]] |
Aktuelle Version vom 7. April 2012, 10:46 Uhr
Inhaltsverzeichnis
Basic
- pack(...)
- Gegenfunktion zu unpack.
- print(VALUE[, FILENAME])
- Text-Ausgabe in Log-Fenster oder Datei.
Conversion
- ASS_ALPHA = convert.a_to_ass(ALPHA)
- Wandelt Alpha-Wert von numerisch zu ASS-String um.
- ALPHA = convert.ass_to_a(ASS_ALPHA)
- Wandelt Alpha-Wert von ASS-String zu numerisch um.
- ASS_RGB = convert.rgb_to_ass(R,G,B)
- Wandelt Farb-Wert von numerisch zu ASS-String um.
- R, G, B = convert.ass_to_rgb(ASS_RGB)
- Wandelt Farb-Wert von ASS-String zu numerisch um.
- PIXELS = convert.text_to_pixels(TEXT, STYLE)
- Gibt Pixelinformationen zu gegebenen Text + Style/Font zurück.
- SHAPE = convert.text_to_shape(TEXT, STYLE)
- Gibt gegebenen Text + Style/Font als Zeichnung zurück.
- PIXELS = convert.shape_to_pixels(SHAPE[, DOWNSCALE])
- Gibt Pixelinformationen zu gegebener Zeichnung zurück.
- PIXELS = convert.image_to_pixels(FILENAME)
- Gibt Pixelinformationen zu gegebenen .bmp/.ico/.tga/.jpeg/.png Bild zurück.
Input/Output
- io.load_ass(ASS_FILE)
- Erlaubt erneutes Laden einer ASS Datei zu Werten in Lua.
- io.progressbar(PERCENT)
- Setzt Prozessbalken.
- io.write_line(LINE)
- Schreiben einer Dialogzeile in die Ausgabe-Datei.
Math
- POINT = math.bezier(PERCENT, POINTS)
- Berechnung eines Punktes auf einer Bezierkurve.
- LENGTH = math.distance(WIDTH, HEIGHT[, DEPTH])
- Satz des Pythagoras zur Abstandsberechnung.
- NEW_X, NEW_Y = math.ellipse(X, Y, WIDTH, HEIGHT, ANGLE)
- Berechnung eines Punktes auf einer Ellipse.
- RANDOM_NUMBER = math.randomsteps(START, END, STRIDE)
- Generierung einer Zufallszahl mit gewünschtem Anfang, Ende und Abweichungsgrad.
- DIRECTION = math.randomway()
- Zufällige Generierung von -1 oder 1.
- ROTATED_POINT = math.rotate(POINT, AXIS, ANGLE)
- Berechnung eines Punktes nach einer Rotation um eine Gradzahl an einer Achse.
- INTEGER = math.round(NUMBER)
- Effektives Runden einer Zahl.
- TRIMMED_NUMBER = math.trim(NUMBER, MIN, MAX)
- Eine Zahl in einen Zahlenraum begrenzen.
Shapes
- MIN_X, MIN_Y, MAX_X, MAX_Y = shape.bounding(SHAPE)
- Innerer gebundener Rahmen einer Zeichnung.
- SHAPE = shape.ellipse(WIDTH, HEIGHT)
- Benutzerspezifische Ellipse als Zeichnung.
- SHAPE = shape.filter(SHAPE, FILTER)
- Manipulation von Punkten einer Zeichnung über eine Filter-Funktion.
- SHAPE = shape.glance(EDGES, INNER_DISTANCE, OUTER_DISTANCE)
- Benutzerspezifisches Glanz Objekt als Zeichnung.
- SHAPE = shape.heart(SIZE, CENTER_Y_OFFSET)
- Benutzerspezifisches Herz Objekt als Zeichnung.
- SHAPE = shape.move(SHAPE, X, Y)
- Bewegung aller Punkte einer Zeichnung.
- SHAPE = shape.rectangle(WIDTH, HEIGHT)
- Benutzerspezifisches Rechteck als Zeichnung.
- SHAPE = shape.split(SHAPE[, LINE_LENGTH])
- Umwandlung von Kurven in Linien und Trennung von Linien in gewünscht kleinere Segmente einer Zeichnung.
- SHAPE = shape.star(EDGES, INNER_DISTANCE, OUTER_DISTANCE)
- Benutzerspezifisches Stern Objekt als Zeichnung.
- SHAPE = shape.tooutline(SHAPE, LINE_WIDTH)
- Umwandlung einer Zeichnung zur Füllung eines Objektes zu einer Zeichnung zur Füllung der Aussenlinie.
- SHAPE = shape.triangle(SIDE_LENGTH)
- Benutzerspezifisches Dreieck als Zeichnung.
- TRANSV_OBJ = shape.transverter()
- TRANSV_OBJ:add(TAGGED_SHAPE)
- TAGGED_SHAPES = TRANSV_OBJ:get()
- Verbindung von attributunterschiedlichen Zeichnungen entgegen der üblichen Verschiebungen.
Strings
- UTF8_STRING = string.uc_to_utf8(UNICODE)
- Umwandlung von UTF16 in UTF8.
- RANGE = string.ucharrange(TEXT, INDEX)
- Länge eines Unicode Charakters in Byte/UTF8 Charakter.
- INDEX, CHAR = string.uchars(TEXT)
- Schleifen-Funktion. Gibt in jedem Durchgang einen Unicode Charakter zurück.
- LENGTH = string.ulen(TEXT)
- Unicode Länge eines Textes.
Tables
- table.append(TABLE1, TABLE2)
- Anfügen eines Tables an einen anderen.
- TABLECOPY = table.copy(TABLE)
- Tiefe Kopie eines Tables (echte Kopie, keine Referenzierung).
- SIZE = table.max(TABLE)
- Größe eines Tables, einschließlich Array und Hash-Table.
- DESCRIPTION = table.tostring(TABLE)
- Textuelle Beschreibung eines Tables.
Utils
- DIST_OBJ = utils.distributor(TABLE)
- VALUE = DIST_OBJ:get()
- Hält einen Table und gibt nacheinander Werte zurück.
- FRAME_START, FRAME_END, INDEX, FRAMES = utils.frames(START_TIME, END_TIME, STRIDE)
- Schleifen-Funktion. Einfaches Erstellen von Frame-für-Frame Dialogzeilen.
- VALUE = utils.interpolate(PERCENT, VALUE1, VALUE2[, FILTER])
- Interpolation von Zahlen, ASS-Farben und ASS-Alpha.
- WIDTH, HEIGHT, ASCENT, DESCENT, INTLEAD, EXTLEAD = utils.textextents(TEXT, STYLE)
- Berechnung der Größen des gegebenen Texts + Styles/Fonts.
Weitere Informationen
Die offiziellen Dokumentationen, welche dem Programm beiliegen, sind weitaus ausführlicher, daher ist zu raten, diese eher in Betracht zu ziehen.