Cameras and Options

mi_api_camera_begin
mi_api_options_begin
mi_api_options_end
mi_api_taglist_reset

Cameras and Options

mi_api_camera_begin

miCamera *mi_api_camera_begin(
    char            *name)      /* light name */

Begin the definition of a camera with the specified name. A pointer to the camera is returned; the caller may modify the structure.

miBoolean mi_api_camera_end(void)

Complete the definition of a camera after all parameters have been set.

mi_api_options_begin

miOptions *mi_api_options_begin(
    char            *name)      /* light name */

Begin the definition of an options block with the specified name. A pointer to the options block is returned; the caller may modify the structure.

mi_api_options_end

miBoolean mi_api_options_end(void)

Complete the definition of an options block after all parameters have been set.

mi_api_taglist_reset

miBoolean mi_api_taglist_reset(void)
    miTag           *tag,       /* tag to reset */
    miDlist         *list)      /* list of tags */

Create a tag list database element from the dynamic list list, and store the new tag in * tag. If tag points to a non-null tag, that tag is assumed to have been created from a previous call to mi_api_taglist_reset, and is deleted. The list is assumed to have been created with a call like mi_api_dlist_create( miDLIST_TAG). If list is a null pointer, * tag is still deleted but no new list is installed. The main application of this function is to install a finalgather file name list in the options, with a call like

miDlist *taglist = mi_api_dlist_create(miDLIST_TAG);
mi_api_dlist_add(taglist, filename_string_tag); /*...*/
mi_api_taglist_reset(&options->finalgather_file, taglist);