AsScreenshot

AsScreenshot — Object representing a single screenshot

Stability Level

Stable, unless otherwise indicated

Synopsis

#include <appstream-glib.h>

#define             AS_TYPE_SCREENSHOT
struct              AsScreenshotClass;
enum                AsScreenshotKind;
AsScreenshot *      as_screenshot_new                   (void);
AsScreenshotKind    as_screenshot_kind_from_string      (const gchar *kind);
const gchar *       as_screenshot_kind_to_string        (AsScreenshotKind kind);
AsScreenshotKind    as_screenshot_get_kind              (AsScreenshot *screenshot);
gint                as_screenshot_get_priority          (AsScreenshot *screenshot);
const gchar *       as_screenshot_get_caption           (AsScreenshot *screenshot,
                                                         const gchar *locale);
GPtrArray *         as_screenshot_get_images            (AsScreenshot *screenshot);
GPtrArray *         as_screenshot_get_images_for_locale (AsScreenshot *screenshot,
                                                         const gchar *locale);
AsImage *           as_screenshot_get_image             (AsScreenshot *screenshot,
                                                         guint width,
                                                         guint height);
AsImage *           as_screenshot_get_image_for_locale  (AsScreenshot *screenshot,
                                                         const gchar *locale,
                                                         guint width,
                                                         guint height);
AsImage *           as_screenshot_get_source            (AsScreenshot *screenshot);
void                as_screenshot_set_kind              (AsScreenshot *screenshot,
                                                         AsScreenshotKind kind);
void                as_screenshot_set_priority          (AsScreenshot *screenshot,
                                                         gint priority);
void                as_screenshot_set_caption           (AsScreenshot *screenshot,
                                                         const gchar *locale,
                                                         const gchar *caption);
void                as_screenshot_add_image             (AsScreenshot *screenshot,
                                                         AsImage *image);
gboolean            as_screenshot_equal                 (AsScreenshot *screenshot1,
                                                         AsScreenshot *screenshot2);

Description

Screenshots have a localized caption and also contain a number of images of different resolution.

See also: AsImage

Details

AS_TYPE_SCREENSHOT

#define AS_TYPE_SCREENSHOT (as_screenshot_get_type ())

struct AsScreenshotClass

struct AsScreenshotClass {
	GObjectClass		parent_class;
};

enum AsScreenshotKind

typedef enum {
	AS_SCREENSHOT_KIND_UNKNOWN,
	AS_SCREENSHOT_KIND_NORMAL,
	AS_SCREENSHOT_KIND_DEFAULT,
} AsScreenshotKind;

The screenshot type.

AS_SCREENSHOT_KIND_UNKNOWN

Type invalid or not known

AS_SCREENSHOT_KIND_NORMAL

Optional screenshot

AS_SCREENSHOT_KIND_DEFAULT

Screenshot to show by default

as_screenshot_new ()

AsScreenshot *      as_screenshot_new                   (void);

Creates a new AsScreenshot.

Returns :

a AsScreenshot. [transfer full]

Since 0.1.0


as_screenshot_kind_from_string ()

AsScreenshotKind    as_screenshot_kind_from_string      (const gchar *kind);

Converts the text representation to an enumerated value.

kind :

the string.

Returns :

a AsScreenshotKind, or AS_SCREENSHOT_KIND_UNKNOWN if not known. [transfer full]

Since 0.1.0


as_screenshot_kind_to_string ()

const gchar *       as_screenshot_kind_to_string        (AsScreenshotKind kind);

Converts the enumerated value to an text representation.

kind :

the AsScreenshotKind.

Returns :

string version of kind

Since 0.1.0


as_screenshot_get_kind ()

AsScreenshotKind    as_screenshot_get_kind              (AsScreenshot *screenshot);

Gets the screenshot kind.

screenshot :

a AsScreenshot instance.

Returns :

a AsScreenshotKind

Since 0.1.0


as_screenshot_get_priority ()

gint                as_screenshot_get_priority          (AsScreenshot *screenshot);

Gets the screenshot priority.

screenshot :

