gls_rso_wrapper.h

Go to the documentation of this file.

/*! \file
  \brief  The disti::GlsRSOWrapper class.

  \par Copyright Information

  Copyright (c) 2015 by The DiSTI Corporation.<br>
  11301 Corporate Blvd; Suite 100<br>
  Orlando, Florida 32817<br>
  USA<br>
  <br>
  All rights reserved.<br>

  This Software contains proprietary trade secrets of DiSTI and may not be
reproduced, in whole or part, in any form, or by any means of electronic,
mechanical, or otherwise, without the written permission of DiSTI.  Said
permission may be derived through the purchase of applicable DiSTI product
licenses which detail the distribution rights of this content and any
Derivative Works based on this or other copyrighted DiSTI Software.

  NO WARRANTY. THE SOFTWARE IS PROVIDED "AS-IS," WITHOUT WARRANTY OF ANY KIND,
AND ANY USE OF THIS SOFTWARE PRODUCT IS AT YOUR OWN RISK. TO THE MAXIMUM EXTENT
PERMITTED BY APPLICABLE LAW, DISTI AND ITS SUPPLIERS DISCLAIM ALL WARRANTIES
AND CONDITIONS, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
IMPLIED WARRANTIES AND CONDITIONS OF MERCHANTABILITY AND/OR FITNESS FOR A
PARTICULAR PURPOSE, TITLE, AND NON-INFRINGEMENT, WITH REGARD TO THE SOFTWARE.

  LIMITATION OF LIABILITY. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW,
IN NO EVENT SHALL DISTI OR ITS SUPPLIERS BE LIABLE FOR ANY SPECIAL, INCIDENTAL,
INDIRECT, OR CONSEQUENTIAL DAMAGES WHATSOEVER (INCLUDING, WITHOUT LIMITATION,
DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS
INFORMATION, OR ANY OTHER PECUNIARY LOSS) ARISING OUT OF THE USE OF OR
INABILITY TO USE THE SOFTWARE, EVEN IF DISTI HAS BEEN ADVISED OF THE POSSIBILITY
OF SUCH DAMAGES.  DISTI'S ENTIRE LIABILITY AND YOUR EXCLUSIVE REMEDY SHALL NOT
EXCEED FIVE DOLLARS (US$5.00).

  The aforementioned terms and restrictions are governed by the laws of the
State of Florida and the United States of America.

*/
#ifndef _GLS_RSO_WRAPPER_H
#define _GLS_RSO_WRAPPER_H

#include "component_base.h"

#include "rso_interface_1.h"

namespace disti
{

//class RSOInterface1;
//class RSOInterface1::DisplayEvent;
class AttributeWrapperMap;
class EmittedEventHandlerImpl;
class MouseEvent;

/** The GlsRSOWrapper class wraps an RSOInterface1 object
    so that it can be inserted into the GL Studio heirarchy.
  */
class GlsRSOWrapper : public ComponentBase
{
public:
    typedef ComponentBase _BaseClass;

    /** Constructor
      * \param rso The RSO to wrap 
      * \param RSOVersion the highest RSOInterface the RSO supports (e.g. 1,2,3)
      */
    GLS_EXPORT GlsRSOWrapper(RSOInterface1* rso, unsigned int RSOVersion);

    /** Call CreateInstance() and Destroy() instead of new and delete 
      * in a mixed-library environment to ensure that matching 
      * new and delete operators are called. 
      * \param rso The RSO to wrap 
      * \param RSOVersion the highest RSOInterface the RSO supports (e.g. 1,2,3)
      */
    static GLS_EXPORT GlsRSOWrapper* CreateInstance(RSOInterface1* rso, unsigned int RSOVersion);
    
    /** Destructor
      * Don't call "delete yourComponent;", instead call "yourComponent->Destroy();" 
      * to ensure that the object is deleted correctly.
      */
    virtual GLS_EXPORT ~GlsRSOWrapper();

    /** Utility Method: Users should call Destroy() instead.
      * Safely delete an object that was created using CreateInstance.
      */
    virtual GLS_EXPORT void DeleteInstance();

    /** Replace the RSO that the GlsRSOWrapper is wrapping.
      * \param rso The new RSO to use
      * \param deleteCurrent Whether to delete the currently referenced rso. If false, then the caller is responsible for deleting it.
      */
    GLS_EXPORT void ChangeRSO(RSOInterface1* rso, bool deleteCurrent = true);

    /** Returns the current RSOInterface object
      */
    GLS_EXPORT RSOInterface1* RSOInterface();

    /** Handle an event that was emitted from the RSO.
      */
    GLS_EXPORT int HandleEmittedEvent(RSOInterface1::Event* ev);

    /** Returns the qualified instance name of the initiator of the last
      * event that was passed to HandleEmittedEvent or "" if no events 
      * have been passed to HandleEmittedEvent. */
    GLS_EXPORT const char* LastEmittedEventInitiatorName() const;


    // DisplayObject overrides

