Actions

Difference between revisions of "GFL Windows specific"

From XnView Wiki

(Created page with 'gflConvertBitmapIntoDIB The gflConvertBitmapIntoDIB function converts a GFL_BITMAP in a Windows Device Independant Bitmap. GFL_ERROR gflConvertBitmapIntoDIB( const GFL_BITM…')
 
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
gflConvertBitmapIntoDIB
== gflConvertBitmapIntoDIB ==


The gflConvertBitmapIntoDIB function converts a GFL_BITMAP in a Windows Device Independant Bitmap.  
The gflConvertBitmapIntoDIB function converts a GFL_BITMAP in a Windows Device Independant Bitmap.  


GFL_ERROR <b>gflConvertBitmapIntoDIB</b>(
  const GFL_BITMAP* bitmap, 
  HANDLE* hDIB
);


GFL_ERROR gflConvertBitmapIntoDIB(
'''Parameters'''
  const GFL_BITMAP * bitmap, 
  HANDLE * hDIB
);


Parameters
:bitmap
::Pointer to a GFL_BITMAP structure.
:hDIB
::Address of a DIB HANDLE.


bitmap
'''Return value'''
Pointer to a GFL_BITMAP structure.
:The function returns GFL_NO_ERROR if it is successful or a value of [[Error|GFL_ERROR]].  
hDIB
Address of a DIB HANDLE.  


Return value


The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.
== gflConvertBitmapIntoDDB ==
 
 
See also
 
gflConvertBitmapIntoDDB, gflConvertDIBIntoBitmap, gflConvertDDBIntoBitmap, gflLoadBitmapIntoDIB, gflLoadBitmapIntoDDB, gflAddText gflImportFromHWND
 
 
gflConvertBitmapIntoDDB


The gflConvertBitmapIntoDDB function converts a GFL_BITMAP in a Windows Device Dependant Bitmap.  
The gflConvertBitmapIntoDDB function converts a GFL_BITMAP in a Windows Device Dependant Bitmap.  


GFL_ERROR <b>gflConvertBitmapIntoDIB</b>(
  const GFL_BITMAP* bitmap, 
  HBITMAP* hBitmap
);


GFL_ERROR gflConvertBitmapIntoDIB(
'''Parameters'''
  const GFL_BITMAP * bitmap, 
  HBITMAP * hBitmap
);


Parameters
:bitmap
::Pointer to a GFL_BITMAP structure.
:hBitmap
::Address of a HBITMAP.


bitmap
'''Return value'''
Pointer to a GFL_BITMAP structure.
:The function returns GFL_NO_ERROR if it is successful or a value of [[Error|GFL_ERROR]].  
hBitmap
Address of a HBITMAP.  


Return value


The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.
== gflConvertDIBIntoBitmap ==
 
 
See also
 
gflConvertBitmapIntoDIB, gflConvertDIBIntoBitmap, gflConvertDDBIntoBitmap, gflLoadBitmapIntoDIB, gflLoadBitmapIntoDDB, gflAddText
 
 
gflConvertDIBIntoBitmap


The gflConvertDIBIntoBitmap function converts a Windows Device Independant Bitmap into GFL_BITMAP.  
The gflConvertDIBIntoBitmap function converts a Windows Device Independant Bitmap into GFL_BITMAP.  


GFL_ERROR <b>gflConvertDIBIntoBitmap</b>(
  HANDLE hDIB, 
  GFL_BITMAP** bitmap
);


GFL_ERROR gflConvertDIBIntoBitmap(
'''Parameters'''
  HANDLE hDIB, 
  GFL_BITMAP ** bitmap
);
 
Parameters  
 
hDIB
A HANDLE on the DIB.
bitmap
Address of a pointer to a GFL_BITMAP structure.
 
Return value
 
The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.
 


See also
:hDIB
::A HANDLE on the DIB.
:bitmap
::Address of a pointer to a GFL_BITMAP structure.


gflConvertBitmapIntoDIB, gflConvertBitmapIntoDDB, gflConvertDDBIntoBitmap, gflLoadBitmapIntoDIB, gflLoadBitmapIntoDDB, gflAddText
'''Return value'''
:The function returns GFL_NO_ERROR if it is successful or a value of [[Error|GFL_ERROR]].




