pane2drgb.h

Go to the documentation of this file.

/***************************************************************************
 *   stick2xyz - Can create and convert stick figure animations for CG.    *
 *   Copyright (C) 2021 by Kevin McBride <dolphindddd@aol.com>             *
 *                                                                         *
 *  This program is free software: 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 3 of the License, or      *
 *  (at your option) any later version.                                    *
 *                                                                         *
 *  This program 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 General Public License for more details.                           *
 *                                                                         *
 *  You should have received a copy of the GNU General Public License      *
 *  along with this program.  If not, see <http://www.gnu.org/licenses/>.  *
 ***************************************************************************/
 
 
#ifndef     PANE2DRGB_H
#define     PANE2DRGB_H (1)
 
#include <stick2xyz.h>
 
/* Pane2D General Module Info Functions */
stick2xyz_pctchar pane2drgb_name ( void );
 
stick2xyz_pctchar pane2drgb_desc ( void );
 
void pane2drgb_version ( int * dest );
 
int pane2drgb_type ( void );
 
void pane2drgb_set_tty ( void * fildescout, void * fildescerr );
 
int pane2drgb_can_multithread ( void );
int pane2drgb_is_multithreaded ( pane2d_handle pane );
 
int pane2drgb_get_bpp ( void );
 
void pane2drgb_getref ( pane2d_handle pane, int * refcount, int * refwaiting );
int pane2drgb_addref ( pane2d_handle pane );
int pane2drgb_releaseref ( pane2d_handle pane, int asyncrelease, int shutdown );
int pane2drgb_isowner ( pane2d_handle pane );
int pane2drgb_candraw ( pane2d_handle pane );
 
#if   defined(__WINDOWS__) | defined(DOXYGEN_BUILD)
DWORD pane2drgb_getownerinfo_windows (
      pane2d_handle pane,
      LPHANDLE destvar
);
BOOL pane2drgb_getdrawaclinfo_windows(
      pane2d_handle pane,
      struct pane2d_drawacl * dest
);
BOOL pane2drgb_freedrawaclinfo_windows(
      pane2d_handle pane,
      struct pane2d_drawacl * src
);
#endif      /* defined(__WINDOWS__) | defined(DOXYGEN_BUILD) */
int pane2drgb_waituntilowner ( pane2d_handle pane, int addref );
int pane2drgb_termwaituntilowner ( pane2d_handle pane );
#ifdef      DOXYGEN_BUILD
int pane2drgb_changeaccesscontrol (
      pane2d_handle pane,
      thrd_t * hthread,
      int hthreadsize,
      uint32_t flags
);
 
int pane2drgb_changeowningthread (
      pane2d_handle pane,
      void * newthread,
      int addref
);
 
void * pane2drgb_eventreleased ( pane2d_handle pane );
#else /* not DOXYGEN_BUILD */
#ifdef      __WINDOWS__
int pane2dgray_changeaccesscontrol (
      pane2d_handle pane,
      PHANDLE hthread,
      int hthreadsize,
      uint32_t flags
);
 
int pane2drgb_changeowningthread (
      pane2d_handle pane,
      HANDLE newthread,
      int addref
);
 
HANDLE pane2drgb_eventreleased ( pane2d_handle pane );
#else /* not __WINDOWS__ */
#ifdef      HAVE_THREADS_H
int pane2drgb_changeaccesscontrol (
      pane2d_handle pane,
      thrd_t * hthread,
      int hthreadsize,
      uint32_t flags
);
 
int pane2drgb_changeowningthread (
      pane2d_handle pane,
      thrd_t newthread,
      int addref
);
#else /* not HAVE_THREADS_H */
int pane2drgb_changeaccesscontrol (
      pane2d_handle pane,
      void * hthread,
      int hthreadsize,
      uint32_t flags
);
 
int pane2drgb_changeowningthread (
      pane2d_handle pane,
      void * newthread,
      int addref
);
#endif      /* not HAVE_THREADS_H */
#endif      /* not __WINDOWS__ */
#endif      /* not DOXYGEN_BUILD */
 
#ifndef     __WINDOWS__
void pane2drgb_lang ( stick2xyz_print_ptr newval );
#endif      /* not __WINDOWS__ */
 
