Truxton subject set custom

This allows you to set an arbitrary value associated with the subject. This will be stored in the [Custom] column of the [Suspect] table.

Syntax

void truxton_subject_set_custom( uint64_t subject_handle, char const * name );

Parameters

subject_handle

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

name

A string to be stored with the subject. Truxton does nothing with this field. It is left for you to define what should be in here. One example would be to store JSON here with data about the subject.

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 );
}