Sophie

Sophie

distrib > Mandriva > 2008.1 > i586 > by-pkgid > 703d980c580707c382b4e43e25965bc5 > files > 6469

php-manual-pt_BR-5.2.4-1mdv2008.1.noarch.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>getimagesize</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="Manual do PHP"
HREF="index.html"><LINK
REL="UP"
TITLE="Imagens, Funções de"
HREF="ref.image.html"><LINK
REL="PREVIOUS"
TITLE="gd_info"
HREF="function.gd-info.html"><LINK
REL="NEXT"
TITLE="image_type_to_extension"
HREF="function.image-type-to-extension.html"><META
HTTP-EQUIV="Content-type"
CONTENT="text/html; charset=UTF-8"></HEAD
><BODY
CLASS="refentry"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>Manual do PHP</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="function.gd-info.html"
ACCESSKEY="P"
>Anterior</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.image-type-to-extension.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="function.getimagesize"
></A
>getimagesize</H1
><DIV
CLASS="refnamediv"
><A
NAME="AEN82409"
></A
><P
>    (PHP 3, PHP 4, PHP 5)</P
>getimagesize&nbsp;--&nbsp;Obtém o tamanho de uma imagem</DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN82412"
></A
><H2
>Descrição</H2
>array <B
CLASS="methodname"
>getimagesize</B
> ( string filename [, array &#38;imageinfo] )<BR
></BR
><P
>&#13;    A função <B
CLASS="function"
>getimagesize()</B
> irá determinar o
    tamanho de qualquer arquivo de imagem <ACRONYM
CLASS="acronym"
>GIF</ACRONYM
>, <ACRONYM
CLASS="acronym"
>JPG</ACRONYM
>,
    <ACRONYM
CLASS="acronym"
>PNG</ACRONYM
>, <ACRONYM
CLASS="acronym"
>SWF</ACRONYM
>, 
    <ACRONYM
CLASS="acronym"
>SWC</ACRONYM
>, <ACRONYM
CLASS="acronym"
>PSD</ACRONYM
>, 
    <ACRONYM
CLASS="acronym"
>TIFF</ACRONYM
>, <ACRONYM
CLASS="acronym"
>BMP</ACRONYM
>, 
    <ACRONYM
CLASS="acronym"
>IFF</ACRONYM
>, <ACRONYM
CLASS="acronym"
>JP2</ACRONYM
>,
    <ACRONYM
CLASS="acronym"
>JPX</ACRONYM
>, <ACRONYM
CLASS="acronym"
>JB2</ACRONYM
>,
    <ACRONYM
CLASS="acronym"
>JPC</ACRONYM
>, <ACRONYM
CLASS="acronym"
>XBM</ACRONYM
>, ou
    <ACRONYM
CLASS="acronym"
>WBMP</ACRONYM
> e retornar as dimensões juntamente com
    o tipo de arquivo e a altura/largura para usar dentro de uma tag 
    <ACRONYM
CLASS="acronym"
>HTML</ACRONYM
> <TT
CLASS="literal"
>IMG</TT
>.
   </P
><P
>&#13;    Se for impossível acessar a imagem <CODE
CLASS="parameter"
>filename</CODE
>,
    ou se não for uma imagem válida, <B
CLASS="function"
>getimagesize()</B
>
    irá retornar <TT
CLASS="constant"
><B
>FALSE</B
></TT
> e gerar um erro de nível
    <CODE
CLASS="varname"
>E_WARNING</CODE
>.
   </P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
     Suporte para <ACRONYM
CLASS="acronym"
>JPC</ACRONYM
>, <ACRONYM
CLASS="acronym"
>JP2</ACRONYM
>,
     <ACRONYM
CLASS="acronym"
>JPX</ACRONYM
>, <ACRONYM
CLASS="acronym"
>JB2</ACRONYM
>,
     <ACRONYM
CLASS="acronym"
>XBM</ACRONYM
>, e <ACRONYM
CLASS="acronym"
>WBMP</ACRONYM
> tornou-se disponível no
     PHP 4.3.2.  Supporte para <ACRONYM
CLASS="acronym"
>SWC</ACRONYM
> a partir do PHP 4.3.0 e
     o suporte a <ACRONYM
CLASS="acronym"
>TIFF</ACRONYM
> foi adicionado no PHP 4.2.0 
    </P
></BLOCKQUOTE
></DIV
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
     Suporte a JPEG 2000 foi adicionado no PHP 4.3.2. Note que JPC e JP2 são
     capazes de ter componentes com profundidades diferentes de bit. Neste caso
     o valor para 'bits' é a maior profundidade de bits encontrada. Também, arquivos JP2
     podem conter múltiplos JPEG 2000 codestreams. Neste caso,
     <B
CLASS="function"
>getimagesize()</B
> retorna o valor para o primeiro
     codestream que encontrar na raíz do arquivo.
    </P
></BLOCKQUOTE
></DIV
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
     A função <B
CLASS="function"
>getimagesize()</B
> não requer a
     biblioteca de imagem GD.
    </P
></BLOCKQUOTE
></DIV
><P
>&#13;    Retorna uma matriz com 4 elementos. O índice 0 contém a largura da imagem
    em pixels. O índice 1 contém a altura. O índice 2 é uma 
    indicação do tipo de imagem: 1 = GIF, 2 = JPG, 3 =
    PNG, 4 = SWF, 5 = PSD, 6 = BMP, 7 = TIFF(intel byte order),
    8 = TIFF(motorola byte order), 9 = JPC, 10 = JP2, 11 = JPX, 12 =
    JB2, 13 = SWC, 14 = IFF, 15 = WBMP, 16 = XBM. Estes valores correspondem as 
    constantes IMAGETYPE que foram adicionadas no PHP 4.3. O índice 3 é uma
    string com  o height="yyy" width="xxx" correto que pode ser usado
    diretamente numa tag IMG.
    <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN82464"
></A
><P
><B
>Exemplo 1. getimagesize (file)</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br /></font><font color="#007700">list(</font><font color="#0000BB">$width</font><font color="#007700">, </font><font color="#0000BB">$height</font><font color="#007700">, </font><font color="#0000BB">$type</font><font color="#007700">, </font><font color="#0000BB">$attr</font><font color="#007700">) = </font><font color="#0000BB">getimagesize</font><font color="#007700">(</font><font color="#DD0000">"img/flag.jpg"</font><font color="#007700">);<br />echo </font><font color="#DD0000">"&lt;img src=</font><font color="#007700">\"</font><font color="#DD0000">img/flag.jpg</font><font color="#007700">\"</font><font color="#DD0000"> $attr alt=</font><font color="#007700">\"</font><font color="#DD0000">getimagesize() example</font><font color="#007700">\"</font><font color="#DD0000"> /&gt;"</font><font color="#007700">;<br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
   </P
><P
>&#13;    Suporte para URL foi adicionado PHP 4.0.5
    <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN82468"
></A
><P
><B
>Exemplo 2. getimagesize (URL)</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php <br />$size </font><font color="#007700">= </font><font color="#0000BB">getimagesize</font><font color="#007700">(</font><font color="#DD0000">"http://www.example.com/gifs/logo.gif"</font><font color="#007700">);<br /><br /></font><font color="#FF8000">// se o nome do arquivo tiver um espaço, codifique-o corretamente<br /></font><font color="#0000BB">$size </font><font color="#007700">= </font><font color="#0000BB">getimagesize</font><font color="#007700">(</font><font color="#DD0000">"http://www.example.com/gifs/lo%20go.gif"</font><font color="#007700">);<br /><br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
   </P
><P
>&#13;    Com imagens <ACRONYM
CLASS="acronym"
>JPG</ACRONYM
> dois indices extras são retornados:
    <TT
CLASS="literal"
>channels</TT
> e <TT
CLASS="literal"
>bits</TT
>.
    <TT
CLASS="literal"
>channels</TT
> será 3 para imagens RGB e 4 para imagens CMYK.
    <TT
CLASS="literal"
>bits</TT
> é o número de bits para cada cor.
   </P
><P
>&#13;    Começando no PHP 4.3.0, <TT
CLASS="literal"
>bits</TT
> e
    <TT
CLASS="literal"
>channels</TT
> estão presentes para outros tipos de imagens também.
    Entretanto, a presença desses valores pode ser um pouco confusa. Por exemplo,
    <ACRONYM
CLASS="acronym"
>GIF</ACRONYM
> sempre usa 3 channels por pixel, mas o
    número de bits por pixel não pode ser calculado para um
    <ACRONYM
CLASS="acronym"
>GIF</ACRONYM
> animado com uma tabela de cores global.
   </P
><P
>&#13;    Alguns formatos podem não conter imagens ou conter múltiplas imagens. Nestes casos,
    <B
CLASS="function"
>getimagesize()</B
> não será capaz de determinar
    o tamanho da imagem. <B
CLASS="function"
>getimagesize()</B
> retornará
    zero para a altura e largura nestes casos.
   </P
><P
>&#13;    Começando no PHP 4.3.0, <B
CLASS="function"
>getimagesize()</B
> também retorna um 
    parâmetro adicional, <TT
CLASS="literal"
>mime</TT
>, que corresponde ao tipo
    MIME da imagem. Esta informação pode ser usada para enviar imagens
    com o cabeçalho HTTP Content-type correto:
    <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN82488"
></A
><P
><B
>Exemplo 3. getimagesize() e tipos MIME </B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br />$size </font><font color="#007700">= </font><font color="#0000BB">getimagesize</font><font color="#007700">(</font><font color="#0000BB">$filename</font><font color="#007700">);<br /></font><font color="#0000BB">$fp</font><font color="#007700">=</font><font color="#0000BB">fopen</font><font color="#007700">(</font><font color="#0000BB">$filename</font><font color="#007700">, </font><font color="#DD0000">"rb"</font><font color="#007700">);<br />if (</font><font color="#0000BB">$size </font><font color="#007700">&amp;&amp; </font><font color="#0000BB">$fp</font><font color="#007700">) {<br />&nbsp;&nbsp;</font><font color="#0000BB">header</font><font color="#007700">(</font><font color="#DD0000">"Content-type: </font><font color="#007700">{</font><font color="#DD0000">$size</font><font color="#007700">[</font><font color="#DD0000">'mime'</font><font color="#007700">]}</font><font color="#DD0000">"</font><font color="#007700">);<br />&nbsp;&nbsp;</font><font color="#0000BB">fpassthru</font><font color="#007700">(</font><font color="#0000BB">$fp</font><font color="#007700">);<br />&nbsp;&nbsp;exit;<br />} else {<br />&nbsp;&nbsp;</font><font color="#FF8000">// error<br /></font><font color="#007700">}<br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
   </P
><P
>&#13;    O parâmetro opcional <CODE
CLASS="parameter"
>imageinfo</CODE
> permite a você extrair
    alguma informação extendida do arquivo de imagem.
    Atualmente, irá retornar os diferentes
    <ACRONYM
CLASS="acronym"
>JPG</ACRONYM
> APP markers como uma matriz associativa. Alguns programas
    usam estes APP markers para embutir textos com informações na imagem.
    Um uso muito comum é embutir informação <ACRONYM
CLASS="acronym"
>IPTC</ACRONYM
>
    <A
HREF="http://www.iptc.org/"
TARGET="_top"
>http://www.iptc.org/</A
> no
    APP13 marker. Você poderá usar a função <A
HREF="function.iptcparse.html"
><B
CLASS="function"
>iptcparse()</B
></A
>
    para interpretar o binário APP13 marker em algo
    legível.
   </P
><P
> 
    <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN82498"
></A
><P
><B
>Exemplo 4. getimagesize() retornando IPTC</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br />$size </font><font color="#007700">= </font><font color="#0000BB">getimagesize</font><font color="#007700">(</font><font color="#DD0000">"testimg.jpg"</font><font color="#007700">, </font><font color="#0000BB">$info</font><font color="#007700">);<br />if (isset(</font><font color="#0000BB">$info</font><font color="#007700">[</font><font color="#DD0000">"APP13"</font><font color="#007700">])) {<br />&nbsp;&nbsp;&nbsp;&nbsp;</font><font color="#0000BB">$iptc </font><font color="#007700">= </font><font color="#0000BB">iptcparse</font><font color="#007700">(</font><font color="#0000BB">$info</font><font color="#007700">[</font><font color="#DD0000">"APP13"</font><font color="#007700">]);<br />&nbsp;&nbsp;&nbsp;&nbsp;</font><font color="#0000BB">var_dump</font><font color="#007700">(</font><font color="#0000BB">$iptc</font><font color="#007700">);<br />}<br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
   </P
><P
>&#13;    Veja também <A
HREF="function.image-type-to-mime-type.html"
><B
CLASS="function"
>image_type_to_mime_type()</B
></A
>, 
    <A
HREF="function.exif-imagetype.html"
><B
CLASS="function"
>exif_imagetype()</B
></A
>, 
    <A
HREF="function.exif-read-data.html"
><B
CLASS="function"
>exif_read_data()</B
></A
> e 
    <A
HREF="function.exif-thumbnail.html"
><B
CLASS="function"
>exif_thumbnail()</B
></A
>. 
   </P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="function.gd-info.html"
ACCESSKEY="P"
>Anterior</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Principal</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="function.image-type-to-extension.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>gd_info</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ref.image.html"
ACCESSKEY="U"
>Acima</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>image_type_to_extension</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>

Perl :: Catalyst :: PostgreSQL :: RPM Valid HTML 4.01 Transitional