NAME

mkpicl, mkpicv - make complex pictures

SYNOPSIS

#include <pict_p.h>

PICT mkpici(pic1, pic2, ..., z)
PICT pic1, pic2, ..., z;

PICT mkpicv(picv)
PICT picv[];

DESCRIPTION

mkpicl and mkpicv build complex pictures from basic or other complex pictures. The pictures created rely on default display parameters for intensity/color and offset, or on the parameter values or higher level complex pictures that may later contain them.

mkpicl expects a list of two or more PICT s; the last one, z, must equal EOP or 0. mkpicv takes a single argument that is the address of an array of PICT s: the last element in the array must be EOP or 0.

Subpictures are placed in the complex picture in the order they appear in the argument list or array. Consequently, when a subpicture is displayed, it will be placed relative to the subpicture preceding it.

There is a hardware limit to the number of levels of subpictures that a complex picture can contain. Basic pictures are level 0. Level 1 pictures are composed of only basic pictures. Level 2 pictures may be composed of level 0 and 1 pictures. Level 3 pictures may be composed of level 0, 1, and 2 pictures. A complex picture that is not a top picture can be nno higher than level 3. A top picture may be composed of level 0-3 pictures. Attempts to build higher level pictures are illegal.

mkpicl and mkpicv each return a PICT pointing to the complex picture.

SEE ALSO

mkpar(3U) , mktop(3U).

DIAGNOSTICS

mkpic will fail, printing an appropriate error message and returning the value EOP, if: