Truxton artifact create

From truxwiki.com
Revision as of 08:08, 16 October 2020 by Sam (talk | contribs) (→‎Remarks)
Jump to navigation Jump to search

This creates an artifact object. Internally, Truxton calls these entities. You can use this to add to the Entity table in the database.

Syntax

uint64_t truxton_artifact_create(uint64_t truxton_handle);

Parameters

truxton_handle

The Truxton instance this artifact will belong. This handle comes from calling truxton_create().

Return value

A handle to an artifact object.

Sample

void create_artifact(void)
{
   uint64_t truxton = truxton_create();

   uint64_t artifact= truxton_artifact_create(truxton);

   truxton_artifact_set_name( artifact, "Ducky Momo Server" );
   truxton_artifact_save( artifact);
   truxton_artifact_tag( artifact, "Too Young", "Yes, yes I am", 1 );

   char id[ 65 ];

   truxton_artifact_get_id( artifact, id, sizeof( id ) );

   printf( "Artifact ID is %s\n", id );

   truxton_artifact_destroy(media);
   truxton_destroy(truxton);
}

Remarks

The default behavior of this API is to:

  • Generate an identifier for the media
  • Set the created date to the current time
  • Set the last updated date to the current time
  • Set the expiration date set to 99 years from now
  • Set the percent complete set 100
  • Set the status set to loaded