comment -*- mode: text -*-
comment $Id: README.sb,v 1.8 2003/10/01 10:46:55 arakiken Exp $

mlterm¤Ç¤Ï¡¢¥ª¥ê¥¸¥Ê¥ë¤Î¥¹¥¯¥í¡¼¥ë¥Ð¡¼¤òÈæ³ÓŪ´Êñ¤Ë¼ÂÁõ¤¹¤ë¤¿¤á¤Î¥Õ¥ì¡¼¥à¥ï¡¼¥¯
¤òÄ󶡤·¤Æ¤¤¤Þ¤¹¡£

°Ê²¼¤Ç¤Ï¡¢¤½¤Î¼ÂÁõÊýË¡¤Ë¤Ä¤¤¤ÆÀâÌÀ¤·¤Þ¤¹¡£

* ¼ÂÁõÊýË¡¤Î³µÎ¬
  1. x_sb_view_t ¤Î³Æ¥¤¥Ù¥ó¥È¤´¤È¤ÎÉÁ²è½èÍý¤ò¼ÂÁõ¡£
  2. ¥³¥ó¥Ñ¥¤¥ë¡¢¶¦Í­¥é¥¤¥Ö¥é¥ê¤ÎºîÀ®
  3. ½êÄê¤Î¥Ç¥£¥ì¥¯¥È¥ê¤Ë¡¢¥é¥¤¥Ö¥é¥ê¤òÇÛÃÖ

* ɬÍפʴĶ­
  ²¼µ­¤Î¤¤¤º¤ì¤«¤¬»ÈÍѲÄǽ¤Ç¤¢¤ë¤³¤È¡£

  o UNIX98 dlopen ¥¤¥ó¥¿¡¼¥Õ¥§¡¼¥¹
  o HP-UX sh_load ¥¤¥ó¥¿¡¼¥Õ¥§¡¼¥¹
  o Win32API LoadLibrary
  o Mac OS X NSModule ¥¤¥ó¥¿¡¼¥Õ¥§¡¼¥¹ (EXPERIMENTAL)
  o libltdl ¥é¥¤¥Ö¥é¥ê

