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);

Copyright © 1986-2010 by mental images GmbH