================================
GeneralObject (hwx.inspire.core)
================================

GeneralObject class provides the ability to extend the Inspire data model with
a custom entity.

This only enables the ability to create new named objects (like Joints, Forces, etc).
It does not provide the ability to create your own Parts or Assemblies.

----------
Attributes
----------

  +------------------+------------------+------------------+
  | active_: Bool    | name_: Attribute | visible_: Bool   |
  +------------------+------------------+------------------+

----------
Properties
----------

  +-------------------------+-------------------------+-------------------------+
  | inbrowser_              | movable_                | redrawWhenUnitsChanged_ |
  +-------------------------+-------------------------+-------------------------+

--------------
Public Methods
--------------

  +-----------------------+
  | getIcon_ (self)       |
  +-----------------------+
  | requireRedraw_ (self) |
  +-----------------------+

-----------------
Attribute Details
-----------------

.. _active:

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
active : :ref:`Bool <Bool (hwx.inspire)>`
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^


Returns or sets the object activeness.

Setting this on or off sets all children.
Setting to True sets all the parents active too.

.. _name:

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
name : :ref:`Attribute <Attribute (hwx.inspire)>`
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^


Returns or sets the name of the object.

It can be any text string, including spaces, although it's best to avoid
using the following characters: " ' * ? and $.

While these characters are allowed, they could create difficulties when
you export the model to other applications.

.. _visible:

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
visible : :ref:`Bool <Bool (hwx.inspire)>`
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^


Determines whether the object is visible in the graphics window.

Setting this on or off sets all children.
Setting to True sets all the parents visible too.


----------------
Property Details
----------------

.. _inbrowser:
.. property:: inbrowser

Show the object in the Model Browser.

.. _movable:
.. property:: movable

Specifies if the object can be moved using the move tool.

If yes then getting/setting the object.position must be implemented.

Can be True, False or a subset of "TX TY TZ RX RY RZ".

.. _redrawWhenUnitsChanged:
.. property:: redrawWhenUnitsChanged

Specifies whether the objects gets redrawn when gui units change.

--------------
Method Details
--------------

.. _getIcon:
.. method:: getIcon(self)

Specifies the icon used to display in Model Browser, Object Tables etc

.. _requireRedraw:
.. method:: requireRedraw(self)

Marks the object that needs to be redrawn in the graphics window.