Top |
const gchar * | as_content_rating_value_to_string () |
AsContentRatingValue | as_content_rating_value_from_string () |
guint | as_content_rating_attribute_to_csm_age () |
const gchar ** | as_content_rating_get_all_rating_ids () |
const gchar * | as_content_rating_system_to_string () |
gchar * | as_content_rating_system_format_age () |
AsContentRatingSystem | as_content_rating_system_from_locale () |
gchar ** | as_content_rating_system_get_formatted_ages () |
const guint * | as_content_rating_system_get_csm_ages () |
AsContentRatingValue | as_content_rating_attribute_from_csm_age () |
const gchar * | as_content_rating_attribute_get_description () |
AsContentRating * | as_content_rating_new () |
const gchar * | as_content_rating_get_kind () |
void | as_content_rating_set_kind () |
guint | as_content_rating_get_minimum_age () |
AsContentRatingValue | as_content_rating_get_value () |
void | as_content_rating_set_value () |
const gchar ** | as_content_rating_get_rating_ids () |
void | as_content_rating_add_attribute () |
#define | AS_TYPE_CONTENT_RATING |
struct | AsContentRatingClass |
enum | AsContentRatingSystem |
enum | AsContentRatingValue |
AsContentRating |
const gchar *
as_content_rating_value_to_string (AsContentRatingValue value
);
Converts the enumerated value to an text representation.
Since: 0.11.0
AsContentRatingValue
as_content_rating_value_from_string (const gchar *value
);
Converts the text representation to an enumerated value.
Since: 0.11.0
guint as_content_rating_attribute_to_csm_age (const gchar *id
,AsContentRatingValue value
);
Gets the Common Sense Media approved age for a specific rating level.
id |
the subsection ID e.g. |
|
value |
the AsContentRatingValue, e.g. |
Since: 0.12.10
const gchar **
as_content_rating_get_all_rating_ids (void
);
Returns a list of all the valid OARS content rating attribute IDs as could
be passed to as_content_rating_add_attribute()
or
as_content_rating_attribute_to_csm_age()
.
a NULL
-terminated
array of IDs, to be freed with g_free()
(the element values are owned by
libappstream and must not be freed).
[array zero-terminated=1][transfer container]
Since: 0.12.10
const gchar *
as_content_rating_system_to_string (AsContentRatingSystem system
);
Get a human-readable string to identify system
. NULL
will be returned for
AS_CONTENT_RATING_SYSTEM_UNKNOWN
.
Since: 0.12.12
gchar * as_content_rating_system_format_age (AsContentRatingSystem system
,guint age
);
Format age
as a human-readable string in the given rating system
. This is
the way to present system-specific strings in a UI.
a newly allocated formatted version of
age
, or NULL
if the given system
has no representation for age
.
[transfer full][nullable]
Since: 0.12.12
AsContentRatingSystem
as_content_rating_system_from_locale (const gchar *locale
);
Determine the most appropriate AsContentRatingSystem for the given locale
.
Content rating systems are selected by territory. If no content rating system
seems suitable, AS_CONTENT_RATING_SYSTEM_IARC
is returned.
Since: 0.12.12
gchar **
as_content_rating_system_get_formatted_ages
(AsContentRatingSystem system
);
Get an array of all the possible return values of
as_content_rating_system_format_age()
for the given system
. The array is
sorted with youngest CSM age first.
Since: 0.12.12
const guint * as_content_rating_system_get_csm_ages (AsContentRatingSystem system
,gsize *length_out
);
Get the CSM ages corresponding to the entries returned by
as_content_rating_system_get_formatted_ages()
for this system
.
system |
||
length_out |
return location for the length of the returned array. |
[out][not nullable] |
Since: 0.12.12
AsContentRatingValue as_content_rating_attribute_from_csm_age (const gchar *id
,guint age
);
Gets the highest AsContentRatingValue which is allowed to be seen by the
given Common Sense Media age
for the given subsection id
.
For example, if the CSM age mappings for violence-bloodshed
are:
age ≥ 0 for AS_CONTENT_RATING_VALUE_NONE
age ≥ 9 for AS_CONTENT_RATING_VALUE_MILD
age ≥ 11 for AS_CONTENT_RATING_VALUE_MODERATE
age ≥ 18 for AS_CONTENT_RATING_VALUE_INTENSE
then calling this function with violence-bloodshed
and age
set to 17 would
return AS_CONTENT_RATING_VALUE_MODERATE
. Calling it with age 18 would
return AS_CONTENT_RATING_VALUE_INTENSE
.
Since: 0.12.12
const gchar * as_content_rating_attribute_get_description (const gchar *id
,AsContentRatingValue value
);
Get a human-readable description of what content would be expected to
require the content rating attribute given by id
and value
.
id |
the subsection ID e.g. |
|
value |
the AsContentRatingValue, e.g. |
Since: 0.12.12
AsContentRating *
as_content_rating_new (void
);
Creates a new AsContentRating.
Since: 0.11.0
const gchar *
as_content_rating_get_kind (AsContentRating *content_rating
);
Gets the content_rating kind.
Since: 0.11.0
void as_content_rating_set_kind (AsContentRating *content_rating
,const gchar *kind
);
Sets the content rating kind.
Since: 0.11.0
guint
as_content_rating_get_minimum_age (AsContentRating *content_rating
);
Gets the lowest Common Sense Media approved age for the content_rating block. NOTE: these numbers are based on the data and descriptions available from https://www.commonsensemedia.org/about-us/our-mission/about-our-ratings and you may disagree with them.
You're free to disagree with these, and of course you should use your own brain to work our if your child is able to cope with the concepts enumerated here. Some 13 year olds may be fine with the concept of mutilation of body parts; others may get nightmares.
Since: 0.11.0
AsContentRatingValue as_content_rating_get_value (AsContentRating *content_rating
,const gchar *id
);
Gets the value of a content rating key.
Since: 0.11.0
void as_content_rating_set_value (AsContentRating *content_rating
,const gchar *id
,AsContentRatingValue value
);
Sets the value of a content rating key.
content_rating |
||
id |
A ratings ID, e.g. |
|
value |
A AsContentRatingValue, e.g. |
Since: 0.11.0
const gchar **
as_content_rating_get_rating_ids (AsContentRating *content_rating
);
Gets the set of ratings IDs which are present in this content_rating
. An
example of a ratings ID is violence-bloodshed
.
The IDs are returned in lexicographical order.
NULL
-terminated
array of ratings IDs; each ratings ID is owned by the AsContentRating and
must not be freed, but the container must be freed with g_free()
.
[array zero-terminated=1][transfer container]
Since: 0.12.10
void as_content_rating_add_attribute (AsContentRating *content_rating
,const gchar *id
,AsContentRatingValue value
);
Adds an attribute value to the content rating.
content_rating |
a AsContentRating instance. |
|
id |
a content rating ID, e.g. |
|
value |
a AsContentRatingValue, e.g. |
Since: 0.14.0