Luce packages
LuceLuce BaseLuciaOS

dymokomi/luce-browser-engine

Source of release 0.6.1

0.6.1 / src / web / html / image_request.lucb

#==============================================================================================
#
#   image_request - HTML::ImageRequest: an img element's current and pending requests
#
#   DESCRIPTION:
#       Port of LibWeb/HTML/ImageRequest.cpp (lines 1-131) and the inline functions of
#       ImageRequest.h: the request's state, current URL (which finds or makes the document's
#       shared resource request for it), image data, pixel density and density-corrected
#       dimensions, and aborting an image request. Fetching goes through
#       SharedResourceRequest (phase 2).
#
#==============================================================================================

## Ported from ImageRequest.cpp:27 Web::HTML::ImageRequest::create.
pub func html_image_request_create(realm: Realm*, page: Page*) -> HtmlImageRequest*:
    return realm_create_html_image_request(realm, page)

## Ported from ImageRequest.cpp:32 Web::HTML::ImageRequest::ImageRequest.
pub func html_image_request_construct(this: HtmlImageRequest*, page: Page*):
    html_image_request_init_fields(this)
    # (An image request's current URL is initially the empty string: the zeroed cell's.)
    this.m_page = page

## Ported from ImageRequest.cpp:41 Web::HTML::ImageRequest::visit_edges (override).
pub func html_image_request_visit_edges_impl(base: gc.Cell*, visitor: gc.CellVisitor*):
    let this = (HtmlImageRequest*)base
    gc.cell_visit_edges_impl(base, visitor)
    gc.cell_visitor_visit_t(visitor, this.m_shared_resource_request)
    gc.cell_visitor_visit_t_2(visitor, this.m_page)
    gc.cell_visitor_visit_t(visitor, this.m_image_data)

## Ported from ImageRequest.cpp:50 Web::HTML::ImageRequest::is_available.
# https://html.spec.whatwg.org/multipage/images.html#img-available
pub func html_image_request_is_available(this: HtmlImageRequest*) -> bool:
    # When an image request's state is either partially available or completely available, the image request is said to be available.
    return this.m_state == HtmlImageRequestState.partially_available or this.m_state == HtmlImageRequestState.completely_available

## Ported from ImageRequest.cpp:56 Web::HTML::ImageRequest::is_fetching.
pub func html_image_request_is_fetching(this: HtmlImageRequest*) -> bool:
    let shared_resource_request = this.m_shared_resource_request else return false
    return html_shared_resource_request_is_fetching(shared_resource_request)

## Ported from ImageRequest.cpp:61 Web::HTML::ImageRequest::state.
pub func html_image_request_state(this: HtmlImageRequest*) -> HtmlImageRequestState:
    return this.m_state

## Ported from ImageRequest.cpp:66 Web::HTML::ImageRequest::set_state.
pub func html_image_request_set_state(this: HtmlImageRequest*, state: HtmlImageRequestState):
    this.m_state = state

## Ported from ImageRequest.cpp:71 Web::HTML::ImageRequest::set_current_url.
pub func html_image_request_set_current_url(this: HtmlImageRequest*, realm: Realm*, url: ak.String):
    this.m_current_url = url

    if let parsed_url = domurl_parse(ak.string_bytes_as_string_view(&this.m_current_url)):
        this.m_shared_resource_request = html_shared_resource_request_get_or_create(realm, this.m_page, parsed_url)

## Ported from ImageRequest.cpp:80 Web::HTML::abort_the_image_request.
# https://html.spec.whatwg.org/multipage/images.html#abort-the-image-request
pub func html_abort_the_image_request(arg0: Realm*, image_request: HtmlImageRequest*?):
    # 1. If image request is null, then return.
    let request = image_request else return

    # 2. Forget image request's image data, if any.
    html_image_request_set_image_data(request, none)

    # 3. Abort any instance of the fetching algorithm for image request,
    #    discarding any pending tasks generated by that algorithm.
    # AD-HOC: We simply don't do this, since our SharedResourceRequest may be used by someone else.

