Truxton file export add criteria - Revision history

Sam: /* Sample */

2024-02-03T14:58:51Z

Sample

Sam: /* Sample */

2024-02-03T14:47:53Z

Sample

Sam at 18:24, 20 August 2021

2021-08-20T18:24:06Z

Sam: /* Criteria Fields */

2021-03-28T22:21:42Z

Criteria Fields

Sam at 11:26, 10 February 2021

2021-02-10T11:26:08Z

Sam at 09:20, 2 December 2020

2020-12-02T09:20:30Z

Sam: Created page with "This gives you the ability to specify criteria for selecting files to export from Truxton. =Syntax= void truxton_file_export_add_criteria(uint64_t export_ha..."

2020-12-02T09:13:25Z

Created page with "This gives you the ability to specify criteria for selecting files to export from Truxton. =Syntax= <source lang="C"> void truxton_file_export_add_criteria(uint64_t export_ha..."

New page

This gives you the ability to specify criteria for selecting files to export from Truxton.

=Syntax=
<source lang="C">
void truxton_file_export_add_criteria(uint64_t export_handle, uint64_t field, char const * value);
</source>

=Parameters=
==<code>export_handle</code>==
The handle to an export instance created by the <code>[[truxton_file_export_create]]()</code> call.

==<code>field</code>==
Which [[File Export Criteria|criteria]] to set.

==<code>value</code>==
The string representation of the field criteria.

=Sample=
<source lang="C" line highlight="20,23,26,29,32">
#include "TruxtonCAPI.h"
#pragma comment(lib, "TruxtonCAPI.lib")

#include "filetypes.h"
#include <stdlib.h>
#pragma hdrstop

int main()
{
char temporary_string[256];

truxton_start();

uint64_t truxton = truxton_create();

uint64_t export_handle = truxton_file_export_create(truxton);

// We want a variety of file types
sprintf_s(temporary_string, sizeof(temporary_string), "%d, %d, %d", Type_JPEGWithExif, Type_JPEG, Type_GIF);
truxton_file_export_add_criteria(export_handle, TRUXTON_EXPORT_FILE_QUERY_FIELD_TYPE, temp_string);

// We only want files where the MD5 hash starts with "e4"
truxton_file_export_add_criteria(export_handle, TRUXTON_EXPORT_FILE_QUERY_FIELD_HASH, "e4");

// We want a file that is at least 4MB long
truxton_file_export_add_criteria(export_handle, TRUXTON_EXPORT_FILE_QUERY_FIELD_SIZE_MINIMUM, "4194304");

// We want a file that is no larger than 5MB
truxton_file_export_add_criteria(export_handle, TRUXTON_EXPORT_FILE_QUERY_FIELD_SIZE_MAXIMUM, "5242880");

// Limit the output to a single file
truxton_file_export_add_criteria(export_handle, TRUXTON_EXPORT_FILE_QUERY_FIELD_LIMIT, "1");

truxton_file_export_where_clause(export_handle, temporary_string, sizeof(temporary_string));
printf( "Will use the following WHERE clause to select files: %s\n", temporary_string);

// Rename the file being exported to include the hash before the original name
truxton_file_export_set_option(export_handle, TRUXTON_EXPORT_FILE_OPTION_NAME_FORMAT, "{hash}_{name}");

// The files should be output to a particular folder
truxton_file_export_set_option(export_handle, TRUXTON_EXPORT_FILE_OPTION_FOLDER, "C:\\temp");

// We want them output to a TAR file in that particular folder
truxton_file_export_set_option(export_handle, TRUXTON_EXPORT_FILE_OPTION_TAR, "JPGWithExif.tar");

// Go find the files and output them to C:\temp\JPGWithExif.tar
truxton_file_export_execute(export_handle);

// Clean up
truxton_file_export_destroy(export_handle);
truxton_destroy(truxton);
truxton_stop();
}
</source>

@@ Line 65: / Line 65: @@
 #pragma hdrstop
