![]() |
![]()
| ![]() |
![]()
NAMESDL::Pango - Text rendering engineCATEGORYPangoSYNOPSISuse SDL; use SDL::Color; use SDL::Surface; use SDL::Overlay; use SDL::Rect; use SDL::Video; use SDL::PixelFormat; use SDL::Pango; use SDL::Pango::Context; SDL::Pango::init(); my $context = SDL::Pango::Context->new; SDL::Pango::set_default_color($context, 0xA7C344FF, 0); SDL::Pango::set_markup($context, 'Hello <b>W<span foreground="red">o</span><i>r</i><u>l</u>d</b>!', -1); SDL::init(SDL_INIT_VIDEO); my $display = SDL::Video::set_video_mode(640, 480, 32, SDL_SWSURFACE); my $bg = SDL::Video::map_RGB($display->format, 0x12, 0x22, 0x45); SDL::Video::fill_rect($display, SDL::Rect->new(0, 0, 640, 480), $bg); my $surface = SDL::Pango::create_surface_draw($context); SDL::Video::blit_surface($surface, SDL::Rect->new(0, 0, 640, 480), $display, SDL::Rect->new(0, 0, 640, 480)); SDL::Video::update_rect($display, 0, 0, 0, 0); SDL::delay(2000); CONSTANTSThe constants are exported by default. You can avoid this by doing:use SDL::Pango (); and access them directly: SDL::Pango::SDLPANGO_DIRECTION_NEUTRAL; or by choosing the export tags below: Export tag: ':align'
Export tag: ':direction'
METHODSinitSDL::Pango::init(); Initialize the Glib and Pango API. This must be called before using other functions in this library, excepting SDL::Pango::was_init. SDL does not have to be initialized before this call. Returns: always 0. was_initmy $was_init = SDL::Pango::was_init(); Query the initialization status of the Glib and Pango API. You may, of course, use this before SDL::Pango::init to avoid initializing twice in a row. Returns: Non-zero when already initialized. Zero when not initialized. set_default_colorSDL::Pango::set_default_color($context, $foreground, $background); SDL::Pango::set_default_color($context, $r1, $g1, $b1, $a1, $r2, $g2, $b2, $a2); Sets default foreground and background color when rendering text and markup. You can call it with either 2 color-parameters (32-bit RRGGBBAA values), or with 4 separate values for foreground and 4 separate values for background. set_minimum_sizeSDL::Pango::set_minimum_size($context, $width, $height); Sets the minimum size of the drawing rectangle. set_textSDL::Pango::set_text($context, $text, $length); SDL::Pango::set_text($context, $text, $length, $alignment); Set plain text to context. Text must be utf-8. $length chars will be rendered, pass "-1" to render the whole text. $alignment can be:
set_markupSDL::Pango::set_markup($context, $text, $length); Set markup text to context. Text must be utf-8. $length chars will be rendered, pass "-1" to render the whole text. See PangoMarkupFormat <http://library.gnome.org/devel/pango/unstable/PangoMarkupFormat.html> for a description about the markup format. get_layout_widthmy $w = SDL::Pango::get_layout_width($context); Returns the width of the resulting surface of the given text/markup for this context. get_layout_heightmy $h = SDL::Pango::get_layout_height($context); Returns the height of the resulting surface of the given text/markup for this context. set_base_directionSDL::Pango::set_base_direction($context, $direction); Sets the direction of the text to either left-to-right or right-to-left. See "CONSTANTS". set_dpiSDL::Pango::set_dpi($context, $dpi_x, $dpi_y); Sets the DPI (dots per inch) for this context. Default is 96. set_languageSDL::Pango::set_language($context, $language); Sets the language name for this context. See ISO639-2 <http://www.loc.gov/standards/iso639-2/php/code_list.php>. Example: SDL::Pango::set_language($context, "en"); drawSDL::Pango::draw($context, $display, $x, $y); Draws the text or markup to an existing surface at position $x/$y. set_surface_create_argsSDL::Pango::set_surface_create_args($context, $flags, $bits, $r_mask, $g_mask, $b_mask, $a_mask); Sets the argument that are used when creating a surface via SDL::Pango::create_surface_draw. Example: SDL::Pango::set_surface_create_args( $context, SDL_SWSURFACE, 32, 0xFF000000, 0x00FF0000, 0x0000FF00, 0x000000FF ); create_surface_drawmy $surface = SDL::Pango::create_surface_draw($context); Creates a new surface and draws the text/markup. You can specify the attributes of the surfaces using SDL::Pango::set_surface_create_args. AUTHORSSee "AUTHORS" in SDL.SEE ALSOSDL::Pango::Context, SDL::Video, SDL::Surface, SDL::TTF
|