/*
    Crystal Space Entity Layer
    Copyright (C) 2003 by Jorrit Tyberghein
  
    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Library General Public
    License as published by the Free Software Foundation; either
    version 2 of the License, or (at your option) any later version.
  
    This library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    Library General Public License for more details.
  
    You should have received a copy of the GNU Library General Public
    License along with this library; if not, write to the Free
    Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
*/

#ifndef __CEL_PF_BILLBOARD__
#define __CEL_PF_BILLBOARD__

#include "cstypes.h"
#include "csutil/scf.h"

struct iBillboard;

/**
 * Billboard property class.
 * <p>
 * This property class can send out the following messages
 * to the behaviour (add prefix 'cel.parameter.' to get the ID for parameters):
 * <ul>
 * <li>pcbillboard_select: billboard is selected (x,y,button)
 * <li>pcbillboard_move: billboard is moved (x,y,button)
 * <li>pcbillboard_unselect: billboard is unselected (x,y,button)
 * <li>pcbillboard_doubleclick: billboard is double clicked (x,y,button)
 * </ul>
 * <p>
 * This property class supports the following properties (add prefix
 * 'cel.property.' to get the ID of the property:
 * <ul>
 * <li>name (string, read/write): name of the billboard.
 * <li>materialname (string, read/write): name of the material.
 * <li>materialnamefast (string, read/write): name of the material (faster
 *     way to set).
 * <li>clickable (bool, read/write): clickable yes or no.
 * <li>movable (bool, read/write): movable yes or no.
 * <li>visible (bool, read/write): visible yes or no.
 * <li>restack (bool, read/write): restackable on selection yes or no.
 * <li>color (color, read/write): color of this billboard.
 * <li>width (long, read/write): width of this billboard.
 * <li>height (long, read/write): height of this billboard.
 * <li>widthpct (float, read/write): width of this billboard in percentage.
 * <li>heightpct (float, read/write): height of this billboard in percentage.
 * <li>x (long, read/write): x position of this billboard.
 * <li>y (long, read/write): y position of this billboard.
 * <li>uv_topleft (vector2, read/write): topleft uv coordinate in material.
 * <li>uv_botright (vector2, read/write): botright uv coordinate in material.
 * <li>layer (string, read/write): layer name.
 * <li>text (string, read/write): optional text on billboard.
 * <li>text_offset (vector2, write): offset for text in billboard space.
 * <li>text_fg_color (color, write): foreground color.
 * <li>text_bg_color (color, write): background color.
 * <li>text_font_size (float, write): font size. Set this before setting
 *     text_font. Otherwise default is 10.
 * <li>text_font (string, write): font.
 * <li>text_default_fg_color (color, write): default foreground color (for
 *     all billboards).
 * <li>text_default_bg_color (color, write): default background color (for
 *     all billboards).
 * <li>text_default_font_size (float, write): font size. Set this before
 *     setting text_default_font. Otherwise default is 10.
 * <li>text_default_font (string, write): default font (for
 *     all billboards).
 * </ul>
 */
struct iPcBillboard : public virtual iBase
{
  SCF_INTERFACE (iPcBillboard, 0, 0, 1);

  /**
   * Set the name of the billboard.
   */
  virtual void SetBillboardName (const char* name) = 0;

  /**
   * Get the name of the billboard.
   */
  virtual const char* GetBillboardName () = 0;

  /**
   * Get the billboard.
   */
  virtual iBillboard* GetBillboard () = 0;

  /**
   * Enable or disable listening for events for this billboard.
   */
  virtual void EnableEvents (bool e) = 0;

  /**
   * Return true if events are enabled.
   */
  virtual bool AreEventsEnabled () const = 0;
};

#endif // __CEL_PF_BILLBOARD__

