Reference Manual - 1.8.0
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.

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