exif-read-data.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f57352dd7a678230f929e1bac0d4a9189631cf16 Maintainer: nilgun Status: ready -->
<refentry xml:id="function.exif-read-data" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>exif_read_data</refname>
  <refpurpose>Bir görüntü dosyasından <acronym>EXIF</acronym> başlıklarını okur</refpurpose>
 </refnamediv>
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type class="union"><type>array</type><type>false</type></type><methodname>exif_read_data</methodname>
   <methodparam><type class="union"><type>kaynak</type><type>string</type></type><parameter>file</parameter></methodparam>
   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>bölümler</parameter><initializer>&null;</initializer></methodparam>
   <methodparam choice="opt"><type>bool</type><parameter>diziler</parameter><initializer>&false;</initializer></methodparam>
   <methodparam choice="opt"><type>bool</type><parameter>küçük_örnek</parameter><initializer>&false;</initializer></methodparam>
  </methodsynopsis>
  <para>
    Bir görüntü dosyasından <acronym>EXIF</acronym> başlıklarını okur Böylece
    sayısal kameralar tarafından üretilen temel veriler okunabilir.
  </para>
  <para>
   Exif başlıkları sayısal kameralar tarafından üretilen JPEG/TIFF görüntülerde
   bulunması için tasarlanmışlarsa da ne yazık ki, her sayısal kamera
   imalatçısı görüntü başlıklarının elde edilmesi konusunda farklı yaklaşımlara
   sahiptirler. Bu bakımdan bazı Exif başlıkları görüntü üzerinde mevcut
   olmayabilir.
  </para>
  <para>
   <literal>Height</literal> ve <literal>Width</literal> başlıkları
   <function>getimagesize</function> işlevinin yaptığı gibi hesaplandığından
   döndürülen başlığın birer parçası olmamalıdırlar. <literal>html</literal>
   başlığı normal <acronym>HTML</acronym> içinde kullanılacak metnin
   yükseklik/genişlik dizgesidir.
  </para>
  <para>
   Bir Exif başlığı bir telif hakkı bilgisi içerdiği takdirde, bu iki değerden
   oluşur. Çözüm Exif 2.10 standadıyla uyumsuz olup <literal>COMPUTED</literal>
   bölümü hem <literal>Copyright.Photographer</literal> hem de
   <literal>Copyright.Editor</literal> başlıklarını içerirken
   <acronym>IFD0</acronym> bölümleri iki girdiyi ayıran &null; karakterli bayt
   dizisini içerir. Eğer veri türü yanlışsa sadece ilk girdi döner (Exif'in
   normal davranışı).  <literal>COMPUTED</literal> bölümü ayrıca,
   <literal>Copyright</literal> dizgesini de içerir ve bu dizge
   ya özgün telif hakkı dizgesini ya da fotoğraf ve eser düzenleyici telif
   haklarını içeren dizgeyi içerir.
  </para>
  <para>
   <literal>UserComment</literal> yaftası <literal>Copyright</literal> yaftası
   ile aynı sorunlara sahiptir. O da iki değer saklayabilir. İlki kullanılan
   kodlama, ikincisi değerin kendisidir. Bu durumda, <literal>IFD</literal>
   bölümü sadece kodlamayı ve bayt dizisini içerir. <literal>COMPUTED</literal>
   bölümü <literal>UserCommentEncoding</literal> ve
   <literal>UserComment</literal> girdilerinin ikisini de saklar.
   <literal>UserComment</literal> girdisi her iki durumda da mevcuttur,
   dolayısıyla <literal>IFD0</literal> bölümündeki değere tercihan kullanılmış
   olmalıdır.
  </para>
  <para>
   <function>exif_read_data</function> işlevi ayrıca,  EXIF belirtimine uygun
   olarak EXIF veri başlıklarını da doğrular.
  </para>
 </refsect1>
 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>kaynak</parameter></term>
     <listitem>
      <para>
       Görüntü dosyasının yeri. Bir dosya yolu (akım sarmalayıcılar
       belirtilebilir) veya <type>resource</type> türünde bir akım.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>bölümler</parameter></term>
     <listitem>
      <para>
       Sonuç dizisinin üretiminde kullanılmak üzere dosyadaki başlıkların
       virgül ayraçlı listesi. Belirtilen başlıkların hiçbiri bulunamazsa
       işlev &false; döndürür.
       <informaltable>
        <tgroup cols="2">
         <tbody>
          <row>
           <entry>FILE</entry>
           <entry><literal>FileName</literal>, <literal>FileSize</literal>,
           <literal>FileDateTime</literal>, <literal>SectionsFound</literal>
           (Dosyaİsmi, DosyaBoyu, DosyaTarihiSaati, BölümlarVar)</entry>
          </row>
          <row>
           <entry>COMPUTED</entry>
           <entry>
            <literal>html</literal>, <literal>Width</literal>,
            <literal>Height</literal>, <literal>IsColor</literal> (html,
            genişlik, yükseklik, Renklidir) ve varsa başkaları.
            <literal>Height</literal> ve <literal>Width</literal>,
            <function>getimagesize</function> işlevinin yaptığı gibi
            hesaplanır, dolayısıyla bunlar döndürülen başlığın parçaları
            olmamalıdır. Ayrıca, <literal>html</literal>, normal
            <acronym>HTML</acronym> içinde kullanılacak height/width dizgesidir.
           </entry>
          </row>
          <row>
           <entry>ANY_TAG</entry>
           <entry><literal>IFD0</literal>, <literal>EXIF</literal>, ... gibi bir
           yaftaya sahip her türlü bilgi
           </entry>
          </row>
          <row>
           <entry>IFD0</entry>
           <entry>
            <literal>IFD0</literal>'ın tüm yaftalanmış bilgisi. Normal görüntü
            dosyalarında burada görüntü boyutu ve saire bulunur.
           </entry>
          </row>
          <row>
           <entry>THUMBNAIL</entry>
           <entry>
            Dosya ikinci bir <literal>IFD</literal>'ye sahipse görüntünün küçük bir
            örneğini içerdiği varsayılır. Küçük görüntü örneği ile ilgili tüm
            veriler bu bölümde saklanır.
           </entry>
          </row>
          <row>
           <entry>COMMENT</entry>
           <entry>JPEG görüntülerin açıklama başlıkları.</entry>
          </row>
          <row>
           <entry>EXIF</entry>
           <entry>
            <literal>EXIF</literal> bölümü <literal>IFD0</literal> bölümünün bir
            alt bölümüdür. Burada görüntü hakkında çok daha fazla bilgi bulunur.
            Bu girdilerin çoğu sayısal kamera ile ilgilidir.
           </entry>
          </row>
         </tbody>
        </tgroup>
       </informaltable>
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>diziler</parameter></term>
      <listitem>
      <para>
       Her bölümün bir dizi haline getirilip getirilmeyeceğini belirler.
       <literal>COMPUTED</literal>, <literal>THUMBNAIL</literal> ve
       <literal>COMMENT</literal> bölümleri, diğer bölümlerle karışmaması için
       daima bir dizi haline getirilirler.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>küçük_örnek</parameter></term>
     <listitem>
      <para>
       &true; belirtilmişse küçük görüntü örneğinin kendisi okunur. Aksi
       takdirde, sadece yaftalı veriler okunur.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Dönen değer bir dizi olup, dizi indisleri başlık isimlerini, değerler bu
   başlıklarla ilgili verileri içerir. Eğer hiçbir veri döndürülemezse
   <function>exif_read_data</function> işlevi &false; döndürür.
  </para>
 </refsect1>

 <refsect1 role="errors">
  &reftitle.errors;
  <para>
   Desteklenmeyen başlıklar veya olası hata durumlarında
   <constant>E_WARNING</constant> ve/veya <constant>E_NOTICE</constant>
   seviyesinde hata üretilebilir, fakat işlev hala anlaşılabilir bilgileri
   okumaya çalışır.
  </para>
 </refsect1>

 <refsect1 role="changelog">
  &reftitle.changelog;
  <para>
   <informaltable>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>&Version;</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>8.0.0</entry>
       <entry>
        <parameter>bölümler</parameter> artık boş olabiliyor.
       </entry>
      </row>
      <row>
       <entry>7.2.0</entry>
       <entry>
        <parameter>kaynak</parameter> bağımsız değişkeni normal dosyalardan başka
        artık akımları da destekliyor.
       </entry>
      </row>
      <row>
       <entry>7.2.0</entry>
       <entry>
        <para>
         Aşağıdaki EXIF biçemlerine destek eklendi:
         <simplelist>
          <member>Samsung</member>
          <member>DJI</member>
          <member>Panasonic</member>
          <member>Sony</member>
          <member>Pentax</member>
          <member>Minolta</member>
          <member>Sigma/Foveon</member>
          <member>AGFA</member>
          <member>Kyocera</member>
          <member>Ricoh</member>
          <member>Epson</member>
         </simplelist>
        </para>
       </entry>
      </row>
     </tbody>
    </tgroup>
   </informaltable>
  </para>
 </refsect1>
 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>- <function>exif_read_data</function> örneği</title>
    <programlisting role="php">
