label_create Function

public function label_create(text, position, rgba, size, max_size, alignment, font_name) result(node)

A label node: text at position in color rgba, in font font_name ('' for the default), aligned by alignment (an ALIGN_* constant of vkf_frames). size > 0: size window units tall; size < 0: -size scene units tall, but at most max_size window units on screen. Null if the font is missing.

Arguments

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

the label's text
real(kind=wp), intent(in) :: position(3)

(the coordinates of the node it is put under)
real(kind=wp), intent(in) :: rgba(4)

color [r, g, b, a] (0 to 1)
real(kind=wp), intent(in) :: size

0: height in window units; < 0: -height in scene units
real(kind=wp), intent(in) :: max_size

for size < 0: the largest height on screen (window units)
integer, intent(in) :: alignment

an ALIGN_* constant of vkf_frames
character(len=*), intent(in) :: font_name

font file ('' for the default)

Return Value type(c_ptr)


Calls

proc~~label_create~~CallsGraph proc~label_create label_create interface~vkf_label_create vkf_label_create proc~label_create->interface~vkf_label_create proc~get_font get_font proc~label_create->proc~get_font proc~vsg_alignment vsg_alignment proc~label_create->proc~vsg_alignment interface~vkf_font_read vkf_font_read proc~get_font->interface~vkf_font_read proc~find_font find_font proc~get_font->proc~find_font proc~find_in_dirs find_in_dirs proc~find_font->proc~find_in_dirs

Called by

proc~~label_create~~CalledByGraph proc~label_create label_create proc~create_hud create_hud proc~create_hud->proc~label_create proc~make_axis make_axis proc~make_axis->proc~label_create proc~make_name_label make_name_label proc~make_name_label->proc~label_create proc~make_name_node make_name_node proc~make_name_node->proc~label_create proc~add_hud_text WindowProxy%add_hud_text proc~add_hud_text->proc~create_hud proc~build_decorations build_decorations proc~build_decorations->proc~make_axis proc~build_decorations->proc~make_name_label proc~create_huds create_huds proc~create_huds->proc~create_hud proc~make_star_node make_star_node proc~make_star_node->proc~make_name_node proc~move_axis move_axis proc~move_axis->proc~make_axis proc~remake_axes remake_axes proc~remake_axes->proc~make_axis proc~set_label_font ReferenceFrame%set_label_font proc~set_label_font->proc~make_name_label proc~set_label_font->proc~remake_axes proc~set_star_names SkySphere%set_star_names proc~set_star_names->proc~make_name_node proc~set_x_label ReferenceFrame%set_x_label proc~set_x_label->proc~make_axis proc~set_y_label ReferenceFrame%set_y_label proc~set_y_label->proc~make_axis proc~set_z_label ReferenceFrame%set_z_label proc~set_z_label->proc~make_axis proc~update_huds update_huds proc~update_huds->proc~create_hud proc~frame WindowProxy%frame proc~frame->proc~create_huds proc~frame->proc~update_huds proc~realize ReferenceFrame%realize proc~frame->proc~realize proc~move_x_axis ReferenceFrame%move_x_axis proc~move_x_axis->proc~move_axis proc~move_y_axis ReferenceFrame%move_y_axis proc~move_y_axis->proc~move_axis proc~move_z_axis ReferenceFrame%move_z_axis proc~move_z_axis->proc~move_axis proc~node~2 SkySphere%node proc~node~2->proc~make_star_node proc~realize->proc~build_decorations proc~realize->proc~realize proc~relayout_labels relayout_labels proc~relayout_labels->proc~remake_axes proc~set_color~2 ReferenceFrame%set_color proc~set_color~2->proc~remake_axes proc~set_star_data SkySphere%set_star_data proc~set_star_data->proc~make_star_node proc~add_child ReferenceFrame%add_child proc~add_child->proc~realize proc~axes_set_color CoordinateAxes%axes_set_color proc~axes_set_color->proc~set_color~2 proc~grid_set_color LatLonGrid%grid_set_color proc~grid_set_color->proc~set_color~2 proc~new_reference_frame new_reference_frame proc~new_reference_frame->proc~set_color~2 proc~place_axes place_axes proc~place_axes->proc~move_x_axis proc~place_axes->proc~move_y_axis proc~place_axes->proc~move_z_axis proc~place_grid_axes place_grid_axes proc~place_grid_axes->proc~move_x_axis proc~place_grid_axes->proc~move_y_axis proc~place_grid_axes->proc~move_z_axis proc~resize WindowProxy%resize proc~resize->proc~frame proc~run WindowProxy%run proc~run->proc~frame proc~segments_set_color CustomLineSegments%segments_set_color proc~segments_set_color->proc~set_color~2 proc~set_label_alignment ReferenceFrame%set_label_alignment proc~set_label_alignment->proc~relayout_labels proc~set_label_size ReferenceFrame%set_label_size proc~set_label_size->proc~relayout_labels proc~set_sky WindowProxy%set_sky proc~set_sky->proc~node~2 proc~sphere_set_color Sphere%sphere_set_color proc~sphere_set_color->proc~set_color~2 proc~time_set_color TimeHandle%time_set_color proc~time_set_color->proc~set_color~2 proc~vector_set_color VectorHandle%vector_set_color proc~vector_set_color->proc~set_color~2 interface~referenceframe ReferenceFrame interface~referenceframe->proc~new_reference_frame proc~grid_set_parameters LatLonGrid%grid_set_parameters proc~grid_set_parameters->proc~place_grid_axes proc~new_coordinate_axes new_coordinate_axes proc~new_coordinate_axes->proc~place_axes proc~new_lat_lon_grid new_lat_lon_grid proc~new_lat_lon_grid->proc~place_grid_axes proc~new_radial_plane new_radial_plane proc~new_radial_plane->proc~place_axes proc~plane_set_parameters RadialPlane%plane_set_parameters proc~plane_set_parameters->proc~place_axes proc~set_axis_length CoordinateAxes%set_axis_length proc~set_axis_length->proc~place_axes interface~coordinateaxes CoordinateAxes interface~coordinateaxes->proc~new_coordinate_axes interface~latlongrid LatLonGrid interface~latlongrid->proc~new_lat_lon_grid interface~radialplane RadialPlane interface~radialplane->proc~new_radial_plane

Source Code

    function label_create(text, position, rgba, size, max_size, alignment, font_name) result(node)
        character(len=*), intent(in) :: text        !! the label's text
        real(wp), intent(in) :: position(3)         !! (the coordinates of the node it is put under)
        real(wp), intent(in) :: rgba(4)             !! color [r, g, b, a] (0 to 1)
        real(wp), intent(in) :: size                !! > 0: height in window units; < 0: -height in scene units
        real(wp), intent(in) :: max_size            !! for size < 0: the largest height on screen (window units)
        integer, intent(in) :: alignment            !! an ALIGN_* constant of vkf_frames
        character(len=*), intent(in) :: font_name   !! font file ('' for the default)
        type(c_ptr) :: node
        type(c_ptr) :: font
        integer :: h, v
        node = c_null_ptr
        font = get_font(font_name)
        if (.not. c_associated(font)) return
        call vsg_alignment(alignment, h, v)
        node = vkf_label_create(font, text, len(text, kind=c_int), real(rgba, c_float), real(position, c_double), &
                                real(size, c_float), real(max_size, c_float), int(h, c_int), int(v, c_int))
    end function label_create