    virtual GLS_EXPORT void AlphaMode(int mode);
    virtual GLS_EXPORT int AlphaMode(void);
    virtual GLS_EXPORT void AntiAlias(bool alias);
    virtual GLS_EXPORT bool AntiAlias(void);
    virtual GLS_EXPORT void SetBlendColor(const glsColor& color);
    virtual GLS_EXPORT glsColor GetBlendColor();
    virtual GLS_EXPORT glsColor GetColor();
    virtual GLS_EXPORT void SetColor(const glsColor& color);
    virtual GLS_EXPORT void CullBackFace(const bool val);
    virtual GLS_EXPORT bool CullBackFace(void);
    virtual GLS_EXPORT int DepthTest(void);
    virtual GLS_EXPORT void DepthTest(int zbuf);
    virtual GLS_EXPORT bool LightingEnabled();
    virtual GLS_EXPORT void LightingEnabled(bool lighting);
    virtual GLS_EXPORT int LineStippleMultiplier(void);
    virtual GLS_EXPORT void LineStippleMultiplier(int mult);
    virtual GLS_EXPORT int LineStipplePattern(void);
    virtual GLS_EXPORT void LineStipplePattern(int pattern);
    virtual GLS_EXPORT float LineWidth(void);
    virtual GLS_EXPORT void LineWidth(float width);
    virtual GLS_EXPORT int MaterialIndex();
    virtual GLS_EXPORT void MaterialIndex(unsigned int index);
    virtual GLS_EXPORT int PolygonMode(void);
    virtual GLS_EXPORT void PolygonMode(int mode);
    virtual GLS_EXPORT int  PolygonEnd(void);
    virtual GLS_EXPORT void PolygonEnd(const int end);
    virtual GLS_EXPORT int PolygonOffset(void) const;
    virtual GLS_EXPORT void PolygonOffset(const int offset);
    virtual GLS_EXPORT int Shading(void);
    virtual GLS_EXPORT void Shading(const int shading);
    virtual GLS_EXPORT int TextureIndex(void);
    virtual GLS_EXPORT void TextureIndex(int textureIndex);
    virtual GLS_EXPORT bool TextureRepeat(void);
    virtual GLS_EXPORT void TextureRepeat(const int rep);
    virtual GLS_EXPORT int TextureMappingTechnique(void);
    virtual GLS_EXPORT void TextureMappingTechnique(const int map);
    virtual GLS_EXPORT int TextureMagnificationFilter(void);
    virtual GLS_EXPORT void TextureMagnificationFilter(const int filter);
    virtual GLS_EXPORT int TextureMinificationFilter(void);
    virtual GLS_EXPORT void TextureMinificationFilter(const int filter);

    virtual GLS_EXPORT void AbsolutePlacement(bool filter);


    virtual GLS_EXPORT void Calculate(double time);

    virtual GLS_EXPORT void CalculateBoundingBox(void);

    virtual GLS_EXPORT DisplayObject *CloneObject(bool generateNames = false);

    virtual GLS_EXPORT void CopyGeometry(DisplayObject *src);

    virtual GLS_EXPORT void CopyProperties(DisplayObject *src);

#ifndef GLES
    virtual GLS_EXPORT InterfaceListType* GetCppInterfaceDescription(InterfaceListType* addToThisList= NULL );

    virtual GLS_EXPORT void GetCppInterfaceDescriptionFree(InterfaceListType* array);
#endif
    virtual GLS_EXPORT void CreateObjects();

    virtual GLS_EXPORT void Draw();

    virtual GLS_EXPORT void GetExtents(float &x,float &y,float &z,float &x1,float &y1,float &z1);

    virtual GLS_EXPORT void GetTransformedExtents(Vector& min, Vector& max, const GlsMatrixType& matrix, bool resetMinMax = true);

    virtual GLS_EXPORT DisplayObject* handle(DisplayEvent *ev);

    virtual GLS_EXPORT DisplayObject *HandleInput(DisplayEvent *ev);

    virtual GLS_EXPORT void Init();

    virtual GLS_EXPORT void Initialize();

    virtual GLS_EXPORT DisplayObject *Pick3D(const Vector& winLoc, 
                                             const Vector& logicalCoords,
                                             float scale, 
                                             const Vector& directionVector, 
                                             Vector& collisionWinLoc /*Returned*/, 
                                             const OpenGLMatrices& drawnMatrices);

    virtual GLS_EXPORT void PreDraw(const OpenGLMatrices& current,Culler& culler);

    virtual GLS_EXPORT void GetResources(std::ostream& outstr, GlsResourceFilter* filter= NULL);

    virtual GLS_EXPORT DistiAttributeBase& Resource(const char *name);

    /* Unhides base class implementation. */
    using ComponentBase::Scale;
    using ComponentBase::Rotate;

    virtual void GLS_EXPORT UpdateBoundingVolume(void);

    /** Called on initial creation to set variables */
    GLS_EXPORT void SetValue(int spec,va_list &args);

protected:
    /** enum that guides the state machine for multitouch handling for RSO's that don't support multitouch.  
      * An RSO starts in the READY_FOR_INPUT state.  When it handles a mouse drag event, it moves to PROCESSING_MOUSE_DRAG
      * state.  It will ignore any other mouse events if they are not for the original cursor_id.  Then, once the RSO either receives the 
      * MOUSE_UP event or stops handling the MOUSE_DRAG events, the RSO then transitions to WAITING_FOR_MOUSE_DOWN (i.e. it keeps ignoring other cursors
      * that might have been dragging on it while it was processing its original cursor event).  Once it receives a new mouse down, it transitions back to READY_FOR_INPUT
      */
    enum MultitouchState 
    {
        READY_FOR_INPUT,
        PROCESSING_MOUSE_DRAG,
        WAITING_FOR_MOUSE_DOWN
    };

    RSOInterface1* _rsoInterface;
    AttributeWrapperMap* _attributeWrapperMap;
    EmittedEventHandlerImpl* _rsoEmittedEventHandler;
    char* _lastEmittedEventInitiatorName;
    MultitouchState  _multitouchState;
    unsigned int _currentCursor;
    unsigned int _rsoVersion;

    GLS_EXPORT void LastEmittedEventInitiatorName(const char* name);
    
    /** this function should be called to handle mouse events if the RSO handles multitouch (RSO version 3 or greater) 
      */
    virtual GLS_EXPORT DisplayObject *HandleMultiTouchInput(MouseEvent *mev);
};

} // namespace disti

#endif