dm_gm_add_text_box Function

public function dm_gm_add_text_box(path, text, text_box, command) result(rc)

Draws text camera image file, using GraphicsMagick. By default, the text box is drawn to the bottom-left corner of the image.

For a list of all supported font names, run:

$ gm convert -list font
Path: /usr/local/lib/GraphicsMagick/config/type-windows.mgk

Name                             Family                  Style   Stretch  Weight
--------------------------------------------------------------------------------
Arial                            Arial                   normal  normal    400
Arial-Black                      Arial                   normal  normal    900
Arial-Bold                       Arial                   normal  normal    700
Arial-Bold-Italic                Arial                   italic  normal    700
Arial-Italic                     Arial                   italic  normal    400
...

If no text box is passed, the default values of the derived type are used.

The function returns the following error codes:

  • E_EMPTY if text or image path are empty.
  • E_IO if GraphicsMagick command execution failed.
  • E_NOT_FOUND if image at given path does no exist.

Arguments

Type IntentOptional Attributes Name
character(len=*), intent(in) :: path

Image file path.
character(len=*), intent(in) :: text

Text to add.
type(gm_text_box_type), intent(in), optional :: text_box

Image text box type.
character(len=:), intent(out), optional, allocatable :: command

Executed command.

Return Value integer


Calls

proc~~dm_gm_add_text_box~~CallsGraph proc~dm_gm_add_text_box dm_gm_add_text_box proc~dm_file_exists dm_file_exists proc~dm_gm_add_text_box->proc~dm_file_exists