1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
|
/****************************************************************************
* graphics/nxmu/nxfe.h
*
* Copyright (C) 2008-2012 Gregory Nutt. All rights reserved.
* Author: Gregory Nutt <gnutt@nuttx.org>
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
* 3. Neither the name NuttX nor the names of its contributors may be
* used to endorse or promote products derived from this software
* without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
* COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
* OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
* AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*
****************************************************************************/
#ifndef __GRAPHICS_NXMU_NXFE_H
#define __GRAPHICS_NXMU_NXFE_H
/****************************************************************************
* Included Files
****************************************************************************/
#include <nuttx/config.h>
#include <stdint.h>
#include <stdbool.h>
#include <mqueue.h>
#include <semaphore.h>
#include <nuttx/nx/nx.h>
#include "nxbe.h"
/****************************************************************************
* Pre-Processor Definitions
****************************************************************************/
/* Configuration ************************************************************/
#ifdef CONFIG_DISABLE_MQUEUE
# error "Message queues are disabled(CONFIG_DISABLE_MQUEUE)"
#endif
#ifndef CONFIG_NX_MXSERVERMSGS
# define CONFIG_NX_MXSERVERMSGS 32 /* Number of pending messages in server MQ */
#endif
#ifndef CONFIG_NX_MXCLIENTMSGS
# define CONFIG_NX_MXCLIENTMSGS 16 /* Number of pending messages in each client MQ */
#endif
/* Used to create unique client MQ name */
#define NX_CLIENT_MQNAMEFMT "/dev/nxc%d"
#define NX_CLIENT_MXNAMELEN (16)
#define NX_MXSVRMSGLEN (64) /* Maximum size of a client->server command */
#define NX_MXEVENTLEN (64) /* Maximum size of an event */
#define NX_MXCLIMSGLEN (64) /* Maximum size of a server->client message */
/* Handy macros */
#define nxmu_semgive(sem) sem_post(sem) /* To match nxmu_semtake() */
/****************************************************************************
* Public Types
****************************************************************************/
/* Client/Connection structures *********************************************/
/* Client state */
enum nx_clistate_e
{
NX_CLISTATE_NOTCONNECTED = 0, /* Waiting for server to acknowledge connection */
NX_CLISTATE_CONNECTED, /* Connection established (normal state) */
NX_CLISTATE_DISCONNECT_PENDING, /* Waiting for server to acknowledge disconnect */
};
/* This structure represents a connection between the client and the server */
struct nxfe_conn_s
{
/* This number uniquely identifies the client */
int cid; /* Client ID (CID) */
uint8_t state; /* See enum nx_clistate_e */
/* These are only usable on the client side of the connection */
mqd_t crdmq; /* MQ to read from the server (may be non-blocking) */
mqd_t cwrmq; /* MQ to write to the server (blocking) */
/* These are only usable on the server side of the connection */
mqd_t swrmq; /* MQ to write to the client */
};
/* Server state structure ***************************************************/
/* This the server 'front-end' state structure */
struct nxfe_state_s
{
/* The 'back-end' window status. Must be first so that instances of
* struct nxbe_state_s can be simply cast to an instance of struct
* nxfe_state_s
*/
struct nxbe_state_s be;
/* This is the server's connection to iself */
struct nxfe_conn_s conn;
};
/* Message IDs **************************************************************/
enum nxmsg_e
{
/* Server-to-Client Messages **********************************************/
NX_CLIMSG_CONNECTED = 1, /* The server has completed the connection and is ready */
NX_CLIMSG_DISCONNECTED, /* The server has disconnected */
NX_CLIMSG_REDRAW, /* Re-draw the specified window */
NX_CLIMSG_NEWPOSITION, /* New window size/position */
NX_CLIMSG_MOUSEIN, /* New mouse positional data available for window */
NX_CLIMSG_KBDIN, /* New keypad input available for window */
NX_CLIMSG_BLOCKED, /* The window is blocked */
/* Client-to-Server Messages **********************************************/
NX_SVRMSG_CONNECT, /* Establish connection with new NX server client */
NX_SVRMSG_DISCONNECT, /* Tear down connection with terminating client */
NX_SVRMSG_OPENWINDOW, /* Create a new window */
NX_SVRMSG_CLOSEWINDOW, /* Close an existing window */
NX_SVRMSG_BLOCKED, /* The window is blocked */
NX_SVRMSG_REQUESTBKGD, /* Open the background window */
NX_SVRMSG_RELEASEBKGD, /* Release the background window */
NX_SVRMSG_SETPOSITION, /* Window position has changed */
NX_SVRMSG_SETSIZE, /* Window size has changed */
NX_SVRMSG_GETPOSITION, /* Get the current window position and size */
NX_SVRMSG_RAISE, /* Move the window to the top */
NX_SVRMSG_LOWER, /* Move the window to the bottom */
NX_SVRMSG_SETPIXEL, /* Set a single pixel in the window with a color */
NX_SVRMSG_FILL, /* Fill a rectangle in the window with a color */
NX_SVRMSG_GETRECTANGLE, /* Get a rectangular region in the window */
NX_SVRMSG_FILLTRAP, /* Fill a trapezoidal region in the window with a color */
NX_SVRMSG_MOVE, /* Move a rectangular region within the window */
NX_SVRMSG_BITMAP, /* Copy a rectangular bitmap into the window */
NX_SVRMSG_SETBGCOLOR, /* Set the color of the background */
NX_SVRMSG_MOUSEIN, /* New mouse report from mouse client */
NX_SVRMSG_KBDIN, /* New keyboard report from keyboard client */
};
/* Message priorities -- they must all be at the same priority to assure
* FIFO execution.
*/
#define NX_CLIMSG_PRIO 42
#define NX_SVRMSG_PRIO 42
/* Server-to-Client Message Structures **************************************/
/* The generic message structure. All messages begin with this form. */
struct nxclimsg_s
{
uint32_t msgid; /* Any of nxclimsg_e */
};
/* The server is now connected */
struct nxclimsg_connected_s
{
uint32_t msgid; /* NX_CLIMSG_REDRAW_CONNECTED */
};
/* The server is now disconnected */
struct nxclimsg_disconnected_s
{
uint32_t msgid; /* NX_CLIMSG_REDRAW_DISCONNECTED */
};
/* This message is received when a requested window has been opened. If wnd is NULL
* then errorcode is the errno value that provides the explanation of the error.
*/
struct nxclimsg_redraw_s
{
uint32_t msgid; /* NX_CLIMSG_REDRAW */
FAR struct nxbe_window_s *wnd; /* The handle to the window to redraw in */
FAR struct nxgl_rect_s rect; /* The rectangle to be redrawn */
bool more; /* true: more redraw messages follow */
};
/* This message informs the client of the new size or position of the window */
struct nxclimsg_newposition_s
{
uint32_t msgid; /* NX_CLIMSG_NEWPOSITION */
FAR struct nxbe_window_s *wnd; /* The window whose position/size has changed */
FAR struct nxgl_size_s size; /* The current window size */
FAR struct nxgl_point_s pos; /* The current window position */
FAR struct nxgl_rect_s bounds; /* Size of screen */
};
/* This message reports a new mouse event to a particular window */
#ifdef CONFIG_NX_MOUSE
struct nxclimsg_mousein_s
{
uint32_t msgid; /* NX_SVRMSG_MOUSEIN */
FAR struct nxbe_window_s *wnd; /* The handle of window receiving mouse input */
struct nxgl_point_s pos; /* Mouse X/Y position */
uint8_t buttons; /* Mouse button set */
};
#endif
/* This message reports a new keypad event to a particular window */
#ifdef CONFIG_NX_KBD
struct nxclimsg_kbdin_s
{
uint32_t msgid; /* NX_CLIMSG_KBDIN */
FAR struct nxbe_window_s *wnd; /* The handle of window receiving keypad input */
uint8_t nch; /* Number of characters received */
uint8_t ch[1]; /* Array of received characters */
};
#endif
/* This messsage confirms that that all queued window messages have been
* flushed and that the all further window messages are blocked.
*/
struct nxclimsg_blocked_s
{
uint32_t msgid; /* NX_CLIMSG_BLOCKED */
FAR struct nxbe_window_s *wnd; /* The window that is blocked */
FAR void *arg; /* User argument */
};
/* Client-to-Server Message Structures **************************************/
/* The generic message structure. All server messages begin with this form. Also
* messages that have no additional data fields use this structure. This includes:
* NX_SVRMSG_CONNECT and NX_SVRMSG_DISCONNECT.
*/
struct nxsvrmsg_s /* Generic server message */
{
uint32_t msgid; /* One of enum nxsvrmsg_e */
FAR struct nxfe_conn_s *conn; /* The specific connection sending the message */
};
/* This message requests the server to create a new window */
struct nxsvrmsg_openwindow_s
{
uint32_t msgid; /* NX_SVRMSG_OPENWINDOW */
FAR struct nxbe_window_s *wnd; /* The pre-allocated window structure */
};
/* This message informs the server that client wishes to close a window */
struct nxsvrmsg_closewindow_s
{
uint32_t msgid; /* NX_SVRMSG_CLOSEWINDOW */
FAR struct nxbe_window_s *wnd; /* The window to be closed */
};
/* This messsage is just a marker that is queued and forwarded by the server
* (NX_CLIMSG_BLOCKED). Messages to the window were blocked just after this
* message was sent. Receipt of this message indicates both that the window
* blocked and that there are no further queued messages for the window.
*/
struct nxsvrmsg_blocked_s
{
uint32_t msgid; /* NX_SVRMSG_BLOCKED */
FAR struct nxbe_window_s *wnd; /* The window that is blocked */
FAR void *arg; /* User argument */
};
/* This message requests the server to create a new window */
struct nxsvrmsg_requestbkgd_s
{
uint32_t msgid; /* NX_SVRMSG_REQUESTBKGD */
FAR struct nxfe_conn_s *conn; /* The specific connection sending the message */
FAR const struct nx_callback_s *cb; /* Event handling callbacks */
FAR void *arg; /* Client argument used with callbacks */
};
/* This message informs the server that client wishes to close a window */
struct nxsvrmsg_releasebkgd_s
{
uint32_t msgid; /* NX_SVRMSG_RELEASEBKGD */
};
/* This message informs the server that the size or position of the window has changed */
struct nxsvrmsg_setposition_s
{
uint32_t msgid; /* NX_SVRMSG_SETPOSITION */
FAR struct nxbe_window_s *wnd; /* The window whose position/size has changed */
FAR struct nxgl_point_s pos; /* The new window position */
};
/* This message informs the server that the size or position of the window has changed */
struct nxsvrmsg_setsize_s
{
uint32_t msgid; /* NX_SVRMSG_SETSIZE */
FAR struct nxbe_window_s *wnd; /* The window whose position/size has changed */
FAR struct nxgl_size_s size; /* The new window size */
};
/* This message informs the server that the size or position of the window has changed */
struct nxsvrmsg_getposition_s
{
uint32_t msgid; /* NX_SVRMSG_FETPOSITION */
FAR struct nxbe_window_s *wnd; /* The window whose position/size has changed */
};
/* This message informs the server to raise this window to the top of the display */
struct nxsvrmsg_raise_s
{
uint32_t msgid; /* NX_SVRMSG_RAISE */
FAR struct nxbe_window_s *wnd; /* The window to be raised */
};
/* This message informs the server to lower this window to the bottom of the display */
struct nxsvrmsg_lower_s
{
uint32_t msgid; /* NX_SVRMSG_LOWER */
FAR struct nxbe_window_s *wnd; /* The window to be lowered */
};
/* Set a single pixel in the window with a color */
struct nxsvrmsg_setpixel_s
{
uint32_t msgid; /* NX_SVRMSG_SETPIXEL */
FAR struct nxbe_window_s *wnd; /* The window to fill */
struct nxgl_point_s pos; /* The position of the pixel in the window */
nxgl_mxpixel_t color[CONFIG_NX_NPLANES]; /* Color to use in the fill */
};
/* Fill a rectangle in the window with a color */
struct nxsvrmsg_fill_s
{
uint32_t msgid; /* NX_SVRMSG_FILL */
FAR struct nxbe_window_s *wnd; /* The window to fill */
struct nxgl_rect_s rect; /* The rectangle in the window to fill */
nxgl_mxpixel_t color[CONFIG_NX_NPLANES]; /* Color to use in the fill */
};
/* Get a rectangular region from the window */
struct nxsvrmsg_getrectangle_s
{
uint32_t msgid; /* NX_SVRMSG_GETRECTANGLE */
FAR struct nxbe_window_s *wnd; /* The window to get from */
struct nxgl_rect_s rect; /* The rectangle in the window to get from */
unsigned int plane; /* The plane number to read */
FAR uint8_t *dest; /* Memory location in which to store the graphics data */
unsigned int deststride; /* Width of the destination memory in bytes */
sem_t *sem_done; /* Semaphore to report when command is done. */
};
/* Fill a trapezoidal region in the window with a color */
struct nxsvrmsg_filltrapezoid_s
{
uint32_t msgid; /* NX_SVRMSG_FILLTRAP */
FAR struct nxbe_window_s *wnd; /* The window to fill */
FAR struct nxgl_rect_s clip; /* The clipping window */
struct nxgl_trapezoid_s trap; /* The trapezoidal region in the window to fill */
nxgl_mxpixel_t color[CONFIG_NX_NPLANES]; /* Color to use in the fill */
};
/* Move a rectangular region within the window */
struct nxsvrmsg_move_s
{
uint32_t msgid; /* NX_SVRMSG_MOVE */
FAR struct nxbe_window_s *wnd; /* The window within which the move is done */
struct nxgl_rect_s rect; /* Describes the rectangular region to move */
struct nxgl_point_s offset; /* The offset to move the region */
};
/* Copy a rectangular bitmap into the window */
struct nxsvrmsg_bitmap_s
{
uint32_t msgid; /* NX_SVRMSG_BITMAP */
FAR struct nxbe_window_s *wnd; /* The window with will receive the bitmap image */
struct nxgl_rect_s dest; /* Destination location of the bitmap in the window */
FAR const void *src[CONFIG_NX_NPLANES]; /* The start of the source image. */
struct nxgl_point_s origin; /* Offset into the source image data */
unsigned int stride; /* The width of the full source image in pixels. */
sem_t *sem_done; /* Semaphore to report when command is done. */
};
/* Set the color of the background */
struct nxsvrmsg_setbgcolor_s
{
uint32_t msgid; /* NX_SVRMSG_SETBGCOLOR */
nxgl_mxpixel_t color[CONFIG_NX_NPLANES]; /* Color to use in the background */
};
/* This message reports a new mouse event from a hardware controller attached to
* the server as a regular client (this message may have even been sent from an
* interrupt handler).
*/
#ifdef CONFIG_NX_MOUSE
struct nxsvrmsg_mousein_s
{
uint32_t msgid; /* NX_SVRMSG_MOUSEIN */
struct nxgl_point_s pt; /* Mouse X/Y position */
uint8_t buttons; /* Mouse button set */
};
#endif
/* This message reports a new keyboard event from a hardware controller attached to
* some kind of keypad (this message may have even been sent from an
* interrupt handler).
*/
#ifdef CONFIG_NX_KBD
struct nxsvrmsg_kbdin_s
{
uint32_t msgid; /* NX_SVRMSG_KBDIN */
uint8_t nch ; /* Number of characters received */
uint8_t ch[1]; /* Array of received characters */
};
#endif
/****************************************************************************
* Public Data
****************************************************************************/
#undef EXTERN
#if defined(__cplusplus)
#define EXTERN extern "C"
extern "C" {
#else
#define EXTERN extern
#endif
/****************************************************************************
* Public Functions
****************************************************************************/
/****************************************************************************
* Name: nxfe_constructwindow
*
* Description:
* This function is the same a nx_openwindow EXCEPT that the client provides
* the window structure instance. nx_constructwindow will initialize the
* the pre-allocated window structure for use by NX. This function is
* provided in addition to nx_open window in order to support a kind of
* inheritance: The caller's window structure may include extensions that
* are not visible to NX.
*
* NOTE: wnd must have been allocated using kmalloc() (or related allocators)
* Once provided to nxfe_constructwindow() that memory is owned and managed
* by NX. On certain error conditions or when the window is closed, NX will
* free the window.
*
* Input Parameters:
* handle - The handle returned by nx_connect
* wnd - The pre-allocated window structure.
* cb - Callbacks used to process window events
* arg - User provided value that will be returned with NX callbacks.
*
* Return:
* OK on success; ERROR on failure with errno set appropriately. In the
* case of ERROR, NX will have dealloated the pre-allocated window.
*
****************************************************************************/
EXTERN int nxfe_constructwindow(NXHANDLE handle,
FAR struct nxbe_window_s *wnd,
FAR const struct nx_callback_s *cb,
FAR void *arg);
/****************************************************************************
* Name: nxmu_semtake
*
* Description:
* Take the semaphore, handling EINTR wakeups. See the nxmu_semgive macro.
*
* Input Parameters:
* sem - the semaphore to be taken.
*
* Return:
* None
*
****************************************************************************/
EXTERN void nxmu_semtake(sem_t *sem);
/****************************************************************************
* Name: nxmu_sendserver
*
* Description:
* Send a message to the server at NX_SVRMSG_PRIO priority
*
* Input Parameters:
* conn - A pointer to the server connection structure
* msg - A pointer to the message to send
* msglen - The length of the message in bytes.
*
* Return:
* OK on success; ERROR on failure with errno set appropriately
*
****************************************************************************/
EXTERN int nxmu_sendserver(FAR struct nxfe_conn_s *conn,
FAR const void *msg, size_t msglen);
/****************************************************************************
* Name: nxmu_sendwindow
*
* Description:
* Send a message to the server detined for a specific window at
* NX_SVRMSG_PRIO priority
*
* Input Parameters:
* wnd - A pointer to the back-end window structure
* msg - A pointer to the message to send
* msglen - The length of the message in bytes.
*
* Return:
* OK on success; ERROR on failure with errno set appropriately
*
****************************************************************************/
EXTERN int nxmu_sendwindow(FAR struct nxbe_window_s *wnd, FAR const void *msg,
size_t msglen);
/****************************************************************************
* Name: nxmu_sendclient
*
* Description:
* Send a message to the client at NX_CLIMSG_PRIO priority
*
* Input Parameters:
* conn - A pointer to the server connection structure
* msg - A pointer to the message to send
* msglen - The length of the message in bytes.
*
* Return:
* OK on success; ERROR on failure with errno set appropriately
*
****************************************************************************/
EXTERN int nxmu_sendclient(FAR struct nxfe_conn_s *conn,
FAR const void *msg, size_t msglen);
/****************************************************************************
* Name: nxmu_sendclientwindow
*
* Description:
* Send a message to the client at NX_CLIMSG_PRIO priority
*
* Input Parameters:
* wnd - A pointer to the back-end window structure
* msg - A pointer to the message to send
* msglen - The length of the message in bytes.
*
* Return:
* OK on success; ERROR on failure with errno set appropriately
*
****************************************************************************/
int nxmu_sendclientwindow(FAR struct nxbe_window_s *wnd, FAR const void *msg,
size_t msglen);
/****************************************************************************
* Name: nxmu_openwindow
*
* Description:
* Create a new window.
*
* Input Parameters:
* be - The back-end status structure
* wnd - The pre-allocated window structure to be initialized [IN/OUT]
*
* Return:
* None
*
****************************************************************************/
EXTERN void nxmu_openwindow(FAR struct nxbe_state_s *be,
FAR struct nxbe_window_s *wnd);
/****************************************************************************
* Name: nxmu_requestbkgd
*
* Description:
* Perform the server-side operation for the nx_requestbkgd operation:
* Give the client control of the background window connection and receipt
* of all background window callbacks.
*
* conn - The client containing connection information [IN]
* be - The server state structure [IN]
* cb - Callbacks used to process window events
* arg - User provided argument (see nx_openwindow, nx_constructwindow)
*
* Return:
* None
*
****************************************************************************/
EXTERN void nxmu_requestbkgd(FAR struct nxfe_conn_s *conn,
FAR struct nxbe_state_s *be,
FAR const struct nx_callback_s *cb,
FAR void *arg);
/****************************************************************************
* Name: nxmu_releasebkgd
*
* Description:
* Release the background window previously acquired using nxmu_openbgwindow
* and return control of the background to NX.
*
* Input Parameters:
* fe - The front-end state structure
*
* Return:
* None
*
****************************************************************************/
EXTERN void nxmu_releasebkgd(FAR struct nxfe_state_s *fe);
/****************************************************************************
* Name: nxfe_reportposition
*
* Descripton:
* Report the new size/position of the window.
*
****************************************************************************/
EXTERN void nxfe_reportposition(FAR struct nxbe_window_s *wnd);
/****************************************************************************
* Name: nxfe_redrawreq
*
* Descripton:
* Request the client that has this window to redraw the rectangular region.
*
****************************************************************************/
EXTERN void nxfe_redrawreq(FAR struct nxbe_window_s *wnd,
FAR const struct nxgl_rect_s *rect);
/****************************************************************************
* Name: nxmu_mouseinit
*
* Description:
* Initialize with the mouse in the center of the display
*
****************************************************************************/
#ifdef CONFIG_NX_MOUSE
EXTERN void nxmu_mouseinit(int x, int y);
#endif
/****************************************************************************
* Name: nxmu_mousereport
*
* Description:
* Report mouse position info to the specified window
*
* Input Parameters:
* wnd - The window to receive the mouse report
*
* Returned Value:
* 0: Mouse report sent; >0: Mouse report not sent; <0: An error occurred
*
****************************************************************************/
#ifdef CONFIG_NX_MOUSE
EXTERN int nxmu_mousereport(struct nxbe_window_s *wnd);
#endif
/****************************************************************************
* Name: nxmu_mousein
*
* Description:
* New positional data has been received from the thread or interrupt
* handler that manages some kind of pointing hardware. Route that
* positional data to the appropriate window client.
*
****************************************************************************/
#ifdef CONFIG_NX_MOUSE
EXTERN int nxmu_mousein(FAR struct nxfe_state_s *fe,
FAR const struct nxgl_point_s *pos, int button);
#endif
/****************************************************************************
* Name: nxmu_kbdin
*
* Descripton:
* New keyboard data has been received from the thread or interrupt
* handler that manages some kind of keyboard/keypad hardware. Route that
* positional data to the appropriate window client.
*
****************************************************************************/
#ifdef CONFIG_NX_KBD
EXTERN void nxmu_kbdin(FAR struct nxfe_state_s *fe, uint8_t nch, FAR uint8_t *ch);
#endif
#undef EXTERN
#if defined(__cplusplus)
}
#endif
#endif /* __GRAPHICS_NXMU_NXFE_H */
|