X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/1d156af3247c862e51a7c62f569a3fd302052a42..4e15d1caa03346c126015019c1fdf093033ef40b:/docs/doxygen/overviews/bitmap.h?ds=sidebyside diff --git a/docs/doxygen/overviews/bitmap.h b/docs/doxygen/overviews/bitmap.h index 2a375ca777..6b22d1a051 100644 --- a/docs/doxygen/overviews/bitmap.h +++ b/docs/doxygen/overviews/bitmap.h @@ -10,11 +10,7 @@ @page overview_bitmap Bitmaps and Icons -Classes: -@li wxBitmap -@li wxBitmapHandler -@li wxIcon -@li wxCursor +@tableofcontents The wxBitmap class encapsulates the concept of a platform-dependent bitmap, either monochrome or colour. Platform-specific methods for creating a wxBitmap @@ -78,14 +74,20 @@ wxBitmap bmp(wxBITMAP(bmpname)); You should always use wxICON() and wxBITMAP() macros because they work for any platform (unlike the code above which doesn't deal with wxMac, wxX11, ...) and -are shorter and more clear than versions with many @ifdef_ blocks. Even better, -use the same XPMs on all platforms. +are shorter and more clear than versions with many @ifdef_ blocks. +Alternatively, you could use the same XPMs on all platforms and avoid dealing +with Windows resource files. -@li @ref overview_bitmap_supportedformats -@li @ref overview_bitmap_handlers +If you'd like to embed bitmaps with alpha transparency in your program, neither +XPM nor BMP formats are appropriate as they don't have support for alpha and +another format, typically PNG, should be used. wxWidgets provides a similar +helper for PNG bitmaps called wxBITMAP_PNG() that can be used to either load +PNG files embedded in resources (meaning either Windows resource section of the +executable file or OS X "Resource" subdirectory of the application bundle) or +arrays containing PNG data included into the program code itself. +@see @ref group_class_gdi -