/* Generic Drawing Pane (2-D) Allocation Functions */
pane2d_handle pane2drgb_alloc ( int x, int y );
pane2d_handle pane2drgb_alloc_multithread (
      int x,
      int y,
      size_t maxthreads,
      uint32_t typesallowed
);
void pane2drgb_clear ( pane2d_handle pane );
void pane2drgb_free ( pane2d_handle pane );
uint8_t ** pane2drgb_dupdata ( pane2d_handle pane, int padding );
uint8_t ** pane2drgb_dupimage ( pane2d_handle pane, int padding );
void pane2drgb_freeimage ( pane2d_handle pane, uint8_t ** image );
uint16_t ** pane2drgb_dupimage16 ( pane2d_handle pane, int padding );
void pane2drgb_freeimage16 ( pane2d_handle pane, uint16_t ** image );
uint8_t * pane2drgb_dupdatap ( pane2d_handle pane, int padding );
void pane2drgb_freedatap ( pane2d_handle pane, uint8_t * image );
uint16_t * pane2drgb_dupdata16p ( pane2d_handle pane, int padding );
void pane2drgb_freedata16p ( pane2d_handle pane, uint16_t * image );
void pane2drgb_dupxy ( pane2d_handle pane, int * x, int * y);
int pane2drgb_dupfunc_getlist (
      uint32_t typerequested,
      struct pane2d_dupgen_funcs * dest
);
 
 
/* Generic Drawing Pane (2-D) Debug Functions */
void pane2drgb_print_segment ( pane2d_handle image, int use_rgb );
 
 
/* Generic Drawing Pane (2-D) Vertex Functions */
void pane2drgb_vertex_setopts ( pane2d_handle pane, uint32_t newopts );
uint32_t pane2drgb_vertex_getopts ( pane2d_handle pane );
int pane2drgb_vertex_get (
      pane2d_handle pane,
      int elm,
      struct pane2d_vertex_elm * dest
);
int pane2drgb_vertex_get_v2 (
      pane2d_handle pane,
      int elm,
      struct pane2d_vertex_elm_v2 * dest
);
 
/* Generic Drawing Pane (2-D) Texture Functions */
uint64_t pane2drgb_texture_add_gray (
      pane2d_handle pane,
      uint8_t gray,
      uint8_t alpha,
      pane2d_texture_handle * dest
);
uint64_t pane2drgb_texture_add_gray16 (
      pane2d_handle pane,
      uint16_t gray,
      uint16_t alpha,
      pane2d_texture_handle * dest
);
uint64_t pane2drgb_texture_add_rgb (
      pane2d_handle pane,
      uint8_t red,
      uint8_t green,
      uint8_t blue,
      uint8_t alpha,
      pane2d_texture_handle * dest
);
uint64_t pane2drgb_texture_add_rgb16 (
      pane2d_handle pane,
      uint16_t red,
      uint16_t green,
      uint16_t blue,
      uint16_t alpha,
      pane2d_texture_handle * dest
);
int pane2drgb_texture_enum (
      pane2d_handle pane,
      pane2d_texture_handle * dest,
      uint64_t number
);
void pane2drgb_texture_clear ( pane2d_handle pane );
uint32_t pane2drgb_colortype ( void );
 
/* Generic Drawing Pane (2-D) Drawing Functions */
void pane2drgb_drawpixel ( pane2d_handle pane, int x, int y );
void pane2drgb_drawline (
      pane2d_handle pane,
      int d,
      int x1,
      int y1,
      int x2,
      int y2
);
void pane2drgb_drawcircle (
      pane2d_handle pane,
      int d,
      int x,
      int y,
      int r
);
void pane2drgb_fillcircle (
      pane2d_handle pane,
      pane2d_texture_handle src,
      int x,
      int y,
      int r
);
void pane2drgb_drawellipse (
      pane2d_handle pane,
      int d,
      int x,
      int y,
      int rx,
      int ry
);
void pane2drgb_fillellipse (
      pane2d_handle pane,
      pane2d_texture_handle src,
      int x,
      int y,
      int rx,
      int ry
);
 
void pane2drgb_drawrect (
      pane2d_handle pane,
      int d,
      int x1,
      int y1,
      int x2,
      int y2
);
void pane2drgb_fillrect (
      pane2d_handle pane,
      pane2d_texture_handle src,
      int x1,
      int y1,
      int x2,
      int y2
);
void pane2drgb_drawsquare (
      pane2d_handle pane,
      int d,
      int l,
      int x1,
      int y1
);
void pane2drgb_fillsquare ( 
      pane2d_handle pane,
      pane2d_texture_handle src,
      int l,
      int x1,
      int y1
);
 
void pane2drgb_drawtriangle (
      pane2d_handle pane,
      int d,
      int x1, 
      int y1,
      int x2,
      int y2,
      int x3,
      int y3
);
void pane2drgb_filltriangle (
      pane2d_handle pane,
      pane2d_texture_handle src,
      int x1, 
      int y1,
      int x2,
      int y2,
      int x3,
      int y3
);
 
void pane2drgb_drawrighttriangle (
      pane2d_handle pane,
      int d,
      int x1,
      int y1,
      int x2,
      int y2,
      int b
);
void pane2drgb_fillrighttriangle (
      pane2d_handle pane,
      pane2d_texture_handle src,
      int x1,
      int y1,
      int x2,
      int y2,
      int b
);
void pane2drgb_drawtworighttriangles (
      pane2d_handle pane,
      int d,
      int x1,
      int y1,
      int x2,
      int y2
);
#endif      /* PANE2DRGB_H */