## Ported from ImageRequest.cpp:94 Web::HTML::ImageRequest::image_data.
pub func html_image_request_image_data(this: HtmlImageRequest*) -> HtmlDecodedImageData*?:
    return this.m_image_data

## Ported from ImageRequest.cpp:99 Web::HTML::ImageRequest::set_image_data.
pub func html_image_request_set_image_data(this: HtmlImageRequest*, data: HtmlDecodedImageData*?):
    this.m_image_data = data

## Ported from ImageRequest.cpp:105 Web::HTML::ImageRequest::prepare_for_presentation.
# https://html.spec.whatwg.org/multipage/images.html#prepare-an-image-for-presentation
pub func html_image_request_prepare_for_presentation(this: HtmlImageRequest*, arg0: HtmlImageElement*):
    # FIXME: 1. Let exifTagMap be the EXIF tags obtained from req's image data, as defined by the relevant codec. [EXIF]
    # FIXME: 2. Let physicalWidth and physicalHeight be the width and height obtained from req's image data, as defined by the relevant codec.
    # FIXME: 3. Let dimX be the value of exifTagMap's tag 0xA002 (PixelXDimension).
    # FIXME: 4. Let dimY be the value of exifTagMap's tag 0xA003 (PixelYDimension).
    # FIXME: 5. Let resX be the value of exifTagMap's tag 0x011A (XResolution).
    # FIXME: 6. Let resY be the value of exifTagMap's tag 0x011B (YResolution).
    # FIXME: 7. Let resUnit be the value of exifTagMap's tag 0x0128 (ResolutionUnit).
    # FIXME: 8. If all the following are true:
    #           ...
    # FIXME: 9. Update req's img element's presentation appropriately.
    return

## Ported from ImageRequest.cpp:119 Web::HTML::ImageRequest::fetch_image.
pub func html_image_request_fetch_image(this: HtmlImageRequest*, realm: Realm*, request: FetchRequest*):
    let shared_resource_request = this.m_shared_resource_request else trap("VERIFY: m_shared_resource_request")
    html_shared_resource_request_fetch_resource(shared_resource_request, realm, request)

## Ported from ImageRequest.cpp:125 Web::HTML::ImageRequest::add_callbacks.
pub func html_image_request_add_callbacks(this: HtmlImageRequest*, on_finish: ak.Function0[unit], on_fail: ak.Function0[unit]):
    let shared_resource_request = this.m_shared_resource_request else trap("VERIFY: m_shared_resource_request")
    html_shared_resource_request_add_callbacks(shared_resource_request, on_finish, on_fail)

# mark: Inline functions of ImageRequest.h ======================================================

## Ported from ImageRequest.h:42 Web::HTML::ImageRequest::current_url.
pub func html_image_request_current_url(this: HtmlImageRequest*) -> ak.String:
    return this.m_current_url

## Ported from ImageRequest.h:48 Web::HTML::ImageRequest::current_pixel_density.
pub func html_image_request_current_pixel_density(this: HtmlImageRequest*) -> f32:
    return this.m_current_pixel_density

## Ported from ImageRequest.h:49 Web::HTML::ImageRequest::set_current_pixel_density.
pub func html_image_request_set_current_pixel_density(this: HtmlImageRequest*, density: f32):
    this.m_current_pixel_density = density

## Ported from ImageRequest.h:51 Web::HTML::ImageRequest::preferred_density_corrected_dimensions.
pub func html_image_request_preferred_density_corrected_dimensions(this: HtmlImageRequest*) -> gfx.FloatSize?:
    return this.m_preferred_density_corrected_dimensions

## Ported from ImageRequest.h:52 Web::HTML::ImageRequest::set_preferred_density_corrected_dimensions.
pub func html_image_request_set_preferred_density_corrected_dimensions(this: HtmlImageRequest*, dimensions: gfx.FloatSize?):
    this.m_preferred_density_corrected_dimensions = dimensions

## Ported from ImageRequest.h:60 Web::HTML::ImageRequest::shared_resource_request.
pub func html_image_request_shared_resource_request(this: HtmlImageRequest*) -> HtmlSharedResourceRequest*?:
    return this.m_shared_resource_request