View source for Truxton subject set custom

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

=Syntax=
<source lang="C">
void truxton_subject_set_custom( uint64_t subject_handle, char const * name );
</source>

=Parameters=
==<code>subject_handle </code>==
The handle to the subject object.
This comes from calling <code>[[truxton_subject_create|truxton_subject_create()]]</code>.

==<code>name</code>==
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 [https://en.wikipedia.org/wiki/JSON JSON] here with data about the subject.

=Sample=
<source lang="C" highlight="7">
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 );
}
</source>