Copyright	Will Thompson Iñaki García Etxebarria and Jonas Platte
License	LGPL-2.1
Maintainer	Iñaki García Etxebarria
Safe Haskell	Safe-Inferred
Language	Haskell2010

GI.Gsk.Structs.Transform

Contents

Exported types
Methods

Description

The GskTransform structure contains only private data.

Synopsis

newtype Transform = Transform (ManagedPtr Transform)
transformEqual :: (HasCallStack, MonadIO m) => Transform -> Maybe Transform -> m Bool
transformGetCategory :: (HasCallStack, MonadIO m) => Transform -> m TransformCategory
transformInvert :: (HasCallStack, MonadIO m) => Transform -> m (Maybe Transform)
transformMatrix :: (HasCallStack, MonadIO m) => Transform -> Matrix -> m Transform
transformNew :: (HasCallStack, MonadIO m) => m Transform
transformParse :: (HasCallStack, MonadIO m) => Text -> m (Bool, Transform)
transformPerspective :: (HasCallStack, MonadIO m) => Transform -> Float -> m Transform
transformPrint :: (HasCallStack, MonadIO m) => Transform -> String -> m ()
transformRef :: (HasCallStack, MonadIO m) => Transform -> m Transform
transformRotate :: (HasCallStack, MonadIO m) => Transform -> Float -> m Transform
transformRotate3d :: (HasCallStack, MonadIO m) => Transform -> Float -> Vec3 -> m Transform
transformScale :: (HasCallStack, MonadIO m) => Transform -> Float -> Float -> m Transform
transformScale3d :: (HasCallStack, MonadIO m) => Transform -> Float -> Float -> Float -> m Transform
transformTo2d :: (HasCallStack, MonadIO m) => Transform -> m (Float, Float, Float, Float, Float, Float)
transformToAffine :: (HasCallStack, MonadIO m) => Transform -> m (Float, Float, Float, Float)
transformToMatrix :: (HasCallStack, MonadIO m) => Transform -> m Matrix
transformToString :: (HasCallStack, MonadIO m) => Transform -> m Text
transformToTranslate :: (HasCallStack, MonadIO m) => Transform -> m (Float, Float)
transformTransform :: (HasCallStack, MonadIO m) => Transform -> Maybe Transform -> m Transform
transformTransformBounds :: (HasCallStack, MonadIO m) => Transform -> Rect -> m Rect
transformTransformPoint :: (HasCallStack, MonadIO m) => Transform -> Point -> m Point
transformTranslate :: (HasCallStack, MonadIO m) => Transform -> Point -> m Transform
transformTranslate3d :: (HasCallStack, MonadIO m) => Transform -> Point3D -> m Transform
transformUnref :: (HasCallStack, MonadIO m) => Transform -> m ()

Exported types

newtype Transform Source #

Memory-managed wrapper type.

Constructors

Transform (ManagedPtr Transform)

Instances

Instances details

Eq Transform Source #
Instance details Defined in GI.Gsk.Structs.Transform Methods (==) :: Transform -> Transform -> Bool # (/=) :: Transform -> Transform -> Bool #
GBoxed Transform Source #
Instance details Defined in GI.Gsk.Structs.Transform
ManagedPtrNewtype Transform Source #
Instance details Defined in GI.Gsk.Structs.Transform Methods toManagedPtr :: Transform -> ManagedPtr Transform
TypedObject Transform Source #
Instance details Defined in GI.Gsk.Structs.Transform Methods glibType :: IO GType
HasParentTypes Transform Source #
Instance details Defined in GI.Gsk.Structs.Transform
IsGValue (Maybe Transform) Source #	Convert `Transform` to and from `GValue`. See `toGValue` and `fromGValue`.
Instance details Defined in GI.Gsk.Structs.Transform Methods gvalueGType_ :: IO GType gvalueSet_ :: Ptr GValue -> Maybe Transform -> IO () gvalueGet_ :: Ptr GValue -> IO (Maybe Transform)
type ParentTypes Transform Source #
Instance details Defined in GI.Gsk.Structs.Transform type ParentTypes Transform = '[] :: [Type]

