icetBoundingVertices(3)

✨ NAME ✨

icetBoundingVertices β€” set bounds of geometry. periodt. πŸ’…

okay so you're reading icetBoundingVertices(3), bestie, straight outta the IceT Reference manual, and it's giving β€œtell IceT where your geometry lives” energy. πŸ¦‹


πŸ¦‹ Synopsis πŸ¦‹

#include <IceT.h>

void icetBoundingVertices(   IceTInt            size,
                             IceTEnum           type,
                             IceTSizeType       stride,
                             IceTSizeType       count,
                             const IceTVoid *   pointer  );

🌸 Description 🌸

okay so icetBoundingVertices is literally how you tell IceT what the bounds are for the geometry drawn by the callback you registered with icetDrawCallback or icetGLDrawCallback. The bounds are assumed to be the convex hull of the vertices you give it. And bestie, you gotta make sure the drawn geometry actually fits inside that convex hull, because if it doesn't, the data may be culled in unexpected ways 😭. IceT runs most efficiently when the bounds you give are tight (like, they match the actual volume of the data well) and when the number of vertices you give is minimal. lowkey iconic efficiency behavior. ✨

Here's the parameter tea, fr fr:

  • size β€” specifies the number of coordinates given for each vertex. Coordinates are given in X-Y-Z-W order. Any Y or Z coordinate not given (because size is less than 3) is assumed to be 0.0, and any W coordinate not given (because size is less than 4) is assumed to be 1.0.
  • type β€” specifies in what data type the coordinates are given. Valid types are ICET_SHORT, ICET_INT, ICET_FLOAT, and ICET_DOUBLE, which correspond to types IceTShort, IceTInt, IceTFloat, and IceTDouble, respectively.
  • stride β€” specifies the offset between consecutive vertices in bytes. If stride is 0, the array is assumed to be tightly packed.
  • count β€” specifies the number of vertices to set.
  • pointer β€” is an array of vertices with the first vertex starting at the first byte.

If data replication is being used, each process in a data replication group should register the same bounding vertices that encompass the entire geometry. By default there is no data replication, so unless you call icetDataReplicationGroup, all process can have their own bounds. no cap. πŸ’–


πŸ’€ Errors πŸ’€

  • ICET_INVALID_ENUM β€” raised if type is not one of ICET_SHORT, ICET_INT, ICET_FLOAT, or ICET_DOUBLE. so don't do that, bestie. πŸ’…

πŸ™ˆ Warnings πŸ™ˆ

None. like, zero. nada. 🫢


πŸ› Bugs πŸ›

None known. we love a bug-free era. πŸ‘‘


Copyright (C)2003 Sandia Corporation

Under the terms of Contract DE-AC04-94AL85000 with Sandia Corporation, the U.S. Government retains certain rights in this software.

This source code is released under the New BSD License.


πŸ”₯ See Also πŸ”₯


that's the whole page, bestie. source/version: IceT Reference Β· date: September 20, 2010 Β· page: icetBoundingVertices(3) πŸ’–βœ¨ stay slay. πŸ’