Truxton media tag

From truxwiki.com
Revision as of 14:09, 24 June 2020 by Sam (talk | contribs) (Created page with "This will tag the media. =Syntax= <syntaxhighlight lang="C"> void truxton_media_tag(uint64_t media_handle, char const * tag_name, char const * why, uint64_t origin); </syntax...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

This will tag the media.

Syntax

void truxton_media_tag(uint64_t media_handle, char const * tag_name, char const * why, uint64_t origin);

Parameters

media_handle

The handle created by the truxton_media_open_id or truxton_media_create call.

tag_name

The small bit of text that will serve as the tag. This will show up in the user interface.

why

The reason why this item was tagged.

origin

What produced this tag. If an algorithm produced this tag, it should be set to 1. If you are calling this method because a human told you to, the value should be 2.

Sample

#define TAG_ORIGIN_AUTOMATIC (1)
#define TAG_ORIGIN_HUMAN     (2)

void process_media(uint64_t truxton)
{
   uint64_t media = truxton_media_open_id(truxton, "92A86F8F-DFD0-4DBE-B9FF-257D4EB17B4C");

   truxton_media_tag(media, "Doofenshmirtz", "Infectinator from Evil Incorporated", TAG_ORIGIN_AUTOMATIC);

   truxton_media_destroy(media);
}