Actions

GFL Windows specific

From XnView Wiki

The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

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"