<![CDATA[
<?php
echo "test1.jpg:<br />\n";
$exif = exif_read_data('tests/test1.jpg', 'IFD0');
echo $exif===false ? "<Başlık verisi bulunamadı.<br />\n" : "Görüntü başlıkları içeriyor<br />\n";

$exif = exif_read_data('tests/test2.jpg', 0, true);
echo "test2.jpg:<br />\n";
foreach ($exif as $key => $section) {
    foreach ($section as $name => $val) {
        echo "$key.$name: $val<br />\n";
    }
}
?>
]]>
    </programlisting>
    <para>
     Görüntü başlık bilgisi içermediğinden ilk çağrı başarısız olur.
    </para>
    &example.outputs.similar;
    <screen role="php">
<![CDATA[
test1.jpg:
Başlık verisi bulunamadı.
test2.jpg:
FILE.FileName: test2.jpg
FILE.FileDateTime: 1017666176
FILE.FileSize: 1240
FILE.FileType: 2
FILE.SectionsFound: ANY_TAG, IFD0, THUMBNAIL, COMMENT
COMPUTED.html: width="1" height="1"
COMPUTED.Height: 1
COMPUTED.Width: 1
COMPUTED.IsColor: 1
COMPUTED.ByteOrderMotorola: 1
COMPUTED.UserComment: Exif test image.
COMPUTED.UserCommentEncoding: ASCII
COMPUTED.Copyright: Photo (c) M.Boerger, Edited by M.Boerger.
COMPUTED.Copyright.Photographer: Photo (c) M.Boerger
COMPUTED.Copyright.Editor: Edited by M.Boerger.
IFD0.Copyright: Photo (c) M.Boerger
IFD0.UserComment: ASCII
THUMBNAIL.JPEGInterchangeFormat: 134
THUMBNAIL.JPEGInterchangeFormatLength: 523
COMMENT.0: Comment #1.
COMMENT.1: Comment #2.
COMMENT.2: Comment #3end
THUMBNAIL.JPEGInterchangeFormat: 134
THUMBNAIL.Thumbnail.Height: 1
THUMBNAIL.Thumbnail.Height: 1
]]>
    </screen>
   </example>
  </para>
  <para>
   <example>
    <title>- PHP 7.2.0 itibariyle <function>exif_read_data</function>
      akımları destekliyor</title>
    <programlisting role="php">
