Util (lx-util.hpp)

From The Foundry MODO SDK wiki
Revision as of 22:14, 28 November 2012 by Shf (Talk | contribs)

Jump to: navigation, search

Utility classes used by wrappers.

CLxObject

This is just a class with a virtual destructor. Anything inheriting from this has the ability to be destroyed anywhere, and that's a powerfully important concept in C++.

CLxRefCounted

This is a CLxObject class which is reference-counted using explicit acquire() and release() methods.

CLxHolder

This template class creates a container for any CLxRefCounted type. The reference counting is managed implicitly using set() on the holder, and the internal object's members can be accessed with ->.

CLxList

Simple template list class using the next and prev pointers in the templated type.

CLxObjectList

Extension of CLxList that manages a list of allocated CLxObject types.

CLxArray

Simple template class for an allocated array of types. Like std::vector but much simpler.

Object Management

The three things you can do with COM objects without knowing anything about them are QueryInterface, AddRef, and Release. These functions handle different data types.

  • lx::IfcQuery(), lx::IfcAddRef(), lx::IfcRelease() -- for an ILxInterfaceID pointer
  • lx::ObjQuery(), lx::ObjAddRef(), lx::ObjRelease() -- for an LXtObjectID
  • lx::UnkQuery(), lx::UnkAddRef(), lx::UnkRelease() -- for an ILxUnknownID pointer

Globals

Globals come from querying the global object, which can be done through:

  • lx::GetGlobal() -- this can take a GUID pointer or a GUID string

GUID Services

If you really need to deal in GUIDs, there are some functions for that:

  • lx::LookupGUID() -- returns a GUID pointer from a string
  • lx::GUIDCompare() -- compares two GUIDs