| Reference Manual - 1.4.3

IDirectFBSurface | GetSubSurface

#### Get an interface to a sub area of this surface.

DFBResult GetSubSurface (
| IDirectFBSurface |  | * | thiz,
| const DFBRectangle |  | * | rect,
| IDirectFBSurface |  | ** | ret_interface
);

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.

| This work is licensed under a Creative Commons Attribution-Share Alike 3.0 License