Warning

This manual is not up to date! The new documentation will come soon! Some functions have changed its prototype...

Overview

The LPATT is a very small and simple C library developed to allow CD (Canvas Draw) programmers to incorporate EdPatt patterns into their applications.

Once constructed the pattern, CD applications can read its description (.pat file) and associate a simbolic name to it. Then, future references to this pattern are automatically managed in the library.

Main Functions

• LPatt* LPattNew( char* name, char* patfile, char* palfile );
  Creates a new pattern with the symbolic name name. The pattern matrix and pallete are described by the EdPatt files patfile (.pat) and palfile (.pal) respectly. This function return a handle for the new pattern.
• LPatt* LPattGetHandle( char* name );
  Returns the handle of the pattern whose symbolic name is name.
• void LPattDelete( LPatt* pat );
  Destroys a previously created pattern.
• int LPattSet( LPatt* pat );
  Sets the current pattern in CD.

  Short Sample Codes

  Creation and destruction

  void main ( void )
  {
    /* System initialization. Example: IupOpen(); */
  
    LPattNew( "1", "1.pat", "pattern.pal" );
    LPattNew( "2", "2.pat", "pattern.pal" );
  
    /* Event loops or main routine. Example: IupMainLoop(); */
  
    LPattDelete( LPattGetHandle("1") );
    LPattDelete( LPattGetHandle("2") );
  }
  

  Setting patterns and drawing using CD

    LPattSet( mypat ); /* mypat is a valid LPatt* */
    cdInteriorStyle( CD_PATTERN );
    cdBegin( CD_FILL );
    cdVertex( 0, 0 );
    cdVertex( 100, 0 );
    cdVertex( 100, 100 );
    cdVertex( 0, 100 );
    cdEnd();
  

  Acknowledgments

  This work was developed at TeCGraf / PUC-Rio. Suggestions, critics and bug reports can be sent to André Clinio.

  ---

  LPATT - Canvas Draw Pattern Library
  Copyright © 1996 [TeCGraf]. All rights reserved.