* \note For AcessOS Version 1\r
* \r
* Video drivers extend the common driver interface api_drv_common.h\r
- * and must support _at least_ the IOCtl numbers defined in this file\r
- * to be compatable with Acess.\r
+ * and must support the IOCtl numbers defined in this file to be\r
+ * compatable with Acess (drivers may implement more IOCtls above\r
+ * DRV_IOCTL_USERMIN).\r
* \r
* \section IOCtls\r
* As said, a compatable driver must implement these calls correctly,\r
* framebuffer.\r
* \r
* \section Mode Support\r
- * All video drivers must support at least one text mode (Mode #0)\r
- * For each graphics mode the driver exposes, there must be a corresponding\r
- * text mode with the same resolution, this mode will be used when the\r
- * user switches to a text Virtual Terminal while in graphics mode.\r
+ * All video drivers must support text output for every resolution (hardware\r
+ * accelerated or software), and at least the _BLIT and _FILL 2D operations\r
+ * (these may be implemented specifically for text mode).\r
*/\r
#ifndef _API_DRV_VIDEO_H\r
#define _API_DRV_VIDEO_H\r
*/\r
typedef struct sDrvUtil_Video_BufInfo\r
{\r
+ /**\r
+ * \name Framebuffer state\r
+ * \{\r
+ */\r
/**\r
* \brief Framebuffer virtual address\r
*/\r
/**\r
* \brief Bit depth of the framebuffer\r
*/\r
- int Depth;\r
+ short Depth;\r
+ /*\r
+ * \}\r
+ */\r
+ \r
+ /**\r
+ * \brief Buffer write format\r
+ */\r
+ short BufferFormat;\r
\r
/**\r
* \name Software cursor controls\r
* \brief Cursor bitmap\r
*/\r
tVideo_IOCtl_Bitmap *CursorBitmap;\r
+ /*\r
+ * \}\r
+ */\r
+\r
+ /*\r
+ * \name Internal fields\r
+ * \{\r
+ */\r
\r
/**\r
* \brief Buffer to store the area under the cursor\r
*/\r
void *CursorSaveBuf;\r
+ \r
+ int CursorReadX; //!< X offset in cursor bitmap corresponding to \a CursorDestX\r
+ int CursorReadY; //!< Same as \a CursorReadX but for Y\r
+ int CursorRenderW; //!< Width of rendered cursor\r
+ int CursorRenderH; //!< Height of rendered cursor\r
+ int CursorDestX; //!< X coordinate Destination for rendered cursor\r
+ int CursorDestY; //!< Y coordinate destination for rendered cursor\r
+\r
/*\r
* \}\r
*/\r
\r
/**\r
* \brief Perform write operations to a LFB\r
- * \param Mode Buffer mode (see eTplVideo_BufFormats)\r
* \param FBInfo Framebuffer descriptor, see type for details\r
* \param Offset Offset provided by VFS call\r
* \param Length Length provided by VFS call\r
* Handles all write modes in software, using the VT font calls for rendering.\r
* \note Calls the cursor clear and redraw if the cursor area is touched\r
*/\r
-extern int DrvUtil_Video_WriteLFB(int Mode, tDrvUtil_Video_BufInfo *FBInfo, size_t Offset, size_t Length, void *Src);\r
+extern int DrvUtil_Video_WriteLFB(tDrvUtil_Video_BufInfo *FBInfo, size_t Offset, size_t Length, void *Src);\r
\r
/**\r
* \name Software cursor rendering\r
* \param Buf Framebuffer descriptor\r
* \param Bitmap New cursor bitmap\r
*/\r
-extern void DrvUtil_Video_SetCursor(tDrvUtil_Video_BufInfo *Buf, tVideo_IOCtl_Bitmap *Bitmap);\r
+extern int DrvUtil_Video_SetCursor(tDrvUtil_Video_BufInfo *Buf, tVideo_IOCtl_Bitmap *Bitmap);\r
/**\r
* \brief Render the cursor at (\a X, \a Y)\r
* \param Buf Framebuffer descriptor, see type for details\r
* \param Buf Framebuffer descriptor, see type for details\r
*/\r
extern void DrvUtil_Video_RemoveCursor(tDrvUtil_Video_BufInfo *Buf);\r
+\r
+/**\r
+ * \brief Text mode cursor image\r
+ */\r
+extern tVideo_IOCtl_Bitmap gDrvUtil_TextModeCursor;\r
/**\r
* \}\r
*/\r