gflConvertDDBIntoBitmap
== gflConvertDDBIntoBitmap ==


The gflConvertDDBIntoBitmap function converts a Windows Device Dependant Bitmap into GFL_BITMAP.  
The gflConvertDDBIntoBitmap function converts a Windows Device Dependant Bitmap into GFL_BITMAP.  


GFL_ERROR <b>gflConvertDDBIntoBitmap</b>(
  HBITMAP hBitmap, 
  GFL_BITMAP** bitmap
);


GFL_ERROR gflConvertDDBIntoBitmap(
'''Parameters'''
  HBITMAP hBitmap, 
  GFL_BITMAP ** bitmap
);
 
Parameters  


hBitmap  
:hBitmap  
A HANDLE on the HBITMAP.  
::A HANDLE on the HBITMAP.  
bitmap  
:bitmap  
Address of a pointer to a GFL_BITMAP structure.  
::Address of a pointer to a GFL_BITMAP structure.  


Return value  
'''Return value'''
:The function returns GFL_NO_ERROR if it is successful or a value of [[Error|GFL_ERROR]].


The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.


== gflLoadBitmapIntoDIB ==


See also
The gflLoadBitmapIntoDIB function loads a picture file into a Windows Device Independant Bitmap.


gflConvertBitmapIntoDIB, gflConvertBitmapIntoDDB, gflConvertDIBIntoBitmap, gflLoadBitmapIntoDIB, gflLoadBitmapIntoDDB, gflAddText
GFL_ERROR <b>gflLoadBitmapIntoDIB</b>(
  const char* filename,
  HANDLE* hDIB,
  GFL_LOAD_PARAMS* params,
  GFL_FILE_INFORMATION* informations
);


'''Parameters'''


