/** Copyright 2012 Haiku, Inc. All rights reserved.* Distributed under the terms of the MIT License.** Authors:* John Scipione, jscipione@gmail.com** Corresponds to:* src/kits/game/DirectWindow.cpp hrev45044* src/kits/game/DirectWindow.h hrev45044*//*!\file DirectWindow.h\ingroup game\ingroup libbe\brief Provides the BDirectWindow class.*//*!\enum direct_buffer_stateDirect buffer state constants\since BeOS R3*//*!\enum direct_driver_stateDirect driver state constants\since BeOS R3*//*!\struct direct_buffer_info\ingroup game\ingroup libbeDirect butter info struct\since BeOS R3*//*!\var direct_buffer_info::buffer_stateState of the direct buffer access privileges.It can have one of the following values:- \c B_DIRECT_MODE_MASK- \c B_DIRECT_START- \c B_DIRECT_MODIFY- \c B_DIRECT_STOP- \c B_BUFFER_MOVED- \c B_BUFFER_RESET- \c B_BUFFER_RESIZED- \c B_CLIPPING_MODIFIED\since BeOS R3*//*!\var direct_buffer_info::driver_stateState of the graphics card on which your direct window is displayed.There are two possible values:- \c B_MODE_CHANGED The resolution or color depth has changed.- \c B_DRIVER_CHANGED The window was moved onto another monitor.\since BeOS R3*//*!\var direct_buffer_info::bitsPointer to the frame buffer in your team's memory space.\since BeOS R3*//*!\var direct_buffer_info::pci_bitsPointer to the frame buffer in the PCI memory space. This value istypically needed to control DMA.\since BeOS R3*//*!\var direct_buffer_info::bytes_per_rowNumber of bytes used to represent a single row of pixels in the frame buffer.\since BeOS R3*//*!\var direct_buffer_info::bits_per_pixelNumber of bits actually used to store a single pixel, including reserved,unused, or alpha channel bits. This value is usually a multiple of eight.\since BeOS R3*//*!\var direct_buffer_info::pixel_formatThe format used to encode a pixel as defined by the \c color_space type.\since BeOS R3*//*!\var direct_buffer_info::layoutReserved for future use.\since BeOS R3*//*!\var direct_buffer_info::orientationReserved for future use.\since BeOS R3*//*!\var direct_buffer_info::_reserved[9]Reserved for future use.\since BeOS R3*//*!\var direct_buffer_info::_dd_type_Reserved for future use.\since BeOS R3*//*!\var direct_buffer_info::_dd_token_Reserved for future use.\since BeOS R3*//*!\var direct_buffer_info::clip_list_countNumber of rectangles in \c clip_list.\since BeOS R3*//*!\var direct_buffer_info::window_boundsRectangle that defines the full content area of the window in screencoordinates.\since BeOS R3*//*!\var direct_buffer_info::clip_boundsBounding rectangle of the visible part of the content area of the windowin screen coordinates.\since BeOS R3*//*!\var direct_buffer_info::clip_listList of rectangles that together define the visible region of the contentarea of the window in screen coordinates.\since BeOS R3*//*!\class BDirectWindow\ingroup game\ingroup libbe\brief Provides direct access to the video card graphics frame buffer.\since BeOS R3*//*!\fn BDirectWindow::BDirectWindow(BRect frame, const char* title,window_type type, uint32 flags, uint32 workspace)\brief Creates and initializes a BDirectWindow object.\param frame The initial frame rectangle of the window.\param title The title of the Window.\param type Window type (see BWindow).\param flags Window flags (see BWindow).\param workspace Workspace of the direct window (see BWindow).\since BeOS R3*//*!\fn BDirectWindow::BDirectWindow(BRect frame, const char* title,window_look look, window_feel feel, uint32 flags, uint32 workspace)\brief Creates and initializes a BDirectWindow object.\param frame The initial frame rectangle of the window.\param title The title of the Window.\param look Window look (see BWindow).\param feel Window feel (see BWindow).\param flags Window flags (see BWindow).\param workspace Workspace of the direct window (see BWindow).\since BeOS R3*//*!\fn BDirectWindow::~BDirectWindow()\brief Destroys the BDirectWindow and frees all memory used by it.Do not delete a BDirectWindow object directly, call Quit() instead.Destroying a BDirectWindow involves a few steps to make sure that itis disconnected and cleaned up.Set the fConnectionDisabled flag to \c true to prevent DirectConnected()from attempting to reconnect while it's being destroyed.next call Hide() and finally Sync() to force the direct window todisconnect from direct access.Once these steps are complete you may do your usual destructor work.\since BeOS R3*//*!\fn BArchivable* BDirectWindow::Instantiate(BMessage* data)\brief Instantiate window from message \a data. Not implemented.\since BeOS R3*//*!\fn status_t BDirectWindow::Archive(BMessage* data, bool deep) const\brief Archive window into message \a data. Not implemented.\since BeOS R3*//*!\fn void BDirectWindow::DirectConnected(direct_buffer_info* info)\brief Hook method called when your application learns about the stateof the graphics display and changes occur.This is the heart of BDirectWindow.\param info The \c direct_buffer_info struct\since BeOS R3*//*!\fn status_t BDirectWindow::GetClippingRegion(BRegion* region,BPoint* origin) const\brief Sets \a region to the current clipping region of the direct window.If \a origin is not \c NULL, the \a region is offset by \a origin.\warning GetClippingRegion() should only be called from within theDirectConnected() method. If called outside GetClippingRegion()will return \c B_ERROR.\param region The clipping region to fill out.\param origin An origin to offset the region by.\returns A status code.\retval B_OK Everything went as expected.\retval B_BAD_VALUE \a region was NULL.\retval B_ERROR Window not locked or not in DirectConnected() method.\retval B_NO_MEMORY Not enough memory to fill \a region\since BeOS R3*//*!\fn status_t BDirectWindow::SetFullScreen(bool enable)\brief Enables or disables full-screen mode.The SupportsWindowMode() method determines whether or not the video cardis capable of supporting windowed mode.When the window is in full screen mode it will always have the focus andno other window can be in front of it.\param enable \c true to enable fullscreen mode, \c false for windowed mode.\returns A status code.\retval B_OK Everything went as expected.\retval B_ERROR An error occurred while trying to switch between full screenand windowed mode.\see BDirectWindow::SupportsWindowMode()\since BeOS R3*//*!\fn bool BDirectWindow::IsFullScreen() const\brief Returns whether the window is in full-screen or windowed mode.\returns \c true if in full-screen mode, \c false if in windowed mode.\since BeOS R3*//*!\fn static bool BDirectWindow::SupportsWindowMode(screen_id id)\brief Returns whether or not the specified screen supports windowed mode.Because this is a static function you don't have to construct aBDirectWindow object to call it.\param id The id of the screen you want to check, \c B_MAIN_SCREEN_ID bydefault.\returns \c true if the screen support windowed mode, \c false otherwise.\since BeOS R3*/