+ // Creates a bitmap that matches the device context's depth, from
+ // an arbitray bitmap. At present, the original bitmap must have an
+ // associated palette. (TODO: use a default palette if no palette exists.)
+ // This function is necessary for you to Blit an arbitrary bitmap (which may have
+ // the wrong depth). wxDC::SelectObject will compare the depth of the bitmap
+ // with the DC's depth, and create a new bitmap if the depths differ.
+ // Eventually we should perhaps make this a public API function so that
+ // an app can efficiently produce bitmaps of the correct depth.
+ // The Windows solution is to use SetDibBits to blit an arbotrary DIB directly to a DC, but
+ // this is too Windows-specific, hence this solution of quietly converting the wxBitmap.
+ // Contributed by Frederic Villeneuve <frederic.villeneuve@natinst.com>
+ wxBitmap GetBitmapForDC(wxDC& dc) const;
+