dm_gm_add_text_box Function

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

Uses

  • proc~~dm_gm_add_text_box~~UsesGraph proc~dm_gm_add_text_box dm_gm_add_text_box module~dm_string dm_string proc~dm_gm_add_text_box->module~dm_string module~dm_error dm_error module~dm_string->module~dm_error module~dm_kind dm_kind module~dm_string->module~dm_kind module~dm_error->module~dm_kind module~dm_ascii dm_ascii module~dm_error->module~dm_ascii iso_fortran_env iso_fortran_env module~dm_kind->iso_fortran_env

Draws text camera image file, using GraphicsMagick. By default, the text box is drawn to the bottom-left corner of the image. If no text box is passed, the default values of the derived type are used. Any quote characters ' and " in string text will be removed.

Note: Make sure to pass only sanitised or parameterised arguments to this function, or risk shell injections if one of them is user-supplied.

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.

References

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 proc~dm_string_remove dm_string_remove proc~dm_gm_add_text_box->proc~dm_string_remove