const bool colorize=false);
/**
- * A parallelogram. The first
- * corner point is the
- * origin. The <tt>dim</tt>
- * adjacent points are the
- * one-dimensional subtensors of
- * the tensor provided and
- * additional points will be sums
- * of these two vectors.
- * Colorizing is done according
- * to hyper_rectangle().
+ * A parallelogram. The first corner point is the origin. The <tt>dim</tt>
+ * adjacent points are the ones given in the second argument and the fourth
+ * point will be the sum of these two vectors. Colorizing is done in the
+ * same way as in hyper_rectangle().
*
- * @note This function is
- * implemented in 2d only.
+ * @note This function is implemented in 2d only.
*
- * @note The triangulation needs to be
- * void upon calling this
- * function.
+ * @note The triangulation needs to be void upon calling this function.
*/
template <int dim>
- static void
- parallelogram(Triangulation<dim> &tria,
- const Tensor<2,dim> &corners,
- const bool colorize=false);
+ static
+ void
+ parallelogram(Triangulation<dim> &tria,
+ const Point<dim> (&corners)[dim],
+ const bool colorize=false);
-
+ /**
+ * @deprecated Use the other function of same name.
+ */
+ template <int dim>
+ static
+ void
+ parallelogram(Triangulation<dim> &tria,
+ const Tensor<2,dim> &corners,
+ const bool colorize=false) DEAL_II_DEPRECATED;
+
+ /**
+ * A parallelepiped. The first corner point is the origin. The
+ * <tt>dim</tt> adjacent points are vectors describing the edges of
+ * the parallelepiped with respect to the origin. Additional points
+ * are sums of these dim vectors. Colorizing is done according to
+ * hyper_rectangle().
+ *
+ * @note This function silently reorders the vertices on the cells
+ * to lexiographic ordering (see
+ * <code>GridReordering::reorder_grid</code>). In other words, if
+ * reodering of the vertices does occur, the ordering of vertices in
+ * the array of <code>corners</code> will no longer refer to the
+ * same triangulation.
+ *
+ * @note The triangulation needs to be void upon calling this
+ * function.
+ */
+ template <int dim>
+ static
+ void
+ parallelepiped (Triangulation<dim> &tria,
+ const Point<dim> (&corners) [dim],
+ const bool colorize = false);
+
/**
* Hypercube with a layer of