Methods

Click to display all available methods, including inherited ones

Expand

Methods

equal, invert, matrix, perspective, print, ref, rotate, rotate3d, scale, scale3d, to2d, toAffine, toMatrix, toString, toTranslate, transform, transformBounds, transformPoint, translate, translate3d, unref.

Getters

getCategory.

Setters

None.

getCategory

transformGetCategory Source #

Arguments

:: (HasCallStack, MonadIO m)
=> Transform	`self`: A `Transform`
-> m TransformCategory	Returns: The category of the transform

Returns the category this transform belongs to.

If self is not invertible, Nothing is returned. Note that inverting Nothing also returns Nothing, which is the correct inverse of Nothing. If you need to differentiate between those cases, you should check self is not Nothing before calling this function.

matrix

transformMatrix Source #

Arguments

:: (HasCallStack, MonadIO m)
=> Transform	`next`: the next transform
-> Matrix	`matrix`: the matrix to multiply `next` with
-> m Transform	Returns: The new transform

Multiplies next with the given matrix.

new

transformNew :: (HasCallStack, MonadIO m) => m Transform Source #

No description available in the introspection data.

parse

transformParse Source #

Arguments

:: (HasCallStack, MonadIO m)
=> Text	`string`: the string to parse
-> m (Bool, Transform)	Returns: `True` if `string` described a valid transform.

Parses the given string into a transform and puts it in outTransform. Strings printed via transformToString can be read in again successfully using this function.

If string does not describe a valid transform, False is returned and Nothing is put in outTransform.

perspective

transformPerspective Source #

Arguments

:: (HasCallStack, MonadIO m)
=> Transform	`next`: the next transform
-> Float	`depth`: distance of the z=0 plane. Lower values give a more flattened pyramid and therefore a more pronounced perspective effect.
-> m Transform	Returns: The new transform

Applies a perspective projection transform. This transform scales points in X and Y based on their Z value, scaling points with positive Z values away from the origin, and those with negative Z values towards the origin. Points on the z=0 plane are unchanged.

print

transformPrint Source #

Arguments

:: (HasCallStack, MonadIO m)
=> Transform	`self`: a `Transform`
-> String	`string`: The string to print into
-> m ()

Converts self into a human-readable string representation suitable for printing that can later be parsed with transformParse.

ref

transformRef Source #

Arguments

:: (HasCallStack, MonadIO m)
=> Transform	`self`: a `Transform`
-> m Transform	Returns: the `Transform` with an additional reference

Acquires a reference on the given Transform.

rotate

transformRotate Source #

Arguments

:: (HasCallStack, MonadIO m)
=> Transform	`next`: the next transform
-> Float	`angle`: the rotation angle, in degrees (clockwise)
-> m Transform	Returns: The new transform

Rotates next angle degrees in 2D - or in 3Dspeak, around the z axis.

rotate3d

transformRotate3d Source #

Arguments

:: (HasCallStack, MonadIO m)
=> Transform	`next`: the next transform
-> Float	`angle`: the rotation angle, in degrees (clockwise)
-> Vec3	`axis`: The rotation axis
-> m Transform	Returns: The new transform

Rotates next angle degrees around axis.

For a rotation in 2D space, use transformRotate.

scale

transformScale Source #

Arguments

:: (HasCallStack, MonadIO m)
=> Transform	`next`: the next transform
-> Float	`factorX`: scaling factor on the X axis
-> Float	`factorY`: scaling factor on the Y axis
-> m Transform	Returns: The new transform

Scales next in 2-dimensional space by the given factors. Use transformScale3d to scale in all 3 dimensions.

scale3d

transformScale3d Source #

Arguments

:: (HasCallStack, MonadIO m)
=> Transform	`next`: the next transform
-> Float	`factorX`: scaling factor on the X axis
-> Float	`factorY`: scaling factor on the Y axis
-> Float	`factorZ`: scaling factor on the Z axis
-> m Transform	Returns: The new transform