-int main( void )
+void main( void )
+{
      char temporary_string[256];

@@ Line 52: / Line 52: @@
 The file group to export.
 You can specify a comma separated list of file groups if you want to export more than a single type.
 =Sample=
-<source lang="C" highlight="20,23,26,29,32">
+<source lang="C" highlight="20,23,26,29,32,35">
 #include "TruxtonCAPI.h"
 #pragma comment(lib, "TruxtonCAPI.lib")
@@ Line 85: / Line 88: @@
      truxton_file_export_add_criteria( export_handle, TRUXTON_EXPORT_FILE_QUERY_FIELD_SIZE_MAXIMUM, "5242880" );
-     // Limit the output to a single file
+     // Limit the output to a hundred file
-     truxton_file_export_add_criteria( export_handle, TRUXTON_EXPORT_FILE_QUERY_FIELD_LIMIT, "1" );
+     truxton_file_export_add_criteria( export_handle, TRUXTON_EXPORT_FILE_QUERY_FIELD_LIMIT, "001" );
      truxton_file_export_where_clause( export_handle, temporary_string, sizeof(temporary_string) );
@@ Line 98: / Line 104: @@
      // We want them output to a TAR file in that particular folder
-     truxton_file_export_set_option( export_handle, TRUXTON_EXPORT_FILE_OPTION_TAR, "JPGWithExif.tar" );
+     truxton_file_export_set_option( export_handle, TRUXTON_EXPORT_FILE_OPTION_TAR, "CarvedGraphics.tar" );
-     // Go find the files and output them to C:\temp\JPGWithExif.tar
+     // Go find the files and output them to C:\temp\CarvedGraphics.tar
      truxton_file_export_execute( export_handle );

@@ Line 48: / Line 48: @@
 ==<code>TRUXTON_EXPORT_FILE_QUERY_FIELD_LIMIT</code>==
 Sets the maximum number of files to export.
 =Sample=

@@ Line 3: / Line 3: @@
 =Syntax=
 <source lang="C">
-void truxton_file_export_add_criteria(uint64_t export_handle, uint64_t field, char const * value);
+void truxton_file_export_add_criteria( uint64_t export_handle, uint64_t field, char const * value );
 </source>
@@ Line 66: / Line 66: @@
      uint64_t truxton = truxton_create();
-     uint64_t export_handle = truxton_file_export_create(truxton);
+     uint64_t export_handle = truxton_file_export_create( truxton );
      // We want a variety of file types
-     sprintf_s(temporary_string, sizeof(temporary_string), "%d, %d, %d", Type_JPEGWithExif, Type_JPEG, Type_GIF);
+     sprintf_s( temporary_string, sizeof(temporary_string), "%d, %d, %d", Type_JPEGWithExif, Type_JPEG, Type_GIF );
-     truxton_file_export_add_criteria(export_handle, TRUXTON_EXPORT_FILE_QUERY_FIELD_TYPE, temp_string);
+     truxton_file_export_add_criteria( export_handle, TRUXTON_EXPORT_FILE_QUERY_FIELD_TYPE, temp_string );
      // We only want files where the MD5 hash starts with "e4"
-     truxton_file_export_add_criteria(export_handle, TRUXTON_EXPORT_FILE_QUERY_FIELD_HASH, "e4");
+     truxton_file_export_add_criteria( export_handle, TRUXTON_EXPORT_FILE_QUERY_FIELD_HASH, "e4" );
      // We want a file that is at least 4MB long
-     truxton_file_export_add_criteria(export_handle, TRUXTON_EXPORT_FILE_QUERY_FIELD_SIZE_MINIMUM, "4194304");
+     truxton_file_export_add_criteria( export_handle, TRUXTON_EXPORT_FILE_QUERY_FIELD_SIZE_MINIMUM, "4194304" );
      // We want a file that is no larger than 5MB
-     truxton_file_export_add_criteria(export_handle, TRUXTON_EXPORT_FILE_QUERY_FIELD_SIZE_MAXIMUM, "5242880");
+     truxton_file_export_add_criteria( export_handle, TRUXTON_EXPORT_FILE_QUERY_FIELD_SIZE_MAXIMUM, "5242880" );
      // Limit the output to a single file
-     truxton_file_export_add_criteria(export_handle, TRUXTON_EXPORT_FILE_QUERY_FIELD_LIMIT, "1");
+     truxton_file_export_add_criteria( export_handle, TRUXTON_EXPORT_FILE_QUERY_FIELD_LIMIT, "1" );
-     truxton_file_export_where_clause(export_handle, temporary_string, sizeof(temporary_string));
+     truxton_file_export_where_clause( export_handle, temporary_string, sizeof(temporary_string) );
-     printf( "Will use the following WHERE clause to select files: %s\n", temporary_string);
+     printf( "Will use the following WHERE clause to select files: %s\n", temporary_string );
      // Rename the file being exported to include the hash before the original name
-     truxton_file_export_set_option(export_handle, TRUXTON_EXPORT_FILE_OPTION_NAME_FORMAT, "{hash}_{name}");
+     truxton_file_export_set_option( export_handle, TRUXTON_EXPORT_FILE_OPTION_NAME_FORMAT, "{hash}_{name}" );
      // The files should be output to a particular folder
-     truxton_file_export_set_option(export_handle, TRUXTON_EXPORT_FILE_OPTION_FOLDER, "C:\\temp");
+     truxton_file_export_set_option( export_handle, TRUXTON_EXPORT_FILE_OPTION_FOLDER, "C:\\temp" );
      // We want them output to a TAR file in that particular folder
-     truxton_file_export_set_option(export_handle, TRUXTON_EXPORT_FILE_OPTION_TAR, "JPGWithExif.tar");
+     truxton_file_export_set_option( export_handle, TRUXTON_EXPORT_FILE_OPTION_TAR, "JPGWithExif.tar" );
      // Go find the files and output them to C:\temp\JPGWithExif.tar
-     truxton_file_export_execute(export_handle);
+     truxton_file_export_execute( export_handle );
      // Clean up
-     truxton_file_export_destroy(export_handle);
+     truxton_file_export_destroy( export_handle );
-     truxton_destroy(truxton);
+     truxton_destroy( truxton );
      truxton_stop();
+}
 </source>