Clutter::Texture(3) An actor for displaying and manipulating images

HIERARCHY

  Glib::Object
  +----Glib::InitiallyUnowned
       +----Clutter::Actor
            +----Clutter::Texture

INTERFACES

  Glib::Object::_Unregistered::ClutterScriptable

METHODS

actor = Clutter::Texture->new ($filename=undef)

  • $filename (string or undef)

actor = $class->new_from_actor ($actor)

  • $actor (Clutter::Actor)

boolean = $texture->set_area_from_rgb_data ($data, $has_alpha, $x, $y, $width, $height, $rowstride, $bpp, $flags)

  • $data (scalar)
  • $has_alpha (boolean)
  • $x (integer)
  • $y (integer)
  • $width (integer)
  • $height (integer)
  • $rowstride (integer)
  • $bpp (integer)
  • $flags (Clutter::TextureFlags)

May croak with a Glib::Error in $@ on failure.

(width, height) = $texture->get_base_size

handle = $texture->get_cogl_texture

$texture->set_cogl_texture ($tex)

  • $tex (handle)

texturequality = $texture->get_filter_quality

$texture->set_filter_quality ($filter_quality)

  • $filter_quality (Clutter::TextureQuality)

boolean = $texture->set_from_file ($filename)

  • $filename (string)

May croak with a Glib::Error in $@ on failure.

boolean = $texture->set_from_rgb_data ($data, $has_alpha, $width, $height, $rowstride, $bpp, $flags)

  • $data (scalar)
  • $has_alpha (boolean)
  • $width (integer)
  • $height (integer)
  • $rowstride (integer)
  • $bpp (integer)
  • $flags (Clutter::TextureFlags)

May croak with a Glib::Error in $@ on failure.

boolean = $texture->set_from_yuv_data ($data, $width, $height, $flags)

  • $data (scalar)
  • $width (integer)
  • $height (integer)
  • $flags (Clutter::TextureFlags)

May croak with a Glib::Error in $@ on failure.

integer = $texture->get_max_tile_waste

PROPERTIES

'cogl-material' (handle : readable / writable)
The underlying COGL material handle used to draw this actor
'cogl-texture' (handle : readable / writable)
The underlying COGL texture handle used to draw this actor
'disable-slicing' (boolean : readable / writable / construct-only / private)
Force the underlying texture to be singlularand not made of of smaller space saving inidivual textures.
'filename' (string : writable)
The full path of the file containing the texture
'filter-quality' (Clutter::TextureQuality : readable / writable / construct / private)
Rendering quality used when drawing the texture.
'keep-aspect-ratio' (boolean : readable / writable / private)
Keep the aspect ratio of the texture when requesting the preferred width or height
'load-async' (boolean : writable / private)
Load files inside a thread to avoid blocking when loading images.
'load-data-async' (boolean : writable / private)
Decode image data files inside a thread to reduce blocking when loading images.
'pixel-format' (Clutter::Cogl::PixelFormat : readable / private)
CoglPixelFormat to use.
'repeat-x' (boolean : readable / writable / private)
Repeat underlying pixbuf rather than scale in x direction.
'repeat-y' (boolean : readable / writable / private)
Repeat underlying pixbuf rather than scale in y direction.
'sync-size' (boolean : readable / writable / private)
Auto sync size of actor to underlying pixbuf dimensions
'tile-waste' (integer : readable / private)
Maximum waste area of a sliced texture

SIGNALS

size-change (Clutter::Texture, integer, integer)
pixbuf-change (Clutter::Texture)
load-finished (Clutter::Texture, gpointer)

ENUMS AND FLAGS

enum Clutter::Cogl::PixelFormat

  • 'any' / 'COGL_PIXEL_FORMAT_ANY'
  • 'a-8' / 'COGL_PIXEL_FORMAT_A_8'
  • 'rgb-565' / 'COGL_PIXEL_FORMAT_RGB_565'
  • 'rgba-4444' / 'COGL_PIXEL_FORMAT_RGBA_4444'
  • 'rgba-5551' / 'COGL_PIXEL_FORMAT_RGBA_5551'
  • 'yuv' / 'COGL_PIXEL_FORMAT_YUV'
  • 'g-8' / 'COGL_PIXEL_FORMAT_G_8'
  • 'rgb-888' / 'COGL_PIXEL_FORMAT_RGB_888'
  • 'bgr-888' / 'COGL_PIXEL_FORMAT_BGR_888'
  • 'rgba-8888' / 'COGL_PIXEL_FORMAT_RGBA_8888'
  • 'bgra-8888' / 'COGL_PIXEL_FORMAT_BGRA_8888'
  • 'argb-8888' / 'COGL_PIXEL_FORMAT_ARGB_8888'
  • 'abgr-8888' / 'COGL_PIXEL_FORMAT_ABGR_8888'
  • 'rgba-8888-pre' / 'COGL_PIXEL_FORMAT_RGBA_8888_PRE'
  • 'bgra-8888-pre' / 'COGL_PIXEL_FORMAT_BGRA_8888_PRE'
  • 'argb-8888-pre' / 'COGL_PIXEL_FORMAT_ARGB_8888_PRE'
  • 'abgr-8888-pre' / 'COGL_PIXEL_FORMAT_ABGR_8888_PRE'
  • 'rgba-4444-pre' / 'COGL_PIXEL_FORMAT_RGBA_4444_PRE'
  • 'rgba-5551-pre' / 'COGL_PIXEL_FORMAT_RGBA_5551_PRE'

flags Clutter::TextureFlags

  • 'none' / 'CLUTTER_TEXTURE_NONE'
  • 'rgb-flag-bgr' / 'CLUTTER_TEXTURE_RGB_FLAG_BGR'
  • 'rgb-flag-premult' / 'CLUTTER_TEXTURE_RGB_FLAG_PREMULT'
  • 'yuv-flag-yuv2' / 'CLUTTER_TEXTURE_YUV_FLAG_YUV2'

enum Clutter::TextureQuality

  • 'low' / 'CLUTTER_TEXTURE_QUALITY_LOW'
  • 'medium' / 'CLUTTER_TEXTURE_QUALITY_MEDIUM'
  • 'high' / 'CLUTTER_TEXTURE_QUALITY_HIGH'

COPYRIGHT

Copyright (C) 2006, 2007, 2008 OpenedHand Ltd

Copyright (C) 2009 Intel Corporation

This module is free software; you can redistribute it and/or modify it under the terms of either:

  • the GNU Lesser General Public Library version 2.1; or
  • the Artistic License, version 2.0.

See Clutter for the full copyright notice.