Imager::Inline(3pm)					User Contributed Perl Documentation				       Imager::Inline(3pm)

NAME

       Imager::Inline - using Imager with Inline::C.

SYNOPSIS

	 use Inline with => 'Imager';
	 use Inline C => <<'EOS';
	 Imager some_func(Imager::Color c, Imager::Fill f) {
	   Imager img = i_img_8_new(200, 200, 3);
	   /* fill with color */
	   i_box_filled(img, 0, 0, 199, 199, c);
	   /* inner area with fill */
	   i_box_cfill(img, 50, 50, 149, 149, f);

	   return img;
	 }
	 EOS

DESCRIPTION

       Imager hooks into Inline's "with" syntax to make it easier to write Inline::C code that works with Imager, you can call Imager functions
       without having to include headers or perform initialization.

       Imager's Inline "with" support does the following:

       o   add the installed Imager include directory to INC

       o   add the Imager typemap to TYPEMAPS

       o   include the headers needed by Imager C extension modules.

       o   declare and initialize the Imager API function table pointer

       o   filter the supplied code to replace Imager's class names with those that Inline::C can handle.

LIMITATIONS

       The filtering mechanism is global, it will replace the class names even inside string constants.  If you need a string matching the name of
       one of Imager's classes, like "Imager::Color" you will need to split it into 2 to use C's string pasting mechanism, for example: "Imager:"
       ":Color".

AUTHOR

       Tony Cook <tonyc@cpan.org>

REVISION

       $Revision$

SEE ALSO

       Imager, Imager::ExtUtils, Imager::API, Imager::APIRef, samples/inline_replace_color.pl

perl v5.14.2							    2011-06-06						       Imager::Inline(3pm)