cgal/Polyhedron/doc_tex/Polyhedron_ref/Polyhedron_operator_rightsh...

65 lines
2.3 KiB
TeX

% +------------------------------------------------------------------------+
% | Reference manual page: Polyhedron_operator_rightshift.tex
% +------------------------------------------------------------------------+
% | 09.09.2000 Lutz Kettner
% | Package: Polyhedron
% |
\RCSdef{\RCSPolyhedronoperatorostreamRev}{$Id$}
\RCSdefDate{\RCSPolyhedronoperatorostreamDate}{$Date$}
% |
%%RefPage: end of header, begin of main body
% +------------------------------------------------------------------------+
\ccHtmlNoClassLinks
\begin{ccRefFunction}{operator>>}
\label{refPolyhedron_operator_rightshift}
\ccDefinition
This operator reads a polyhedral surface in Object File Format, OFF,
with file extension {\tt .off}, which is also understood by
Geomview~\cite{cgal:p-gmgv16-96}, from the input stream \ccc{in} and
appends it to the polyhedral surface $P$. Only the point coordinates
and facets from the input stream are used to build the polyhedral
surface. Neither normal vectors nor color attributes are evaluated. If
the stream \ccc{in} does not contain a permissible polyhedral surface
the \ccc{ios::badbit} of the input stream \ccc{in} is set and $P$ remains
unchanged.
For OFF an ASCII and a binary format exist. The stream detects the
format automatically and can read both.
\ccInclude{CGAL/IO/Polyhedron_iostream.h}
\ccGlobalFunction{template <class PolyhedronTraits_3>
istream& operator>>( istream& in,
CGAL::Polyhedron_3<PolyhedronTraits_3>& P);}
\ccSeeAlso
\ccRefIdfierPage{CGAL::Polyhedron_3<Traits>}\\
\ccRefIdfierPage{CGAL::Polyhedron_incremental_builder_3<HDS>}\\
\lcTex{\ccc{operator<<} \dotfill\
page~\pageref{refPolyhedron_operator_leftshift}}%
\lcRawHtml{
<I><A HREF="Function_operator.html">operator&lt;&lt;</A></I>.
}
\ccImplementation
This operator is implemented using the modifier mechanism for
polyhedral surfaces and the \ccc{CGAL::Polyhedron_incremental_builder_3}
class, which allows the construction in a single, efficient scan pass
of the input and handles also all the possible flexibility of the
polyhedral surface.
\end{ccRefFunction}
% +------------------------------------------------------------------------+
%%RefPage: end of main body, begin of footer
% EOF
% +------------------------------------------------------------------------+