kits/interface/Bitmap.cpp

76 /*!	\brief Returns the number of bytes per row needed to store the actual
81 	\return The number of bytes per row needed to store data for a row, or
147 /*!	\brief Returns the number of bytes per row needed to store the bitmap
151 	\return The number of bytes per row needed to store data for a row, or
158 	// align to int32
174 		   \c B_ANY_BYTES_PER_ROW to let the constructor choose an appropriate
202 		   it shall be possible to attach BView to the bitmap and draw into
233 		   it shall be possible to attach BView to the bitmap and draw into
463 	// the data even if B_BITMAP_ACCEPTS_VIEWS is set (as opposed to
497 	need to access their Bits(), you have to lock them first.
506 	//	It would be more or less useful to report what kind of bitmap
517 			// the app_server does not grant us access to the frame buffer
525 	// NOTE: maybe this is used to prevent the app_server from
534 	Counterpart to LockBits(), see there for comments.
558 /*!	\brief Returns the pointer to the bitmap data.
559 	\return The pointer to the bitmap data.
585 /*!	\brief Returns the number of bytes used to store a row of bitmap data.
586 	\return The number of bytes used to store a row of bitmap data.
617 	This method informs about which flags have been used to create the
630 /*!	\brief Assigns data to the bitmap.
634 	- \c B_RGB32: The source buffer is supposed to contain \c B_RGB24_BIG
636 	- \c B_RGB32: The source buffer is supposed to contain \c B_CMAP8
638 	- other color spaces: The source buffer is supposed to contain data
639 	  according to the specified color space being rowwise padded to int32.
644 	\note As this methods is apparently a bit strange to use, Haiku introduces
645 		  ImportBits() methods, which are recommended to be used instead.
647 	\param data The data to be copied.
648 	\param length The length in bytes of the data to be copied.
649 	\param offset The offset (in bytes) relative to beginning of the bitmap
666 	// tweaks to mimic R5 behavior
680 /*!	\brief Assigns data to the bitmap.
685 	is supposed to contain data of that color space. \a bpr specifies how
687 	supplied, if standard padding to int32 is used.
692 	\param data The data to be copied.
693 	\param length The length in bytes of the data to be copied.
695 	\param offset The offset (in bytes) relative to beginning of the bitmap
730 /*!	\brief Assigns data to the bitmap.
734 	(and converted if necessary) to the bitmap at \a to.
739 	\param data The data to be copied.
740 	\param length The length in bytes of the data to be copied.
744 	\param to The offset in the bitmap where the source should be written.
745 	\param size The size (in pixels) to be imported.
753 	color_space colorSpace, BPoint from, BPoint to, BSize size)
771 		fBytesPerRow, colorSpace, fColorSpace, from, to,
778 	color_space colorSpace, BPoint from, BPoint to, int32 width, int32 height)
780 	return ImportBits(data, length, bpr, colorSpace, from, to, BSize(width - 1, height - 1));
784 /*!	\brief Assigns another bitmap's data to this bitmap.
787 	Its data is converted to the color space of this bitmap.
796 	  or the conversion from or to one of the color spaces is not supported.
812 /*!	\brief Assigns data to the bitmap.
816 	(and converted if necessary) to the bitmap at \a to. The source bitmap is
817 	clipped to the bitmap and they don't need to have the same dimensions.
824 	\param to The offset in the bitmap where the source should be written.
825 	\param size The size (in pixels) to be imported.
827 	- \c B_BAD_VALUE: \c NULL \a bitmap, the conversion from or to one of
831 BBitmap::ImportBits(const BBitmap* bitmap, BPoint from, BPoint to, BSize size)
840 		bitmap->BytesPerRow(), bitmap->ColorSpace(), from, to, size);
845 BBitmap::ImportBits(const BBitmap* bitmap, BPoint from, BPoint to, int32 width, int32 height)
847 	return ImportBits(bitmap, from, to, BSize(width - 1, height - 1));
873 /*!	\brief Adds a BView to the bitmap's view hierarchy.
878 	\param view The view to be added.
889 	\param view The view to be removed.
898 /*!	\brief Returns the number of BViews currently belonging to the bitmap.
899 	\return The number of BViews currently belonging to the bitmap.
909 	\param index The index of the BView to be returned.
921 	\param name The name of the BView to be returned.
944 /*!	\brief Locks the off-screen window that belongs to the bitmap.
958 /*!	\brief Unlocks the off-screen window that belongs to the bitmap.
1036 		   \c B_ANY_BYTES_PER_ROW to let the constructor choose an appropriate
1135 				// Ask the server (via our owning application) to create a bitmap.
1174 						// The base pointer will now point to an overlay_client_data
1175 						// structure bytes per row might be modified to match
1212 		// clear to white if the flags say so.
1224 		// copies the current content of the bitmap to a back buffer.
1225 		// So at this point the bitmap has to be already cleared to white.
1226 		// Better move the above code to the server so the problem looks more
1243 		informs the server to do so as well (if needed).