* x_sb_view_t
  ¸½ºßÄêµÁ¤µ¤ì¤Æ¤¤¤ë¥¤¥Ù¥ó¥È

  o void (*get_geometry_hints)( struct  x_sb_view * , unsigned int *  width , 
         unsigned int *  top_margin , unsigned int *  bottom_margin ,
         int *  up_button_y , unsigned int *  up_button_height ,
         int *  down_button_y , unsigned int *  down_button_height) ;
    ¥¹¥¯¥í¡¼¥ë¥Ð¡¼¤Î¥¸¥ª¥á¥È¥ê¾ðÊó¤òÅϤ¹¥¤¥Ù¥ó¥È
    ¥¹¥¯¥í¡¼¥ë¥Ð¡¼¤ÎÉý¡¢¤ª¤è¤Ó¡¢¿âľÊý¸þ¤Î¥Þ¡¼¥¸¥ó¡¢¤½¤·¤Æ¡¢¾å²¼¥¹¥¯¥í¡¼¥ë¥Ü¥¿¥ó
    ¤Î°ÌÃÖ¤òÅϤ·¤Þ¤¹¡£
    (ɬ¿Ü)

  o void (*get_default_color)( struct x_sb_view * , char **  fg_color ,
         char **  bg_color) ;
    ¥Ç¥Õ¥©¥ë¥È¤ÎÁ°·ÊÇØ·Ê¿§¤òÅϤ¹¥¤¥Ù¥ó¥È
    Á°·ÊÇØ·Ê¿§¤Ë»È¤¨¤ë̾Á°¤Ï¡¢{fg|bg}_color ÀßÄê¤Ç»È¤¨¤ë¤â¤Î¤ÈƱ¤¸¤Ç¤¹¡£
    ʸ»úÎó¤Ï¡¢¸Æ¤Ó½Ð¤·Â¦¤Ç¤Ï²òÊü¤·¤Þ¤»¤ó¤Î¤Ç¡¢ÆâÉô¤Ç½èÍý¤·¤Æ²¼¤µ¤¤¡£
    (¿ä¾©)
    
  o void (*realized)( struct  x_sb_view *  , Display * , int , Window , GC ,
         unsigned int  win_height) ;
    ¥¹¥¯¥í¡¼¥ë¥Ð¡¼¤¬¡¢²èÌ̤ËMAP¤µ¤ì¤ëľÁ°¤Ç¸Æ¤Ð¤ì¤ë¥¤¥Ù¥ó¥È
    ¥¹¥¯¥í¡¼¥ë¥Ð¡¼¥ª¥Ö¥¸¥§¥¯¥È¤ÎÆâÉô¾õÂ֤νé´ü²½¤·¤Þ¤¹¡£
    ¼õ¤±¼è¤Ã¤¿Display,screen,Window,GC¤ò¡¢x_sb_view_t ¤Î³Æ¥á¥ó¥Ð¤ËÀßÄꤹ¤ë¤Î¤ò˺
    ¤ì¤Ê¤¤¤Ç²¼¤µ¤¤¡£
    (ɬ¿Ü)
    
  o void (*resized)( struct  x_sb_view * , Window , unsigned int  height) ;
    ¥¹¥¯¥í¡¼¥ë¥Ð¡¼¤Î¹â¤µ¤¬Êѹ¹¤µ¤ì¤¿¾ì¹ç¤Ë¸Æ¤Ð¤ì¤ë¥¤¥Ù¥ó¥È
    ¥¹¥¯¥í¡¼¥ë¥Ð¡¼¥ª¥Ö¥¸¥§¥¯¥ÈÆâÉô¤Î¾õÂÖ¤òºÆÀßÄꤷ¤Þ¤¹¡£
    ¼õ¤±¼è¤Ã¤¿ Window ¤ò¡¢x_sb_view_t ¤Î¥á¥ó¥Ð¤ËÀßÄꤹ¤ë¤Î¤ò˺¤ì¤Ê¤¤¤Ç²¼¤µ¤¤¡£
    (ɬ¿Ü)
    
  o void (*delete)( struct  x_sb_view *) ;
    ¥¹¥¯¥í¡¼¥ë¥Ð¡¼¥ª¥Ö¥¸¥§¥¯¥È¤ÎÇ˲õ¥¤¥Ù¥ó¥È
    ÉÔÍפˤʤ俥ǡ¼¥¿¤ò²òÊü¤·¤Æ²¼¤µ¤¤¡£
    (ɬ¿Ü)

  o void (*draw_decoration)( struct  x_sb_view *) ;
    ¥¹¥¯¥í¡¼¥ë¥Ð¡¼¤Î¼þ¤ê¤ÎÁõ¾þ¤òÉÁ²è¤¹¤ë¥¤¥Ù¥ó¥È
    (¿ä¾©)
    
  o void (*draw_scrollbar)( struct  x_sb_view * , int  bar_top_y ,
         unsigned int  bar_height) ;
    ¥¹¥¯¥í¡¼¥ë¥Ð¡¼¤ÎÉÁ²è¥¤¥Ù¥ó¥È
    bar_top_y °ÌÃÖ(top_margin ¤È¤·¤ÆÅϤ·¤¿Ãͤϴޤޤì¤Þ¤¹)¤«¤é¡¢ bar_height ʬ¤Î
    ¹â¤µ¤Î¥Ð¡¼¤òÉÁ²è¤·¤Þ¤¹¡£
    (ɬ¿Ü)

  o void (*up_button_pressed)( struct  x_sb_view *) ;
  o void (*down_button_pressed)( struct  x_sb_view *) ;
  o void (*up_button_released)( struct  x_sb_view *) ;
  o void (*down_button_released)( struct  x_sb_view *) ;
    get_geometry_hints()¤Ç¿½ÀÁ¤·¤¿¡¢¾å¥¹¥¯¥í¡¼¥ë¥Ü¥¿¥ó¡¢²¼¥¹¥¯¥í¡¼¥ë¥Ü¥¿¥ó¤¬²¡¤µ
    ¤ì¤¿¾ì¹ç¤Ë¸Æ¤Ð¤ì¤ë¥¤¥Ù¥ó¥È¡£
    (¿ä¾©)
  