a AsScreenshot instance.

Returns :

a priority value

Since 0.3.1


as_screenshot_get_caption ()

const gchar *       as_screenshot_get_caption           (AsScreenshot *screenshot,
                                                         const gchar *locale);

Gets the image caption for a specific locale.

screenshot :

a AsScreenshot instance.

locale :

the locale, or NULL. e.g. "en_GB"

Returns :

the caption

Since 0.1.0


as_screenshot_get_images ()

GPtrArray *         as_screenshot_get_images            (AsScreenshot *screenshot);

Gets the images included in the screenshot of all sizes and locales.

screenshot :

a AsScreenshot instance.

Returns :

an array. [element-type AsImage][transfer none]

Since 0.1.0


as_screenshot_get_images_for_locale ()

GPtrArray *         as_screenshot_get_images_for_locale (AsScreenshot *screenshot,
                                                         const gchar *locale);

Returns all images of all sizes that are compatible with a specific locale.

screenshot :

a AsScreenshot instance.

locale :

a locale, e.g. `en_GB`

Returns :

an array. [element-type AsImage][transfer container]

Since 0.5.14


as_screenshot_get_image ()

AsImage *           as_screenshot_get_image             (AsScreenshot *screenshot,
                                                         guint width,
                                                         guint height);

Gets the AsImage closest to the target size. The AsImage may not actually be the requested size, and the application may have to pad / rescale the image to make it fit.

screenshot :

a AsScreenshot instance.

width :

target width

height :

target height

Returns :

an AsImage, or NULL. [transfer none]

Since 0.2.2


as_screenshot_get_image_for_locale ()

AsImage *           as_screenshot_get_image_for_locale  (AsScreenshot *screenshot,
                                                         const gchar *locale,
                                                         guint width,
                                                         guint height);

Gets the AsImage closest to the target size with the specified locale. The AsImage may not actually be the requested size, and the application may have to pad / rescale the image to make it fit.

FIXME: This function assumes the images are ordered in preference order, e.g. "en_GB -> en -> NULL"

screenshot :

a AsScreenshot instance.

locale :

locale, or NULL

width :

target width

height :

target height

Returns :

an AsImage, or NULL. [transfer none]

Since 0.5.14


as_screenshot_get_source ()

AsImage *           as_screenshot_get_source            (AsScreenshot *screenshot);

Gets the source image (the unscaled version) for the screenshot

screenshot :

a AsScreenshot instance.

Returns :

an AsImage, or NULL. [transfer none]

Since 0.1.6


as_screenshot_set_kind ()

void                as_screenshot_set_kind              (AsScreenshot *screenshot,
                                                         AsScreenshotKind kind);

Sets the screenshot kind.

screenshot :

a AsScreenshot instance.

kind :

the AsScreenshotKind.

Since 0.1.0


as_screenshot_set_priority ()

void                as_screenshot_set_priority          (AsScreenshot *screenshot,
                                                         gint priority);

Sets the screenshot priority. Higher numbers are better.

screenshot :

a AsScreenshot instance.

priority :

the priority value.

Since 0.3.1


as_screenshot_set_caption ()

void                as_screenshot_set_caption           (AsScreenshot *screenshot,
                                                         const gchar *locale,
                                                         const gchar *caption);

Sets a caption on the screenshot for a specific locale.

screenshot :

a AsScreenshot instance.

locale :

the locale, or NULL. e.g. "en_GB"

caption :

the caption text.

Since 0.1.0


as_screenshot_add_image ()

void                as_screenshot_add_image             (AsScreenshot *screenshot,
                                                         AsImage *image);

Adds an image to the screenshot.

screenshot :

a AsScreenshot instance.

image :

a AsImage instance.

Since 0.1.0


as_screenshot_equal ()

gboolean            as_screenshot_equal                 (AsScreenshot *screenshot1,
                                                         AsScreenshot *screenshot2);

Checks if two screenshots are the same.

screenshot1 :

a AsScreenshot instance.

screenshot2 :

a AsScreenshot instance.

Returns :

TRUE for success

Since 0.5.7