Truxton file create location - Revision history

Sam at 08:57, 13 February 2021

2021-02-13T08:57:27Z

Sam at 16:55, 4 December 2020

2020-12-04T16:55:31Z

Sam: /* Sample */

2020-06-13T08:23:17Z

Sample

Sam: /* file_handle */

2020-06-10T08:06:42Z

file_handle

Sam: Created page with "This creates a geographic location object sourced from this file that you can use in the Location API. A location object is how you add..."

2020-06-10T07:58:22Z

Created page with "This creates a geographic location object sourced from this file that you can use in the Location API. A location object is how you add..."

New page

This creates a geographic location object sourced from this file that you can use in the [[Truxton C API#Geographic Location | Location API.]]
A location object is how you add records to the <code>[[Location Table | Location]]</code> table.
The resulting object will automatically be associated with the file it was created from and with the media the file belongs to.

=Syntax=
<syntaxhighlight lang="C">
uint64_t truxton_file_create_location( uint64_t file_handle );
</syntaxhighlight>

=Parameters=
==<code>file_handle</code>==

The handle created by the [[truxton_child_file_create]] or [[truxton_file_create_child]] call.

=Return value=
A handle to an location object.

=Sample=

<syntaxhighlight lang="C" highlight="5">
void process_file(uint64_t truxton)
{
uint64_t file = truxton_file_open_md5(truxton, "9ec8fb6095c35eff2b236863b7caaf10");

uint64_t location = truxton_child_file_create_location(file);

truxton_location_set_latitude(location, 18.30305549975252);
truxton_location_set_longitude(location, -64.824006192214);
truxton_location_set_altitude(location, 1.1);
truxton_location_set_type(location, LOCATION_TYPE_GOPRO_VIDEO);
truxton_location_save(location);
truxton_location_destroy(location);

truxton_file_destroy(file);
}
</syntaxhighlight>

@@ Line 17: / Line 17: @@
 =Sample=
 <source lang="C" highlight="5">
-void process_file(uint64_t truxton)
+void process_file( uint64_t truxton )
+{
-    uint64_t file = truxton_file_open_md5(truxton, "9ec8fb6095c35eff2b236863b7caaf10");
+    uint64_t file = truxton_file_open_md5( truxton, "9ec8fb6095c35eff2b236863b7caaf10" );
-    uint64_t location = truxton_child_file_create_location(file);
+    uint64_t location = truxton_child_file_create_location( file );
-    truxton_location_set_latitude(location, 18.30305549975252);
+    truxton_location_set_latitude( location, 18.30305549975252 );
-    truxton_location_set_longitude(location, -64.824006192214);
+    truxton_location_set_longitude( location, -64.824006192214 );
-    truxton_location_set_altitude(location, 1.1);
+    truxton_location_set_altitude( location, 1.1 );
-    truxton_location_set_type(location, LOCATION_TYPE_GOPRO_VIDEO);
+    truxton_location_set_type( location, LOCATION_TYPE_GOPRO_VIDEO );
-    truxton_location_save(location);
+    truxton_location_save( location );
-    truxton_location_destroy(location);
+    truxton_location_destroy( location );
-    truxton_file_free(file);
+    truxton_file_free( file );
+}
 </source>

@@ Line 1: / Line 1: @@
 This creates a geographic location object sourced from this file that you can use in the [[Truxton C API#Geographic Location | Location API.]]
-A location object is how you add records to the <code>[[Location Table | Location]]</code> table.
+A location object is how you add records to the <code><nowiki>[</nowiki>[[Location Table|Location]]<nowiki>]</nowiki></code> table.
 The resulting object will automatically be associated with the file it was created from and with the media the file belongs to.
 =Syntax=
-<syntaxhighlight lang="C">
+<source lang="C">
 uint64_t truxton_file_create_location( uint64_t file_handle );
-</syntaxhighlight>
+</source>
 =Parameters=
@@ Line 16: / Line 16: @@
 =Sample=
+<source lang="C" highlight="5">
 void process_file(uint64_t truxton)
+{
@@ Line 33: / Line 32: @@
     truxton_file_free(file);
+}
-</syntaxhighlight>
+</source>

@@ Line 10: / Line 10: @@
 =Parameters=
 ==<code>file_handle</code>==
+The handle created by the [[truxton_file_open_id]] or [[truxton_file_open_md5]] call.
 =Return value=