|
Retrieving information
|
GetCapabilities
|
Return the capabilities of this surface.
|
|
|
GetPosition
|
Get the surface's position in pixels.
|
|
|
GetSize
|
Get the surface's width and height in pixels.
|
|
|
GetVisibleRectangle
|
Created sub surfaces might be clipped by their parents,
this function returns the resulting rectangle relative
to this surface.
|
|
|
GetPixelFormat
|
Get the current pixel format.
|
|
|
GetColorSpace
|
Get the current color space.
|
|
|
GetAccelerationMask
|
Get a mask of drawing functions that are hardware
accelerated with the current settings.
|
|
Palette & Alpha Ramp
|
GetPalette
|
Get access to the surface's palette.
|
|
|
SetPalette
|
Change the surface's palette.
|
|
|
SetAlphaRamp
|
Set the alpha ramp for formats with one or two alpha bits.
|
|
Buffer operations
|
GetStereoEye
|
Get the current stereo eye.
|
|
|
SetStereoEye
|
Select the stereo eye for future operations.
|
|
|
Lock
|
Lock the surface for the access type specified.
|
|
|
GetFramebufferOffset
|
Obsolete. Returns DFB_FAILURE always.
|
|
|
Unlock
|
Unlock the surface after direct access.
|
|
|
Flip
|
Flip/Update surface buffers.
|
|
|
FlipStereo
|
Flip/Update stereo surface buffers. Flips both the left and right
buffers simultaneously to ensure synchronization between the two.
Only applicable to window and layer surfaces with the DWCAPS_STEREO
or DLOP_STEREO option set; will fail with all other surfaces.
|
|
|
SetField
|
Set the active field.
|
|
|
Clear
|
Clear the surface and its depth buffer if existent.
|
|
Drawing/blitting control
|
SetClip
|
Set the clipping region used to limit the area for
drawing, blitting and text functions.
|
|
|
GetClip
|
Get the clipping region used to limit the area for
drawing, blitting and text functions.
|
|
|
SetColor
|
Set the color used for drawing/text functions or
alpha/color modulation (blitting functions).
|
|
|
SetColorIndex
|
Set the color like with SetColor() but using
an index to the color/alpha lookup table.
|
|
|
SetSrcBlendFunction
|
Set the blend function that applies to the source.
|
|
|
SetDstBlendFunction
|
Set the blend function that applies to the destination.
|
|
|
SetPorterDuff
|
Set the source and destination blend function by
specifying a Porter/Duff rule.
|
|
|
SetSrcColorKey
|
Set the source color key, i.e. the color that is excluded
when blitting FROM this surface TO another that has
source color keying enabled.
|
|
|
SetSrcColorKeyIndex
|
Set the source color key like with SetSrcColorKey() but using
an index to the color/alpha lookup table.
|
|
|
SetDstColorKey
|
Set the destination color key, i.e. the only color that
gets overwritten by drawing and blitting to this surface
when destination color keying is enabled.
|
|
|
SetDstColorKeyIndex
|
Set the destination color key like with SetDstColorKey() but using
an index to the color/alpha lookup table.
|
|
Blitting functions
|
SetBlittingFlags
|
Set the flags for all subsequent blitting commands.
|
|
|
Blit
|
Blit an area from the source to this surface.
|
|
|
TileBlit
|
Blit an area from the source tiled to this surface.
|
|
|
BatchBlit
|
Blit a bunch of areas at once.
|
|
|
StretchBlit
|
Blit an area scaled from the source to the destination
rectangle.
|
|
|
TextureTriangles
|
Preliminary texture mapping support.
|
|
Drawing functions
|
SetDrawingFlags
|
Set the flags for all subsequent drawing commands.
|
|
|
FillRectangle
|
Fill the specified rectangle with the given color
following the specified flags.
|
|
|
DrawRectangle
|
Draw an outline of the specified rectangle with the given
color following the specified flags.
|
|
|
DrawLine
|
Draw a line from one point to the other with the given color
following the drawing flags.
|
|
|
DrawLines
|
Draw 'num_lines' lines with the given color following the
drawing flags. Each line specified by a DFBRegion.
|
|
|
FillTriangle
|
Fill a non-textured triangle.
|
|
|
FillRectangles
|
Fill a bunch of rectangles with a single call.
|
|
|
FillSpans
|
Fill spans specified by x and width.
|
|
|
FillTriangles
|
Fill a bunch of triangles with a single call.
|
|
Text functions
|
SetFont
|
Set the font used by DrawString() and DrawGlyph().
You can pass NULL here to unset the font.
|
|
|
GetFont
|
Get the font associated with a surface.
|
|
|
DrawString
|
Draw a string at the specified position with the
given color following the specified flags.
|
|
|
DrawGlyph
|
Draw a single glyph specified by its character code at the
specified position with the given color following the
specified flags.
|
|
|
SetEncoding
|
Change the encoding used for text rendering.
|
|
Lightweight helpers
|
GetSubSurface
|
Get an interface to a sub area of this surface.
|
|
OpenGL
|
GetGL
|
Get a unique OpenGL context for this surface.
|
|
Debug
|
Dump
|
Dump the contents of the surface to one or two files.
|
|
|
DisableAcceleration
|
Disable hardware acceleration.
|
|
Resources
|
ReleaseSource
|
Release possible reference to source surface.
|
|
Blitting control
|
SetIndexTranslation
|
Set index translation table.
|
|
Rendering
|
SetRenderOptions
|
Set options affecting the output of drawing and blitting operations.
|
|
Drawing/blitting control
|
SetMatrix
|
Set the transformation matrix.
|
|
|
SetSourceMask
|
Set the surface to be used as a mask for blitting.
|
|
Lightweight helpers
|
MakeSubSurface
|
Make this a sub surface or adjust the rectangle of this sub surface.
|
|
Direct Write/Read
|
Write
|
Write to the surface without the need for (Un)Lock.
|
|
|
Read
|
Read from the surface without the need for (Un)Lock.
|
|
Drawing/blitting control
|
SetColors
|
Sets color values used for drawing/text functions or
alpha/color modulation (blitting functions).
|
|
Blitting functions
|
BatchBlit2
|
Blit a bunch of areas at once using secondary source for reading instead of destination.
|
|
Buffer operations
|
GetPhysicalAddress
|
Returns the physical address of a locked surface.
|
|
Drawing functions
|
FillTrapezoids
|
Fill a bunch of trapezoids with a single call.
|
|
Drawing/blitting control
|
SetWriteMaskBits
|
Sets write mask bits.
|
|
|
SetRop
|
Set Rop operation related parameters.
|
|
|
SetSrcColorKeyExtended
|
Sets extended source color keying.
|
|
|
SetDstColorKeyExtended
|
Sets extended destination color keying.
|
|
Drawing functions
|
DrawMonoGlyphs
|
Blit monochrome glyph data with attributes.
|
|
Blitting control
|
SetSrcColorMatrix
|
Set the source color matrix.
|
|
|
SetSrcConvolution
|
Set the source convolution filter.
|
|
Retrieving information
|
GetID
|
Get the unique surface ID.
|
|
Process security
|
AllowAccess
|
Allow access.
|
|
Event buffers
|
CreateEventBuffer
|
Create an event buffer for this surface and attach it.
|
|
|
AttachEventBuffer
|
Attach an existing event buffer to this surface.
|
|
|
DetachEventBuffer
|
Detach an event buffer from this surface.
|
|
Blitting functions
|
BatchStretchBlit
|
Blit a bunch of areas scaled from the source to the destination
rectangles.
|
|
Client
|
MakeClient
|
Put in client mode for frame synchronization.
|
|
|
FrameAck
|
Put in client mode for frame synchronization.
|
|
Debug
|
DumpRaw
|
Dump the contents of the surface to one or two files in raw format.
|
|
Timing
|
GetFrameTime
|
Retrieve timestamp for next frame to be rendered.
|
|
|
SetFrameTimeConfig
|
Set configuration for GetFrameTime
|
|
Allocations
|
Allocate
|
Add implementation specific handle as buffer allocation.
|
|
|
GetAllocation
|
Acquire implementation specific handle from surface.
|
|
|
GetAllocations
|
Acquire implementation specific handles from surface.
|
|
Interface
|
Flush
|
Flush pending drawing operations
|
