TruxtonEXIF - Revision history

Sam: /* Sample */

2024-09-11T18:17:23Z

Sample

Sam: /* Sample */

2024-01-27T19:09:45Z

Sample

Sam: /* Sample */

2023-05-03T08:24:32Z

Sample

Sam at 22:19, 2 May 2023

2023-05-02T22:19:53Z

Sam: /* Attributes and Methods */

2022-10-01T11:53:04Z

Attributes and Methods

Sam: /* Attributes and Methods */

2022-10-01T11:17:16Z

Attributes and Methods

Sam at 20:59, 16 September 2022

2022-09-16T20:59:28Z

Sam: /* Attributes and Methods */

2022-07-29T15:44:51Z

Attributes and Methods

Sam: /* Sample */

2021-02-09T14:50:44Z

Sample

Sam at 15:02, 2 November 2020

2020-11-02T15:02:25Z

@@ Line 138: / Line 138: @@
 def add_file(parent_truxton_file, filename):
    child = parent_truxton_file.newchild()
    child.name = Path(filename).name
-   shutil.copyfileobj(source_file, child)
+   with open(filename, "rb") as source_file:
-  source_file.close()
+    shutil.copyfileobj(source_file, child)
    child.save()
    return child

@@ Line 183: / Line 183: @@
 if __name__ == "__main__":
-   main()
+   sys.exit(main())
 </source>

@@ Line 127: / Line 127: @@
 =Sample=
-<source lang="Python" highlight="43-49">
+<source lang="Python" highlight="37-43">
 import sys
 sys.path.append('C:/Program Files/Truxton/SDK')
@@ Line 136: / Line 136: @@
 from calendar import timegm
 from pathlib import Path
 def add_file(parent_truxton_file, filename):
@@ Line 175: / Line 169: @@
    exif.make = "Universal"
    exif.model = "Minute 16"
-   exif.devicetime = date_to_filetime(datetime.fromisoformat("2016-04-01T12:00:00-05:00"))
+   exif.devicetime = datetime.fromisoformat("2016-04-01T12:00:00-05:00")
    exif.save()

@@ Line 25: / Line 25: @@
 The offset into the file where the body serial number was found