* ¼ÂÁõ¡¢¥³¥ó¥Ñ¥¤¥ë
  ¥³¥ó¥¹¥È¥é¥¯¥¿¤Ï¡¢É¬¤º¡¢

  x_sb_view_t *  x_[yourbar]_sb_view_new(void) ;  /* Ä̾ïÈÇ */
  x_sb_view_t *  x_[yourbar]_transparent_sb_view_new(void) ;  /* Æ©²á½èÍýÂбþÈÇ */

  ¤È¤·¤Æ¤¯¤À¤µ¤¤¡£

  Ä̾ï¤Î¥Ð¡¼¤È¡¢Æ©²á½èÍý¤ËÂбþ¤·¤¿¥¹¥¯¥í¡¼¥ë¥Ð¡¼¤ÎξÊý¤òÍÑ°Õ¤¹¤ë¤Î¤¬Ë¾¤Þ¤·¤¤¤Ç¤¹¡£
  (Æ©²á½èÍýÈǤ¬¤Ê¤¤¾ì¹ç¤Ï¡¢Æ©²á½èÍýÃæ¤Ç¤â¡¢Ä̾ïÈǤ¬»È¤ï¤ì¤Þ¤¹)

  Ê£¿ô¤Îpty¥¦¥£¥ó¥É¥¦¤òµ¯Æ°¤·¤Æ¤¤¤ë¾ì¹ç¤Ë¤Ï¡¢¥¹¥¯¥í¡¼¥ë¥Ð¡¼¥ª¥Ö¥¸¥§¥¯¥È¤âÊ£¿ôÀ¸
  À®¤µ¤ì¤ë¤³¤È¤Ë¤Ê¤ê¤Þ¤¹¤Î¤Ç¡¢Æȼ«¤Î¥Ç¡¼¥¿¹½Â¤¤òstatic¤Ë¤â¤Ã¤Æ¤¤¤ë¾ì¹ç¤Ë¤Ï¡¢¤½¤ì
  ¤é¤Î°·¤¤¤Ë¤Ï½½Ê¬Ãí°Õ¤·¤Æ²¼¤µ¤¤¡£

  x_sb_view_t ¤ò³ÈÄ¥¤·¡¢

  x_your_sb_view_t 
  {
	x_sb_view_t ;
	your own data ;
  } ;

  ¤òºî¤Ã¤Æ¡¢Æȼ«¥Ç¡¼¥¿¤ò¡¢¹½Â¤ÂΤΥá¥ó¥Ð¤Ë¤â¤Ä¤Î¤¬°ìÈֳμ¤Ǥ¹¡£

  ¥é¥¤¥Ö¥é¥ê̾¤Ë¤Ä¤¤¤Æ¤Ï¡¢É¬¤º¡¢

  lib[yourbar].so

  ¤È¤·¤Æ¤¯¤À¤µ¤¤¡£

  ¤Þ¤¿¡¢¥×¥ê¥×¥í¥»¥Ã¥µ¤¬¡¢x_sb_view.h ¤ò¸«¤Ä¤±¤é¤ì¤ë¤è¤¦¡¢x_sb_view.h¤Î¤¢¤ë¥Ñ¥¹
  ¤ò -I ¥ª¥×¥·¥ç¥ó¤Ë²Ã¤¨¤ë¤è¤¦¤Ë¤·¤Æ²¼¤µ¤¤¡£

* ÅÐÏ¿ºî¶È
  ¸½ºß¤Î¤È¤³¤í¡¢$(PREFIX)/lib/mlterm°Ê²¼¤Ë¡¢¤Ç¤­¤¢¤¬¤Ã¤¿¥é¥¤¥Ö¥é¥ê¤ò¥³¥Ô¡¼¤·¤Æ¤¯
  ¤À¤µ¤¤¡£

* ¼ÂºÝ¤Ë»È¤Ã¤Æ¤ß¤ë
  $ mlterm -S "your_sb"

  ¤Ç¡¢ºîÀ®¤µ¤ì¤¿¥¹¥¯¥í¡¼¥ë¥Ð¡¼¤¬É½¼¨¤µ¤ì¤ë¤Ï¤º¤Ç¤¹¡£
  ¤â¤·¡¢»ØÄꤷ¤¿Ì¾Á°¤Î¥¹¥¯¥í¡¼¥ë¥Ð¡¼¤¬Â¸ºß¤·¤Ê¤¤¾ì¹ç¤Ï¡¢"simple"(mltermËÜÂΤËÁÈ
  ¤ß¹þ¤ß)¤¬»È¤ï¤ì¤Þ¤¹¡£

* Êä­
  ºÙ¤«¤¤¼ê½ç¤Ê¤É¤Ë¤Ä¤¤¤Æ¤Ï¡¢xwindow/x_simple_sb_view.[ch],scrollbar/sample ¤ò»²
  ¾È²¼¤µ¤¤¡£