NyuFX Funktionen: Unterschied zwischen den Versionen

Aus WiFX - The Karaoke Wiki for ASSCalc, NyuFX, Lua, AFX, Tenfex & Templater
Wechseln zu: Navigation, Suche
Zeile 29: Zeile 29:
 
*:Schreiben einer Dialogzeile in die Ausgabe Datei.
 
*: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=
 
*
 
*
Zeile 71: Zeile 71:
 
*:
 
*:
 
=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 Charaktern.
*
+
*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 einer anderen.
*
+
*TABLECOPY = table.copy(TABLE)
*:
+
*:Tiefe Kopie eines Tables (Umgehung einer 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)

Version vom 3. April 2012, 06:33 Uhr

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 Shape zurück.
  • PIXELS = convert.shape_to_pixels(SHAPE[, DOWNSCALE])
    Gibt Pixelinformationen zu gegebenen Shape 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

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 Charaktern.
  • 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 einer anderen.
  • TABLECOPY = table.copy(TABLE)
    Tiefe Kopie eines Tables (Umgehung einer 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)
  • 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.