Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Create initial wrappers translations #308

Merged
merged 15 commits into from
Jul 28, 2023
Merged

Create initial wrappers translations #308

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
15 commits
Select commit Hold shift + click to select a range
3dbb84e
Update ArrayAccess implementation example
AdaiasMagdiel Jul 27, 2023
ce4bfc5
Merge branch 'master' into master
alfsb Jul 27, 2023
cc398ed
Create Predefined Attributes translations
AdaiasMagdiel Jul 27, 2023
9012a42
Create Attribute construct class translation
AdaiasMagdiel Jul 27, 2023
00b3c76
Create Attribute class translation
AdaiasMagdiel Jul 27, 2023
ad0c57e
Create ReturnTypeWillChange class translation
AdaiasMagdiel Jul 27, 2023
2652dd0
Merge branch 'master' of github.com:AdaiasMagdiel/doc-pt_br
AdaiasMagdiel Jul 27, 2023
a01dee9
Change revision status: rev -> ready
AdaiasMagdiel Jul 28, 2023
0c4b667
Merge branch 'master' of https://github.com/php/doc-pt_br
AdaiasMagdiel Jul 28, 2023
dc880e1
Create AllowDynamicProperties class translation
AdaiasMagdiel Jul 28, 2023
91d5f18
Create SensitiveParameter class translation
AdaiasMagdiel Jul 28, 2023
dafaa3a
Merge branch 'master' of https://github.com/php/doc-pt_br
AdaiasMagdiel Jul 28, 2023
19111be
Merge branch 'master' of https://github.com/php/doc-pt_br
AdaiasMagdiel Jul 28, 2023
6c1a4a8
Create wrappers/audio translation
AdaiasMagdiel Jul 28, 2023
f0fe37b
Create wrappers/compression translation
AdaiasMagdiel Jul 28, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
196 changes: 196 additions & 0 deletions language/wrappers/audio.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,196 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: af6fdf16ab44bcf4d045407963e43c3d9dd2ff29 Maintainer: adaiasmagdiel Status: ready --><!-- CREDITS: adaiasmagdiel -->

<refentry xml:id="wrappers.audio" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" role="noversion">
<refnamediv>
<refname>ogg://</refname>
<refpurpose>Streams de áudio</refpurpose>
</refnamediv>

<refsect1 role="description"><!-- {{{ -->
&reftitle.description;
<para>
Os arquivos abertos para leitura por meio do wrapper <filename>ogg://</filename>
são tratados como áudio compactado codificado usando o codec <literal>OGG/Vorbis</literal>.
Da mesma forma, os arquivos abertos para gravação ou adição por meio do
wrapper <filename>ogg://</filename> são gravados como dados de áudio compactados.
<function>stream_get_meta_data</function>, quando usado em um arquivo OGG/Vorbis
aberto para leitura, retornará vários detalhes sobre o stream,
incluido a tag <parameter>vendor</parameter>, quaisquer
<parameter>comentários</parameter> incluídos, o número de
<parameter>canais</parameter>, a taxa de <parameter>sampling</parameter>,
e o intervalo da taxa de codificação descrito por:
<parameter>bitrate_lower</parameter>, <parameter>bitrate_upper</parameter>,
<parameter>bitrate_nominal</parameter>, e <parameter>bitrate_window</parameter>.
</para>

<simpara><filename>ogg://</filename> (PECL)</simpara>
<note>
<title>Este wrapper não é habilitado por padrão</title>
<simpara>
Para poder utilizar o wrapper <filename>ogg://</filename> é preciso instalar
a extensão <link xlink:href="&url.pecl.package;oggvorbis">OGG/Vorbis</link>
disponível em <link xlink:href="&url.pecl;">PECL</link>.
</simpara>
</note>
</refsect1><!-- }}} -->

