Truxton subject set id

This allows you to set the GUID for the subject. This will be stored in the [ID] column of the [Suspect] table.

Syntax

void truxton_subject_set_id( uint64_t subject_handle, char * const id );

Parameters

subject_handle

The handle to the subject object. This comes from calling truxton_subject_create().

id

The string representation of a GUID.

Remarks

By setting your own identifier, you can have multiple subjects with the same name.

Sample

void create_villan( uint64_t truxton )
{
   uint64_t subject = truxton_subject_create( truxton );

   truxton_subject_set_name( subject, "Khaka Peü Peü" );
   truxton_subject_set_description( subject, "Last name translates to 'This strong hand or that strong hand.'" );
   truxton_subject_set_custom( subject, "Danville PD Tri-State ID: TSA-785543" );
   truxton_subject_set_birthday( subject, to_ticks( "1963-09-18" ) );
   truxton_subject_set_id( subject, "5068696E-6561-7320-616E-642046657262" );
   truxton_subject_set_picture( subject, base64_encode( "C:\Subjects\Photos\KPP.png" ) );

   // Commit the data to the database
   truxton_subject_save( subject );

   truxton_subject_tag( subject, "Prime Suspect", "As identified by The Beak", TAG_ORIGIN_HUMAN );
   truxton_subject_destroy( subject );
}