lua-oocairo-matrix(3) [debian man page]

doc::lua-oocairo-matrix(3)				       Lua OO Cairo binding					doc::lua-oocairo-matrix(3)

Name
       lua-oocairo-matrix - Transformation matrix table

Introduction
       Matrix objects are used in Cairo to represent affine transformations like rotation and scaling.	They are used for transforming both fonts
       and paths drawn on surfaces.

       This binding uses normal Lua tables for matrices, with each matrix being an array of six numbers.  You can use any such table when
       supplying a matrix to a method, but the ones returned by this module have a metatable set so that the methods listed below can be called on
       it.

       The "matrix_create" function in the module table can be used to create a new identity matrix.

Methods
       The following methods can be called on a matrix object.	Unless otherwise stated they do not return any values.	The transformations alter
       the matrix you supply by adjusting the numbers in the table, rather than creating a new table.

       mat:invert ()
	   Set mat to its inverse, which will result in a transformation which reverses what it did originally.  Not all matrices have an inverse,
	   and if none can be found then an exception will be thrown.

       mat1:multiply (mat2)
	   Multiply mat1 by mat2, leaving mat2 unchanged.  This has the effect of combining the transformations represented by the two matrices.

       mat:rotate (ang)
	   Apply a rotation by ang radians to mat.

       mat:scale (sx, sy)
	   Apply a scaling transformation to mat.

       mat:transform_distance (x, y)
	   Transform the distance given, using mat, and return two numbers giving the resulting distance.  This will have the same effect as
	   "mat:transform_point()" but without any translation taking place.

       mat:transform_point (x, y)
	   Transform the position of the coordinates, which must be numbers, to the matrix, and return two numbers giving the resulting position.

       mat:translate (x, y)
	   Apply a translation to mat.

1.4								    2011-05-18						doc::lua-oocairo-matrix(3)

doc::lua-oocairo-fontopt(3)				       Lua OO Cairo binding				       doc::lua-oocairo-fontopt(3)

Name
       lua-oocairo-fontopt - options controlling text rendering

Introduction
       A font options object contains options that tell Cairo how to render text on surfaces.  They can be created with the "font_options_create"
       function in the main oocairo module (see lua-oocairo(3)), and retrieved from scaled fonts or context objects with "get_font_options"
       methods.

       Font options objects can be compared with the "==" operator.  Two different objects with the same options set will be considered equal.

Methods
       The following methods are available on font options objects:

       opt:copy ()
	   Returns a new font options object, with identical options to opt.  The two objects will be completely independent, so you can set them
	   to have different options.

       opt:get_antialias ()
	   Get the current antialiasing mode, which will be one of the strings accepted by the "opt:set_antialias()" method.

       opt:get_hint_metrics ()
	   Returns the current hint metrics option, which will be one of the same strings accepted by the "opt:set_hint_metrics()" method.

       opt:get_hint_style ()
	   Get the kind of font hinting done when rendering text.  Returns one of the strings accepted by the "opt:set_hint_style()" method.

       opt:get_subpixel_order ()
	   Returns the current ordering of colour components in pixels used for subpixel rendering, which will be one of the same strings accepted
	   by the "opt:set_subpixel_order()" method.

       opt:hash ()
	   Return a number which can be used as a hash key identifying the particular options in opt.  That is, if you wanted to cache fonts
	   according to the options set on them, you could store them in a table with this hash value as the key.  Two font options objects with
	   the same options will have the same hash value.

       opt:merge (srcopt)
	   Add any options which are set to a non-default value in srcopt to opt if that still has the default value from them.  The options in
	   srcopt will be unchanged.  Nothing is returned.

       opt:set_antialias (antialiastype)
	   Set the antialiasing mode used for drawing.	The argument must be a string or boolean value accepted by the "set_antialias" method on
	   context objects (see lua-oocairo-context(3)).

       opt:set_hint_metrics (hintmetrics)
	   Set the kind of hinting to be applied to the metrics, as opposed to outlines, of the glyphs in a font.  The hintmetrics value must be
	   one of the following strings:

	   default
	   off
	   on
       opt:set_hint_style (hintstyle)
	   Set the kind of font hinting done when rendering text.  The hintstyle value must be one of the following strings:

	   default
	   none
	   slight
	   medium
	   full
       opt:set_subpixel_order (order)
	   Used to inform Cairo of the arrangement of colour components in the pixels of a display device like a monitor.  Only applies if
	   subpixel antialiasing is used.  The order value must be one of the following strings:

	   default
	   rgb
	   bgr
	   vrgb
	   vbgr

	   The last two options refer to vertical arrangements of colours.

1.4								    2011-05-18					       doc::lua-oocairo-fontopt(3)