<refsect1 role="usage"> <!-- {{{ -->
&reftitle.usage;
<itemizedlist>
<listitem><simpara><filename>ogg://soundfile.ogg</filename></simpara></listitem>
<listitem><simpara><filename>ogg:///path/to/soundfile.ogg</filename></simpara></listitem>
<listitem><simpara><filename>ogg://http://www.example.com/path/to/soundstream.ogg</filename></simpara></listitem>
</itemizedlist>
</refsect1> <!-- }}} -->

<refsect1 role="options"><!-- {{{ -->
&reftitle.options;
<para>
<table>
<title>Resumo do Wrapper</title>
<tgroup cols="2">
<thead>
<row>
<entry>Atributo</entry>
<entry>Suportado</entry>
</row>
</thead>
<tbody>
<row>
<entry>Restringido por <link linkend="ini.allow-url-fopen">allow_url_fopen</link></entry>
<entry>Não</entry>
</row>
<row>
<entry>Permite Leitura</entry>
<entry>Sim</entry>
</row>
<row>
<entry>Permite Escrita</entry>
<entry>Sim</entry>
</row>
<row>
<entry>Permite Adição</entry>
<entry>Sim</entry>
</row>
<row>
<entry>Permite Leitura e Escrita Simultâneas</entry>
<entry>Não</entry>
</row>
<row>
<entry>Suporta <function>stat</function></entry>
<entry>Não</entry>
</row>
<row>
<entry>Suporta <function>unlink</function></entry>
<entry>Não</entry>
</row>
<row>
<entry>Suporta <function>rename</function></entry>
<entry>Não</entry>
</row>
<row>
<entry>Suporta <function>mkdir</function></entry>
<entry>Não</entry>
</row>
<row>
<entry>Suporta <function>rmdir</function></entry>
<entry>Não</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<!-- FIXME: This should not be here! context.audio... -->
<para>
<table>
<title>Opções de contexto</title>
<tgroup cols="3">
<thead>
<row>
<entry>Nome</entry>
<entry>Uso</entry>
<entry>Padrão</entry>
<entry>Modo</entry>
</row>
</thead>
<tbody>
<row>
<entry><literal>pcm_mode</literal></entry>
<entry>
Codificação PCM a ser aplicada durante a leitura, uma das seguintes:
<constant>OGGVORBIS_PCM_U8</constant>, <constant>OGGVORBIS_PCM_S8</constant>,
<constant>OGGVORBIS_PCM_U16_BE</constant>, <constant>OGGVORBIS_PCM_S16_BE</constant>,
<constant>OGGVORBIS_PCM_U16_LE</constant>, e <constant>OGGVORBIS_PCM_S16_LE</constant>.
(8 vs 16 bit, signed ou unsigned, big ou little <literal>endian</literal>)
</entry>
<entry>OGGVORBIS_PCM_S16_LE</entry>
<entry>Leitura</entry>
</row>
<row>
<entry><literal>rate</literal></entry>
<entry>
Taxa de amostragem de dados de entrada, expressa em Hz
</entry>
<entry>44100</entry>
<entry>Escrita/Adição</entry>
</row>
<row>
<entry><literal>bitrate</literal></entry>
<entry>
Quando fornecido como um número inteiro, refere-se à taxa de bits fixa na qual codificar. (16000 to 131072)
Quando fornecido como um float, refere-se à qualidade da taxa de bits variável a ser utilizada. (-1.0 to 1.0)
</entry>
<entry>128000</entry>
<entry>Escrita/Adição</entry>
</row>
<row>
<entry><literal>channels</literal></entry>
<entry>
O número de canais de áudio a serem codificados, geralmente 1 (mono) ou 2 (estéreo).
Pode variar até 16.
</entry>
<entry>2</entry>
<entry>Escrita/Adição</entry>
</row>
<row>
<entry><literal>comments</literal></entry>
<entry>
"Um array de strings para codificar no cabeçalho da faixa."
</entry>
<entry/>
<entry>Escrita/Adição</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</refsect1> <!-- }}} -->

