💾 Archived View for lofi.haiku-os.org › docs › develop › servers › app_server › BitmapManager.gmi captured on 2024-08-25 at 00:21:26. Gemini links have been rewritten to link to archived content

View Raw

More Information

⬅️ Previous capture (2023-09-28)

-=-=-=-=-=-=-

BitmapManager class

The BitmapManager object handles all ServerBitmap allocation and deallocation. The rest of the server uses CreateBitmap and DeleteBitmap instead of new and delete.

Member Functions

BitmapManager(void)

1. Create the bitmap list

2. Create the bitmap area

3. Allocate the access semaphore

4. Call set_buffer_area_management

5. Set up the buffer pool via bpool

~BitmapManager(void)

1. Iterate over each item in the bitmap list, removing each item, calling brel() on its buffer, and deleting it.

2. Delete the bitmap list

3. Delete the bitmap area

4. Free the access semaphore

ServerBitmap *CreateBitmap(BRect bounds, color_space space, int32 flags, int32 bytes_per_row=-1, screen_id screen=B_MAIN_SCREEN_ID)

CreateBitmap is called by outside objects to allocate a ServerBitmap object. If a problem occurs, it returns NULL.

1. Acquire the access semaphore

2. Verify parameters and if any are invalid, spew an error to stderr and return NULL

3. Allocate a new ServerBitmap

4. Allocate a buffer for the bitmap with the bitmap’s theoretical buffer length

5. If NULL, delete the bitmap and return NULL

6. Set the bitmap’s area and buffer to the appropriate values (area_for buffer and buffer)

7. Add the bitmap to the bitmap list

8. Release the access semaphore

9. Return the bitmap

void DeleteBitmap(ServerBitmap *bitmap)

Frees a ServerBitmap allocated by CreateBitmap()

1. Acquire the access semaphore

2. Find the bitmap in the list

3. Remove the bitmap from the list or release the semaphore and return if not found

4. call brel() on the bitmap’s buffer if it is non-NULL

5. delete the bitmap

6. Release the access semaphore