next up previous contents index
Next: Access a particular Up: How to use Previous: How to use

Access a composition

To access a composition one has to know the presentation description object version and the root version of the composition. To find the appropriate binding table, call GBTV_Get_Binding_Table_Version(). If the composition existed before (i.e. the combination of the presentation description object and the root) then we get a binding table version as described above. To get the versions of the root and the component objects, call for each of them GCRV_Get_Component_or_Root_Version(). Otherwise, i.e. the composition did not exist before, a new binding table with an empty transient version is created. In the latter case the (presentation description object, binding table) pair is added to the root but the root and components in the binding table must still be filled in. (One way to do this is to use the ARBT_Add_Root_to_Binding_Table() and ACBT_Add_Component_to_Binding_Table()
functions. One could also use GCRV_Get_Component_or_Root_Version(). The difference is that in the first way the component/root must be bound while in the second way the function allows unbound components/root. The function binds the component to be the `best' version.)



Martin Sjolin
Thu Jun 15 20:41:59 MET DST 1995