-==<code>devicetime: int</code>==
+==<code>devicetime: [https://docs.python.org/3/library/datetime.html datetime]</code>==
-The timestamp of the image taken from the clock of the imaging device in [https://docs.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-filetime FILETIME] ticks.
+The timestamp of the image taken from the clock of the imaging device.
 ==<code>devicetimeoffset: int</code>==
@@ Line 41: / Line 42: @@
 The offset in the file where focal length was found.
-==<code>gpstime: int</code>==
+==<code>gpstime: [https://docs.python.org/3/library/datetime.html datetime]</code>==
-The timestamp from a [https://en.wikipedia.org/wiki/Global_Positioning_System GPS] unit in the imaging device in [https://docs.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-filetime FILETIME] ticks.
+The timestamp from a [https://en.wikipedia.org/wiki/Global_Positioning_System GPS] unit in the imaging device.
 ==<code>gpstimeoffset: int</code>==

@@ Line 12: / Line 12: @@
 [https://docs.python.org/3.10/library/constants.html?highlight=false#True True] if the tag was associated with the EXIF, [https://docs.python.org/3.10/library/constants.html?highlight=false#False False] on failure.
 The note is stored in the <code>[InvestigatorNote]</code> table in the database.
 ==<code>altitude: float</code>==

@@ Line 6: / Line 6: @@
 =Attributes and Methods=
 ==<code>altitude: float</code>==
 The altitude in meters.
@@ Line 103: / Line 111: @@
 The <code>origin</code> is either <code>TAG_ORIGIN_AUTOMATIC</code> (1) or <code>TAG_ORIGIN_HUMAN</code> (2).
 It will return
-[https://docs.python.org/3.8/library/constants.html?highlight=false#True True] if the tag was associated with the camera information, [https://docs.python.org/3.8/library/constants.html?highlight=false#False False] on failure.
+[https://docs.python.org/3.10/library/constants.html?highlight=false#True True] if the tag was associated with the camera information, [https://docs.python.org/3.10/library/constants.html?highlight=false#False False] on failure.
 ==<code>thumbnaillength: int</code>==

@@ Line 87: / Line 87: @@
 The offset into the file where the model was found.
-==<code>save() -> bool</code>==
+==<code>save() -> boolean</code>==
 This will commit the information to the <code><nowiki>[</nowiki>[[EXIF Table|EXIF]]<nowiki>]</nowiki></code> table.
 It will return [https://docs.python.org/3/library/constants.html#True True] if the record was saved to the database, [https://docs.python.org/3/library/constants.html#False False] if there was an error.
@@ Line 97: / Line 97: @@
 The offset into the file where shutter count was found.
-==<code>tag(tag: str, reason: str, origin: int) -> bool</code>==
+==<code>tag(tag: str, reason: str, origin: int) -> boolean</code>==
 This creates a tag associated with this camera information in Truxton.
 The <code>tag</code> parameter is a short, one or two word, bit of text that will be displayed in the UI.

@@ Line 6: / Line 6: @@
 =Attributes and Methods=
-==<code>altitude</code>==
+==<code>altitude: float</code>==
 The altitude in meters.
-==<code>altitudeoffset</code>==
+==<code>altitudeoffset: int</code>==
 The offset into the file where the altitude was found.
-==<code>bodyserialnumber</code>==
+==<code>bodyserialnumber: str</code>==
 The serial number of the body of the imaging device.
-==<code>bodyserialnumberoffset</code>==
+==<code>bodyserialnumberoffset: int</code>==
 The offset into the file where the body serial number was found
-==<code>devicetime</code>==
+==<code>devicetime: int</code>==
 The timestamp of the image taken from the clock of the imaging device in [https://docs.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-filetime FILETIME] ticks.
-==<code>devicetimeoffset</code>==
+==<code>devicetimeoffset: int</code>==
 The offset into the file where the device time was found.
-==<code>fileid</code>==
+==<code>fileid: str</code>==
 The [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the file this camera information came from.
 This corresponds to the <code>[FileID]</code> column of the <code><nowiki>[</nowiki>[[EXIF Table|EXIF]]<nowiki>]</nowiki></code> table.
-==<code>focallength</code>==
+==<code>focallength: int</code>==
 The focal length of the lens in [https://en.wikipedia.org/wiki/35_mm_equivalent_focal_length 35mm equivalent.]
-==<code>focallengthoffset</code>==
+==<code>focallengthoffset: int</code>==
 The offset in the file where focal length was found.
-==<code>gpstime</code>==
+==<code>gpstime: int</code>==
 The timestamp from a [https://en.wikipedia.org/wiki/Global_Positioning_System GPS] unit in the imaging device in [https://docs.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-filetime FILETIME] ticks.
-==<code>gpstimeoffset</code>==
+==<code>gpstimeoffset: int</code>==
 The offset in the file where the [https://en.wikipedia.org/wiki/Global_Positioning_System GPS] time was found.
-==<code>heading</code>==
+==<code>heading: float</code>==
 The compass heading of the image.
 The direction the camera was pointing when the image was taken.
-==<code>headingoffset</code>==
+==<code>headingoffset: int</code>==
 The offset into the file where the heading was found.
-==<code>id</code>==
+==<code>id: str</code>==
 This is the [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the record.
 It becomes non-zero after <code>save()</code> has been called.
 This corresponds to the <code>[ID]</code> column of the <code><nowiki>[</nowiki>[[EXIF Table|EXIF]]<nowiki>]</nowiki></code> table.
-==<code>latitude</code>==
+==<code>latitude: float</code>==
 The [https://en.wikipedia.org/wiki/Latitude latitude] portion of the geographic coordinate using the [https://en.wikipedia.org/wiki/World_Geodetic_System#WGS84 WGS84] ellipsoid.
-==<code>latitudeoffset</code>==
+==<code>latitudeoffset: int</code>==
 The offset into the file where the latitude was found.
-==<code>lensserialnumber</code>==
+==<code>lensserialnumber: str</code>==
 The serial number of the lens.
-==<code>lensserialnumberoffset</code>==
+==<code>lensserialnumberoffset: int</code>==
 The offset into the file where the lens serial number was found.
-==<code>longitude</code>==
+==<code>longitude: float</code>==
 The [https://en.wikipedia.org/wiki/Longitude longitude] portion of the geographic coordinate using the [https://en.wikipedia.org/wiki/World_Geodetic_System#WGS84 WGS84] ellipsoid.
 Many thanks go to [https://en.wikipedia.org/wiki/John_Harrison John Harrison] for his work.
-==<code>longitudeoffset</code>==
+==<code>longitudeoffset: int</code>==
 The offset into the file where longitude was found.
-==<code>make</code>==
+==<code>make: str</code>==
 The manufacturer of the imaging device.
-==<code>makeoffset</code>==
+==<code>makeoffset: int</code>==
 The offset into the file where the make was found.
-==<code>mediaid</code>==
+==<code>mediaid: str</code>==
 This is the [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the media this artifact came from.
 This corresponds to the <code>[MediaID]</code> column of the <code><nowiki>[</nowiki>[[EXIF Table|EXIF]]<nowiki>]</nowiki></code> table.
-==<code>model</code>==
+==<code>model: str</code>==
 The model of the imaging device.
-==<code>modeloffset</code>==
+==<code>modeloffset: int</code>==
 The offset into the file where the model was found.
-==<code>save()</code>==
+==<code>save() -> bool</code>==
 This will commit the information to the <code><nowiki>[</nowiki>[[EXIF Table|EXIF]]<nowiki>]</nowiki></code> table.
 It will return [https://docs.python.org/3/library/constants.html#True True] if the record was saved to the database, [https://docs.python.org/3/library/constants.html#False False] if there was an error.
-==<code>shuttercount</code>==
+==<code>shuttercount: int</code>==
 The number of times the shutter has been activated on the imaging device.
-==<code>shuttercountoffset</code>==
+==<code>shuttercountoffset: int</code>==
 The offset into the file where shutter count was found.
-==<code>tag(tag, reason, origin)</code>==
+==<code>tag(tag: str, reason: str, origin: int) -> bool</code>==
 This creates a tag associated with this camera information in Truxton.
 The <code>tag</code> parameter is a short, one or two word, bit of text that will be displayed in the UI.
@@ Line 105: / Line 105: @@
 [https://docs.python.org/3.8/library/constants.html?highlight=false#True True] if the tag was associated with the camera information, [https://docs.python.org/3.8/library/constants.html?highlight=false#False False] on failure.
-==<code>thumbnaillength</code>==
+==<code>thumbnaillength: int</code>==
 The length of the thumbnail of this image.
-==<code>thumbnaillengthoffset</code>==
+==<code>thumbnaillengthoffset: int</code>==
 The offset in the file where the length of the thumbnail image was found.
-==<code>thumbnailoffset</code>==
+==<code>thumbnailoffset: int</code>==
 The offset of the thumbnail image.
-==<code>thumbnailoffsetoffset</code>==
+==<code>thumbnailoffsetoffset: int</code>==
 The offset in the file where thumbnail offset was found.

@@ Line 118: / Line 118: @@
 =Sample=
+<source lang="Python" highlight="43-49">
-<syntaxhighlight lang="Python" highlight="41-47">
+import sys
 import truxton
 import shutil
@@ Line 180: / Line 181: @@
 if __name__ == "__main__":
    main()
-</syntaxhighlight>
+</source>