]> git.saurik.com Git - wxWidgets.git/blob - contrib/src/gizmos/statpict.txt
Defaults in wxWinCE documented.
[wxWidgets.git] / contrib / src / gizmos / statpict.txt
1 wxStaticPicture class
2 by Wade Brainerd (wadeb@wadeb.com)
3
4 Description:
5
6 This class is an improved version of wxStaticBitmap.
7
8 Rather than using a native bitmap control, it uses DC operations to draw the
9 control. This makes its appearance more consistent across platforms, and
10 allows for additional features.
11
12 Features include:
13
14 wxStaticBitmap compatible API - drop-in replacement. Image alignment - top,
15 left, bottom, right, center vertical and/or horizontal.
16 Image scaling - scale horizontally and/or vertically, justified scaling
17 (maintains image aspect ratio).
18
19 Platforms tested:
20
21 wxMSW
22 wxGTK
23 wxMac
24
25 Implementation notes:
26
27 Under MSW wxWindows uses the operating system to do an optimized (potentially
28 hardware accelerated) blit in wxDC::DrawBitmap. This is usually fast enough to
29 do image scaling without affecting the program's interactivity.
30
31 On wxMac and wxGTK however, wxDC::DrawBitmap implicitly calls wxImage::Scale
32 which is a much slower operation. Therefore, on these platforms wxStaticPicture
33 caches the scaled image to make updates that don't change the image (overlapping
34 windows, etc.) faster.