Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
DIRECTFB-CSOURCE(1)	     DirectFB Manual Pages	   DIRECTFB-CSOURCE(1)

NAME
       directfb-csource	- C code generation utility for	DirectFB surfaces

SYNOPSIS
       directfb-csource	[options] <imagefiles>

DESCRIPTION
       directfb-csource	 is  a	small utility that reads PNG (Portable Network
       Graphics) image files and generates C code that can be used to  compile
       an image	into a DirectFB	application.  Below is a simple	example	to il-
       lustrate	this.

       If multiple PNG image files are passed to  directfb-csource,  they  are
       combined	 into a	single surface.	The different images can then be blit-
       ted from	this surface using  the	 array	of  rectangles	that  is  also
       dumped. This can	be useful for example for icons	or sprites.

OPTIONS
       --name=identifier
	      Specifies	 the  identifier name (prefix) for the generated vari-
	      ables.  If this option is	not used, the identifier is  generated
	      from  the	 filename.  You	have to	specify	an identifer name when
	      processing multiple images.

       --format=pixelformat
	      Specifies	the pixel-format of the	generated inline surface. Pos-
	      sible  values  are  ARGB,	RGB32, RGB24, RGB16, RGB15, RGB332, A8
	      and LUT8.	 By default the	format is ARGB if the PNG image	has an
	      alpha channel or RGB32 otherwise.

       --dither-rgb16
	      If  specified,  images  rendered to RGB16	surfaces are dithered.
	      This reduces banding caused by the limited colorspace. This  op-
	      tion has no effect for other pixel-formats than RGB16.

       --transparent=AARRGGBB
	      If  specified,  completely  transparent  pixels  are set to this
	      color value.  This may be	useful for color keying	 and  to  work
	      around bugs in graphics driver.

       --version
	      Output version information.

       --help Print brief help and exit.

EXAMPLE
       Generate	a header file from a PNG image file:

	    directfb-csource --name=foo	foo.png	> foo.h

       Include	the  generated header in your application and create a surface
       using the surface description from the header file:

	 #include <directfb.h>
	 #include "foo.h"

	 IDirectFB	  *dfb;
	 IDirectFBSurface *surface;

	 ...

	 dfb->CreateSurface( dfb, &foo_desc, &surface );

OTHER INFO
       directfb-csource	was inspired by	and uses code from gdk-pixbuf-csource,
       a similar program written by Tim	Janik.

       The   canonical	place  to  find	 informations  about  DirectFB	is  at
       http://www.directfb.org/.

Version	1.4.17			  14 May 2009		   DIRECTFB-CSOURCE(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLE | OTHER INFO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=directfb-csource&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help