[PHP-DOC] cvs: phpdoc /en/functions image.xml From: Rasmus Lerdorf (rasmus <email protected>)
Date: 08/07/00

rasmus Mon Aug 7 14:45:15 2000 EDT

  Modified files:
    /phpdoc/en/functions image.xml
  Log:
  Document read_exif_data
  
  
Index: phpdoc/en/functions/image.xml
diff -u phpdoc/en/functions/image.xml:1.19 phpdoc/en/functions/image.xml:1.20
--- phpdoc/en/functions/image.xml:1.19 Fri Aug 4 21:41:05 2000
+++ phpdoc/en/functions/image.xml Mon Aug 7 14:45:15 2000
@@ -2108,6 +2108,76 @@
     </para>
    </refsect1>
   </refentry>
+
+ <refentry id="function.read_exif_data">
+ <refnamediv>
+ <refname>read_exif_data</refname>
+ <refpurpose>Read the EXIF headers from a JPEG</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>read_exif_data</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ The <function>read_exif_data</function> function reads the
+ EXIF headers from a JPEG image file. It returns an associative
+ array where the indeces are the Exif header names and the values
+ are the values associated with those Exif headers. Exif headers
+ tend to be present in JPEG images generated by digital cameras, but
+ unfortunately each digital camera maker has a different idea of how
+ to actually tag their images, so you can't always rely on a specific
+ Exif header being present.
+ <example>
+ <title>read_exif_data</title>
+ <programlisting role="php">
+&lt;?php
+ $exif = read_exif_data ('p0001807.jpg');
+ while(list($k,$v)=each($exif)) {
+ echo "$k: $v&lt;br>\n";
+ }
+?>
+
+Output:
+FileName: p0001807.jpg
+FileDateTime: 929353056
+FileSize: 378599
+CameraMake: Eastman Kodak Company
+CameraModel: KODAK DC265 ZOOM DIGITAL CAMERA (V01.00)
+DateTime: 1999:06:14 01:37:36
+Height: 1024
+Width: 1536
+IsColor: 1
+FlashUsed: 0
+FocalLength: 8.0mm
+RawFocalLength: 8
+ExposureTime: 0.004 s (1/250)
+RawExposureTime: 0.0040000001899898
+ApertureFNumber: f/ 9.5
+RawApertureFNumber: 9.5100002288818
+FocusDistance: 16.66m
+RawFocusDistance: 16.659999847412
+Orientation: 1
+ExifVersion: 0200
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ <note>
+ <simpara>
+ This function is only available in PHP4 compiled using --enable-exif
+ </simpara>
+ <simpara>
+ This function does not require the GD image library.
+ </simpara>
+ </note>
+ </para>
+ </refsect1>
+ </refentry>
+
  </reference>
 
 <!-- Keep this comment at the end of the file