<!-- clanlib header begin --> <HTML> <HEAD> <TITLE>CL_GlyphBuffer::add - ClanLib Game SDK</TITLE> <STYLE TYPE="text/css"><!-- HTML BODY { font-family: verdana, helvetica, sans-serif; font-size: 12px; } H1 { font-size: 22px; } H2 { font-size: 18px; } H3 { font-size: 16px; } H4 { font-size: 14px; } P { font-size: 12px; } LI { font-size: 12px; } --></STYLE> </HEAD> <body bgcolor=white text=black link=blue vlink=#800080> <center> <img src="http://clanlib.org/gfx/clanlib.png"> </center> <!-- clanlib header end --> <center> <p> <a href="http://clanlib.org/docs.html">Home</a> | <a href="classes.html">All Classes</a> | <a href="modules.html">Grouped Classes</a> | <a href="index.html">Index</a> | <a href="search.html">Search</a> </p> </center> <h1>CL_GlyphBuffer::add</h1> <p> Add elements onto the end of the glyphs vector.</p> <pre> CL_GlyphBuffer& add( int x, int y, unsigned int character); CL_GlyphBuffer& add( const CL_GlyphBuffer& other, int center_x = 0, int center_y = 0); CL_GlyphBuffer& add( const CL_GlyphBuffer& other, Range range, int center_x = 0, int center_y = 0); </pre> <p><b>Parameters:</b></p> <dl> <dt><i>x, y</i></dt><dd>The position to add the characters at (always upper-left positioning inside the buffer).</dd> <dt><i>center_x, center_y</i></dt><dd>Where to realign the origin of the input GlyphBuffer to in this GlyphBuffer.</dd> <dt><i>character</i></dt><dd>A single character to add without preprocessing.</dd> <dt><i>other</i></dt><dd>Another CL_GlyphBuffer to copy all glyphs and data from to the specified position.</dd> <dt><i>range</i></dt><dd>The subsection of the other GlyphBuffer to add onto the end of this one</dd> </dl> <p><b>Return value:</b></p> <p>A reference to this object, allowing you to chain multiple calls of add() together.<br></p> <p><b>Detailed description:</b></p> <p> It's usually more useful and efficient to have ClanLib draw many glyphs into the GlyphBuffer at once using CL_Font::draw_to_gb() or CL_TextStyler::draw_to_gb() than to use this function or the glyphs vector to manually add glyphs.</p> <p><b>See also:</b></p> <p><a href="CL_TextStyler.html">CL_TextStyler</a> | <a href="CL_GlyphBuffer.html">CL_GlyphBuffer</a> | <a href="CL_Font.html">CL_Font</a></p> <!-- clanlib footer begin --> <center><br><br><font color="#a0a0a0"> Questions or comments, write to the <a href="http://clanlib.org/contact.html">ClanLib mailing list</a>. </font></center> </body> </html> <!-- clanlib footer end -->