<refsect1 role="examples"><!-- {{{ -->
&reftitle.examples;
</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
-->

142 changes: 142 additions & 0 deletions language/wrappers/compression.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,142 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 68d6bce01964dd9c1792027efadabcb9968a42fe Maintainer: adaiasmagdiel Status: ready --><!-- CREDITS: adaiasmagdiel -->

<refentry xml:id="wrappers.compression" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" role="noversion">
<refnamediv>
<refname>zlib://</refname>
<refname>bzip2://</refname>
<refname>zip://</refname>
<refpurpose>Streams de compactação</refpurpose>
</refnamediv>

<refsect1 role="description"><!-- {{{ -->
&reftitle.description;
<simpara><filename>compress.zlib://</filename> e <filename>compress.bzip2://</filename></simpara>

<simpara>
<filename>zlib:</filename> funciona como <function>gzopen</function>, exceto que
o stream pode ser usado com <function>fread</function> e outras
funções do sistema de arquivos. Isso é obsoleto devido
a ambiguidades com nomes de arquivos contendo caracteres ':'; use
<filename>compress.zlib://</filename> em vez disso.
</simpara>

<simpara>
<filename>compress.zlib://</filename> e
<filename>compress.bzip2://</filename> são equivalentes para
<function>gzopen</function> e <function>bzopen</function>
respectivamente, e funcionam mesmo em sistemas que não suportam
fopencookie.
</simpara>

<simpara>
A <link linkend="book.zip">extensão ZIP</link> registra o wrapper <filename>zip:</filename>. a partir do
PHP 7.2.0 e libzip 1.2.0+, foi adicionado suporte para as senhas para arquivos criptografados, permitindo
que as senhas sejam fornecidas por stream contexts. As senhas podem ser definidas usando <literal>'password'</literal>,
uma opção de contexto de streams.
</simpara>
</refsect1><!-- }}} -->

<refsect1 role="usage"> <!-- {{{ -->
&reftitle.usage;
<itemizedlist>
<listitem><simpara><filename>compress.zlib://file.gz</filename></simpara></listitem>
<listitem><simpara><filename>compress.bzip2://file.bz2</filename></simpara></listitem>
<listitem><simpara><filename>zip://archive.zip#dir/file.txt</filename></simpara></listitem>
</itemizedlist>
</refsect1> <!-- }}} -->

<refsect1 role="options"><!-- {{{ -->
&reftitle.options;
<para>
<table>
<title>Resumo do Wrapper</title>
<tgroup cols="2">
<thead>
<row>
<entry>Atributo</entry>
<entry>Suportado</entry>
</row>
</thead>
<tbody>
<row>
<entry>Restringido por <link linkend="ini.allow-url-fopen">allow_url_fopen</link></entry>
<entry>Não</entry>
</row>
<row>
<entry>Permite Leitura</entry>
<entry>Sim</entry>
</row>
<row>
<entry>Permite Escrita</entry>
<entry>Sim (exceto <literal>zip://</literal>)</entry>
</row>
<row>
<entry>Permite Adição</entry>
<entry>Sim (exceto <literal>zip://</literal>)</entry>
</row>
<row>
<entry>Permite Leitura e Escrita Simultâneas</entry>
<entry>Não</entry>
</row>
<row>
<entry>Suporta <function>stat</function></entry>
<entry>
Não, use o wrapper <literal>file://</literal>
para verificar o stat de arquivos compactados.
</entry>
</row>
<row>
<entry>Suporta <function>unlink</function></entry>
<entry>
Não, use o wrapper <literal>file://</literal>
para excluir arquivos compactados.
</entry>
</row>
<row>
<entry>Suporta <function>rename</function></entry>
<entry>Não</entry>
</row>
<row>
<entry>Suporta <function>mkdir</function></entry>
<entry>Não</entry>
</row>
<row>
<entry>Suporta <function>rmdir</function></entry>
<entry>Não</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</refsect1> <!-- }}} -->

<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><xref linkend="context.zlib" /></member>
</simplelist>
</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
-->