home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 3 / AACD03.BIN / AACD / Programming / ImageLib / Image_lib / Image.doc < prev    next >
Encoding:
Text File  |  1999-06-01  |  8.9 KB  |  322 lines
  1. TABLE OF CONTENTS
  2. image.library/DrawBitMap
  3. image.library/ChunkyToBitMapA
  4. image.library/FreeChunky
  5. image.library/DrawTextA
  6. image.library/Draw3DBoxA
  7. image.library/ScaleBitMapA
  8. image.library/ChunkyToHAMA
  9. image.library/DrawBitMap                                     image.library/DrawBitMap
  10.  
  11.    NAME
  12.   DrawBitMap -- Narysuj bitmapë w okreôlonym rastporcie.  (V39)
  13.  
  14.    SYNOPSIS
  15.   DrawBitMap( bitmap, xpos, ypos, width, height, rastport )
  16.               A0      D1    D2    D3     D4      A1
  17.  
  18.   VOID DrawBitMap( struct BitMap *, ULONG, ULONG, ULONG, ULONG, struct RastPort * );
  19.  
  20.    FUNCTION
  21.   Funkcja kopiuje bitmapë o okreôlonych wymiarach do okreôlonego miejsca w rastporcie
  22.  
  23.    INPUTS
  24.   bitmap -- adres bitmapy do skopiowania
  25.   width -- szerokoôê bitmapy
  26.   height -- wysokoôê bitmapy
  27.   xpos -- pozycja x w rastporcie lewego górnego rogu bitmapy
  28.   ypos -- pozycja y w rastporcie lewego górnego rogu bitmapy
  29.   rastport -- adres rastportu
  30.  
  31.    RESULTS
  32.  
  33.    NOTE
  34.  
  35.    EXAMPLE
  36.  
  37.    SEE ALSO
  38.   BltBitMapRastPort()
  39. image.library/ChunkyToBitMapA                                     image.library/ChunkyToBitMapA
  40.  
  41.    NAME
  42.   ChunkyToBitMapA -- Zamieï chunky image na bitmapë.  (V39)
  43.   ChunkyToBitMap -- Zamieï chunky image na bitmapë( tagi jako argumenty ).  (V39)
  44.  
  45.    SYNOPSIS
  46.   bitmap = ChunkyToBitMapA( screen, chunkyimage, tags )
  47.   D0                       A0      A1
  48.  
  49.   struct BitMap * ChunkyToBitMapA( struct Screen *, struct ChunkyImg *, struct TagItem * );
  50.  
  51.   bitmap = ChunkyToBitMap( screen, chunkyimage, tag1, ... )
  52.  
  53.   struct BitMap * ChunkyToBitMap( struct Screen *, struct ChunkyImg *, ULONG, ... );
  54.  
  55.    FUNCTION
  56.   Funkcja remapuje chunkyimage do palety kolorów uûywanej przez wybrany ekran screen,
  57.   a nastëpnie konwertuje na bitmapë
  58.  
  59.    INPUTS
  60.   screen -- adres ekranu na którym bëdzie wyôwietlany chunkyimage
  61.   chunkyimage -- adres struktury ChunkyImg do konwersji
  62.   tags -- adres struktury TagItem z wybranymi tagami
  63.   
  64.     TAGS
  65.   CTBM_Precision -- Precyzja doboru kolorów. Argumenty takie same jak dla funkcji
  66.                     graphics.library/ObtainBestPenA() czyli:
  67.     PRECISION_GUI
  68.     PRECISION_ICON
  69.     PRECISION_IMAGE
  70.     PRECISION_EXACT
  71.  
  72.    RESULTS
  73.   bitmap -- adres struktury BitMap z przekonwertowanym obrazem lub zero gdy wystâpiî bîâd
  74.  
  75.    NOTE
  76.   Funkcja korzysta z funkcji graphics.library WritePixelLine8(), przy czym nie niszczy
  77.   chunkyimage
  78.  
  79.    EXAMPLE
  80.  
  81.    SEE ALSO
  82.   FreeChunky()
  83. image.library/FreeChunky                                     image.library/FreeChunky
  84.  
  85.    NAME
  86.   FreeChunky -- Zwolnij pamiëê i kolory.  (V39)
  87.  
  88.    SYNOPSIS
  89.   FreeChunky( screen, bitmap )
  90.               A0      A1
  91.  
  92.   VOID FreeChunky( struct Screen *, struct BitMap * );
  93.  
  94.    FUNCTION
  95.   Funkcja zwalnia pamiëê i kolory zajëte przez przez funkcje ChunkyToBitMapA
  96.  
  97.    INPUTS
  98.   screen -- adres tego samego ekranu jak w ChunkyToBitMapA
  99.   bitmap -- adres bitmapy zwróconej przez ChunkyTobitMapA
  100.  
  101.    RESULTS
  102.  
  103.    NOTE
  104.  
  105.    EXAMPLE
  106.  
  107.    SEE ALSO
  108.   ChunkyToBitMapA()
  109. image.library/DrawTextA                                     image.library/DrawTextA
  110.  
  111.    NAME
  112.   DrawTextA -- Narysuj wycentrowane linie tekstu.  (V39)
  113.   DrawText -- Narysuj wycentrowane linie tekstu( tagi jako argumenty ).  (V39)
  114.  
  115.    SYNOPSIS
  116.   DrawTextA( tags )
  117.              A0
  118.  
  119.   VOID DrawTextA( struct TagItem * );
  120.  
  121.   DrawText( tag1, ... )
  122.              
  123.   VOID DrawText( ULONG, ... );
  124.  
  125.    FUNCTION
  126.   Funkcja rysuje wycentrowane linie tekstu w okreôlonym rastporcie. Kaûda z linii
  127.   moûe byê narysowana okreôlonâ czcionkâ i okreôlonym stylem
  128.  
  129.    INPUTS
  130.   tags -- adres struktury TagItem z wybranymi tagami
  131.   
  132.     TAGS
  133.   DT_FontA -- adres struktury TextFont dla fontu nr.0
  134.   DT_FontB -- adres struktury TextFont dla fontu nr.1
  135.   DT_Texts -- adres ciâgu znaków zakoïczy zerem. Kaûda nowa linia musi zaczynaê
  136.               sië znakiem '\n' z wyjâtkiem pierwszej linii, nastëpny znak informuje
  137.               o numerze fontu, jeôli go nie ma to domyôlnie jest ustawiony font nr.0.
  138.               Styl czcionki okreôlajâ znaki 'b'-pogrubienie 'i'-pochylenie 'u'-podkreôlenie.
  139.               Brak znaku oznacz normalny styl. Stylów nie moûna mieszaê.
  140.               W tekôcie moûe byê maksymalnie 19 znaków 'n'.
  141.   DT_Top -- pozycja y pierwszej linii tekstu
  142.   DT_Left -- pozycja x ôrodka tekstu (jeôli DT_Width = 0)
  143.   DT_Width -- szerokoôê tekstu
  144.   DT_Height -- wysokoôê tekstu
  145.   DT_RastPort -- adres rastportu
  146.  
  147.  
  148.    RESULTS
  149.  
  150.    NOTE
  151.   Funkcja nie dokoïczona
  152.  
  153.    EXAMPLE
  154.  
  155.   DrawText( DT_Texts,"Font nr.0 styl: NORMAL\n\
  156. bFont nr.0 styl: BOLD\n\
  157. iFont nr.0 styl: ITALIC\n\
  158. uFont nr.0 styl: UNDERLINE\n\
  159. 1Font nr.1 styl: NORMAL\n\
  160. 1bFont nr.1 styl: BOLD\n\
  161. 1iFont nr.1 styl: ITALIC\n\
  162. 1uFont nr.1 styl: UNDERLINE"
  163.  DT_FontA, Font0,
  164.  DT_FontB, Font1,
  165.  DT_RastPort , Window->RPort,
  166.  DT_Top, 40,
  167.  DT_Left, 200,
  168.  TAG_DONE);
  169.  
  170.    SEE ALSO
  171.  
  172. image.library/Draw3DBoxA                                     image.library/Draw3DBoxA
  173.  
  174.    NAME
  175.   Draw3DBoxA -- Narysuj ramkë.  (V39)
  176.   Draw3DBox -- Narysuj ramkë ( tagi jako argumenty ).  (V39)
  177.  
  178.    SYNOPSIS
  179.   Draw3DBoxA( rastport, textfont, tags )
  180.              A0         A1        A2
  181.  
  182.   VOID Draw3DBoxA( struct RastPort *, struct TextFont, struct TagItem * );
  183.  
  184.   Draw3DBox( rastport, textfont, tag1, ... )
  185.              
  186.   VOID Draw3DBox( struct RastPort *, struct TextFont, ULONG, ... );
  187.  
  188.    FUNCTION
  189.   Funkcja rysuje trójwymiarowâ ramkë z opcjonalnym tekstem
  190.  
  191.    INPUTS
  192.   rastport -- adres rastportu w którym ma byê narysowana ramka
  193.   textfont -- adres struktury TextFont opisujâcej font dla wypisywanego tekstu
  194.   tags -- adres struktury TagItem z wybranymi tagami
  195.   
  196.     TAGS
  197.   DBA_PosX -- pozycja x górnego lewego rogu ramki
  198.   DBA_PosY -- pozycja y górnego lewego rogu ramki
  199.   DBA_Width -- szerokoôê ramki
  200.   DBA_Height -- wysokoôê ramki
  201.   DBA_BrightEdge -- numer koloru dla jaôniejszej krawëdzi ramki
  202.   DBA_DarkEdge -- numer koloru dla ciemniejszej krawëdzi ramki
  203.   DBA_Align -- rodzaj wyrównania tekstu ( ALIGN_CENTER lub ALIGN_LEFT - domyôlny )
  204.   DBA_Text: -- adres tekstu
  205.  
  206.  
  207.    RESULTS
  208.  
  209.    NOTE
  210.  
  211.    EXAMPLE
  212.  
  213.   Draw3DBox( Window->RPort, Font,
  214.             DBA_PosX,   80,
  215.             DBA_PosY,   30,
  216.             DBA_Width,  240,
  217.             DBA_Height, 70,
  218.             DBA_Text,   "Draw3DBox",
  219.             DBA_Align,  ALIGN_CENTER,
  220.             TAG_DONE );
  221.  
  222.    SEE ALSO
  223.  
  224. image.library/ScaleBitMapA                                     image.library/ScaleBitMapA
  225.  
  226.    NAME
  227.   ScaleBitMapA -- Skaluj bitmapë.  (V39)
  228.   ScaleBitMapA -- Skaluj bitmapë( tagi jako argumenty ).  (V39)
  229.  
  230.    SYNOPSIS
  231.   destbitmap = ScaleBitMapA( srcbitmap, tags )
  232.   D0                          A0         A1
  233.  
  234.   struct BitMap *ScaleBitMapA( struct BitMap *, struct TagItem * );
  235.  
  236.   destbitmap = ScaleBitMap( srcbitmap, tag1, ... )
  237.              
  238.   struct BitMap *ScaleBitMap( struct BitMap *, ULONG, ... );
  239.  
  240.    FUNCTION
  241.   Funkcja skaluje srcbitmap na destbitmap 
  242.  
  243.    INPUTS
  244.   srcbitmap -- adres úródîowej bitmapy
  245.   tags -- adres struktury TagItem z wybranymi tagami
  246.   
  247.     TAGS
  248.   SBA_SrcX -- pozycja x poczâtku bitmapy úródîowej (domyôlnie 0)
  249.   SBA_SrcY -- pozycja y poczâtku bitmapy úródîowej (domyôlnie 0)
  250.   SBA_SrcWidth -- szerokoôê bitmapy úródîowej
  251.   SBA_SrcHeight -- wysokoôê bitmapy úródîowej
  252.   SBA_DestWidth -- szerokoôê bitmapy przeznaczenia
  253.   SBA_DestHeight -- wysokoôê bitmapy przeznaczenia
  254.  
  255.  
  256.    RESULTS
  257.   destbitmap -- adres przeskalowanej bitmapy lub zero gdy brak pamiëci na bitmapë
  258.  
  259.    NOTE
  260.   Funkcja korzysta z funkcji graphics.library/BitMapScale() w wyniku czego
  261.   posiada takie same bîëdy ( bîëdnie skaluje gdy szerokoôê destbitmap > 1024)
  262.   Po wykorzystaniu destbitmap musimy zwolniê zajmowanâ przez niâ pamiëê z
  263.   pomocâ funkcji graphics.library/FreeBitMap()
  264.  
  265.    EXAMPLE
  266.  
  267.   ...
  268.   if(ScaledBM = ScaleBitMap( HomeBM,
  269.                     SBA_SrcWidth, 400,
  270.                     SBA_SrcHeight, 400,
  271.                     SBA_DestWidth, 200,
  272.                     SBA_DestHeight, 200),
  273.                     TAG_DONE))
  274.   {
  275.     DrawBitMap( ScaledBM, 0, 0, 200, 200, Window->RPort );
  276.     FreeBitMap( ScaledBM );
  277.   }
  278.   ...
  279.  
  280.    SEE ALSO
  281.     BitMapScale() FreeBitMap() DrawBitMap()
  282.  
  283.  
  284. image.library/ChunkyToHAMA                                     image.library/ChunkyToHAMA
  285.  
  286.    NAME
  287.   ChunkyToHAMA -- Zamieï chunky image na bitmapë HAM.  (V40)
  288.   ChunkyToHAM -- Zamieï chunky image na bitmapë HAM( tagi jako argumenty ).  (V40)
  289.  
  290.    SYNOPSIS
  291.   bitmap = ChunkyToHAMA( chunkyimage, tags )
  292.   D0                     A0           A1
  293.  
  294.   struct BitMap * ChunkyToHAMA( struct ChunkyImg *, struct TagItem * );
  295.  
  296.   bitmap = ChunkyToHAM( chunkyimage, tag1, ... )
  297.  
  298.   struct BitMap * ChunkyToHAM( struct ChunkyImg *, ULONG, ... );
  299.  
  300.    FUNCTION
  301.   Funkcja konwertuje chunky na bitmapë HAM
  302.  
  303.    INPUTS
  304.   chunkyimage -- adres struktury ChunkyImg do konwersji
  305.   tags -- adres struktury TagItem z wybranymi tagami
  306.   
  307.     TAGS
  308.   CTBH_HamMode: -- Tryb HAM, MODE_HAM6 lub MODE_HAM8.
  309.  
  310.    RESULTS
  311.   bitmap -- adres struktury BitMap z przekonwertowanym obrazem lub zero gdy wystâpiî bîâd
  312.  
  313.    NOTE
  314.   Funkcja korzysta z funkcji graphics.library WritePixelLine8(), przy czym nie niszczy
  315.   chunkyimage
  316.  
  317.    EXAMPLE
  318.  
  319.    SEE ALSO
  320.   FreeChunky()
  321.  
  322.