PgmViewportFactory

PgmViewportFactory — A factory creating viewports.

Synopsis


#include <pgm/pgm.h>

                    PgmViewportFactory;
PgmViewportFactory * pgm_viewport_factory_new           (const gchar *name);
PgmError            pgm_viewport_factory_get_description
                                                        (PgmViewportFactory *factory,
                                                         gchar **description);
PgmError            pgm_viewport_factory_get_license    (PgmViewportFactory *factory,
                                                         gchar **license);
PgmError            pgm_viewport_factory_get_origin     (PgmViewportFactory *factory,
                                                         gchar **origin);
PgmError            pgm_viewport_factory_get_author     (PgmViewportFactory *factory,
                                                         gchar **author);
PgmError            pgm_viewport_factory_create         (PgmViewportFactory *factory,
                                                         PgmViewport **viewport);
PgmError            pgm_viewport_factory_make           (const gchar *name,
                                                         PgmViewport **viewport);

Object Hierarchy

  GObject
   +----GstObject
         +----PgmViewportFactory

Description

PgmViewportFactory is used to create instances of PgmViewport.

Use the pgm_viewport_factory_new() and pgm_viewport_factory_create() functions to create viewport instances or use pgm_viewport_factory_make() as a convenient shortcut.

The following code example shows you how to create an OpenGL based viewport.

Example 5. Using a viewport factory

PgmViewportFactory *factory;
PgmViewport *viewport;
 
pgm_init (&argc, &argv);
 
factory = pgm_viewport_factory_new ("opengl");
pgm_viewport_factory_create (factory, &viewport);


Last reviewed on 2007-04-12 (0.1.5)

Details

PgmViewportFactory

typedef struct _PgmViewportFactory PgmViewportFactory;

The PgmViewportFactory opaque structure.


pgm_viewport_factory_new ()

PgmViewportFactory * pgm_viewport_factory_new           (const gchar *name);

Creates a new PgmViewportFactory instance of the given name. PgmViewportFactory is a singleton, if a factory of the given name has already been created, this constructor returns that one with a incremented refcount. This function does not detect if the name passed as argument is an invalid name (i.e. if there is no plugin of that name). Such an error will only be detected when trying to use the factory (e.g. with pgm_viewport_factory_create() or with one of the pgm_viewport_factory_get*() functions.

MT safe.

name :

the name of the factory to create.

Returns :

a PgmViewportFactory instance or NULL if an error occurred.

pgm_viewport_factory_get_description ()

PgmError            pgm_viewport_factory_get_description
                                                        (PgmViewportFactory *factory,
                                                         gchar **description);

Retrieves the description of the viewports managed by factory in description.

MT safe.

factory :

a PgmViewportFactory object.

description :

a pointer to a pointer to a gchar where the description string is going to be be stored. g_free() after use.

Returns :

a PgmError indicating success/failure.

pgm_viewport_factory_get_license ()

PgmError            pgm_viewport_factory_get_license    (PgmViewportFactory *factory,
                                                         gchar **license);

Retrieves the license of the viewports managed by factory in license.

MT safe.

factory :

a PgmViewportFactory object.

license :

a pointer to a pointer to a gchar where the license string is going to be be stored. g_free() after use.

Returns :

a PgmError indicating success/failure.

pgm_viewport_factory_get_origin ()

PgmError            pgm_viewport_factory_get_origin     (PgmViewportFactory *factory,
                                                         gchar **origin);

Retrieves the origin of the viewports managed by factory in origin.

MT safe.

factory :

a PgmViewportFactory object.

origin :

a pointer to a pointer to a gchar where the origin string is going to be be stored. g_free() after use.

Returns :

a PgmError indicating success/failure.

pgm_viewport_factory_get_author ()

PgmError            pgm_viewport_factory_get_author     (PgmViewportFactory *factory,
                                                         gchar **author);

Retrieves the author of the viewports managed by factory in author.

MT safe.

factory :

a PgmViewportFactory object.

author :

a pointer to a pointer to a gchar where the author string is going to be be stored. g_free() after use.

Returns :

a PgmError indicating success/failure.

pgm_viewport_factory_create ()

PgmError            pgm_viewport_factory_create         (PgmViewportFactory *factory,
                                                         PgmViewport **viewport);

Creates a new viewport of the type defined by factory in viewport.

MT safe.

factory :

a PgmViewportFactory object.

viewport :

a pointer to a PgmViewport's pointer where the created viewport is going to be be stored.

Returns :

a PgmError indicating success/failure.

pgm_viewport_factory_make ()

PgmError            pgm_viewport_factory_make           (const gchar *name,
                                                         PgmViewport **viewport);

Creates a new viewport of the given name in viewport.

MT safe.

name :

the name of the viewport to make.

viewport :

a pointer to a PgmViewport's pointer where the created viewport is going to be be stored.

Returns :

a PgmError indicating success/failure.

See Also

#PgmViewport.