# ScreenGroup

A collection of one or more screens.

### Description

A screen group is a collection of one or more screens.

### Folio

graphics

### Item Type

SCREENGROUPNODE

### Create

`CreateScreenGroup()`

### Delete

``DeleteScreenGroup`()`

### Use

``AddScreenGroup`(), RemoveScreenGroup()`

### Tags

CSG_TAG_DISPLAYHEIGHT
  (uint32) Create. This optional tag lets you specify the visible height of each screen within the screen group. This determines the number of lines of the bitmaps that make up the screen will be visible at any one time. When this

CSG_TAG_SCREENCOUNT
  (uint32) Create. This optional tag lets you specify the number of screens to create within the screen group. If the tag is not supplied, then two screens is created.

CSG_TAG_SCREENHEIGHT
  (uint32) Create. This optional tag lets you specify the number of lines that make up each screen within the screen group. When this tag is not supplied, the current default height is used.

CSG_TAG_BITMAPCOUNT
  (uint32) Create. This optional tag lets you specify the number of bitmaps per screen. This tag should currently not be used.

CSG_TAG_BITMAPWIDTH_ARRAY
  (uint32 *) Create. This optional tag provides a pointer to an array of width values, indicating the width of each bitmap.

CSG_TAG_BITMAPHEIGHT_ARRAY
  (uint32 *) Create. This optional tag provides a pointer to an array of height values, indicating the height of each bitmap.

CSG_TAG_BITMAPBUF_ARRAY
  (void **) Create. This optional tag points to an array of pointers to memory buffers. This array must contain as many entries as the screen group has screens. The array points to the memory to use for bitmaps when creating the screen group. If this tag is not provided, the graphics folio will allocate memory for the bitmaps itself.

CSG_TAG_VDLTYPE
  (uint32) Create. This optional tag specifies the type of VDL for each screen.

CSG_TAG_VDLPTR_ARRAY
  (uint32 **) Create. This tag maps the bitmaps to the video display lists. Each element of the array is a pointer to a VDL.

CSG_TAG_VDLLENGTH_ARRAY
  (uint32 *) Create. This optional tag specifies the length in words for each custom VDL referenced by the CSG_TAG_VDLPTR_ARRAY.

CSG_TAG_SPORTBITS
  (uint32) Create. Specifies the memory allocation bits to use when allocating memory for the screen group, which lets you control from which bank of VRAM an allocation comes from. If this tag is not supplied, the graphics folio will allocate the memory from any bank of VRAM. The values you supply to this tag are either `(MEMTYPE_BANKSELECT | MEMTYPE_BANK1)` or `(MEMTYPE_BANKSELECT | MEMTYPE_BANK2).`