Traditionally bitmaps in Graphics32 have been using resources managed by the Windows GDI. While this is feasible for most usage scenarios in Windows there are some that require certain less resource-restricted approaches like handle-less bitmaps or bitmaps that rely on memory-mapped files. Prior to Graphics32 1.9 several community-driven patches existed that added these features. In order to keep backwards compatibility the TBitmap32<\/a> class still exposes the same external interface. In order to get a clean cut from the platform specific methods and properties we implemented a new in-between class TCustomBitmap32<\/a> which is truly platform agnostic and relies solely on the associated back-end class to handle its needs. As a matter of fact TCustomBitmap32<\/a> is missing all Text, Canvas and Handle methods. Back-ends may implement predefined interfaces to implement the functionality.<\/p>\n\n\n\n The back-end instance is switchable during the life-cycle of a TCustomBitmap32<\/a> instance. Conversion to the new back-end instance is handled transparently, i.e. without loosing the bitmap’s surface contents. For instance this allows for temporarily switching a handle-less memory-only bitmap to a GDI bitmap with handle and vice versa. TCustomBitmap32<\/a> exposes the current back-end via its Backend<\/a> property.<\/p>\n\n\n Currently Graphics32 ships with the following back-end classes which are subclasses of TBackend<\/a> and implement several interfaces (see below):<\/p>\n\n\n\n By default TBitmap32<\/a> now uses the back-end class TGDIBackend on Delphi\/VCL\/Windows and TLCLBackend on FreePascal\/LCL\/[supported OS (see above)].<\/p>\n\n\n\n Each of these back-ends may or may not implement certain pre-defined interfaces which can be queried for at runtime, either directly via the back-end or indirectly via the bitmap instance:<\/p>\n\n\n\n Most of the methods and properties left in TBitmap32<\/a> query the back-end for these specific interfaces. Failing to implement the required interfaces in the back-end class will cause the method call or property read to fail with an exception. We recommend to change your custom routines or methods to use TCustomBitmap32<\/a> instead of TBitmap32<\/a> wherever possible.<\/p><\/div><\/div>\n\n\n\n <\/p>\n","protected":false},"excerpt":{"rendered":" Introduction Traditionally bitmaps in Graphics32 have been using resources managed by the Windows GDI. While this is feasible for most usage scenarios in Windows there are some that require certain less resource-restricted approaches like handle-less bitmaps or bitmaps that rely<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-254","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/melander.dk\/graphics32\/wp-json\/wp\/v2\/pages\/254","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/melander.dk\/graphics32\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/melander.dk\/graphics32\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/melander.dk\/graphics32\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/melander.dk\/graphics32\/wp-json\/wp\/v2\/comments?post=254"}],"version-history":[{"count":2,"href":"https:\/\/melander.dk\/graphics32\/wp-json\/wp\/v2\/pages\/254\/revisions"}],"predecessor-version":[{"id":266,"href":"https:\/\/melander.dk\/graphics32\/wp-json\/wp\/v2\/pages\/254\/revisions\/266"}],"wp:attachment":[{"href":"https:\/\/melander.dk\/graphics32\/wp-json\/wp\/v2\/media?parent=254"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
With the arrival of broader platform support in Graphics32 we have separated the memory management as well as OS or graphics subsystem specific methods from the generic methods in TBitmap32<\/a> and have moved these portions into so called back-end classes.<\/p>\n\n\n\nApproach and compatibility<\/h2>\n\n\n\n
\nbegin\n MyBitmap := TBitmap32.Create;\n TMMFBackend.Create(MyBitmap); \/\/ Switch to a handle-less memory mapped file back-end...\n MyBitmap.SetSize(5000, 5000);\n \n \/\/ Draw onto your new big bitmap...\n \/\/ Note: No text or canvas drawing is allowed because TMMFBackend does not implement those operations.\n \/\/ Use TGDIMMFBackend instead...\n \n TGDIBackend.Create(MyBitmap); \/\/ Switch to a GDI back-end and convert the current buffer...\n MyBitmap.SaveToFile('test.bmp');\nend;\n<\/pre><\/div>\n\n\nClass and interface overview<\/h2>\n\n\n\n
Note<\/h5>