Scales next by the given factors.

to2d

transformTo2d Source #

Arguments

:: (HasCallStack, MonadIO m)
=> Transform	`self`: a 2D `Transform`
-> m (Float, Float, Float, Float, Float, Float)

Converts a Transform to a 2D transformation matrix. self must be a 2D transformation. If you are not sure, use transformGetCategory >= TransformCategory2d to check.

The returned values have the following layout:

plain code

 | xx yx |   |  a  b  0 |
 | xy yy | = |  c  d  0 |
 | dx dy |   | tx ty  1 |

This function can be used to convert between a Transform and a matrix type from other 2D drawing libraries, in particular Cairo.

toAffine

transformToAffine Source #

Arguments

:: (HasCallStack, MonadIO m)
=> Transform	`self`: a `Transform`
-> m (Float, Float, Float, Float)

Converts a Transform to 2D affine transformation factors. self must be a 2D transformation. If you are not sure, use transformGetCategory >= TransformCategory2dAffine to check.

toMatrix

transformToMatrix Source #

Arguments

:: (HasCallStack, MonadIO m)
=> Transform	`self`: a `Transform`
-> m Matrix

Computes the actual value of self and stores it in outMatrix. The previous value of outMatrix will be ignored.

toString

transformToString Source #

Arguments

:: (HasCallStack, MonadIO m)
=> Transform	`self`: a `Transform`
-> m Text	Returns: A new string for `self`

Converts a matrix into a string that is suitable for printing and can later be parsed with transformParse.

This is a wrapper around transformPrint, see that function for details.

toTranslate

transformToTranslate Source #

Arguments

:: (HasCallStack, MonadIO m)
=> Transform	`self`: a `Transform`
-> m (Float, Float)

Converts a Transform to a translation operation. self must be a 2D transformation. If you are not sure, use transformGetCategory >= TransformCategory2dTranslate to check.

transform

transformTransform Source #

Arguments

:: (HasCallStack, MonadIO m)
=> Transform	`next`: Transform to apply `other` to
-> Maybe Transform	`other`: Transform to apply
-> m Transform	Returns: The new transform

Applies all the operations from other to next.

transformBounds

transformTransformBounds Source #

Arguments

:: (HasCallStack, MonadIO m)
=> Transform	`self`: a `Transform`
-> Rect	`rect`: a `Rect`
-> m Rect

Transforms a Rect using the given transform self. The result is the bounding box containing the coplanar quad.

transformPoint

transformTransformPoint Source #

Arguments

:: (HasCallStack, MonadIO m)
=> Transform	`self`: a `Transform`
-> Point	`point`: a `Point`
-> m Point

Transforms a Point using the given transform self.

translate

transformTranslate Source #

Arguments

:: (HasCallStack, MonadIO m)
=> Transform	`next`: the next transform
-> Point	`point`: the point to translate the transform by
-> m Transform	Returns: The new transform

Translates next in 2dimensional space by point.

translate3d

transformTranslate3d Source #

Arguments

:: (HasCallStack, MonadIO m)
=> Transform	`next`: the next transform
-> Point3D	`point`: the point to translate the transform by
-> m Transform	Returns: The new transform

Translates next by point.

unref

transformUnref Source #

Arguments

:: (HasCallStack, MonadIO m)
=> Transform	`self`: a `Transform`
-> m ()

Releases a reference on the given Transform.

If the reference was the last, the resources associated to the self are freed.

:: (HasCallStack, MonadIO m)
=> Transform	`first`: the first transform
-> Maybe Transform	`second`: the second transform
-> m Bool	Returns: `True` if the two transforms perform the same operation.

:: (HasCallStack, MonadIO m)
=> Transform	`self`: Transform to invert
-> m (Maybe Transform)	Returns: The inverted transform or `Nothing` if the transform cannot be inverted.