mirror of
https://gitlab.uni-freiburg.de/opensourcevdi/spice
synced 2026-01-06 09:54:45 +00:00
DisplayChannel: add documentation for Ring types
The Surface and Display channels each have a 'current_list' Ring, and Surface also has a 'current' Ring. these names are confusing, so at minimum, add a comment indicating the type of object they hold. The DisplayChannel::current_list already had a comment, but it was incorrect. Signed-off-by: Jonathon Jongsma <jjongsma@redhat.com> Acked-by: Frediano Ziglio <fziglio@redhat.com>
This commit is contained in:
parent
43f62e46ca
commit
11629023c4
@ -41,7 +41,11 @@ struct DisplayChannelPrivate
|
||||
int enable_jpeg;
|
||||
int enable_zlib_glz_wrap;
|
||||
|
||||
Ring current_list; // of TreeItem
|
||||
/* A ring of pending drawables for this DisplayChannel, regardless of which
|
||||
* surface they're associated with. This list is mainly used to flush older
|
||||
* drawables when we need to make room for new drawables. The ring is
|
||||
* maintained in order of age, the tail being the oldest drawable */
|
||||
Ring current_list;
|
||||
|
||||
uint32_t drawable_count;
|
||||
_Drawable drawables[NUM_DRAWABLES];
|
||||
|
||||
@ -162,7 +162,14 @@ typedef struct DrawContext {
|
||||
|
||||
typedef struct RedSurface {
|
||||
uint32_t refs;
|
||||
/* A Ring representing a hierarchical tree structure. This tree includes
|
||||
* DrawItems, Containers, and Shadows. It is used to efficiently determine
|
||||
* which drawables overlap, and to exclude regions of drawables that are
|
||||
* obscured by other drawables */
|
||||
Ring current;
|
||||
/* A ring of pending Drawables associated with this surface. This ring is
|
||||
* actually used for drawing. The ring is maintained in order of age, the
|
||||
* tail being the oldest drawable. */
|
||||
Ring current_list;
|
||||
DrawContext context;
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user