New features include surface clipping in all operations, full support for the Pocket PC 2003 environment, a new pixel shader, and several bug fixes!
Read more at
Above: The new pixel shader BLTFAST_MULTIPLY is especially useful for changing colors of text fonts.
Complete release notes:
GapiDraw 2.02 [2003-07-15]
--------------------------
SDK additions:
-Clipping support in all operations! A clipping viewport can be set for each surface using CGapiSurface::SetClipper and CGapiSurface::GetClipper.
-GapiDraw now comes with XScale-optimized binaries for the PocketPC 2003 environment (Windows CE 4.2).
-New function: CGapiApplication::CreateVideoSurfaces. Place all your code for creating video surfaces here. This function will be called if video surfaces are lost. This function is also called on application startup.
-New function: CGapiApplication::OnMinimize (use this to suspend music output).
-New function: CGapiApplication::OnRestore (use this to resume music output).
-New helper classes: CPoint and CRect. Use them in all functions requiring a POINT or RECT structure (e.g. BltFast(0, 0, &surface, CRect(10, 10, 100, 100), 0, NULL)). They are located in the files GapiDrawExtension.h and GapiDrawExtension.cpp.
-New font functions: CGapiBitmapFont::GetStringWidth, CGapiBitmapFont::GetCharWidth, and CGapiBitmapFont::GetSpacing.
-New font functions: CGapiDisplay::GetSystemFont and CGapiDisplay::GetSystemFontBorder to retrieve pointers to the built-in system fonts.
-New BltFast pixel shader: Multiply! Use this to easily change color of fonts.
SDK improvements:
-CGapiBitmapFont::CreateFont now allows ASCII strings with less characters than the bitmap font to be used (only those defined in the ASCII string will be used). If the ASCII string contains more characters than the bitmap font, only those defined in the bitmap font will be used.
-CGapiBitmapFont::CreateFont no longer requires the first character in the ASCII string to be <space>, e.g. a font can now contain only the characters "1234567890" with no space. This applies to both the simple as well as the advanced font bitmap formats.
-It is now possible to call CreateSurface() on a surface that is a backbuffer copy (assigned using CGapiDisplay::GetBackBuffer).
-The back buffer is now cleared at startup on Pocket PCs with direct display access.
-CGapiSurface::Intersect now works with signed coordinates.
-A new flag GDRGBASURFACE_SYSTEMMEMORY was introduced. RGBA surfaces can currently only be stored in system memory, this flag was added for extra code clarity.
SDK Changes:
-If surfaces stored in video memory are lost, CGapiApplication will now call CGapiApplication::CreateVideoSurfaces (previously CGapiApplication::CreateSurfaces was called). Move all your video surface creation code from CGapiApplication::CreateSurfaces to CGapiApplication::CreateVideoSurfaces.
-If the width and height passed to CGapiDisplay::OpenDisplay is 0, GapiDraw will now open the display as 240x320 if windowed, and 320x240 if full screen.
-The .NET function calls (GapiDrawNet.h) CGapiDisplay_OpenDisplay and CGapiDisplay_OpenDisplayByName were slightly modified.
-CGapiApplication does no longer include CrtDebug debug checking for full STL compatibility.
-The single-threaded version of CGapiApplication does no longer sleep 1 millisecond if it cannot reach its target FPS.
-DrawText with system font was removed. It is no longer possible to draw text directly using the system font. Instead if you want to draw text with one of the system fonts, call CGapiDisplay::GetSystemFont to retrieve a font pointer and then use the bitmapped system font for drawing.
-RenderSystemFont was moved from CGapiSurface to CGapiDisplay and is no longer a static function.
-The GDDRAWTEXT_CALCWIDTH feature was removed. Use CGapiBitmapFont::GetStringWidth instead.
Bug fixes
-Using the flag GDALPHABLTFAST_OPACITY with CGapiSurface::AlphaBltFast would previously not work on pixels where alpha was 255 (totally opaque).
-Calling AlphaBlt with a destination rectangle in a different size than the source surface would previously cause rendering errors in some display modes.
-Blt using rotation center would previously not work correctly in all display modes.
