u3d.hpp

/* ==================================================== ======== ======= *
 *
 *  u3d.hpp : Ubit3D: tridimensional Box containers.
 *  Author: Matthieu Nottale
 *  Part of the Ubit Toolkit: A Brick Construction Game Model for Creating GUIs
 *  (C) 1999-2006 / Eric Lecolinet / ENST Paris / http://www.enst.fr/~elc/ubit
 *
 * ***********************************************************************
 * COPYRIGHT NOTICE : 
 * THIS PROGRAM IS DISTRIBUTED WITHOUT ANY WARRANTY AND WITHOUT EVEN THE 
 * IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. 
 * YOU CAN REDISTRIBUTE IT AND/OR MODIFY IT UNDER THE TERMS OF THE GNU 
 * GENERAL PUBLIC LICENSE AS PUBLISHED BY THE FREE SOFTWARE FOUNDATION; 
 * EITHER VERSION 2 OF THE LICENSE, OR (AT YOUR OPTION) ANY LATER VERSION.
 * SEE FILES 'COPYRIGHT' AND 'COPYING' FOR MORE DETAILS.
 * ***********************************************************************
 * ==================================================== [(c)Elc] ======= *
 * ==================================================== ======== ======= */

#ifndef _u3d_hpp_
#define _u3d_hpp_
//pragma ident  "@(#)u3d.hpp    ubit:05.05.00"

#include <ubit/uprop.hpp>
#include <ubit/ubox.hpp>
#include <ubit/uctlmenu.hpp>
#include <ubit/uevent.hpp>
namespace ubit {

/* ==================================================== ==== ======= */
  
class UFrame3d: public UFrame {
public:
  UBIT_ELEMENT_CLASS(UFrame3d, UFrame)
  
  UFrame3d(const UArgs& a = UArgs::none);
  friend UFrame3d& uframe3d(const UArgs& a = UArgs::none);
    
  static UStyle* createStyle();
};
  
/* ==================================================== ==== ======= */
/* 3-Dimensional view, able to display UBox as planes in a 3D space.
* The displayed view is a 60° wide perspective.
* The position of the components is controlled with UPos3d properties.
*
* Event handling and drawing:
* The mouse coordinates are transformed by the UView3d when passed to 
* its children, so that the transformation  is transparent for them.
* Similarly, when a child component is repainted, the drawing occurr
* in it's local coordinate system.
*
* Position and movement:
* The view itself can't be changed, but the position and orientation 
* of it's child components is controlled by an UPos3d property.
* Aditionnaly, a control menu can be associated with a UBox and a UPos3d
* with the funciton UPos3dctlmenu.
*/
class UPos3d : public UPos {
public:
  UPos3d();
  UPos3d(float x, float y, float z);
  UPos3d(float x, float y, float z, float theta, float phi, float alpha);

  friend UPos3d& upos3d(float x, float y, float z);
  friend UPos3d& upos3d(float x, float y, float z,
                        float theta, float phi, float alpha);
  
  UPos3d& setSticky(bool sticky);

  //void set(const UPos& p)         {setImpl(p.x, p.y, true);}
  //void set(float _x, float _y)    {setImpl(_x, _y,true);}
  //void setX(float _x)             {setImpl(_x, y,true);}
  //void setY(float _y)             {setImpl(x, _y,true);}
  
  UPos3d& setXY(float _x, float _y) {setImpl(_x,_y,z, true); return *this;}
  UPos3d& setXYZ(float _x, float _y, float _z) {setImpl(_x,_y,_z,true); return *this;}

  UPos3d& setNormal(//float x, float y, float z,
                    float normal_x, float normal_y, float normal_z,
                    float alpha, bool update = true);

  UPos3d& setAngles(//float x, float y, float z,
                    float theta, float phi,
                    float alpha, bool update = true);

  UPos3d& rotate(float dtheta, float dphi, float dalpha);
  UPos3d& translate(float dx, float dy, float dz);

  // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  
  virtual void setImpl(float _x, float _y, bool upd);
  virtual void setImpl(float _x, float _y, float _z, bool upd);
  virtual void update();
  
private:
  friend class UView;
  friend class UFrameView3d;
  float z;
  float normal_x, normal_y, normal_z;
  float angle_alpha, angle_theta, angle_phi;
  float theta, phi, alpha;
  bool sticky;
  virtual void putProp(UContext*, UControl*);
};

/* ==================================================== ==== ======= */
class UCtlmenu3d : public UCtlmenu {
public:
  UCtlmenu3d(UPos3d&);
};

}
#endif
/* ==================================================== [TheEnd] ======= */
/* ==================================================== ======== ======= */

---