<![CDATA[
<?php
// Bir dosya açar, bu ikil kipte olmalı
$fp = fopen('/path/to/image.jpg', 'rb');

if (!$fp) {
    echo 'Hata: Görüntü okumak için açılamadı';
    exit;
}

// Exif başlıklarını okumaya çalış
$headers = exif_read_data($fp);

if (!$headers) {
    echo 'Hata: Exif başlıkları okunamadı';
    exit;
}

// 'COMPUTED' başlıklarını bas
echo 'EXIF Headers:' . PHP_EOL;

foreach ($headers['COMPUTED'] as $header => $value) {
    printf(' %s => %s%s', $header, $value, PHP_EOL);
}
?>
]]>
    </programlisting>
    &example.outputs.similar;
    <screen role="php">
<![CDATA[
EXIF Headers:
 Height => 576
 Width => 1024
 IsColor => 1
 ByteOrderMotorola => 0
 ApertureFNumber => f/5.6
 UserComment =>
 UserCommentEncoding => UNDEFINED
 Copyright => Denis
 Thumbnail.FileType => 2
 Thumbnail.MimeType => image/jpeg
]]>
    </screen>
   </example>
  </para>
 </refsect1>
 <refsect1 role="notes">
  &reftitle.notes;
  <note>
   <para>
    <link linkend="ref.mbstring">mbstring</link> etkinse,
    unicode karakterleri işlemeye çalışır ve  <link
    linkend="ini.exif.decode-unicode-motorola">exif.decode_unicode_motorola</link>
    ve <link linkend="ini.exif.decode-unicode-intel">exif.decode_unicode_intel</link>
    ile belirtilen karakter kümesini seçer. Exif eklentisi karakter kodlamasını
    bulmaya çalışmaz. Kullanıcı <function>exif_read_data</function> işlevini
    çağırmadan önce bu iki ini yönergesinden birine uygun karakter kodlamasını
    belirtmelidir.
   </para>
  </note>
  <note>
   <para>
    <parameter>kaynak</parameter> bağımsız değişkeni işleve bir akım aktarmak için
    kullanılmışsa, akım araştırılabilri olmalıdır. Bu işlev döndükten sonra
    dosya göstericisinin yeri değişmeyecektir.
   </para>
  </note>
 </refsect1>
 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>exif_thumbnail</function></member>
    <member><function>getimagesize</function></member>
    <member><xref linkend="wrappers"/></member>
   </simplelist>
  </para>
 </refsect1>
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->