<HTML> <STYLE> <!-- A{textdecoration:none} --> </STYLE> <HEAD> <TITLE>DirectFB Reference Manual</TITLE> </HEAD> <BODY bgcolor=#FFFFFF link=#0070FF vlink=#0070FF text=#404040> <TABLE width=100% bgcolor=black border=0 cellspacing=1 cellpadding=3> <TR><TD width=30%> <A href="http://www.directfb.org"><IMG border=0 src="directfb.png"></A> </TD><TD align=right> <A href="index.html"><FONT size=+3 color=white>DirectFB Reference Manual</FONT></A> </TD></TR> <TR><TD colspan=2 align=center bgcolor=#303030> <TABLE border=0 cellspacing=0 cellpadding=0> <TR><TD align=right width=50%> <BIG><A href="IDirectFBSurface.html"><FONT color=#DDDDDD>IDirectFBSurface</FONT></A> </BIG> </TD><TD align=left width=50%> <BIG><FONT color=orange> GetSubSurface</FONT></BIG> </TD></TR> </TABLE> </TD></TR> </TABLE> <P> Get an interface to a sub area of this surface.</P><P> <TABLE border=0 cellspacing=0 cellpadding=4 bgcolor=#C0C0C0> <TR><TD colspan=3><I><FONT color=black>GetSubSurface (</FONT></I></TD></TR> <TR><TD width=50> </TD><TD valign=top> <A href="IDirectFBSurface.html">IDirectFBSurface</A> </TD><TD valign=top> <FONT color=black><B>*thiz</B></FONT> </TD></TR> <TR><TD width=50> </TD><TD valign=top> const DFBRectangle </TD><TD valign=top> <FONT color=black><B>*rect</B></FONT> </TD></TR> <TR><TD width=50> </TD><TD valign=top> <A href="IDirectFBSurface.html">IDirectFBSurface</A> </TD><TD valign=top> <FONT color=black><B>**interface</B></FONT> </TD></TR> <TR><TD colspan=3><I><FONT color=black>);</FONT></I></TD></TR> </TABLE> </P> <P> No image data is duplicated, this is a clipped graphics within the original surface. This is very helpful for lightweight components in a GUI toolkit. The new surface's state (color, drawingflags, etc.) is independent from this one. So it's a handy graphics context. If no rectangle is specified, the whole surface (or a part if this surface is a subsurface itself) is represented by the new one.</P> <TABLE width=100% bgcolor=black border=0 cellspacing=0 cellpadding=0> <TR><TD valign=center> <FONT size=-3> (C) Copyright by convergence GmbH</FONT> </TD><TD align=right> <A href="http://www.convergence.de"> <IMG border=0 hspace=4 src="cimlogo.png"> </A> </TD></TR> </TABLE> </BODY> </HTML>