gflLoadBitmapIntoDIB
:filename
::Pointer to a null-terminated string that contains the filename to load.
:hDIB
::Address of a DIB HANDLE.
:params
::Pointer to a GFL_LOAD_PARAMS structure.
::This structure must be filled correctly.
:informations
::Pointer to a GFL_FILE_INFORMATION structure. Can be NULL if you don't want it.
::You must use [[Read#gflFreeFileInformation|gflFreeInformation]] to free his content.


The gflLoadBitmapIntoDIB function load a picture file into a Windows Device Independant Bitmap.  
'''Return value'''
:The function returns GFL_NO_ERROR if it is successful or a value of [[Error|GFL_ERROR]].


== gflLoadBitmapIntoDDB ==


GFL_ERROR gflLoadBitmapIntoDIB(
The gflLoadBitmapIntoDDB function loads a picture file into a Windows Device Dependant Bitmap.
  const char * filename, 
  HANDLE * hDIB, 
  GFL_LOAD_PARAMS * params, 
  GFL_FILE_INFORMATION * informations
);


Parameters
GFL_ERROR <b>gflLoadBitmapIntoDDB</b>(
  const char* filename, 
  HBITMAP* hBitmap, 
  GFL_LOAD_PARAMS* params, 
  GFL_FILE_INFORMATION* informations
);


filename
'''Parameters'''
Pointer to a null-terminated string that contains the filename to load.
hDIB
Address of a DIB HANDLE.
params
Pointer to a GFL_LOAD_PARAMS structure.
This structure must be filled correctly.
informations
Pointer to a GFL_FILE_INFORMATION structure. Can be NULL if you don't want it.
You must use gflFreeInformation to free his content.


Return value
:filename
::Pointer to a null-terminated string that contains the filename to load.
:hBitmap
::Address of a HBITMAP.
:params
::Pointer to a GFL_LOAD_PARAMS structure.
::This structure must be filled correctly.
:informations
::Pointer to a GFL_FILE_INFORMATION structure. Can be NULL if you don't want it.
::You must use [[Read#gflFreeFileInformation|gflFreeInformation]] to free his content.


The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.  
'''Return value'''
:The function returns GFL_NO_ERROR if it is successful or a value of [[Error|GFL_ERROR]].


 
== gflAddText ==
See also
 
gflConvertBitmapIntoDIB, gflConvertBitmapIntoDDB, gflConvertDIBIntoBitmap, gflConvertDDBIntoBitmap, gflLoadBitmapIntoDDB, gflAddText
 
 
gflLoadBitmapIntoDDB
 
The gflLoadBitmapIntoDDB function load a picture file into a Windows Device Dependant Bitmap.
 
 
GFL_ERROR gflLoadBitmapIntoDDB(
  const char * filename, 
  HBITMAP * hBitmap, 
  GFL_LOAD_PARAMS * params, 
  GFL_FILE_INFORMATION * informations
);
 
Parameters
 
filename
Pointer to a null-terminated string that contains the filename to load.
hBitmap
Address of a HBITMAP.
params
Pointer to a GFL_LOAD_PARAMS structure.
This structure must be filled correctly.
informations
Pointer to a GFL_FILE_INFORMATION structure. Can be NULL if you don't want it.
You must use gflFreeInformation to free his content.
 
Return value
 
The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.
 
 
See also
 
gflConvertBitmapIntoDIB, gflConvertBitmapIntoDDB, gflConvertDIBIntoBitmap, gflConvertDDBIntoBitmap, gflLoadBitmapIntoDIB, gflAddText
 
 
gflAddText


The gflAddText function adds a text on a GFL_BITMAP.  
The gflAddText function adds a text on a GFL_BITMAP.  


GFL_ERROR <b>gflAddText</b>(
  GFL_BITMAP* bitmap, 
  const char* text, 
  const char* font_name, 
  GFL_INT32 x, 
  GFL_INT32 y, 
  GFL_INT32 font_size, 
  GFL_INT32 orientation, 
  GFL_BOOL italic, 
  GFL_BOOL bold, 
  GFL_BOOL strike_out, 
  GFL_BOOL underline, 
  GFL_BOOL antialias, 
  const GFL_COLOR* color
);


GFL_ERROR gflAddText(
'''Parameters'''
  GFL_BITMAP * bitmap, 
  const char * text, 
  const char * font_name, 
  GFL_INT32  x, 
  GFL_INT32  y, 
  GFL_INT32  font_size, 
  GFL_INT32  orientation, 
  GFL_BOOL  italic, 
  GFL_BOOL  bold, 
  GFL_BOOL  strike_out, 
  GFL_BOOL  underline, 
  GFL_BOOL  antialias, 
  const GFL_COLOR * color
);


Parameters
:bitmap
::Pointer to a GFL_BITMAP structure.
:text
::Pointer to a null-terminated string that contains the text to add.
:font_name
::Pointer to a null-terminated string that contains the name of the font to use.
:x
::X position.
:y
::Y position.
:font_size
::Height of the font.
:orientation
::Orientation of the text (degrees).
:italic
::Specifies a italic font.
:bold
::Specifies a bold font.
:strike_out
::Specifies a strikeout font.
:underline
::Specifies a underline font.
:antialias
::Font is antialiased.
:color
::Pointer to a GFL_COLOR structure for the text color.


bitmap
'''Return value'''
Pointer to a GFL_BITMAP structure.
:The function returns GFL_NO_ERROR if it is successful or a value of [[Error|GFL_ERROR]].  
text
Pointer to a null-terminated string that contains the text to add.
font_name
Pointer to a null-terminated string that contains the name of the font to use.
x
X position.
y
Y position.
font_size
Height of the font.
orientation
Orientation of the text (degrees).
italic
Specifies a italic font.
bold
Specifies a bold font.
strike_out
Specifies a strikeout font.
underline
Specifies a underline font.
antialias
Font is antialiased.
color
Pointer to a GFL_COLOR structure for the text color.  


Return value


The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.
== gflImportFromClipboard ==
 
 
See also
 
gflConvertBitmapIntoDIB, gflConvertBitmapIntoDDB, gflConvertDIBIntoBitmap, gflConvertDDBIntoBitmap, gflLoadBitmapIntoDIB, gflLoadBitmapIntoDDB
 
 
gflImportFromClipboard


The gflImportFromClipboard function allows to import the picture from the clipboard. .  
The gflImportFromClipboard function allows to import the picture from the clipboard. .  


GFL_ERROR <b>gflImportFromClipboard</b>(
  GFL_BITMAP** bitmap
);


GFL_ERROR gflImportFromClipboard(
'''Parameters'''
  GFL_BITMAP ** bitmap
);


Parameters
:bitmap
::Address of a pointer to a GFL_BITMAP structure.


bitmap
'''Return value'''
Address of a pointer to a GFL_BITMAP structure.  
:The function returns GFL_NO_ERROR if it is successful or a value of [[Error|GFL_ERROR]].  


Return value


The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.
== gflExportIntoClipboard ==
 
 
See also
 
gflExportFromClipboard, gflImportFromHWND
 
 
gflExportIntoClipboard


The gflExportIntoClipboard function allows to export a picture into clipboard..  
The gflExportIntoClipboard function allows to export a picture into clipboard..  


GFL_ERROR <b>gflExportIntoClipboard</b>(
  GFL_BITMAP* bitmap
);


GFL_ERROR gflExportIntoClipboard(
'''Parameters'''
  GFL_BITMAP * bitmap
);
 
Parameters  
 
bitmap
Pointer to a GFL_BITMAP structure.
 
Return value
 
The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.


:bitmap
::Pointer to a GFL_BITMAP structure.


See also
'''Return value'''
:The function returns GFL_NO_ERROR if it is successful or a value of [[Error|GFL_ERROR]].


gflImportFromClipboard, gflImportFromHWND


 
== gflImportFromHWND ==
gflImportFromHWND


The gflImportFromHWND function allows to copy the content of a window. .  
The gflImportFromHWND function allows to copy the content of a window. .  


GFL_ERROR <b>gflImportFromHWND</b>(
  HWND hwnd,
  const GFL_RECT* rect, 
  GFL_BITMAP** bitmap
);


GFL_ERROR gflImportFromHWND(
'''Parameters'''
  HWND hwnd
  const GFL_RECT * rect, 
  GFL_BITMAP ** bitmap
);
 
Parameters  
 
hwnd
Handle of the window.
rect
Rectangle to copy.
Can be NULL.
bitmap
Address of a pointer to a GFL_BITMAP structure.
 
Return value
 
The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.


:hwnd
::Handle of the window.
:rect
::Pointer to [[Structures#GFL_RECT|GFL_RECT]] structure. Rectangle to copy. Can be NULL.
:bitmap
::Address of a pointer to a GFL_BITMAP structure.


See also
'''Return value'''
:The function returns GFL_NO_ERROR if it is successful or a value of [[Error|GFL_ERROR]].


gflImportFromClipboard, gflExportFromClipboard
[[Category: GFLSDK Reference Manual]]

Latest revision as of 18:18, 27 April 2010

gflConvertBitmapIntoDIB

The gflConvertBitmapIntoDIB function converts a GFL_BITMAP in a Windows Device Independant Bitmap. 

GFL_ERROR gflConvertBitmapIntoDIB(
  const GFL_BITMAP* bitmap,  
  HANDLE* hDIB
);

Parameters

bitmap
Pointer to a GFL_BITMAP structure.
hDIB
Address of a DIB HANDLE.

Return value

The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.


gflConvertBitmapIntoDDB

The gflConvertBitmapIntoDDB function converts a GFL_BITMAP in a Windows Device Dependant Bitmap. 

GFL_ERROR gflConvertBitmapIntoDIB(
  const GFL_BITMAP* bitmap,  
  HBITMAP* hBitmap
);

Parameters

bitmap
Pointer to a GFL_BITMAP structure.
hBitmap
Address of a HBITMAP.

Return value

The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.


gflConvertDIBIntoBitmap

The gflConvertDIBIntoBitmap function converts a Windows Device Independant Bitmap into GFL_BITMAP. 

GFL_ERROR gflConvertDIBIntoBitmap(
  HANDLE hDIB,  
  GFL_BITMAP** bitmap
);

Parameters

hDIB
A HANDLE on the DIB.
bitmap
Address of a pointer to a GFL_BITMAP structure.

Return value

The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.


gflConvertDDBIntoBitmap

The gflConvertDDBIntoBitmap function converts a Windows Device Dependant Bitmap into GFL_BITMAP. 

GFL_ERROR gflConvertDDBIntoBitmap(
  HBITMAP hBitmap,  
  GFL_BITMAP** bitmap
);

Parameters

hBitmap
A HANDLE on the HBITMAP.
bitmap
Address of a pointer to a GFL_BITMAP structure.

Return value

The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.


gflLoadBitmapIntoDIB

The gflLoadBitmapIntoDIB function loads a picture file into a Windows Device Independant Bitmap. 

GFL_ERROR gflLoadBitmapIntoDIB(
  const char* filename,  
  HANDLE* hDIB,  
  GFL_LOAD_PARAMS* params,  
  GFL_FILE_INFORMATION* informations
);

Parameters

filename
Pointer to a null-terminated string that contains the filename to load.
hDIB
Address of a DIB HANDLE.
params
Pointer to a GFL_LOAD_PARAMS structure.
This structure must be filled correctly.
informations
Pointer to a GFL_FILE_INFORMATION structure. Can be NULL if you don't want it.
You must use gflFreeInformation to free his content.

Return value

The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.

gflLoadBitmapIntoDDB

The gflLoadBitmapIntoDDB function loads a picture file into a Windows Device Dependant Bitmap. 

GFL_ERROR gflLoadBitmapIntoDDB(
  const char* filename,  
  HBITMAP* hBitmap,  
  GFL_LOAD_PARAMS* params,  
  GFL_FILE_INFORMATION* informations
);

Parameters

filename
Pointer to a null-terminated string that contains the filename to load.
hBitmap
Address of a HBITMAP.
params
Pointer to a GFL_LOAD_PARAMS structure.
This structure must be filled correctly.
informations
Pointer to a GFL_FILE_INFORMATION structure. Can be NULL if you don't want it.
You must use gflFreeInformation to free his content.

Return value

The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.

gflAddText

The gflAddText function adds a text on a GFL_BITMAP. 

GFL_ERROR gflAddText(
  GFL_BITMAP* bitmap,  
  const char* text,  
  const char* font_name,  
  GFL_INT32 x,  
  GFL_INT32 y,  
  GFL_INT32 font_size,  
  GFL_INT32 orientation,  
  GFL_BOOL italic,  
  GFL_BOOL bold,  
  GFL_BOOL strike_out,  
  GFL_BOOL underline,  
  GFL_BOOL antialias,  
  const GFL_COLOR* color
);

Parameters

bitmap
Pointer to a GFL_BITMAP structure.
text
Pointer to a null-terminated string that contains the text to add.
font_name
Pointer to a null-terminated string that contains the name of the font to use.
x
X position.
y
Y position.
font_size
Height of the font.
orientation
Orientation of the text (degrees).
italic
Specifies a italic font.
bold
Specifies a bold font.
strike_out
Specifies a strikeout font.
underline
Specifies a underline font.
antialias
Font is antialiased.
color
Pointer to a GFL_COLOR structure for the text color.

Return value

The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.


gflImportFromClipboard

The gflImportFromClipboard function allows to import the picture from the clipboard. . 

GFL_ERROR gflImportFromClipboard(
  GFL_BITMAP** bitmap
);

Parameters

bitmap
Address of a pointer to a GFL_BITMAP structure.

Return value

The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.


gflExportIntoClipboard

The gflExportIntoClipboard function allows to export a picture into clipboard.. 

GFL_ERROR gflExportIntoClipboard(
  GFL_BITMAP* bitmap
);

Parameters

bitmap
Pointer to a GFL_BITMAP structure.

Return value

The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.


gflImportFromHWND

The gflImportFromHWND function allows to copy the content of a window. . 

GFL_ERROR gflImportFromHWND(
  HWND hwnd,
  const GFL_RECT* rect,  
  GFL_BITMAP** bitmap
);

Parameters

hwnd
Handle of the window.
rect
Pointer to GFL_RECT structure. Rectangle to copy. Can be NULL.
bitmap
Address of a pointer to a GFL_BITMAP structure.

Return value

The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.
Retrieved from "https://www.xnview.com/wiki/index.php?title=GFL_Windows_specific&oldid=364"